WDMla 按键绑定

基本信息

属性 值
绑定数 6
静态字段 KeyEvent.key_cfg / key_show / key_liquid / key_recipe / key_usage / key_details（KeyEvent.java:29-34）
构造位置 KeyEvent 构造函数，客户端 init 阶段经 ClientRegistry.registerKeyBinding 注册（Waila.java:69、KeyEvent.java:37-48）
事件监听 InputEvent.KeyInputEvent（KeyEvent.java:51-52）
语言域 waila.keybind.*（Constants.java:15-20）

按键

字段 配置键 默认键 分类名 中文名（zh_CN.lang）
key_cfg waila.keybind.wailaconfig 小键盘 0 Waila [Waila]配置屏幕
key_show waila.keybind.wailadisplay 小键盘 1 Waila [Waila]显示/隐藏
key_liquid waila.keybind.liquid 小键盘 2 Waila [Waila]显示流体
key_recipe waila.keybind.recipe 小键盘 3 Waila [Waila]显示合成
key_usage waila.keybind.usage 小键盘 4 Waila [Waila]显示可参与合成
key_details waila.keybind.details 左 Shift WDMla 显示详细信息

默认键常量取自 org.lwjgl.input.Keyboard：KEY_NUMPAD0–KEY_NUMPAD4 与 KEY_LSHIFT（KeyEvent.java:37-48）。

只有 key_details 的分类名是 WDMla，其余五个都是 Waila（KeyEvent.java:37-48）。在游戏选项的按键设置里，前五个会与其它 Waila 附属的同名按键混在同一分类下。

交互

按键 行为
key_cfg 打开 WDMla 配置界面 ModsMenuScreenConfig（KeyEvent.java:53-60），仅在无其它界面打开时生效
key_show 切换提示框总开关（General.forceLegacy 之外的独立显隐）
key_liquid 切换流体显示
key_recipe 切换合成配方显示
key_usage 切换「可参与合成」物品显示
key_details（左 Shift） 按住展开详细信息，对应 调试插件 的诊断项与 harvestability.condition.textdetailsonly

打开配置界面抛 ConfigException 时由 WailaExceptionHandler.handleErr 兜底（KeyEvent.java:57-59）。

key_show 被按下与否在 onKeyEvent 首行就被读取为局部变量 showKey（KeyEvent.java:52），后续逻辑复用该快照。

设计约束

KeyEvent 的类注释说明它不能在 WDMla 上重写：Waila 把它开放给了自己的附属使用（KeyEvent.java:24-25）。这与 WDMla 大量 @BackwardCompatibility 标注的旧版 API 是同一套兼容策略。

en_US.lang 中还有一条 waila.keybind.testing（en_US.lang:477），但 KeyEvent 只注册 6 个 KeyBinding，没有使用 BIND_SCREEN_ENCH（Constants.java:13）或任何 testing 绑定——这两条语言键与常量在本仓内无对应注册，属遗留键。

相关条目