# Music Pack — музыка для вашей игры

**22 музыкальные композиции** для исследования мира, сражений и главного меню. Набор можно использовать в разных играх на cthangover, не копируя музыку в каждый сюжетный мод.

![Три музыкальных контекста: исследование, бой и главное меню](assets/playlists.png)

## Что услышит игрок

- **Исследование мира:** 8 композиций для сцен без собственного плейлиста, в том числе RPG-карт.
- **Сражения:** 12 композиций в плейлисте `Battle`. В запасном боевом списке `default` также есть `Empty Save Room` — всего 13.
- **Главное меню:** `Serpent's Lament`.

> Music Pack содержит музыку и плейлисты. Новых локаций, заданий и игровых механик он не добавляет.

## Нужно ли что-то настраивать

Если ваша игра уже использует Music Pack, устанавливать отдельные треки или выбирать их вручную не требуется. Музыку воспроизводит система `audio_base`.

Набор используется главным меню, Cthangover, шаблоном новеллы и RPG-играми проекта. Он не требует загрузки сюжета основной игры.

## Подключение к своей игре

1. Установите `music_pack` и его зависимость `audio_base`.
2. В `manifest.json` своего контентного мода добавьте зависимость `music_pack>=1` к уже существующему списку `depends`.
3. Для сцен без особых требований используйте готовые плейлисты. Для собственной подборки добавьте JSON-файл в `music/playlists/` вашего мода.

Пример зависимости:

```jsonc
// Добавьте зависимость к существующему списку:
"depends": ["music_pack>=1"]
```

Пример размещения собственного плейлиста:

```filestree
my_game/
├── manifest.json
└── music/
    └── playlists/
        └── my_scene.json  # Музыка вашей сцены
```

Пример собственного плейлиста для сцены `my_scene`:

```json
{
  "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` установлены и включены.
- Проверьте громкость музыки в настройках игры.
- Если проблема только в одной сцене, проверьте её собственный плейлист и точные имена треков.
- Более поздний зависимый мод может заменить музыкальную подборку для той же сцены и типа музыки.