EasyKits+

EasyKits+

EasyKits+ is an advanced, easy-to-use, and performance-oriented kit management plugin for your Minecraft server. Specially designed for Paper 1.21x, it allows you to manage all kit configuration processes effortlessly from within the game. You no longer have to deal with long and complex YAML files!

✨ Features

• In-Game Kit Creation: Saves all items in your inventory (including armor and off-hand) by copying them exactly with their enchantments, NBT data, custom models, and names.

• Advanced GUI Menu: Offers a user-friendly and stylish menu that players can access with the /kits command.

• Kit Preview System: Before claiming any kit, you can Right-Click on the kit in the menu to transparently see exactly what kind of items are inside.

• Visual "Locked" States: Kits for which the player does not have the necessary permission appear as locked (Gray Glass) in the menu. Information on how to obtain the kit is included in the description along with the permission info.

• Dynamic Permission System: The moment you create a new kit (e.g., vip), the permission required for players to claim that kit is automatically defined (easykits.kit.vip).

• One-Time Use Kits: You can create special starter or reward kits that can only be claimed once.

• Independent Cooldowns: Special waiting/cooldown periods can be set individually for each kit in seconds.

• PlaceholderAPI Support: You can display kit-specific cooldowns instantly in Tablists, Scoreboards, or other menu plugins.

• Flawless Data Logging: Custom Model Data, colored leather armor, custom heads (skulls), and advanced enchantments added to your items are kept on the server without any loss using Base64 encoding.

🛡️ Automatic Kit Permissions:

For example, when you type /kit create player in-game; It creates an automatic permission for this kit. For instance, if you name the kit "Starter", it will automatically create the permission as easykits.kit.starter.

📖 Usage Guide

How to Create a Kit?

Arrange your own inventory in-game with the items you want to give. (Armor slots and off-hand are also included in the kit.)

• Enter the /kit create command via chat. Example: /kit create starter

• Kit created successfully! You can now give the easykits.kit.starter permission to your players.

- How to Claim or Preview a Kit?

• A player types the /kits command.

• Kits for which they have permission appear in the menu with their normal item icons.

• Left-Click to instantly claim the kit and transfer it to the inventory.

• Right-Click (Preview) to see the items inside the kit in full size and inspect them.

Commands and Permissions

• /kits the main kit menuNone (Everyone can use)
• /kit create Saves your inventory as a kit with that name easykits.admin
• /kit delete Completely deletes an existing kit from the system easykits.admin
• /kit setcooldown Sets the in-game cooldown for the specified kit easykits.admin

📊 PlaceholderAPI Usage

If PlaceholderAPI is installed on your server, you can use the following variables:

%easykits_cooldown_<kitname>% - Shows the remaining cooldown of the specified kit, whether it is ready for use, or if the right has ended for one-time use kits.

%easykits_has_<kitname>% - Returns true or false indicating whether the player has access to that kit.