Как с помощью Claude Code создать мод для почти любой игры

Раньше для создания мода нужно было знать программирование, разбираться в устройстве движка и самому рисовать графику. Теперь часть этой работы можно поручить ИИ-агенту. Плагин universal-modder для Claude Code учит агента определять движок игры, выбирать загрузчик, писать код, генерировать спрайты и проверять результат в запущенной игре. В этом материале мы расскажем, как устроен плагин, как его установить и создать с его помощью первый мод.

Universal-modder — это бесплатный плагин для Claude Code, который помогает ИИ-агенту делать моды почти для любой игры на ПК. Его автор — разработчик Rehan, плагин лежит в открытом доступе на GitHub и распространяется по лицензии MIT. На момент написания материала актуальна версия 0.2.0. О том, как Universal Modder генерирует ассеты, пишет код и проверяет моды прямо в игре, мы рассказывали отдельно.

Сам по себе Claude Code умеет писать код, но ничего не знает о том, как устроена конкретная игра и каким загрузчиком модов ее принято расширять. Плагин закрывает этот пробел. Он добавляет агенту набор навыков с инструкциями под разные движки, консольную утилиту um для работы с играми и подключение к сервису fal, который генерирует спрайты, текстуры, 3D-модели и звуки.

Плагин будет полезен как игрокам, которые хотят добавить в любимую игру свой предмет, врага или механику, но не умеют программировать, так и начинающим моддерам, которым нужен помощник для разбора кода игры и поиска нужных функций.

Прежде чем ставить какой-либо плагин, необходимо скачать и установить ИИ-агента, который будет писать за вас код. В данном случае это Claude Code.

Claude Code — это ИИ-агент от Anthropic, который работает в терминале. Он читает и создает файлы, запускает команды и пишет код на вашем компьютере. Для работы понадобится платная подписка Claude (Pro, Max, Team или Enterprise) либо аккаунт в Claude Console с оплатой по API.

Системные требования:

Большинство игр для модинга работает на Windows, а часть инструментов плагина (запуск игры, скриншоты, запись видео) сделана именно под неё. Поэтому дальше мы разберем установку на Windows.

Перейдите на официальный сайт Git, скачайте установщик и запустите его. Во всех окнах можно оставить настройки по умолчанию. Git нужен сразу для двух вещей: Claude Code использует встроенный в него Git Bash, а плагин скачивается с GitHub.

Нажмите правой кнопкой мыши на кнопку «Пуск» и выберите «Терминал» или «Windows PowerShell». Вставьте в окно команду irm https://claude.ai/install.ps1 | iex и нажмите Enter. На macOS и Linux откройте терминал и выполните: curl -fsSL https://claude.ai/install.sh | bash. После установки закройте терминал и откройте новое окно. Перейдите в нужную папку с проектом и запустите Claude Code командой claude. Проверить установку можно командой claude --version — в ответ появится номер версии. Если что-то пошло не так, запустите claude doctor, и программа покажет, чего не хватает.

Создайте отдельную папку для будущих модов, например C:\mods. Именно в ней агент будет хранить код, ассеты и журнал работы. Откройте терминал в этой папке и запустите Claude Code командой claude. При первом запуске программа предложит выбрать цветовую тему и способ входа. Выберите вход через подписку Claude или через Console — в браузере откроется страница авторизации. Войдите в аккаунт, подтвердите доступ и вернитесь в терминал. Напоследок Claude Code спросит, доверяете ли вы текущей папке. Подтвердите, и перед вами появится поле для сообщений.

Перед установкой самого плагина стоит поставить программы, на которых работает его инструментарий. Затем останется добавить плагин в Claude Code и прописать ключ для сервиса с ассетами.

Для работы инструментария используются следующие компоненты:

На Windows все программы можно поставить через встроенный менеджер winget. Откройте терминал и по очереди выполните команды:

После установки перезапустите терминал. Введите python --version, uv --version и ffmpeg -version, чтобы убедиться, что все программы на месте.

