yc-software/minecraft-agent-harness

Что это?

Ключевые возможности

• 01Подключает Claude, GPT, Gemini, OpenRouter или любой эндпоинт с поддержкой OpenAI Responses API.
• 02После перезапуска агент продолжает с прежней сессии, если использует то же имя.
• 03Предоставляет каждому агенту shell на базе E2B, Docker или локальной папки.
• 04Позволяет задавать команды из нескольких агентов в одном JSON-файле и обмениваться личными сообщениями.
• 05Включает конфигурацию Docker Compose с сервером Paper.

Сценарии использования

• Эксперименты с LLM-агентами, действующими в мире Minecraft.
• Запуск команды ИИ-игроков, координирующих действия через чат.
• Тестирование поведения агентов в таких играх, как Bed Wars, с судьёй.
• Изучение того, как агенты используют shell-песочницы для написания скриптов, вызывающих игровые инструменты.

Быстрый старт

1. 1

   Установите зависимости

   npm ci
2. 2

   Скопируйте файл env и добавьте API-ключ провайдера моделей

   cp .env.example .env
3. 3

   Запустите сервер Minecraft для разработки (требуется Java 21)

   npm run server
4. 4

   В другом терминале запустите агента, указав цель

   npm start -- --objective "Gather wood and build a small shelter near spawn"

Что важно знать

• !Требуются Node 22.19 или новее, API-ключ провайдера моделей и сервер Minecraft.
• !По умолчанию оболочка агента работает в локальной папке, а команды выполняются с правами вашего пользователя. Исключение — если доступен Docker или E2B либо передан параметр --sandbox none.
• !Поддержка изображений находится в экспериментальной стадии.
• !Проект молодой, у него всего 100 звёзд, поэтому возможны недоработки.

В подборках

Темы

Частые вопросы

Что такое minecraft-agent-harness?

Запускает LLM-агентов в Minecraft в роли игроков через Mineflayer: с сохранением сессий, отдельными shell-песочницами и командами из нескольких агентов. minecraft-agent-harness подключает языковую модель к серверу Minecraft, чтобы она могла играть как обычный игрок. Действия — ходьба, добыча ресурсов, крафт, строительство, сражения и общение в чате — выполняются через Mineflayer, а сессией модели управляет pi. Поддерживаются Claude, GPT, Gemini, OpenRouter и любые эндпоинты с поддержкой OpenAI Responses API.

minecraft-agent-harness можно использовать бесплатно? Какая у него лицензия?

minecraft-agent-harness распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

minecraft-agent-harness всё ещё поддерживается?

Активно поддерживается. Последний коммит в minecraft-agent-harness — 29 окт. 2026 г..

Для чего можно использовать minecraft-agent-harness?

Эксперименты с LLM-агентами, действующими в мире Minecraft. Запуск команды ИИ-игроков, координирующих действия через чат. Тестирование поведения агентов в таких играх, как Bed Wars, с судьёй. Изучение того, как агенты используют shell-песочницы для написания скриптов, вызывающих игровые инструменты.

Как установить minecraft-agent-harness?

Установите зависимости: npm ci Скопируйте файл env и добавьте API-ключ провайдера моделей: cp .env.example .env Запустите сервер Minecraft для разработки (требуется Java 21): npm run server В другом терминале запустите агента, указав цель: npm start -- --objective "Gather wood and build a small shelter near spawn"

Где скачать minecraft-agent-harness?

Исходный код и инструкции по установке — на GitHub: https://github.com/yc-software/minecraft-agent-harness