入门指南 (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 行)。

相关条目

  • 提交站 (OSS) - 同属核心 modid 的两个方块之一,物品之外的另一类注册内容
  • 任务通知 - 同样是 BetterQuesting 客户端表现层的内容,与本物品共用 betterquesting.gui.* 命名空间