シナリオ MOD

シナリオ MOD は原作のステージにイベントを追加します。何ターン目、誰かが撃墜されたとき、誰と誰が戦ったとき、「説得」を選んだとき……に、書いたセリフを流したり、人物を加入・退場させたり、シナリオ変数を変えて後の原作シナリオを別の分岐に進ませたりできます。いつ起こすかはゲームが判断するので、書くのは条件と内容だけで、原作のイベント表を知る必要はありません。原作のイベントが書き換えられたり押し出されたりすることはありません。

パッケージのインストールと管理は MOD パッケージ：導入と作り方 を見てください。バージョン 0.5.3 以降が必要です。

完全な例は「東方不敗 生存」で、ソースは config/recomp/mods/master-asia にあります。独立軍ルート「死闘!ランタオ島大決戦（後）」と OZ ルート「絶望と悲しみの拳（後）」で、戦闘中に東方不敗と言葉を交わしたドモンは東方不敗を説得でき、撃墜数 50 以上なら東方不敗は退いてステージクリア後に仲間になります。

パッケージの中身

yourname.story/
  mod.json
  story/
    <任意の名前>.json  シナリオスクリプト、いくつでも
  data/
    pilots.json        必要なら数値もあわせて変更（数値 MOD を参照）

パッケージ化（tools/mods/pack.py）のとき、story/ のシナリオスクリプトはゲームが読む形式にコンパイルされます。書き間違いはどのイベントのどの項目かが報告されます。

書き方

{
  "schema": "srw64.story.v1",
  "events": [
    {
      "id": "persuade",
      "scene": 129,
      "when": { "persuade": { "by": 4, "target": 18 } },
      "if": { "vars": { "131": 0 }, "kills": { "4": 50 } },
      "do": [
        { "say": 4, "text": { "ja": "「師匠！」", "zh-Hans": "“师父！”", "en": "“Master!”" } },
        { "say": 18, "mode": 2, "text": { "ja": "「……」", "zh-Hans": "“……”", "en": "“...”" } },
        { "leave": 18 },
        { "set": { "131": 3 } }
      ]
    },
    {
      "id": "joins",
      "scene": 129,
      "when": { "after": "end" },
      "if": { "fired": ["persuade"] },
      "do": [ { "join": { "pilot": 18, "unit": 27 } } ]
    }
  ]
}

イベントごとの項目：

各イベントは標準ではステージごとに 1 回だけ起こります。 ゲームが記録し、中断セーブにも残るので、原作のように変数を書いて再生の重複を防ぐ必要はありません。

人物番号と機体番号は数値 MOD の人物表と機体表にあります。

when：いつ

同じタイミングで原作のイベントも起こるときは原作のものが先で、こちらのイベントは次の確認のときに見られます。オープニング、初期配置、終了の後のイベントは repeat にできません。

if：ほかの条件

その人物が味方の名簿にいないときは、kills も kills_below も成り立ちません。

成功と失敗の 2 通りのセリフ：同じタイミングに条件が重ならない 2 つのイベントを書くと、ゲームは成り立つほうを選びます。例では撃墜数が足りれば成功、足りなければ断られるセリフが流れます：

{ "id": "persuade", "when": { "persuade": { "by": 4, "target": 18 } },
  "if": { "vars": { "131": 0 }, "kills": { "4": 50 }, "not_fired": ["refused"] }, "do": [] },
{ "id": "refused", "when": { "persuade": { "by": 4, "target": 18 } },
  "if": { "vars": { "131": 0 }, "kills_below": { "4": 50 } }, "do": [] }

断られるイベントは 1 回だけ起こり、成功のほうは not_fired: refused を条件にしているので、断られた後はそのステージでどちらも成り立たず、「説得」はコマンドから消えて、シナリオは原作どおりに進みます。何度でも試せるようにするなら、断られるほうに "repeat": true を書き、成功のほうの not_fired を外します。

