events.json（イベント一覧）

events.json は「このMODにどんなイベントがあるか」を列挙するファイルです。ここにイベント（通常イベント）とエンディング（31日目の結果イベント）を登録し、実際の中身は script_file で events/*.json に分けて書きます。

ページ概要

• 対象ファイル: events.json
• 役割: イベント/エンディングの「一覧メタデータ」を定義します（タイトル、条件、優先度、スクリプトファイルの場所など）。
• どこで使われるか: イベント発火判定（required_conditions）、イベント一覧の読み込み、エンディング選出（31日目）
• 最小構成: このページの「最小構成（コピペ用）」
• よくあるミス: ID不一致（EVENT_ID_MISMATCH/ENDING_ID_MISMATCH）、script_file の書き間違い、条件JSONの型違い（day は配列）

最小構成（コピペ用）

まずは「イベント1つ＋エンディング1つ」だけで動く形を作り、増やしていくのが安全です。

{
  "events": [
    {
      "id": "hello_event",
      "title_ja": "はじめての会話",
      "title_en": "First Talk",
      "description_ja": "",
      "description_en": "",
      "type": "story",
      "required_conditions": {
        "day": [{"operator": ">=", "value": 1}],
        "time": ["morning"],
        "locations": ["school_classroom"]
      },
      "script_file": "events/hello_event.json",
      "once_only": true,
      "priority": 10
    }
  ],
  "endings": [
    {
      "id": "ending_normal",
      "title_ja": "いつもの日常",
      "title_en": "As Usual",
      "description_ja": "",
      "description_en": "",
      "type": "normal",
      "required_conditions": {},
      "script_file": "events/endings/ending_normal.json",
      "priority": 0
    }
  ]
}

events（通常イベント）

events は「平常時に発生するイベント」を並べます（会話、デート、ランダムイベントなど）。

イベント定義のフィールド

endings（エンディング）

endings は「31日目に評価として再生されるイベント」を並べます。基本的には、条件を満たしたものの中から priority の高いものが選ばれ、キャラクターごとに1つ再生されます。

エンディングの設計（分岐の作り方、優先度の考え方）は エンディングの作り方 を参照してください。

エンディング定義のフィールド

よくあるミス

• ID不一致: events.json の id と、スクリプトの event_id が違う（EVENT_ID_MISMATCH）
• script_file が存在しない: パスの書き間違い、フォルダ名の揺れ（MISSING_EVENT_SCRIPT/MISSING_ENDING_SCRIPT）
• 条件JSONの型が違う: day は [{...}] の配列。stats は { "affection": { ... } } のマップ
• once_only を忘れる: 同じ会話が何度も出てしまう（意図通りならOK）

関連ドキュメント

• イベントスクリプト（events/*.json）
• イベント発生条件（required_conditions）
• 特殊イベントの書き方
• エンディングの作り方
• 検証（バリデーション）ガイド
• 検証コード一覧