🎁 OutPlayerKits — Ultimate Kit Management System

The most advanced, feature-rich kit management plugin for Minecraft. Beautiful GUIs, stunning effects, and complete customization for your server's kits.

🌟 About OutPlayerKits

OutPlayerKits is not just another kit plugin — it's a complete kit management ecosystem for your Minecraft server. Unlike standard plugins that offer basic kit functionality, OutPlayerKits delivers a professional experience with beautiful GUI design, stunning visual feedback, and unparalleled customization options.

Whether you're running a small survival server with friends or a large network with hundreds of players, OutPlayerKits adapts to your needs with its flexible configuration system, per-kit permissions, cooldowns, and an intuitive in-game editor.

✨ Feature Showcase

🎨 GUI & Design

Feature	Description
Pattern-Based GUI Designer	Create stunning kit menus with custom patterns, borders, and layouts
RGB Color Support	Full RGB hex color support for all messages and display names
Preview Mode	Right-click any kit to preview its contents before claiming
Custom Icons	Every kit can have its own unique icon with custom lore

⏱️ Kit Management

Feature	Description
Per-Kit Cooldowns	Individual cooldowns for each kit with fancy time formatting
Permission System	Granular permission control for each kit (`outplayerkits.kit.<name>`)
Auto-Armor	Automatically equips armor to the correct slots
Unlimited Kits	Create as many kits as you want with unlimited items

🛠️ Admin Features

Feature	Description
In-Game Editor	Create and edit kits directly in-game with an intuitive GUI
Slot Selection	Drag-and-drop style slot selection for kit placement
Item Editing	Add/remove items by simply placing them in the editor
Cooldown Bypass	Permission to bypass all cooldowns
Give Command	Give any kit to any player with `/kit give <player> <kit>`

🔊 Audio & Visual

Feature	Description
Custom Sounds	15+ configurable sounds for every action
Status Indicators	Visual indicators for enabled/disabled features
Success/Error Feedback	Clear visual and audio feedback for all actions
Cooldown Display	Beautiful cooldown display with CLOCK icon and formatted time

📊 bStats Metrics

OutPlayerKits uses bStats to collect anonymous usage statistics. This helps us improve the plugin based on real usage data. Below is the live statistics chart for OutPlayerKits:

