For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme
Nov 9, 2026 Codex

Como criar um jogo retrô para um console portátil com o Codex e o ModRetro Chromatic

Com o plugin ModRetro Chromatic para o Codex, você pode criar qualquer jogo que imaginar e jogá-lo no ModRetro Chromatic.

Autor: Kevin Whinnery

Como criar um jogo retrô para um console portátil com o Codex e o ModRetro Chromatic

Com todo o respeito ao iPhone, talvez o Game Boy seja o aparelho portátil mais icônico de todos os tempos. Uma geração de crianças pulou em cima de Koopas no ônibus e usou o cabo link para desafiar os amigos em batalhas de Pokémon. Tudo isso em um aparelho que cabia no bolso. Ou pelo menos no bolso da mochila.

Com os poderosos modelos de programação de hoje e ferramentas como o Codex, nunca foi tão fácil criar seus próprios jogos (nem tão divertido, na minha opinião). Mas jogar em um aparelho feito para isso, como o Game Boy Color, tem um encanto difícil de reproduzir. Por isso, estou animadíssimo para contar que o plugin da ModRetro para o Codex permite criar jogos de Game Boy Color e jogá-los em um Chromatic.

Encomende a edição especial do ModRetro Chromatic.

Vamos ver como funciona.

Instale o plugin

  1. No aplicativo do ChatGPT para computador, selecione Codex no menu suspenso ChatGPT.
  2. Abra Plug-ins e procure por ModRetro Chromatic. Selecione ModRetro Chromatic Plugin, da ModRetro, e clique em Instalar.
  3. Abra uma pasta de projeto local e inicie um chat. Digite @ e selecione o plugin para que o Codex saiba quais ferramentas usar.
  4. Peça ao Codex que configure o plugin e verifique se falta alguma ferramenta de compilação. Você pode criar e jogar seu primeiro jogo no próprio computador.

Crie seu primeiro jogo com um prompt

Com o plugin selecionado no chat do Codex, descreva o jogo que você quer criar. Para acompanhar o vídeo, use este exemplo de prompt.

Crie um jogo de aventura com visão de cima chamado Lodge Podge. Nele, um castor em pixel art precisa roer árvores pequenas até derrubá-las e juntar galhos para construir sua toca no centro da fase.

Em seguida, peça ao Codex que compile o jogo e abra a prévia. Você também pode pedir que ele mostre onde encontrar estes arquivos na pasta do seu projeto do GB Studio.

  • Abra o arquivo .gbsproj no GB Studio para editar cenas, atores e eventos.
  • Na pasta assets/, você encontra as folhas de sprites, os planos de fundo e os arquivos de áudio usados no projeto.
  • Execute o arquivo .gbc compilado em um emulador ou instale-o em um cartucho.
Três telas do jogo mostram, em pixel art, um castor e sua toca à beira de um lago.

Jogue algumas partidas e diga ao Codex o que deixaria o jogo mais divertido. Em Lodge Podge, pedi ao Codex que deixasse o castor mais rechonchudo (para ficar o mais fofo possível) e que, para construir a toca, o castor tivesse que juntar lama e folhas além dos galhos.

O que o plugin oferece

O plugin ModRetro Chromatic inclui ferramentas de desenvolvimento que o modelo pode usar por você.

Anime um personagem

Peça ao Codex que crie uma folha de sprites e mostre os quadros lado a lado. Para ajustar a animação, indique a pose ou a direção que você quer mudar e peça ao Codex que gere a prévia novamente.

Folha de sprites com seis poses do castor, visto de frente, de costas e de lado.

Crie um mapa pelo qual o jogador possa andar

Peça ao Codex que mostre, lado a lado, o plano de fundo de uma cena e o mapa de colisão. Esse mapa indica quais blocos impedem a passagem. Use o plano de fundo para localizar a área que você tem em mente e diga ao Codex quais blocos marcar como bloqueados ou transitáveis.

Plano de fundo de uma cena ao lado da mesma cena com os blocos que impedem a passagem destacados em vermelho.

Jogue a ROM no Codex

