?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
OrangeKits

OrangeKits

OrangeKits is a Spigot/Paper kit plugin with a drag-to-rearrange GUI, per-kit perms, cooldowns, one-time claims, sounds, kit-on-join/death, force-give, and left-click previews. Everything's configurable in settings.yml and reloads with /kit reload.

175downloads
0followers
175downloads
0followers

Links

Join Discord server

Tags

Creators

Details

Licensed ARR
Published 4 months ago
Updated 4 months ago
All versions

1.0.0

Release
OrangeKits 1.0.04 months ago 175
Uploaded by
Download

Compatibility

Minecraft: Java Edition
26.1.x
1.21.x
1.20.x
Platform
Paper

Changes

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+