Kits API

Kit kit = kits.findKitByName("vip");
if (kit == null) return;

// Expose kit info to your own GUI.
int cooldown  = (int) kit.getCooldownInSeconds();
int maxClaims = kit.getMaximumClaimsAllowed();
boolean oneTime = kit.isOneTimeUse();

// Copy the item list (getItemStacks() returns a fresh list).
List<ItemStack> items = new ArrayList<>(kit.getItemStacks());

KitClaimProfile profile = kits.fetchClaimProfile(player, kit);

long secondsSinceLastClaim =
    (System.currentTimeMillis() - profile.getLastClaimedTimestamp()) / 1000;

if (profile.getTotalClaimCount() >= 3) {
    player.sendMessage("You've claimed this kit 3 times already.");
}

@EventHandler
public void onKitPermissionCheck(KitPermissionCheckEvent event) {
    // Let anyone use the "starter" kit regardless of permissions.
    if (event.getKit().getName().equals("starter")) {
        event.setHasPermission(true);
    }
}

@EventHandler
public void onKitAvailableCheck(KitAvailableCheckEvent event) {
    // Force "vip" to be unavailable during maintenance.
    if (maintenance && event.getKit().getName().equals("vip")) {
        event.setAvailable(false);
        event.setDenialReason("Kit temporarily disabled.");
    }
}

@EventHandler
public void onKitClaim(KitClaimEvent event) {
    // Block claims while the player is in a "no-kit" world.
    if (event.getPlayer().getWorld().getName().equals("pvp_arena")) {
        event.setCancelled(true);
        return;
    }
    // Announce the claim.
    server.broadcast(event.getPlayer().getName() + " claimed " + event.getKit().getDisplayName());
}

@EventHandler
public void onKitGive(KitGiveEvent event) {
    List<ItemStack> items = new ArrayList<>(event.getItems());

    // Add a loyalty bonus on top of the configured items.
    items.add(new ItemStack(Material.GOLD_INGOT, 8));
    event.setItems(items);

    // Or strip a banned item entirely.
    items.removeIf(s -> s.getType() == Material.BEDROCK);
    event.setItems(items);
}

@EventHandler
public void onKitFirstJoin(KitFirstJoinEvent event) {
    // Skip the starter kit for players joining from a whitelisted network.
    if (event.getPlayer().hasPermission("network.started")) {
        event.setCancelled(true);
    }
}

@EventHandler
public void onKitCooldownExpire(KitCooldownExpireEvent event) {
    // Notify the player their kit is ready again.
    event.getPlayer().sendMessage("Your " + event.getKit().getName() + " kit is ready!");
}

// Fired once per kit as kit config is loaded.
@EventHandler
public void onKitLoad(KitLoadEvent event) {
    getLogger().info("Loaded kit " + event.getKit().getName()
        + " from " + event.getSourceFileName());
}

// Fired after a full kit reload.
@EventHandler
public void onKitReload(KitReloadEvent event) {
    getLogger().info("Kit reload complete - " + event.getKitCount() + " kits.");
}

// A player's claim entries were loaded from storage.
@EventHandler
public void onKitDataLoad(KitDataLoadEvent event) {
    getLogger().info("Loaded " + event.getLoadedEntryCount()
        + " claim entries for " + event.getPlayerName());
}

// A claim was persisted.
@EventHandler
public void onKitDataSave(KitDataSaveEvent event) {
    getLogger().info("Saved claim #" + event.getNewClaimCount()
        + " for kit " + event.getKit().getName());
}

// A claim completed (after persistence).
@EventHandler
public void onKitPostClaim(KitPostClaimEvent event) {
    long timestamp = event.getClaimTimestamp();
    event.getPlayer().sendMessage("Enjoy your " + event.getKit().getDisplayName() + "!");
}

@Override
public boolean onCommand(CommandSender sender, Command cmd, String label, String[] args) {
    if (!(sender instanceof Player p) || args.length == 0) return true;

    KitManager kits = api.getKitManager();
    Kit kit = kits.findKitByName(args[0]);
    if (kit == null) {
        p.sendMessage("Unknown kit: " + args[0]);
        return true;
    }

    // Respect the plugin's own rules, but let the events do the vetoing.
    if (!kits.isPermittedToUse(p, kit)) {
        p.sendMessage("You don't have permission for that kit.");
        return true;
    }
    if (!kits.isClaimAllowedFor(p, kit)) {
        long remaining = kits.getRemainingCooldownSeconds(p, kit);
        p.sendMessage("Kit on cooldown - " + remaining + "s left.");
        return true;
    }

    // Fire the full pipeline (events can still cancel it).
    kits.claimKitForPlayer(p, kit).exceptionally(ex -> {
        p.sendMessage("Something went wrong claiming that kit.");
        return null;
    });
    return true;
}

KitManager kits = api.getKitManager();

for (Kit kit : kits.getKitsAvailableTo(player)) {
    long cd = kits.getRemainingCooldownSeconds(player, kit);
    String status = cd > 0
        ? "on cooldown (" + cd + "s)"
        : "claimable";
    player.sendMessage(kit.getDisplayName() + " - " + status);
}

Kit kit = kits.findKitByName("party");
if (kit == null) return;

// Hand items straight over - no claim recorded, no cooldown applied.
for (ItemStack item : kit.getItemStacks()) {
    Map<Integer, ItemStack> leftover = player.getInventory().addItem(item);
    leftover.values().forEach(drop -> player.getWorld().dropItemNaturally(player.getLocation(), drop));
}