Запустите Claude Code в папке для модов и введите в поле сообщения команду, которая добавит каталог с плагином: /plugin marketplace add rehan-remade/universal-modder. Затем установите сам плагин, введя команду: /plugin install universal-modder@universal-modder. Программа спросит, для какой области его устанавливать. Выберите вариант для пользователя (User), чтобы плагин работал в любой папке. После установки проверьте сообщение Claude Code. Если плагин требует перезагрузки компонентов, выполните команду /reload-plugins. Если вы используете Claude Desktop, откройте локальную сессию Code, нажмите «+» рядом с полем ввода и выберите Plugins — Add plugin. Добавьте маркетплейс universal-modder, затем установите плагин и выберите нужную область установки.

fal — это сервис для генерации изображений, ассетов, моделей и других ресурсов, необходимых для модов. Без ключа плагин тоже работает, но агент не сможет сам создавать спрайты, модели и звуки. Сервис платный: каждая генерация списывает деньги с баланса, и самые дорогие задачи — 3D-модели и видео. Зайдите на fal.ai, зарегистрируйтесь и пополните баланс. Затем откройте страницу ключей, нажмите кнопку создания нового ключа и скопируйте его. Ключ показывают только один раз, поэтому сразу сохраните его. Теперь ключ нужно передать системе через переменную окружения FAL_KEY. На Windows выполните в терминале команду, подставив свой ключ: setx FAL_KEY «ваш_ключ».

На macOS и Linux добавьте строку export FAL_KEY=ваш_ключ в файл ~/.bashrc или ~/.zshrc. После этого обязательно перезапустите терминал. Также ключ можно положить в файл .env в папке проекта в формате FAL_KEY=ваш_ключ — утилита um прочитает его оттуда, но сервер fal MCP в Claude Code берет ключ только из переменной окружения.

У плагина есть два вида команд: навыки, которые вызываются через косую черту в Claude Code, и команды утилиты um, которые агент запускает в терминале. Запоминать их не обязательно: достаточно описать задачу словами, и агент сам выберет нужный навык. Но знать их полезно, чтобы понимать, что делает агент.

Все навыки запускаются с префиксом плагина, например /universal-modder:mod-any-game. После названия можно сразу написать задачу.

Разберем весь процесс на примере создания мода для Terraria. Эта игра хорошо подходит для первого мода, так как у нее нет античита, а tModLoader официально доступен в Steam и поддерживает огромную экосистему модификаций. С лучшими модами для Terraria можно познакомиться в нашей отдельной подборке. В базе знаний universal-modder уже есть подробные заметки по игре. Для других игр порядок действий будет таким же, поменяется только инструментарий.

Перед стартом убедитесь, что игра куплена и установлена в Steam. Затем найдите в магазине Steam бесплатное приложение tModLoader и добавьте его в библиотеку. Без этого загрузчик не запустится, а агент не будет обходить эту проверку. Запустите tModLoader один раз вручную, чтобы он создал свои папки, и закройте его. Создайте папку под проект, например C:\mods\terraria-boomerang, откройте в ней терминал и запустите Claude Code командой claude.

Вызовите главный навык и сразу напишите задачу. Чем точнее описание, тем меньше уточняющих вопросов задаст агент: /universal-modder:mod-any-game Сделай мод для Terraria из Steam: добавь бумеранг, который отскакивает от врагов четыре раза, а затем возвращается к игроку. Спрайты сделай через fal в стиле игры. Агент уточнит детали и спросит, что считать готовым результатом. Обычно это работающий в игре мод и ролик длиной 20-45 секунд. Если видео вам не нужно, скажите об этом сразу. В папке проекта появится журнал MODLOG.md.

Перед первым запуском игры с модом агент сделает резервную копию сохранений через um backup create. Он также настроит отдельную папку сохранений с помощью параметра -tmlsavedirectory. Так ваши настоящие персонажи и миры останутся нетронутыми. Игру он переведет в оконный режим с фиксированным размером, чтобы скриншоты и координаты кликов не менялись. Дождитесь окончания создания проекта, а затем сами проверьте созданный продукт — агент написал полностью готовый мод самостоятельно.

У плагина есть жесткие правила, которые агент не нарушит даже по вашей просьбе. Перед созданием модификаций изучите их, чтобы в будущем не возникало проблем. Что плагин делать не будет:

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