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 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'

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