Мод для Майнкрафт на Fabric, который помогает разрабатывать и отлаживать датапаки прямо в запущенном мире. Он подключает Майнкрафт к VS Code через протокол отладки: можно ставить точки останова в .mcfunction, выполнять команды пошагово, смотреть и менять игровые данные.
Возможности
- Точки останова, пауза, продолжение выполнения, вход в вызванные функции и выход из них; точки на пустых строках и комментариях переносятся к следующей исполняемой команде.
- Отладка обычных команд и строк макросов с
$.... - Просмотр стека вызовов, исполнителя команды, его позиции, поворота, измерения и NBT-данных.
- Просмотр и изменение аргументов макросов, таблицы счёта, хранилищ команд и NBT сущностей.
- Разрешение селекторов сущностей, например
@e[type=pig], и координат прямо в редакторе при остановке выполнения. - Окно наблюдения Saddle Watch для отслеживания сущностей, значений таблицы счёта и NBT в реальном времени. Закреплённые значения можно переименовывать и редактировать.
- История выполнения команд: доступны шаг назад и переход к предыдущей точке остановки. Для сохранённого момента показываются стек, аргументы, исполнитель, таблица счёта и хранилища.
- Сообщения игрового чата выводятся в консоль отладки VS Code.
Как пользоваться
Установите расширение Saddle для VS Code, откройте папку датапака, поставьте точки останова в .mcfunction и запустите профиль Attach to Minecraft (Saddle) клавишей F5. Функцию из открытого файла можно выполнить сочетанием Ctrl+Alt+Enter или кнопкой запуска в редакторе.
В панели WATCH и Saddle Watch поддерживаются выражения:
@e[type=pig]— найденные сущности;storage <id> [path],entity <target> [path],block <x> <y> <z> [path]— NBT-данные;score <objective> [holder],scoreboard,storage— значения таблицы счёта и хранилища;$(name)— аргумент текущего макроса.
Команды saddle/pin, saddle/unpin и saddle/pins управляют закреплёнными выражениями. Настройка saddle.reloadOnSave автоматически выполняет /reload после сохранения файлов датапака.
Команда /deploy с уровнем прав 4 подготавливает мир для распространения: сохраняет карту, блоки, сущности, датапаки и настройки мира, но удаляет данные игроков. /deploy copy [path] создаёт очищенную копию, а /deploy apply очищает текущий мир после его закрытия.
Настройки
Адрес отладчика по умолчанию — 127.0.0.1:16352; его можно изменить параметрами Java -Dsaddle.host и -Dsaddle.port. Удалённые подключения разрешаются только с -Dsaddle.allowRemote=true, но порт позволяет выполнять команды без проверки доступа, поэтому его следует открывать лишь в доверенной сети или через защищённый туннель.
Параметр -Dsaddle.ttd.steps задаёт размер истории выполнения команд. Частота обновления Saddle Watch меняется настройкой saddle.liveWatchRefreshInterval.
Требования и совместимость
Нужны Fabric Loader, Fabric API, Java и расширение Saddle для VS Code; версии мода и расширения должны совпадать. Мод ставится на сторону, где работает мир: на клиент в одиночной игре или на сервер в мультиплеере.
На выделенном сервере для остановок на точках останова автор рекомендует установить max-tick-time=-1, иначе серверный watchdog может остановить сервер. Во время паузы на точке останова мир не выполняется; при долгой паузе в одиночной игре внутренний клиент может отключиться.
