mod_music_pack/docs/zh.md

Music Pack — 为你的游戏配乐

22 首曲目，覆盖探索、战斗和主菜单。在 cthangover 的各个游戏之间共用这套配乐，无需把音频复制进每个剧情模组。

玩家会听到什么

• 探索： 8 首曲目，供没有专属播放列表的场景使用，包括 RPG 地图。
• 战斗： Battle 播放列表中的 12 首曲目。备用战斗列表 default 还包含 Empty Save Room，合计 13 首。
• 主菜单： Serpent's Lament。

Music Pack 提供音频和播放列表，不添加地点、任务或玩法机制。

需要配置什么吗

如果你的游戏已经在用 Music Pack，就无需单独安装或挑选曲目。播放由 audio_base 系统负责。

主菜单、Cthangover、小说模板和项目的 RPG 游戏都在使用这个素材包。加载它不需要主游戏的剧情内容。

在自己的游戏中使用

1. 安装 music_pack 及其依赖 audio_base。
2. 在内容模组 manifest.json 已有的 depends 列表中加入 music_pack>=1。
3. 直接使用自带的播放列表，或者想自定义选曲时，在你模组的 music/playlists/ 目录下添加一个 JSON 文件。

依赖示例：

// 把依赖加入已有的列表：
"depends": ["music_pack>=1"]

自定义播放列表的存放位置示例：

my_game/
├── manifest.json
└── music/
    └── playlists/
        └── my_scene.json  # 你的场景的音乐

场景 my_scene 的播放列表示例：

{
  "Scene": "my_scene",
  "Musics": [
    {
      "MusicType": "Ambient",
      "MusicNames": ["Airborne Melody", "Twilight Interlude"]
    }
  ]
}

曲目名不带 .ogg 扩展名，大小写和空格都要保持原样。把 my_scene 换成你的场景名。

自带的播放列表

• default — 探索音乐（Ambient）和备用战斗音乐（Combat）。
• Battle — 两套战斗系统共用的战斗音乐。
• MainMenu — 主菜单主题曲。

播放列表 town_entry 仍属于剧情模组 cthangover_game，不在本素材包内。

全部 22 首曲目

探索

Abyssal Void · Airborne Melody · Binary Prelude · Cinders of Dawn · Melancholic Journey · Nebula Pulse Echoes · Quantum Archive · Twilight Interlude.

战斗与备用战斗列表

Aura of Decay · Circuit Dreams II · Crimson Echoes · Crimson Horizon · Empty Save Room · Glass Symphony · Hex Doom Cart · Iron Resonance · Iron Resonance II · Luminous Twilight · Rusty Frequencies · Skull Resonance · Venom's Embrace.

主菜单

Serpent's Lament.

音乐不播放时

• 检查 music_pack 和 audio_base 是否已安装并启用。
• 检查游戏设置中的音乐音量。
• 如果只有某个场景有问题，检查它自己的播放列表和确切的曲目名。
• 后加载的依赖模组可以覆盖同一场景、同一音乐类型的选曲。