OrangeKits 1.0.0 — Initial release

A configurable kit plugin with a drag-to-rearrange GUI, per-kit permissions and cooldowns, kit-on-join / kit-on-death, force-give, and a full settings file. Built for Paper, Purpur, and Spigot 1.20.x–1.21.x.

Highlights

• Editable kit GUI. Staff can pick up tiles in layout-edit mode and drop them anywhere — kit slots are stored per-kit, not hardcoded.
• Left-click previews, right-click claims. Preview shows the kit's items in their stored slot positions, with a Claim button (or a "No permission" barrier).
• Color-coded tiles. Kits you can claim show the configured icon with a green name; kits you can't are red glass with a red name and a "No permission" note.
• Per-kit Settings GUI. Icon (shift-click with held item), cooldown (LMB ±1m / RMB ±1s / Q resets), one-time toggle, claim sound (cycle/preview), in-GUI move, delete.
• Kit-on-join & kit-on-death. Both opt-in, both route through the full claim flow so cooldowns and one-time flags actually apply. If an auto-give fails, the player sees why — e.g. "Tried to give your on-join kit but it's on cooldown — 142s left."
• Force commands. /kit force for an instant admin-give that bypasses all checks; /kit forceload queues a kit so the player gets it on their next join with no opt-out.

Commands

Command	Notes
/kit	Open the GUI
/kit <name>	Claim a kit directly
/kit ondeath	Toggle "give last-claimed kit on respawn" (off by default)
/kit onjoin <name|off>	Set or clear your auto-claim on join
/kit list	Text list of kits
/kit create <name>	Snapshot your inventory into a new kit (admin)
/kit delete <name>	Remove a kit (admin)
/kit edit <name>	Open per-kit settings (admin)
/kit layout	Open the GUI in layout-edit mode (admin)
/kit force <player> <kit>	Instant give, bypasses everything (admin)
/kit forceload <player> <kit>	Queue for next join, no opt-out (admin)
/kit reload	Reload settings.yml, kits.yml, players.yml (admin)

Permissions

Node	Default	Grants
orangekits.use	true	Open /kit
orangekits.admin	op	Create / edit / delete / force / layout / reload
orangekits.bypass.cooldown	op	Claim kits ignoring cooldowns
orangekits.kit.<name>	op (via orangekits.kit.*)	Claim a specific kit

Configuration

Everything player-facing lives in plugins/OrangeKits/settings.yml:

• Defaults — cooldown, one-time flag, sound, icon, permission prefix used by /kit create
• Sounds — creation sound + the curated list the Settings GUI cycles through
• GUI titles — main, edit-mode, preview, settings (with %kit% placeholder)
• Cooldown edit steps — how much each click changes a kit's cooldown
• Messages — every player-facing string, with & color codes and %kit%, %player%, %time%, %context%, etc. placeholders

Run /kit reload to apply edits without a restart.

Compatibility

• ✅ Paper — 1.20.x and 1.21.x
• Requires Java 17+