原创 - 开源 - 工具 - 其他 - WaterCommand - 给你的指令绑定按键(SHIFT-Q，F) 支持自定义消息权限【1.12.X-1.21.X】

版权类型: 原创

插件中文名称: 沃特指令

插件英文名称: WaterCommand

原帖地址: #

支持的核心（服务端）

Spigot
Paper

语言支持: 多语言

前置组件: 【可选】PlaceHolderAPI https://www.spigotmc.org/wiki/hooking-into-placeholderapi/

适配版本（Java）

1.21
1.20
1.19
1.18
1.17
1.16
1.15
1.14
1.13
1.12

[由AI生成，侵删]
:吃彩瓜:

前言

本插件是我的既 CompassCommand 之后的另一款绑定工具。由于原生的Bukkit服务器不支持监听玩家按下按键并传递消息返回服务器，如果需要实现全按键支持，必须采用MOD作为监听支持的接口传递给插件，所以当前纯插件阶段只能支持监听玩家的动作，然后取消按键实现检测按键。

局限性 :只能绑定SHIFT_Q 或者 SHIFT_F 按键，并且如果玩家改变了按键绑定，会导致按键检测不准的问题。

后期会开发相关的MOD使其支持全按键，如果不介意的话可以下载安装。
:恰饭:

插件功能

指定按键绑定任意的命令
在检测到玩家按键绑定的按键被按下触发的时候执行命令，并且发送消息
支持自定义命令，自定义消息
存在防抖功能，可以设置防抖时间的间隔
可以设置命令的执行对象玩家或者是服务器
文本区域支持PAPI

插件指令和权限
[TABLE=collapse,centered]
[TR]
[TH]指令[/TH]
[TH]别名[/TH]
[TH]父指令[/TH]
[TH]权限[/TH]
[TH]功能[/TH]
[/TR]
[TR]
[TD]watercommand[/TD]
[TD]wcd[/TD]
[TD]无[/TD]
[TD]watercommand.admin[/TD]

[TD]

重载插件

[/TD]
[/TR]
[TR]
[TD]reload[/TD]
[TD][/TD]

[TD]watercommand[/TD]
[TD]watercommand.admin[/TD]

[TD]

重载插件

[/TD]
[/TR]
[/TABLE]
:喝果汁:

配置文件

YAML：

[/FONT]
locale: zh
# 是否自动检查更新，并且下载最新版本
check-update:
  enable: true
  auto-download: true
# 执行指令之间的防抖延迟 单位:毫秒
doBounceDelay: 100

# 按键绑定的只能是游戏中的按键，服务器无法读取玩家客户端上的按键，除非装了专门的mod传递按键消息给服务器
# 未来版本会开发客户端MOD，专门检测玩家按键。
# 支持的按键只能是类似如: 玩家下蹲shift + 玩家换副手 f 或 玩家下蹲shift + 玩家丢出物品 Q 如果绑定这些指令会覆盖原来的操作。
# Keys: SHIFT_F SHIFT_Q
# 清注意，SHIFT_F和SHIFT_Q必须在玩家手中有物品才能执行，已知BUG，存在F和Q按键冲突，暂时只能绑定一个按键
# 如果是SHIFT_Q,那么SHIFT_Q 和 SHIFT_F两者任一一个按下都会触发
# '[player]'可以更改为[console]表示是终端输出指令，后面必须要紧跟着指令。同时支持papi.
Binds:
  "open_menu":
    name: 'main_menu'
    key: SHIFT_Q
    command: '[player]menu'
    message: '§e你打开了主菜单§r'
    permission: none
    cancelAction: true
  #"open_shop":
  #  name: 'shop'
  #  key: SHIFT_F
  #  command: '[player] shop'
  #  permission: none
  #  cancelAction: true
[FONT=AlimamaFangYuanTiVF-Thin]

注意事项

SHIFT_Q 和 SHIFT_F 键不能同时绑定，因为两者事件发生冲突，所以理论上只有两种单独的按键是可以绑定指令的,后期会更新mod支持更多的按键，前提是客户端必须装这个mod，服务端才能检测到玩家按键的事件。
玩家必须手持物品才能执行指令，如果需要玩家取消SHIFT_Q丢弃的功能在执行插件的过程中，把 cancelAction 设置为 true 即可
如果你是paper端，则配置文件可能会在 plugin/.paper-remapped/WaterCommand 下