Repolode
Enviar
studioigor

studioigor/ref2game

Uma skill para Claude Code e Codex que transforma uma imagem de referência em um protótipo jogável de jogo 2D para navegador.

Ver no GitHub
Estrelas
290
Forks
40
Issues abertas
2
Último commit
há 22 dias

O que é?

ref2game recebe uma captura de tela, uma arte principal ou uma imagem conceitual e produz um protótipo jogável de jogo 2D para navegador. A geração de imagens por IA cria a arte peça por peça no estilo da referência, enquanto o movimento, a iluminação, as partículas, a câmera e a HUD são implementados em código em uma pequena engine WebGL2. A página é atualizada em tempo real enquanto o agente trabalha.

O projeto oferece duas edições da mesma skill: a pasta claude/ para Claude Code e a pasta codex/ para Codex. Ambas compartilham a engine, os rigs, as verificações automatizadas e o tratamento das referências. Os sprites são montados com rigs de recortes e membros com dois ossos, então os ciclos de caminhada e os movimentos dos animais são controlados pelas articulações, em vez de mover a imagem inteira.

O pipeline vai de algumas perguntas iniciais a um primeiro frame comparado com a referência e, por fim, a uma build estática jogável com texturas, um manifest e os arquivos-fonte. Cada defeito relatado é corrigido e depois coberto por uma verificação automática, enquanto avaliadores em segundo plano atribuem notas ao asset, ao movimento e à fidelidade do resultado.

Recursos principais

  • 01Gera a arte peça por peça no estilo da referência, enquanto a engine cuida do movimento e dos efeitos.
  • 02Monta personagens com rigs de recortes, membros com dois ossos e medições no nível das articulações.
  • 03Oferece verificações automatizadas de movimento, como deslizamento dos pés e passada.
  • 04Recarrega a página no navegador a cada alteração, preservando o estado do jogo.
  • 05Entrega uma build estática jogável com texturas, manifest e arquivos-fonte.

Casos de uso

  • Transformar a captura de tela de um conceito de jogo em um protótipo clicável para uma apresentação ou teste com jogadores.
  • Experimentar gêneros de jogos 2D, como plataformas ou shooters com visão de cima, a partir de uma única imagem.
  • Criar protótipos de sprites animados a partir de arte conceitual sem montar um rig manualmente.
  • Exportar uma pequena build de jogo para navegador a partir de uma sessão com um agente.

Início rápido

  1. 1

    Envie o prompt de instalação para seu agente (Claude Code ou Codex)

  2. 2

    Use a pasta claude/ com o Claude Code ou a pasta codex/ com o Codex

  3. 3

    No Claude Code, envie /ref2game; no Codex, envie $ref2game, com a imagem de referência anexada

Antes de usar

  • Requer Claude Code ou Codex e funciona apenas no macOS ou Linux.
  • Precisa de Python 3.9 ou superior e Node.js 18 ou superior; o Playwright com Chromium é instalado na primeira execução.
  • ffmpeg é necessário para usar vídeos como referência e para renderizar vídeos.
  • A geração de imagens na edição Claude Code depende da API ou ferramenta de imagem que você escolher e pagar.

Em coleções

Ferramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IAFerramentas e motores para desenvolvimento de jogos

Tópicos

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

Perguntas frequentes

O que é ref2game?
Uma skill para Claude Code e Codex que transforma uma imagem de referência em um protótipo jogável de jogo 2D para navegador. ref2game recebe uma captura de tela, uma arte principal ou uma imagem conceitual e produz um protótipo jogável de jogo 2D para navegador. A geração de imagens por IA cria a arte peça por peça no estilo da referência, enquanto o movimento, a iluminação, as partículas, a câmera e a HUD são implementados em código em uma pequena engine WebGL2. A página é atualizada em tempo real enquanto o agente trabalha.
ref2game é gratuito? Qual é a licença?
ref2game é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ref2game ainda é mantido?
Manutenção ativa. O último commit de ref2game foi em 15 de out. de 2026.
Para que posso usar ref2game?
Transformar a captura de tela de um conceito de jogo em um protótipo clicável para uma apresentação ou teste com jogadores. Experimentar gêneros de jogos 2D, como plataformas ou shooters com visão de cima, a partir de uma única imagem. Criar protótipos de sprites animados a partir de arte conceitual sem montar um rig manualmente. Exportar uma pequena build de jogo para navegador a partir de uma sessão com um agente.
Como instalar ref2game?
Envie o prompt de instalação para seu agente (Claude Code ou Codex) Use a pasta claude/ com o Claude Code ou a pasta codex/ com o Codex No Claude Code, envie /ref2game; no Codex, envie $ref2game, com a imagem de referência anexada
Onde consigo ref2game?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/studioigor/ref2game

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados