BloodHuntMusic

BloodHuntMusic — это музыкальный мод для Risk of Rain 2, который заменяет стандартный саундтрек игры на атмосферные и динамичные треки от BloodHunt. Ссылки на автора:

• https://www.deezer.com/ru/artist/255060972
• https://vk.ru/bloodhuntmusic
• https://music.yandex.ru/artist/21677021
• https://music.apple.com/ru/artist/bloodhunt/1731037344
• https://open.spotify.com/artist/7pezvE4sFquniFRrjQjDdT
• https://music.youtube.com/channel/UChWlRacJnDDPURORMG9BLWw

Мод работает на обновленном аудио-движке с поддержкой плавных переходов, сохранения позиции треков и гибкой настройки через текстовый реестр music_list.txt.

🌟 Ключевые особенности

• Плавный кроссфейд (Fade-In / Fade-Out): Переходы между треками при исследовании локаций, активации телепорта и смене уровней происходят плавно и без резких обрывов.
• Защита тем многофазных боссов: Музыка в битвах с Митриксом, Ложным Сыном (Меридиан) и Voidling'ом не сбрасывается на начало между фазами боя.
• Живая пауза в памяти: При временной смене музыки трек ставится на паузу в оперативной памяти и продолжает играть с того же места при возврате.
• Интеграция с Risk of Options: Регулируйте общую громкость, баланс громкости локаций и боссов, а также длительность плавного перехода прямо во время игры через меню Settings -> Mod Options.
• Удобная настройка через music_list.txt: Поддержка форматов .mp3, .ogg и .wav без необходимости перепаковки звуковых банков Wwise.

📂 Структура папки мода

В папке вашего профиля модов (BepInEx/plugins/BloodHuntMusic/) располагаются:

📁 BloodHuntMusic
 ├── 📄 CustomTextMusicMod.dll    (основной плагин мода)
 ├── 📄 NAudio.dll                (аудио-библиотека)
 ├── 📄 NVorbis.dll               (декодер Ogg Vorbis)
 ├── 📄 music_list.txt            (реестр привязки треков к локациям)
 └── 📁 Tracks                    (или аудиофайлы .mp3 / .ogg / .wav прямо в корне папки)

⚙️ Настройка music_list.txt

Каждая строка в файле music_list.txt задает правило воспроизведения в формате:

Код_Сцены | Тип (Stage или Boss) | Имя_Файла | Громкость_%

• Код_Сцены: Внутреннее название локации в игре (например, blackbeach, golemplains, moon2, meridian) или универсальное ключевое слово any для музыки по умолчанию.
• Тип: Stage (музыка исследования уровня) или Boss (музыка события телепорта и боссов).
• Имя_Файла: Название аудиофайла (мод автоматически ищет его как в корне папки мода, так и в подпапке Tracks/). Если оставить поле пустым, игра автоматически использует трек по умолчанию (any).
• Громкость_%: Индивидуальная громкость трека в процентах (по умолчанию 100).

Вы можете изменять список треков прямо во время запущенной игры — для применения изменений достаточно нажать кнопку «Перезагрузить music_list.txt» в настройках мода (Mod Options).

🛠️ Требования и зависимости

• BepInExPack
• RiskOfOptions (автор Rune580) — для отображения настроек громкости и переходов в меню игры.