Universal Modder: permite que los agentes de IA modifiquen casi cualquier juego de PC
Universal Modder ofrece a Claude Code y otros agentes de IA un flujo de trabajo repetible para el reconocimiento, la ingeniería inversa, la creación de recursos, las pruebas y el empaquetado de mods de juegos.
Universal Modder: permite que los agentes de IA modifiquen casi cualquier juego de PC
Modificar juegos suele requerir varias especialidades diferentes a la vez: identificar el motor, localizar los archivos adecuados, entender formatos no documentados, escribir un cargador o parche, crear recursos compatibles, realizar pruebas de forma segura y documentar el resultado. universal-modder empaqueta ese flujo de trabajo para agentes de programación con IA, de modo que puedan abordar sistemáticamente juegos de PC desconocidos en lugar de avanzar a ciegas mediante un experimento aislado.
El proyecto es compatible con Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode y otros agentes que leen AGENTS.md. Su promesa central no es que todos los juegos puedan modificarse al instante. En cambio, proporciona al agente un proceso repetible de investigación y entrega para juegos que posees, con límites de seguridad y una base de conocimiento compartida que conserva los descubrimientos entre proyectos.
Qué añade el proyecto a un agente de programación con IA
Universal Modder combina tres componentes principales:
- Agent Skills para reconocimiento, ingeniería inversa, canalizaciones de recursos, automatización, producción de vídeo y publicación.
- La herramienta de línea de comandos
umpara escanear instalaciones, gestionar partidas guardadas, generar recursos, controlar juegos de Windows y mantener notas de campo. - Un servidor MCP de fal para generar sprites, texturas, modelos 3D, efectos de sonido, música, voces y vídeo.
El agente sigue un ciclo coherente:
- Buscar conocimientos existentes sobre el juego.
- Reconocer la instalación, el motor, la versión, los cargadores, las ubicaciones de las partidas guardadas y la situación del sistema antitrampas.
- Elegir una ruta viable para modificar el juego.
- Hacer copias de seguridad de las partidas y establecer un entorno de pruebas seguro.
- Leer el código o los formatos de datos reales en lugar de basarse en suposiciones.
- Construir una primera parte pequeña que funcione.
- Generar o adaptar los recursos necesarios.
- Verificar el mod en el juego en ejecución.
- Grabar una demostración de la jugabilidad.
- Empaquetar el resultado y escribir una nota de campo para futuros agentes.
Esta secuencia es importante. Hace que el agente se comporte más como un ingeniero inverso júnior que trabaja siguiendo un proceso documentado que como un chatbot que produce código especulativo.
Opciones de instalación
Para Claude Code, añade el marketplace e instala el plugin:
/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder
Codex usa:
codex plugin marketplace add rehan-remade/universal-modder
codex plugin add universal-modder@universal-modder
Gemini CLI puede instalar la extensión directamente:
gemini extensions install https://github.com/rehan-remade/universal-modder
Para un agente compatible con el formato Agent Skills:
npx skills add https://github.com/rehan-remade/universal-modder
Como alternativa, clona el repositorio e inicia un agente dentro de él:
git clone https://github.com/rehan-remade/universal-modder
cd universal-modder
El repositorio coloca enlaces al directorio compartido skills/ en las ubicaciones esperadas por distintos agentes, incluidas .agents/skills, .claude/skills, .gemini/skills y .github/skills. Las instrucciones para los agentes se proporcionan mediante AGENTS.md, mientras que CLAUDE.md y GEMINI.md apuntan a las mismas directrices. La configuración de MCP está disponible para .mcp.json, Codex, Cursor y VS Code.
La CLI también puede instalarse de forma independiente:
uv tool install git+https://github.com/rehan-remade/universal-modder
# o
pipx install git+https://github.com/rehan-remade/universal-modder
Necesitas Python 3.10 o posterior y ffmpeg. El proyecto recomienda uv, y Blender es necesario al convertir modelos 3D en renders de sprites. Los juegos de Windows pueden controlarse de forma nativa o desde WSL.
Uso de fal para generar recursos de juegos
Universal Modder utiliza fal tanto mediante MCP como a través de um fal. Define una clave de API antes de generar recursos:
export FAL_KEY=your_key_here
El envoltorio de fal ofrece comandos para la producción de imágenes y recursos de juegos, incluidos:
sprite,image,edit,rmbg,pixelateyupscale- Generación de texturas y mapas PBR
- Creación de modelos 3D a partir de imágenes
- Rigging
- Efectos de sonido, música, voz y vídeo
- Búsqueda de modelos, inspección de esquemas, precios y ejecución
Los recursos generados se registran mediante un manifiesto, lo que resulta útil para la reproducibilidad y la atribución. A continuación, la canalización de recursos independiente convierte el resultado genérico generado en contenido específico del motor: recortes transparentes, pixel art con interpolación de vecino más cercano, paletas, hojas de sprites, máscaras de colores de equipo, texturas sin interrupciones y renders 3D con la cámara igualada.
Por ejemplo, el flujo de trabajo 3D puede renderizar un modelo GLB en ocho o dieciséis fotogramas direccionales para una cámara al estilo de Age of Empires II. El flujo de trabajo 2D puede transformar arte generado en un sprite de Terraria con el tamaño correcto, como un recurso del juego de 64x26.
Las habilidades cubren todo el ciclo de vida de la modificación
La habilidad mod-any-game incluye guías prácticas para doce grandes familias de motores y tecnologías, entre ellas Unity, Unreal, juegos .NET/XNA como Terraria y Stardew Valley, Godot, Source 1 y 2, juegos de Bethesda, Minecraft, AoE2/Genie, RE Engine, títulos de FromSoftware, GTA, Cyberpunk, Baldur’s Gate 3, C++ nativo y varios ecosistemas independientes y retro.
Otras habilidades gestionan tareas especializadas:
game-reconidentifica motores, versiones, cargadores, carpetas de partidas guardadas y rutas respaldadas por la comunidad.reverse-engineeringcubre herramientas como ILSpy, Cpp2IL, Vineflower, Ghidra, IDA, Cheat Engine, Frida y RenderDoc.game-automationinicia juegos, captura capturas de pantalla, controla la entrada, gestiona el modo ventana y limpia los informes de fallos.showcase-videograba audio únicamente del juego, crea hojas de contacto y compila vídeos editados a partir de un EDL.mashup-modspermite experimentos entre juegos y arquitecturas de paso directo.publish-modcomprueba que los paquetes no contengan archivos prohibidos y prepara los créditos y el material de lanzamiento.
Una base de conocimiento diseñada para agentes
El directorio knowledge/ es una de las ideas más útiles del repositorio. Almacena notas de campo que describen cómo se modificaron realmente juegos específicos, incluyendo:
- Las versiones exactas que funcionaron
- La ruta seleccionada y por qué se eligió
- Lo que realmente hace el motor
- Cómo se verificó el resultado
- Problemas expresados como síntoma, causa y solución
Los agentes pueden buscar este material antes de iniciar un proyecto nuevo:
um kb search "grand theft auto"
Se puede crear y validar una nota nueva con:
um kb new --game "Hades II" \
--title "A new boon god" \
--from-scan hades \
--agent "Codex (gpt-6)"
um kb check knowledge/games/hades-ii/a-new-boon-god.md
Tras la aprobación humana, la nota puede enviarse como pull request:
um kb pr knowledge/games/hades-ii/a-new-boon-god.md --yes
Las reglas de contribución prohíben explícitamente los archivos de juegos, los volcados descompilados, el material que permita hacer trampas en línea y las afirmaciones de verificación deshonestas. El objetivo es conservar conocimientos prácticos sin convertir el repositorio en un canal de distribución de datos de juegos protegidos por derechos de autor o trampas multijugador.
Ejemplos incluidos
El repositorio incluye tres ejemplos importantes.
Terraria tModLoader
El ejemplo de Terraria, llamado Fal Arsenal, añade un lanzamisiles teledirigido, una bomba nuclear táctica, un rifle de relámpagos encadenados, un arma de agujero negro, un ataque orbital, tres enemigos y un jefe Polilla Nodriza de Drones con dos fases. Todos los sprites se generaron con fal y después se adaptaron a los requisitos de recursos del juego.
Age of Empires II: Definitive Edition
El ejemplo San Franciscans añade una civilización con una unidad única Robotaxi, drones de reparto y una maravilla de la Pirámide Transamérica. Las unidades se crearon a partir de modelos 3D generados por fal mediante imágenes y se renderizaron desde el ángulo de cámara del juego. El proyecto también incluye un escritor de sprites .sld obtenido mediante ingeniería inversa.
Minecraft dentro de GTA V
El ejemplo más ambicioso coloca Minecraft real dentro del modo historia de GTA V. Un mod de Fabric y un complemento de ScriptHookV más ReShade se comunican mediante un WebSocket local. El color y la profundidad de Minecraft se componen en el fotograma de GTA, mientras que la dinamita, las flechas y los fuegos artificiales de Minecraft se convierten en explosiones y balas de GTA. Incluso los mobs de Minecraft pueden luchar contra la policía.
Estos ejemplos demuestran que el repositorio está pensado para mucho más que simples ajustes de configuración. Admite mods a nivel de código fuente, conversiones de recursos, puentes en tiempo de ejecución y mashups de juegos cuidadosamente delimitados.
Los límites de seguridad forman parte del diseño
Universal Modder está dirigido explícitamente a la modificación de juegos para un jugador y sin conexión, siempre que el usuario sea su propietario. Sus instrucciones rechazan inyectar código en juegos en línea con sistemas antitrampas, crear trampas multijugador o eludir sistemas antitrampas, DRM o comprobaciones de propiedad.
El flujo de trabajo también incluye medidas de seguridad operativa:
- Haz copias de seguridad de las carpetas de partidas antes de modificarlas.
- Finaliza procesos por PID en lugar de usar una terminación amplia de procesos.
- Pregunta antes de controlar el ratón y el teclado.
- Pregunta antes de instalar cargadores en los directorios de los juegos.
- Pregunta antes de publicar o abrir pull requests.
- Usa
um publish checkpara impedir que los archivos de juegos, el código descompilado y las claves filtradas lleguen a los paquetes de lanzamiento.
El repositorio utiliza la licencia MIT y actualmente está compuesto principalmente por Python, con una distribución de lenguajes indicada como 89,4 % Python, 10 % PowerShell y 0,6 % Shell. Dentro de um/ps1/ se incluyen dos utilidades de Windows que no requieren compilación: WinDrive para controlar la entrada y ProcLoopback para capturar únicamente el audio del juego; ambas están implementadas como scripts de PowerShell con C# incrustado.
Por qué es importante este proyecto
El cambio interesante consiste en pasar de «pedirle a una IA que cree un mod» a «darle a una IA un sistema de ingeniería para modificar juegos». El reconocimiento, el seguimiento de versiones, las copias de seguridad, la conversión repetible de recursos, la verificación dentro del juego y las notas de campo compartidas abordan las partes de la modificación que normalmente quedan invisibles en una demostración breve.
El resultado seguirá dependiendo del juego, su versión, sus herramientas comunitarias y la capacidad del agente para inspeccionar código desconocido. Sin embargo, universal-modder hace explícitas esas dependencias. Para desarrolladores interesados en herramientas asistidas por IA, ingeniería inversa o contenido de juegos procedural, es un ejemplo práctico de cómo las habilidades, las herramientas MCP, las utilidades CLI y el conocimiento acumulado de proyectos pueden trabajar conjuntamente como un único flujo de trabajo orientado a agentes.
Repositorio: rehan-remade/universal-modder