🎒 KitsFlow

A lightweight, feature-rich kit plugin for Minecraft SMP servers. Create, manage and distribute kits through a clean GUI or simple commands — fully compatible with servers.

---

✨ Features

🎒 Kit System

Create kits directly from your inventory — items, armor and offhand included. Players can claim kits via command or through an interactive GUI. Each kit is fully configurable after creation.

🖥️ Interactive GUI

Open the kit menu with /kit — each kit displays its icon, cooldown status and remaining uses. Click a kit to claim it instantly.

⚙️ Kit Configuration GUI

After creating a kit, a configuration GUI opens automatically. Set the display name, permission node, cooldown, max uses, clear-inventory behavior and menu icon — all without editing any file.

🖼️ Custom Kit Icons

Set any item as the kit's icon in the menu by holding it in your main hand and typing /kitf confirm-icon after clicking the icon slot in the config GUI.

⏳ Cooldown & Max Uses

Each kit supports an independent cooldown and a maximum number of uses per player. Set either to 0 / -1 to disable them. Ops and players with kitsflow.bypass.cooldown or kitsflow.bypass.maxuses can bypass these limits.

🛡️ Admin Commands

Operators and players with the kitsflow.admin permission can create, edit, delete, list and force-give kits to any online player — all through the /kitf subcommand system.

📡 Developer API

KitsFlow exposes a clean public API to give kits, query cooldowns, check remaining uses and list all kits — ready to be used by other plugins.

⚙️ Full Config Support

Customize broadcast messages on kit claim — all from config.yml. Reload without restarting with /kitf reload.

---

📋 Commands

Command	Description
/kit	Open the kit menu GUI
/kit <name>	Claim a specific kit directly
/kitf menu	Open the kit menu GUI
/kitf create <id>	Start kit creation from your current inventory
/kitf confirm	Confirm kit creation
/kitf confirm cancel	Cancel kit creation
/kitf confirm-icon	Set the held item as the kit's menu icon
/kitf edit <id>	Open the configuration GUI for a kit
/kitf delete <id>	Delete a kit
/kitf give <id> <player>	Force-give a kit to a player
/kitf list	List all existing kits
/kitf reload	Reload the config
/kitf credits	Show plugin credits

---

🔐 Permissions

Permission	Description
kitsflow.admin	Access to all /kitf admin subcommands
kitsflow.kit.<id>	Access to a specific kit
kitsflow.bypass.cooldown	Bypass kit cooldowns
kitsflow.bypass.maxuses	Bypass kit max uses

---

⚙️ Config

# KitsFlow Configuration

menu:
  title: "§5§lKits"

broadcast-on-kit-get: false
broadcast-format: "§7{player} §fgot the §5{kit} §fkit!"

---

📦 Installation

Drop the .jar into your plugins/ folder and restart your server. No dependencies required.

---

🔧 Compatibility

• ✅ Paper / Spigot
• ✅ Minecraft 1.21.x // 26.x.x

---

🧩 API Usage

KitsFlowAPI api = KitsFlow.getInstance().getAPI();

// Give a kit to a player
api.giveKit(player, "starter");

// Give a kit ignoring cooldown and max uses
api.giveKit(player, "vip", true, true);

// Check cooldown remaining (in seconds)
long remaining = api.getCooldownRemaining(player, "starter");

// Check uses remaining (-1 = unlimited)
int uses = api.getUsesRemaining(player, "starter");

// Get all kits
Collection<Kit> kits = api.getAllKits();

---

Made with ❤️ by Gregwll