例：好感度とマルチエンディング

この例では、Skeleton（スケルトン）テンプレートで作成したプロジェクトに好感度の仕組みを実装します。

• 選択肢でセーブ変数 好感度 を増やします。
• 会話ボックスの右側に 好感度 の現在の値を表示します。
• 好感度 が 20 以上のとき、追加の分岐が再生されます。
• ストーリーは 好感度 と 正直 に応じて 3 つのエンディングのいずれかで終わります。
• タイトルページに到達したエンディングの数を表示します。

準備

Skeleton（スケルトン）テンプレートで新しいプロジェクトを作成します。手順ははじめにを参照してください。スケルトンには「廊下」「部室」「最後の光」の 3 つのシーンがあります。「部室」のメニューは選択をセーブ変数 正直 に書き込み、「最後の光」は 正直 に応じて異なる台詞を表示し、エンディング「明日も同じ時間」で終わります。

以下の手順では、変数を宣言し、3 つのシーンを順に変更したあと、ゲーム UI「会話」とページ「タイトル」を変更します。

1. 変数を宣言する

右サイドバーで Variables（変数）を開き、Saved variables（セーブ変数）の Add（追加）をクリックします。新しい変数の名前を 好感度 にし、型を Number（数値）にして、既定値は 0 のままにします。

セーブ変数はプロジェクト全体に属し、すべてのシーンとブループリントから読み書きできます。値はセーブに書き込まれ、ロード時に復元され、新しいゲームを始めると既定値に戻ります。ほかのスコープについては変数を参照してください。

2. 選択肢で好感度を変更する

/inc 好感度 20 と入力して Enter を押すと、行は inc 好感度 20（日本語のインターフェースでは 増加 好感度 20）と表示されます。数値を省略すると /inc は 1 を加算します。/dec は値を減らします。/set 好感度 好感度 + 20 は /inc 好感度 20 と同じ結果になります。

3. 会話ボックスに好感度を表示する

ブループリント値が読み取るセーブ変数に書き込みがあるたびに、テキストは再評価されます。/inc の実行時、ロード時、新しいゲームの開始時に、会話ボックスの値が更新されます。

4. 好感度で分岐する

「最後の光」で、正直 の条件のあと、Narra の台詞「明日も同じ時間。遅れないで。」の前に行を追加し、/if 好感度 >= 20 と入力して Enter を押します。If の下に次を追加します。

• Narra：「帰り、駅まで一緒に歩く？」
• メニュー。選択肢「うん。」の中に Narra：「じゃあ、行こう。」と /inc 好感度 15、選択肢「今日はやめておく。」の中に Narra：「わかった。また今度。」

好感度 が 20 未満のときは分岐全体が飛ばされます。この条件には Else（それ以外）がないため、ストーリーは次の行に進みます。

/if の条件は式で、比較演算と &&、||、! を使えます。プロパティパネルで条件を Variable（変数）に切り替え、ドロップダウンで変数と比較方法を選ぶこともできます。

5. 3 つのエンディング

「最後の光」の末尾にある 2 行のナレーションとエンディング「明日も同じ時間」を削除します。シーンの末尾で /if 好感度 >= 35 && 正直 と入力して Enter を押し、条件の行で Else if（そうでなくもし）と Else（それ以外）をクリックして、残り 2 つの分岐を追加します。

/ending はその行でストーリーを終了し、プレイヤーが到達したエンディングを記録します。

6. エンディングのあとタイトルページに戻る

Project（プロジェクト）→ App（アプリ）を開き、Build variants（ビルドバリアント）で main を展開して、Page shown when the story ends（ストーリーが終わったときに出すページ）を「タイトル」にします。ストーリーがエンディングの行で終わったあと、このページが表示されます。個別のエンディングの行には、プロパティパネルの Page shown afterwards（終了後に表示するページ）で別のページを指定できます。

7. タイトルページに到達したエンディングを表示する

プレイヤーが到達したエンディングはセーブの外に記録されます。ロード、新しいゲームの開始、ゲームの再起動では消えません。

ページ「タイトル」を開き、タイトル区切り線の下に Text（テキスト）を追加して名前を エンディング にします。Text を Blueprint Value（ブループリント値）に切り替えて開きます。

Get Endings（エンディング一覧を取得）を追加し、Story（ストーリー）を スケルトン にします。Endings（エンディング一覧）出力の型は Ending list（エンディングのリスト）です。Endings からワイヤーを引き出してキャンバスの空いた場所で離すと、ノード追加メニューが Fields（フィールド）のグループで開き、エンディングの各フィールドでできる操作が並びます。Filter by isReached（isReached で絞り込み）を選ぶと、Studio は Key（キー）が isReached、Value（値）が True の Array Filter By Key（配列をキーで絞り込み）を追加し、Endings をその Array（配列）に接続します。

残りのノードを追加し、次のように接続します。

Get Endings はストーリー内のすべてのエンディングの行を列挙します。各エンディングの isReached フィールドは、プレイヤーがそのエンディングに到達したかどうかを示します。1 つ目の Get Endings は到達したエンディングを絞り込み、2 つ目はすべてのエンディングを数えます。同じ Endings 出力から 2 本目のワイヤーを引くと 1 本目が置き換わるため、それぞれの数に Get Endings を 1 つずつ使います。エンディングのフィールドと、それを読み取るほかのノードは構造体にまとめてあります。

テンプレートはグラフ内に書いた文字で、ゲームの言語では切り替わりません。プロジェクトに複数の言語があるときは、Translation Key Text でテンプレートを渡します。

テスト

• F5 を押すと、プロジェクトが開発モードで実行されます。行の Play from this row（この行から再生）をクリックすると、その行から実行されます。
• 開発モード左下のデバッグボタン → Story（ストーリー）→ Variables（変数）に、セーブ変数の現在の値が表示され、その場で変更できます。好感度 を 40 にし、正直 をオンにしてから最後まで進めると、エンディング「一緒に文化祭」を確認できます。
• 開発モードボタンの横の矢印 → Reset player data（プレイヤーデータをリセット）→ Dev Mode（開発モード）で、開発モードのすべてのセーブとエンディングの記録が消去されます。タイトルページは 到達したエンディング 0 / 3 に戻ります。
• Story（ストーリー）パネルで Open Scene Flow（シーンフローを開く）をクリックし、変数の一覧で 好感度 を選びます。各シーンに到達時の 好感度 の範囲が表示され、Show branches（枝を表示）で選択肢ごとの増減量と、エンディングで終わる分岐が表示されます。
• 条件の基準値がどのルートでも到達できない値のとき、Problems（問題）パネルが Condition no path can satisfy（成立し得ない条件）を報告し、その位置での 好感度 の範囲を示します。

関連ページ

• 永続変数はセーブに保存されず、すべてのセーブと起動をまたいで保持されます。永続変数を参照してください。
• ノードのリファレンス：変数のノード、Game のノード、Data のノード。