指南书

alaindustrial:guide_book

实用方块已实现guide-booktutorialonboardingdocumentationutility

概览

指南书——Ala Industrial 模组的游戏内教程。新玩家进入世界时面对的是非平凡的机制 （EU/FE 而非 FE、LV/MV/HV 电压等级、带损耗的电缆、机器的端口朝向），在没有内置教程的情况 下只能猜测或阅读外部 wiki。指南书降低了入门门槛：玩家在首次进入世界时自动获得此书 （恰好一次），右键打开——全屏窗口，带标签页和分页导航——按章节一步步走到第一个能 用的能源网络和机器，全程无需离开游戏。

指南书不需要能量，机械上不「做」任何事——纯粹是阅读材料。其内容来自与模组 wiki 站点 相同的数据源，因此书中的数值不会与游戏脱节。

示例： 进入新世界 → 物品栏里有一本「指南书」 → 右键 → 打开带「从何开始」标签页的 屏幕 → 点击「太阳能板」链接 → 阅读它产生多少 EU/FE 以及如何合成。

如何获得

• 首次进入时自动发放。 玩家首次进入世界时，书会被放入物品栏恰好一次。「已发放给 谁」的标志存储在世界级存档（含多个 UUID 的 SavedData）中——经历死亡/重生/跨维度 都不会丢失，重复进入也不会重复发放。
• 模组更新后的现有玩家也会收到一次：他们的 UUID 尚不在「已发放」集合中 → 更新后首次 进入时书会被发放，UUID 也会被加入。
• 丢失时恢复——两道保险，且都不影响自动发放：
  • 合成（便宜，LV 即可，无需蓝图门槛）；
  • /alaindustrial guide 命令（复用现有的 /ala 命令；发放/打开书）。玩家永远不会 缺少教程。
• 如果自动发放时物品栏已满——书会掉落在玩家脚下（不会丢失）。

界面

右键打开——全屏窗口（不是箱子：没有槽位、没有物品栏）。由以下部分组成：

• 标签页（顶层章节）位于左侧/顶部——复刻 wiki 站点的分类分组，加上一个引导性的 新手章节：
  1. 从何开始（Getting Started）——手动新手引导：第一台发电机 → 第一根电缆 → 第一台 机器；
  2. 能量——什么是 EU/FE、LV/MV/HV 等级、电缆与距离损耗、端口朝向；
  3. 发电机，4. 机器，5. 储能，6. 能量传输，
  4. 材料，8. 物品与工具，9. 组件，10. 实用。
• 标签内的条目列表（每个方块/物品/机制一条），可滚动。
• 条目页面——跨页排版，带分页导航（前进/后退箭头）和返回列表的「返回」按钮。
• 文本中的可点击链接——跳转到另一条目（v1.1 起支持跳到条目内的锚点）。
• 页面上的配方小部件——合成/加工网格（绘制原料和产物；不依赖 JEI/REI 即可工作）。
• 文本按行换行，长列表可滚动。

视觉上，指南书沿用模组的风格——与其余界面相同的配色和面板斜面。

内容

• 书涵盖游戏中已有的所有方块和物品：每个都有简短描述、属性（等级、EU/FE、缓存）和合成配方。
• 书中的数值（EU/FE、等级、缓存、配方）来自与模组 wiki 站点相同的数据源，因此永远与游戏 一致——不会出现偏差。
• 尚未添加或仅计划中的方块不会进入书中：它不会承诺尚未存在的内容。
• 外围章节「从何开始」和「能量」作为面向新手的基础教程撰写。

方块属性

指南书是物品（非方块）：不会放置到世界中，堆叠上限为 1，没有 EU/FE 缓存。「形状」就是 普通物品的平面图标。右键打开 GUI（见「界面」）；世界中不会放置任何方块，没有碰撞箱。

配方

合成非常简单，无形状：原版书 + 木质齿轮（模组中最早最廉价的组件）。没有蓝图门槛 （书反正会自动发放；合成仅用于丢失后恢复）。

进阶

• 等级：无（实用工具，不参与能量链）。即时可用——这是进入进度的入口，而不是进度的一阶。 它引导玩家沿模组真正的进度推进（矿石 → 发电机 → 电缆 → 机器 → 等级）。

本地化

• v1：en_us + ru_ru——完整的章节内容（来源是 en_us，与整个模组一致）。
• 其余语言（生成的 en_us 与 ru_ru 除外）由翻译映射组装（build_book_locale.py apply）：章节内容已完整翻译，本书存在于模组的全部语言中。
• 书中所有文本都走 lang 键；没有硬编码字符串（项目规则）。

相关内容

• 指南书由与模组 wiki 站点相同的数据源生成：相同的内容和相同的数值，但就在玩家手中。

合成

无序合成

▶

指南书