Developer API

1) Add the Dependency

Don't forget to change always the version!

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>

Gradle

2) Add mc-Credits to plugin.yml

as depend

depend:
  - mc-Treasure

as softdepend

3) Example how to use the TreasureAPI

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<ITreasureChest> findNearbyTreasures(Location center, double radius) {
        return McTreasureAPI.getAllTreasures().stream()
            .filter(treasure -> treasure.getLocation() != null)
            .filter(treasure -> treasure.getLocation().distance(center) <= radius)
            .collect(Collectors.toList());
    }
}