Logo
AzDuels
PluginMIT

AzDuels

A complete dueling system for Minecraft servers

836
Downloads
4
Followers
6 months ago
Updated
📦
5
Versions
equipmentbukkitpaperpurpurspigot
Download Latestv1.9View on Modrinth

📖About AzDuels

🧱 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

  1. Positioning: Use /dh movehere <hologram_name> while standing where you want the hologram
  2. Height Adjustment: Use /dh move <hologram_name> ~ ~0.5 ~ to move up by 0.5 blocks
  3. Update Frequency: Lower update intervals (like 10-15 seconds) provide more real-time data but may impact performance
  4. Color Codes: Use & for color codes in hologram text
  5. 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

  1. Download the latest AzDuels.jar
  2. Place it in your server's plugins folder
  3. Restart your server
  4. Configure the plugin in plugins/AzDuels/config.yml
  5. Create arenas using /azduels arena create
  6. Set up kits with /azduels kit create
  7. ᴏᴘᴛɪᴏɴᴀʟ: Install PlaceholderAPI for enhanced features
  8. ᴏᴘᴛɪᴏɴᴀʟ: Install DecentHolograms for leaderboard displays
  9. 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! ⚔️