ステージをまたぐ：フラグ

fired はそのステージの中だけで、次のステージでは消えます。後のステージに出来事を伝えるには、イベントに "set_flags": ["フラグ名"]（英小文字、数字、_、-、32 文字まで）を書くと、イベントが終わったときに立ちます。フラグはそのパッケージだけのもので、原作のシナリオ変数とは関係なく、中断セーブとインターミッションのセーブについていき、新しいゲームを始めたときだけ消えます。

{ "id": "persuade", "scene": 129, "set_flags": ["persuaded"], "when": { "persuade": { "by": 4, "target": 18 } }, "do": [] },
{ "id": "comes-along", "scene": 81, "when": { "after": "opening" },
  "if": { "roster": { "pilots": [18] }, "flags": ["persuaded"] },
  "do": [ { "say": 18, "text": { "ja": "「ドモン、遅れを取るでないぞ！」" } } ] }

名簿も見ているのは、その後に原作のシナリオやほかのイベントで名簿から外されることがあるからです。フラグだけでは、いなくなっても話してしまいます。

do：何をするか

セリフ：text には ja が必須で、書かなかった言語は日本語で表示されます（繁体字がなければ簡体字）。1 つ 200 文字までで、改ページはリーダーが自動で行うので <STOP> は書きません。かぎかっこは原作のセリフと同じく自分で書きます。日本語と繁体字は「」、簡体字と英語は “”。mode は原作の会話の表示方法で、マップでは味方 0、敵 2 が普通、ワールドマップでは 0 と 1 で上下を交互にします。

加入時のレベルは原作の決まりどおり、そのステージの基準レベル（味方上位 15 人の平均から計算）です。"level": {"offset": 3} で基準から増減し、"level": {"like": 4} で 4 番の人物と同じレベル（加入した時点）にします。SP、能力、技能、精神コマンドは原作がレベルから計算します。基本値を変えるなら data/pilots.json を使います（敵の人物は SP や精神コマンドが空のことが多く、例では SP を補っています）。

注意

• 原作のイベントは原作の変数しか見ません。 原作のあるイベントを流さない、または別の部分を流すには、それが判定に使う変数を変えます。例では説得の後に 131 = 3 とし、原作の終了イベントは 131 が 1 か 2 のときだけ東方不敗との死別を流します。
• ユニットの退場（leave）では原作の撃墜イベントは起こりません。 撃墜後に原作がすること（例ではウォンの登場と勝利条件の開放）は、自分のイベントでやり直す必要があります。
• 同じシナリオを別のステージに移す前に、そのステージの原作イベントを読んでください。会話でどの変数を使うか、撃墜の後に原作が何をするか、終了イベントがどの変数でどの部分を流すか。例の OZ ルートのイベントはシーン 137 の原作イベントに合わせて書き直したものです。
• フラグはセーブの横に保存されます（セーブフォルダー saves/ の中の story-state/）。セーブファイル自体には入っていません。セーブをほかのエミュレーターに持っていったりこのフォルダーを消したりするとフラグはなくなり、ステージをまたぐイベントは起こりません。1 つのステージの中のイベントには影響しません。
• 追加シナリオ（campaign/）のステージではシナリオ MOD は動きません。

確認とパッケージ化

python3 tools/mods/story.py compile story/master.json -o out.json

python3 tools/mods/pack.py yourname.story -o build/mods

1 つ目はシナリオスクリプト 1 つだけをコンパイルし、各イベントがどんな命令になるかを確かめられます。2 つ目はパッケージを作り、ゲームと同じ決まりで確認します。ゲームが読めないパッケージはログに SRW64_STORY_MOD_PROBLEM と出ます。

リポジトリの docs/guide/story-mods/ フォルダーに完全な形式の説明とシーン番号対照表があり、まるごと AI アシスタントに渡して、考えたシナリオをスクリプトに書いてもらえます。