⌨️ 按键绑定
将按键绑定到服务器端命令。按下按键,服务器执行一条命令。
客户端模组 (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 秒,插件通过
keybind:sync通道发送所有配置好的动作(名称、显示名称、默认按键)。 - 注册:模组将每个动作注册为 Minecraft 原生按键绑定,归类于 设置 → 控制 中的 Keybind 类别下。
- 触发:当按下按键且没有打开任何屏幕时,模组通过
keybind:main通道发送动作名称。 - 执行:插件验证动作名称(仅限字母数字和下划线),检查权限和冷却时间,然后运行命令。
?️ 安装
服务端
- 将
Keybind-Plugin-1.0.4.jar放入你的plugins/文件夹。 - 重启服务器 ——
plugins/Keybind/config.yml会自动生成。 - 编辑
config.yml定义你的动作,然后运行/kbind reload。
客户端
- 将与你的 Minecraft 版本和加载器匹配的客户端 jar 文件安装到
.minecraft/mods/中。 - 安装所选平台所需的加载器和 API。Minecraft 1.21.x 请使用 Java 21,Minecraft 26.x 请使用 Java 25。
- 不要同时安装多个 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 |
你是这个资源的作者?登录后可认领此资源。
相似资源
Woot Revived
pharuxtan
一个用于收集生物掉落物的多区块模组。
生物科技
349
玉Jade ?
Snownee
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
实用前置
339
KubeJS
Lat
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
前置实用
238
物品管理器Just Enough Items (JEI)
mezz
查看物品与配方
前置实用
229
Xaero的小地图
thexaero
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
冒险交通
196
Applied Energistics 2
shartte
AE2:一款流行的自动化与存储模组
存储科技
165
评论 0
登录后参与评分
还没有评论,来抢沙发吧