A comprehensive Minecraft Spigot plugin for creating custom kit duels with advanced features, beautiful GUIs, and modern text formatting.

• Custom Kit Creation: Create unlimited custom kits with intuitive GUI
• Kit Settings: Configure kit health (1-30 hearts) and natural regeneration
• Bulk Mode: Quickly fill multiple slots with the same item
• Rounds Duels: First-to-X rounds system with live scoreboard
• Item Modification: Enchant items, change stack sizes, modify potions
• Arena System: Multiple arenas with automatic regeneration support
• Health Indicators: Real-time health display with multiple methods

• Rounds-based Duels: Choose from 1-10 rounds to win
• Live Scoreboard: Real-time duel statistics with hex colors and gradients
• Countdown System: 5-second countdown with note block sounds
• Inventory Management: 2-second preparation time between rounds
• Arena Regeneration: Automatic arena restoration using FAWE
• Health Display: Multiple methods for showing player health

• Arena Management: Create and configure arenas with GUI editor
• Spawn System: Set global spawn point for post-duel teleportation
• Category Editor: Customize item categories for kit creation
• Configuration: Extensive customization options with modern formatting
• Permissions: Granular permission system

• Adventure API (4.14.0): Modern text components and hex color support
• Adventure Platform Bukkit (4.3.2): Bukkit integration for Adventure
• Adventure Text MiniMessage (4.14.0): Advanced text parsing and formatting
• FastBoard (2.0.3): High-performance scoreboards with better update handling

• HolographicDisplays (3.0.0): Enhanced floating health displays (soft dependency)
• ProtocolLib (5.1.0): Packet-based health displays (soft dependency)

