MUSYNC - Music Sync for Minecraft

MuSync

MuSync синхронизирует фоновую музыку Minecraft на всём сервере, чтобы каждый игрок слышал один и тот же трек в одно и то же время и с одной и той же позицией воспроизведения.

Возможности

Синхронизация на всём сервере: MuSync держит фоновую музыку согласованной у всех подключённых игроков. Если кто-то заходит позже, меняет измерение или принудительно запускает ресинк, его клиент автоматически догоняет текущий трек по актуальной метке времени, а не начинает с начала.

Автономные потоки измерений: во время обычной игры каждое активное измерение ведёт собственный независимый музыкальный поток. Overworld, Nether и End сохраняют своё время и выбор треков, естественно реагируя на события вроде смены биома, боя с Ender Dragon или титров.

Режим универсального плейлиста: как только оператор вручную запускает трек или очередь, MuSync переопределяет автономные потоки и сводит воспроизведение в единую трансляцию на весь сервер. Все слышат одну и ту же музыку независимо от измерения, пока плейлист не закончится и обычные потоки измерений не возобновятся.

Автономный клиентский режим: даже на сервере без установленного MuSync мод работает как полноценный локальный музыкальный движок. Можно ставить треки в очередь, перемешивать и управлять ими локально так же, как на сервере.

Своя музыка и горячая загрузка: MuSync поддерживает пользовательские треки (.ogg, .wav, .mp3) из серверных ресурспаков, модов или папки custom music. Операторы могут горячо загружать новые пользовательские треки без перезапуска сервера. Если у игроков нет пользовательских треков, сервер может передать их напрямую и закешировать локально, чтобы экономить трафик при будущих воспроизведениях.

Точная история ванильных треков: при повторе или возврате к ванильной музыке MuSync помнит точный вариант трека, который играл. Если играл конкретный творческий трек, повтор воспроизведёт именно эту песню, а не выберет случайно из музыкального пула заново.

Управление воспроизведением: соберите очередь, перемешайте её или поставьте на повтор. Мод включает стандартные элементы управления (Play, Pause, Stop, Skip и Previous). Функция «Previous» помнит историю проигранных треков и позволяет вернуться назад, чтобы услышать их снова.

Живая перемотка: главная панель управления включает полосу перемотки. Перетаскивание обновляет позицию живого трека сразу для всего сервера.

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

Поддержка разных версий: сейчас MuSync поддерживает 1.19.2 (Forge/Fabric), 1.20.1 (Forge/Fabric) и 1.21.1–1.21.11 (Fabric/NeoForge).

Элементы управления интерфейса

Откройте панель управления назначенной клавишей или командой /musync gui. Большинство функций управления требуют прав оператора.

Sync: пересинхронизирует ваш локальный клиент с живым состоянием воспроизведения на сервере. Меню измерений: переключает интерфейс для просмотра активных потоков разных измерений и показывает, какие игроки их слушают. Управление воспроизведением: кнопки Previous, Stop, Pause и Skip для текущего потока. Полоса перемотки: перетаскивайте, чтобы промотать активный трек. Repeat: переключает режимы повтора выключен, повтор трека, повтор плейлиста, перемешивание и перемешивание с повтором. Delay: задаёт и применяет свои минимальные и максимальные задержки воспроизведения для выбранного измерения. Playlist: открывает очередь для просмотра предстоящих треков, удаления записей или сохранения и загрузки очередей локально. Tracks: открывает браузер треков для воспроизведения или добавления в очередь любого доступного ванильного или пользовательского трека. Cache: переключает локальное кеширование на диске для скачанных пользовательских треков. Команды

Эти операторские команды управляют серверным потоком без необходимости в GUI:

/musync gui - Открывает панель управления. /musync play  - Немедленно воспроизводит указанный трек. /musync stop - Останавливает активный серверный поток. /musync pause - Ставит текущий поток на паузу. /musync resume - Возобновляет текущий поток. /musync skip - Переключает на следующий трек в очереди. /musync queue  - Добавляет трек в плейлист. /musync status - Выводит подробные данные о воспроизведении, таймингах и очереди. /musync sync - Принудительно синхронизирует всех клиентов. /musync delay - Показывает пользовательскую задержку текущего измерения. /musync delay reset - Сбрасывает переопределение задержки для текущего измерения. /musync delay  - Задаёт пользовательский диапазон автоматической задержки для текущего измерения. Горячие клавиши

Эти горячие клавиши позволяют управлять воспроизведением без открытия меню. Использование управляющих горячих клавиш на сервере требует прав оператора.

GUI: Открывает главную панель управления. Skip Track: Переключает текущую песню. Pause/Resume: Ставит воспроизведение на паузу или возобновляет его. Stop Music: Полностью останавливает воспроизведение. Previous Track: Переключает назад на предыдущий трек.