Repolode
Enviar
studioigor

studioigor/ref2game

Una skill para Claude Code y Codex que convierte una imagen de referencia en un prototipo jugable de un juego 2D para navegador.

Ver en GitHub
Estrellas
290
Forks
40
Issues abiertos
2
Último commit
hace 22 días

¿Qué es?

ref2game toma una captura de pantalla, una ilustración clave o una imagen conceptual y crea un prototipo jugable de un juego 2D para navegador. La generación de imágenes con IA crea el arte pieza por pieza siguiendo el estilo de la referencia, mientras que el movimiento, la iluminación, las partículas, la cámara y el HUD se implementan mediante código en un pequeño motor WebGL2. La página se actualiza en tiempo real mientras trabaja el agente.

El proyecto incluye dos versiones de la misma skill: una carpeta claude/ para Claude Code y otra codex/ para Codex. Ambas comparten el motor, los rigs, las comprobaciones automáticas y el manejo de referencias. Los sprites se construyen a partir de rigs recortados con extremidades de dos huesos, de modo que los ciclos de caminata y el movimiento de los animales se controlan mediante articulaciones, en lugar de mover una imagen completa.

El flujo de trabajo va desde unas preguntas iniciales de configuración hasta un primer fotograma comparado con la referencia y una versión jugable estática con texturas, un manifiesto y los archivos fuente. Cada defecto detectado se corrige y se cubre con una comprobación automática; además, críticos en segundo plano puntúan los recursos, el movimiento y la fidelidad del resultado.

Funciones clave

  • 01Genera el arte pieza por pieza siguiendo el estilo de la referencia, y deja que el motor se encargue del movimiento y los efectos.
  • 02Construye los personajes con rigs recortados, extremidades de dos huesos y mediciones a nivel de articulación.
  • 03Ofrece comprobaciones automáticas del movimiento, como el deslizamiento de los pies y la zancada.
  • 04Vuelve a cargar la página del navegador con cada cambio sin perder el estado de juego.
  • 05Entrega una versión jugable estática con texturas, manifiesto y archivos fuente.

Casos de uso

  • Convertir la captura de pantalla de un concepto de juego en un prototipo interactivo para una presentación o una prueba de juego.
  • Experimentar con géneros de juegos 2D, como plataformas o shooters con vista cenital, a partir de una sola imagen.
  • Crear prototipos de sprites animados a partir de arte conceptual sin tener que construir un rig a mano.
  • Exportar una pequeña versión de un juego para navegador desde una sesión con un agente.

Inicio rápido

  1. 1

    Envía el prompt de instalación a tu agente (Claude Code o Codex)

  2. 2

    Usa la carpeta claude/ con Claude Code o la carpeta codex/ con Codex

  3. 3

    En Claude Code, envía /ref2game; en Codex, envía $ref2game, adjuntando la imagen de referencia

Antes de usarlo

  • Requiere Claude Code o Codex y solo funciona en macOS o Linux.
  • Necesita Python 3.9 o posterior y Node.js 18 o posterior; Playwright con Chromium se instala en la primera ejecución.
  • Se requiere ffmpeg para usar vídeos como referencia y para renderizar vídeos.
  • La generación de imágenes en la edición de Claude Code depende de la API o herramienta de imágenes que elijas y pagues.

En colecciones

Herramientas, skills y plugins para Claude CodeFrameworks y apps de agentes de IA open sourceAsistentes y agentes de programación con IAHerramientas y motores para desarrollo de juegos

Temas

#game-development#ai-agent#claude-code#codex#webgl#2d-game#prototyping#procedural-animation

Preguntas frecuentes

¿Qué es ref2game?
Una skill para Claude Code y Codex que convierte una imagen de referencia en un prototipo jugable de un juego 2D para navegador. ref2game toma una captura de pantalla, una ilustración clave o una imagen conceptual y crea un prototipo jugable de un juego 2D para navegador. La generación de imágenes con IA crea el arte pieza por pieza siguiendo el estilo de la referencia, mientras que el movimiento, la iluminación, las partículas, la cámara y el HUD se implementan mediante código en un pequeño motor WebGL2. La página se actualiza en tiempo real mientras trabaja el agente.
¿ref2game es gratuito? ¿Qué licencia tiene?
ref2game es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ref2game sigue mantenido?
Mantenimiento activo. El último commit de ref2game fue el 15 oct 2026.
¿Para qué puedo usar ref2game?
Convertir la captura de pantalla de un concepto de juego en un prototipo interactivo para una presentación o una prueba de juego. Experimentar con géneros de juegos 2D, como plataformas o shooters con vista cenital, a partir de una sola imagen. Crear prototipos de sprites animados a partir de arte conceptual sin tener que construir un rig a mano. Exportar una pequeña versión de un juego para navegador desde una sesión con un agente.
¿Cómo se instala ref2game?
Envía el prompt de instalación a tu agente (Claude Code o Codex) Usa la carpeta claude/ con Claude Code o la carpeta codex/ con Codex En Claude Code, envía /ref2game; en Codex, envía $ref2game, adjuntando la imagen de referencia
¿Dónde consigo ref2game?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/studioigor/ref2game

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados