
mc_aiplayer: ИИ, который играет в Minecraft за вас
zoyluoblue/mc_aiplayer
Автономный ИИ-агент, который играет в Minecraft самостоятельно - серверный мод Fabric (MC 1.21.3), где LLM, совместимая с DeepSeek/OpenAI, управляет реальным игроком для добычи, строительства, земледелия, боя и выживания по командам на естественном языке. ИИ планирует, детерминированные задачи выполняются.
Посмотреть на GitHub ↗Хотели бы вы автоматизировать утомительные задачи Minecraft без написания собственного скрипта для каждой? mc_aiplayer - это мод Fabric, который создает реального серверного ИИ-игрока, способного понимать команды на естественном языке и автономно выполнять сложные многошаговые задачи, включая добычу, строительство, земледелие, боевые действия и выживание, без каких-либо жестко запрограммированных инструкций.
Что делает этот проект
mc_aiplayer - это серверный мод Fabric для Minecraft 1.21.3, который приносит в ваш мир автономного ИИ-агента. Вы даете ему задачу на простом английском - "добудь 3 алмаза" или "построй дом" - и встроенный в мод LLM (по умолчанию DeepSeek или любая совместимая с OpenAI модель) разбивает эту задачу на план, а затем выполняет его шаг за шагом. Это не клиентский мод и не читы, это настоящий поддельный игрок, который следует обычным правилам игры и взаимодействует с миром как настоящий человек.
Архитектура продумана. Вместо того, чтобы позволить ИИ галлюцинировать случайные действия в Minecraft (что было бы хаосом), система разделяет принятие решений и выполнение. LLM решает, *что* делать, выбирая из 62 встроенных инструментов, а детерминированный механизм задач обрабатывает *как* это делать надежно. Думайте об этом как о найме очень умного рабочего, который может понимать неясные инструкции и разбираться в деталях самостоятельно.
Написано на Java с 211 звёздами GitHub и лицензией MIT, оно предназначено для администраторов серверов и создателей модпаков, которые хотят автоматизации без компромиссов.
Когда это использовать
Практические случаи использования делятся на несколько категорий:
- Скучная добыча ресурсов. Скажите ему собрать 64 дубовых бревна или 5 стопок булыжника и вернитесь позже. Гринд камня для строительных материалов? Позвольте боту заняться этим, пока вы работаете над чем-то интересным.
- Отладка фермы мобов. Установите ферму, попросите ИИ встать в нее и собирать дропы при тестировании, действительно ли темпы приличные. Реальная проверка без скучного ожидания.
- Помощь при строительстве мира. Позвольте боту выполнять повторяющиеся задачи - выравнивание местности, строительство мостов, автоматизированную посадку урожая - чтобы вы могли сосредоточиться на дизайне и размещении.
- Автоматизация SMP-сервера. Если вы управляете сообществом на сервере, это открывает возможности для автоматических событий, генерации ресурсов или даже поведений, похожих на NPC, которые реагируют на команды игроков.
- Тестирование и создание контента. YouTubers и разработчики модпаков могут использовать это для быстрой демонстрации полных рабочих процессов или тестирования взаимодействия модов без ручного прохождения каждого шага.
Это не для игроков, ищущих способ AFK-майнинга, пока игра играет сама за себя (это противоречит смыслу Minecraft). Это для людей, которые хотят, чтобы игра обрабатывала конкретные дела, чтобы они могли сосредоточиться на творческой или стратегической части.
Как это работает изнутри
Здесь mc_aiplayer становится интересным. Когда вы издаете команду, LLM получает вашу цель и текущее состояние мира бота (соседние блоки, инвентарь, здоровье и т.д.), а затем использует вызовы инструментов для выбора из 62 предопределенных задач: добыча камня, создание стола, размещение блока, разведение животных и так далее. LLM не генерирует произвольные действия, он работает в рамках ограниченного набора инструментов, что обеспечивает стабильность.
Как только LLM спланирует последовательность, отдельный исполнитель задач пройдет через нее. Так что если ваша команда была "построй дом", план может быть: собрать 50 древесины - изготовить доски - изготовить деревянную кирку - добыть камень - изготовить стол верстака - разместить блоки прямоугольником - добавить крышу. Каждый шаг надежен, потому что исполнитель *знает*, как это делать, ИИ просто решил порядок и контекст.
Мод включает пять уровней безопасности, чтобы помешать боту застрять или умереть глупо: он отслеживает здоровье, логирует ошибки, повторяет неудачные задачи, знает, когда он запутался, и может попросить помощь у человека, если что-то пойдет серьёзно неправильно. Вы также можете настроить, к каким инструментам он имеет доступ, ограничив его конкретными задачами, если хотите более плотного контроля.
И поскольку это серверная часть, нет инъекции клиента, нет риска VAC на ограниченных серверах (хотя вы должны проверить условия вашего сервера), и несколько игроков могут сосуществовать с ботом в одном мире.
Установка и настройка
Здесь я должен быть честен: mc_aiplayer - это технический проект, предназначенный для администраторов серверов, а не для случайных игроков. Если вы никогда не устанавливали мод Fabric раньше, это будет кривой обучения.

