🧱 AzDuels - Ultimate Minecraft Dueling Plugin

✨ Features

🗡️ 1v1 Duels - Challenge players to epic battles
👥 Party Duels - Team vs team combat with multiple rounds
🎯 Custom Kits - Create and manage combat loadouts
🏟️ Arena System - Multiple arenas with auto-reset functionality
📊 Spectator Mode - Watch duels in progress
💰 Betting System - Wager on duel outcomes
🏆 Queue System - Automated matchmaking
📈 Scoreboard - Real-time duel statistics
🎨 GUI Menus - User-friendly interfaces
⚙️ Highly Configurable - Customize everything
🔥 FFA Arenas - Free-for-all combat zones
📊 PlaceholderAPI Support - Rich placeholder integration
🏆 Leaderboards - Top player rankings
🎯 Hologram Support - Display statistics with holograms

🎮 Commands & Permissions

👑 Admin Commands

Command	Description	Permission
`/azduels reload`	Reload plugin configuration	`azduels.admin`
`/azduels arena create <name>`	Create a new arena	`azduels.admin`
`/azduels arena delete <name>`	Delete an arena	`azduels.admin`
`/azduels arena enable <name>`	Enable an arena	`azduels.admin`
`/azduels arena disable <name>`	Disable an arena	`azduels.admin`
`/azduels arena list`	List all arenas	`azduels.admin`
`/azduels arena tp <name>`	Teleport to arena	`azduels.admin`
`/azduels kit create <name>`	Create a new kit	`azduels.admin`
`/azduels kit delete <name>`	Delete a kit	`azduels.admin`
`/azduels kit edit <name>`	Edit a kit	`azduels.admin`
`/azduels kit list`	List all kits	`azduels.admin`
`/azduels admin gui`	Open admin GUI	`azduels.admin`
`/azduels stats reset <player>`	Reset player stats	`azduels.admin`
`/azduels forceend`	Force end all duels	`azduels.admin`
`/azduels debug`	Toggle debug mode	`azduels.admin`

🔥 FFA Commands

Command	Description	Permission
`/ffa join`	Join FFA arena selection	`azduels.ffa`
`/ffa join <arena>`	Join specific FFA arena	`azduels.ffa`
`/ffa leave`	Leave current FFA arena	`azduels.ffa`
`/ffa list`	List available FFA arenas	`azduels.ffa`
`/ffa stats`	View your FFA statistics	`azduels.ffa`
`/ffa gui`	Open FFA management GUI	`azduels.ffa`
`/ffa top`	View FFA leaderboards	`azduels.ffa`
`/ffa kit <kit>`	Change FFA kit	`azduels.ffa`

👥 Party Commands

Command	Description	Permission
`/party create`	Create a new party	`azduels.party`
`/party invite <player>`	Invite player to party	`azduels.party`
`/party accept`	Accept party invitation	`azduels.party`
`/party deny`	Deny party invitation	`azduels.party`
`/party leave`	Leave current party	`azduels.party`
`/party kick <player>`	Kick player from party	`azduels.party.leader`
`/party disband`	Disband the party	`azduels.party.leader`
`/party list`	List party members	`azduels.party`
`/party chat`	Toggle party chat	`azduels.party`
`/partyduel <party>`	Challenge another party	`azduels.partyduel`
`/partyduel accept`	Accept party duel request	`azduels.partyduel`
`/partyduel deny`	Deny party duel request	`azduels.partyduel`
`/partyduel gui`	Open party duel GUI	`azduels.partyduel`

👤 Player Commands

Command	Description	Permission
`/duel <player>`	Challenge a player to duel	`azduels.duel`
`/duel accept`	Accept a duel request	`azduels.duel`
`/duel deny`	Deny a duel request	`azduels.duel`
`/duel gui`	Open duel challenge GUI	`azduels.duel`
`/duel stats`	View your duel statistics	`azduels.duel`
`/duel stats <player>`	View another player's stats	`azduels.duel`
`/duel top`	View duel leaderboards	`azduels.duel`
`/spectate <player>`	Spectate a duel	`azduels.spectate`
`/leavefight`	Leave current duel/spectate	`azduels.leavefight`
`/queue join`	Join matchmaking queue	`azduels.queue`
`/queue leave`	Leave matchmaking queue	`azduels.queue`
`/queue status`	Check queue status	`azduels.queue`
`/queue gui`	Open queue selection GUI	`azduels.queue`
`/duel toggle`	Toggle duel requests	`azduels.duel`
`/duel history`	View duel history	`azduels.duel`

