Repolode
rehan-remade

rehan-remade/universal-modder

Набор навыков, CLI-инструментов и MCP-сервер, с помощью которых AI-агенты для программирования могут исследовать и модифицировать принадлежащие вам игры для ПК, а также тестировать моды с ресурсами, созданными через fal.

Звёзды
8,461
Форки
934
Открытые issues
26
Последний коммит
12 часов назад

Что это?

Universal Modder предоставляет AI-агентам для программирования, таким как Claude Code, Codex, Cursor и Gemini CLI, рабочий процесс для модификации игр на ПК. Агент определяет путь установки игры, её движок и версию, выбирает способ модификации, изучает код игры, создаёт работающий мод и проверяет его в запущенной игре. В комплект входит CLI `um`: он сканирует установки игр, создаёт спрайты, 3D-модели и аудио через fal, захватывает окна и звук, а также монтирует демонстрационные видео.

Проект поддерживает множество семейств движков, в том числе Unity, Unreal, .NET/XNA, Godot, Minecraft, Age of Empires II и игры Bethesda, а также инструменты обратной разработки, такие как ILSpy, Ghidra и Frida. Навыки агентов следуют заданному циклу: поиск существующих заметок, разведка, резервное копирование сохранений, создание одного небольшого фрагмента мода, генерация ресурсов, проверка и фиксация результатов. Агенты также могут добавлять полевые заметки в общую базу знаний в репозитории.

Проект не допускает внедрения в сетевые игры с античитом и читерства против других игроков; игровые файлы и декомпилированный код в него никогда не входят. Для настройки нужны Git, Python 3.10+ и ffmpeg, а для генерации ресурсов — API-ключ fal.

Ключевые возможности

  • 01Сканирует установки Steam, Epic и Xbox, чтобы определить движок, версию и наличие античита.
  • 02Предоставляет агентам навыки для обратной разработки, разведки, генерации ресурсов и тестирования в игре.
  • 03Создаёт спрайты, 3D-модели, текстуры и аудио через fal.
  • 04Захватывает игровые окна и только игровой звук; отправлять ввод можно только в окно игры.
  • 05Создаёт резервные копии папок с сохранениями перед изменениями; проверка перед публикацией блокирует добавление игровых файлов.

Сценарии использования

  • Добавление новых видов оружия или врагов в мод для Terraria с помощью спрайтов, созданных ИИ.
  • Создание новой цивилизации или юнита для Age of Empires II DE.
  • Запись и монтаж демонстрационного видео готового игрового мода.
  • Поиск информации о том, модифицировали ли игру раньше и какой движок в ней используется.

Быстрый старт

  1. 1

    Установите um CLI с помощью uv

    uv tool install git+https://github.com/rehan-remade/universal-modder
  2. 2

    Сохраните ключ API fal (необязательно, для генерации ресурсов)

    um fal key set
  3. 3

    Установите навыки в свой ИИ-агент для программирования

    npx skills add https://github.com/rehan-remade/universal-modder

Что важно знать

  • Модифицируются только принадлежащие вам игры для ПК; в README агентам также рекомендуется не использовать читы против других игроков.
  • Для генерации ресурсов нужен платный ключ API fal, ключ Sprixen для спрайтов или локальный сервер ComfyUI.
  • Для рендеринга спрайтов из 3D-моделей нужен Blender, а управление играми для Windows выполняется нативно или через WSL.

Темы

Частые вопросы

Что такое universal-modder?
Набор навыков, CLI-инструментов и MCP-сервер, с помощью которых AI-агенты для программирования могут исследовать и модифицировать принадлежащие вам игры для ПК, а также тестировать моды с ресурсами, созданными через fal. Universal Modder предоставляет AI-агентам для программирования, таким как Claude Code, Codex, Cursor и Gemini CLI, рабочий процесс для модификации игр на ПК. Агент определяет путь установки игры, её движок и версию, выбирает способ модификации, изучает код игры, создаёт работающий мод и проверяет его в запущенной игре. В комплект входит CLI `um`: он сканирует установки игр, создаёт спрайты, 3D-модели и аудио через fal, захватывает окна и звук, а также монтирует демонстрационные видео.
universal-modder можно использовать бесплатно? Какая у него лицензия?
universal-modder распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
universal-modder всё ещё поддерживается?
Активно поддерживается. Последний коммит в universal-modder — 19 окт. 2026 г..
Для чего можно использовать universal-modder?
Добавление новых видов оружия или врагов в мод для Terraria с помощью спрайтов, созданных ИИ. Создание новой цивилизации или юнита для Age of Empires II DE. Запись и монтаж демонстрационного видео готового игрового мода. Поиск информации о том, модифицировали ли игру раньше и какой движок в ней используется.
Как установить universal-modder?
Установите um CLI с помощью uv: uv tool install git+https://github.com/rehan-remade/universal-modder Сохраните ключ API fal (необязательно, для генерации ресурсов): um fal key set Установите навыки в свой ИИ-агент для программирования: npx skills add https://github.com/rehan-remade/universal-modder
Где скачать universal-modder?
Исходный код и инструкции по установке — на GitHub: https://github.com/rehan-remade/universal-modder

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Персональное хранилище контекста, которое помогает AI-агентам для написания кода — Codex, Claude Code и OpenCode — сохранять знания о проектах с помощью CLI, MCP-сервера и десктопного приложения.

1,3 тыс.84JavaScriptMITОбновлён 4 месяца назад