键位
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 指令同属「结构导出」这条链路,
详见 结构导出。