Запускает LLM-агентов в Minecraft в роли игроков через Mineflayer: с сохранением сессий, отдельными shell-песочницами и командами из нескольких агентов.
mindcraft-bots/mindcraft
Minecraft-боты на Mineflayer под управлением LLM: каждый агент играет в игру и может общаться с игроками.
- Звёзды
- 5,972
- Форки
- 985
- Открытые issues
- 63
- Последний коммит
- 11 дней назад
Что это?
Mindcraft — фреймворк для запуска ИИ-агентов в Minecraft Java Edition. Он подключает большую языковую модель к боту на Mineflayer, чтобы агент мог воспринимать игровой мир, общаться с игроками и выполнять игровые действия, например собирать ресурсы и создавать предметы.
Агенты настраиваются с помощью JSON-профилей, в которых задаются модель для чата, отдельная модель для кода, необязательная модель для обработки изображений, параметры эмбеддингов и голоса, а также промпты и примеры, задающие характер агента. Проект поддерживает множество LLM-провайдеров, включая OpenAI, Gemini, Anthropic, DeepSeek и локальные модели через Ollama. Можно запустить бота в мире по LAN на localhost или подключить его к онлайн-серверам с помощью учётной записи Microsoft. Также в проекте есть средство запуска задач с заранее заданными целями.
По умолчанию генерация кода отключена, поскольку LLM может писать и выполнять код на вашем компьютере. В README рекомендуется запускать проект в Docker, прежде чем подключаться к удалённому серверу.
Ключевые возможности
- 01Подключает LLM к ботам на Mineflayer, которые играют в Minecraft Java Edition.
- 02Поддерживает множество провайдеров моделей, включая OpenAI, Gemini, Anthropic, DeepSeek и Ollama.
- 03Позволяет назначать отдельные модели для чата, написания кода, обработки изображений и эмбеддингов.
- 04Запускает заранее заданные задачи с целями по инвентарю и другим параметрам через JSON-файл задачи.
- 05Позволяет одновременно запускать несколько агентов, используя отдельные файлы профилей.
Сценарии использования
- Исследование взаимодействия нескольких LLM-агентов в игровой среде с воплощённым агентом.
- Эксперименты с поведением разных LLM в роли игровых персонажей.
- Создание сценарных или целевых задач в Minecraft для оценки работы агентов.
- Запуск Minecraft-агентов на локальных моделях через Ollama без внешних API-вызовов.
Быстрый старт
- 1
Установите Node.js (рекомендуется v18 или v20 LTS)
- 2
Скачайте последнюю версию или клонируйте репозиторий
- 3
Переименуйте keys.example.json в keys.json и добавьте API-ключ
- 4
Установите зависимости из каталога проекта
npm install
Что важно знать
- Требуется API-ключ поддерживаемого провайдера LLM; по умолчанию используется OpenAI.
- Требуется установленная Minecraft Java Edition; поддерживаются версии до v1.21.11 включительно.
- При включённой функции написания кода LLM может писать и запускать код на вашем компьютере, поэтому с этой настройкой не следует подключаться к публичным серверам.
В подборках
Темы
Частые вопросы
- Что такое mindcraft?
- Minecraft-боты на Mineflayer под управлением LLM: каждый агент играет в игру и может общаться с игроками. Mindcraft — фреймворк для запуска ИИ-агентов в Minecraft Java Edition. Он подключает большую языковую модель к боту на Mineflayer, чтобы агент мог воспринимать игровой мир, общаться с игроками и выполнять игровые действия, например собирать ресурсы и создавать предметы.
- mindcraft можно использовать бесплатно? Какая у него лицензия?
- mindcraft распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- mindcraft всё ещё поддерживается?
- Активно поддерживается. Последний коммит в mindcraft — 27 окт. 2026 г..
- Для чего можно использовать mindcraft?
- Исследование взаимодействия нескольких LLM-агентов в игровой среде с воплощённым агентом. Эксперименты с поведением разных LLM в роли игровых персонажей. Создание сценарных или целевых задач в Minecraft для оценки работы агентов. Запуск Minecraft-агентов на локальных моделях через Ollama без внешних API-вызовов.
- Как установить mindcraft?
- Установите Node.js (рекомендуется v18 или v20 LTS) Скачайте последнюю версию или клонируйте репозиторий Переименуйте keys.example.json в keys.json и добавьте API-ключ Установите зависимости из каталога проекта: npm install
- Где скачать mindcraft?
- Исходный код и инструкции по установке — на GitHub: https://github.com/mindcraft-bots/mindcraft
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Unity ML-Agents Toolkit превращает игры и симуляции на Unity в среды для обучения ИИ-агентов с помощью обучения с подкреплением и имитационного обучения.
JavaScript API для создания Minecraft-ботов, которые могут подключаться к серверам, перемещаться, копать, создавать предметы, общаться и взаимодействовать с миром.
Веб-панель для нескольких пользователей: развертывание и управление серверами Minecraft и Steam на нескольких машинах, в Docker или как отдельными процессами.
Мультимодальная модель с открытыми весами и 9 млрд параметров для визуального понимания, пространственных рассуждений, использования инструментов и исследований embodied AI, построенная на Qwen3.5 и C-RADIOv4-H.
Фреймворк для обучения LLM, VLM, диффузионных моделей и моделей с воплощённым интеллектом на NVIDIA GPU и Kunlun XPU, построенный на Megatron-LM и нативных для torch бэкендах.