[1](https://bstats.org/plugin/bukkit/OutRTP/29965)

---

📥 Installation Guide

1️⃣	Download — Get the latest `.jar` from Modrinth
2️⃣	Install — Place the JAR into your server's `plugins/` folder
3️⃣	Restart — Restart your server (or use `/reload` if you must)
4️⃣	Configure — Edit `plugins/OutPlayerKits/config.yml` to your liking
5️⃣	Create Kits! — Use `/kit create` to start making your first kit

⚠️ Important: A full server restart is strongly recommended over /reload for optimal performance and to avoid any plugin conflicts.

🎮 Commands & Permissions

👤 Player Commands

Command	Description	Permission	Default
`/kit`	Open the kits GUI	`outplayerkits.use`	✅ All players
`/kit help`	Show help menu	`outplayerkits.use`	✅ All players
`/kit <kitname>`	Claim a specific kit directly	`outplayerkits.kit.<kitname>`	❌ Per-kit basis

👑 Admin Commands

Command	Description	Permission	Default
`/kit create <name>`	Create a new kit	`outplayerkits.admin`	❌ Ops only
`/kit delete <name>`	Delete an existing kit	`outplayerkits.admin`	❌ Ops only
`/kit edit <name>`	Edit a kit's settings	`outplayerkits.admin`	❌ Ops only
`/kit give <player> <kit>`	Give a kit to a player	`outplayerkits.admin`	❌ Ops only
`/kit reload`	Reload configuration	`outplayerkits.admin`	❌ Ops only

🔑 Advanced Permissions

Permission	Description	Default
`outplayerkits.*`	All permissions	❌ Ops only
`outplayerkits.admin`	All admin commands	❌ Ops only
`outplayerkits.bypass.cooldown`	Ignore all kit cooldowns	❌ Ops only
`outplayerkits.kit.*`	Access to all kits	❌ Ops only
`outplayerkits.kit.<kitname>`	Access to specific kit	✅ All players (configurable)

⚙️ Configuration Deep Dive

📁 ɢᴜɪ ᴄᴏɴғɪɢᴜʀᴀᴛɪᴏɴ


gui:
  # Main kits menu title - supports RGB colors (&x&R&R&G&G&B&B format)
  title: "&x&E&5&4&1&E&7ᴏ&x&D&E&3&B&E&0ᴜ&x&D&6&3&5&D&Aᴛ&x&C&F&2&F&D&3ᴘ&x&C&8&2&9&C&Dʟ&x&C&1&2&3&C&6ᴀ&x&B&9&1&E&C&0ʏ&x&B&2&1&8&B&9ʀ&x&A&B&1&2&B&3ᴋ&x&A&4&0&C&A&Cɪ&x&9&C&0&6&A&6ᴛ&x&9&5&0&0&9&Fs"
  
  # Preview menu title when right-clicking a kit
  preview-title: "&8ᴘʀᴇᴠɪᴇᴡ: &e%kit%"

  # Edit menu title (admin only)
  edit-menu-title: "&8⚙ ● &bᴇᴅɪᴛ ᴋɪᴛ ● &8⚙"

  # Slot selection menu title
  slot-selection-title: "&8⚙ ● &aꜱᴇʟᴇᴄᴛ ꜱʟᴏᴛ ● &8⚙"

  # Icon editing menu title
  icon-edit-title: "&8⚙ ● &e%type% ɪᴄᴏɴ ● &8⚙"

  # Items editing menu title
  items-edit-title: "&8⚙ ● &aᴇᴅɪᴛ ɪᴛᴇᴍꜱ ● &8⚙"

  # GUI size (must be multiple of 9: 9, 18, 27, 36, 45, 54)
  size: 54

  # =================================
  # PATTERN SYSTEM - Design your GUI
  # ================================
  # Format: "MATERIAL:SLOTS:NAME" (name is optional)
  # SLOTS can be:
  #   - Single number: 5
  #   - Range: 10-15 (includes 10,11,12,13,14,15)
  #   - Mixed: 1,2,5-10,20,25-30
  #   - All remaining: "all" (fills empty slots)
  # Patterns are applied in order, later patterns won't overwrite earlier ones
  patterns:
    # Border pattern - fills the edges with black glass
    - "BLACK_STAINED_GLASS_PANE:0-8,45-53,9,17,16,37,43,10,18,26,27,35,36,44:　"

  # ==============================
  #  Where kits will be displayed
  # ==============================
  center:
    # Width of center area (in columns, max 9)
    width: 5
    # Height of center area (in rows)
    height: 4
    # Starting row (0 = top row, 1 = second row, etc.)
    start-row: 1
    # Alternative: you can define exact slots instead of dimensions
    # slots: 10-16,19-25,28-34,37-43

  # ================
  # COOLDOWN DISPLAY
  # ================
  cooldown-display:
    # Enable cooldown display
    enabled: true
    # Material to show when kit is on cooldown
    material: "CLOCK"
    # Display name - supports placeholders:
    # %kit% - kit name
    # %time% - formatted cooldown time
    # %seconds% - cooldown in seconds
    name: "%kit% - &e%time%"
    # Lore (description) when hovering
    lore:
      - "&7ʀᴇʟᴏᴀᴅɪɴɢ"
    # Replace the kit icon with cooldown icon? (true/false)
    # If false, keeps original icon but adds cooldown info
    replace-icon: true

# ========
# MESSAGES
# ========
messages:
  chat-prefix: "[&x&E&5&4&1&E&7ᴏ&x&D&E&3&B&E&0ᴜ&x&D&6&3&5&D&Aᴛ&x&C&F&2&F&D&3ᴘ&x&C&8&2&9&C&Dʟ&x&C&1&2&3&C&6ᴀ&x&B&9&1&E&C&0ʏ&x&B&2&1&8&B&9ʀ&x&A&B&1&2&B&3ᴋ&x&A&4&0&C&A&Cɪ&x&9&C&0&6&A&6ᴛ&x&9&5&0&0&9&Fs&f] "
  gui-prefix: "&x&E&5&4&1&E&7ᴏ&x&D&E&3&B&E&0ᴜ&x&D&6&3&5&D&Aᴛ&x&C&F&2&F&D&3ᴘ&x&C&8&2&9&C&Dʟ&x&C&1&2&3&C&6ᴀ&x&B&9&1&E&C&0ʏ&x&B&2&1&8&B&9ʀ&x&A&B&1&2&B&3ᴋ&x&A&4&0&C&A&Cɪ&x&9&C&0&6&A&6ᴛ&x&9&5&0&0&9&Fs"

  # Success messages
  kit-received: "&aʏᴏᴜ ʀᴇᴄᴇɪᴠᴇᴅ &f%kit%&a!"
  kit-created: "&aᴋɪᴛ &f%kit% &aᴄʀᴇᴀᴛᴇᴅ!"
  kit-deleted: "&aᴋɪᴛ &f%kit% &aᴅᴇʟᴇᴛᴇᴅ!"
  give-success: "&aɢᴀᴠᴇ &f%kit% &aᴛᴏ &e%player%"
  reloaded: "&aᴄᴏɴꜰɪɢᴜʀᴀᴛɪᴏɴ ʀᴇʟᴏᴀᴅᴇᴅ!"
  settings-saved: "&aꜱᴇᴛᴛɪɴɢꜱ ꜱᴀᴠᴇᴅ!"
  icon-saved: "&aɪᴄᴏɴ ꜱᴀᴠᴇᴅ!"
  items-saved: "&aᴋɪᴛ ɪᴛᴇᴍꜱ ꜱᴀᴠᴇᴅ!"

  # Error messages
  no-permission: "&cʏᴏᴜ ᴅᴏɴ'ᴛ ʜᴀᴠᴇ ᴘᴇʀᴍɪꜱꜱɪᴏɴ!"
  kit-not-exists: "&cᴋɪᴛ ᴅᴏᴇꜱɴ'ᴛ ᴇxɪꜱᴛ!"
  kit-already-exists: "&cᴋɪᴛ ᴀʟʀᴇᴀᴅʏ ᴇxɪꜱᴛꜱ!"
  inventory-full: "&cʏᴏᴜʀ ɪɴᴠᴇɴᴛᴏʀʏ ɪꜱ ꜰᴜʟʟ!"
  inventory-empty: "&cʏᴏᴜʀ ɪɴᴠᴇɴᴛᴏʀʏ ɪꜱ ᴇᴍᴘᴛʏ!"
  player-not-found: "&cᴘʟᴀʏᴇʀ ɴᴏᴛ ꜰᴏᴜɴᴅ!"
  must-be-player: "&cᴏɴʟʏ ᴘʟᴀʏᴇʀꜱ ᴄᴀɴ ᴜꜱᴇ ᴛʜɪꜱ ᴄᴏᴍᴍᴀɴᴅ!"
  enter-valid-number: "&cᴘʟᴇᴀꜱᴇ ᴇɴᴛᴇʀ ᴀ ᴠᴀʟɪᴅ ɴᴜᴍʙᴇʀ!"
  slot-occupied: "&cᴛʜɪꜱ ꜱʟᴏᴛ ɪꜱ ᴀʟʀᴇᴀᴅʏ ᴏᴄᴄᴜᴘɪᴇᴅ!"
  slot-selected: "&aꜱʟᴏᴛ ꜱᴇᴛ ᴛᴏ &f%slot%&a!"

  # Cooldown messages
  cooldown: "&cᴘʟᴇᴀꜱᴇ ᴡᴀɪᴛ &f%time%"
  cooldown-format: "%dd %dh %dm %ds"  # Format for time display
  cooldown-remaining: "&cᴄᴏᴏʟᴅᴏᴡɴ ʀᴇᴍᴀɪɴɪɴɢ: &e%time%"

  # Input prompts
  enter-cooldown: "&aᴇɴᴛᴇʀ ɴᴇᴡ ᴄᴏᴏʟᴅᴏᴡɴ ɪɴ ꜱᴇᴄᴏɴᴅꜱ:"
  place-item-here: "&7ᴘʟᴀᴄᴇ ᴛʜᴇ ɪᴛᴇᴍ ɪɴ ᴛʜᴇ ᴄᴇɴᴛᴇʀ"
  save-items: "&a&l✔ ꜱᴀᴠᴇ ɪᴛᴇᴍꜱ"

  # Status indicators
  status-enabled: "&a✔"
  status-disabled: "&c✘"
  click-to-edit: "&7ᴄʟɪᴄᴋ ᴛᴏ ᴇᴅɪᴛ"
  current-value: "&7ᴄᴜʀʀᴇɴᴛ: &f%value%"
  save-and-exit: "&a&l✔ ꜱᴀᴠᴇ"
  go-back: "&e◀ ʙᴀᴄᴋ"
  info: "&6&lⓘ ɪɴꜰᴏ"

  # Button descriptions
  cooldown-info: "&7ᴄʟɪᴄᴋ ᴛᴏ ꜱᴇᴛ ᴄᴏᴏʟᴅᴏᴡɴ"
  permission-info: "&7ᴛᴏɢɢʟᴇ ᴘᴇʀᴍɪꜱꜱɪᴏɴ"
  autoarmor-info: "&7ᴀᴜᴛᴏ-ᴇǫᴜɪᴘ ᴀʀᴍᴏʀ"
  items-info: "&7ᴇᴅɪᴛ ᴋɪᴛ ɪᴛᴇᴍꜱ"

# =====
# SOUND
# =====
sounds:
  # Master toggle - disable all sounds
  enabled: true

  # Sound when opening any GUI
  gui-open:
    enabled: true
    sound: "BLOCK_CHEST_OPEN"
    volume: 0.5
    pitch: 1.0

  # Sound when clicking buttons in GUI
  gui-click:
    enabled: true
    sound: "UI_BUTTON_CLICK"
    volume: 0.5
    pitch: 1.0

  # Sound when receiving a kit
  kit-receive:
    enabled: true
    sound: "ENTITY_PLAYER_LEVELUP"
    volume: 0.5
    pitch: 1.0

  # Sound for errors
  error:
    enabled: true
    sound: "BLOCK_ANVIL_LAND"
    volume: 0.5
    pitch: 1.0

  # Sound for successful actions
  success:
    enabled: true
    sound: "ENTITY_PLAYER_LEVELUP"
    volume: 0.5
    pitch: 1.0

  # Sound when saving settings
  save:
    enabled: true
    sound: "BLOCK_NOTE_BLOCK_PLING"
    volume: 0.5
    pitch: 1.0

  # Sound when going back in menus
  back:
    enabled: true
    sound: "UI_BUTTON_CLICK"
    volume: 0.5
    pitch: 1.0

  # Sound when toggling settings
  toggle:
    enabled: true
    sound: "UI_BUTTON_CLICK"
    volume: 0.5
    pitch: 1.2

  # Sound when selecting a slot
  slot-select:
    enabled: true
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
    volume: 0.5
    pitch: 1.0

  # Sound when setting cooldown
  cooldown-set:
    enabled: true
    sound: "BLOCK_NOTE_BLOCK_PLING"
    volume: 0.5
    pitch: 1.0

  # Sound when placing item
  item-place:
    enabled: true
    sound: "ENTITY_ITEM_PICKUP"
    volume: 0.5
    pitch: 1.0

  # Sound when taking item
  item-take:
    enabled: true
    sound: "ENTITY_ITEM_PICKUP"
    volume: 0.5
    pitch: 0.8

  # Sound when clicking on cooldown item
  cooldown-click:
    enabled: true
    sound: "UI_BUTTON_CLICK"
    volume: 0.5
    pitch: 0.8
</details><details> <summary>📁 ᴘʟᴜɢɪɴ.ʏᴍʟ</summary>
yaml
name: OutPlayerKits
version: 1.6.2
main: studio.vissed.OutPlayerKits
api-version: "1.21"
author: Vissed Studio
description: Best kit management plugin for 1.21.7+

commands:
  kit:
    description: Main kit command
    usage: /<command> [kit/give/reload/create/delete/edit]
    aliases: [kits]
    permission: outplayerkits.use

permissions:
  outplayerkits.*:
    description: All permissions
    default: op
    children:
      outplayerkits.use: true
      outplayerkits.admin: true
      outplayerkits.bypass.cooldown: true
      outplayerkits.kit.*: true

  outplayerkits.use:
    description: Use /kit command and open GUI
    default: true

  outplayerkits.admin:
    description: Admin permissions for managing kits
    default: op
    children:
      outplayerkits.use: true
      outplayerkits.bypass.cooldown: true
      outplayerkits.kit.*: true

  outplayerkits.kit.*:
    description: Access to all kits
    default: op
    children:
      outplayerkits.use: true

  outplayerkits.bypass.cooldown:
    description: Bypass cooldowns
    default: op

  outplayerkits.kit.<kitname>:
    description: Access to specific kit
    default: true
</details>
🔧 Compatibility
Server Software	Support	Notes
Paper 1.21.7+	✅ Full	Recommended
Purpur 1.21.7+	✅ Full	Fully compatible
Spigot 1.21.7+	✅ Full	May have minor performance differences
CraftBukkit	⚠️ Limited	Not recommended
Older versions	❌ No	Upgrade to 1.21.7+
❓ Frequently Asked Questions
<details> <summary>❓ How do I create my first kit?</summary>
Simply type /kit create <name> and follow the in-game GUI editor! The plugin will guide you through setting up the icon, items, cooldown, and permissions.

</details><details> <summary>❓ Can I use RGB colors in kit names?</summary>
Yes! OutPlayerKits supports full RGB hex colors using the format &x&R&R&G&G&B&B. Check the config.yml for examples.

</details><details> <summary>❓ How does auto-armor work?</summary>
When auto-armor is enabled, any armor pieces in the kit will be automatically equipped to the correct slots (helmet, chestplate, leggings, boots) when a player claims the kit.

</details><details> <summary>❓ Can I give a kit to another player?</summary>
Yes! Admins can use /kit give <player> <kitname> to give any kit to any player, bypassing permissions and cooldowns.

</details><details> <summary>❓ What's the difference between kit preview and claiming?</summary>
Left-click a kit → Claim it (if you have permission and no cooldown)

Right-click a kit → Preview its contents without claiming

</details>

OutPlayerKits