Universal Modder + Claude Code: полная настройка

Почему Claude Code — эталонный агент

Автор собрал набор из реальных сессий Claude Code, и в репозитории есть настройки специально под Claude: маркетплейс плагинов (.claude-plugin/), навыки в .claude/skills, MCP-сервер fal в .mcp.json и хук SessionStart, который добавляет CLI um в PATH при каждом запуске или возобновлении сессии. Другие агенты тоже работают (см. руководство по установке для разных агентов), но лучше всего протестирован именно Claude Code.

1. Установите Claude Code

Пропустите, если claude --version уже работает.

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

Затем создайте рабочую папку для модов (например, ~/mods или C:\mods), запустите в ней claude и войдите. Нужен тариф Claude Pro, Max, Team или Enterprise либо аккаунт Console с оплатой API. Если что-то не так, выполните claude doctor.

Также поставьте зависимости набора: Git, Python 3.10+, ffmpeg и uv (установка одной строкой).

2. Добавьте плагин Universal Modder

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

• Выберите область user, чтобы плагин был доступен в любой папке проекта.
• Выполните /reload-plugins, если Claude Code попросит, или перезапустите сессию.
• Удобнее в терминале? То же самое делается через claude plugin marketplace add … и claude plugin install ….
• Ошибка SSH? См. решение проблем.

Что ставит плагин

3. Подключите fal для арта, 3D и звука

MCP-сервер fal читает FAL_KEY из окружения, в котором запущен Claude Code. Создайте ключ на fal.ai/dashboard/keys, экспортируйте его и перезапустите claude.

export FAL_KEY="your-key"     # macOS / Linux / WSL
setx FAL_KEY "your-key"       # Windows, затем откройте новый терминал

Проверьте через /mcp в Claude Code: сервер fal должен быть подключён. Цены на ассеты — на странице стоимости.

Как вызывать навыки

Называть навык почти никогда не нужно: запрос вроде «сделай мод для Stardew Valley, чтобы…» подключает mod-any-game, а тот при необходимости зовёт остальные. Чтобы вызвать конкретный, наберите его слэш-команду:

Что внутри каждого навыка →

Рабочие промпты

В хорошем промпте есть игра, один конкретный результат и критерий «готово». Примеры из README проекта:

Сделай мод для Terraria: добавь самонаводящуюся ракетницу и тактическую ядерную бомбу, которая оставляет кратер. Спрайты сделай через fal.

Сделай новую цивилизацию для Age of Empires II с уникальным юнитом, отрендеренным из 3D.

Помести настоящий Minecraft в сюжетный режим GTA V. Камера Minecraft должна следовать за камерой GTA, а его динамит — взрывать машины GTA.

На каком движке C:\Games\Foo и моддил ли его кто-нибудь?

Советы, которые экономят токены и деньги:

• Сначала разведка, потом работа. Попросите план до любых изменений — он запишет MODDING_PLAN.md.
• По одному срезу. Одно рабочее оружие лучше десяти недоделанных.
• Заглушки до fal. Финальный арт генерируйте, только когда механика заработала в игре.
• Спросите цену. «Проверь um fal price перед генерацией 3D-модели».
• Руки прочь во время тестов. Не пользуйтесь ПК, пока агент управляет игрой или пишет видео.

Длинные проекты и лимиты контекста

Навык ведёт журнал в MODLOG.md (пути, ID, форматы, что не сработало, следующий шаг), поэтому при сжатии разговора в Claude Code ничего важного не теряется. Новую сессию начните так:

Прочитай MODLOG.md и MODDING_PLAN.md и продолжай со следующего шага.

Когда мод заработает, попросите написать полевую заметку навыком share-field-notes. Pull request в общую базу знаний он откроет только после вашего согласия.

Что Claude Code уже сделал с его помощью

• Age of Empires II: Definitive Edition: San Franciscans: a new civilization for Age of Empires II DE with units rendered from 3D
• Baldur's Gate 3: Act 2 never loads (hang at 50% or crash): one modded NPC on a bad level layer, found by bisecting a pak
• Baldur's Gate 3: A generated wardrobe mod: 260 clothing mods sorted by race and body type into containers summoned by reusable scrolls
• Baldur's Gate 3: Custom outfits from cloned mod and vanilla meshes: visuals, materials, body masks, cloth, LODs, icons and the Blender GR2 round trip
• Baldur's Gate 3: Gameplay and compatibility patches in stats and Osiris: level-gated armour tiers, Extra Attack on a modded cantrip, crit immunity, stacking damage reduction, feats from items, removing equipment glow, a class vs starting-equipment fix
• Baldur's Gate 3: Running a 500+ mod load order by hand: modsettings.lsx rules, recovering a wiped order from a save, mod.io re-subscribes, game-folder files and conflict diagnosis
• Baldur's Gate 3: Weapons: porting a Skyrim dagger and scabbard, fixing a modded sword's sheath height with a Dummy_Sheath bone, and visible stowed shields for modded shields
• Borderlands 2: BL3 weapons and movement in Borderlands 2 (Willow2 SDK mods)
• Darkest Dungeon: A seeded randomizer (trinkets, heroes, monsters, curios, quirks, quests) as a Darkest Dungeon data mod
• Dragon's Dogma 2: Blink Strike teleports behind the target (REFramework Lua skill rework)
• Dragon's Dogma 2: Dimension Door: aimed teleport spell with a scripted arrival camera (REFramework Lua)
• Elden Ring: CS2 conversion of Elden Ring offline: native Rust DLL via me3 (fall death, spirit springs, 3D inspect, params)

Все игры →