Peça ao Codex que abra a prévia do jogo no navegador integrado. Use as teclas de seta como direcional do Game Boy, Z para o botão A, X para o B e Enter para o Start. Use a barra de ferramentas acima do emulador para pausar ou retomar o jogo.

Lodge Podge em execução na prévia do Chromatic no Codex.

Indique a parte que você quer alterar

Selecione Annotate game na barra de ferramentas da prévia e clique na tela do jogo para congelar um quadro. Selecione o sprite, o bloco ou a área que você quer alterar e descreva a mudança. Selecione Resume game para voltar ao emulador. Depois que o Codex fizer a alteração, peça que ele recompile a ROM e reabra a prévia.

Emulador pausado com a ferramenta de anotação selecionada na barra de ferramentas.

Peça ao Codex que teste uma sequência de movimentos

Você também pode controlar o emulador pelo chat. Peça ao Codex que execute a ROM, pressione uma sequência de botões no emulador e capture um quadro após cada etapa. Peça que ele mostre os quadros lado a lado para que você possa compará-los.

Três quadros do emulador lado a lado, cada um identificado pelo respectivo número.

Edite o jogo no GB Studio

O GB Studio é um editor visual para criar jogos de Game Boy. Abra o arquivo .gbsproj do projeto e selecione Game World. Selecione uma cena no painel de navegação para ver as propriedades dela na barra lateral. Você pode arrastar um ator para outro bloco ou editar as colisões diretamente na cena. Salve o projeto, volte ao chat do Codex e peça que ele recompile o jogo e abra a prévia. O guia de cenas do GB Studio explica como os planos de fundo, os atores e os gatilhos funcionam em conjunto.

A tela Game World do GB Studio mostra as cenas Survey stakes e Woven walls de Lodge Podge.

Outras opções de desenvolvimento

  • Amplie um jogo criado no GB Studio. Se os eventos integrados não derem conta de uma mecânica do jogo, você pode adicionar um evento personalizado em GBVM, a linguagem da máquina virtual do GB Studio, ou estender o motor do jogo em C. Consulte o guia de plugins do GB Studio.
  • Escreva o jogo em C com o GBDK-2020. O plugin da ModRetro pode compilar código C independente com o compilador lcc do GBDK. As APIs de Game Boy do GBDK dão acesso a botões, sprites, blocos e paletas de cores. Para começar, peça ao Codex que crie um loop de jogo que leia a entrada do direcional e mova um único sprite.
  • Escreva seu próprio motor de jogo. Você pode pedir ao Codex que implemente do zero o loop do jogo, a rolagem da tela e as colisões. Para um projeto em assembly, compile a ROM com um conjunto de ferramentas instalado separadamente, como o RGBDS. Depois, passe o arquivo .gb ou .gbc gerado para o plugin inspecionar e testar o jogo.

Instale o jogo no console

Você vai precisar de um Chromatic, de um cartucho regravável compatível com jogos homebrew e de um cabo USB de dados. Siga o guia de início rápido da ModRetro para atualizar o firmware e ativar o modo de desenvolvedor usando o computador ao qual você vai conectar o console.

  1. Insira o cartucho no Chromatic, conecte o console ao computador e abra a prévia do jogo no chat local do Codex.
  2. Selecione Install on Chromatic, escolha o dispositivo conectado e clique em Install. Leia a mensagem de confirmação com atenção. Gravar a nova ROM apaga o jogo que está no cartucho e pode apagar o progresso salvo. O instalador não faz backup do cartucho.
  3. Quando estiver pronto para gravar, selecione Confirm Install. Mantenha o cabo conectado até o plugin informar que a instalação foi concluída com sucesso. Em seguida, inicie o jogo no Chromatic.

“O poder da ciência é impressionante!”

Com o plugin da ModRetro para o Codex, você pode criar jogos originais de Game Boy Color com prompts e usar todas as ferramentas da comunidade de desenvolvimento homebrew para GBC, que está a todo vapor. Isso vai ser divertido demais. Você pode encomendar seu ModRetro Chromatic e conhecer os outros projetos da ModRetro. Divirta-se programando para o Game Boy!