OrangeKits

# 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