1. Adventure API:

   • Provides modern text components
   • Full hex color support (#RRGGBB)
   • Gradient and rainbow text effects
   • Better Unicode support

2. FastBoard:

   • High-performance scoreboard implementation
   • Automatic line length handling
   • Better update performance than vanilla Bukkit scoreboards
   • Flicker-free updates

3. MiniMessage:

   • Modern text formatting syntax
   • Supports gradients: <gradient:#start:#end>text</gradient>
   • Supports hex colors: <#RRGGBB> or &#RRGGBB
   • Named colors: <red>, <green>, etc.

4. HolographicDisplays (Optional):

   • Creates floating text above players
   • Better visual health indicators
   • More immersive experience

5. ProtocolLib (Optional):

   • Packet manipulation for advanced features
   • Custom health display methods
   • Enhanced compatibility

/ckd createkit <name>     - Create a new custom kit
/ckd editkit <name>       - Edit an existing kit
/ckd deletekit <name>     - Delete a kit
/ckd listkits             - List your kits
/ckd duel <player>        - Challenge a player to a duel (opens kit selector)
/ckd leave                - Leave current duel (gives win to opponent)

/ckd arena create <name>     - Create a new arena
/ckd arena editor            - Open arena selection GUI
/ckd arena list              - List all arenas
/ckd arena delete <name>     - Delete an arena
/ckd setspawn                - Set the global spawn point
/ckd editcategory <category> - Edit item categories
/ckd reload                  - Reload configuration

1. Download the plugin JAR file
2. Place it in your server's plugins folder
3. Restart your server
4. Optional: Install HolographicDisplays and/or ProtocolLib for enhanced features
5. Configure arenas using admin commands
6. Set spawn with /ckd setspawn
7. Players can start creating kits and dueling!

settings:
  max-kits-per-player: 10
  duel-request-timeout: 30
  blocked-commands:
    - "tp"
    - "teleport"
    - "home"

Now supports MiniMessage format with hex colors and gradients:

title: "<gradient:#00FF98:#C3F6E2><bold>PakMC</bold></gradient>"
lines:
  - " "
  - " <#00FF98><bold>DUEL</bold> <gray>(FT<#C3F6E2><rounds></gray>)"
  - " <#C3F6E2>│ Duration: <#00FF98><duration>"
  - " <#C3F6E2>│ Round: <#00FF98><current_round>"
  - " "
  - " <#00FF98><bold>SCORE</bold>"
  - " <#C3F6E2>│ <green><player_score></green> - <red><opponent_score></red>"
  - " <#C3F6E2>│ <gray><player_name> vs <opponent_name></gray>"
  - " "
  - "    <#C3F6E2>pakmc.xyz"

Enhanced Formatting Options:

• Hex Colors: <#RRGGBB> or &#RRGGBB
• Named Colors: <red>, <green>, <blue>, etc.
• Gradients: <gradient:#start:#end>text</gradient>
• Rainbow: <rainbow>text</rainbow>
• Bold/Italic: <bold>, <italic>, <underlined>

Available Placeholders:

• <rounds> - Target rounds to win
• <duration> - Duel duration (MM:SS)
• <current_round> - Current round number
• <player_score> - Player's wins
• <opponent_score> - Opponent's wins
• <player_name> - Player's name
• <opponent_name> - Opponent's name

1. Create Arena: /ckd arena create <name>
2. Open Editor: /ckd arena editor
3. Select Arena from the GUI
4. Set Positions: Use Shift+Left-click in air to set corners and spawn points
5. Enable Regeneration: Toggle arena regeneration (requires FAWE)
6. Save: Click the save button

• Position 1 & 2: Define arena boundaries
• Spawn Point 1 & 2: Player spawn locations
• FAWE Plugin: Required for arena regeneration

1. Use /ckd createkit <name>
2. Add Items: Left-click empty slots to browse categories
3. Modify Items: Right-click items to enchant/modify
4. Bulk Mode: Shift-click for quick item placement
5. Kit Settings: Configure health and regeneration
6. Save: Click the emerald to save your kit

• Hearts: Set player health (1-30 hearts) - now supports more than 20!
• Natural Regen: Enable/disable health regeneration from saturation
• Health Indicators: Enable/disable visual health display during duels

• Activate: Shift-click any slot or use the bulk button
• Quick Fill: Click multiple slots to place the same item
• Exit: Right-click the bulk mode button

1. Challenge: /ckd duel <player>
2. Select Kit: Choose from your available kits
3. Select Rounds: Choose 1-10 rounds to win
4. Accept: Target player clicks the accept button in chat
5. Countdown: 4-second preparation countdown
6. Fight: Duel begins!

• Use /ckd leave to forfeit and give the win to your opponent
• Automatically restores your inventory and teleports you to spawn
• Works during countdown, active duel, or rounds duel

• Win Condition: First to reach target rounds wins
• Round End: Player death ends the round
• Preparation: 2-second break + 5-second countdown
• Live Scoreboard: Real-time updates with beautiful formatting
• Health Display: Multiple methods for showing player health
• Arena Regen: Automatic restoration between rounds

• Restoration: Players are restored to original state
• Teleport: 2-second delay, then teleport to spawn
• Cleanup: All displays and effects are properly cleaned up

customkitduels.create:
  description: Create kits
  default: true

customkitduels.edit:
  description: Edit kits
  default: true

customkitduels.delete:
  description: Delete kits
  default: true

customkitduels.list:
  description: List kits
  default: true

customkitduels.duel:
  description: Challenge players to duels
  default: true

customkitduels.leave:
  description: Leave current duel
  default: true

customkitduels.arena:
  description: Arena management commands
  default: op

customkitduels.setspawn:
  description: Set global spawn point
  default: op

customkitduels.editcategory:
  description: Edit item categories
  default: op

customkitduels.reload:
  description: Reload plugin configuration
  default: op

customkitduels.use:
  description: Basic plugin usage (includes all basic permissions)
  default: true
  children:
    - customkitduels.create
    - customkitduels.edit
    - customkitduels.delete
    - customkitduels.list
    - customkitduels.duel
    - customkitduels.leave

customkitduels.admin:
  description: Admin commands and features (includes all permissions)
  default: op
  children:
    - customkitduels.use
    - customkitduels.arena
    - customkitduels.setspawn
    - customkitduels.editcategory
    - customkitduels.reload

• Spigot/Paper: 1.21.4+
• Java: 21+

• FastAsyncWorldEdit (FAWE): For arena regeneration
• WorldEdit: Alternative to FAWE (limited features)
• Multiverse-Core: For loading arenas from Multiverse worlds
• Multiverse-Core: For loading arenas from Multiverse worlds
• HolographicDisplays: For enhanced floating health displays
• ProtocolLib: For packet-based health displays

plugins/CustomKitDuels/
├── config.yml              # Main configuration
├── scoreboard.yml           # Enhanced scoreboard with MiniMessage
├── spawn.yml               # Spawn location
├── menus/                  # Customizable menu configurations
│   ├── rounds.yml          # Rounds selector menu
│   └── kits.yml            # Kit selector menu
├── arenas/                 # Arena configurations
│   ├── arena1.yml
│   └── arena2.yml
├── categories/             # Item categories
│   ├── WEAPONS.yml
│   ├── ARMOR.yml
│   └── ...
├── kits/                   # Player kits
│   └── <uuid>.yml
├── kit-settings/           # Kit configurations
│   └── <uuid>.yml
└── schematics/             # Arena schematics (FAWE)
    ├── arena1_arena.schem
    └── arena2_arena.schem

The plugin now supports fully customizable menus through YAML files:

• menus/rounds.yml: Configure the rounds selection GUI
• menus/kits.yml: Configure the kit selection GUI
• All menus support custom titles, items, lore, and placeholders
• Reload with /ckd reload to apply changes

The new scoreboard system supports advanced formatting:

# Gradient title
title: "<gradient:#00FF98:#C3F6E2><bold>PakMC</bold></gradient>"

# Hex colors and formatting
lines:
  - "<#FF0000>Red text"
  - "<gradient:#FF0000:#00FF00>Rainbow gradient</gradient>"
  - "<rainbow>Rainbow text</rainbow>"
  - "<bold><italic>Bold and italic</italic></bold>"

The plugin now supports multiple health display methods:

1. Custom Name: Shows health below player name (most compatible)
2. HolographicDisplays: Floating text above players (requires plugin)
3. ProtocolLib: Packet-based displays (requires plugin)

Scoreboard not showing properly

• Ensure you're using valid MiniMessage syntax
• Check for syntax errors in scoreboard.yml
• Restart server after configuration changes

Health indicators not working

• Check if health indicators are enabled in kit settings
• Install HolographicDisplays or ProtocolLib for enhanced features
• Verify console for any error messages

Colors not displaying

• Ensure your client supports the color format
• Use legacy color codes (&a, &b) for older clients
• Check that Adventure API is properly loaded

Arena regeneration not working

• Install FastAsyncWorldEdit (FAWE)
• Ensure arena positions are set
• Check console for errors

• FastBoard provides better performance than vanilla scoreboards
• Health display updates every 0.5 seconds for optimal performance
• Use gradients sparingly for better performance
• Regular server restarts for optimal performance

For issues, suggestions, or contributions:

• Check the console for error messages
• Verify all dependencies are installed
• Ensure proper permissions are set
• Test with minimal plugins to isolate conflicts

This plugin is provided as-is for educational and server use. Please respect the terms of use for any dependencies.

Version: 1.0.0
Minecraft: 1.21.4
Java: 21+
Enhanced with: Adventure API, FastBoard, MiniMessage