📋 Requirements

Minecraft Version: 1.16.5 - 1.20.x
Java Version: 8 or higher
Dependencies:
- Spigot/Paper/Bukkit
- ᴏᴘᴛɪᴏɴᴀʟ: PlaceholderAPI for enhanced placeholders
- ᴏᴘᴛɪᴏɴᴀʟ: DecentHolograms for hologram displays
- ᴏᴘᴛɪᴏɴᴀʟ: DeluxeMenus for custom GUI integration

⚙️ Configuration Example

# AzDuels Configuration
settings:
  # Arena settings
  arenas:
    auto_reset: true
    reset_delay: 5
  
  # Duel settings
  duels:
    countdown_time: 5
    max_rounds: 10
    default_kit: "default"
  
  # Party duel settings
  party_duels:
    enabled: true
    max_party_size: 5
    rounds_to_win: 3
  
  # FFA settings
  ffa:
    enabled: true
    respawn_time: 3
    kill_rewards: true
  
  # Economy settings
  economy:
    enabled: true
    betting_enabled: true
    min_bet: 10.0
    max_bet: 1000.0

# Messages with color codes
messages:
  duel_request: "&6[AzDuels] &a{player} &7has challenged you to a duel!"
  duel_start: "&6[AzDuels] &eDuel starting in &c{countdown} &eseconds!"
  duel_win: "&6[AzDuels] &a{winner} &7has won the duel!"
  party_duel_start: "&6[AzDuels] &eParty duel between &a{party1} &eand &a{party2} &estarting!"

🎯 Color Codes Reference

&0 - Black
&1 - Dark Blue
&2 - Dark Green
&3 - Dark Aqua
&4 - Dark Red
&5 - Dark Purple
&6 - Gold
&7 - Gray
&8 - Dark Gray
&9 - Blue
&a - Green
&b - Aqua
&c - Red
&d - Light Purple
&e - Yellow
&f - White
&l - Bold
&o - Italic
&n - Underline
&m - Strikethrough
&k - Magic
&r - Reset

🏆 Hologram Setup Guide

AzDuels Top 10 Wins Hologram Setup

This guide shows how to create a hologram displaying the top 10 players by wins using DecentHolograms and PlaceholderAPI.

Prerequisites

DecentHolograms plugin installed
PlaceholderAPI plugin installed
AzDuels plugin with PlaceholderAPI expansion registered

Commands to Create the Hologram

1. Create the Hologram

/dh create top_wins_hologram

2. Add Header Lines

/dh addline top_wins_hologram &6&l🏆 TOP 10 DUELISTS 🏆
/dh addline top_wins_hologram &7&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/dh addline top_wins_hologram &e&lRanked by Total Wins
/dh addline top_wins_hologram " "

3. Add Top 10 Player Lines

/dh addline top_wins_hologram &e1. &f%azduels_top_wins_1% &7- &a%azduels_top_wins_value_1% &7wins
/dh addline top_wins_hologram &e2. &f%azduels_top_wins_2% &7- &a%azduels_top_wins_value_2% &7wins
/dh addline top_wins_hologram &e3. &f%azduels_top_wins_3% &7- &a%azduels_top_wins_value_3% &7wins
/dh addline top_wins_hologram &e4. &f%azduels_top_wins_4% &7- &a%azduels_top_wins_value_4% &7wins
/dh addline top_wins_hologram &e5. &f%azduels_top_wins_5% &7- &a%azduels_top_wins_value_5% &7wins
/dh addline top_wins_hologram &e6. &f%azduels_top_wins_6% &7- &a%azduels_top_wins_value_6% &7wins
/dh addline top_wins_hologram &e7. &f%azduels_top_wins_7% &7- &a%azduels_top_wins_value_7% &7wins
/dh addline top_wins_hologram &e8. &f%azduels_top_wins_8% &7- &a%azduels_top_wins_value_8% &7wins
/dh addline top_wins_hologram &e9. &f%azduels_top_wins_9% &7- &a%azduels_top_wins_value_9% &7wins
/dh addline top_wins_hologram &e10. &f%azduels_top_wins_10% &7- &a%azduels_top_wins_value_10% &7wins

