原创 - 工具 - [1.7-1.21+]WarZHotKey —— 快捷按键执行指令|高级按键监听插件 | F / Q / Shift 组合 | Folia 原生支持

版权类型: 原创

插件中文名称: WarZHotKey

插件英文名称: WarZHotKey

原帖地址: #

支持的核心（服务端）

Spigot
Paper
Folia
Purpur
PufferFish
Leaves
其他核心

语言支持: 中文（简体）

适配版本（Java）

1.21
1.20
1.19
1.18
1.17
1.16
1.15
1.14
1.13
1.12
1.11
1.10
1.9
1.8
1.7

让 F、Q 不再只是交换和丢弃
一键技能 · 一键菜单 · 一键功能触发

插件介绍

WarZHotKey 是一款专为 Minecraft Spigot / Paper / Folia 服务器设计的
高级按键监听插件。
插件允许服务器管理员将玩家的常用按键操作：

F
Q
Shift + F
Shift + Q

直接绑定为自定义指令，用于实现：

技能释放
打开 GUI 菜单
快捷功能调用
职业 / RPG / 枪械 / 末日服交互系统

无需客户端 Mod，纯服务端实现。

核心特性

多按键监听

支持：
- F（副手交换）
- Q（丢弃物品）
- Shift + F
- Shift + Q
自动适配不同 Minecraft 版本

三种指令执行模式

每个按键可单独配置执行方式：

PLAYER
以玩家身份执行（遵循原版权限）
OP
临时赋予 OP 执行
执行完毕立即回收，绝对安全
CONSOLE
以控制台身份执行

🛡 权限 & 开关控制

每个按键都可：
- 独立开启 / 关闭
- 绑定额外权限节点
支持基础权限 + 进阶权限双重控制

⏱ 冷却系统

内置毫秒级冷却管理
防止高频触发 / 滥用
支持 OP 无视冷却

Folia 原生支持

不使用 BukkitScheduler
完全遵循 Folia API
多线程环境稳定运行

超强版本兼容

1.7.x - 1.21+
自动识别：
- 1.7 / 1.8：仅监听 Q
- 1.9+：完整支持 F + Q

安装说明

运行环境

Java：Java 8 及以上（推荐 Java 17+）
服务端：
- Spigot
- Paper
- Folia
- Purpur 等 Bukkit 派生端

安装步骤

将
代码：
```
WarZHotKey-1.0.0.jar
```
放入 plugins 文件夹
重启服务器
编辑
代码：
```
plugins/WarZHotKey/config.yml
```
使用 /whk reload 重载配置

命令与权限

插件命令

主命令别名：/whk、/warzhotkey

命令	说明	权限
`/whk help`	查看帮助	无
`/whk reload`	重载配置	`warz.hotkey.reload`

权限节点

权限	默认	说明
`warz.hotkey.use`	true	使用快捷键基础权限
`warz.hotkey.reload`	op	重载配置
`warz.hotkey.bypasscooldown`	op	无视冷却

每个按键还可以在 config.yml 中设置 独立权限

配置示例

代码：

cooldown: 3

hotkeys:
  F:
    enabled: true
    permission: ""
    cancel-event: true
    command-mode: PLAYER
    commands:
      - "skill use dash"

  SHIFT_F:
    enabled: true
    permission: "warz.hotkey.vip"
    cancel-event: true
    command-mode: OP
    commands:
      - "say 我使用了 Shift+F"

  Q:
    enabled: true
    cancel-event: false
    command-mode: PLAYER
    commands:
      - "say 我按下了 Q"

  SHIFT_Q:
    enabled: true
    cancel-event: true
    command-mode: CONSOLE
    commands:
      - "give %player% minecraft:diamond 1"

常见问题

Q：1.8 按 F 没反应？

A：
1.8 版本 没有副手系统，插件会自动禁用 F 键监听，不会报错。

Q：临时 OP 安全吗？

A：
非常安全。
插件使用 try-finally 结构，OP 权限会在指令执行结束后 立即回收，不存在可利用窗口。

Q：支持 Folia 吗？

A：
完全支持，并且是 原生适配，不是兼容凑合。

适用服务器类型

RPG / 技能服
枪械服 / TacZ / Timeless
末日生存 / WarZ 系列
职业 / 技能树服务器
高交互玩法服务器

作者信息

作者：Crazy_Jky
插件定制开发：QQ 1285988665
插件技术交流群：398893720
末日类服务器交流群：1063544727

反馈： z77z43883

原创工具 [1.7-1.21+]WarZHotKey —— 快捷按键执行指令|高级按键监听插件 | F / Q / Shift 组合 | Folia 原生支持 1.0.1

插件介绍