PlayerEngine

PlayerEngine — это серверный фреймворк, предназначенный для изменения взаимодействия ИИ-NPC с миром Minecraft, предоставляя им возможности, доступные игрокам.

PlayerEngine — это мощный инструментарий для разработчиков, позволяющий выйти за рамки простых чат-ботов и создавать полноценных агентов. Вместо того чтобы просто имитировать диалог, моды на базе этого фреймворка могут добывать ресурсы, сражаться, управлять инвентарем и взаимодействовать с миром на уровне игрока.

В основе PlayerEngine лежит идея того, что «быть игроком» — это не тип сущности, а набор способностей, которые можно прикрепить к любому мобу. Реализуя несколько простых интерфейсов, кастомная сущность получает доступ к ключевым механикам:

• Постоянный инвентарь, аналогичный игровому (LivingEntityInventory).
• Возможность взаимодействия с миром: разрушение блоков и использование предметов (LivingEntityInteractionManager).
• Продвинутая навигация и выполнение задач через движок Automatone.

Это делает проект идеальным «активатором» для ИИ-мозгов, таких как Player2 API. Если языковая модель (LLM) принимает решение о действии, PlayerEngine предоставляет NPC «тело» для его выполнения.

Фреймворк спроектирован специально для мододелов, чтобы они могли давать своим уникальным творениям реальную автономию, а не просто менять их внешний вид.

• ⛏️ Настоящее взаимодействие с миром: NPC могут добывать блоки, использовать инструменты и взаимодействовать с объектами. (Примечание: сложная постройка конструкций пока не поддерживается).
• 🎒 Игровой инвентарь: каждый агент управляет собственным постоянным инвентарем, что позволяет реализовывать сложные системы сбора ресурсов, крафта и управления инструментами.
• 🧠 Бесшовная интеграция с Player2: проект является физическим противовесом Player2 API. Вы можете отправлять высокоуровневые команды, такие как @get diamond 5, и агент будет самостоятельно выполнять цепочку задач для достижения цели.
• 🛠️ Надежный фундамент: навигация построена на Automatone (форке Baritone), система задач адаптирована из ChatClef, а модульность обеспечивается через Cardinal Components для высокой совместимости.

PlayerEngine — это не просто временный эффект, а инструмент для глубокой системной интеграции. NPC перестают быть просто датерами квестов и становятся активными участниками экономики, экологии и динамических историй мира.

Фреймворк служит защитными механизмами (guardrails): он обеспечивает детерминированный слой действий на основе игровой логики, который надежно исполняет высокоуровневые цели от LLM, включая отказоустойчивые сценарии и понимание игрового мира.

Идейным вдохновением послужил мод ChatClef, который соединял ИИ с клиентом игрока. Однако он требовал запуска нескольких экземпляров клиента для работы ИИ-спутников, что было неудобно и не масштабируемо. PlayerEngine решает эту проблему, перенося логику на сервер и отделяя способности игрока от самого класса PlayerEntity.

Требования проверенного файла

• По манифесту для файла playerengine-neoforge-1.21.1-1.4.0.jar (Minecraft 1.21.1; NeoForge) требуется architectury.