> For the complete documentation index, see [llms.txt](https://docs.mongenscave.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mongenscave.com/free-products/treasure/api.md).
# 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-Treasure</artifactId>
<version>[VERSION]</version>
</dependency>
{% endtab %}
{% tab title="Gradle" %}
```groovy
maven { url "https://repo.mongenscave.com/releases" }
implementation "com.mongenscave:mc-Treasure:[VERSION]"
```
{% endtab %}
{% endtabs %}
### 2) Add mc-Credits to plugin.yml
{% tabs %}
{% tab title="as depend" %}
```yaml
depend:
- mc-Treasure
```
{% endtab %}
{% tab title="as softdepend" %}
```yaml
softdepend:
- mc-Treasure
```
{% endtab %}
{% endtabs %}
### 3) Example how to use the TreasureAPI
```java
import com.mongenscave.mctreasure.api.McTreasureAPI;
import com.mongenscave.mctreasure.api.model.ITreasureChest;
public class TreasureExample {
public void handleTreasure(Player player, String treasureId) {
// π Get treasure by ID
ITreasureChest treasure = McTreasureAPI.getTreasure(treasureId);
if (treasure == null) {
player.sendMessage("Β§cβ Treasure not found!");
return;
}
// β
Check if player can open
if (McTreasureAPI.canPlayerOpen(player, treasure)) {
player.sendMessage("Β§aπ Opening treasure: " + treasure.getName());
} else {
player.sendMessage("Β§cπ You cannot open this treasure!");
}
}
// πΊοΈ Find treasures near location
public List findNearbyTreasures(Location center, double radius) {
return McTreasureAPI.getAllTreasures().stream()
.filter(treasure -> treasure.getLocation() != null)
.filter(treasure -> treasure.getLocation().distance(center) <= radius)
.collect(Collectors.toList());
}
}
```
