SoapsUniverse

Kits

Last updated Oct 4, 2026

Kits

Claimable item kits with cooldowns, warmups, costs, and an in-game editor. Module: kits. Config: kits.yml. Reload: /sa reload kits.

Player how-to

  1. List kits: /sa kits or open the kits GUI from the player dashboard when enabled.
  2. Preview: /sa kit preview <name>.
  3. Claim: /sa kit <name>. Stay still if the kit has a warmup.
  4. Cooldown and one-time limits apply per kit. Extra kits often need soapsadmin.kit.<name>.

Staff how-to

  1. Create: /sa kit create <name> (or use the kit manager GUI).
  2. Edit contents: /sa kit edit <name>.
  3. Tune settings: /sa kit settings <name> or /sa kit set <name> <setting> <value>.
  4. Reset cooldowns or usage: /sa kit reset <kit|all> [player].
  5. Permission for manage tools: soapsadmin.kit.manage.

Claim safety

When a claim fails or the inventory cannot hold everything:

full-inventory-action What happens
drop (default) Kit is granted. Items that do not fit drop on the ground.
deny Kit is not granted if there is not enough space. Paid costs are refunded. Overflow does not discard paid items.

Warmup kits re-check costs after the warmup finishes. If the player cannot pay or space is denied, the grant does not complete as a silent half-give.

Costs and gates you can set per kit include cooldown, warmup, usage limit, permission, world/time/weather conditions, XP costs, and item costs. See kits.yml in Default Config Files.