Jukebox Custom Disc Fix

Мод Jukebox Custom Disc Fix для Minecraft 1.21.11

Мод Jukebox Custom Disc Fix решает проблему, когда пользовательские музыкальные диски (resource pack) обрезаются в джакуксовых сразу после окончания оригинального трека. Решение реализовано на стороне сервера: мод отправляет клиенту сигнал о прекращении воспроизведения только тогда, когда диск физически извлечен из джакуксового (игроком или хоппером). Для версий Minecraft 1.21 и новее добавлено клиентское исправление, игнорирующее ошибочные пакеты от сервера и останавливающее трек по состоянию блока джакуксового. Мод не требует Fabric API и не обязателен для клиентов в мультиплеере, достаточно установить его на сервер.

🎵 Проблема обрезки треков в джакуксовых

Мод решает баг MC-260346, при котором пользовательские музыкальные диски (custom music discs) в джакуксовых обрезаются слишком рано. Это происходит, когда оригинальный трек ванильного диска заканчивается, и игра по ошибке останавливает воспроизведение и кастомного трека. В результате музыка обрывается в самый неподходящий момент, не доиграв до конца композиции.

🔧 Принцип работы исправления

Исправление реализовано на стороне сервера. В ванильном Minecraft сервер отправляет клиенту команду остановить звук сразу, как только ванильный диск заканчивается. Мод же меняет логику: он продолжает воспроизведение кастомного трека, пока диск физически находится в джакуксовом. Звук останавливается только тогда, когда диск извлекается из блока (игроком, кликнув по нему, или автоматически хоппером).

🆕 Клиентское исправление для Minecraft 1.21+

Начиная с версии Minecraft 1.21 (мод 0.1.4-1.21), разработчик добавил клиентскую часть исправления. Это необходимо, так как баг был частично исправлен в самой игре, но оставил проблемы для сторонних ресурсов. Новый механизм игнорирует ошибочные пакеты от сервера, которые приказывают клиенту остановить музыку. Теперь клиент сам решает, когда прекратить воспроизведение: только когда в состоянии блока джакуксового (has_record) будет установлено значение false.

⚠️ Рекомендация для Minecraft 1.21 и новее: В этой версии игры баг отчета был помечен как решенный. Для добавления пользовательских дисков теперь рекомендуется использовать datapacks (встроенный способ игры). Если вы всё же хотите использовать кастомные диски исключительно через resource pack, этот мод всё ещё необходим для корректной работы.

🌐 Установка и мультиплеер

Мод не требует Fabric API. Для игры в мультиплеере мод не обязателен на клиентах игроков; достаточно установить его на сервере. Это упрощает настройку серверов, где игроки могут подключаться с разными сборками, но при этом корректно слышать музыку из кастомных дисков.

📊 Поддерживаемые платформы и версии

🛠️ Технические детали и поддержка

Мод написан с использованием Mixins. Размер архива составляет всего 8.5 КБ (8486 байт), что делает его крайне легким для установки. В архиве содержится 15 файлов, включая 4 класс-файла. Мод не требует дополнительных зависимостей и работает автономно.

Если вы нашли баг или у вас возникли вопросы, разработчик поддерживает официальный трекер задач (issue tracker) и сообщество в Discord. Для получения технической помощи или обсуждения можно присоединиться к серверу Discord автора.

Связанные материалы

• Sound Controller — похожий мод
• Resource Gamma Util / Fullbright — похожий мод
• Sodium Extra — похожий мод
• VeinMiner Hotkey — похожий мод

Автор: eclipseisoffline · Лицензия: LGPL-3.0-only