Getting started

ZelBounty provides a comprehensive API for third-party plugin integration.

Getting the API

ZelBounty registers its API as a Bukkit service. Access it like this:

import com.kammoun.api.ZelBountyAPI;
import com.kammoun.api.BountyAPI;
import com.kammoun.api.PlayerDataAPI;

public class MyPlugin extends JavaPlugin {

    private ZelBountyAPI zelBountyAPI;
    private BountyAPI bountyAPI;
    private PlayerDataAPI playerDataAPI;

    @Override
    public void onEnable() {
        // Get the main API
        zelBountyAPI = Bukkit.getServicesManager().load(ZelBountyAPI.class);

        if (zelBountyAPI == null) {
            getLogger().warning("ZelBounty not found!");
            return;
        }

        // Check if enabled
        if (!zelBountyAPI.isEnabled()) {
            getLogger().warning("ZelBounty is not enabled!");
            return;
        }

        // Get sub-APIs
        bountyAPI = zelBountyAPI.getBountyAPI();
        playerDataAPI = zelBountyAPI.getPlayerDataAPI();

        getLogger().info("ZelBounty API loaded! Version: " + zelBountyAPI.getVersion());
    }
}

API Components

ZelBountyAPI

The main API interface providing access to all sub-APIs.

public interface ZelBountyAPI {
    BountyAPI getBountyAPI();
    PlayerDataAPI getPlayerDataAPI();
    String getVersion();
    boolean isEnabled();
}

Maven/Gradle Dependency

To use the API in your project, add the ZelBounty Jar as a dependency.

plugin.yml

depend: [ZelBounty]
# or
softdepend: [ZelBounty]

Gradle

dependencies {
     implementation files('libs/Zelbounty.jar')
}

Thread Safety

• All API methods that modify data return CompletableFuture for async operations

• Read operations are synchronous but thread-safe

• Use .join() or .thenAccept() to handle async results

Async Example

bountyAPI.addBounty(targetUUID, adderUUID, 1000.0)
    .thenAccept(newAmount -> {
        getLogger().info("Bounty added! New total: " + newAmount);
    })
    .exceptionally(ex -> {
        getLogger().warning("Failed to add bounty: " + ex.getMessage());
        return null;
    });

Exception Handling

The API may throw these exceptions:

Exception	Description
BountyException	Base exception for bounty operations
InsufficientFundsException	Player doesn't have enough money
InvalidBountyException	Invalid bounty amount

try {
    bountyAPI.addBounty(target, adder, amount).join();
} catch (CompletionException e) {
    if (e.getCause() instanceof InsufficientFundsException) {
        InsufficientFundsException ife = (InsufficientFundsException) e.getCause();
        player.sendMessage("Need $" + ife.getRequired() + " but only have $" + ife.getAvailable());
    }
}