DebugBridge (Дебаг бридж)

Мод для Майнкрафт на Fabric, предназначенный для разработки и отладки: он открывает локальный WebSocket-мост к запущенной игре и веб-интерфейс для просмотра её состояния. Подходит для инструментов автоматизации и клиентов MCP: можно получать данные об игроке, мире, сущностях и интерфейсе, а также выполнять сценарии Groovy.

Возможности

• Показывает позицию, здоровье, голод, измерение, режим игры, время и погоду.
• Ищет ближайших мобов и другие сущности, выводит их снаряжение, атрибуты, пассажиров и предметы в рамках; отдельно определяет сущность, на которую направлен прицел.
• Просматривает блоки с данными: сундуки, таблички, баннеры, маяки, печи и другие. Для них доступны содержимое, текст, профиль головы и уровень маяка.
• Проверяет открытое меню или инвентарь, включая предметы в ячейках, и хранит недавние сообщения чата на стороне клиента.
• Делает снимки экрана, записывает последовательность кадров и создаёт изображения предметов с учётом прочности, покраски, пользовательской модели и голов игроков.
• Подсвечивает сущности и блоки контуром прямо в мире.
• Встроенный веб-интерфейс содержит сводку игрока, списки сущностей и блоков, просмотр инвентаря, чат, консоль Groovy и просмотр объектов Java.
• Через execute запускает сценарии Groovy внутри игры. В них уже доступны mc, player и level; мост сопоставляет читаемые имена классов Minecraft с именами, используемыми игрой.

Как пользоваться

Мост принимает подключения только с того же компьютера через 127.0.0.1. Он использует порт 9876, а при занятом порте перебирает диапазон до 9886; веб-интерфейс открывается на порту моста плюс 100.

Для прямого подключения отправляйте JSON-запросы в WebSocket, например с типом execute. Ответ содержит те же поля id и type вместе с результатом в payload.

При первом запуске нужно подтвердить предупреждение разработчика в игре. После этого мод сохраняет признак подтверждения в config/debugbridge.json.

Настройки

Основные параметры находятся в config/debugbridge.json.

• web_ui_enabled — включает или отключает встроенный веб-интерфейс.
• run_command_enabled — разрешает runCommand, который отправляет команды от лица игрока.
• session_control_enabled — разрешает disconnect, joinServer и quit для управления подключением и клиентом.

Видеозаписи по умолчанию сохраняются временно и удаляются после срока, заданного ttlHours. В запросе record_video значение storage: "persistent" сохраняет кадры в папке debugbridge-recordings внутри каталога игры.

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

Мод работает только на клиенте с Fabric; на сервер его устанавливать не нужно. При запуске он может загрузить официальные таблицы имён Mojang, необходимые для сопоставления классов. Веб-интерфейс и отладочный порт не доступны из сети: к ним могут подключаться только программы на том же компьютере.