Keybind

模组

· 作者 iM5LB1

⌨️ 将按键绑定到服务器端命令。按下按键,服务器执行相应命令。

0 本站下载 0 关注 更新于 4 周前

最新 1.0.4 · 26.3 · Bukkit / Paper

一键开服(送7天)

⌨️ 按键绑定

将按键绑定到服务器端命令。按下按键,服务器执行一条命令。

客户端模组 (Fabric) • 服务端插件 (Paper)

环境 加载器 MC 版本 状态
客户端 Fabric 1.21.x, 26.x 已发布
服务端 Paper 1.18.2+ 已发布
客户端 NeoForge 1.21.x, 26.x 已发布
客户端 Forge 1.21.x, 26.x 已发布

注意:必须同时安装服务端插件和对应的客户端模组,按键绑定才能正常工作。在没有安装该插件的服务器上,不会注册或提供任何按键绑定。


✨ 特性

  • ? 服务端驱动:动作完全由服务端定义,并在玩家加入时同步到客户端。
  • ? 按服务器存储:按键分配保存在 .minecraft/config/keybind-servers/ 中,以服务器 IP 为区分,重新加入时不会被覆盖。
  • ?️ 动态注册:新的服务器动作无需重启游戏即可出现在你的 设置 → 控制 菜单中。
  • ? 游戏内管理器:在 Paper 1.21.7+ 上,/kbind manage 会打开一个 Minecraft 对话框,允许你添加、编辑或删除按键绑定,而无需触碰 config.yml。点击 Press a key…(按下某键…),然后按下你想绑定的按键(需要客户端模组)。
  • ?️ 备用箱子 GUI:对于没有 Paper Dialog API 的服务器,提供交互式的 54 格箱子 GUI 作为备用方案。
  • ? 自动更新通知:检查 GitHub 发行版,当有新版本可用时,在玩家加入时自动通知管理员。
  • ? bStats 指标:完全匿名的服务器遥测数据,有助于跟踪插件的使用情况和普及率。
  • ?️ 自定义显示名称:服务器所有者可以设置友好的名称(例如 "Teleport to Spawn" 而不是 spawn)。
  • ⏱️ 双重冷却时间:全局冷却时间(任意动作之间)和每个动作单独的冷却时间可防止滥用。
  • ? 权限支持:除了基础的 keybind.use 权限外,每个动作还支持可选的额外权限节点。
  • ? 插件消息通道:使用 keybind:main / keybind:sync 插件消息通道。如果数据包通道不可用,则回退到 /kbind <action>。
  • ? 过期动作清理:来自之前会话的过时动作会自动从控制菜单和保存的配置中移除。
  • ? 多加载器客户端:提供适用于 Minecraft 1.21.x 和 26.x 的 Fabric、Forge 和 NeoForge 构建版本。

? 工作原理

  1. 同步:玩家加入后 1 秒,插件通过 keybind:sync 通道发送所有配置好的动作(名称、显示名称、默认按键)。
  2. 注册:模组将每个动作注册为 Minecraft 原生按键绑定,归类于 设置 → 控制 中的 Keybind 类别下。
  3. 触发:当按下按键且没有打开任何屏幕时,模组通过 keybind:main 通道发送动作名称。
  4. 执行:插件验证动作名称(仅限字母数字和下划线),检查权限和冷却时间,然后运行命令。

?️ 安装

服务端

  1. 将 Keybind-Plugin-1.0.4.jar 放入你的 plugins/ 文件夹。
  2. 重启服务器 —— plugins/Keybind/config.yml 会自动生成。
  3. 编辑 config.yml 定义你的动作,然后运行 /kbind reload。

客户端

  1. 将与你的 Minecraft 版本和加载器匹配的客户端 jar 文件安装到 .minecraft/mods/ 中。
  2. 安装所选平台所需的加载器和 API。Minecraft 1.21.x 请使用 Java 21,Minecraft 26.x 请使用 Java 25。
  3. 不要同时安装多个 Keybind 客户端 jar 文件。启动游戏并连接到运行了 Keybind 插件的服务器。

