# Developer API
### 1) Add the Dependency
Don't forget to change always the version!
{% tabs %}
{% tab title="Maven" %}
<repository>
<id>MonGens-Cave</id>
<url>https://repo.mongenscave.com/releases<repository></url>
</repository>
<dependency>
<groupId>com.mongenscave</groupId>
<artifactId>mc-LevelsAPI</artifactId>
<version>[VERSION]</version>
</dependency>
{% endtab %}
{% tab title="Gradle" %}
```groovy
maven { url "https://repo.mongenscave.com/releases" }
implementation "com.mongenscave:mc-LevelsAPI:[VERSION]"
```
{% endtab %}
{% endtabs %}
### 2) Add mc-Levels to plugin.yml
{% tabs %}
{% tab title="as depend" %}
```yaml
depend:
- mc-Levels
```
{% endtab %}
{% tab title="as softdepend" %}
```yaml
softdepend:
- mc-Levels
```
{% endtab %}
{% endtabs %}
### 3) Example how to use the LevelsAPI
As an example, give XP to a player.
```java
public class XPExample {
public void giveXP(Player player, int amount) {
LevelsAPI.getInstance().addXP(player, amount);
player.sendMessage("✅ " + amount + " You got XP!");
}
}
```
| Event | Description |
| ------------------ | -------------------------------------------------------------- |
| PlayerGainXPEvent | Triggered when a player gains XP. Can be modified or canceled. |
| PlayerLevelUpEvent | Fired when a player levels up. |