4. Add Footer

/dh addline top_wins_hologram " "
/dh addline top_wins_hologram &7&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/dh addline top_wins_hologram &7Updates every 30 seconds

5. Configure Update Interval

/dh setpapi top_wins_hologram 30

6. Position the Hologram

/dh movehere top_wins_hologram

Alternative Leaderboard Types

Top 10 by Kills

Replace the player lines with:

/dh addline top_kills_hologram &e1. &f%azduels_top_kills_1% &7- &c%azduels_top_kills_value_1% &7kills
/dh addline top_kills_hologram &e2. &f%azduels_top_kills_2% &7- &c%azduels_top_kills_value_2% &7kills
# ... continue for positions 3-10

Top 10 by Win Streak

Replace the player lines with:

/dh addline top_streak_hologram &e1. &f%azduels_top_streak_1% &7- &d%azduels_top_streak_value_1% &7streak
/dh addline top_streak_hologram &e2. &f%azduels_top_streak_2% &7- &d%azduels_top_streak_value_2% &7streak
# ... continue for positions 3-10

Useful Management Commands

View Hologram Info

/dh info top_wins_hologram

Delete Hologram

/dh delete top_wins_hologram

List All Holograms

/dh list

Tips

Positioning: Use /dh movehere <hologram_name> while standing where you want the hologram
Height Adjustment: Use /dh move <hologram_name> ~ ~0.5 ~ to move up by 0.5 blocks
Update Frequency: Lower update intervals (like 10-15 seconds) provide more real-time data but may impact performance
Color Codes: Use & for color codes in hologram text
Empty Players: If a position has no player, the placeholder will return an empty string

🎨 DeluxeMenu Integration

DeluxeMenu Integration Examples for AzDuels

This document provides comprehensive DeluxeMenu configuration examples for integrating with AzDuels plugin GUIs.

Prerequisites

DeluxeMenu plugin installed
AzDuels plugin installed and configured
PlaceholderAPI plugin installed
Proper permissions set for players

Available AzDuels Commands for GUI Integration

/duel gui - Opens duel challenge GUI
/duel queue - Opens duel queue GUI
/ffa join - Opens FFA arena selection GUI
/ffa gui - Opens FFA management GUI
/partyduel gui - Opens party duel GUI
/azduels admin gui - Opens admin management GUI

Main Duel Menu Integration

File: `plugins/DeluxeMenus/gui_menus/duel_main_menu.yml`

menu_title: '&6&lDuel Menu &6&l⚔️'
open_command: duelmenu
size: 45
update_interval: 20

