Assemble3

Wiki

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

  1. Baixe o kit e o guia (abaixo) e coloque-os numa pasta de trabalho.
  2. Rode bash tools/setup.sh uma vez. Ele baixa o núcleo do motor (libGD) e confere as demais dependências.
  3. Abra seu assistente de IA na pasta, dê o guia em PDF a ele e peça o jogo.
  4. Receba o .a3p e 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 .a3p codificado.
  • 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.