03. 最初のシナリオ

最短で「背景・立ち絵・台詞・選択肢」まで通します。

手順概要

1. lumina.exe の隣の GameData\data0\scenario\ に、my_first.txt を新しく作ります（開発環境では build\win\bin\Release\GameData\data0\scenario\）。
2. 下のサンプルを貼り、UTF-8 で保存します。
3. タイトルの「はじめから」で開くように、title_enhanced.txt の 1 行を書き換えます（下の「タイトルから開く」）。
4. lumina.exe を起動し、クリックで進むことを確かめます。

サンプルが動くための最小素材

サンプルは、エンジンに入っている次の素材を使います。

立ち絵は、フォルダを書かずに表情の名前だけで見つかります。キャラのフォルダ（ch01 など）が system\SoundInit.txt の表に登録してあるためです。
自分の素材に替えるときは、まず feature_demo が動くか試すと、素材名の参考になります。

サンプル：最短の1シーン

キャプチャ差し替え images/03_editor_my_first.png

エディタで my_first.txt を開いている画面

文章の行は、行頭にタブを 1 つ入れます。

// my_first.txt — はじめてのシナリオ

*start

msgshow
bg 0 bg01a

name "ナレーション"
	物語が始まります。

chara_show 0 smile center 30 sync

name "ヒロイン"
	こんにちは。LUMINA のシナリオへようこそ。

name ""
choice "話す" *talk "黙る" *silent

*talk
chara_change 0 trouble 15
name "ヒロイン"
	ありがとうございます。では続きをどうぞ。
jump *ending

*silent
name "ナレーション"
	……静かな時間が流れた。
jump *ending

*ending
chara_hide 0 30 sync
name ""
	おしまいです。
fadeout 1000
end

キャプチャ差し替え images/03_game_message.png

ゲーム実行中・メッセージと立ち絵が表示された画面

キャプチャ差し替え images/03_game_choice.png

choice 命令で選択肢が出ている画面

何をしているか（行の意味）

メッセージの書き方

推奨: 行頭タブ

	こんにちは。

• 行頭にタブを入れた行が、画面の文章になります。文章は行頭タブにそろえましょう。
• タブの無い日本語の行も文章として表示されますが、英数字だけの行は命令として読まれ、エラーになります。
• 命令の行（bg や jump など）は、行頭から書きます。
• 行頭タブの行でも、最初の語が命令名（wait や name など）だと命令として扱われます。英語の文章で困るときは message "…" で書きます。

タイトルから開く（具体手順）

スタートボタンの動作は、同じ GameData\data0 の system\title_enhanced.txt にあります。228 行目付近の読込行を書き換えます。

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

title_enhanced.txt の loadScenario 部分など

変更箇所（RegisterButtonActions 内・title.start）:

// 変更前（228 行目付近）
        "System.loadScenario(\"scenario/feature_demo\");\n" +

// 変更後
        "System.loadScenario(\"scenario/my_first\");\n" +

• この行は文字列の中に書かれています。\" や \n はそのまま残し、feature_demo の部分だけを書き換えます。
• 保存してゲームを再起動すれば反映されます（Windows では .txt と .lsf の新しいほうが読まれます）。
• 配布前に、title_enhanced.lsf も作り直します（02章）。

動作確認チェックリスト

.txt と .lsf の扱いは 02章、タイトル接続の詳細は 08章 を参照してください。

タイトルから開く（API 参照）

システムスクリプト側で使う API は次のとおりです。

System.loadScenario("scenario/my_first");

• 拡張子は書かなくて構いません（Config の設定で決まります）。
• System.loadScenario は、前に遊んだ回の変数を空にしてから始めます。
• Scenario.load("scenario/my_first") でも読み込めますが、変数を空にしません。「はじめから」には System.loadScenario を使います。

エラーの見つけ方

開発環境の GameData は Debug 実行モードで起動するので、lumina.exe の隣に lumina_debug.log ができます。

• シナリオの書き間違いは「構文エラー」として、行番号つきで出ます。
• シナリオが見つからないときは「ファイルが見つかりません」と出ます。

うまく動かないとき

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