02. 環境とフォルダ

開発時に触る場所

編集するのは、lumina.exe の隣にある GameData\data0 フォルダです。
エンジンの開発環境では、build\win\bin\Release\GameData\data0 がその場所です。

キャプチャ差し替え images/02_folder_map.png

エクスプローラーで lumina.exe の隣の GameData と data0〜data8 を表示した画面

lumina.exe と同じフォルダ
├── lumina.exe
├── DLL\                    ← Windows 用のプラグイン（使うときに自動で読み込みます）
├── GameData\
│   └── data0\ … data8\     ← 編集する場所
└── SaveData\               ← 遊ぶと作られるセーブ（配布物には入りません）

Release と Debug の GameData

開発環境の build\win\bin\Release と build\win\bin\Debug には、GameData がそれぞれ別にあります。中の system\Config.txt の設定も違います。

直した GameData と、起動した lumina.exe が同じフォルダか、いつも確かめてください。

実行モード（Debug／Release）

実行モードは、起動時に次の順で決まります（system\RunMode.txt）。

1. 環境変数 LUMINA_RUNMODE が 1 なら Debug、0 なら Release
2. data0\system\DevMode.txt があれば Debug（開発中の目印）
3. どちらも無ければ Release（配布物はこれ）

対応プラットフォームと共有関係

data0〜data8 の役割（現行 Config）

system\Config.txt の System.setFolder(...) でフォルダが割り当てられています。

data0 の中身

素材の呼び方と拡張子

シナリオから素材を呼ぶときは、フォルダを書かずにファイル名（拡張子なし）だけを書きます。

bg 0 bg01a

拡張子は Config.txt の System.setExtension(...) で決まります。

シナリオファイルの置き場所

キャプチャ差し替え images/02_scenario_folder.png

GameData\data0\scenario 内の feature_demo.txt など

GameData\data0\scenario\
├── feature_demo.txt     ← 紹介デモ（学習用に最適）
├── feature_demo.lsf     ← 暗号化版（配布用）
└── my_first.txt         ← あなたのシナリオ

• 開発中は .txt を編集します。Release の GameData なら、保存してゲームを再起動すれば反映されます。
• 配布物には .txt が入りません。配布前に ScriptEncryptor で .lsf を必ず作ります（下の「配布前」）。

起動から本編までの流れ

キャプチャ差し替え（任意） images/02_startup_flow.png

無くても下の図で説明できます

• Windows では、最初に「起動設定」のダイアログが出ます。OK でゲームが始まり、キャンセルで終了します。
• タイトルの「はじめから」を押すと、System.loadScenario でシナリオが始まります。自分のシナリオを試すときは、この読込パスを差し替えます（03章）。
• シナリオが end に来るか、最後の行まで進むと、自動でタイトルへ戻ります。
• Windows では lumina.exe --start-scenario=scenario/my_first で、ロゴとタイトルを飛ばして直接始められます。

開発中の .txt と配布前の .lsf（重要）

開発中（.txt）

1. Release の GameData で .txt を編集して保存します。
2. ゲームを再起動して確認します。

• シナリオ: Release は .txt を先に読むので、そのまま反映されます。
• システムスクリプト: Windows では .txt と .lsf の新しいほうが読まれます。保存すれば .txt が新しくなります。
• マクロ: 同じ名前の .lsf があると、そちらが読まれます。マクロの .txt を直したら、.lsf も作り直してください。
• Debug の GameData はシナリオも .lsf を先に読みます。古い .lsf が読まれるので、ふだんの確認は Release で行ってください。

配布前（.lsf）

ScriptEncryptor で .lsf を作ります。x.txt から、同じフォルダに x.lsf ができます。

ツールの場所（開発環境）: Tool\01_Development\build\bin\x64\Release\ScriptEncryptor.exe

ScriptEncryptor.exe -e -p "(Config.txt の setScriptPassword の文字列)" --ext txt "…\data0\scenario\my_first.txt"
ScriptEncryptor.exe -e --default-key --ext txt "…\data0\system\Config.txt"

• シナリオ・システムスクリプト・マクロは、作品のパスワード（-p）で暗号化します。
• Config.txt だけは --default-key で暗号化します。パスワードが Config の中に書いてあるので、Config 自身は既定の鍵でしか開けないためです。
• 既定の鍵で作った .lsf もエンジンは読めますが、作品のパスワードでは守られません。

配布時の暗号化・パックの位置づけは 公式マニュアル 第5章・第3章 も参照してください。

ビルド出力のイメージ

Android／ブラウザへの流れ

1. GameData を編集し、配布前と同じく .lsf を作ります。
2. Windows の Release をビルドします（build-win.ps1）。build\win\bin\master\Release が作り直されます。
3. build-pack-data.ps1 で .laf パックを作ります。ブラウザ用も作るときは -Targets android,web を付けます。
4. build-android.ps1 または build-web.ps1 でビルドします。

パックを作り直さない限り、Android とブラウザには編集が反映されません。

ゲームの起動確認

どのプラットフォームでも、編集したデータが実際に読み込まれているかを確認してください。特に Windows の Release／Debug の GameData、ブラウザ用 build\web\bin\GameData、Android APK 内のアセットは混同しやすいです。

まずは確認してほしいこと

1. lumina.exe の隣の GameData\data0\scenario\feature_demo.txt が開くこと
2. タイトルの「はじめから」で紹介デモが再生できること
3. 編集したら、起動した exe の隣の GameData を直したか（Release／Debug は別）を確認すること
4. プラットフォーム差が気になる箇所は、最終的に Windows だけでなく Android / ブラウザでも確認すること

Copyright (C) ALC Software Laboratory. All Rights Reserved.