入门指南 (Guide Book)
基本信息
| 属性 | 值 |
|---|---|
| 注册名 | betterquesting:guide_book |
| 类 | betterquesting.items.ItemGuideBook |
| 注册位置 | GameRegistry.registerItem(guideBook, "guide_book")(BetterQuesting.java:102) |
| 贴图 | 复用原版书写书 book_written(setTextureName("book_written"),ItemGuideBook.java:15) |
| 中文名 | item.betterquesting.guide.name=入门指南 |
| GUI ID | 1 → betterquesting.client.gui2.GuiQuestHelp(handlers/GuiHandler.java:32-33) |
| 附魔光环 | 恒为 true(hasEffect,ItemGuideBook.java:42-45) |
功能
入门指南是内置帮助手册物品,右键直接打开 BetterQuesting 自己的说明界面(GUI ID 1)。它不占背包中的功能位以外的空间,也没有任何合成配方 —— 属于开发/调试期留在正式包里的便利物品:整合包作者把它发给测试玩家,玩家就能在不查网页的情况下看到模组自带的操作说明。
它的存在主要是「模组自带文档」的载体:GuiQuestHelp 内部的内容由 lang 文件驱动(见 语言文件)。若整合包删掉该物品,玩家就只能靠任务界面自身的按钮发现问题。
guideBook 字段在 BetterQuesting 类中静态构造(BetterQuesting.java:71),在 init 阶段注册(BetterQuesting.java:102),并被放入 BetterQuesting.tabQuesting 创造标签(ItemGuideBook.java:17)。
数值
| 数值名 | 值 |
|---|---|
| GUI ID | 1 |
| 堆叠上限 | 未覆写 getItemStackLimit,沿用 Item 默认 64 |
| 最大耐久 | 未覆写,无耐久 |
| 合成配方 | 无(BetterQuesting.java:96-156 的全部 addShapelessRecipe 中没有 guideBook) |
交互
| 触发 | 行为 |
|---|---|
| 右键 | 仅客户端执行 player.openGui(BetterQuesting.instance, 1, world, 0, 0, 0)(ItemGuideBook.java:33-38),由 GuiHandler.getClientGuiElement 的 ID == 1 分支接住 |
| 服务端右键 | 无对应处理 —— GuiHandler.getServerGuiElement 没有 ID == 1 分支(handlers/GuiHandler.java:16-24),因为该界面不需要容器 |
左键放置(onItemUse) |
恒返回 true,无放置行为(ItemGuideBook.java:24-27) |
| 附魔外观 | hasEffect 恒 true,故始终带附魔书的光效 |
语言文件
物品名 key 为 item.betterquesting.guide.name;帮助界面正文使用 betterquesting.gui.* 前缀的 key。assets/betterquesting/lang/ 下提供 en_US.lang、zh_CN.lang、ru_RU.lang 三个语言文件(en_US.lang 共 353 行)。