⌨️ 按键绑定
将按键与服务端命令绑定。按下按键,服务器执行命令。
客户端模组 (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…(按下某个键…),然后按下你选择的按键(需要安装客户端模组)。 - ⏱️ 双重冷却时间:包含全局冷却时间(任意动作之间)和每个动作独立的冷却时间,防止滥用。
- 📊 bStats 指标:提供完全匿名的服务器遥测数据,帮助追踪插件的使用情况和普及度。
- 🔐 权限支持:除了默认的
keybind.use权限外,每个动作都支持可选的额外权限节点。
🚀 工作原理
- 同步:玩家加入后 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 Releases 并在玩家加入时通知管理员)
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 分支)
实用前置
341
Xaero的小地图
thexaero
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
冒险交通
241
KubeJS
Lat
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
前置实用
239
物品管理器Just Enough Items (JEI)
mezz
查看物品与配方
前置实用
239
Applied Energistics 2
shartte
AE2:一款流行的自动化与存储模组
存储科技
217
评论 0
登录后参与评分
还没有评论,来抢沙发吧