CubeRunner - 方块跑酷：躲避从天而降的方块

> [!NOTE]

> 本插件自 2016 年夏季起已不再获得开发者支持。

玩家将被投入一个竞技场，唯一的目标就是：生存！在从天而降的方块砸中你之前拼命奔跑，同时试图淘汰对手，成为坚持到最后的人。随着方块在竞技场内不断堆积，生存将变得越来越艰难……

本插件源于我在旧服务器上用命令方块实现的一个原创想法。如今我已掌握 Java 并开始制作插件，因此决定以更丰富的功能重现它。

💡主要特性

• 兼容性：支持 Minecraft 1.7.10 及更高版本。
• 游戏模式：支持单人与多人游戏，最多可容纳 10 名玩家。
• 用户界面：提供友好的图形界面和告示牌交互。
• 数据统计：记录所有玩家过往游戏的多种统计数据。
• 成就系统：可编辑的成就供玩家达成。
• 趣味挑战：玩家可完成各种挑战。
• 经济奖励：与 Vault 兼容，可为游戏奖励和挑战奖励提供货币奖励。
• 竞技场设置：竞技场易于设置且高度可定制。
• 方块雨：可编辑下落方块的类型和颜色。
• 多语言支持：内置英语、法语和德语。玩家可根据个人偏好选择语言。
• 多世界/多背包兼容：与多世界、多背包类插件兼容。

🎮安装与配置

兼容性

• 支持版本：1.8.7+ 及 1.9 在线服务器。
• 重要警告：若使用 Paper 服务端，方块落地时可能出现显示错误，影响游戏体验。此为 Paper 的已知问题，无法修复。相关问题链接：PaperMC/Paper Issue #336。

必需插件

• WorldEdit

推荐插件

• Vault
• 任意经济插件（如 Essentials 等）
• PermissionsEx（用于管理组和权限）

安装步骤

• 下载插件（CubeRunner.jar）及其他必需插件。
• 将文件放入服务器的 plugins 文件夹。
• 重启服务器，这将生成 config.yml 配置文件。
• 打开 plugins/CubeRunner 文件夹。
• 编辑 config.yml 以调整设置。若启用经济奖励，服务器必须安装 Vault。
• 再次启动服务器。
• 默认情况下权限已自动设置。若使用权限管理插件，则需手动配置权限。
• 设置竞技场。
• 开始游戏！

设置竞技场的重要提示

• 区域必须为 WorldEdit 立方体选区，当前版本不支持其他形状。
• 起始点必须在区域内部，否则竞技场将不可用。
• 大厅必须在区域外部，否则竞技场将不可用。
• 竞技场墙壁必须是笔直的，否则玩家可能藏身墙内。
• 你可以装饰竞技场内部（例如放置柱子以改变视觉形状），但请注意，每次游戏开始前，通过 WorldEdit 设置的区域内，所有被 /cr setcolor <arena> 选中的方块都将被清除。
• 若使用 WorldGuard 并将区域标志设置为禁止建造、破坏或放置方块，插件将无法正常工作，方块会被破坏！建议不要使用这些区域标志。

🔧命令列表

在游戏中执行 /cr help 可获取完整命令列表。

玩家命令

• /cr - 显示插件描述。
• /cr help [类别] [页码] - 获取所有 CubeRunner 命令。
• /cr join - 打开包含所有竞技场列表的 GUI。点击特定竞技场以加入。
• /cr join <arena> - 自动加入大厅并准备游戏。
• /cr quit - 退出当前游戏。
• /cr stats - 查看你的所有统计数据、挑战以及各项统计的前 10 名玩家。
• /cr start - 开始游戏倒计时。
• /cr language - 获取可用语言列表。
• /cr language <language> - 将你的语言设置为所选语言。

管理员命令

• /cr new <arena> - 创建新竞技场。
• /cr delete <arena> - 删除竞技场。
• /cr setlobby <arena> - 设置竞技场的大厅位置。
• /cr setstartpoint <arena> - 设置竞技场游戏的起始点。
• /cr setzone <arena> - 必须先有一个 WorldEdit 立方体选区。设置竞技场的区域（玩家可移动且方块可生成的范围）。
• /cr setcolor <arena> - 设置竞技场“方块雨”的方块类型。
• /cr setminplayer <arena> <数量> - 设置竞技场所需的最小玩家数量。
• /cr setmaxplayer <arena> <数量> - 设置竞技场允许的最大玩家数量。
• /cr reload - 重载配置、语言文件和玩家数据。

✨权限

推荐权限组

• 玩家：cuberunner.player.*
• 管理员：cuberunner.admin.*

权限详情

