Digimon Engine
Multi-Agent, Multi-Player Framework для AI-нативных игр и метавселенных с агентами.
Это открытая игровая платформа, похожая на Unreal Engine, но для AI-игр. Digimon Engine поддерживает социальных и финансовых AI-агентов, позволяя создавать по-настоящему захватывающие игровые миры, где неигровые персонажи (NPC) ведут себя как живые существа — как в сериале «Мир Дикого Запада».
MCP-сервер
Digimon Engine предоставляет MCP-сервер для бесшовной интеграции с внешними клиентами, LLM и AI-агентами. Сервер объединяет архитектуры MCP-протокола, SDK DAMN.FUN и самого движка.
Ключевые компоненты:
- Hosts, Clients, Servers — модульная архитектура для масштабирования.
- Транспортные модели: STDIO (Standard Input/Output) + SSE (Server-Sent Events) — для общения в реальном времени.
- Язык и среда: TypeScript для логики MCP-сервера.
- Деплой: Docker — контейнеризация для запуска в любом окружении.
Архитектура движка
- Агенты: Каждый монстр/агент имеет уникальную личность и мотивацию. Они свободно перемещаются, общаются и формируют отношения. Для долговременной памяти используется векторная база данных Pinecone — агенты помнят прошлые встречи.
- Игровой движок: Оркестратор планирует действия агентов, обрабатывает задачи
Run Agent Batch и управляет коллизиями. Когда пути двух монстров пересекаются, движок запускает диалог. После завершения задачи агенты снова доступны для планирования.
- Журнал событий: Ведётся неизменяемая запись всего происходящего — пути, временные метки разговоров, кто с кем говорил. Перед началом нового пути монстры сверяются с журналом, чтобы предсказать коллизии и инициировать диалог, если давно не общались.
- Память и векторная БД: После разговоров агенты создают векторные представления (embeddings) с помощью mxbai-embed-large. Эти векторы используются для подстановки контекста в следующие промпты.
- Сжатое состояние (HistoryObject): Для низкой задержки и плавной анимации каждый тик (~60/с) логируются числовые поля, а в конце шага (1/с) сохраняется сжатый буфер истории. Клиент получает как текущие значения, так и буфер — анимация идёт без рывков.
- Собственный движок: Вместо Unity или Godot используется кастомный AI-native движок на TypeScript. AI-агенты и реальные игроки равны — никаких NPC второго сорта. Каждый тик движок обновляет весь мир в памяти, давая AI ту же свободу действий, что и людям.
Рабочий цикл:
- Планировщик периодически запускает шаг симуляции.
- Движок загружает данные из БД в память.
- AI-агенты и игроки отправляют действия — единый цикл обработки.
- После применения правил вычисляется «разница» (diff) и сохраняется в БД.
Подробнее — Архитектура.
Быстрый старт
Предварительные требования
Установка
# Клонируйте репозиторий
git clone https://github.com/CohumanSpace/digimon-engine.git
cd digimon-engine
# Установите зависимости
npm install
# Запустите MCP-сервер (режим разработки)
npm run dev
Конфигурация
Для работы с MCP-сервером необходимо указать переменные окружения (создайте файл .env в корне проекта):
# Пример минимальной конфигурации
OPENAI_API_KEY=your_openai_api_key
PINECONE_API_KEY=your_pinecone_api_key
PINECONE_ENVIRONMENT=your_pinecone_env
Полный список опций — в документации.
Пример использования
После запуска MCP-сервера вы можете подключиться к нему через любой MCP-клиент (например, Claude Desktop или свой инструмент).
Запрос на создание агента:
{
"method": "create_agent",
"params": {
"name": "DigiMonster",
"personality": "playful",
"memory_type": "persistent"
}
}
Ответ:
{
"result": {
"agent_id": "monster_12345",
"status": "spawned",
"world_position": {"x": 10, "y": 20}
}
}
Сервер также предоставляет REST API и webhooks для внешнего управления агентами, владения и подключения кошельков. Подробные примеры — в документации.
Сообщество и поддержка
Контрибьюторы
Благодарим всех, кто помогает развивать проект! Список участников — на странице контрибьюторов.
Digimon Engine — это открытая платформа, и мы рады любой помощи. Присоединяйтесь к созданию следующего поколения AI-игр!
Комментарии
Комментариев пока нет. Будьте первым.