Access, Unlock & Cooldowns

Access & Unlock Models

Field	Description
`permission`	Required permission to see / claim ("" = none)
`price`	Money charged on every claim (0 = free)
`one-time-price`	One-off cost to unlock the kit; free afterwards (on cooldown)
`currency`	"" / "vault" = Vault economy, else an XCore currency id
`one-time`	Claimable once ever (e.g. starter kits)
`first-join`	Automatically given on the player's first connection

Paid kits work with or without Vault: an empty currency routes to the Vault economy (any provider), while a named currency uses XCore's economy — so paid kits work even when XCore's internal economy is off.

Cooldowns & Limits

cooldown: "1d"                 # 0/none, or 30s / 5m / 2h / 1d ...
cooldown-bypass-permission: "xkits.bypass.daily"
cooldown-reductions:
  xkits.vip: 50                # VIPs get 50% off the cooldown
max-uses: 0                    # total claims (0 = unlimited)
max-uses-per-day: 3            # per-day cap (resets at daily-reset-hour)

Cooldowns, unlocks and use-counts are stored in XCore's shared database and broadcast on the sync channel, so a player can't bypass them by hopping between servers.