MusicLayer

MusicLayer - это техническая библиотека для Майнкрафт, которая решает одну важную проблему: проигрывание музыки без фризов и лагов. В ванильной игре музыка воспроизводится в определённые моменты, но если мод хочет добавить свою собственную музыку (например, для новых биомов, измерений или событий), стандартные средства могут вызывать подвисания. MusicLayer берёт это на себя.

Как это работает и зачем нужно

MusicLayer сам по себе ничего не меняет в игровом процессе - это чистый API для других модов. Если вы устанавливаете какой-нибудь мод, который приносит новую музыку, и он требует MusicLayer, то без этой библиотеки музыка не заиграет. Мод позволяет проигрывать Ogg-файлы несколькими способами:

• Из ресурсов мода - по пути типа testmod:music/beach он находит файл /assets/testmod/sounds/music/beach.ogg и играет его.
• По прямой ссылке - можно указать URL на .ogg файл, музыка скачается и закэшируется в папке .minecraft/musiclayer/music/. При первом запуске будет небольшая задержка (скачивание), но потом всё играет мгновенно. Кэш проверяет, не изменился ли файл на сервере, и при необходимости обновляет его.
• Кастомный InputStream - продвинутый вариант, когда другой мод передаёт свой поток данных для проигрывания.

Важный момент: MusicLayer при запуске извлекает дополнительную библиотеку в /asm/MusicLayer/SoundLib.jar. Это нормально, без неё мод не заработает.

Совместимость и требования

• Обязательно: HammerLib - без него MusicLayer не запустится.
• Поддерживается только последняя версия Minecraft, для которой существует этот мод. Автор просит не просить даунгрейд - это не предполагается.
• Использование в модпаках: можно свободно включать в сборки.
• Репост: нельзя выкладывать мод на других сайтах без указания ссылки на скачивание на CurseForge или Modrinth и без разрешения автора.
• Включение в другие моды: запрещено, но делать аддоны (надстройки) можно. Автор просит только предупредить его по-дружески.

Итог

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