ガイドブック

alaindustrial:guide_book

ユーティリティ実装済みguide-booktutorialonboardingdocumentationutility

概要

ガイドブックは Ala Industrial モッドのゲーム内チュートリアルです。新規プレイヤーは 非自明なメカニクス（FE の代わりの EU/FE、電圧ティア LV/MV/HV、損失のあるケーブル、機械の面ポート）の あるワールドに入り、組み込みのチュートリアルがないまま推測したり外部 wiki を読まされたりしてきました。 この本はその参入障壁を下げます。プレイヤーは 最初のワールド参加時に自動でインベントリに受け取り （1 回限り）、右クリックで開く — 全画面タブとページごとのナビゲーション付き — ことで、 ゲームを抜けることなく章を追って最初の稼働するエネルギーネットワークと機械に到達します。

本は エネルギーを消費せず、機械的に何も「しない」 — 純粋な読み物です。中身はモッドの wiki サイトと同じソースから作られているため、本の中の数値はゲームと食い違いません。

ミニ例： 新しいワールドに入る → インベントリに「ガイドブック」が入っている → 右クリック → 「ここから始める」タブが開いた画面 →「ソーラーパネル」のリンクをクリック → どれだけ EU/FE を 出力し、どうクラフトするかを読む。

入手方法

初回ログイン時の自動配付。 プレイヤーが初めてワールドに入る際、本がインベントリに ちょうど 1 回だけ 配られます。「すでに配った人」のフラグは ワールドごとのセーブデータ （複数 UUID を持つ SavedData）に保存され、死亡 / リスポーン / ディメンション変更を耐え、 再ログインでも重複配付されません。 モッド更新時の既存プレイヤー も 1 回だけ本を受け取ります。その UUID はまだ「配付済み」集合に ないため、更新後の初回ログインで本が配られ、UUID が追加されます。 紛失時の復元 — 2 つの保険があり、どちらも自動配付をブロックしません： クラフト（安価、LV で利用可能、設計図によるゲートなし）。 /alaindustrial guide コマンド（既存の /ala コマンドを再利用、本を配付/表示）。 プレイヤーがチュートリアルなしで取り残されることはありません。 自動配付時にインベントリが満杯なら — 本はプレイヤーの足元に落ちます（失われません）。

インターフェース

右クリックで開く — 全画面ウィンドウ（チェストではなく、スロットもインベントリもありません）。 構成は以下の通りです：

タブ（最上位の章） は左/上に — wiki サイトのカテゴリグループ分けに加え、先頭のオンボーディング セクションを再現します：

1. ここから始める（Getting Started） — 手動オンボーディング：最初の発電機 → 最初のケーブル →

最初の機械。

1. エネルギー — EU/FE とは、ティア LV/MV/HV、ケーブルと距離ごとの損失、面ポート。
2. 発電機、4. 機械、5. 貯蔵、6. エネルギー伝送、
3. 材料、8. アイテムとツール、9. コンポーネント、10. ユーティリティ。

タブ内の エントリー一覧（ブロック / アイテム / メカニクスごとに 1 つ）、スクロール付き。 エントリーページ — ページごとのナビゲーション（前/次の矢印）と一覧へ「戻る」ボタンを 持つ見開き。 本文内の クリック可能なリンク — 別のエントリーへ（そして 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 サイトと同じソースから作られています：同じ内容と同じ数値ですが、 プレイヤーの手の中に直接あります。

クラフト

不定形クラフト

▶

ガイドブック