指南书
alaindustrial:guide_book
概览
指南书——Ala Industrial 模组的游戏内教程。新玩家进入世界时面对的是非平凡的机制 （EU/FE 而非 FE、LV/MV/HV 电压等级、带损耗的电缆、机器的端口朝向），在没有内置教程的情况 下只能猜测或阅读外部 wiki。指南书降低了入门门槛：玩家在首次进入世界时自动获得此书 （恰好一次），右键打开——全屏窗口，带标签页和分页导航——按章节一步步走到第一个能 用的能源网络和机器，全程无需离开游戏。
指南书不需要能量，机械上不「做」任何事——纯粹是阅读材料。其内容来自与模组 wiki 站点 相同的数据源，因此书中的数值不会与游戏脱节。
示例： 进入新世界 → 物品栏里有一本「指南书」 → 右键 → 打开带「从何开始」标签页的 屏幕 → 点击「太阳能板」链接 → 阅读它产生多少 EU/FE 以及如何合成。
如何获得
首次进入时自动发放。 玩家首次进入世界时，书会被放入物品栏恰好一次。「已发放给 谁」的标志存储在世界级存档（含多个 UUID 的 SavedData）中——经历死亡/重生/跨维度 都不会丢失，重复进入也不会重复发放。 模组更新后的现有玩家也会收到一次：他们的 UUID 尚不在「已发放」集合中 → 更新后首次 进入时书会被发放，UUID 也会被加入。 丢失时恢复——两道保险，且都不影响自动发放： 合成（便宜，LV 即可，无需蓝图门槛）； /alaindustrial guide 命令（复用现有的 /ala 命令；发放/打开书）。玩家永远不会 缺少教程。 如果自动发放时物品栏已满——书会掉落在玩家脚下（不会丢失）。
界面
右键打开——全屏窗口（不是箱子：没有槽位、没有物品栏）。由以下部分组成：
标签页（顶层章节）位于左侧/顶部——复刻 wiki 站点的分类分组，加上一个引导性的 新手章节：
- 从何开始（Getting Started）——手动新手引导：第一台发电机 → 第一根电缆 → 第一台
机器；
- 能量——什么是 EU/FE、LV/MV/HV 等级、电缆与距离损耗、端口朝向；
- 发电机，4. 机器，5. 储能，6. 能量传输，
- 材料，8. 物品与工具，9. 组件，10. 实用。
标签内的条目列表（每个方块/物品/机制一条），可滚动。 条目页面——跨页排版，带分页导航（前进/后退箭头）和返回列表的「返回」按钮。 文本中的可点击链接——跳转到另一条目（v1.1 起支持跳到条目内的锚点）。 页面上的配方小部件——合成/加工网格（绘制原料和产物；不依赖 JEI/REI 即可工作）。 文本按行换行，长列表可滚动。
视觉上，指南书沿用模组的风格——与其余界面相同的配色和面板斜面。
内容
书涵盖游戏中已有的所有方块和物品：每个都有简短描述、属性（等级、EU/FE、缓存）和合成配方。 书中的数值（EU/FE、等级、缓存、配方）来自与模组 wiki 站点相同的数据源，因此永远与游戏 一致——不会出现偏差。 尚未添加或仅计划中的方块不会进入书中：它不会承诺尚未存在的内容。 外围章节「从何开始」和「能量」作为面向新手的基础教程撰写。
方块属性
指南书是物品（非方块）：不会放置到世界中，堆叠上限为 1，没有 EU/FE 缓存。「形状」就是 普通物品的平面图标。右键打开 GUI（见「界面」）；世界中不会放置任何方块，没有碰撞箱。
| 字段 | 数值 |
|---|---|
| 类型 | 物品（item），非方块 |
| 堆叠 | 1 |
| EU/FE 缓存 | 无 |
| 右键 | 打开指南书屏幕（client-side） |
| 世界放置 | 无 |
配方
合成非常简单，无形状：原版书 + 木质齿轮（模组中最早最廉价的组件）。没有蓝图门槛 （书反正会自动发放；合成仅用于丢失后恢复）。
进阶
等级：无（实用工具，不参与能量链）。即时可用——这是进入进度的入口，而不是进度的一阶。 它引导玩家沿模组真正的进度推进（矿石 → 发电机 → 电缆 → 机器 → 等级）。
本地化
v1：en_us + ru_ru——完整的章节内容（来源是 en_us，与整个模组一致）。 其余语言（生成的 en_us 与 ru_ru 除外）由翻译映射组装（build_book_locale.py apply）：章节内容已完整翻译，本书存在于模组的全部语言中。 书中所有文本都走 lang 键；没有硬编码字符串（项目规则）。
相关内容
指南书由与模组 wiki 站点相同的数据源生成：相同的内容和相同的数值，但就在玩家手中。
合成
无序合成
▶
指南书