AzDuels — Advanced Duels Plugin
Minimal, clean, and Minecraft-themed dueling for your server — with clickable duel requests, kit selection, queues, and DeluxeMenus integration.
Arena Regen Extension:
AZCustomArenaReset — Arena Regen Extension
Features
- Clickable Duel Requests — Rich in-chat [ACCEPT] and [DENY] buttons
- Kit Selector Flow — Use DeluxeMenus or the built-in GUI
- Queue System — Join kit queues quickly; customizable menu
- Spectate & Leave — Simple spectator mode and clean exits
- ELO & Stats — Adjustable ELO changes and per-player stats
- Admin Tools — Signs, kit editor, lobby settings
Requirements
- Minecraft Server: Spigot/Paper 1.8.8+
- Java: 8+
- Dependencies: Vault (required)
- Soft-Depends: PlaceholderAPI (optional), DeluxeMenus (optional)
Commands & Permissions
Player Commands
- /duel <player> — Send a duel request — Permission: azduels.duel
- /duel accept <player> — Accept a duel request — Permission: azduels.duel
- /duel decline <player> — Decline a duel request — Permission: azduels.duel
- /duel stats [player] — View stats — Permission: azduels.player
- /duel top — Leaderboard — Permission: azduels.player
- /duel queue <kit> — Join queue — Permission: azduels.player
- /duel leave — Leave queue — Permission: azduels.player
- /duel lobby — Teleport to lobby — Permission: azduels.player
- /duel toggle — Toggle duel requests — Permission: azduels.player
- /duel toggle-spectate — Toggle spectate requests — Permission: azduels.player
- /spectate <player> — Spectate duel — Permission: azduels.spectate
- /leavefight — Forfeit duel — Permission: azduels.player
- /queue — Open queues menu — Permission: azduels.player
- /kits [player] — Open kit selector GUI — Permission: azduels.player
- /selectkit [player] — Open kit selector GUI — Permission: azduels.player
- /kitselect <kitname> — Select kit — Permission: azduels.player
- /kiteditor <kit|save|leave> — Edit kits — Permission: azduels.kiteditor
Admin Commands
- /ds help [category] — Show help — Permission: azduels.admin
- /ds create <name> — Create arena — Permission: azduels.admin
- /ds set <name> <1|2> — Set arena spawn — Permission: azduels.admin
- /ds delete <name> — Delete arena — Permission: azduels.admin
- /ds info <name> — Show arena info — Permission: azduels.admin
- /ds toggle <name> — Enable/disable arena — Permission: azduels.admin
- /ds tp <name> [1|2] — Teleport to arena — Permission: azduels.admin
- /ds list — List arenas/kits/queues — Permission: azduels.admin
- /ds savekit <name> — Save kit — Permission: azduels.admin
- /ds loadkit <kit> [player] — Load kit — Permission: azduels.admin
- /ds deletekit <name> — Delete kit — Permission: azduels.admin
- /ds bind <kitname> — Bind kit to arena GUI — Permission: azduels.admin
- /ds kiticon <kit> [player] — Set kit icon — Permission: azduels.admin
- /ds seticon <kit> — Alternative kit icon — Permission: azduels.admin
- /ds createqueue <kit> [bet] — Create queue — Permission: azduels.admin
- /ds deletequeue <kit> [bet] — Delete queue — Permission: azduels.admin
- /ds addsign <kit> [bet] — Create queue sign — Permission: azduels.admin
- /ds delsign — Delete looking sign — Permission: azduels.admin
- /delsign <name> — Delete sign by name — Permission: azduels.admin
- /ds setelo <player> <kit> <amount> — Set player ELO — Permission: azduels.admin
- /ds edit <player> <add|remove|set> <wins|losses> <amount> — Edit stats — Permission: azduels.admin
- /ds reset <player> — Reset stats — Permission: azduels.admin
- /ds wand — Get arena wand — Permission: azduels.admin
- /ds setlobby — Set lobby location — Permission: azduels.admin
- /ds setkiteditor — Set kit editor location — Permission: azduels.admin
- /ds reload — Reload plugin config — Permission: azduels.admin
Configuration Example (YAML)
Code (YAML):
commands:
deluxemenus:
kit_selector_menu
:
"deluxemenus_kit_selector"
kit_selector_menus:
- name
:
"deluxemenus_kit_selector"
enabled
: true
- name
:
"pvp_kits_menu"
enabled
: false
duel_request_menus:
- name
:
"deluxemenus_duel_request"
enabled
: true
- name
:
"alt_duel_request"
enabled
: false
duel-request-format:
enabled
: true
title
:
"DUEL REQUEST"
player-line
:
"Challenger: {playername}"
kit-line
:
"Kit: {kitname}"
accept-button:
text
:
"[ACCEPT]"
hover
:
"Click to accept duel from {playername} ({kitname})"
command
:
"/duel accept {playername}"
deny-button:
text
:
"[DENY]"
hover
:
"Click to deny duel from {playername}"
command
:
"/duel deny {playername}"
queues:
actionbar-enabled
: true
actionbar-interval-seconds
: 2
actionbar-format
:
"You are in duel queue. To cancel it type /duel leave"
Use with %azduels_<identifier>%. Requires PlaceholderAPI.
Player Status
- in_match — "true" if player is currently in a duel, else "false".
- in_queue — "true" if player is currently in any queue.
- status — "In Match", "In Queue", or "Available".
Player Stats (global across kits)
- wins — total wins across all kits.
- losses — total losses across all kits.
- elo — average ELO across enabled kits, or default ELO.
- rating — alias of elo.
- +elo — ELO gain on win (from config).
- +rating — alias of +elo.
- -elo — ELO loss on defeat (from config).
- -rating — alias of -elo.
Kit-Specific Stats
- kit_elo_<kit> — ELO for specific kit.
- kit_wins_<kit> — wins for specific kit.
- kit_losses_<kit> — losses for specific kit.
Streaks
- streak — current win streak.
- best_streak — best win streak ever achieved.
- azstreak_rank — rank among top streak players.
Queue Info
- queue_size — total players in all queues.
- queue_size_<kit> — players queued for <kit>.
- in_match_<kit> — players in matches for <kit>.
- queue_display_<kit> — formatted text showing queue and match counts for <kit>.
- queue_display_bet_<kit>_<amount> — formatted text including bet filter.
- timer_<kit> — seconds since player joined <kit> queue.
# Instructions by Ph4ntom
# 1. Requires PlaceholderAPI & azLeaderboards Plugin
# 2. Run:
# /papi ecloud download statistic & /papi reload
# /azlb add %statistic_deaths%
# /azlb add %statistic_player_kills%
# /azlb add %statistic_time_played:hours%
# /luckperms group default permission set azleaderboards.dontupdate.* false
# 3. Update locations:
# /dh mvhr Leaderboard-Deaths
# /dh mvhr Leaderboard-Kills
# /dh mvhr Leaderboard-Playtime
# 4. Enjoy!
Author: Made with ❤️ by GamingHuzai