Files
mod_music_pack/docs/ru.md
T

88 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` установлены и включены.
- Проверьте громкость музыки в настройках игры.
- Если проблема только в одной сцене, проверьте её собственный плейлист и точные имена треков.
- Более поздний зависимый мод может заменить музыкальную подборку для той же сцены и типа музыки.