Blocks To Commands - 方块命令化

💡简介

BlocksToCommands 是一款允许玩家将任意指令绑定到方块上的插件。当玩家右键点击该方块时，预设的指令便会执行。指令可以设置为由控制台或玩家本人执行，并支持经济消费与丰富的变量系统。

🎮前置需求与依赖

• 必需：本插件需要 Vault 作为前置插件。

- Vault 下载地址：https://dev.bukkit.org/projects/vault

• 可选但推荐：若需使用经济消费功能，您还需要一个与 Vault 兼容的经济插件（如 EssentialsX、CMI 等）。
• 版本兼容：插件已内置 1.8 版本的二进制文件，以兼容旧版服务器。

🔧使用方法

创建指令方块

• 手持物品，看向您想绑定的方块。
• 执行指令 /btc create <名称> 来创建一个新的指令方块。
• 为该方块添加指令：/btc add cmd <名称> <是否由控制台执行: true/false> <指令>。
• 完成设置后，玩家右键点击该方块即可触发您设置的指令。

移除指令方块

您可以通过以下两种方式移除已设置的指令方块

• 方式一：拥有 btc.remove 权限的玩家，可以潜行并破坏该方块。
• 方式二：执行管理员指令 /btc remove <名称>。

其他实用指令

• /btc help：查看完整的指令帮助。
• /btc list：查看所有已设置的指令方块列表。

✨权限列表

• btc.admin：授予服务器管理员。
• btc.use：授予允许使用指令方块的玩家。
• btc.remove：允许玩家潜行破坏指令方块。
• 自定义权限：您可以为每个方块设置独立的权限。例如：/btc set perm 方块名称 自定义权限节点。玩家需要同时拥有 btc.use 和此自定义权限才能使用该方块。

[$] Vault 经济支持

您可以为使用指令方块设置消费。

• 设置花费：/btc set cost <名称> <金额>
• 移除花费：/btc remove cost <名称>

当玩家使用需要付费的方块时，若余额不足，将收到提示；若支付成功，相应金额会从其账户扣除。

[%] 可用变量

变量需包裹在 ${} 中使用，例如 ${playerName}。变量区分大小写，请严格按照下方格式书写。

• 玩家信息

-   `${name}`：玩家用户名。

-   `${displayName}`：玩家显示名（含前缀）。

-   `${uuid}`：玩家的 UUID。

-   `${ip}`：玩家的 IP 地址。

-   `${randomPlayer}`：随机获取一名在线玩家的名字。

• 位置信息

-   `${x}`, `${y}`, `${z}`：玩家当前所在的坐标。

-   `${blockX}`, `${blockY}`, `${blockZ}`：被点击方块所在的坐标。

-   `${world}`：当前世界名称。

变量使用示例

• 让控制台 OP 点击方块的玩家：/btc add cmd opBlock true op ${name}
• 向玩家发送个性化消息：/btc add msg welcomeBlock &a你好，${displayName}

⭐配置文件详解 (`config.yml`)

配置文件主要包含消息提示与功能选项。

消息提示

您可以自定义玩家收到的各类提示信息，支持颜色代码 (&)。

• mayNotPerformCommand: 无权限执行指令时的提示。
• mayNotBreakBlock: 无权限破坏方块时的提示。
• mayNotUseBlock: 无权限使用方块时的提示。
• notEnoughFunds: 经济不足时的提示。支持 ${cost}（花费）和 ${currency}（货币名称）变量。
• fundsDeducted: 扣款成功时的提示。同样支持 ${cost} 和 ${currency} 变量。

货币名称

• currency: 定义服务器货币的显示名称（如：金币、美元）。

功能选项

• adminShiftRemove: 设置为 true 时，拥有 btc.admin 权限的管理员可以按住潜行键破坏指令方块来删除它。
• interactSounds: （暂未实现）未来可能用于设置玩家与方块交互时的音效。
• metrics: 是否启用匿名数据统计（bStats），以帮助开发者改进插件。您可以选择在此处关闭。

🔧配置示例

以下是一个名为 “op” 的指令方块配置文件 (op.yml) 示例，它展示了完整的设置结构：

Block:
  name: op
  location:
    world: world
    x: -319
    y: 144
    z: 415
messages:
  msg_1:
    message: '&aYou are now OP'
commands:
  cmd_1:
    command: op ${name}
    runFromConsole: true
  cmd_2:
    command: money
    runFromConsole: false
cost: 1000.0

说明：该方块位于主世界的 (-319, 144, 415)。玩家使用时，控制台会执行 op 指令为该玩家授权，同时玩家自身会执行 money 指令查看余额，整个过程会花费 1000 货币单位，并提示绿色消息“You are now OP”。

❓注意事项与鸣谢

• 数据统计：本插件使用了 bStats 收集匿名使用数据以优化插件。如果您希望禁用，请在 config.yml 中将 metrics 选项设为 false。插件 bStats 页面可在项目页找到。
• 反馈与贡献：如果您有功能建议，欢迎在讨论区提出，或到 GitHub 上 Fork 本项目。
• 致谢：感谢超过 5000 次下载！完整文档请参阅插件发布页。