OrangeKits

A kit plugin for Paper, Purpur, and Spigot servers (1.20.x–1.21.x) that gives players a clean GUI to claim pre-made item sets and gives staff a fast way to build, edit, and rearrange those kits without ever leaving the game.

What it does

Run /kit and players see a grid of every kit they can claim. Each tile shows the kit's icon and a quick summary of cooldown, one-time status, and required permission. Left-click previews the kit so players can see exactly what they'll get before committing; right-click claims it. Kits the player doesn't have access to appear as red tiles with a clear "No permission" note instead of being hidden — so they know what's available to earn or buy.

Behind the scenes, every kit has its own permission node, cooldown, one-time flag, claim sound, icon, and GUI slot. Staff create kits straight from their inventory with /kit create <name>, then tweak everything from an in-game Settings GUI — including dragging the kit to a new position in the menu using layout-edit mode.

Why use it

• Editable layouts. Kit positions aren't hardcoded. Staff pick up tiles and drop them wherever in the GUI, and the order persists across restarts.
• Real auto-give support. Kit-on-join and kit-on-death are opt-in toggles that fully respect permissions, cooldowns, and one-time flags — and if an auto-give is blocked, the player sees the actual reason ("Tried to give your on-join kit but it's on cooldown — 87s left.") instead of silently getting nothing.
• Admin overrides. /kit force instantly gives a kit bypassing every check; /kit forceload queues a kit so the player gets it on their next join with no way to opt out — useful for first-join starter kits or compensation drops.
• Fully configurable. Every default, sound, GUI title, cooldown step size, and player-facing message lives in settings.yml with color codes and placeholders. /kit reload applies edits without a restart.
• No dependencies. Drop the JAR in, restart, done.

At a glance

• Per-kit permissions (orangekits.kit.<name>), cooldowns, and one-time claims
• Left-click preview / right-click claim
• Green/red tile coloring by permission
• Settings GUI for icon, cooldown, one-time, sound, position, delete
• Kit-on-join + kit-on-death toggles with contextual failure messages
• /kit force (instant) and /kit forceload (queued, no opt-out)
• kits.bypass.cooldown permission for staff
• YAML-stored kits, players, and settings — easy to back up and edit by hand