Автоматизация всего цикла: от реверс-инжиниринга до видео
Проект Universal Modder — это не просто плагин, а полноценная экосистема, превращающая AI-кодингагентов в автономных моддеров. Система работает по замкнутому циклу: агент находит игру, определяет движок, читает реальный код, строит мод, генерирует 3D/2D-ассеты через fal, тестирует их в запущенной игре, записывает видео и, что критически важно, сохраняет знания для следующих итераций.
Проект поддерживает интеграцию с Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot и OpenCode. Установка осуществляется через стандартные маркетплейсы плагинов или CLI-инструмент um (на Python). Для работы требуется Python 3.10+, ffmpeg, Blender (для 3D→спрайт рендера) и API-ключ fal.
База знаний «AI для AI»
Главная инновация — система field notes (полевых заметок). Когда агент успешно модифицирует игру, он записывает в базу знаний knowledge/ точные версии, выбранный маршрут реверс-инжиниринга, ошибки и способы их решения. Следующий агент не начинает с нуля, а использует эти данные, избегая повторных ошибок. Это создает самообучающуюся базу опыта по взлому и модификации игр.
Технический стек и навыки
Проект использует формат Agent Skills и включает 12 готовых «плейбуков» для популярных движков: Unity, Unreal, Godot, Source 1/2, Bethesda, RE Engine, а также нативных C++ и инди-движков. Для реверс-инжиниринга применяются ILSpy, Cpp2IL, Ghidra, IDA и Frida. Генерация ассетов (спрайты, PBR-карты, 3D-модели, звук) делегируется серверу fal MCP.
| Компонент | Функция | Примеры использования |
|---|---|---|
| mod-any-game | Основной цикл моддинга и безопасность | Работа с Unity, Unreal, Godot, Source, Bethesda, RE Engine |
| game-recon | Разведка и планирование | Поиск анти-читов, загрузчиков, папок сохранений, создание MODDING_PLAN.md |
| reverse-engineering | Декомпиляция и анализ | ILSpy, Cpp2IL, Ghidra, Cheat Engine, Frida, RenderDoc |
| fal-assets | Генерация контента | Спрайты с прозрачностью, 3D→2D, SFX, музыка, озвучка, видео |
| game-automation | Управление игрой | Запуск, скриншоты (GPU-safe), ввод (клавиатура/мышь), очистка краш-репортов |
| mashup-mods | Пасхальные яйца и порты | Внедрение Minecraft в GTA V, обмен камерой и событиями через WebSocket |
Реальные кейсы и безопасность
В репозитории представлены три демонстрационных мода:
- Terraria: Добавлены самонаводящаяся ракетница, тактическая ядерная бомба (с кратером), цепная молния и черная дыра. Все спрайты сгенерированы через fal.
- Age of Empires II: Новая цивилизация «Сан-Францисканцы» с юнитами Robotaxi и Delivery Drones, а также чудом света Transamerica Pyramid. Юниты рендерятся из 3D-моделей.
- GTA V × Minecraft: Полноценный Minecraft внутри сюжетной кампании GTA V. Камеры синхронизированы, взрывы TNT из Minecraft вызывают взрывы машин в GTA, а мобы сражаются с полицией.
Проект строго соблюдает этические нормы: он работает только с офлайн-играми, которые пользователь купил сам. Агент отказывается инжектиться в онлайн-игры с анти-читами, не обходит DRM и не распространяет декомпилированный код или файлы игр. Все моды поставляются как код, патчи или конвертеры, а перед изменением сохранений делается бэкап.
Источник: Github ↗