M1 - Machine One AI Interface

Мод для Майнкрафт, который позволяет управлять запущенным игровым клиентом текстовыми командами через локальное соединение. Он подходит для автоматизации, тестирования модов и игры без мыши и клавиатуры: можно читать состояние мира и экранов, перемещаться, добывать ресурсы, создавать предметы и работать с интерфейсами.

Возможности

• Описывает открытые меню и их элементы, содержимое контейнеров, сохранённые миры, инвентарь, координаты, здоровье, голод и измерение игрока.
• Сканирует видимую область, блок под прицелом, мобов и выброшенные предметы. Сканирование не видит руды за стенами и показывает блоки только перед игроком; живые существа определяются вокруг игрока.
• Строит маршрут до координат, открывает двери и калитки, проходит по рельсам и лестницам. Можно остановить движение или добычу командой stop.
• Добывает блоки, размещает и использует предметы, выбирает ячейки хотбара, надевает броню и щит, делает скриншоты.
• Выполняет простые крафты: доски и верстак — в сетке инвентаря, палки и деревянный топор — на верстаке.
• Автоматически выбирает лучшую броню из инвентаря; эту функцию можно включать и выключать.
• Поддерживает боевые действия, следование за игроком, автоматическую защиту, сортировку хотбара, перенос предметов из контейнеров и восстановление вещей после смерти.

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

После запуска клиента мод открывает текстовый сервер только на этом компьютере: 127.0.0.1:26000. Команды отправляются построчно, а ответ заканчивается строкой <<END; приветственное сообщение после подключения нужно прочитать до первой команды.

Основные команды:

• help — список доступных команд.
• describe — описание текущего меню и его элементов.
• click <id> и type <id> <text> — нажатие на элемент интерфейса и ввод текста.
• where, look, scan [радиус|название], inv — состояние игрока, блок под прицелом, обзор и инвентарь.
• moveto <x> <z>, goto <x> <y> <z>, move <направление> <блоки>, face <направление|координаты> — навигация и поворот камеры.
• mine [x y z], hold <0-8>, equip <предмет>|all, place — добыча и работа с предметами.
• openinv, slots, slot <id> [кнопка] [режим] — инвентарь и ячейки открытого контейнера.
• craft planks|sticks|table|axe — создание базовых предметов.
• attack [nearest|id|crosshair], defend on|off, agent follow <игрок> — бой, защита и следование.
• screenshot [имя] — сохранение снимка экрана.
• quit или exit — закрытие соединения без остановки клиента.

Команды move, moveto, goto, mine и craft выполняются в фоне: проверяйте результат через where, look или inv. Для перехода к блоку и добычи можно указать его координаты. Команда cmd <команда> отправляет обычную серверную команду без символа /; для неё в мире должны быть разрешены читы.

Индексы из inv относятся к постоянной нумерации инвентаря, а номера из slots меняются для каждого открытого контейнера. Перед использованием slot следует вызвать slots.

Настройки

• autoupgrade on|off — включает или выключает автоматическую замену брони на более прочную.
• upgrades — показывает ожидающие сообщения об автоматической смене брони.
• Для управления через ИИ-клиент требуется мост MCP-Minecraft из исходного проекта; вручную к соединению можно подключиться любым построчным TCP-клиентом.

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

Работает как клиентский мод для Fabric, NeoForge и Forge; серверный мод не нужен. Одновременно должен быть запущен только один клиент с этим модом, так как используется один и тот же локальный порт.

Для работы с хранилищем Bank Vault нужны Bank Vault и открытое хранилище; доступны команды vault mark, vault contents, vault withdraw и vault deposit. Возможности рюкзака — openpack, pack on, pack contents, pack put и pack take — требуют Travelers Backpack.