**一个用于在 Minecraft 中创建竞技场和迷你游戏的全功能比赛和活动框架。支持通过配置文件创建模式，或通过插件创建完全自定义的模式。**
BattleArena 允许你在 Minecraft 服务器上创建自己的比赛，通过配置文件进行。游戏逻辑的几乎所有方面都可以配置，范围从队伍人数、生成点、地图、游戏机制以及许多其他功能。
## 功能
- 竞技场隔离 - 加入或离开比赛时存储/恢复玩家物品
- 类别 - 创建自定义套件或类别
- 决斗 - 为你的比赛配置决斗选项
- 动态竞技场 - 根据需要扩展世界中的比赛
- 地图恢复 - 比赛结束后恢复地图
- 派对 - 与各种派对插件的集成
- PlaceholderAPI 支持 - 通过 PlaceholderAPI 在第三方插件中显示竞技场信息
- 积分板 - 为比赛配置积分板
- 统计跟踪 (与 [BattleTracker](https://modrinth.com/plugin/battletracker)) - 存储比赛统计并包含排行榜
- 队伍配置 - 创建单人或团队比赛
- 锦标赛 - 为任何比赛类型运行淘汰赛锦标赛
## 默认模式
BattleArena 中的活动游戏被称为比赛。 BattleArena 原生支持两种比赛类型：
### 比赛
当满足特定条件时（例如，玩家人数）或始终处于活动状态时开始的游戏。只要有可用地图，玩家可以随时加入。常见的例子包括 Spleef、SkyWars、生存游戏或夺旗。
### 活动
基于特定时间间隔或由服务器管理员触发时开始的游戏。除非活动处于活动状态，否则无法正常加入这些游戏。常见的例子包括淘汰赛锦标赛、死亡竞赛或自由搏斗。
### 预配置游戏列表可以在 [这里](https://docs.battleplugins.org/books/additional-gamemodes) 找到。
## 内置比赛类型
- 竞技场：简单的决斗模式，你使用配置文件中提供的物品进行战斗。
- 决斗：你携带自己想要战斗的物品。游戏始终运行，你可以随时加入和离开。
- 角斗场：4v4 团队死亡竞赛。最后一个队伍站立获胜。
- 战场：1 分钟的比赛，获胜者是击杀数最多的玩家。
## 内置活动类型
- 自由搏斗：每 30 分钟开始一次的自由搏斗死亡竞赛。最后存活的玩家获胜。
- 死亡竞赛：一个持续 2 分钟的活动，如果你死亡你会复活。击杀数最高的玩家获胜。
- 锦标赛：任何数量的团队的淘汰赛锦标赛。
## 用户指南
BattleArena 中可配置的大多数功能都将位于 **plugins/BattleArena/arenas** 目录中的相应的 .yml 文件中。 可以修改、删除这些文件，并可以添加新的文件。
BattleArena 的完整用户指南可以在 BattleDocs 上的 [用户指南](https://docs.battleplugins.org/books/user-guide) 中找到。
## 供开发者
BattleArena 具有高度的可扩展性，并广泛支持创建自定义比赛、活动，甚至比赛类型。 它是一个事件驱动的框架，这意味着外部插件可以轻松地通过多种方式添加或修改行为。
BattleArena API 的完整文档可以在 BattleDocs 上的 [开发者指南](https://docs.battleplugins.org/books/developer-guide) 中找到。
## 其他扩展和模块
BattleArena 的核心是框架，这意味着基本插件具有非常标准的功能集，而大多数附加内容都来自模块和扩展。 以下扩展和模块构建在 BattleArena 之上，并允许你进一步扩展 BattleArena 的功能。
### 扩展
这些是添加新模式到 BattleArena 的插件。
- [ArenaSpleef](https://modrinth.com/plugin/arenaspleef) - 将 Spleef 添加到 BattleArena
- [ArenaCTF](https://modrinth.com/project/arenactf) - 将夺旗添加到 BattleArena
- [ArenaPaintball](https://modrinth.com/project/arenapaintball) - 将 Paintball 模式添加到 BattleArena
- [ArenaParkour](https://modrinth.com/project/arenaparkour) - 将 Parkour 添加到 BattleArena
### 统计跟踪
统计数据由我们的姊妹插件 [BattleTracker](https://modrinth.com/plugin/battletracker) 跟踪。 这为 BattleArena 添加了诸如排行榜和排名之类的功能。有关更多信息，请参见 BattleTracker 页面。
### 模块
这些模块扩展了 BattleArena 的现有功能，并且通常可以在任何模式下使用，甚至可以在自定义模式下使用。
**捆绑**:
这些模块已预安装在 BattleArena 中。
- 竞技场恢复 - 允许在比赛结束后从 WorldEdit 蓝图恢复地图
- 边界执行器 - 确保玩家在比赛中不在竞技场边界内。
- 类别 - 将自定义类别（或套件）添加到 BattleArena。
- 决斗 - 允许你在配置的竞技场中与其他玩家决斗。
- 一枪制胜 - 为 BattleArena 添加一枪制胜支持。
- 积分板 - 为 BattleArena 添加积分板支持。
- 队伍颜色 - 将玩家名称的颜色更改为竞技场中启用的模块的团队颜色。
- 队伍头像 - 将每个玩家的头像物品设置为其团队颜色的羊毛物品。
- 锦标赛 - 为 BattleArena 添加淘汰赛锦标赛支持。
- Vault 集成 - 支持与 Vault 的功能，例如在竞技场中添加/删除货币或授予/删除权限。
**第三方**:
- [PhatLoots](https://modrinth.com/plugin/phatloots) - 支持配置和重置比赛中的掉宝表。
- [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) - 支持显示 BattleArena 信息的占位符（参见 [PlaceholderAPI 文档](https://docs.battleplugins.org/books/user-guide/page/placeholder-api)）
可以在 BattleDocs 上的 [模块和其他工具](https://docs.battleplugins.org/books/modules-and-other-tools/) 页面上找到关于使用 BattleArena 的派对模块和插件的完整列表。
## 链接
- 网站：[https://www.battleplugins.org](https://www.battleplugins.org)
- Discord：[BattlePlugins Discord](https://discord.com/invite/J3Hjjb8)
- 捐赠：[BattlePlugins Patreon](https://patreon.com/battleplugins)
## 重要说明
特别感谢 alkarin_v 在 2011 年编写了 [原始 BattleArena](https://github.com/alkarinv/BattleArena/) 插件。 尽管今天几乎没有原始代码幸存下来，但它奠定了 BattlePlugins 套件和随后的创新以及最终成为的基础。