Etched-Extension

Etched-Extension - утилитарное дополнение для мода Etched, которое расширяет его музыкальные возможности поддержкой Meting API и ссылок на NetEase Cloud Music (网易云音乐). Если вы когда-нибудь хотели создать в Майнкрафт пластинку с любимым треком, но стандартный функционал Etched вас ограничивал - этот мод для вас.

Если вы не в курсе, Etched - это мод, который позволяет превращать собственные аудиофайлы в музыкальные диски с кастомными текстурами. Штука крутая, но заточенная в основном под локальные файлы. Этчед Экстеншн расширяет эти рамки: теперь можно вставлять ссылку из NetEase Cloud Music, и мод сам подтянет трек, создаст из него запись внутри игры. Удобно для тех, кто слушает музыку через китайский сервис, или просто хочет быстро закинуть песню в Minecraft без ручной конвертации.

Что именно делает мод

Добавляет в Etched два ключевых элемента:

• Поддержку NetEase Cloud Music - вы копируете ссылку на трек/альбом/плейлист, вставляете в Etched, и он превращает её в игровой музыкальный диск.
• Meting API - универсальный интерфейс, который позволяет обращаться к разным музыкальным платформам (на текущий момент основная - NetEase) через единый формат запроса.

Разрешение треков происходит через API под названием ebnr. Это такой посредник, который вытягивает аудиопоток по ссылке. Адрес API можно поменять в конфиге.

Настройка

Всё управляется через файл etched_extension-common.toml. Там можно указать собственный адрес ebnr API. По умолчанию стоит публичный сервер, но он имеет ограничения - о них ниже.

Важный нюанс с VIP-треками

Вот тут стоит быть внимательным. Стандартный API не поддерживает VIP-композиции (платный контент NetEase). Формально они могут записаться на диск, но при воспроизведении вы скорее всего получите ошибку или тишину. Мод в версии 0.2.3 как раз добавил проверку конфигурации при запуске и почистил вводящие в заблуждение предупреждения - раньше можно было случайно создать нерабочую пластинку и не понять, почему она молчит.

Если вы плотно сидите на NetEase и у вас есть доступ к нормальному API (или вы разворачиваете свой), то прописываете его в конфиг и проблема решается. Если нет - используйте только бесплатные треки, иначе диски будут просто красивыми пустышками.

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

Актуальный релиз - 0.2.3, вышел 5 октября 2025 года. Доступны сборки:

• Minecraft 1.20.1 под Forge
• Minecraft 1.21.1 под NeoForge

На Modrinth указана работа и на клиенте, и на сервере. Но есть нюанс: мод должен быть установлен на обеих сторонах. Если вы играете на сервере и хотите крафтить диски - ставьте и туда, и туда. Иначе синхронизация не сработает, и вы просто не увидите новых рецептов или они будут вести себя странно.

Зависимости

Без них никуда:

• Etched - сам мод, к которому идёт расширение. Без него ничего работать не будет, логично.
• Kotlin for Forge - библиотека, на которой написан Etched-Extension. Обязательна для запуска.

Обе зависимости ставятся стандартным способом - забрасываем в папку mods, не забываем про нужную версию загрузчика.

Что в итоге

Скачать Etched-Extension стоит, если вы активно пользуетесь Etched и хотите упростить добавление музыки в игру через NetEase Cloud Music. Мод делает одну вещь, но делает её хорошо: ссылка - диск - играет. Не надо возиться с конвертерами, не надо искать файлы на диске. Просто вставил URL и всё.

Для русскоязычных игроков NetEase может быть не самым очевидным выбором - сервис всё-таки китайский, и часть контента там платная или заблокирована для других регионов. Но если вы уже слушаете музыку через него или ваши любимые артисты выкладывают релизы именно там, мод становится незаменимым. Для остальных это скорее нишевое решение - большинство предпочтут просто закинуть mp3-файл в Etched напрямую.

Сборка для Forge 1.20.1 и NeoForge 1.21.1 - стандартный набор для современных модпаков. Проблем с установкой обычно не возникает, если не забыть про Kotlin for Forge. Если планируете играть с друзьями - ставьте мод на сервер, иначе гости не смогут воспроизводить созданные пластинки.

Если в конфиге что-то напутали с API или версией - мод в 0.2.3 теперь прямо скажет при запуске, что не так. Раньше приходилось догадываться. Приятная мелочь, которая экономит время.

Лицензия проекта - GPLv3, так что при желании можно копаться в исходниках и адаптировать под свои задачи.