items:
  # Challenge Player Section
  challenge_player:
    material: DIAMOND_SWORD
    slot: 10
    display_name: '&c&lChallenge Player ⚔️'
    lore:
      - '&7👤 Challenge another player'
      - '&7to an epic duel!'
      - ''
      - '&7Your Stats:'
      - '&8▸ &fWins: &a%azduels_wins%'
      - '&8▸ &fLosses: &c%azduels_losses%'
      - '&8▸ &fW/L Ratio: &e%azduels_wlr%'
      - ''
      - '&e💡 Click to open challenge menu'
    enchanted: true
    left_click_commands:
      - '[player] duel gui'
    
  # Queue System
  join_queue:
    material: EMERALD_BLOCK
    slot: 12
    display_name: '&a&lJoin Queue 🎯'
    lore:
      - '&7🔄 Join the duel queue'
      - '&7and get matched automatically!'
      - ''
      - '&7Queue Status: %azduels_queue_status%'
      - '&7Position: &f%azduels_queue_position%'
      - '&7Waiting Time: &f%azduels_queue_time%'
      - '&7Players in Queue: &f%azduels_queue_waiting_players%'
      - ''
      - '&e💡 Click to see available arenas'
    enchanted: true
    left_click_commands:
      - '[player] duel queue'
    
  # FFA Section
  ffa_arena:
    material: IRON_SWORD
    slot: 14
    display_name: '&6&lFFA Arena 🏟️'
    lore:
      - '&7⚔️ Join Free-For-All battles!'
      - '&7Fight against multiple players'
      - '&7in intense combat!'
      - ''
      - '&7Current FFA Status: %ffa_status%'
      - '&7Arena: &f%ffa_arena%'
      - '&7Players: &f%ffa_players%'
      - '&7Your Kills: &a%ffa_kills%'
      - '&7Your Deaths: &c%ffa_deaths%'
      - '&7K/D Ratio: &e%ffa_kdr%'
      - ''
      - '&e💡 Click to join FFA'
    enchanted: true
    left_click_commands:
      - '[player] ffa gui'
    
  # Party Duels
  party_duels:
    material: GOLDEN_SWORD
    slot: 16
    display_name: '&d&lParty Duels 👥'
    lore:
      - '&7👥 Challenge other parties'
      - '&7to team-based duels!'
      - ''
      - '&7Party: &f%azduels_party_name%'
      - '&7Leader: &f%azduels_party_leader%'
      - '&7Size: &f%azduels_party_size%'
      - ''
      - '&e💡 Click to manage party duels'
    enchanted: true
    left_click_commands:
      - '[player] partyduel gui'

FFA Arena Selection Menu

File: `plugins/DeluxeMenus/gui_menus/ffa_arena_menu.yml`

menu_title: '&6&lFFA Arena Selection 🏟️'
open_command: ffamenu
size: 54
update_interval: 10

items:
  # Dynamic FFA Arena Items
  ffa_arena_1:
    material: GRASS_BLOCK
    slot: 10
    display_name: '&a&lGrasslands Arena'
    lore:
      - '&7🌿 A natural battlefield with'
      - '&7rolling hills and open spaces'
      - ''
      - '&7Status: %ffa_status_grasslands%'
      - '&7Players: &f%ffa_players_grasslands%/∞'
      - '&7Kit: &f%ffa_kit_grasslands%'
      - ''
      - '&a✓ Available for joining'
      - ''
      - '&e💡 Click to join this arena'
    left_click_commands:
      - '[player] ffa join grasslands'
  
  # Quick Join
  quick_join:
    material: EMERALD
    slot: 31
    display_name: '&a&lQuick Join 🚀'
    lore:
      - '&7⚡ Instantly join the most'
      - '&7active FFA arena!'
      - ''
      - '&7Will join arena with most players'
      - '&7or random available arena'
      - ''
      - '&e💡 Click for instant action'
    enchanted: true
    left_click_commands:
      - '[player] ffa join'

📊 PlaceholderAPI Integration

AzDuels Placeholders

This document lists all available placeholders for the AzDuels plugin. These placeholders can be used with PlaceholderAPI in scoreboards, chat, holograms, and other plugins that support PAPI.

Player Statistics

Basic Stats

%azduels_wins% - Player's total wins
%azduels_losses% - Player's total losses
%azduels_kills% - Player's total kills
%azduels_streak% - Player's current win streak
%azduels_best_streak% - Player's best win streak
%azduels_total_games% - Player's total games played
%azduels_winrate% - Player's win rate as percentage (e.g., 75.5%)

Player Rankings

%azduels_rank_wins% - Player's rank by wins
%azduels_rank_winrate% - Player's rank by win rate
%azduels_rank_streak% - Player's rank by current streak
%azduels_rank_kills% - Player's rank by kills
%azduels_rank_losses% - Player's rank by losses
%azduels_rank_total_games% - Player's rank by total games

Duel Status

Current Duel Information

