键位

GuideNH 共注册 6 个 KeyBinding,全部在 com.hfstudio/guidenh/client/hotkey/ 下, 用 ClientRegistry.registerKeyBinding 注册(客户端专属,服务端不注册)。

键位总表

字段 配置 ID 默认键 分类
OPEN_GUIDE_KEY key.guidenh.open_guide G(Keyboard.KEY_G) key.categories.guidenh
OPEN_GUIDE_HOME_KEY key.guidenh.open_guide_home G(Keyboard.KEY_G) key.categories.guidenh
GUIDE_PAGE_BACK_KEY key.guidenh.guide_page_back Backspace(Keyboard.KEY_BACK) key.categories.guidenh
GUIDE_PAGE_FORWARD_KEY key.guidenh.guide_page_forward Enter(Keyboard.KEY_RETURN) key.categories.guidenh
OPEN_SCENE_EDITOR_KEY key.guidenh.open_scene_editor 未绑定(Keyboard.KEY_NONE) key.categories.guidenh
CYCLE_REGION_WAND_MODE_KEY key.guidenh.cycle_region_wand_mode 未绑定(Keyboard.KEY_NONE) key.categories.guidenh

6 个键位分属 5 个类,其中 GuidePageHistoryHotkey 一个类注册 2 个 (后退 / 前进成对)。

⚠️ 源码缺陷:两个键位默认同为 G

OpenGuideHotkey.java:43 的 OPEN_GUIDE_KEY 与 OpenGuideHomeHotkey.java:20 的 OPEN_GUIDE_HOME_KEY 默认键都是 Keyboard.KEY_G,且两者的配置 ID 不同 (key.guidenh.open_guide vs key.guidenh.open_guide_home), 分类相同(key.categories.guidenh)。

后果:在控制台设置(Options → Controls → Key Binds)里, 「打开指南」与「打开首页」两行会显示同一个键。玩家必须手动改其中一个, 否则两个动作同时响应同一个物理按键。

这不像是有意的「双绑定同一键」设计——若是,两个 KeyBinding 应共用同一个配置 ID, 由注册方自行分发。实际是两个独立 KeyBinding 各自持有 G。

未绑定的两个键位

OPEN_SCENE_EDITOR_KEY(场景编辑器)与 CYCLE_REGION_WAND_MODE_KEY(区域导出魔棒模式) 默认是 Keyboard.KEY_NONE,即在控制台里显示为「未绑定」,默认不生效。 两者属于高级 / 调试向功能,需要玩家自行绑定。

区域导出魔棒与 网络协议 里的 GuideNhRegionExport* 封包、/guidenh importstructure 指令同属「结构导出」这条链路, 详见 结构导出。

相关条目

  • 指令 - /guide open 是不按键的等价入口
  • 指南框架 - 打开指南后走什么流程
  • ModConfig - 调试叠加层的开关与显示项