クイックスタート（最小構成で動作確認）

このページは「とにかく最短で、MODを1つ作ってゲーム内で動くところまで」を目的にしています。

MODはどこに置く？

自作MODは、ドキュメントフォルダの以下に配置します。

Documents/LoveSystem/mods/

Windowsの例:

C:\Users\<あなたのユーザー名>\Documents\LoveSystem\mods\

最小構成（このまま作る）

まずは次の構成をそのまま作ってください。

my_first_mod/
├── mod.json
├── character.json
├── events.json
├── events/
│   └── first_meeting.json
└── portraits/
    └── spring/
        └── casual/
            └── normal.png

最重要（ここで詰まりやすい）

  • 必須立ち絵: portraits/spring/casual/normal.png は必須です
  • パス: JSONのファイルパスは「MODフォルダ内からの相対パス」で書きます（../ や / で始めない）

mod.json（メタデータ）

このまま貼り付けて、mod_id と名前だけ変えればOKです。

{
  "mod_version": "1.0.0",
  "mod_id": "my_first_mod",
  "mod_name": "はじめてのMOD",
  "mod_name_en": "My First Mod",
  "author": "Your Name",
  "description": "クイックスタート用の最小MODです。",
  "description_en": "A minimal mod for quick start.",
  "min_game_version": "0.1.0",
  "max_game_version": "0.1.999",
  "season_preference": "all",
  "supported_genders": ["male", "female"],
  "character_file": "character.json",
  "events_metadata_file": "events.json",
  "events_directory": "events"
}

character.json（キャラクター定義）

まずは「名前・性別・必須立ち絵・初期ステータス」だけ揃えます。

{
  "id": "my_char",
  "family_name_ja": "田中",
  "given_name_ja": "さくら",
  "family_name_en": "Tanaka",
  "given_name_en": "Sakura",
  "gender": "female",
  "age": 17,
  "description_ja": "クイックスタート用キャラクター。",
  "description_en": "A character for quick start.",
  "personality_tags_ja": ["明るい"],
  "personality_tags_en": ["Bright"],
  "hobby_ja": ["読書"],
  "hobby_en": ["Reading"],
  "favorite_things_ja": ["本"],
  "favorite_things_en": ["Books"],
  "dislike_things_ja": ["運動"],
  "dislike_things_en": ["Sports"],
  "relationship_type": {
    "male": "romance",
    "female": "friendship"
  },
  "target_player_gender": ["male"],
  "portraits": {
    "spring": {
      "casual": {
        "normal": "portraits/spring/casual/normal.png"
      }
    }
  },
  "initial_stats": {
    "male": {
      "affection": 0,
      "intimacy": 0,
      "relationship": "acquaintance"
    },
    "female": {
      "affection": 0,
      "intimacy": 0,
      "relationship": "acquaintance"
    }
  },
  "stat_ranges": {
    "affection": {"min": -100, "max": 100},
    "intimacy": {"min": -100, "max": 100}
  },
  "unlock_conditions": {
    "male": null,
    "female": null
  }
}

events.json（イベント一覧）

{
  "events": [
    {
      "id": "first_meeting",
      "title_ja": "初めての出会い",
      "title_en": "First Meeting",
      "description_ja": "最小構成のテストイベント",
      "description_en": "Minimal test event",
      "type": "story",
      "required_conditions": {
        "day": {"operator": "==", "value": 1}
      },
      "script_file": "events/first_meeting.json",
      "once_only": true,
      "priority": 100
    }
  ]
}

events/first_meeting.json（イベントスクリプト）

{
  "event_id": "first_meeting",
  "scenes": [
    {
      "scene_id": "s01",
      "type": "dialogue",
      "character": "player",
      "text_ja": "（今日はいい天気だ）",
      "text_en": "(It's a beautiful day.)"
    },
    {
      "scene_id": "s02",
      "type": "dialogue",
      "character": "my_char",
      "portrait": "casual.normal",
      "text_ja": "こんにちは！",
      "text_en": "Hello!"
    },
    {
      "scene_id": "s99",
      "type": "end"
    }
  ]
}

ゲーム内で確認

  1. Documents/LoveSystem/mods/ に my_first_mod/ を配置
  2. ゲームを起動
  3. 「設定」→「MOD管理」でMODが読み込まれているか確認
  4. ニューゲーム開始 → キャラクター選択で表示されるか確認

次に読む