paintGame — my first real experience using Codex
gamedevdotnetmauicodexblazor

paintGame — my first real experience using Codex

How I turned a simple idea — building levels from Paint-drawn PNGs — into a playable prototype with architecture, editor tooling and documentation.

4 min read

Eu queria fazer um experimento simples: criar um jogo 2D em que o mapa nasce de um PNG desenhado no Paint.

A ideia parecia quase brincadeira. Cada pixel do arquivo teria uma função: branco seria ar, marrom seria terreno, verde seria o spawn, vermelho seria perigo, amarelo seria objetivo. O PNG não seria a arte final, mas uma máscara técnica, um blueprint que o jogo conseguiria ler e transformar em uma fase jogável.

Foi assim que nasceu o paintGame.

Um jogo feito de cores exatas

O núcleo do projeto é um plataforma 2D lateral feito em .NET MAUI Blazor Hybrid. A regra do jogo fica em C#, enquanto a interface usa Razor, HTML e CSS real dentro do BlazorWebView.

O fluxo principal é direto:

  1. O jogo encontra um PNG em Maps/Official ou Maps/Custom.
  2. Cada pixel é interpretado por uma legenda de cores.
  3. O domínio transforma essas cores em células lógicas.
  4. O runtime monta a fase, posiciona o jogador e aplica movimento, gravidade e colisão.
  5. O Blazor renderiza tudo como uma janela de jogo.

O detalhe que mais gosto é que o Paint vira uma ferramenta de level design. Não precisa de editor complexo para começar uma fase: basta respeitar a paleta.

Arquitetura antes da pressa

Mesmo sendo um protótipo, eu não queria deixar tudo misturado. O projeto foi organizado em camadas:

  • Domain, para regras puras de mapa, colisão, movimento e jogador.
  • Application, para casos de uso como carregar mapa, iniciar gameplay e coordenar o editor.
  • Infra, para leitura de arquivos, PNGs, JSON e assets.
  • Interfaces, para adaptar entrada, renderização e serviços de janela.
  • Components, para a UI em Razor.

Essa separação ajudou muito quando o projeto começou a crescer. A UI não decide regra de fase. O editor não precisa invadir o runtime. O PNG exportado continua sendo um contrato simples.

O que já entrou no protótipo

O paintGame evoluiu rápido.

Entraram movimento suave, pulo, gravidade, agachar, câmera acompanhando o jogador, fullscreen, lista de mapas, configurações, editor de mapas em janela própria, salvar/abrir projeto, exportar PNG, playtest, undo/redo, hotkeys, propriedades contextuais, preview de grade, suporte Android/Windows e melhorias para mapas grandes.

Também entraram decisões importantes de performance: catálogo assíncrono de mapas, editor mais leve para touch, camada visual virtualizada e índice espacial de colisão. Em mapas maiores, o jogo deixa de pensar no mundo inteiro a cada frame e passa a consultar apenas o que está perto do jogador.

Outra melhoria que mudou bastante a sensação de jogo foi a subida automática em rampas e escadas. O jogador consegue andar por terrenos inclinados sem precisar pular em cada degrau, mantendo a leitura de plataforma mais natural.

O editor virou parte do jogo

Uma das partes mais legais foi perceber que o editor não era só uma ferramenta auxiliar. Ele virou uma peça central do projeto.

A ideia é permitir criar um projeto editável, pintar a grade, selecionar ferramentas, ajustar propriedades, validar erros, testar o mapa e exportar um PNG pronto para Maps/Custom.

O runtime continua simples: ele lê o mapa final. O editor pode guardar mais informação em JSON, como propriedades, layout e metadados, mas o contrato jogável continua sendo um PNG válido.

Isso deixa o projeto com uma base interessante: simples para criar, mas organizado para crescer.

Minha primeira experiência com o Codex

Esse projeto também marcou minha primeira experiência real usando o Codex como parceiro de desenvolvimento.

Minha opinião sincera: foi ótimo. Melhor do que eu esperava.

O que mais me surpreendeu não foi só gerar código. Foi a combinação de entender contexto, ler documentação, respeitar arquitetura, atualizar walkthroughs, propor cortes pequenos, encontrar bugs e manter o projeto coerente enquanto ele crescia.

Eu usei o Codex para pensar junto, documentar mecânicas, implementar componentes, revisar decisões e transformar ideias soltas em tarefas concretas. As skills ajudaram principalmente nessa parte: seguir padrões de engenharia, trabalhar com UX/UI, estruturar documentação e manter a evolução do projeto registrada.

Foi uma sensação diferente de usar uma IA como autocomplete. Pareceu mais uma colaboração técnica: eu trazia direção, intenção e gosto; o Codex ajudava a transformar isso em arquitetura, código e documentação.

O aprendizado

O paintGame começou com uma pergunta pequena: "e se um PNG desenhado no Paint virasse uma fase?"

Agora ele já tem uma base de plataforma, um editor, documentação técnica, compatibilidade entre Windows e Android e um caminho claro para evoluir.

Ainda é um projeto em desenvolvimento, mas ele já me ensinou algo importante: protótipos simples ficam muito mais fortes quando a ideia divertida vem acompanhada de arquitetura, documentação e iteração constante.

Código fonte:

github.com/ChickChuck2/paintGame