Cómo instalar y usar Universal Modder

Requisitos

Instala los requisitos de una vez

winget install Git.Git Python.Python.3.12 astral-sh.uv Gyan.FFmpeg
winget install BlenderFoundation.Blender   # opcional, para 3D → sprites

brew install git python ffmpeg uv
brew install --cask blender                 # opcional

sudo apt install git python3 python3-venv ffmpeg
curl -LsSf https://astral.sh/uv/install.sh | sh

Windows, macOS y Linux: qué funciona dónde

Casi todo el kit es multiplataforma. La parte que controla un juego en marcha (lanzar, capturar, enviar entrada, grabar la ventana solo con el audio del juego) está pensada primero para Windows, porque ahí están los juegos. Los agentes pueden controlar juegos de Windows de forma nativa o desde WSL2.

En macOS y Linux el agente aún puede probar en el juego con las herramientas de captura del sistema (screencapture, ffmpeg, xdotool), pero no hay nada preconfigurado. Notas de campo como ejecutar xEdit en Linux o HL2 con Wine en macOS demuestran que se puede.

Instalar por agente: comparativa

Todas las vías instalan las mismas skills (formato Agent Skills), el servidor MCP de fal y la CLI um.

Claude Code

Ejecútalo dentro de una sesión de Claude Code (no en tu terminal):

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

Elige el ámbito user para tenerlo en todas las carpetas y ejecuta /reload-plugins si te lo pide. El recorrido completo, incluido Claude Desktop y cómo llamar a cada skill, está en la página Universal Modder + Claude Code.

OpenAI Codex

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

Codex lee las skills de .agents/skills y la configuración MCP de .codex/config.toml.

Gemini CLI

gemini extensions install https://github.com/rehan-remade/universal-modder

El manifiesto de la extensión es gemini-extension.json; las instrucciones vienen de GEMINI.md, que apunta a AGENTS.md.

VS Code con GitHub Copilot

1. Abre la configuración y activa chat.plugins.enabled.
2. Abre la paleta de comandos y ejecuta Chat: Install Plugin From Source.
3. Pega https://github.com/rehan-remade/universal-modder.

La configuración MCP está en .vscode/mcp.json.

Cursor

Instálalo desde Cursor Marketplace, o clona el repo y ábrelo: Cursor lee AGENTS.md y .cursor/mcp.json automáticamente.

OpenCode

git clone https://github.com/rehan-remade/universal-modder
cd universal-modder
opencode

opencode.json añade las skills y el servidor MCP de fal.

Cualquier otro agente

# solo las skills, en la carpeta de skills de tu agente
npx skills add https://github.com/rehan-remade/universal-modder

# o todo: inicia tu agente dentro del clon
git clone https://github.com/rehan-remade/universal-modder

Instalar solo la CLI um

Instalar el plugin o clonar el repo ya añade um al PATH. Si usas las skills en otro sitio, o quieres um en una terminal normal, instálala como herramienta. Se instala desde GitHub; no está en PyPI, así que pip install universal-modder no funcionará.

uv tool install git+https://github.com/rehan-remade/universal-modder
# o
pipx install git+https://github.com/rehan-remade/universal-modder

Cada grupo de comandos tiene --help con ejemplos. Consulta la referencia de la CLI um.

Configura tu clave de fal

Consigue una clave en fal.ai/dashboard/keys (tendrás que añadir saldo; se muestra una sola vez, guárdala). Con ella funcionan tanto el servidor MCP de fal como um fal.

export FAL_KEY="your-key"
# para que sea permanente
echo 'export FAL_KEY="your-key"' >> ~/.zshrc   # o ~/.bashrc

setx FAL_KEY "your-key"
# después abre una terminal nueva y reinicia tu agente

¿Sin clave? um comfy genera imágenes con un servidor ComfyUI local. El audio, el 3D y el vídeo siguen necesitando fal. Los precios están en la página de costes.

Comprueba la instalación

um --help
um kb search "terraria"       # notas de campo previas (funciona fuera del repo)
um scan --list                # juegos encontrados en esta máquina
um fal price fal-ai/trellis-2 # confirma que FAL_KEY funciona

Tu primera sesión: un cambio pequeño y reversible

1. Elige un juego fácilLos juegos con un loader popular son el comienzo más suave: Terraria (tModLoader), Stardew Valley (SMAPI), Minecraft (Fabric/Forge), juegos de Unity con BepInEx y de Unreal con UE4SS. Ver la biblioteca de juegos.
2. Pide primero un reconocimiento
   promptCopiar

   ¿Qué motor usa mi copia de Terraria, alguien la ha modificado antes (busca en la base de conocimiento) y qué ruta seguirías? No cambies nada todavía.

3. Deja que haga copias y monte un laboratorioEl agente hace una instantánea de las partidas con um backup create, usa un perfil o mundo aparte y pregunta antes de instalar un loader.
4. Construye una parte
   promptCopiar

   Añade un bumerán que rebote entre enemigos cuatro veces antes de volver. Primero con un sprite provisional y, cuando funcione en el juego, un sprite de fal.

5. Verifica y luego amplíaLanza el juego, míralo y solo entonces pide más. Los proyectos largos se guardan en MODLOG.md; en una sesión nueva dile «lee MODLOG.md y continúa».

Solución de problemas

Añadir el marketplace falla con un error de Git / SSH

Los marketplaces de plugins se clonan con Git. Si tu equipo no tiene clave SSH de GitHub, dile a Git que use HTTPS para GitHub:

git config --global url."https://github.com/".insteadOf [email protected]:

Las skills no aparecen tras instalar

Ejecuta /reload-plugins (Claude Code) o reinicia el agente. Comprueba en /plugin que el plugin está activado.

um: command not found

Abre una terminal nueva tras instalar el plugin, o instala la CLI con uv tool install como arriba y asegúrate de que ~/.local/bin está en el PATH (uv tool update-shell).

um fal dice que falta la clave

FAL_KEY tiene que estar en el entorno desde el que se inició el agente. Reinicia el agente después de setx o de editar el perfil de tu shell.

um win no se ejecuta

Solo controla juegos de Windows, desde Windows o WSL2. En macOS/Linux, prueba en el juego a mano.