? 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 ` | Create a new arena | `azduels.admin` |
| `/azduels arena delete ` | Delete an arena | `azduels.admin` |
| `/azduels arena enable ` | Enable an arena | `azduels.admin` |
| `/azduels arena disable ` | Disable an arena | `azduels.admin` |
| `/azduels arena list` | List all arenas | `azduels.admin` |
| `/azduels arena tp ` | Teleport to arena | `azduels.admin` |
| `/azduels kit create ` | Create a new kit | `azduels.admin` |
| `/azduels kit delete ` | Delete a kit | `azduels.admin` |
| `/azduels kit edit ` | Edit a kit | `azduels.admin` |
| `/azduels kit list` | List all kits | `azduels.admin` |
| `/azduels admin gui` | Open admin GUI | `azduels.admin` |
| `/azduels stats reset ` | 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 ` | 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 ` | Change FFA kit | `azduels.ffa` |
? Party Commands
| Command | Description | Permission |
|---------|-------------|------------|
| `/party create` | Create a new party | `azduels.party` |
| `/party invite ` | 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 ` | 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 ` | 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 ` | 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 ` | View another player's stats | `azduels.duel` |
| `/duel top` | View duel leaderboards | `azduels.duel` |
| `/spectate ` | 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 ` while standing where you want the hologram
2. **Height Adjustment**: Use `/dh move ~ ~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`
```yaml
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`
```yaml
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
```yaml
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
```yaml
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! ⚔️
暂无评论，抢个沙发吧~