Universal Modder + Claude Code: a configuração completa

Por que o Claude Code é o agente de referência

O autor criou o kit a partir de sessões reais do Claude Code, e o repositório traz configuração própria para o Claude: um marketplace de plugins (.claude-plugin/), skills copiadas em .claude/skills, o servidor MCP do fal em .mcp.json e um hook SessionStart que coloca a CLI um no PATH sempre que uma sessão começa ou é retomada. Outros agentes também funcionam (veja o guia de instalação multiagente), mas o Claude Code é o caminho mais testado.

1. Instale o Claude Code

Pule esta parte se claude --version já funciona.

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

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

Depois crie uma pasta de trabalho para seus mods (por exemplo ~/mods ou C:\mods), rode claude dentro dela e faça login. Você precisa de um plano Claude Pro, Max, Team ou Enterprise, ou de uma conta do Console com cobrança por API. Se algo parecer errado, rode claude doctor.

Instale também os requisitos do kit: Git, Python 3.10+, ffmpeg e uv (instalação em uma linha).

2. Adicione o plugin do Universal Modder

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

• Escolha o escopo user para ter o plugin em todas as pastas de projeto.
• Rode /reload-plugins se o Claude Code pedir, ou reinicie a sessão.
• Prefere o terminal? Funciona igual com claude plugin marketplace add … e claude plugin install ….
• Erro de SSH? Veja solução de problemas.

O que o plugin instala

3. Conecte o fal para arte, 3D e áudio

O servidor MCP do fal lê a FAL_KEY do ambiente em que o Claude Code inicia. Crie uma chave em fal.ai/dashboard/keys, exporte e reinicie o claude.

export FAL_KEY="your-key"     # macOS / Linux / WSL
setx FAL_KEY "your-key"       # Windows; depois abra um terminal novo

Confira com /mcp dentro do Claude Code: o servidor fal deve aparecer como conectado. Os preços por asset estão na página de custos.

Como chamar as skills

Quase nunca é preciso citar uma skill: um pedido como “faça um mod para o Stardew Valley que…” carrega a mod-any-game, que usa as outras conforme precisa. Para forçar uma, digite o comando com barra:

O que cada skill contém →

Prompts que funcionam

Um bom prompt cita o jogo, um resultado concreto e o que significa “pronto”. Exemplos do README do projeto:

Faça um mod para o Terraria: adicione um lança-mísseis teleguiado e uma bomba nuclear tática que abre uma cratera no mundo. Gere os sprites com o fal.

Crie uma nova civilização para Age of Empires II com uma unidade única renderizada a partir de 3D.

Coloque o Minecraft de verdade dentro do modo história do GTA V. A câmera do Minecraft deve seguir a do GTA, e o TNT dele deve explodir os carros do GTA.

Qual é a engine de C:\Games\Foo, e alguém já fez mod nele?

Dicas para economizar tokens e dinheiro:

• Reconhecimento primeiro, construção depois. Peça o plano antes de qualquer mudança; ele escreve o MODDING_PLAN.md.
• Uma parte por vez. Uma arma funcionando vale mais que dez pela metade.
• Provisórios antes do fal. Gere a arte final só quando a mecânica funcionar no jogo.
• Pergunte o preço. “Confira um fal price antes de gerar o modelo 3D.”
• Mãos longe durante os testes. Não use o PC enquanto ele controla o jogo ou grava.

Projetos longos e limites de contexto

A skill mantém um diário no MODLOG.md (caminhos, IDs, formatos, o que falhou, o próximo passo), então nada importante se perde quando o Claude Code compacta a conversa. Comece uma sessão nova com:

Leia o MODLOG.md e o MODDING_PLAN.md e continue a partir do próximo passo.

Quando o mod funcionar, peça uma nota de campo com a skill share-field-notes. Ela só abre um pull request na base de conhecimento compartilhada depois do seu ok.

O que o Claude Code construiu com ele

• 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)

Ver todos os jogos →