Universal Modder + Claude Code: la configuración completa

Por qué Claude Code es el agente de referencia

El autor creó el kit a partir de sesiones reales de Claude Code, y el repo trae configuración específica para Claude: un marketplace de plugins (.claude-plugin/), skills copiadas en .claude/skills, el servidor MCP de fal en .mcp.json y un hook SessionStart que añade la CLI um al PATH cada vez que una sesión empieza o se reanuda. Otros agentes también funcionan (mira la guía de instalación multiagente), pero Claude Code es la vía más probada.

1. Instala Claude Code

Sáltate esto si claude --version ya funciona.

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

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

Después crea una carpeta de trabajo para tus mods (por ejemplo ~/mods o C:\mods), ejecuta claude dentro e inicia sesión. Necesitas un plan Claude Pro, Max, Team o Enterprise, o una cuenta de Console con facturación por API. Si algo va mal, ejecuta claude doctor.

Instala también los requisitos del kit: Git, Python 3.10+, ffmpeg y uv (instalación en una línea).

2. Añade el plugin de Universal Modder

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

• Elige el ámbito user para tener el plugin en todas las carpetas de proyecto.
• Ejecuta /reload-plugins si Claude Code te lo pide, o reinicia la sesión.
• ¿Prefieres la terminal? Funciona igual con claude plugin marketplace add … y claude plugin install ….
• ¿Error de SSH? Mira solución de problemas.

Qué instala el plugin

3. Conecta fal para arte, 3D y audio

El servidor MCP de fal lee FAL_KEY del entorno en el que arranca Claude Code. Crea una clave en fal.ai/dashboard/keys, expórtala y reinicia claude.

export FAL_KEY="your-key"     # macOS / Linux / WSL
setx FAL_KEY "your-key"       # Windows; después abre una terminal nueva

Compruébalo con /mcp dentro de Claude Code: el servidor fal debe aparecer como conectado. Los precios por asset están en la página de costes.

Cómo llamar a las skills

Casi nunca hace falta nombrar una skill: una petición como «haz un mod para Stardew Valley que…» carga mod-any-game, que usa las demás según haga falta. Para forzar una, escribe su comando con barra:

Qué contiene cada skill →

Prompts que funcionan

Un buen prompt nombra el juego, un resultado concreto y qué significa «terminado». Ejemplos del README del proyecto:

Haz un mod para Terraria: añade un lanzamisiles teledirigido y una bomba nuclear táctica que abra un cráter en el mundo. Genera los sprites con fal.

Crea una nueva civilización para Age of Empires II con una unidad única renderizada desde 3D.

Mete el Minecraft real dentro del modo historia de GTA V. La cámara de Minecraft debe seguir a la de GTA y su TNT debe hacer explotar los coches de GTA.

¿Qué motor usa C:\Games\Foo y alguien lo ha modificado antes?

Consejos para ahorrar tokens y dinero:

• Primero reconocimiento, luego construir. Pide el plan antes de cualquier cambio; escribe MODDING_PLAN.md.
• Una parte cada vez. Un arma que funciona vale más que diez a medias.
• Provisionales antes que fal. Genera el arte final solo cuando la mecánica funcione en el juego.
• Pregunta el precio. «Comprueba um fal price antes de generar el modelo 3D».
• Manos fuera durante las pruebas. No uses el PC mientras controla el juego o graba.

Proyectos largos y límites de contexto

La skill lleva un diario en MODLOG.md (rutas, IDs, formatos, qué falló, el siguiente paso), así que no se pierde nada importante cuando Claude Code compacta la conversación. Empieza una sesión nueva con:

Lee MODLOG.md y MODDING_PLAN.md y continúa desde el siguiente paso.

Cuando el mod funcione, pídele una nota de campo con la skill share-field-notes. Solo abre un pull request a la base de conocimiento compartida después de que digas que sí.

Lo que Claude Code ha construido con él

• 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 los juegos →