Region BGM API

Данный мод представляет собой программный интерфейс, который могут использовать другие модификации для воспроизведения фоновой музыки в игре. Он поддерживает потоковое вещание аудио из различных онлайн-источников, включая YouTube, Twitch и многие другие платформы.

Основное применение API - создание зон с уникальным музыкальным сопровождением. Это позволяет разработчикам добавлять атмосферные саундтреки в определенных областях игрового мира, значительно повышая уровень погружения.

Технической основой мода служит библиотека lavaplayer, созданная разработчиком sedmelluq. На данный момент проект поддерживает версию Minecraft 1.12.2.

Моды, использующие API

Сам по себе RegionBGM не имеет функциональности - для его работы требуется установка дополнительных модификаций, которые реализуют конкретные возможности.

Типичная схема установки включает размещение RegionBGM как на клиенте, так и на сервере, в то время как мод-расширение устанавливается только на серверной стороне.

В настоящее время доступны следующие проекты, использующие данный API:

• Zone BGM: Модификация, интегрирующаяся с Forge Essentials и RegionBGM для создания музыкальных зон. Идеально подходит для добавления уникальных саундтреков в различных локациях сервера - городах, кораблях пиратов и других тематических областях. Требует установки только на сервере.

Настройки

Пользователи могут регулировать два основных параметра через интерфейс конфигурации:

• enabled: Включение или отключение функциональности мода
• volume: Регулировка громкости фоновой музыки

В игровом процессе для каждого мода, использующего RegionBGM API, создается специальное игровое правило bgm_modid, которое по умолчанию активно. При отключении этого правила соответствующая модификация перестает отправлять пакеты клиентам и активировать музыкальное сопровождение.

Поддерживаемые источники

Система поддерживает широкий спектр онлайн-источников аудио: отдельные видео YouTube, плейлисты YouTube, прямые трансляции Twitch и многое другое.

Благодаря использованию библиотеки lavaplayer, доступен полный перечень поддерживаемых форматов и платформ, соответствующий возможностям этой технологии.

Для разработчиков

Разработчики, желающие интегрировать RegionBGM API в свои проекты, могут найти подробную техническую документацию и примеры использования в соответствующем репозитории на GitHub.