Criar jogos com IA: Assemble3 AI Toolkit
O AI Toolkit é um kit para que um agente de IA (como o Claude Code ou outro assistente que rode comandos) transforme uma ideia em um jogo completo e testado, entregue como um arquivo .a3p que abre direto no editor.
Você escreve o pedido em português, a IA projeta o jogo, desenha as imagens, gera os sons, monta os eventos, testa e entrega o arquivo.
Exemplo de pedido: "Faça um jogo de plataforma onde um sapo pula entre vitórias-régias e coleta moedas. Tem 3 vidas, pontuação na tela e uma tela de fim de jogo. Textos em português."
O que vem no kit
| Arquivo | Para quê |
|---|---|
| Assemble3 AI Game Builder Guide (PDF, 106 páginas) | O manual que a IA lê: formato do projeto, regras de eventos, receitas testadas e lista de tudo que existe no editor. |
a3lib.py |
Biblioteca em Python para descrever o jogo (objetos, layouts, eventos) sem escrever o JSON à mão. |
tools/validate.js |
Valida cada instrução, parâmetro e expressão com o núcleo real do motor (libGD) e conta os eventos. |
tools/export.js |
Exporta o jogo para HTML5. |
tools/playtest.js |
Joga o jogo num navegador sem tela (Chromium), confere o estado e tira capturas de tela. |
tools/a3p.py |
Codifica e decodifica arquivos .a3p. |
tools/meta.js e reference.json |
Consulta de todas as condições, ações e expressões disponíveis. |
samples/ |
Três jogos completos de exemplo, com os testes. |
Como funciona
A IA segue um processo de nove passos, descrito no guia:
| Passo | O que acontece |
|---|---|
| 1. Projeto | O pedido vira mecânicas, telas, objetos, variáveis e um plano de eventos, dentro do limite do plano. |
| 2. Arte e sons | Imagens (Pillow) e sons (numpy → WAV) são gerados por código. A IA confere uma folha de contato das imagens. |
| 3. Montagem | O jogo é descrito em Python com a3lib.py. |
| 4. Validação | validate.js confere tudo com o motor real. |
| 5. Exportação | export.js gera o HTML5 de verdade. |
| 6. Teste | playtest.js joga o jogo e tira capturas, que a IA olha. |
| 7. Correções | A IA ajusta o que não ficou bom e repete os passos 4 a 6. |
| 8. Codificação | a3p.py cria o .a3p final. |
| 9. Entrega | Você recebe o arquivo, uma captura e um resumo: controles, mecânicas, variáveis para ajustar e número de eventos. |
Um jogo completo em 25 linhas
Este é o menor jogo do guia: clique na caixa para ganhar pontos.
from PIL import Image, ImageDraw
from a3lib import *
import os
os.makedirs('assets', exist_ok=True)
img = Image.new('RGBA', (120, 120))
ImageDraw.Draw(img).rounded_rectangle([4, 4, 115, 115], 20, fill=(0, 200, 180), outline='white', width=6)
img.save('assets/caixa.png')
p = Project('Clique na Caixa', 960, 540)
p.image('assets/caixa.png')
p.add_object(simple_sprite('Caixa', 'caixa.png'))
p.add_object(text('TextoPontos', 'Pontos: 0', 36, (255, 255, 255)))
lay = p.layout('Jogo', background=(30, 30, 60), layers=['', 'UI'])
lay.instance('Caixa', 480, 270)
lay.instance('TextoPontos', 20, 20, 'UI')
lay.variables = [num('Pontos')]
lay.events = [
COMMENT('Clique na caixa para ganhar pontos!'),
E(clicked('Caixa'), [set_var('Pontos', '+', '1'), set_scale('Caixa', '=', '1.2')]),
E([], [set_scale('Caixa', '=', 'max(1, Caixa.ScaleX() - 2 * TimeDelta())'),
set_text('TextoPontos', '"Pontos: " + ToString(Pontos)')]),
]
p.save_json('caixa.json')
Depois, valide e codifique:
node tools/validate.js caixa.json caixa.rt.json
python3 tools/a3p.py encode caixa.rt.json CliqueNaCaixa.a3p
Como usar
- Baixe o kit e o guia (abaixo) e coloque-os numa pasta de trabalho.
- Rode
bash tools/setup.shuma vez. Ele baixa o núcleo do motor (libGD) e confere as demais dependências. - Abra seu assistente de IA na pasta, dê o guia em PDF a ele e peça o jogo.
- Receba o
.a3pe abra no editor: ☰ ou Abrir → Arquivo….
Requisitos
- Python 3 com Pillow (e numpy para sons).
- Node 22.
- Playwright com Chromium, para os testes de jogo.
- Para exportar e testar o jogo, o kit precisa do runtime compilado do jogo (GDJS), que faz parte do código-fonte do Assemble3. Sem ele, ainda dá para montar, validar e codificar o
.a3p, e testar o jogo abrindo-o no editor.
O que a IA respeita
O guia traz regras que evitam os erros mais comuns:
- Toda instrução leva todos os seus parâmetros, na ordem.
- Toda variável usada em uma expressão é declarada antes.
- O projeto respeita o limite de eventos do plano (250 por padrão).
- O comportamento Plataforma pula com a seta para cima.
- Teclas que trocam de tela usam tecla liberada.
- Nunca entrega sem validar, exportar e jogar o teste.
- Textos em português, sem violência, com arte e fontes de licença livre.
O que a IA entrega
- O arquivo
.a3pcodificado. - Uma captura de tela do jogo rodando.
- Um resumo com controles, mecânicas, variáveis ajustáveis e número de eventos.
- O que ela não conseguiu verificar, como o comportamento exato dentro da interface do editor.
Revise sempre. Abra o jogo no editor, jogue e leia os eventos. Um jogo feito por IA é um ponto de partida para você aprender e modificar: os eventos são os mesmos que você escreveria à mão.
Baixar
Depois de abrir um jogo feito pela IA, siga com Eventos e Comportamentos para entender e mudar o que ela criou.