Terra-CalamityOST (Custom Text Music Loader)

Terra-CalamityOST — это продвинутый мод для Risk of Rain 2, который позволяет полностью заменить внутриигровой саундтрек на вашу собственную музыку (включая масштабные музыкальные паки из Terraria, Calamity Mod, Fargo's и любых других источников) без необходимости запаковывать их в громоздкие банка-моды Wwise.

---

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

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

---

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

В папке вашего профиля модов (BepInEx/plugins/Terra-CalamityOST/) должны находиться:

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

---

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

Файл использует простой и понятный формат:

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

• Код_Сцены: Внутреннее название уровня (например, blackbeach, moon2, meridian) или универсальное слово any для музыки по умолчанию.
• Тип: Stage (исследование уровня) или Boss (бой после активации телепорта).
• Вы можете редактировать music_list.txt в любой момент. Для применения изменений прямо во время игры откройте меню мода через Mod Options и нажмите кнопку «Перезагрузить music_list.txt».

---

🛠️ Требования

• Risk of Rain 2 (версия с поддержкой DLC Alloyed Collective)
• BepInExPack (версия 5.4.21+)
• RiskOfOptions (автор Rune580) — необходим для работы ползунков громкости в меню.