Interface KitService

public interface KitService

Kit registry and per-player claim tracking.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static enum	KitService.ClaimResult

Method Summary

Modifier and Type	Method	Description
CompletableFuture<KitService.ClaimResult>	claim(UUID player, String kitId)	Attempts to claim a kit: checks permission, one-time/max-claims, cooldown and inventory space, then gives the items and records the claim.
CompletableFuture<KitClaimState>	claimState(UUID player, String kitId)
CompletableFuture<Long>	cooldownRemaining(UUID player, String kitId)	Seconds remaining before player can claim kitId again, or 0 if ready now.
Optional<Kit>	kit(String id)
Collection<Kit>	kits()
void	register(Kit kit)	Registers or replaces a kit definition - how expansions add a "new kit type" at runtime.
void	unregister(String id)

Method Details

kits

Collection<Kit> kits()

kit

Optional<Kit> kit(String id)

register

void register(Kit kit)

Registers or replaces a kit definition - how expansions add a "new kit type" at runtime.

unregister

void unregister(String id)

claimState

CompletableFuture<KitClaimState> claimState(UUID player,
 String kitId)

cooldownRemaining

CompletableFuture<Long> cooldownRemaining(UUID player,
 String kitId)

Seconds remaining before player can claim kitId again, or 0 if ready now.

claim

CompletableFuture<KitService.ClaimResult> claim(UUID player,
 String kitId)

Attempts to claim a kit: checks permission, one-time/max-claims, cooldown and inventory space, then gives the items and records the claim. The result explains exactly why a claim was refused so commands don't have to re-derive it.