我已经收到您的指令,请提供需要翻译的游戏文本内容。

我已经收到您的指令,请提供需要翻译的游戏文本内容。

将多键组合绑定到任意按键,在模组的自身配置中找到其绑定,搜索/排序/筛选控制界面。

基础库

键位绑定增强 (Keybindery)

为游戏中的任何按键绑定多键和弦快捷键,从模组的配置界面直接跳转到该模组的按键绑定,并支持对控制界面进行搜索/排序/筛选。

一个客户端模组,三项功能合一。

多键和弦按键绑定

按住任意组合键 — Ctrl + Shift + K、X + Z,甚至鼠标按键 — 松开即绑定。适用于游戏中的所有按键绑定:原版、模组、任何类型。

单键绑定仍与之前完全一样。和弦绑定按每个绑定选择性启用。

自动列出模组按键绑定

无需再在按键绑定菜单中费力寻找特定模组的按键绑定。

  • 使用 YACL 的模组 会自动在其配置界面添加原生的"按键绑定"标签页。
  • 其他模组的配置 会在右上角添加一个小的"按键绑定"按钮 — 单击即可打开已预筛选到该模组绑定的控制界面。

推荐安装 Mod Menu(Keybindery 通过它来发现哪些按键绑定属于哪个模组),但 YACL 标签页无需 Mod Menu 也能正常工作。

控制界面改造

按键绑定菜单新增了工具栏:

  • 搜索按键绑定 — 输入名称以缩小列表范围
  • 搜索按键组合 — 点击后按下任意和弦;列表会显示所有与该和弦共享按键的内容(即时冲突查找器)
  • 排序 — 按类别(默认)、字母顺序或按绑定按键
  • 筛选 — 仅显示冲突绑定、仅显示未绑定绑定,或不筛选

每一行还新增了两个图标:

  • ⚠ 冲突 — 打开已预筛选到该绑定所有冲突键位的控制界面
  • ↻ 重置 — 恢复按键绑定的默认值

长按键绑定名称会自动滚动,而不会被截断。

原版将所有未分类的模组按键绑定塞入的"MISC"类别会自动按模组拆分,因此你将看到"Inventory Plus / Shulker Palette / [其他模组]",而不是一个巨大的未排序的 MISC。

需求

  • Fabric Loader 0.15 或更新版本
  • Fabric API
  • YACL (Yet Another Config Lib) — 通过 JIJ 内置于 Keybindery 中,无需单独安装
  • Mod Menu — 强烈推荐用于自动列出模组按键绑定

安装

将 jar 文件与 Fabric API 一起放入 mods/ 文件夹。Keybindery 仅限客户端 — 安装在服务器端无效果。

兼容性

  • 完全尊重原版单键绑定。未选择启用和弦的模组行为不变。
  • 与流行的 Fabric 输入模组(Controlify、MidnightControls 等)兼容 — Keybindery 在狭窄的钩子点使用精确的 Mixin 注入,不使用 @Overwrite。
  • 和弦绑定会与 options.txt 中的原版设置一同序列化。卸载后一切将干净地恢复为单键行为。

给模组开发者的说明

Keybindery 附带一个小型 API(内置于主 jar 中),您可以在自己的模组中使用。请参阅 GitHub 上的 README 了解 API 接口。

鸣谢

灵感来源于 Amecs、Controlling 以及更广泛的 Fabric 输入模组生态的设计选择。