⚙️ 配置

plugins/Keybind/config.yml

# 更新检查器(检查 GitHub 发行版并在玩家加入时通知管理员)
update-checker: true

# 任意按键绑定动作之间的全局冷却时间(毫秒)
global-cooldown: 500

actions:
  spawn:
    command: "spawn"              # 要执行的命令(不带 /)
    display-name: "Spawn"        # 在控制菜单中显示的标签
    default-key: "LEFT_BRACKET"  # 首次连接玩家的建议按键
    permission: ""               # 可选的额外权限节点(留空表示无)
    cooldown: 1000               # 单个动作的冷却时间(毫秒);默认为 global-cooldown
    console: false               # true = 以控制台身份运行,并将 {player} 替换为玩家名称

  home:
    command: "home"
    display-name: "Home"
    default-key: "RIGHT_BRACKET"
    permission: ""
    cooldown: 1000
    console: false

# 启用匿名指标报告(bStats)
metrics: true

说明:

  • 动作名称必须仅包含字母数字字符和下划线(例如 my_action)。
  • console: true 将以控制台发送者的身份运行命令。使用 {player} 作为玩家名称的占位符(例如 command: "tp {player} spawn")。
  • default-key 仅在玩家首次连接时应用。后续加入时将使用他们保存的绑定。

⌨️ 支持的按键

键盘

类别 值
字母键 A–Z
数字键 0–9
功能键 F1–F25
方向键 UP, DOWN, LEFT, RIGHT
导航键 PAGE_UP, PAGE_DOWN, HOME, END, INSERT, DELETE
特殊键 SPACE, ENTER, TAB, BACKSPACE, ESCAPE, PAUSE
锁定键 CAPS_LOCK, SCROLL_LOCK, NUM_LOCK
其他键 PRINT_SCREEN, MENU
修饰键 LEFT_SHIFT, LEFT_CONTROL(或 LEFT_CTRL), LEFT_ALT, LEFT_SUPER, RIGHT_SHIFT, RIGHT_CONTROL(或 RIGHT_CTRL), RIGHT_ALT, RIGHT_SUPER
小键盘 KP_0–KP_9, KP_ADD, KP_SUBTRACT, KP_MULTIPLY, KP_DIVIDE, KP_DECIMAL, KP_ENTER, KP_EQUAL
符号键 LEFT_BRACKET, RIGHT_BRACKET, BACKSLASH, SEMICOLON, APOSTROPHE, COMMA, PERIOD, SLASH, GRAVE_ACCENT, MINUS, EQUAL — 或直接使用字符:[, ], \, ;, ', ,, ., /, `, -, =
世界键 WORLD_1, WORLD_2(某些键盘上的区域特定按键)

鼠标

值 别名 按钮
MOUSE_LEFT MOUSE_1 左键点击
MOUSE_RIGHT MOUSE_2 右键点击
MOUSE_MIDDLE MOUSE_3 中键点击
MOUSE_4–MOUSE_8 — 侧边/额外按钮

? 指令与权限

指令 描述 权限
/kbind <action> 手动触发一个动作 keybind.use
/kbind list 列出所有已配置的动作名称 (任意)
/kbind manage 打开 Minecraft 对话框管理器(Paper 1.21.7+) keybind.admin
/kbind add <name> <command...> 创建快捷键绑定 keybind.admin
/kbind set <name> <field> <value> 编辑 command、display、key、permission、cooldown 或 console keybind.admin
/kbind remove <name> 删除快捷键绑定 keybind.admin
/kbind reload 重新加载配置文件并同步所有在线玩家 keybind.admin
权限 描述 默认值
keybind.use 触发任何动作所需的权限 true(所有人)
keybind.admin 访问 /kbind manage、添加/设置/删除以及重载的权限 op
keybind.bypass.cooldown 忽略所有冷却时间 op

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源