Что вам понадобится:
- Сервер Minecraft, работающий на Fabric loader 0.18.4+ версии 1.21.3
- Java 21, установленная на сервере
- API-ключ от DeepSeek, OpenAI или совместимого поставщика LLM
- Базовый комфорт с командной строкой
Фактическая установка проста, если у вас уже есть Fabric: загрузите JAR-файл mc_aiplayer с выпусков GitHub, бросьте его в папку `mods/` вашего сервера, перезагрузитесь и настройте учетные данные API вашего LLM в файле конфигурации мода. README проходит через это, и мод генерирует конфигурацию по умолчанию при первом запуске.
После запуска вы будете взаимодействовать с ботом через команды в игре. Что-то вроде:
/aibot brain say Bob mine 3 diamondsЭто говорит боту (по прозвищу "Bob" по умолчанию) выяснить и выполнить добычу 3 алмазов. Бот оценит свою текущую ситуацию, спланирует последовательность и приступит к работе. Честно говоря, вы также можете попросить его проверить свой инвентарь, остановиться или сообщить статус в процессе выполнения задачи.
Удаление чистое: Удалите JAR-файл мода, перезагрузите сервер, и вы вернетесь к ванили. Постоянных изменений в ваш мир или конфиги.
Что создает трудности людям
Несколько ловушек, о которых стоит знать:
Задержка LLM и затраты. Каждая команда отправляет запрос к DeepSeek или OpenAI (или выбранному вами поставщику), что занимает несколько секунд и влечет расходы API. Если вы выполняете десятки команд ежедневно, следите за своим счетом. DeepSeek более доступен, чем GPT-4, что стоит учитывать.
Бот не имеет телепатии. Если он не может видеть ресурс, который ему нужен, он не будет волшебным образом знать, где его найти. "Добудь 64 алмаза" работает, потому что алмазы следуют предсказуемому распределению, "найди мой потерянный дом" не будет работать, если вы не дадите ему больше контекста.
Команды из нескольких слов требуют тщательного формулирования. "Добудь 3 алмаза" работает. "Пойди найди алмазы и принеси их назад" более расплывчато и может не выполниться как запланировано. LLM будет пытаться, но специфичность всегда помогает.
Производительность сервера немного страдает, пока бот активен (это еще один игрок, работающий с поиском пути и взаимодействиями), поэтому на сильно загруженных серверах вы можете заметить задержки. Не катастрофические, но стоит протестировать сначала на вашем оборудовании.
Если API LLM выходит из строя или ваши учетные данные неправильны, бот полностью останавливается. Нет откатов на запрограммированное поведение - он просто ждет или выдает ошибку. Убедитесь, что ваши учетные данные API правильны во время настройки.
Что это не является (и что он не может делать)
mc_aiplayer мощный, но имеет реальные ограничения. Он не может надежно сражаться с Withером или Ender Dragon - не потому что он неспособен, а потому что эти бои хаотичны и модель восприятия бота имеет ограничения. Результат может добывать, строить и фармить весь день, но набеги на боссов? Пока нет.
Он также не понимает возникающую игру. Вы не можете попросить его "получать удовольствие от исследования" или "создавать крутую постройку" без более структурированных инструкций. Это инструмент для автоматизации известных задач, а не творческий сотрудник (по крайней мере, пока нет).
И если вы ищете способ сделать AFK-майнинг забавным или легитимным на PvP-сервере с анти-читом, это не то. Многие серверы имеют плагины, которые обнаруживают поведение бота, и использование этого без разрешения приведет к блокировке. Сначала проверьте правила вашего сервера. Даже если это серверная часть и технически легитимное, не все это разрешают.
Альтернативы, о которых стоит знать
Если mc_aiplayer вам не подходит, несколько других проектов решают похожие задачи. Carpet mod имеет систему поддельных игроков, которую вы можете программировать с помощью определенных команд, но требует изучения языка домена Carpet - менее гибкий, чем естественный язык, но более стабильный. Есть также Malilib и другие инструменты автоматизации со стороны клиента, хотя они сопровождаются большей совместимостью с серверами. И для чистого гринда ресурсов дизайны ванильных ферм и гриндеры мобов всегда будут превосходить любого бота (иногда самое простое решение лучше).
Но если вы хотите ИИ, который понимает естественный язык и может адаптироваться к новым задачам без изменения кода, mc_aiplayer действительно уникален.
Прежде чем начать, убедитесь, что ваша версия Minecraft актуальна. Мы рассмотрели другие серверные утилиты, такие как наш Minecraft Server Status Checker и инструменты, такие как Nether Portal Calculator, если вы управляете серверной инфраструктурой.
Lead writer at minecraft.how. Long-time Minecraft player running a small SMP server, testing every build, mod, and seed before writing about it.


