Keybind

模组

· 作者 iM5LB1

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

0 本站下载 0 关注 更新于 1 天前

最新 1.0.5 · 26.3 · Bukkit / Folia

一键开服(送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…(按下某个键…),然后按下你选择的按键(需要安装客户端模组)。
  • ⏱️ 双重冷却时间:包含全局冷却时间(任意动作之间)和每个动作独立的冷却时间,防止滥用。
  • 📊 bStats 指标:提供完全匿名的服务器遥测数据,帮助追踪插件的使用情况和普及度。
  • 🔐 权限支持:除了默认的 keybind.use 权限外,每个动作都支持可选的额外权限节点。

🚀 工作原理

  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 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

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源