pv-addon-lavaplayer-lib

pv-addon-lavaplayer-lib - серверная библиотека для голосового чата Plasmo Voice, внутри которой лежит форк LavaPlayer. Сама по себе она ничего не добавляет в игру, но без неё не заведутся аддоны, которые стримят музыку и трансляции прямо в голосовой чат. Классический пример - pv-addon-discs, который проигрывает аудио с YouTube, Twitch, SoundCloud и по прямым ссылкам через кастомные пластинки.

Короче, если вы ставите на сервер какой-то музыкальный аддон для Пласмо Войса и он ругается на отсутствие зависимости - это как раз про эту библиотеку. Скачайте pv-addon-lavaplayer-lib, закиньте на сервер, и всё заработает.

Зачем вообще нужна эта библиотека

Plasmo Voice - это мод на голосовой чат в Майнкрафт с позиционным звуком: слышно, откуда говорит игрок, с какого расстояния и так далее. У него есть система аддонов, и часть из них умеет воспроизводить внешние аудиопотоки. Проблема в том, что для работы с YouTube, Twitch и прочими источниками нужен аудиофреймворк LavaPlayer, а тащить его в каждый аддон отдельно - так себе идея. Поэтому разработчики вынесли форк LavaPlayer в отдельную библиотеку, которую аддоны подключают как зависимость.

По факту это типичная ситуация для серверных проектов: одна общая библиотека, куча аддонов поверх неё. Ставите один раз - и все совместимые аддоны подхватывают её автоматически.

Совместимость и версии

Библиотека покрывает Minecraft Java начиная с 1.16.5 и вплоть до актуальных веток 1.21.x. Список поддерживаемых платформ приличный:

• Paper, Purpur, Spigot - ставится как обычный плагин в папку ~/plugins
• Fabric, Forge, NeoForge - ставится как мод в папку ~/mods
• BungeeCord и Velocity - для прокси-сетей
• Folia - тоже поддерживается, что приятно

Так что неважно, на чём крутится ваш сервер Майнкрафт - библиотека скорее всего встанет без проблем.

Установка

Ничего сложного, стандартная процедура:

1. Скачайте аддон pv-addon-lavaplayer-lib с этой страницы
2. Установите библиотеку:
   • Для Paper (а также Purpur, Spigot, Folia) - закиньте jar в папку ~/plugins
   • Для Fabric или Forge - положите в папку ~/mods
3. Перезапустите сервер

Важный нюанс: библиотека ставится только на сервер. Игрокам ничего качать не нужно - это чисто серверная штука, клиент её не трогает.

Актуальные версии и что исправлено

Проект живой и регулярно обновляется. Последняя версия на момент написания - 1.2.3, где обновили youtube-source и починили назойливую ошибку "страницу нужно перезагрузить" при воспроизведении с YouTube. В предыдущих релизах добавили lavasrc (расширенные источники аудио), а также исправляли проблемы с Twitch и декодированием AAC-потоков.

Совет: если у вас музыка с YouTube внезапно перестала играть - первым делом обновите эту библиотеку. YouTube постоянно меняет что-то у себя на бэкенде, и разработчикам приходится подстраиваться.

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

Если вы пишете свой аддон для Plasmo Voice и вам нужен LavaPlayer, подключить библиотеку к проекту можно парой строк.

Подключение к проекту

Kotlin DSL

repositories {
    maven("https://repo.plo.su")
}

dependencies {
    compileOnly("su.plo:pv-addon-lavaplayer-lib:1.0.2")
}

Groovy DSL

repositories {
    maven { url 'https://repo.plo.su/' }
}

dependencies {
    compileOnly 'su.plo:pv-addon-lavaplayer-lib:1.0.2'
}

Использование с универсальными аддонами

Kotlin

@Addon(
    ...
    dependencies = [
        Dependency(id = "pv-addon-lavaplayer-lib")
    ]
)

Java

@Addon(
    ...
    dependencies = {
        @Dependency(id = "pv-addon-lavaplayer-lib")
    }
)

Использование с Bukkit-плагинами

Добавьте pv-addon-lavaplayer-lib в секцию depend вашего plugin.yml:

depend:
  - pv-addon-lavaplayer-lib

Стоит ли ставить

Если вы используете Plasmo Voice и хотите музыку на сервере - через пластинки, диджей-пульты или любые другие аддоны, которые тянут аудио из интернета - то эта библиотека обязательна. Без неё аддоны просто не запустятся. Если же музыкальные аддоны вам не нужны, то и библиотека не пригодится.

Для запуска сервера с Plasmo Voice и музыкальными аддонами удобно арендовать хостинг Майнкрафт на BungeeHost - там можно создать сервер в пару кликов и сразу закинуть нужные плагины. Особенно актуально, если планируете играть с друзьями и хотите, чтобы голосовой чат с музыкой работал стабильно и без лагов.