🎒 KitsCore — Advanced Kit Management

The most complete kit plugin for your server. Interactive GUI, daily/weekly/monthly kits, economy integration, vouchers, categories, conditions, custom commands and much more — all configurable in-game, no need to restart the server.

---

📦 Dependencies

Dependency	Type	Purpose
Spigot / Paper 1.14.4+	✅ Required	Server software base
Java 16+	✅ Required	Runtime (Java 17 recommended)
Vault	⚠️ Optional	Economy (kit costs, purchases, unlock mode)
PlaceholderAPI	⚠️ Optional	Placeholders in other plugins

💡 Vault requires an economy plugin to function (e.g. EssentialsX, CMI, TheNewEconomy).

---

🖥️ Compatible Software

Software	Supported
Spigot	✅
Paper	✅
Purpur	✅
Folia	✅ (via async scheduler)
Bukkit	✅

Minecraft versions: 1.14.4 → 1.20.x

---

✨ Features

🎮 Player Features

• Interactive inventory GUI — browse, preview, and claim kits with a single click
• Daily, Weekly and Monthly kits — automatically reset on the correct schedule
• Random kit — pick a surprise kit from a configurable weighted pool
• Kit Shop — purchase premium kits with in-game money (requires Vault)
• Unlock Mode — pay once, use forever
• Favorites — star kits for quick access in a dedicated menu
• Kit Preview — see a kit's contents before claiming it
• Cooldown display — shows exact remaining time on each kit
• Category browsing — kits organized into custom categories
• Kit search — find kits by name or category via command

🔧 Admin Features

• Full in-game GUI editor — create, edit, and delete kits without touching any file
• Create kit from GUI — type the ID in chat and the editor opens automatically
• Set Items editor — drag and drop items directly into kit slots
• Conditions system — require minimum kills, playtime, level, money, or rank
• Limits system — cap usage per day / week / month / lifetime / globally per player
• Flags — auto-equip armor, clear inventory, play sound, show particles, broadcast on claim, admin-only
• Console & Player Commands — run commands on claim (supports {player} placeholder)
• Voucher system — create single-use or multi-use vouchers for any kit
• Kit duplication — clone any kit with one click
• Audit log — all admin actions are logged to the database
• Admin statistics — view top kits by uses and purchases
• Hot reload — reload config and kits without restarting

🌍 Multi-language

• 🇺🇸 English (en_US)
• 🇧🇷 Portuguese Brazil (pt_BR)
• 🇪🇸 Spanish (es_ES)
• Per-player language selection in-game
• Fully customizable lang files

💾 Storage

• YAML (default) — no setup required, kits saved as individual files
• MySQL / MariaDB — for networks and BungeeCord/Velocity setups

---

🖱️ Commands

Player — /kit (alias: /kits)

Command	Description
/kit	Open the kit GUI
/kits	Alias — same as /kit
/kit list	Open the interactive kit GUI
/kit gui	Open the kit GUI
/kit preview <name>	Preview a kit's contents
/kit info <name>	Show kit details in chat
/kit cooldown <name>	Check remaining cooldown
/kit search <term>	Search kits by name or category
/kit daily	Open the daily kits menu
/kit random	Open the random kit menu
/kit shop	Open the kit shop
/kit favorites	Open your favorites menu

Admin — /kitscore

Command	Description
/kitscore admin	Open the admin kit list GUI
/kitscore create <id>	Create a new kit and open its editor
/kitscore delete <kit>	Delete a kit
/kitscore duplicate <kit> <new-id>	Duplicate a kit
/kitscore give <player> <kit>	Give a kit to a player
/kitscore list	List all kits in chat
/kitscore reload	Reload config, lang and kits
/kitscore stats	View usage statistics
/kitscore voucher create <kit> <uses> [hours]	Create a voucher
/kitscore voucher give <player> <id>	Give a voucher to a player
/kitscore voucher list	List active vouchers

---

🔐 Permissions

Permission	Default	Description
kitscore.use	Everyone	Use /kit and open the GUI
kitscore.preview	Everyone	Preview kit contents
kitscore.admin	OP	Full access to all admin features
kitscore.create	OP	Create kits
kitscore.delete	OP	Delete kits
kitscore.edit	OP	Edit kits via GUI
kitscore.give	OP	Give kits to other players
kitscore.reload	OP	Reload the plugin
kitscore.stats	OP	View statistics
kitscore.logs	OP	View audit logs
kitscore.voucher.create	OP	Create vouchers
kitscore.voucher.give	OP	Give vouchers to players
kitscore.category.manage	OP	Manage categories
kitscore.bypass.cooldown	OP	Skip kit cooldowns
kitscore.bypass.cost	OP	Skip kit costs
kitscore.bypass.conditions	OP	Skip kit conditions
kitscore.bypass.world	OP	Skip world/time restrictions
kitscore.kit.<id>	—	Per-kit access permission (optional)

---

⚙️ Admin Menu Layout

The kit editor is organized into a clean 6-row GUI — no clutter, everything at a glance:

┌─────────────────[ Kit Info Banner ]─────────────────┐
│  Set Items  │  Edit Name  │  Cooldown  │ Permission  │
│  Edit Cost  │  Category   │    Icon    │ Disp. Item  │
│   Preview   │ Conditions  │   Limits   │    Flags    │
│ Con. Cmds   │  Plr. Cmds  │ Duplicate  │   Delete    │
│ Back │ ■ One-time │ Daily │ Weekly │ Monthly │ Close │
└─────────────────────────────────────────────────────┘

---

📋 Placeholders (PlaceholderAPI)

Placeholder	Returns
%kitscore_kit_cooldown_<id>%	Remaining cooldown (formatted)
%kitscore_kit_available_<id>%	true / false
%kitscore_kit_uses_<id>%	Total times claimed by the player
%kitscore_total_kits%	Total number of kits on the server

---

📁 Config Overview

plugins/KitsCore/
├── config.yml          → storage, sounds, default language
├── categories.yml      → kit categories
├── kits/               → one .yml file per kit
└── lang/
    ├── en_US.yml
    ├── pt_BR.yml
    └── es_ES.yml

---

💬 Support

Have a question, found a bug or want to suggest a feature? Join our Discord server and open a ticket — we'll be happy to help!

---

Made with ❤️ by EuGabrixz AI-generated description, enhanced and fully reviewed.