OrangeKits

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+