🎒 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

🔐 Permissions

⚙️ 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