Kits Module

Types of Kits

Normal Kits

Normal kits are standard kits that players can claim via commands (e.g., /kit <name>). They respect defined cooldowns and permissions.

Respawn Kits

Respawn kits are automatically given to players when they respawn. They are not provided on initial join, only on death/respawn.

Features

• Create and manage normal and respawn kits via commands
• Configure permissions, cooldowns, and priorities per kit
• Define kit contents: inventory, armor, offhand items, and potion effects
• Trigger custom actions on kit claims

Configuration Reference

Key	Type	Default	Description
enabled	boolean	true	Enable or disable the kits module
<kitName>.permission	string	''	Permission required to claim the kit
<kitName>.cooldown-in-seconds	number	0	Cooldown in seconds between kit claims
<kitName>.priority	number	0	Priority for kit availability (higher checked first)
<kitName>.effects	object[]	[]	Potion effects on claim (effect-type, amplifier, duration)
<kitName>.actions	string[]	[]	List of actions executed on kit claim
<kitName>.offhand	object		Offhand item data (material, amount, title, enchantments, flags)
<kitName>.inventory-items	string[]	[]	Inventory items with slot (ITEM + SLOT format)
<kitName>.armor-items	string[]	[]	Armor items with slot (ITEM + SLOT format)

Priority

Higher priority values make a kit checked earlier. For respawn kits, higher priority kits are applied first.

Permission

If permission is empty (''), the kit is available to all players. Otherwise, players need firebox.kits.<permission> or firebox.rkits.<permission> to access the kit.

Example

Kits section

<kitName>:
    permission: PERMISSION
    cooldown-in-seconds: NUMBER
    priority: NUMBER
    effects: [EFFECT]
    actions: [ACTION...]
    offhand: ITEM
    inventory-items: [ITEM + SLOT ...]
    armor-items: [ITEM + SLOT ...]
    actions: [ACTION...]

Related Modules

• Actions