ロジック » スタック
July 18, 2026

スタック

作業中

このドキュメントはまだ拡張・修正中です。機能、スクリーンショット、説明はTalescapeの公開リリースまで変更される可能性があります。わかりにくい点や助けが必要な場合は、公式Talescape Discordで質問してください。必要に応じてページを明確化したり更新したりします。

スタックは、関連するコンテンツをまとめた再利用可能なプールです。アクション内で単一の固定アイテムや会話、シーンを選ぶ代わりに、スタックを作成してプレイヤーがプレイ中にそのエントリーのひとつを受け取ったり入ったりできるようにします。

同じリストを複数のアクションに重複して作ることなく結果を変化させたい場合にスタックは便利です。ランダム報酬、入れ替わる会話、再利用できるシーン選択、任意の詳細シーンなどに使えます。

1. スタックの種類

1. スタックの種類

スタックは含まれるコンテンツの種類に紐づきます:

  • アイテムスタック: 一度にまとめて付与できる、またはランダムに選ばれるアイテム群。
  • ダイアログスタック: その中からランダムに1つ開始される会話の群。
  • 通常シーンスタック: ランダムなシーン遷移に使う通常シーンの集合。
  • 詳細シーンスタック: ランダムなオーバーレイや任意のクローズアップ操作に使う詳細シーンの集合。

スタックは用途ごとに分けて使おう。例えば、宝の報酬用スタックは、同じシーンで使われる場合でも酒場の会話候補のスタックとは別にしておくべきです。

2. アイテムスタック

アイテムスタックは2通りの使い方があります:

  • ランダムアイテム: 選択したアイテムスタックから1つ以上のランダムなアイテムをプレイヤーのインベントリに追加します。
  • アイテムスタックをインベントリに追加: 選択したアイテムスタック内のすべてのアイテムをプレイヤーのインベントリに追加します。

ランダムアイテムスタックは戦利品表、ミステリー報酬、変動する補給などに適しています。スタック内全アイテムを与える報酬はスターターキット、装備バンドル、章の設定に向いています。

3. ダイアログスタック

ダイアログスタックは、アクションが選択したプールからランダムな会話を開始できるようにします。

常に同じ台詞になってほしくない繰り返しのやり取り、例えば周囲のキャラクターの一言、噂、仲間の掛け合い、調べたときの反応などに便利です。個々の会話は、それぞれの行、選択肢、条件、アクションを含め、通常のダイアログエディターで作成します。

4. シーンスタック

シーンスタックは通常シーンにも詳細シーンにも使えます:

  • ランダムなシーンに移動: 選択したスタック内の通常シーンの中からランダムでプレイヤーを移動させます。
  • ランダムな詳細シーンを開く: 選択したスタック内の詳細シーンをランダムで開きます。

通常シーンスタックはランダムな移動、部屋選択、反復可能な探索に便利です。詳細シーンスタックは任意のオーバーレイ、クローズアップ、小さな発見、現在のシーンに戻る短いバリエーションに役立ちます。

5. 一度だけ

ランダムスタックのアクションは一度だけを有効にできます。有効にすると、そのスタック内の各エントリーはプレイ中に1回だけ選ばれます。以前に選ばれたエントリーは記憶され、スタックが使われなくなるかプレイの状態がリセットされるまで同じ結果は繰り返されません。

固有の報酬、1回限りの噂、時間をかけて尽きるべき発見のセットなど、繰り返されると不自然に感じる場合にこれを使ってください。一般的な戦利品や繰り返しの雰囲気のように繰り返しが許容される場合は無効のままにしておきます。

6. ベストプラクティス

  • 用途がわかる名前にする。例:森の戦利品酒場の噂ランダムクローズアップ
  • スタックのエントリーは、それを消費するアクションと互換性があるように保つ。
  • 特定のストーリー状態で利用可能な結果が限られる場合は、アクションや出力コンテンツに条件を使う。
  • スタックアクションはストーリープレビューでテストし、デバッグメニューを使ってインベントリ、変数、イベントの流れを確認する。

スタックはプールが一箇所にまとまっているため、アクションがその使い方を決めることで再利用可能かつランダムなコンテンツの管理が簡単になります。

ドキュメント