KEY COMMAND BIND - 按键命令绑定

Key Command Bind 是一款允许玩家通过按下键盘数字键（1-9）来触发预设命令的 Minecraft 插件。它提供了丰富的配置选项，包括冷却时间、权限检查、消耗设置等，并能与 PlaceholderAPI 和 Vault 等插件联动。

💡核心功能

• 按键绑定命令：将数字键 1 至 9 绑定到自定义命令。
• 触发限制：可设置在飞行或潜行时禁用按键。
• 冷却系统：为每个按键设置独立的触发冷却时间。
• 权限控制：为每个按键绑定独立的权限节点。
• 消耗机制：支持消耗玩家的经验等级或游戏内金钱（需 Vault）来执行命令。
• 占位符支持：支持 PlaceholderAPI，可使用 %kcbPlayer% 获取玩家名。
• 控制台执行：在命令前添加 -c- 前缀，即可让命令在控制台执行。
• 物品交换控制：可禁用按键触发时切换快捷栏物品的行为。

🎮安装与要求

安装步骤

• 确保服务器 Java 版本为 8 或更高。
• 将下载的 KeyCommandBind.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件。
• 根据需求编辑 plugins/KeyCommandBind/config.yml 文件。

前置依赖（可选但推荐）

• Vault：用于支持经济（金钱）消耗功能。
• PlaceholderAPI：用于在消息中使用丰富的占位符。

🔧配置详解

配置文件位于 plugins/KeyCommandBind/config.yml。以下是对主要配置项的说明：

全局设置

# 启用/禁用调试信息
"disableMessages": false,
# 启用/禁用通过切换物品来检测按键（传统模式）
"swapModeEnabled": false,
# 启用/禁用通过按键按压来检测按键（推荐模式）
"keyPressModeEnabled": false,

按键模式配置 (`keyPressMode`)

每个按键（key1 到 key9）都有独立的配置区块。以 key1 为例：

"key1": {
  # 启用或禁用此按键槽位
  "enabled": false,
  # 按下按键时禁用物品交换
  "disableSwap": false,
  # 启用按键后物品返回指定槽位
  "returnKeyEnabled": false,
  "returnKeySlot": 1,
  # 仅在潜行时激活命令
  "sneakingOnly": false,
  # 潜行时禁用命令（覆盖 sneakingOnly）
  "disableOnSneak": false,
  # 飞行时禁用命令
  "disableOnFly": false,
  # 启用权限检查
  "usePermission": false,
  "permission": "kcb.key1",
  # 无权限时的提示消息
  "noPermissionMessageEnabled": false,
  "noPermissionMessage": "Key is still in cooldown",
  # 冷却时间（毫秒），设为 0 则无冷却
  "cooldownMilliSeconds": 500,
  "cooldownMessageEnabled": false,
  "cooldownMessage": "Key is still in cooldown",
  # 经验等级消耗
  "enabledExpCost": false,
  "expCost": 1,
  "insufficientExpMessageEnabled": false,
  "insufficientExpMessage": "Insufficient exp to run command",
  # 金钱消耗（需 Vault）
  "moneyCostEnabled": false,
  "moneyCost": 1,
  "insufficientMoneyMessageEnabled": false,
  "insufficientMoneyMessage": "Insufficient exp to run command",
  # 要执行的命令列表
  "commands": [
    "version",
    "-c- say %kcbPlayer% executed a console command"
  ]
}

❓常见问题与帮助

如何让命令在控制台执行？

在 commands 列表中的命令前加上 -c- 前缀。例如："-c- say Hello"。

如何在命令中使用玩家名？

使用 %kcbPlayer% 占位符，它会被替换为触发按键的玩家名称。

如何报告漏洞或提出建议？

• 请在 Spigot 资源页面的 讨论区 发帖。
• 或通过 Spigot 账户直接向作者发送私信。

> 注意：在评分区提交的报告可能会被遗漏。

✨支持作者

如果您喜欢这个插件并想支持作者继续开发，可以考虑通过 Spigot 页面提供的链接请作者喝杯咖啡或吃个披萨。您的支持是最大的动力！