Поставить карту

Карта умещается в один файл .blockymap. Поставить его можно четырьмя способами; для первого не нужно ничего, кроме самой игры.

Что нужно заранее

Картам нужен мод Blocky Music для Minecraft 1.21.1 на NeoForge. Сначала поставьте мод и запустите игру один раз, чтобы он создал свои папки.

Скачать мод на qwu.world

1. Через браузер в игре (проще всего)

Нажмите Alt+B в игре. Тот же экран открывается кнопкой «Мастерская» в главном меню и из настроек Blocky Music, так что клавишу можно переназначить или вообще не трогать.
Найдите карту по названию, исполнителю, мапперу или номеру, послушайте превью и откройте её.
Нажмите «Установить». Карта скачается, пройдёт проверку и сразу появится в списке треков: ничего распаковывать и никуда перекладывать не нужно.

Один раз мод спросит, можно ли ему обращаться к этому сайту. Пока вы не согласитесь, экраны Мастерской работают без сети; способы с файлами ниже действуют всё равно, а помощник дождётся вашего ответа.

2. В один клик с сайта (помощник)

QwU Workshop Helper это маленькая отдельная программа. С ней кнопка «Установить в игре» на странице карты сразу ведёт в Minecraft: карта встаёт в очередь игры и ставится, как только вы заглянете в Мастерскую; неважно, запущена игра или закрыта.

Установка происходит один раз и объясняет компьютеру три вещи:

что ссылки blockymusic:// открывает помощник, поэтому «Установить в игре» отсюда доходит до вашей игры;
что файлы .blockymap открывает помощник, поэтому двойной клик по скачанной карте её ставит;
в какую сборку Minecraft класть: он сам ищет мод и спросит один раз, если сборок несколько.

Помощник ничего не скачивает, не выходит в сеть и не требует аккаунта. Он лишь кладёт маленький файл в папку workshop_inbox вашей игры; остальное делает мод, по тому разрешению на сеть, которое вы ему уже дали.

Скачать

Помощник пока без подписи, поэтому в первый раз macOS Gatekeeper и Windows SmartScreen предупредят. На macOS откройте приложение через правую кнопку в Finder и выберите «Открыть»; на Windows нажмите «Подробнее», затем «Выполнить в любом случае». Перед этим сверьте SHA-256 файла с суммой выше.

Как убрать

Запустите помощника один раз с ключом --unregister в терминале. Тип файлов .blockymap и ссылки blockymusic:// вернутся тому, у кого были до этого, больше ничего не изменится.

qwu-workshop-helper --unregister

Потом удалите саму программу. Останется только маленький файл настроек с выбранной сборкой (QwU/workshop-helper.json в вашей папке пользователя).

3. Перетащить файл

На странице карты здесь нажмите «Скачать» и сохраните файл .blockymap.
Не закрывая Minecraft, перетащите файл на окно игры: подойдёт главное меню, список треков или любой экран Мастерской.
Мод проверит файл, поставит карту и покажет всплывающее сообщение с её названием.

4. Папка входящих

Если игра не запущена или вы ставите карты не себе, положите файлы сюда:

<папка игры>/music_battle_tracks/workshop_inbox/

Папку мод читает при запуске игры, при открытии Мастерской и каждые несколько секунд, пока открыт любой её экран. Каждый исправный пакет ставится и из папки исчезает.

Файл, который поставить не вышло, уезжает в workshop_inbox/rejected/, а рядом появляется .txt с причиной.

Где лежат файлы

Всё, с чем работает Blocky Music, лежит в папке music_battle_tracks внутри папки игры. У каждой поставленной карты своя подпапка рядом с вашими собственными треками.

Официальный лаунчер: .minecraft (Windows: %appdata%\.minecraft, macOS: ~/Library/Application Support/minecraft, Linux: ~/.minecraft).
В Modrinth App, Prism и CurseForge у каждой сборки своя папка. Берите папку сборки, а не .minecraft.

Не знаете, какая папка у вашей сборки? Откройте Мастерскую, вкладку «Установленные» и нажмите «Показать файлы».

Если карта не ставится

Сверьте версии мода и Minecraft с теми, что указаны на странице карты. Карта, собранная под более новый мод, на старом не запустится.
Загляните в workshop_inbox/rejected/: в .txt рядом с картой написано, что именно не так.
Часть карт выходит без звука и просит вашу собственную копию песни. Как работают карты со своим звуком
Снятую карту поставить уже нельзя, даже из файла, скачанного раньше.