%azduels_in_duel% - Returns "true" if player is in a duel, "false" otherwise
%azduels_duel_status% - Returns "In Duel", "Pending Request", or "Available"
%azduels_spectating% - Returns "true" if player is spectating, "false" otherwise
%azduels_opponent% - Name of current opponent (if in duel)
%azduels_arena% - Current arena name (if in duel)
%azduels_kit% - Current kit name (if in duel)
%azduels_current_round% - Current round number (if in duel)
%azduels_max_rounds% - Maximum rounds for current duel
%azduels_player_score% - Player's score in current duel
%azduels_opponent_score% - Opponent's score in current duel
%azduels_duel_time% - Time elapsed in current duel (mm:ss format)

Leaderboard Placeholders

Top Players by Wins

%azduels_top_wins_1% - 1st place player name by wins
%azduels_top_wins_2% - 2nd place player name by wins
%azduels_top_wins_3% - 3rd place player name by wins
... (continues up to %azduels_top_wins_10%)

Top Players Wins Values

%azduels_top_wins_value_1% - 1st place player's win count
%azduels_top_wins_value_2% - 2nd place player's win count
%azduels_top_wins_value_3% - 3rd place player's win count
... (continues up to %azduels_top_wins_value_10%)

Top Players by Kills

%azduels_top_kills_1% - 1st place player name by kills
%azduels_top_kills_2% - 2nd place player name by kills
... (continues up to %azduels_top_kills_10%)

Top Players Kills Values

%azduels_top_kills_value_1% - 1st place player's kill count
%azduels_top_kills_value_2% - 2nd place player's kill count
... (continues up to %azduels_top_kills_value_10%)

Queue System Placeholders

Queue Status

%azduels_queue_status% - Returns "In Queue" if player is in queue, "Not in Queue" otherwise
%azduels_queue_arena% - Arena name player is queued for (if in queue)
%azduels_queue_kit% - Kit name player is queued for (if in queue)
%azduels_queue_position% - Player's position in queue (if in queue)
%azduels_queue_time% - Time spent in queue in mm:ss format (if in queue)
%azduels_queue_waiting_players% - Number of players waiting in queue for same arena/kit
%azduels_queue_arena_type% - Type of arena player is queued for (if in queue)

FFA (Free For All) Placeholders

FFA Status

%azduels_ffa_status% - Returns "In FFA" if player is in FFA, "Not in FFA" otherwise
%azduels_ffa_arena% - Name of FFA arena player is in (if in FFA)
%azduels_ffa_players% - Number of players in the FFA arena
%azduels_ffa_max_players% - Maximum players allowed in the FFA arena (∞ for unlimited)
%azduels_ffa_kills% - Player's kills in current FFA session
%azduels_ffa_deaths% - Player's deaths in current FFA session
%azduels_ffa_time% - Time spent in current FFA session in mm:ss format
%azduels_ffa_kit% - Kit being used in current FFA arena

Party System Placeholders

Party Status

%azduels_party_status% - Returns "In Party" if player is in a party, "Not in Party" otherwise
%azduels_party_name% - Name of the party player is in (if in party)
%azduels_party_leader% - Name of the party leader (if in party)
%azduels_party_size% - Current number of members in the party
%azduels_party_max_size% - Maximum allowed party size (8)
%azduels_party_members% - Comma-separated list of all party members
%azduels_party_chat% - Returns "Enabled" if party chat is on, "Disabled" otherwise
%azduels_party_age% - Time since party was created in mm:ss format

Example Usage

Scoreboard Example

title: "&6&lAzDuels"
lines:
  - "&7Player: &f%player_name%"
  - "&7Wins: &a%azduels_wins%"
  - "&7Losses: &c%azduels_losses%"
  - "&7Win Rate: &e%azduels_winrate%"
  - "&7Streak: &b%azduels_streak%"
  - ""
  - "&6&lTop Players:"
  - "&71. &f%azduels_top_wins_1% &7- &a%azduels_top_wins_value_1% &7wins"
  - "&72. &f%azduels_top_wins_2% &7- &a%azduels_top_wins_value_2% &7wins"
  - "&73. &f%azduels_top_wins_3% &7- &a%azduels_top_wins_value_3% &7wins"

Chat Format Example

