Universal Modder: как пользоваться и во что обойдётся первый мод

Universal Modder — это не программа с окнами и кнопкой «сделать мод». Это открытый набор навыков (Agent Skills), утилита командной строки um, подключение к генератору ассетов fal и общая база заметок о моддинге конкретных игр. Всё это ставится внутрь ИИ-агента — Claude Code, Codex, Cursor, GitHub Copilot, OpenCode или Gemini CLI, — и дальше вы просто пишете агенту, какой мод хотите. Агент сам определяет движок, выбирает загрузчик модов, делает бэкап сохранений, пишет код, генерирует спрайты и проверяет результат в запущенной игре. Так это описано в README проекта на GitHub.

Перед установкой проверьте четыре условия:

• Платный агент. Сам Universal Modder бесплатный (лицензия MIT), но Claude Code требует подписку Claude Pro, Max, Team, Enterprise или оплату API через Console. Codex работает в лимитах тарифа ChatGPT или через стороннего API-провайдера. Путь с локальной моделью через OpenCode тоже есть, но он сложнее.
• Windows или WSL. Запуск игры, скриншоты, нажатия и запись видео (um win) работают только там. На macOS и Linux агент сможет анализировать игру и готовить файлы, но проверку в игре придётся делать вам.
• Своя копия игры: одиночный режим или ваш сервер. Онлайн-игры с античитом, обход DRM и игры не из вашей библиотеки инструмент не трогает.
• Ключ fal для графики и звука. Каждая генерация оплачивается отдельно. По ценам fal на 8 октября 2026 года 10 спрайтов с настройками по умолчанию стоят около $2,11, а на среднем качестве — около $0,53.

Если всё сходится, путь такой: установить плагин, проверить, что агент видит навык mod-any-game, и попросить одну маленькую фичу в игре с готовым загрузчиком модов, например в Terraria.

Что нужно до установки: агент, система, игра и ключ fal

Проект запустили 30 сентября 2026 года. Автор — Rehan Sheikh; по данным Post-Cutoff, в профиле X он указан как инженер fal, а генерация ассетов в проекте по умолчанию идёт через платный API fal. По состоянию на 8 октября 2026 года у репозитория около 5 400 звёзд, версия в pyproject.toml — 0.2.0, формальных релизов на GitHub нет, а изменения вливаются почти каждый день. Поэтому команды ниже стоит сверять с таблицей установки в README.

Какого агента выбрать для Universal Modder

Claude Code удобен тем, что основной навык вызывается явной командой /universal-modder:mod-any-game, и агент гарантированно идёт по сценарию плагина. Нужна подписка Pro, Max, Team, Enterprise или Console с оплатой API. Длинные сессии моддинга (разведка, декомпиляция, циклы тестов) быстро съедают лимиты, поэтому заранее посмотрите, что меняется в лимитах Claude Pro и Max.

Codex ставится так же просто и работает в лимитах тарифа ChatGPT или с ключом стороннего провайдера. Чем агенты отличаются в целом, разобрано в статье Claude Code vs Codex в 2026 году.

Gemini CLI по-прежнему есть в README, но с 18 июня 2026 года вход «Login with Google» для потребительских аккаунтов (Gemini Code Assist для частных лиц, Google AI Pro и Ultra) больше не даёт доступа к Gemini CLI. Этот путь подходит, только если у вас уже работает другой способ авторизации; подробности — в статье Gemini CLI отключён не для всех.

