Плагин для Claude Code помогает создавать моды почти для любой игры на ПК

Что умеет universal-modder

Universal-modder — бесплатный плагин для Claude Code, предназначенный для создания модов почти к любой игре на ПК. Его разработал Rehan; исходный код открыт на GitHub, лицензия — MIT. На момент подготовки материала последней была версия 0.2.0.

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

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

Подготовка Claude Code

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

Инструкции по установке ориентированы прежде всего на Windows: большинство игр для модификаций работает на этой системе, и часть инструментов плагина, включая запуск игры, создание скриншотов и запись видео, рассчитана именно на неё. Перед установкой Claude Code на Windows нужно загрузить Git for Windows с официального сайта Git. Настройки установщика можно не менять: Claude Code использует Git Bash, а сам плагин загружается с GitHub.

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

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

Установка плагина и настройка fal

До установки плагина нужно поставить программы, необходимые его инструментам. В 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, пополнить баланс, создать ключ на странице ключей и сохранить его: показывают его только один раз.

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

Команды и навыки

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

Основной навык — mod-any-game: он сопровождает работу от идеи до готового мода и включает руководства по 12 движкам. Перед началом можно запустить game-recon: он выясняет, какой движок использует игра, есть ли у неё античит, где находятся сохранения и какой загрузчик популярен у сообщества, а затем сохраняет результаты в MODDING_PLAN.md.

Навык asset-pipeline помогает подготовить графику под требования игры: удалить фон, настроить размер кадра и палитру, собрать спрайт-лист или отрендерить 3D-модель с нужной стороны. publish-mod предназначен для подготовки к публикации: он проверяет и упаковывает мод, составляет README с инструкцией и титры, а также готовит текст для Nexus Mods, Steam Workshop, Thunderstore, mod.io или GitHub.

Создание мода для Terraria

В качестве примера предлагается Terraria: игра подходит для первого проекта, поскольку в ней нет античита, а tModLoader официально доступен в Steam и имеет большую экосистему модификаций. В базе знаний плагина уже есть подробные заметки о Terraria; для других игр общий порядок действий будет таким же, но набор инструментов изменится.

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

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

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

Ограничения и советы

Плагин запрещает модифицировать сетевые игры с античитом: EasyAntiCheat, BattlEye, Vanguard, VAC на официальных серверах, Ricochet и ACE. Вместо этого агент предложит офлайн-режим, собственный сервер или официальные инструменты — например, Steam Workshop либо редактор карт. В распространяемый мод могут войти только код и ресурсы пользователя, а также патчи; извлечённые материалы игры и декомпилированный код останутся на компьютере.

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

Новичкам рекомендуют начинать с игр, у которых есть популярные загрузчики модов: Terraria, Stardew Valley, Minecraft и игр на Unity. Если проект занимает несколько дней, следующую сессию лучше начать в той же папке и попросить агента прочитать MODLOG.md и продолжить — журнал содержит сведения, необходимые для восстановления контекста работы.