# Developer API

You can import **ExcellentCrates** to your project using Maven. Replace `{VERSION}` with the latest version below:

![](https://repo.nightexpressdev.com/api/badge/latest/releases/su/nightexpress/excellentcrates/crates-api?color=40c14a&name=crates-api&prefix=v)
```xml
<repository>
  <id>nightexpress-releases</id>
  <url>https://repo.nightexpressdev.com/releases</url>
</repository>

<dependency>
  <groupId>su.nightexpress.excellentcrates</groupId>
  <artifactId>crates-api</artifactId>
  <version>{VERSION}</version>
</dependency>
```

## Events

{.compact}
| Event | Description | Cancellable |
| ---   | ---         | ---         |
| `ExcellentCratesPreModuleRegisterEvent` | Fired before module registration. | :icon-phs-x-circle: No | 
| `ExcellentCratesModulesRegisteredEvent` | Fired after all modules have been registered (1st bootstrap phase completed). | :icon-phs-x-circle: No |
| `ExcellentCratesModulesResolvedEvent` | Fired after all modules have been resolved (2nd bootstrap phase completed). | :icon-phs-x-circle: No |
| `CratePipelinePreStartEvent` | Fired when a crate opening pipeline is about to be executed. | :icon-phs-check-circle: Yes |
| `RewardGrantedEvent` | Fired when a crate reward is given to a player. | :icon-phs-x-circle: No |
| `RewardGrantEvent` | Fired when a crate reward is about to be given to a player. | :icon-phs-check-circle: Yes |

## API Access

```java
RegisteredServiceProvider<ExcellentCratesAPI> provider = Bukkit.getServer().getServicesManager().getRegistration(ExcellentCratesAPI.class);
ExcellentCratesAPI api = provider.getProvider();
```
