Kit Menu
A clean, fully in-game configurable kit system for your server.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦 Overview
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
The Kits plugin provides a fully featured kit system with a beautiful GUI menu, in-game kit editor, Vault economy support, cooldowns, permissions, first-join kits and more — all without ever touching a config file.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ Features
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- Animated gradient GUI title — fully customisable in
kits-config.yml - Kit GUI menu — shows all kits, cooldowns, costs and lock status at a glance
- Kit preview — right-click a kit in the menu (or
/kit preview ) to inspect its contents without claiming - Cooldowns — per-kit cooldown in seconds; bypassable via permission
- Economy support — optional Vault integration for paid kits
- Per-kit permissions — lock kits behind any permission node you choose
- First-join kit — automatically gives a configurable kit to brand new players
- Fully in-game editor — create, modify and delete kits without restarting or editing files
- Live kit item editor — drag and drop items directly into an inventory to set kit contents
- Hex & gradient colour support — use
RRGGBB and text anywhere - Auto slot placement — assign fixed GUI slots per kit or let the plugin fill them automatically
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 Installation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- Make sure GateWayMC-Core is installed and running.
- Drop the
KitsModule.jar into the modules folder:plugins/GateWayMC-Core/modules/
- Load the module — choose one of:
• In-game: /gatewaycore reload
- Console: gatewaycore reload
- Or simply restart the server.
- Done! Configuration files are generated automatically on first load inside
plugins/GateWayMC-Core/modules/Kits/
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💬 Commands
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
| Command |
Description |
Permission |
/kit (alias: /kits) |
Open the kit selection GUI |
kits.menu |
/kit menu |
Open the kit selection GUI |
kits.menu |
/kit list |
List all available kits in chat |
kits.list |
/kit preview |
Preview a kit's contents without claiming it |
kits.preview |
/kit give |
Force-give a kit to another player |
kits.give + kits.give. |
/kit help |
Show command help (configurable in config) |
none |
/kitedit |
Open the kit editor GUI (list all kits) |
kits.edit |
/kitedit |
Open the editor directly for a specific kit |
kits.edit |
/kitedit reload |
Reload config and kits from disk |
kits.edit.reload |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔑 Permissions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
| Permission |
Description |
Default |
kits.menu |
Open the kit GUI menu |
all players |
kits.list |
Use /kit list |
all players |
kits.preview |
Preview kit contents |
all players |
kits.give |
Give kits to other players |
op |
kits.give. |
Give a specific named kit to others |
op |
kits.edit |
Access the in-game kit editor |
op |
kits.edit.reload |
Reload kits and config |
op |
kits.cooldown.bypass |
Skip cooldown on all kits |
op |
|
Per-kit permission — set any node on each kit individually via the editor |
configurable |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛠 In-Game Kit Editor
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Everything can be managed without touching any file:
- Display Name — supports all colour codes and hex colours
- Items — drag and drop into a live inventory editor, click Save when done
- Cost — set an economy cost (only available when Vault is enabled)
- Cooldown — set how many seconds players must wait between claims
- Display Item — the icon shown in the GUI; type a material name or use the item in your hand
- Permission — lock the kit behind any permission node, or set to
none - Lore — multi-line lore shown on the kit icon; separate lines with
| - Slot — fixed GUI slot (0-53) or
-1 for automatic placement
After editing, the menu reopens automatically — no need to retype /kitedit every time.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📁 Configuration Files
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
kits-config.yml — GUI title, filler item, messages, permissions, Vault toggle, first-join settingskits.yml — all kit definitions (auto-generated; edit in-game via /kitedit)firstjoin.yml — tracks which players have already received the first-join kit
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙ Dependencies
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- Required: GateWayMC-Core
- Optional: Vault — enable
vault-enabled: true in kits-config.yml to unlock economy features