BattleArena - 竞技场与迷你游戏框架

💡简介

BattleArena 是一个完整的比赛与活动框架，用于在 Minecraft 中创建竞技场和小游戏。它支持通过配置文件创建游戏模式，也支持通过插件实现完全自定义的模式。几乎所有游戏逻辑均可配置，包括队伍规模、重生点、地图、游戏机制等诸多方面。

🎮核心功能

• 竞技场隔离 - 玩家加入或离开比赛时，自动保存和恢复其物品。
• 职业系统 - 创建自定义装备或职业（职业）。
• 决斗系统 - 为比赛配置决斗选项。
• 动态竞技场 - 按需在世界中扩展比赛规模。
• 记分板 - 为比赛配置记分板。
• 统计追踪 - 通过 BattleTracker 存储比赛统计数据并支持排行榜。
• 队伍配置 - 创建单人或多人的团队比赛。
• 锦标赛 - 为任何比赛类型运行淘汰赛制锦标赛。
• 世界恢复 - 比赛结束后恢复地图。

🎮默认模式

BattleArena 中的活动游戏被称为“比赛”。它原生支持两种比赛类型：

匹配赛

当满足特定条件（如玩家数量）时开始，或始终保持活跃的游戏。只要有可用地图，玩家可随时加入。常见例子包括 Spleef、SkyWars、生存游戏或夺旗战。

• 更多游戏模式列表可在此处查看。

活动赛

基于特定时间间隔触发，或由服务器管理员手动开始的游戏。除非活动正在进行，否则玩家无法正常加入。常见例子包括淘汰赛锦标赛、死亡竞赛或自由混战。

🎮内置模式

内置匹配赛类型

• Arena：简单的决斗模式，使用配置中提供的物品进行战斗。
• Skirmish：玩家携带自己的物品进行战斗。游戏持续运行，玩家可随时加入或离开。
• Colosseum：4v4 团队死亡竞赛，最后存活的队伍获胜。
• Battlegrounds：时长 1 分钟的比赛，击杀数最多的玩家获胜。

内置活动赛类型

• Free for All：每 30 分钟开始一次的自由混战死亡竞赛，最后存活的玩家获胜。
• Deathmatch：时长 2 分钟的活动，死亡后可重生，击杀数最高的玩家获胜。
• Tournament：适用于任意数量队伍的淘汰赛制锦标赛。

🔧用户指南

BattleArena 几乎所有可配置功能都位于 plugins/BattleArena/arenas 目录下的相应 <arena>.yml 配置文件中。您可以修改、删除这些文件，或添加新的配置文件。

完整的用户指南可在 BattleDocs 的 用户指南 中找到。

🔧开发者文档

BattleArena 具有高度可扩展性，广泛支持创建自定义的匹配赛、活动赛甚至比赛类型。它是一个事件驱动的框架，意味着外部插件可以通过多种方式轻松添加或修改行为。

完整的 BattleArena API 文档可在 BattleDocs 的 开发者指南 中找到。

✨扩展与模块

BattleArena 本质上是一个框架，基础插件提供标准功能集，而大部分额外内容则来自模块和扩展。以下扩展和模块构建于 BattleArena 之上，可进一步扩展其能力。

扩展插件

这些插件为 BattleArena 添加了新的游戏模式。

• ArenaSpleef - 为 BattleArena 添加 Spleef 模式。
• ArenaCTF - 为 BattleArena 添加夺旗战模式。
• ArenaPaintball - 为 BattleArena 添加彩弹射击模式。
• ArenaParkour（即将推出）- 为 BattleArena 添加跑酷模式。

统计追踪

统计数据由我们的姊妹插件 BattleTracker 追踪。它为 BattleArena 添加了排行榜和排名等功能。更多信息请查看 BattleTracker 页面。

模块

这些模块扩展了 BattleArena 的现有功能，并且通常可以在任何模式（包括自定义模式）中使用。

捆绑模块

这些模块随 BattleArena 预装。

• Arena Restoration - 允许您在比赛结束后从 WorldEdit 示意图恢复地图。
• Boundary Enforcer - 确保玩家在比赛期间不离开竞技场边界。
• Classes - 为 BattleArena 添加自定义职业（或装备）。
• Duels - 允许您在配置的竞技场中与其他玩家决斗。
• One in the Chamber - 为 BattleArena 添加“一枪制敌”模式支持。
• Scoreboards - 为 BattleArena 添加记分板支持。
• Team Colors - 在启用此模块的竞技场中更改玩家名称的颜色。
• Team Heads - 将每位玩家的头部物品设置为其队伍颜色的羊毛。
• Tournaments - 为 BattleArena 添加淘汰赛制锦标赛支持。
• Vault Integration - 支持与 Vault 相关的功能，例如在竞技场中添加/移除货币或授予/移除权限。

第三方模块

• PhatLoots - 支持在比赛中配置和重置战利品表。

完整的模块列表以及使用 BattleArena 的插件可在 BattleDocs 的 模块与其他工具 页面找到。

⭐链接

• 官方网站：https://www.battleplugins.org
• Discord：BattlePlugins Discord
• 赞助支持：BattlePlugins Patreon

❓特别鸣谢

特别感谢 alkarin_v 在 2011 年编写了原始的 BattleArena 插件。虽然原始代码留存至今的已非常少，但它为后来成为 BattlePlugins 套件及其后续创新奠定了基础。