[MC插件] HotKeyManager v20260511 – 评分 5.0/5.0

插件详细介绍

插件简介 🧩

HotKeyManager 是一款专为 Minecraft 服务器设计的自定义快捷键管理插件，作者为 crston，当前版本 20260511，在 SpigotMC 上获得了 5.0/5.0 的满分评价，累计下载量已突破 433 次。它的核心思路十分直接：让服务器管理员能够将原版游戏中默认的 Q（丢弃物品）、F（切换副手）、L（打开进度）等按键绑定为任意指令，甚至支持 Shift + 组合键（如 Shift + Q、Shift + 1~9），从而极大丰富玩家的交互方式。

核心功能 ✨

• ✅ 支持的按键组合：Q、F、L、Shift + Q、Shift + F、Shift + L，以及 Shift + 1~9 数字键。
• ✅ 可定制执行主体：每个快捷键绑定的命令可以选择以 player（玩家身份）、op（管理员身份）或 console（控制台身份）执行。
• ✅ 智能防冲突：内置冷却系统，避免按下 L 键后被误判为 Shift + L 组合键。
• ✅ 屏蔽默认行为：按下 Q 时不再会丢弃物品，按下 F 时也不会切换副手，完全由你设定的命令接管。
• ✅ 高性能检测：基于 ProtocolLib 实现精准的按键监听，并针对服务器性能进行了优化，不会造成额外负载。
• ✅ 热重载支持：修改配置后只需执行 /hotkeyreload 即可生效，无需重启服务器。

使用场景 🎯

HotKeyManager 非常适合希望简化玩家操作或增加服务器趣味性的管理场景：

• 将 Q 键改为“快速打开菜单”或“执行 /warp spawn 回城”。
• 将 F 键设为“切换飞行模式”或“打开商店界面”。
• 利用 Shift + 1~9 快速切换游戏模式、执行调试命令，甚至作为小游戏房内的快捷技能触发键。
• 适合 RPG、生存、小游戏等需要频繁使用命令但又不想让玩家记长命令的服务器。

配置说明 ⚙️

所有设置都在 plugins/HotKeyManager/config.yml 中完成，结构非常直观。以下是一个完整示例：

hotkeys:
  Q:
    enabled: true
    command: "say Q pressed by %player%"
    executor: "player"
  SHIFT_Q:
    enabled: true
    command: "say Shift + Q pressed"
    executor: "player"
  F:
    enabled: true
    command: "say F key"
    executor: "player"
  SHIFT_F:
    enabled: true
    command: "say Shift + F key"
    executor: "player"
  SHIFT_1:
    enabled: true
    command: "say Shift + 1 key"
    executor: "console"
  SHIFT_2:
    enabled: true
    command: "say Shift + 2 key"
    executor: "console"
  # ...（Shift_3 至 SHIFT_9 同理）
  L:
    enabled: true
    command: "say L key"
    executor: "op"
  SHIFT_L:
    enabled: true
    command: "say Shift + L key"
    executor: "op"

其中 %player% 变量在执行时会自动替换为触发该快捷键的玩家名称。你可以根据需要为每个按键单独设置启用状态、命令和执行权限。

兼容性与依赖 🛡️

• 必须依赖：ProtocolLib（请务必确保已安装该插件，否则 HotKeyManager 无法正常工作）。
• 支持 1.8~1.20 以上版本（基于 ProtocolLib 的版本支持）。
• 与大部分主流插件无冲突，因为 HotKeyManager 仅拦截特定按键事件，不会干扰其他插件逻辑。

安装步骤：将 HotKeyManager.jar 放入 plugins/ 文件夹，同时安装 ProtocolLib，然后启动服务器。首次运行后编辑 plugins/HotKeyManager/config.yml，再输入 /hotkeyreload 即可应用配置。无需任何额外操作，轻松定制你的快捷键系统。