format: "&7[&6Rank #%azduels_rank_wins%&7] &f%player_name%&7: %message%"

Notes

All placeholders return appropriate default values when no data is available
Leaderboard placeholders return empty strings for positions that don't exist
Value placeholders return "0" when no data is available
PlaceholderAPI must be installed for these placeholders to work
The AzDuels PlaceholderAPI expansion is automatically registered when the plugin loads

🏗️ Installation

Download the latest AzDuels.jar
Place it in your server's plugins folder
Restart your server
Configure the plugin in plugins/AzDuels/config.yml
Create arenas using /azduels arena create
Set up kits with /azduels kit create
ᴏᴘᴛɪᴏɴᴀʟ: Install PlaceholderAPI for enhanced features
ᴏᴘᴛɪᴏɴᴀʟ: Install DecentHolograms for leaderboard displays
Ready to duel! ⚔️

🎨 Features Showcase

ᴅᴜᴇʟ sʏsᴛᴇᴍ

Instant 1v1 battles
Custom kit support
Spectator functionality
Multi-round support

ᴘᴀʀᴛʏ ᴅᴜᴇʟs

Team vs team combat
Multiple round support
Automatic winner detection
Party management system

ғғᴀ ᴀʀᴇɴᴀs

Free-for-all combat zones
Multiple arena support
Real-time statistics
Kill/death tracking

ᴀʀᴇɴᴀ ᴍᴀɴᴀɢᴇᴍᴇɴᴛ

Multiple arena support
Auto-reset after duels
Schematic-based restoration
Arena enable/disable system

ᴘʟᴀᴄᴇʜᴏʟᴅᴇʀ sᴜᴘᴘᴏʀᴛ

Rich PlaceholderAPI integration
Real-time statistics
Leaderboard placeholders
Queue and FFA status

📞 Support

For support, configuration help, or bug reports:

Check the configuration files
Review server console for errors
Ensure all requirements are met
Verify PlaceholderAPI integration

📄 License

MIT License - Free to use and modify

👨‍💻 Author

Made with ❤️ by GamingHuzai

ᴇɴᴊᴏʏ ᴇᴘɪᴄ ᴅᴜᴇʟs ᴏɴ ʏᴏᴜʀ ᴍɪɴᴇᴄʀᴀғᴛ sᴇʀᴠᴇʀ!

⚔️ Ready to battle? Install AzDuels today! ⚔️

AzDuels

📖About AzDuels

🧱 AzDuels - Ultimate Minecraft Dueling Plugin

✨ Features

🎮 Commands & Permissions

📋 Requirements

⚙️ Configuration Example

🎯 Color Codes Reference

AzDuels Top 10 Wins Hologram Setup

Prerequisites

Commands to Create the Hologram

1. Create the Hologram

2. Add Header Lines

3. Add Top 10 Player Lines

4. Add Footer

5. Configure Update Interval

6. Position the Hologram

Alternative Leaderboard Types

Top 10 by Kills

Top 10 by Win Streak

Useful Management Commands

View Hologram Info

Delete Hologram

List All Holograms

Tips

DeluxeMenu Integration Examples for AzDuels

Prerequisites

Available AzDuels Commands for GUI Integration

Main Duel Menu Integration

File: plugins/DeluxeMenus/gui_menus/duel_main_menu.yml

FFA Arena Selection Menu

File: plugins/DeluxeMenus/gui_menus/ffa_arena_menu.yml

AzDuels Placeholders

Player Statistics

Basic Stats

Player Rankings

Duel Status

Current Duel Information

Leaderboard Placeholders

Top Players by Wins

Top Players Wins Values

Top Players by Kills

Top Players Kills Values

Queue System Placeholders

Queue Status

FFA (Free For All) Placeholders

FFA Status

Party System Placeholders

Party Status

Example Usage

Scoreboard Example

Chat Format Example

Notes

🏗️ Installation

🎨 Features Showcase

📞 Support

📄 License

👨‍💻 Author

File: `plugins/DeluxeMenus/gui_menus/duel_main_menu.yml`

File: `plugins/DeluxeMenus/gui_menus/ffa_arena_menu.yml`