AzDuels

一款为 Minecraft 服务器提供的完整的决斗系统。

资源图片
# 🧱 AzDuels - Ultimate Minecraft Dueling Plugin ## ✨ Features - **🗡️ 1v1 Duels** - 挑战玩家进行史诗般的战斗 - **👥 Party Duels** - 多轮团队对抗 - **🎯 Custom Kits** - 创建和管理战斗装备 - **🏟️ Arena System** - 多个竞技场,具有自动重置功能 - **📊 Spectator Mode** - 观看正在进行的决斗 - **💰 Betting System** - 在决斗结果上投注 - **🏆 Queue System** - 自动匹配 - **📈 Scoreboard** - 实时决斗统计 - **🎨 GUI Menus** - 友好的用户界面 - **⚙️ Highly Configurable** - 完全可自定义 - **🔥 FFA Arenas** - 自由搏斗区域 - **📊 PlaceholderAPI Support** - 丰富的占位符集成 - **🏆 Leaderboards** - 顶级玩家排名 - **🎯 Hologram Support** - 使用全息图显示统计信息 ## 🎮 Commands & Permissions
👑 Admin Commands | Command | Description | Permission | |---------|-------------|------------| | `/azduels reload` | 重新加载插件配置 | `azduels.admin` | | `/azduels arena create ` | 创建新的竞技场 | `azduels.admin` | | `/azduels arena delete ` | 删除竞技场 | `azduels.admin` | | `/azduels arena enable ` | 启用竞技场 | `azduels.admin` | | `/azduels arena disable ` | 禁用竞技场 | `azduels.admin` | | `/azduels arena list` | 列出所有竞技场 | `azduels.admin` | | `/azduels arena tp ` | 传送到竞技场 | `azduels.admin` | | `/azduels kit create ` | 创建新的装备 | `azduels.admin` | | `/azduels kit delete ` | 删除装备 | `azduels.admin` | | `/azduels kit edit ` | 编辑装备 | `azduels.admin` | | `/azduels kit list` | 列出所有装备 | `azduels.admin` | | `/azduels admin gui` | 打开管理员 GUI | `azduels.admin` | | `/azduels stats reset ` | 重置玩家统计 | `azduels.admin` | | `/azduels forceend` | 强制结束所有决斗 | `azduels.admin` | | `/azduels debug` | 切换调试模式 | `azduels.admin` |
🔥 FFA Commands | Command | Description | Permission | |---------|-------------|------------| | `/ffa join` | 加入 FFA 竞技场选择 | `azduels.ffa` | | `/ffa join ` | 加入特定的 FFA 竞技场 | `azduels.ffa` | | `/ffa leave` | 离开当前的 FFA 竞技场 | `azduels.ffa` | | `/ffa list` | 列出所有可用的 FFA 竞技场 | `azduels.ffa` | | `/ffa stats` | 查看你的 FFA 统计信息 | `azduels.ffa` | | `/ffa gui` | 打开 FFA 管理 GUI | `azduels.ffa` | | `/ffa top` | 查看 FFA 排行榜 | `azduels.ffa` | | `/ffa kit ` | 更改 FFA 装备 | `azduels.ffa` |
👥 Party Commands | Command | Description | Permission | |---------|-------------|------------| | `/party create` | 创建一个新的队伍 | `azduels.party` | | `/party invite ` | 邀请玩家加入队伍 | `azduels.party` | | `/party accept` | 接受队伍邀请 | `azduels.party` | | `/party deny` | 拒绝队伍邀请 | `azduels.party` | | `/party leave` | 离开当前的队伍 | `azduels.party` | | `/party kick ` | 将玩家从队伍中踢出 | `azduels.party.leader` | | `/party disband` | 解散队伍 | `azduels.party.leader` | | `/party list` | 列出队伍成员 | `azduels.party` | | `/party chat` | 切换队伍聊天 | `azduels.party` | | `/partyduel ` | 挑战另一个队伍 | `azduels.partyduel` | | `/partyduel accept` | 接受队伍决斗请求 | `azduels.partyduel` | | `/partyduel deny` | 拒绝队伍决斗请求 | `azduels.partyduel` | | `/partyduel gui` | 打开队伍决斗 GUI | `azduels.partyduel` |
👤 Player Commands | Command | Description | Permission | |---------|-------------|------------| | `/duel ` | 挑战另一个玩家决斗 | `azduels.duel` | | `/duel accept` | 接受决斗请求 | `azduels.duel` | | `/duel deny` | 拒绝决斗请求 | `azduels.duel` | | `/duel gui` | 打开决斗挑战 GUI | `azduels.duel` | | `/duel stats` | 查看你的决斗统计信息 | `azduels.duel` | | `/duel stats ` | 查看另一个玩家的统计信息 | `azduels.duel` | | `/duel top` | 查看决斗排行榜 | `azduels.duel` | | `/spectate ` | 观看决斗 | `azduels.spectate` | | `/leavefight` | 离开当前的决斗/观战 | `azduels.leavefight` | | `/queue join` | 加入匹配队列 | `azduels.queue` | | `/queue leave` | 离开匹配队列 | `azduels.queue` | | `/queue status` | 检查队列状态 | `azduels.queue` | | `/queue gui` | 打开队列选择 GUI | `azduels.queue` | | `/duel toggle` | 切换决斗请求 | `azduels.duel` | | `/duel history` | 查看决斗历史 | `azduels.duel` |
## 📋 Requirements - **Minecraft Version:** 1.16.5 - 1.20.x - **Java Version:** 8 或更高 - **Dependencies:** - Spigot/Paper/Bukkit - ᴏᴘᴛɪᴏɴᴀʟ: PlaceholderAPI 用于增强的占位符 - ᴏᴘᴛɪᴏɴᴀʟ: DecentHolograms 用于全息图显示 - ᴏᴘᴛɪᴏɴᴀʟ: DeluxeMenus 用于自定义 GUI 集成 ## ⚙️ Configuration Example ```yaml # 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} &7已挑战您进行决斗!" duel_start: "&6[AzDuels] &e将在 &c{countdown} &e秒后开始决斗!" duel_win: "&6[AzDuels] &a{winner} &7赢得了决斗!" party_duel_start: "&6[AzDuels] &e由 &a{party1} &e和 &a{party2} &e之间的队伍决斗将开始!" ``` ## 🎯 Color Codes Reference - `&0` - 黑色 - `&1` - 深蓝色 - `&2` - 深绿色 - `&3` - 深水色 - `&4` - 深红色 - `&5` - 深紫色 - `&6` - 金色 - `&7` - 灰色 - `&8` - 暗灰色 - `&9` - 蓝色 - `&a` - 绿色 - `&b` - 水色 - `&c` - 红色 - `&d` - 淡紫色 - `&e` - 黄色 - `&f` - 白色 - `&l` - 粗体 - `&o` - 斜体 - `&n` - 下划线 - `&m` - 删除线 - `&k` - 魔法 - `&r` - 重置
🏆 Hologram Setup Guide # AzDuels Top 10 Wins Hologram Setup 本指南展示了如何使用 DecentHolograms 和 PlaceholderAPI 创建一个全息图,显示按获胜数排序的前 10 名玩家。 ## Prerequisites - 安装了 DecentHolograms 插件 - 安装了 PlaceholderAPI 插件 - AzDuels 插件已安装,并注册了 PlaceholderAPI 扩展 ## Commands to Create the Hologram ### 1. 创建全息图 ``` /dh create top_wins_hologram ``` ### 2. 添加标题行 ``` /dh addline top_wins_hologram &6&l🏆 TOP 10 DUELISTS 🏆 /dh addline top_wins_hologram &7&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ /dh addline top_wins_hologram &e&l按总胜场次排名 /dh addline top_wins_hologram " " ``` ### 3. 添加前 10 名玩家行 ``` /dh addline top_wins_hologram &e1. &f%azduels_top_wins_1% &7- &a%azduels_top_wins_value_1% &7胜场 /dh addline top_wins_hologram &e2. &f%azduels_top_wins_2% &7- &a%azduels_top_wins_value_2% &7胜场 /dh addline top_wins_hologram &e3. &f%azduels_top_wins_3% &7- &a%azduels_top_wins_value_3% &7胜场 /dh addline top_wins_hologram &e4. &f%azduels_top_wins_4% &7- &a%azduels_top_wins_value_4% &7胜场 /dh addline top_wins_hologram &e5. &f%azduels_top_wins_5% &7- &a%azduels_top_wins_value_5% &7胜场 /dh addline top_wins_hologram &e6. &f%azduels_top_wins_6% &7- &a%azduels_top_wins_value_6% &7胜场 /dh addline top_wins_hologram &e7. &f%azduels_top_wins_7% &7- &a%azduels_top_wins_value_7% &7胜场 /dh addline top_wins_hologram &e8. &f%azduels_top_wins_8% &7- &a%azduels_top_wins_value_8% &7胜场 /dh addline top_wins_hologram &e9. &f%azduels_top_wins_9% &7- &a%azduels_top_wins_value_9% &7胜场 /dh addline top_wins_hologram &e10. &f%azduels_top_wins_10% &7- &a%azduels_top_wins_value_10% &7胜场 ``` ### 4. 添加页脚 ``` /dh addline top_wins_hologram " " /dh addline top_wins_hologram &7&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ /dh addline top_wins_hologram &7每 30 秒更新一次 ``` ### 5. 配置更新间隔 ``` /dh setpapi top_wins_hologram 30 ``` ### 6. 定位全息图 ``` /dh movehere top_wins_hologram ``` ## Alternative Leaderboard Types ### Top 10 by Kills 将玩家行替换为: ``` /dh addline top_kills_hologram &e1. &f%azduels_top_kills_1% &7- &c%azduels_top_kills_value_1% &7击杀 /dh addline top_kills_hologram &e2. &f%azduels_top_kills_2% &7- &c%azduels_top_kills_value_2% &7击杀 # ... 继续进行 3-10 个位置 ``` ### Top 10 by Win Streak 将玩家行替换为: ``` /dh addline top_streak_hologram &e1. &f%azduels_top_streak_1% &7- &d%azduels_top_streak_value_1% &7连胜 /dh addline top_streak_hologram &e2. &f%azduels_top_streak_2% &7- &d%azduels_top_streak_value_2% &7连胜 # ... 继续进行 3-10 个位置 ``` ## Useful Management Commands ### 查看全息图信息 ``` /dh info top_wins_hologram ``` ### 删除全息图 ``` /dh delete top_wins_hologram ``` ### 列出所有全息图 ``` /dh list ``` ## Tips 1. **定位**: 当你想要全息图的位置时,使用 `/dh movehere <全息图名称>` 2. **高度调整**: 使用 `/dh move <全息图名称> ~ ~0.5 ~` 向上移动 0.5 个方块 3. **更新频率**: 更低的更新间隔(例如 10-15 秒)提供更实时的信息,但可能会影响性能 4. **颜色代码**: 在全息图文本中使用 `&` 用于颜色代码 5. **空玩家**: 如果某个位置没有玩家,占位符将返回一个空字符串
🎨 DeluxeMenu Integration # DeluxeMenu 集成示例用于 AzDuels 本文档提供了与 AzDuels 插件 GUI 集成的高级 DeluxeMenu 配置示例。 ## Prerequisites - 安装了 DeluxeMenu 插件 - 安装了 AzDuels 插件并已配置 - 安装了 PlaceholderAPI 插件 - 为玩家设置了正确的权限 ## 可用于 GUI 集成的 AzDuels 命令 - `/duel gui` - 打开决斗挑战 GUI - `/duel queue` - 打开决斗队列 GUI - `/ffa join` - 打开 FFA 竞技场选择 GUI - `/ffa gui` - 打开 FFA 管理 GUI - `/partyduel gui` - 打开派对决斗 GUI - `/azduels admin gui` - 打开管理员管理 GUI ## 主决斗菜单集成 ### 文件: `plugins/DeluxeMenus/gui_menus/duel_main_menu.yml` ```yaml menu_title: '&6&l决斗菜单 &6&l⚔️' open_command: duelmenu size: 45 update_interval: 20 items: # 挑战玩家部分 challenge_player: material: DIAMOND_SWORD slot: 10 display_name: '&c&l挑战玩家 ⚔️' lore: - '&7👤 挑战另一位玩家' - '&7进行史诗般的决斗!' - '' - '&7你的统计信息:' - '&8▸ &f获胜数: &a%azduels_wins%' - '&8▸ &f失败数: &c%azduels_losses%' - '&8▸ &fW/L Ratio: &e%azduels_wlr%' - '' - '&e💡 点击打开挑战菜单' enchanted: true left_click_commands: - '[player] duel gui' # 队列系统 join_queue: material: EMERALD_BLOCK slot: 12 display_name: '&a&l加入队列 🎯' lore: - '&7🔄 加入决斗队列' - '&7并自动匹配!' - '' - '&7队列状态: %azduels_queue_status%' - '&7位置: &f%azduels_queue_position%' - '&7等待时间: &f%azduels_queue_time%' - '&7队列中等待的玩家数: &f%azduels_queue_waiting_players%' - '' - '&e💡 点击查看可用竞技场' enchanted: true left_click_commands: - '[player] duel queue' # FFA 部分 ffa_arena: material: IRON_SWORD slot: 14 display_name: '&6&lFFA 竞技场 🏟️' lore: - '&7⚔️ 加入自由搏斗的战斗!' - '&7对抗多个玩家' - '&7在激烈的战斗中!' - '' - '&7当前 FFA 状态: %azduels_ffa_status%' - '&7竞技场: &f%ffa_arena%' - '&7玩家: &f%ffa_players%' - '&7你的击杀数: &a%ffa_kills%' - '&7你的死亡数: &c%ffa_deaths%' - '&7K/D Ratio: &e%ffa_kdr%' - '' - '&e💡 点击加入 FFA' enchanted: true left_click_commands: - '[player] ffa gui' # 派对决斗 party_duels: material: GOLDEN_SWORD slot: 16 display_name: '&d&l派对决斗 👥' lore: - '&7👥 挑战其他队伍' - '&7进行团队式的决斗!' - '' - '&7队伍: &f%azduels_party_name%' - '&7领队: &f%azduels_party_leader%' - '&7人数: &f%azduels_party_size%' - '' - '&e💡 点击管理派对决斗' enchanted: true left_click_commands: - '[player] partyduel gui' ``` ## FFA 竞技场选择菜单 ### 文件: `plugins/DeluxeMenus/gui_menus/ffa_arena_menu.yml` ```yaml menu_title: '&6&lFFA 竞技场选择 🏟️' open_command: ffamenu size: 54 update_interval: 10 items: # 动态 FFA 竞技场物品 ffa_arena_1: material: GRASS_BLOCK slot: 10 display_name: '&a&l草原竞技场' lore: - '&7🌿 一个充满自然风光' - '&7连绵的丘陵和空旷的场地' - '' - '&7状态: %ffa_status_grasslands%' - '&7玩家: &f%ffa_players_grasslands%/∞' - '&7装备: &f%ffa_kit_grasslands%' - '' - '&a✓ 可加入' - '' - '&e💡 点击加入此竞技场' left_click_commands: - '[player] ffa join grasslands' # 快速加入 quick_join: material: EMERALD slot: 31 display_name: '&a&l快速加入 🚀' lore: - '&7⚡ 立即加入最' - '&7活跃的 FFA 竞技场!' - '' - '&7将加入拥有最多玩家的竞技场' - '&7或随机可用的竞技场' - '' - '&e💡 点击以获得即时行动' enchanted: true left_click_commands: - '[player] ffa join' ```
📊 PlaceholderAPI 集成 # AzDuels 占位符 本文档列出了 AzDuels 插件的所有可用占位符。这些占位符可以与 PlaceholderAPI 在积分板、聊天、全息图和其他支持 PAPI 的插件中使用。 ## 玩家统计 ### 基本统计 - `%azduels_wins%` - 玩家的总获胜数 - `%azduels_losses%` - 玩家的总失败数 - `%azduels_kills%` - 玩家的总击杀数 - `%azduels_streak%` - 玩家当前连胜数 - `%azduels_best_streak%` - 玩家最佳连胜数 - `%azduels_total_games%` - 玩家总游戏数 - `%azduels_winrate%` - 玩家的胜率(例如,75.5%) ### 玩家排名 - `%azduels_rank_wins%` - 玩家按获胜数排名 - `%azduels_rank_winrate%` - 玩家按胜率排名 - `%azduels_rank_streak%` - 玩家按当前连胜数排名 - `%azduels_rank_kills%` - 玩家按击杀数排名 - `%azduels_rank_losses%` - 玩家按失败数排名 - `%azduels_rank_total_games%` - 玩家按总游戏数排名 ## 决斗状态 ### 当前决斗信息 - `%azduels_in_duel%` - 如果玩家在决斗中,则返回“true”,否则返回“false” - `%azduels_duel_status%` - 返回“In Duel”、“Pending Request”或“Available” - `%azduels_spectating%` - 如果玩家正在观战,则返回“true”,否则返回“false” - `%azduels_opponent%` - 当前对手的姓名(如果在决斗中) - `%azduels_arena%` - 当前竞技场名称(如果在决斗中) - `%azduels_kit%` - 当前装备名称(如果在决斗中) - `%azduels_current_round%` - 当前回合数(如果在决斗中) - `%azduels_max_rounds%` - 当前决斗的最大回合数 - `%azduels_player_score%` - 当前决斗中玩家的得分 - `%azduels_opponent_score%` - 当前决斗中对手的得分 - `%azduels_duel_time%` - 当前决斗经过的时间(mm:ss 格式) ## 排行榜占位符 ### 获胜数排名前 10 名玩家 - `%azduels_top_wins_1%` - 获胜数排名前 1 的玩家姓名 - `%azduels_top_wins_2%` - 获胜数排名前 2 的玩家姓名 - `%azduels_top_wins_3%` - 获胜数排名前 3 的玩家姓名 - ...(继续到 `%azduels_top_wins_10%`) ### 获胜数值 - `%azduels_top_wins_value_1%` - 获胜数排名前 1 的玩家的获胜数 - `%azduels_top_wins_value_2%` - 获胜数排名前 2 的玩家的获胜数 - `%azduels_top_wins_value_3%` - 获胜数排名前 3 的玩家的获胜数 - ...(继续到 `%azduels_top_wins_value_10%`) ### 击杀数排名前 10 名玩家 - `%azduels_top_kills_1%` - 击杀数排名前 1 的玩家姓名 - `%azduels_top_kills_2%` - 击杀数排名前 2 的玩家姓名 - ...(继续到 `%azduels_top_kills_10%`) ### 击杀数值 - `%azduels_top_kills_value_1%` - 击杀数排名前 1 的玩家的击杀数 - `%azduels_top_kills_value_2%` - 击杀数排名前 2 的玩家的击杀数 - ...(继续到 `%azduels_top_kills_value_10%`) ## 队列系统占位符 ### 队列状态 - `%azduels_queue_status%` - 如果玩家在队列中,则返回“In Queue”,否则返回“Not in Queue” - `%azduels_queue_arena%` - 玩家正在排队的竞技场名称 (如果在队列中) - `%azduels_queue_kit%` - 玩家正在排队的装备名称 (如果在队列中) - `%azduels_queue_position%` - 队列中的玩家位置 (如果在队列中) - `%azduels_queue_time%` - 在队列中花费的时间,格式为 mm:ss (如果在队列中) - `%azduels_queue_waiting_players%` - 为同个竞技场/装备等待的玩家人数 - `%azduels_queue_arena_type%` - 玩家正在排队的竞技场类型 (如果在队列中) ## FFA (自由搏斗) 占位符 ### FFA 状态 - `%azduels_ffa_status%` - 如果玩家在 FFA 中,则返回“In FFA”,否则返回“Not in FFA” - `%azduels_ffa_arena%` - 玩家所在的 FFA 竞技场名称(如果在 FFA 中) - `%azduels_ffa_players%` - FFA 竞技场中的玩家人数 - `%azduels_ffa_max_players%` - FFA 竞技场允许的最大玩家人数 (∞ 表示无限) - `%azduels_ffa_kills%` - 当前 FFA 课程中的玩家击杀数 - `%azduels_ffa_deaths%` - 当前 FFA 课程中的玩家死亡数 - `%azduels_ffa_time%` - 当前 FFA 课程花费的时间,格式为 mm:ss - `%azduels_ffa_kit%` - 当前 FFA 竞技场使用的装备 ## 派对系统占位符 ### 派对状态 - `%azduels_party_status%` - 如果玩家在队伍中,则返回“In Party”,否则返回“Not in Party” - `%azduels_party_name%` - 玩家所在的队伍名称(如果在队伍中) - `%azduels_party_leader%` - 队伍领队的姓名(如果在队伍中) - `%azduels_party_size%` - 队伍当前的人数 - `%azduels_party_max_size%` - 允许的最大队伍规模 (8) - `%azduels_party_members%` - 包含所有队伍成员的逗号分隔列表 - `%azduels_party_chat%` - 如果派对聊天已开启,则返回“Enabled”,否则返回“Disabled” - `%azduels_party_age%` - 自队伍创建以来的时间,格式为 mm:ss ## 示例用法 ### 积分板示例 ```yaml title: '&6&lAzDuels' lines: - '&7玩家: &f%player_name%' - '&7获胜数: &a%azduels_wins%' - '&7失败数: &c%azduels_losses%' - '&7胜率: &e%azduels_winrate%' - '&7连胜: &b%azduels_streak%' - '' - '&6&l顶级玩家:' - '&71. &f%azduels_top_wins_1% &7- &a%azduels_top_wins_value_1% &7胜场' - '&72. &f%azduels_top_wins_2% &7- &a%azduels_top_wins_value_2% &7胜场' - '&73. &f%azduels_top_wins_3% &7- &a%azduels_top_wins_value_3% &7胜场' ``` ### 聊天格式示例 ```yaml format: '&7[&6Rank #%azduels_rank_wins%&7] &f%player_name%&7: %message%' ``` ## 注意事项 - 所有占位符在没有数据时都会返回适当的默认值 - 排行榜占位符会为不存在的位置返回空字符串 - 值占位符在没有数据时返回“0” - 必须安装 PlaceholderAPI 才能使这些占位符起作用 - 加载插件时会自动注册 AzDuels PlaceholderAPI 扩展
## 🏗️ 安装 1. 下载最新的 AzDuels.jar 2. 将其放在服务器的 `plugins` 文件夹中 3. 重新启动服务器 4. 在 `plugins/AzDuels/config.yml` 中配置插件 5. 使用 `/azduels arena create` 创建竞技场 6. 使用 `/azduels kit create` 设置装备 7. ᴏᴘᴛɪᴏɴᴀʟ:安装 PlaceholderAPI 以增强功能 8. ᴏᴘᴛɪᴏɴᴀʟ:安装 DecentHolograms 以进行排行榜显示 9. 准备好战斗了! ⚔️ ## 🎨 特点展示 **决斗系统** - 瞬间 1v1 战斗 - 自定义装备支持 - 旁观者功能 - 多轮支持 **派对决斗** - 团队对抗 - 多轮支持 - 自动胜负检测 - 队伍管理系统 **FFA 竞技场** - 自由搏斗区域 - 多竞技场支持 - 实时统计 - 击杀/死亡追踪 **竞技场管理** - 多竞技场支持 - 战斗后自动重置 - 基于蓝图的恢复 - 竞技场启用/禁用系统 **占位符支持** - 丰富的 PlaceholderAPI 集成 - 实时统计 - 排行榜占位符 - 队列和 FFA 状态 ## 📞 支持 如有支持、配置帮助或错误报告: - 检查配置文件 - 查看服务器控制台中的错误 - 确保满足所有要求 - 验证 PlaceholderAPI 集成 --- ## 📄 许可 **MIT 许可** - 免费使用和修改 ## 👨‍💻 作者 **使用 ❤️ 制作 by GamingHuzai** *尽情享受你 Minecraft 服务器上的史诗决斗吧!* --- ⚔️ **准备好战斗了吗?今天就安装 AzDuels!** ⚔️