Simple Voice Chat Music for Paper

Плагин для серверов Paper и Purpur, позволяющий транслировать музыку с YouTube, Spotify, SoundCloud и других источников в чаты Simple Voice Chat.

Описание и возможности

Это порт популярного Fabric-мода, адаптированный для работы на серверных платформах Paper и Purpur. Плагин позволяет создавать групповые прослушивания в чатах Simple Voice Chat, передавая аудио в реальном времени всем участникам группы. Поддерживается широкий спектр источников: YouTube, Spotify, SoundCloud, Twitch, Bandcamp, Vimeo, а также локальные файлы форматов MP3, FLAC, WAV и M3U. В основе работы лежит библиотека lavaplayer, что обеспечивает гибкость в обработке различных медиа-форматов.

Команды управления

Плагин предоставляет набор команд в латинице для управления воспроизведением. В данной версии аргументы командной строки объединяются автоматически, поэтому кавычки вокруг поисковых запросов не требуются.

Основные команды:

• /music play — ищет и ставит первую найденную песню в очередь. Для поиска по YouTube используется формат ytsearch: , для SoundCloud — scsearch: . Для прямых ссылок на YouTube Music используется ytmsearch: . Ссылки на Spotify принимаются без дополнительных команд.
• /music search — выводит список всех найденных результатов на YouTube, позволяя выбрать конкретный трек для воспроизведения.
• /music now-playing — отображает информацию о текущем треке.
• /music queue — показывает текущую очередь воспроизведения.
• /music skip — пропускает текущий трек.
• /music pause / /music resume — пауза и возобновление воспроизведения.
• /music stop — останавливает музыку и очищает очередь.
• /music volume — регулирует громкость.
• /music kill — аварийная перезагрузка плагина без остановки сервера.
• /music bassboost — добавляет бас-буст (требуется указать числовое значение).

Важно: при попытке воспроизвести ссылку на YouTube через команду /music play без явного указания формата поиска, плагин может не распознать запрос. Используйте префикс ytsearch:, если ссылка не работает автоматически.

Интеграция с Spotify

Плагин поддерживает интеграцию с Spotify через их API. Для работы достаточно вставить прямую ссылку на трек (например, https://open.spotify.com/track/...) в команду воспроизведения. Система автоматически извлекает название и исполнителя, а затем ищет трек на YouTube для трансляции. Специальные команды для поиска на Spotify не требуются, так как поиск по умолчанию выполняется на YouTube.

Поддержка и известная информация

Плагин находится в активной разработке. Основной функционал для YouTube, SoundCloud и Spotify протестирован авторами. Однако, поскольку это порт для платформы Paper, в коде могут встречаться ошибки, отсутствующие в оригинальной Fabric-версии. Если вы обнаружили баги, связанные со Spotify или другими источниками, рекомендуется создать запрос на GitHub или обратиться к разработчику GavinGoGaming в Discord.

Ограничения и замечания

Плагин был протестирован в ограниченном объеме. Известные проблемы включают:

• Команда /music bassboost может выдавать ошибку, если не передано числовое значение.
• Поиск по прямой ссылке на YouTube требует обязательного использования префикса ytsearch:, иначе команда может не сработать.
• Поддержка YouTube Music через Lavaplayer работает нестабильно.

Плагин распространяется под лицензией Apache-2.0. Оригинальный мод был создан автором @ItzDerok, а порт на Paper выполнен GavinGoGaming с использованием Bukkit API Simple Voice Chat. Поддержка Spotify была добавлена пользователем MrTronMan для личного использования.