Battle Royale - 大逃杀

💡Battle Royale 简介

Battle Royale 是一款专为 Minecraft 1.21.11 设计的、灵感来源于《堡垒之夜》的生存竞技小游戏。玩家从高空出生点跳下，搜寻战利品，展开对决，最终决出唯一的胜者。插件功能全面，支持多竞技场同时运行，并拥有丰富的自定义选项。

🎮核心功能

• 高级战利品系统：可自定义的宝箱，包含 5 个稀有度等级（普通、罕见、稀有、史诗、传说）。
• 滑翔伞系统：从高空出生点使用鞘翅进行滑翔降落。
• 实时计分板：显示存活玩家数量和游戏状态。
• 观战模式：被淘汰的玩家可以观战剩余幸存者。
• 动态竞技场告示牌：自动更新，显示竞技场状态和玩家人数。
• 粒子轨迹商店：提供 11 种可自定义的粒子轨迹，支持经济系统（需 Vault 插件）。
• 成就系统：达成击杀、获胜、死亡等里程碑可获得奖励。
• 玩家统计：追踪玩家的击杀、死亡、胜场和成就数据。
• PlaceholderAPI 支持：完全集成，可用于创建动态排行榜和全息图。
• 多竞技场支持：可同时运行多场独立的游戏。
• 特殊物品：包含生命恢复器、隐身药水等多种游戏内物品。
• 完全可配置：提供 6 个配置文件，用于调整消息、商店、物品、宝箱、成就和竞技场设置。

🔧安装与依赖

• 核心需求：Spigot 或 Paper 服务器，版本 1.21.11。
• 可选依赖：
• Vault：用于粒子轨迹商店的经济系统。
• PlaceholderAPI：用于使用占位符创建动态内容。

✨快速设置指南

按照以下步骤创建一个可玩的竞技场

• 设置主大厅

- 使用命令 `/battleroyale setmainlobby` 设置玩家进入服务器时的出生点。

• 创建竞技场

- 使用命令 `/battleroyale create <ArenaName>` 创建一个新竞技场。

• 设置竞技场等待大厅

- 使用命令 `/battleroyale setlobby <ArenaName>` 设置该竞技场游戏开始前的等待区域。

• 添加出生点

- 使用命令 `/battleroyale addspawn <ArenaName>` 在高空添加玩家出生点（至少需要 2 个）。

• 添加战利品箱

- 使用命令 `/battleroyale addchest <ArenaName>` 添加宝箱位置（插件会自动放置宝箱方块）。

完成以上步骤后，竞技场即可投入使用！

🔧命令列表

玩家命令

• /br help - 显示命令列表。
• /br version - 显示插件版本。
• /br list - 列出所有可用的竞技场。
• /br join <ArenaName> - 加入一个竞技场。
• /br leave - 离开当前所在的竞技场。
• /br lobby - 返回主大厅。

管理员命令

• /br setmainlobby - 设置主大厅出生点。
• /br create <ArenaName> - 创建一个新竞技场。
• /br delete <ArenaName> - 删除一个竞技场。
• /br setlobby <ArenaName> - 设置竞技场的等待大厅。
• /br addspawn <ArenaName> - 为竞技场添加一个出生点。
• /br addchest <ArenaName> - 为竞技场添加一个战利品箱位置。
• /br start <ArenaName> - 强制开始一个竞技场的游戏。
• /br stop <ArenaName> - 停止一个正在运行的竞技场。
• /br reload - 重载所有配置文件。

🔧权限节点

• battleroyale.use - 允许使用玩家命令。
• battleroyale.admin - 允许使用管理员命令。
• battleroyale.* - 允许使用所有命令。

🔧创建加入告示牌

放置一个告示牌，并输入以下内容

• 第一行：BattleRoyale
• 第二行：<ArenaName>（替换为你的竞技场名称）

告示牌会自动更新，显示该竞技场的玩家数量和状态！

🔧配置文件

插件提供 6 个主要的配置文件，方便你深度自定义游戏体验：

• config.yml - 物品名称、材质和菜单槽位。
• messages.yml - 所有插件消息（完全可翻译）。
• shop.yml - 粒子轨迹、价格和商店消息。
• items.yml - 游戏内物品、特殊物品和菜单标题。
• chests.yml - 战利品表、稀有度和掉落几率。
• achievements.yml - 成就达成条件和奖励。

🔧PlaceholderAPI 占位符

竞技场占位符

• %battleroyale_arena_<name>_state%
• %battleroyale_arena_<name>_status%
• %battleroyale_arena_<name>_players%
• %battleroyale_arena_<name>_maxplayers%
• %battleroyale_arena_<name>_playerlist%

玩家占位符

• %battleroyale_player_arena%
• %battleroyale_player_isingame%
• %battleroyale_player_state%

全局占位符

• %battleroyale_arenas_count%
• %battleroyale_players_total%

🔧游戏内菜单

• 玩家统计菜单：查看你的击杀、死亡、胜场和 K/D 比率。
• 成就菜单：查看并解锁基于击杀、胜场和死亡里程碑的成就。
• 粒子轨迹商店：购买并装备 11 种不同的粒子轨迹效果。

⭐主要特色

• 多竞技场支持：在单个服务器上同时运行多场游戏。
• 完全可定制：可编辑所有消息、物品、战利品和商店设置。
• 经济集成：通过可选的 Vault 插件支持付费粒子轨迹。
• 全息图兼容：使用 PlaceholderAPI 创建动态全息显示。
• 轻量且优化：即使运行多个竞技场也能保持流畅。
• 持续开发：定期更新和修复错误。

❓获取帮助

遇到问题或发现了漏洞？请通过 Discord 支持频道 联系我们。

Battle Royale 是一款为 Minecraft 服务器设计的生存竞技插件，玩家将在不断缩小的战场中展开对决，直至决出最后的胜者。以下为您整理了插件的核心命令与权限说明。

🎮命令列表

插件的主命令是 /battleroyale，您也可以使用其简写 /br。

主命令

• 命令：/battleroyale 或 /br
• 描述：Battle Royale 插件的主命令。
• 用法：/<command> [help|join|leave|list]
• 权限：battleroyale.use
• 说明：不带参数执行将显示命令帮助。使用 join 加入游戏，leave 离开，list 查看玩家列表。

快捷命令

• 命令：/leave
• 描述：离开当前竞技场。
• 用法：/leave
• 权限：battleroyale.use

• 命令：/lobby
• 描述：返回主大厅。
• 用法：/lobby
• 权限：battleroyale.use

✨权限节点

权限系统采用树状结构，授予父权限将自动包含其所有子权限。

主要权限组

• **battleroyale.***

- **描述**：授予所有 Battle Royale 相关权限。

- **默认拥有者**：管理员 (op)

- **包含子权限**：`battleroyale.use`, `battleroyale.admin`, `battleroyale.vip`

具体权限

• battleroyale.use

- **描述**：允许玩家使用基础命令（如加入、离开、查看列表）。

- **默认拥有者**：所有玩家 (true)

• battleroyale.admin

- **描述**：允许玩家使用管理员命令（如配置游戏、管理玩家）。

- **默认拥有者**：管理员 (op)

• battleroyale.vip

- **描述**：允许使用 VIP 专属功能。

- **默认拥有者**：无 (false)，需手动分配。