Universal Modder: набор скиллов и утилит для моддинга игр
📂 Исходный код на GitHubПлагин для Claude Code с девятью скиллами, CLI `um` на Python и MCP-сервером fal. Разведка установленных игр, определение движка, разбор кода, генерация графики и звука, проверка мода в живой игре, запись видео и упаковка релиза.
Universal Modder — это плагин для Claude Code, который добавляет в него девять скиллов, CLI на Python и MCP-сервер fal. Задача у набора одна: помочь Claude Code сделать мод к почти любой PC-игре, которая у вас уже куплена. Агент сам находит игру, определяет её движок и подходящий способ модификации, читает настоящий код игры, генерирует графику, 3D и звук через fal, проверяет результат в запущенной игре и собирает видео с демонстрацией мода.
Сразу оговорка: это не сервис и не инструмент для онлайн-игр. Набор работает только с одиночными играми и требует, чтобы игра была вашей.
Что внутри
Скиллы
Девять скиллов лежат в папке skills/. Каждый отвечает за свой этап работы.
| Скилл | Что делает |
|---|---|
mod-any-game |
Основной цикл работы, жёсткие правила безопасности и 12 подробных инструкций по движкам: Unity, Unreal, .NET/XNA (Terraria, Stardew, Celeste), Godot, Source 1 и 2, Bethesda, Minecraft, AoE2 и Genie, RE Engine и игры FromSoft, GTA, Cyberpunk, BG3, нативный C++, инди-движки (GameMaker, RPG Maker, Ren'Py, Paradox, Doom, HTML5, LÖVE, Java), а также ретрой-декомпиляции |
game-recon |
Определяет движок и версию, управляемый код или нативный, античит, загрузчики, папки с сохранениями и Community-путь. На выходе — файл MODDING_PLAN.md |
reverse-engineering |
Работа с ILSpy, Cpp2IL, Vineflower, Ghidra и IDA через MCP, с Cheat Engine, Frida и RenderDoc. Формат файла разбирается на части и проверяется обратной сборкой |
fal-assets |
Спрайты с настоящей прозрачностью, согласованные варианты, пиксель-арт, бесшовные текстуры, PBR-карты, картинка в 3D, автоматическая сборка скелета, звуки, музыка, озвучка и видео для катсцен |
asset-pipeline |
Готовая картинка превращается в кадры, готовые для движка: вырезание фона, подгонка, палитры, атласы, маски командных цветов, 3D в 8 или 16 ракурсов |
game-automation |
Запуск игры, скриншоты без нагрузки на видеокарту, клики и ввод текста, оконный режим, уборка краш-репортеров, мосты для агента внутрь игры |
showcase-video |
Запись окна игры вместе только с её звуком, выбор удачных моментов и нарезка оформленного видео |
mashup-mods |
Игра внутри игры: перенос контента, сквозные моды, декомпиляции как библиотеки, полные переписывания |
publish-mod |
Проверка качества, упаковка под каждую платформу, список благодарностей и текст публикации |
CLI um
Вторая часть набора — команда um на Python. У каждой команды есть --help с примерами.
| Команда | Что делает |
|---|---|
um scan |
Находит установки Steam, Epic и Xbox, определяет движок и версию, от managed-кода к нативному, античит, установленные загрузчики, папки с сохранениями. Возвращает отсортированный список путей |
um fal |
Обёртка над fal по обычному REST: sprite, image, edit, rmbg, pixelate, upscale, texture, pbr, model3d, rig, sfx, music, voice, video, run, search, schema, price. Каждая генерация попадает в манифест |
um sprite |
Работа со спрайтами: cutout, fit, pixelate, palette, sheet, slice, frames, team-mask, seamless, preview |
um render3d |
Превращает GLB в кадры спрайтов через Blender с ракурсом камеры игры: aoe2, iso8, trueiso, topdown, side, turntable |
um win |
Работа с Windows: shot, record через gfxcapture и process-loopback, drive для ввода, который долетит только до игры, ps, kill, launch, reg |
um video |
Листы контактов, сборка видео из EDL с музыкой, склейка, поиск долей и первый кадр |
um backup |
Снимок, сравнение и восстановление папок с сохранениями |
um publish check |
Не даёт выпустить файлы игры, декомпилированный код и утёкшие ключи |
Остальное
В набор входят MCP-сервер fal из файла .mcp.json (он обращается к https://mcp.fal.ai/mcp по вашему ключу), хук на старте сессии, который добавляет um в PATH, и две утилиты для Windows в папке tools/win/. Утилитам не нужна сборка — это PowerShell со встроенным C#. Одна отправляет ввод в игру, вторая записывает звук только игрового процесса.
Как проходит работа
Агент начинает со скилла mod-any-game и каждый раз проходит один и тот же цикл: разведка, выбор пути, безопасная лаборатория с резервными копиями сохранений, чтение настоящего кода, сборка одного рабочего куска, генерация ресурсов, проверка в живой игре, запись и упаковка.
Запросы выглядят по-разному, а цикл всё равно один и тот же:
Сделай мод для Terraria: добавь установку самонаводящихся ракет и тактическую ядерную бомбу, которая оставляет воронку в мире. Спрайты сделай через fal.
Сделай новую цивилизацию для Age of Empires II с уникальным юнитом, отрисованным из 3D.
У меня есть Skyrim SE. Что нужно, чтобы добавить туда режим строительства из блоков в духе Minecraft?
Какой движок у игры по пути
C:\Games\Fooи как её обычно модифицируют?
Отдельный скилл game-recon отвечает на последний вопрос и пишет результат в MODDING_PLAN.md.
Что нужно, чтобы начать
Рекомендуемый способ — поставить плагин в Claude Code:
/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modderВторой способ — клонировать репозиторий и запустить Claude внутри папки:
git clone https://github.com/rehan-remade/universal-modder && cd universal-modder && claudeДальше нужен ключ fal API из личного кабинета. Он нужен и MCP-серверу, и команде um fal:
export FAL_KEY=...Из остальных требований: Python 3.10 или новее и ffmpeg. Разработчики советуют uv — CLI сам поднимает своё окружение. Blender нужен, чтобы превращать 3D в спрайты. Windows-игры можно запускать нативно или из WSL.
Через файл AGENTS.md набор работает и с Codex и Cursor.
Моды, собранные на нём
В репозитории лежат два готовых примера. Оба начинались с запроса в одну строку.
- examples/terraria-tmodloader — мод «Fal Arsenal» для tModLoader. Установка самонаводящихся ракет, тактическая ядерная бомба с воронкой и грибным облаком, винтовка с цепной молнией, пушка с чёрной дырой, орбитальный удар, три новых врага и босс с двумя фазами. Все спрайты сделаны через fal.
- examples/aoe2-de-civ — мод «San Franciscans» для Age of Empires II DE. Новая цивилизация с уникальным юнитом-роботакси и дронами-доставщиками, отрисованными из 3D-моделей fal под ракурс камеры AoE2. Плюс чудо-строение в виде пирамиды Трансамерика и собственный писатель спрайтов
.sld, разобранный обратной разработкой.
Неочевидные выводы из этих двух работ авторы записали в case-studies.md.
Правила, которые он соблюдает
Автор вынес правила в отдельный файл safety.md. Главное из него:
- Только одиночные игры и офлайн, на ваших копиях. Набор отказывается внедряться в онлайн-игры с античитом, писать читы для мультиплеера и обходить античит, DRM или проверку владения.
- Никогда не публикует файлы игры и декомпилированный код. В релиз идут ваш код, ваши ресурсы, патчи и конвертеры.
- Сначала резервная копия. Сохранения бэкапятся перед любым запуском с модом, а процессы завершаются строго по числовому идентификатору.
- Спрашивает заранее. Перед управлением мышью и клавиатурой, установкой загрузчиков в папку игры и публикацией.
Формулировка «спрашивает заранее» здесь важна: WinDrive отправляет ввод только когда игра на переднем плане, а долгие автоматические серии нужно согласовать отдельной командой.
Кому это пригодится
Набор подойдёт тем, кто модифицирует одиночные игры и хочет отдать подготовку агенту: поиск движка и загрузчика, разбор бинарников, генерация спрайтов и звука, проверка в живой игре. Отдельно он полезен тем, кто делает графику для модов: fal-assets и asset-pipeline закрывают путь от картинки до кадров, готовых для движка.
Нужен Claude Code или другой coding-агент, который читает AGENTS.md, своя копия игры, Python с ffmpeg и ключ fal. Лицензия — MIT, условия в файле LICENSE. Шрифты в проекте — Space Grotesk и JetBrains Mono под SIL OFL.