Minecraft Agent Harness CLI
CLI запускает LLM-агентов в Minecraft через Mineflayer: добыча, постройки, бой и чат, сессии переживают перезапуск
- 209 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент выполняет команды в своей оболочке (Docker, `E2B` или локальная папка) и в игре
- Ключи API провайдеров моделей берутся из `.env`, расход токенов растет с числом агентов
- Боты на чужих серверах могут нарушать правила, подключайтесь только с согласия владельца
Установка
Ручная установка
npm ciПервый шаг быстрого старта: затем копия `.env.example` в `.env`, `npm run server` и `npm start -- --objective "..."`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент выполняет команды в своей оболочке (Docker, `E2B` или локальная папка) и в игре
- Ключи API провайдеров моделей берутся из `.env`, расход токенов растет с числом агентов
- Боты на чужих серверах могут нарушать правила, подключайтесь только с согласия владельца
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Harness подключает модель к серверу Minecraft и дает ей задачу. Агент играет как обычный игрок через Mineflayer: ходит, добывает, крафтит, строит, сражается и пишет в чат. Сессией модели управляет `pi`, поэтому подходят Claude, GPT, Gemini, OpenRouter и любой адрес с API OpenAI Responses. Состояние лежит в `.agent-state/<имя>/`, и остановленный агент под тем же именем продолжает с места остановки. У каждого агента есть оболочка в Docker, `E2B` или обычной папке: в ней он хранит заметки и пишет скрипты, которые вызывают его же игровые инструменты. Команды описываются одним JSON-файлом с личными сообщениями между агентами и общей машиной по желанию, зрение экспериментальное. По README на нем играли матчи Bed Wars и держали сервер выживания с 50 агентами.
Для кого. Исследователям и разработчикам игровых агентов, которые проверяют модели в открытом мире Minecraft и хотят командное взаимодействие без собственного цикла управления.
Подходит, если
- Нужно проверить, как модель строит укрытие или добывает ресурсы по цели из одной фразы
- Несколько агентов играют командой, переписываются и делят общую машину
- Эксперимент длится часами, и агент после падения процесса должен продолжить сам
- Хочется сравнить Claude, GPT и Gemini на одном и том же задании в игре
Не подходит, если
- Нужен помощник для разработки кода: проект сделан для игры и не связан с репозиториями
- Свой сервер Minecraft вам недоступен, а подключаться к чужому с ботами нельзя без согласия владельца
- Нужна стабильная версия игры отличная от 1.21.6: встроенный сервер Paper рассчитан на нее
Пример запроса к агенту
Собери вокруг спавна небольшое укрытие из дерева и сообщи в чат, когда закончишь.Ограничения
Нужны Node.js 22.19 или новее, ключ API какого-либо провайдера моделей и сервер Minecraft: для разработки есть встроенный Paper 1.21.6 в офлайн-режиме, которому нужна Java 21. Модель по умолчанию в README названа `GPT-6.1 Terra`, другие провайдеры настраиваются в `docs/configuration.md`. Оболочка агента в Docker или `E2B` требует соответствующего окружения. Зрение в README помечено экспериментальным. Агентов нужно запускать только на серверах, где боты разрешены. Последний коммит в репозитории датирован октябрем 2026 года.
Как отключить. Остановите агента командой Ctrl+C. Состояние лежит в `.agent-state/` и удаляется вместе с папкой, контейнеры Docker для оболочек останавливаются отдельно, а встроенный сервер закрывается завершением `npm run server`.
Частые вопросы
Как запустить агента?
Выполните `npm ci`, заполните `.env`, запустите `npm run server`, затем `npm start -- --objective "..."` с целью в кавычках. Подключиться и наблюдать можно из Minecraft 1.21.6 на `localhost:25565`.
Какие модели поддерживаются?
Claude, GPT, Gemini, OpenRouter и любой адрес, который говорит на API OpenAI Responses. Список и переключение описаны в `docs/configuration.md`.
Что будет после перезапуска?
Агент, запущенный под прежним именем, продолжит с сохраненного состояния из `.agent-state/<имя>/`: заметки, сессия и память остаются.
Можно ли запускать команду агентов?
Да, команды описываются одним файлом JSON, агенты пишут друг другу личные сообщения, а общая машина подключается по желанию. По README держали сервер с 50 агентами.
Где агент хранит заметки и скрипты?
В своей оболочке: Docker, `E2B` или обычная локальная папка. Скрипты агента вызывают его игровые инструменты.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер Harness: один агент запускает другие сеансы Claude Code и Codex на вашем компьютере, ждет их, читает ответы и закрывает
LocalHarness запускает агентов на локальных моделях через vLLM, llama.cpp, Ollama или LM Studio, с YAML-агентами и проверкой прав
mi — агентный кодинг в 30 строках: цикл, два инструмента и модель; работает с любым API, совместимым с OpenAI, и в Docker.
Открытый кодовый агент для терминала, браузера и десктопа, который работает с моделями от OpenAI и Claude до Ollama
multi-agents запускает команду кодовых агентов на задаче и меряет, победила ли она одиночного агента и во что обошлась.
Agent Mesh связывает агентов, контейнеры и ноутбуки в частную сеть, где узлы публикуют инструменты и модели через MCP
Коротко о README
README рассказывает, что проект подключает LLM к серверу Minecraft, перечисляет возможности (модели, сессии, оболочка, команды, зрение), дает быстрый старт из трех шагов и ссылки на конфигурацию, инструменты и пример Bed Wars.