permissions:
  cuberunner.*:
    description: 授予所有 CubeRunner 命令的访问权限
    children:
      cuberunner.player.*: true
      cuberunner.admin.*: true

  cuberunner.player.*:
    description: 授予正常游戏所需的所有命令访问权限
    children:
      cuberunner.player.list: true
      cuberunner.player.info: true
      cuberunner.player.stats: true
      cuberunner.player.language: true
      cuberunner.player.play.*: true

  cuberunner.player.list:
    description: 允许查看竞技场列表
    default: true
  cuberunner.player.info:
    description: 允许查看竞技场信息
    default: true
  cuberunner.player.stats:
    description: 允许玩家查看自己的统计数据
    default: true
  cuberunner.player.language:
    description: 允许更改个人语言
    default: true

  cuberunner.player.play.*:
    description: 授予正常进行游戏的所有权限
    children:
      cuberunner.player.play.join: true
      cuberunner.player.play.quit: true
      cuberunner.player.play.start: true

  cuberunner.player.play.join:
    description: 允许加入游戏
    default: true
  cuberunner.player.play.quit:
    description: 允许退出游戏
    default: true
  cuberunner.player.play.start:
    description: 允许开始游戏
    default: true

  cuberunner.admin.*:
    description: 授予设置竞技场和其他管理操作所需的所有命令访问权限
    children:
      cuberunner.admin.reload: true
      cuberunner.admin.info: true
      cuberunner.admin.edit.*: true

  cuberunner.admin.reload:
    description: 允许重载插件配置
    default: op
  cuberunner.admin.info:
    description: 允许查看高级竞技场信息
    default: op

  cuberunner.admin.edit.*:
    description: 授予设置竞技场所需的所有命令访问权限
    children:
      cuberunner.admin.edit.new: true
      cuberunner.admin.edit.delete: true
      cuberunner.admin.edit.zone: true
      cuberunner.admin.edit.lobby: true
      cuberunner.admin.edit.startpoint: true
      cuberunner.admin.edit.sign: true
      cuberunner.admin.edit.color: true
      cuberunner.admin.edit.amountplayer.*: true

  cuberunner.admin.edit.new:
    description: 允许创建新竞技场
    default: op
  cuberunner.admin.edit.delete:
    description: 允许删除竞技场
    default: op
  cuberunner.admin.edit.zone:
    description: 允许选择竞技场区域
    default: op
  cuberunner.admin.edit.lobby:
    description: 允许编辑竞技场大厅位置
    default: op
  cuberunner.admin.edit.startpoint:
    description: 允许编辑竞技场起始点
    default: op
  cuberunner.admin.edit.sign:
    description: 允许设置 CubeRunner 告示牌
    default: op
  cuberunner.admin.edit.color:
    description: 允许设置竞技场的方块颜色
    default: op

  cuberunner.admin.edit.amountplayer.*:
    description: 授予编辑竞技场最小和最大玩家数量的两个命令的访问权限
    children:
      cuberunner.admin.edit.amountplayer.minplayer: true
      cuberunner.admin.edit.amountplayer.maxplayer: true

  cuberunner.admin.edit.amountplayer.minplayer:
    description: 允许编辑竞技场的最小玩家数量
    default: op
  cuberunner.admin.edit.amountplayer.maxplayer:
    description: 允许编辑竞技场的最大玩家数量
    default: op

❓告示牌设置

制作方法

玩家需拥有权限 cuberunner.admin.edit.sign。

• 在第一或第二行，必须写上：[cr]
• 在下面的行中，根据告示牌类型写入以下内容：

加入告示牌

• 第 2 行：join
• 第 3 行：<arena>

游戏告示牌

• 第 2 行：play
• 第 3 行：<arena>

排行榜告示牌

• 第 2 行：top
• 第 3 行：<arena>

退出告示牌

• 第 2 行：quit

开始告示牌

• 第 2 行：start

数据告示牌

• 第 2 行：stats

> [!NOTE]

> “游戏”与“加入”告示牌的区别：“加入”告示牌会将玩家传送至竞技场，通常应放置在集散大厅（如 hub）。“游戏”告示牌不会传送玩家，通常应放置在竞技场的大厅内。当配置选项 teleportAfterEnding 设置为 false 时，此告示牌尤为有用。

⭐语言与测试

多语言支持

目前内置多种语言文件，位于 LanguageFiles 目录中。你可以在配置中选择一种。

若要创建新语言，请复制现有语言文件，重命名并翻译，然后在配置中填入文件名（不含 .yml 扩展名）。非常欢迎将您的翻译发送给我，以便集成到插件中。

**现有语言**

• English - 默认
• French - 法语
• German - 德语（感谢 AkEgo 的翻译！）

测试服务器

若想在将插件安装到自己的服务器前进行测试，可以尝试我的测试服务器。

IP: poutineqc.ca

🔧反馈与支持

问题或新功能想法？

欢迎随时发送您的想法、反馈和遇到的问题。我会尽快回复。希望大家喜欢这个插件！

捐赠

如果您觉得慷慨，请通过 PayPal 向 [email protected] 发送小额捐赠。这对我有很大帮助，也能支持我维护测试服务器。非常感谢！