KitsCore

🎒 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 · Preview a kit's contents
/kit info · Show kit details in chat
/kit cooldown · Check remaining cooldown
/kit search · 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 · Create a new kit and open its editor
/kitscore delete · Delete a kit
/kitscore duplicate · Duplicate a kit
/kitscore give · 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 [hours] · Create a voucher
/kitscore voucher give · 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. · — · 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_% · Remaining cooldown (formatted)
%kitscore_kit_available_% · true / false
%kitscore_kit_uses_% · 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.