BuildBattle - 建筑大师

BuildBattle 是一款经典的建筑比赛小游戏插件，最初为 BuildersRefuge 服务器设计，现已免费发布。它支持单人模式，玩家需根据随机主题在规定时间内建造作品，随后进入投票环节决出胜负。插件高度可配置，并包含便捷的标牌加入系统。

💡重要须知

• 本插件为 单人 建筑比赛，不支持团队模式。
• 必须安装 ActionBarAPI 插件才能正常运行。
• 专为 Minecraft 1.13 设计，其他版本可能无法正常工作。若使用 1.12，请下载旧版。
• 建议在 BungeeCord 网络下的子服务器运行，以减少插件冲突。

✨核心特性

• 自动清理：比赛结束后，自动清理竞技场内的建筑。
• 动态标牌：可放置一个动态显示游戏状态的标牌，用于加入游戏或观战。
• 主题系统：随机选择建筑主题，支持在 themelist.yml 中无限添加。
• 计分板：实时显示剩余时间、当前主题、玩家人数等信息。
• 音效投票：投票时会播放不同音效，增加互动乐趣。
• 烟花庆祝：比赛结束后，在获胜者的竞技场角落燃放烟花。
• 高度可配置：几乎所有文本、时间、数量限制均可通过配置文件调整。

🔧安装与依赖

• 必需插件：ActionBarAPI
• 建议：使用 WorldGuard 保护竞技场地板及周边区域，但允许玩家在地板上方建筑。

🎮配置与设置

基本配置

在 config.yml 中需设置两个关键世界：

• worldName：建筑比赛世界（包含大厅和竞技场），默认为 buildbattle。
• hubWorldName：大厅世界（玩家选择游戏的地方），默认为 world。

确保这两个世界位于同一服务器。

设置大厅

• 进入 buildbattle 世界。
• 站在希望作为大厅出生点的位置。
• 执行命令 /buildbattle setlobby。
• 建议使用 WorldGuard 保护此区域。

设置竞技场

• 在 config.yml 中设定 arenaRadius（竞技场边长，默认27）和 arenaRadiusHeight（清理高度，默认27）。
• 进入 buildbattle 世界，站在规划为 1号竞技场 中心的位置。
• 执行命令 /buildbattle setarena 1。
• 重复步骤2-3，设置后续竞技场（例如 2, 3, 4...）。竞技场数量需与 config.yml 中 totalPlayers（默认8）一致。
• 使用 WorldGuard 保护每个竞技场：保护地板及建筑高度（arenaRadiusHeight）以上的区域，但允许玩家在保护区内建筑。

数据将保存于 plugins/BuildBattle/data.yml。

⭐游戏流程

• 加入游戏：玩家通过命令 /buildbattle join 或点击设置好的标牌进入大厅世界。
• 等待开始：大厅计时器（默认60秒）启动。当玩家数达到 totalPlayersNeededToStart（默认2人）时，倒计时结束即开始游戏。否则，计时器重置。
• 建造阶段：玩家被传送到各自的竞技场，随机主题公布，建造计时器（默认300秒）启动。计分板将显示信息。
• 投票阶段：

- 建造时间结束，玩家依次传送到每个参赛者的建筑前进行投票。

- 玩家使用物品栏中的投票方块（默认为羊毛）右键点击进行投票，每次投票会播放独特音效。

- 每个建筑的投票时间由 `timeTillNextVote`（默认10秒）控制。

• 结束与庆祝：所有投票结束后，公布结果，在获胜者的竞技场燃放烟花，随后所有玩家被传回大厅。

❓命令与权限

命令列表

• /buildbattle 或 /bb - 查看帮助页面。

- 权限：`buildbattle.buildbattle`

• /buildbattle setlobby - 设置大厅出生点。

- 权限：`buildbattle.setlobby`

• /buildbattle setarena [序号] - 设置指定序号的竞技场。

- 权限：`buildbattle.setarena`

• /buildbattle join - 加入游戏大厅。

- 权限：`buildbattle.join`

• /buildbattle reload - 重载配置文件。

- 权限：`buildbattle.reload`

• /buildbattle about - 查看插件信息。

- 可在配置中关闭此命令。

标牌权限

• buildbattle.signplace - 允许放置 BuildBattle 标牌。
• buildbattle.signjoin - 允许右键点击标牌加入游戏。
• buildbattle.signremove - 允许破坏并移除 BuildBattle 标牌。

🔧标牌系统

创建标牌

• 确保已设置大厅和竞技场。
• 在配置中指定的 hubWorldName 世界内放置一个标牌。
• 在标牌第一行准确输入 [BuildBattle]（区分大小写）。此文本可通过配置 signJoinText 修改。
• 放置后，标牌将动态显示游戏状态（如：Players: 0/8, JOIN LOBBY）。

标牌特性

• 每个服务器只能存在一个有效标牌。
• 如果 data.yml 数据损坏或缺失，标牌会显示“ERROR”。
• 修改配置后，执行 /buildbattle reload 可更新标牌显示。
• 移除标牌：玩家持有 buildbattle.signremove 权限时击打标牌，或手动在 data.yml 中将 signPlaced 改为 false。

💡注意事项与故障排除

• 游戏模式：插件会自动管理游戏模式。请勿使用 Multiverse 等插件强制覆盖大厅或比赛世界的默认游戏模式，也勿启用 server.properties 中的 force-gamemode。
• 观战模式：当前观战功能 (spectatingDisabled) 存在一些漏洞，建议在配置中保持禁用。
• ViaVersion：使用 ViaVersion 时，计分板可能显示异常。
• 传送物品：请在比赛世界禁用末影珍珠和紫颂果，防止玩家离开竞技场。
• 玩家离开：

- 如果游戏中仅剩1人，比赛直接结束。

- 如果游戏已开始且人数大于2，玩家离开后可以重新加入。若在投票阶段加入，则进入观战模式，其建筑不被投票。

• 插件冲突：建议在纯净的子服务器运行，多数问题源于插件干扰。

⭐可用占位符

• %prefix% - 插件消息前缀。
• %start_timer% - 游戏开始倒计时。
• %players_needed% - 开始游戏所需最少玩家数。
• %time_remaining% - 建造或投票剩余时间。
• %current_theme% - 当前建筑主题。
• %players_playing% - 正在游戏的玩家数。
• %player_name% - 玩家名称。
• %first_place%, %second_place%, %third_place% - 比赛排名。
• %status% - 状态（如 JOIN LOBBY）。
• %sign_join_text% - 标牌首行文本。
• (更多占位符请参考配置文件注释)

❓已知问题

• 观战相关：

- 玩家在比赛中途离开服务器，比赛结束后再回来，可能会在大厅处于观战模式。需返回大厅世界重新加入。

- 观战者在比赛结束时可能无法被传回大厅。需返回大厅世界重新加入。

- 在某些特定玩家进退场景下，观战者可能导致游戏崩溃。

• 建议：目前请在配置中设置 spectatingDisabled: true 以禁用观战。

---

> 如需帮助，请在 SpigotMC 网站私信作者。请勿在评论中直接报告问题。