Minecraft-plugin PlayerKits2

🔌 About PlayerKits 2

PlayerKits 2 is a Minecraft plugin for creating and distributing configurable survival kits via a clean in-game GUI. It is designed so server administrators can define kit contents, display items, claim requirements, and automated behaviours while players claim kits through a menu or commands.

🎯 Purpose

The plugin solves kit management for survival/SMP and networked servers that need: configurable kit inventories, claim rules (cooldowns, permissions, one-time kits), kit previews and first-join kits. It is oriented at server owners, admins, and moderators who require a flexible kit system with GUI editing and runtime control.

⚙️ Features

• Create and edit kits from your inventory or via an in-game kit editor GUI.
• Configurable kit properties: cooldowns, one-time flags, permission requirements, auto-armor and auto-offhand.
• Multiple kit display states (default, no-permission, on-cooldown, one-time, requirement states).
• Kit claim requirements: price handling and PlaceholderAPI-enabled variable checks.
• Kit actions support (commands on claim / on error).
• Kit preview and configurable drop behaviour when player inventory is full.
• First-join kit support and configurable defaults for new kits.
• Optional MySQL-backed storage for kit data.
• Works on a broad range of Minecraft versions (plugin advertises support for 1.8+).

🧩 Who It Is For

• Survival and SMP servers that want curated starter or timed kits.
• Servers using GUI-focused administration for non-technical staff.
• Servers that need placeholder-driven requirements (PlaceholderAPI users).
• Admins who prefer in-game editing of kit contents and properties.

🏗️ Example Use Cases

• Offer starter kits to new players with a first-join kit.
• Provide role-based kits that require a permission node and have cooldowns.
• Give timed event kits to players via the kit GUI or direct commands.
• Use MySQL storage to share kit cooldown/state across multiple server instances.

⌨️ Commands

⚙️ Installation

📥 Setup

• Download the plugin JAR and place it in your server's plugins/ directory.
• Start or restart the server and check the server console for successful plugin load messages.

📦 Dependencies

• PlaceholderAPI (supported for item name/lore placeholders).
• MySQL is supported as an optional storage backend (database setup is optional and documented by the author).

🧾 Configuration

• Kits and GUI layouts are configurable via the plugin configuration and the in-game editors.
• The plugin stores kit definitions and supports configurable defaults for new kits.

🧠 Technical Notes

• The plugin advertises compatibility with a wide range of Minecraft versions (the author documents support for versions from 1.8 upward).
• Source code is published under an MIT license.
• Support and issue reporting are handled via the plugin resource page and the project's issue tracker.

🤝 When This Plugin Is Useful

If you need a GUI-driven, highly configurable kit system with placeholder support and optional database-backed storage, PlayerKits 2 provides a clear workflow for creating, editing, and enforcing kit rules for players and admins.