Локальные модели. Проверенный сопровождающим путь — OpenCode с локальным сервером LM Studio; про LM Studio Bionic он пишет, что «скорее всего, в основном будет работать», но сам это не проверял (issue #126). Качество здесь сильно зависит от модели.

Если подписку Claude или ChatGPT из России не оформить

Прямую подписку из России оформить сложно. Варианты без неё собраны в статье Claude Code бесплатно в 2026. Ещё один путь — запускать Universal Modder в Codex через API-провайдера с оплатой по токенам. Например, у laozhang.ai есть инструкция для Codex CLI: в ~/.codex/config.toml задаётся свой provider с base_url = "https://api.laozhang.ai/v1" и wire_api = "responses", ключ хранится в переменной окружения, рекомендованная модель — gpt-6-sol. Учтите три вещи: сколько токенов уходит на один мод, никто не измерял; насколько хорошо эта модель справляется с реверсом игр, тоже не проверено; Claude-моделей через этот путь сейчас нет. Общие правила подключения Codex к стороннему API — в статье Как подключить Codex к стороннему API.

Сколько стоит мод в Universal Modder: агент плюс генерации fal

Расходы складываются из двух частей, которые нельзя смешивать.

1. Агент. Подписка или токены модели. Плагин к тому же занимает место в контексте на каждом шаге: по документации Claude Code, имена и описания навыков включённого плагина попадают в контекст каждого хода, даже когда плагин не используется. Замеров, сколько токенов уходит на один мод, нет.
2. Ассеты fal. Каждая генерация списывается с баланса fal по цене конкретной модели.

Модели по умолчанию прописаны в коде um fal. Цены ниже взяты со страниц моделей fal по состоянию на 8 октября 2026 года; fal предупреждает, что цены могут меняться.

Пример расчёта по формуле «количество × цена за штуку» (без перегенераций и без стоимости агента):

• 10 спрайтов с настройками по умолчанию: 10 × $0,211 ≈ $2,11;
• те же 10 спрайтов с --quality medium: 10 × $0,053 ≈ $0,53; с low — около $0,06;
• 10 картинок Nano Banana 2 в 1K: 10 × $0,08 = $0,80;
• 30 секунд звуковых эффектов: 30 × $0,002 = $0,06.

Главная ловушка — качество по умолчанию: um fal sprite берёт high, и это в четыре раза дороже medium. Для черновиков прямо напишите агенту «спрайты на medium». Одна 3D-модель через um fal model3d с настройками по умолчанию стоит на fal $0,30 (по состоянию на 8 октября 2026 года), но перед пакетной 3D-генерацией всё равно сверьте цену командой um fal price fal-ai/trellis-2 или в личном кабинете fal. Перед любой дорогой генерацией можно просто попросить агента назвать цену — он проверит её через um fal price.

Какую игру выбрать для первого мода с Universal Modder

Лучше всего начинать с игр, у которых есть зрелый загрузчик модов: так агент быстрее придёт к рабочему результату. Это Terraria с tModLoader, Stardew Valley со SMAPI, Minecraft с Fabric и Unity-игры с BepInEx. В основном навыке есть 12 сценариев по движкам: Unity, Unreal, .NET/XNA, Godot, Source, Bethesda, Minecraft, Age of Empires II, RE Engine/FromSoft/GTA/Cyberpunk/BG3, нативный C++, инди-движки и ретро-декомпиляции.

До начала проверьте, моддил ли кто-нибудь вашу игру. Попросите агента выполнить um kb search "<название игры>" или откройте индекс базы знаний. По состоянию на 8 октября 2026 года там 78 заметок по играм и 50 по техникам. В каждой — версии, которые сработали, выбранный путь, способ проверки и подводные камни. Наличие заметки не гарантирует, что всё заработает на вашей версии игры, но экономит агенту часы разведки.

Даже для подходящей игры есть оговорки. tModLoader не запустится, пока бесплатное приложение tModLoader не добавлено в вашу библиотеку Steam. Агент не станет обходить эту проверку, он попросит добавить приложение. Для игр с VAC тесты идут только локально с параметром -insecure, а на публичные серверы с внедрённым модом заходить нельзя.

Как установить Universal Modder в Claude Code, Codex и другие агенты

Сначала поставьте зависимости. На Windows это удобно сделать через встроенный winget (команды из гайда VGTimes):

winget install --id Git.Git -e
winget install Python.Python.3.12
winget install astral-sh.uv
winget install Gyan.FFmpeg

Blender (winget install BlenderFoundation.Blender) нужен только для 3D. После установки закройте терминал, откройте новый и проверьте git --version, python --version, uv --version и ffmpeg -version.

Если Claude Code ещё не установлен, в PowerShell выполните irm https://claude.ai/install.ps1 | iex, а на macOS и Linux — curl -fsSL https://claude.ai/install.sh | bash. Создайте отдельную папку под моды, например C:\mods, откройте в ней терминал, запустите claude и войдите в аккаунт.

Команды установки плагина из README на 8 октября 2026 года:

В Claude Code на вопрос об области установки выберите User, чтобы плагин был доступен в любой папке. Если Claude Code попросит перезагрузить компоненты, выполните /reload-plugins. Если um нужен вне плагина, поставьте его отдельно: uv tool install git+https://github.com/rehan-remade/universal-modder.

Ключ fal создаётся в кабинете fal после пополнения баланса. На Windows сохраните его командой setx FAL_KEY ваш_ключ и перезапустите терминал, на macOS и Linux — export FAL_KEY=.... По данным VGTimes, MCP-сервер fal читает ключ только из переменной окружения, поэтому файла .env для него недостаточно.

Как проверить, что Universal Modder подключился

1. В Claude Code откройте /plugin: universal-modder должен быть в списке установленных.
2. Начните вводить /universal-modder: — в подсказках появится основной навык mod-any-game.
3. Попросите агента выполнить um kb search terraria. Если появился список заметок, утилита um работает.
4. Попросите um scan --list: агент должен увидеть ваши игры из Steam, Epic или Xbox.

В Codex и других агентах навык тоже срабатывает по обычному запросу, но надёжнее прямо написать в нём «используй навык mod-any-game».

Первый мод в Universal Modder: от запроса до проверки в игре

Возьмём Terraria со Steam. Запустите tModLoader один раз вручную, чтобы он создал свои папки, и закройте его. Создайте папку проекта, например C:\mods\terraria-boomerang, откройте в ней терминал, запустите агента и сразу опишите задачу целиком:

/universal-modder:mod-any-game Сделай мод для Terraria (Steam, tModLoader): бумеранг,
который четыре раза отскакивает между врагами и возвращается к игроку.
Спрайт сгенерируй через fal в стиле игры, качество medium.
Готово = предмет крафтится и работает в тестовом мире. Видео не нужно.

Явный вызов /universal-modder:mod-any-game гарантирует, что агент пойдёт по сценарию плагина, а не начнёт импровизировать. Чем конкретнее запрос, тем меньше уточняющих вопросов. Если не нужен ролик, скажите об этом сразу: обычно «готово» означает рабочий мод плюс видео на 20–45 секунд.

Дальше агент работает по циклу из основного навыка:

1. Журнал. Создаёт в папке проекта MODLOG.md и записывает туда пути, найденные классы, неудачи и следующий шаг.
2. Разведка. Ищет игру в базе знаний (um kb search), запускает um scan --list и um scan "Terraria": движок, версия, античит, установленные загрузчики, папки сохранений.
3. Выбор пути. Берёт самый дешёвый путь к идее: правка данных → API загрузчика → патчинг управляемого кода → нативные хуки → переписывание → мэшап двух игр.
4. Страховка. Делает бэкап сохранений через um backup create "<папка сохранений>" --name terraria-saves, заводит отдельную тестовую папку сохранений (для tModLoader — параметр -tmlsavedirectory) и переводит игру в окно фиксированного размера.
5. Одна маленькая рабочая фича. Сначала один предмет целиком, пусть даже с временной картинкой. Только когда он появился в игре и работает, агент расширяет мод.
6. Ассеты. Генерирует спрайты через um fal (каждая генерация пишется в fal_manifest.jsonl) и подгоняет их под размер, который ждёт движок.
7. Проверка в игре. Запускает игру, проходит меню, делает скриншоты и читает логи. Если одна и та же ошибка повторилась три раза, агент останавливается, записывает, что известно, и меняет подход или спрашивает вас.

Пока агент управляет игрой, не трогайте мышь и клавиатуру: лишний клик сбивает координаты. Перед долгими автоматическими прогонами и перед установкой загрузчика в папку игры агент спросит разрешения.

Критерий «готово» — не сообщение агента «всё работает», а ваша собственная проверка: запустите игру в тестовом профиле, скрафтите предмет и убедитесь, что он ведёт себя как задумано. Если что-то не так, агенту помогут логи: у tModLoader это client.log, у BepInEx — BepInEx/LogOutput.log, у UE4SS — UE4SS.log, у Unity — Player.log, у Minecraft — logs/latest.log.

Если работа растянулась на несколько дней, откройте новую сессию в той же папке и напишите «прочитай MODLOG.md и продолжай». Журнал нужен именно для этого: всё, чего в нём нет, теряется при сжатии контекста. Если посреди сессии кончился лимит, разберитесь по статьям Лимиты Claude Code: как посмотреть, понять ошибку и продолжить или Codex остановился с ошибкой 429.

Когда мод готов, перед публикацией агент запускает um publish check <папка мода> --game "<папка игры>": проверка не даёт выложить файлы игры, декомпилированный код и случайно попавшие ключи. Отдельно агент предложит оформить заметку для базы знаний; pull request на GitHub он откроет только с вашего согласия.

Ошибки Universal Modder при установке и запуске

Если агент три раза подряд упёрся в одну и ту же ошибку и остановился, это не сбой, а встроенный предохранитель. Прочитайте, что он записал в MODLOG.md, и решите вместе с ним: другой путь, другая версия загрузчика или другая идея.

Где Universal Modder откажет: античит, DRM и чужие копии игр

У инструмента есть жёсткие правила, которые агент не нарушит даже по прямой просьбе. Они описаны в навыке и в файле safety.md:

• Только игры, которыми вы владеете. Агент не скачивает игры, ROM и образы дисков. С пиратской копией он работать не будет: обход DRM (Denuvo, Steam stub) и проверок владения — запрет без исключений. Если для загрузчика нужно пропатчить исполняемый файл мимо DRM, агент остановится.
• Только одиночная игра, офлайн или ваш собственный сервер. Клиенты онлайн-игр под EasyAntiCheat, BattlEye, Vanguard, VAC на официальных серверах, Ricochet, ACE, EA Javelin, nProtect, XIGNCODE и mhyprot агент не трогает. Вместо этого он предложит офлайн-режим, приватный сервер или официальные инструменты вроде Steam Workshop и редакторов карт.
• Никаких читов для мультиплеера: аимботов, ESP, спидхаков.
• Никакого распространения файлов игры. В готовом моде только ваш код, ваши ассеты и патчи; извлечённые ресурсы и декомпилированный код остаются на вашем компьютере.

Про публикацию сам проект предупреждает честно: моды удаляют с GitHub, даже если в них нет ни одного файла игры. Take-Two в 2021 году добилась удаления re3 и reVC и подала в суд на авторов, Activision в 2024 году отправила требование прекратить работу моду H2M. Коммерческое использование заметно повышает риск, а использование ИИ лучше раскрывать: часть сообществ такие проекты не принимает. Это правила самого инструмента и контекст, а не юридическая консультация; если важна политика конкретного издателя, читайте его правила для модов.

И ещё о безопасности. Плагин выполняет код с правами вашего пользователя, а safety.md прямо предупреждает: «скачать вирусный мод» часто означает скачать вредонос. Официальный источник Universal Modder — только репозиторий на GitHub. Сайт universal-modder.org называет себя хабом сообщества на основе открытого проекта, а не официальной страницей; его кнопка установки просто копирует ту же команду из README. Как ограничить права агента на компьютере, разобрано в статье Песочница Codex и config.toml.

Зачем плагин Universal Modder, если агент и так пишет код

Сильный агент может сделать мод и без плагина. Автор японского YouTube-канала «さつきのOSS研究室» сообщает, что Claude Code прошёл 8 из 8 задач по моддингу в трёх играх, вообще не вызывая навыки плагина и работая напрямую через командную строку. Это одиночный отчёт, игры и версии в нём неизвестны.

Ценность плагина в другом — в дисциплине работы, которую агент без него соблюдает не всегда:

• бэкап сохранений и отдельный тестовый профиль до первого запуска мода;
• разведка через um scan вместо догадок о движке;
• база знаний, где другие агенты уже записали рабочие версии и тупики;
• конвейер ассетов: генерация через fal, вырезание фона, подгонка под формат движка;
• проверка в настоящей игре и «предохранитель» после трёх одинаковых ошибок;
• um publish check перед публикацией.

Чтобы этот сценарий точно запустился, вызывайте /universal-modder:mod-any-game явно. А когда не моддите, отключайте плагин через /plugin или claude plugin disable: его описания расходуют контекст и лимиты в каждой сессии. В облачных сессиях Claude Code (claude.ai/code) локальные плагины не загружаются, так что Universal Modder там не появится.

Короткие ответы про Universal Modder

Можно ли добавить мод в уже существующий мир?

Можно, но не сразу. Сначала агент делает бэкап сохранений через um backup create и тестирует мод на копии мира или в отдельной папке сохранений. Скриптовые прогоны портят тестовые миры, поэтому чистую копию держат отдельно. Когда мод проверен на копии, его можно подключать к основному миру: если что-то пойдёт не так, сохранения откатываются из бэкапа командой um backup restore.

Нужна ли лицензионная копия игры?

Да. Universal Modder работает только с играми из вашей библиотеки и не обходит DRM и проверки владения. Обычная покупка в Steam, Epic или Xbox подходит: um scan --list найдёт такие установки сам.

Работает ли Universal Modder на macOS?

Частично. Разведка, база знаний, генерация через fal и обработка спрайтов — это обычный Python и работают везде. Команды um win (запуск игры, скриншоты, ввод, запись видео) работают только на Windows и в WSL, поэтому на Mac проверять мод в игре придётся вручную.

Как пользоваться Universal Modder с Minecraft?

Minecraft с загрузчиком Fabric — один из рекомендованных вариантов для первого мода, у основного навыка есть отдельный сценарий для этой игры. Начните с um kb search minecraft: там уже есть заметки других агентов, включая мэшапы с другими играми. Лог для отладки — logs/latest.log.

Нужно ли платить за Universal Modder?

Сам плагин бесплатный и открытый. Платите вы за агента (подписка или токены) и за генерации fal, если пользуетесь ими. Без ключа fal код мода всё равно пишется, а картинки можно сделать через локальный ComfyUI или нарисовать самому. Если нужен прозрачный фон у спрайтов, пригодится статья GPT Image 2 и 2.5: прозрачный фон в PNG и WebP.