📖 Manual de utilização

1. Visão geral

Monte jogos com blocos, teste no palco e exporte um arquivo Python (pygame) que roda sozinho. Tudo acontece neste arquivo HTML — não precisa de servidor nem de internet.

2. Montando scripts

• Arraste blocos da paleta (esquerda) para a área central. Perto de outro bloco aparece um brilho: solte para encaixar.
• Todo script que deve rodar começa com um bloco amarelo (quando 🏁 for clicado, quando a tecla… ou quando eu receber…).
• Arrastar um bloco leva junto os blocos que estão abaixo dele. Soltar sobre a paleta apaga. Duplo clique remove só aquele bloco.
• Blocos repita, sempre e se têm “boca”: encaixe blocos dentro dela. sempre e parar tudo não aceitam blocos abaixo.

3. Campos e expressões

Os campos brancos aceitam números e expressões: x + 10, score * 2, rand(1,6), sin(dir), abs(x). Condições (hexágono) usam and, or, not, ==, <, >. Sensores: key('left') (teclas: left, right, up, down, space, a…z), touching('NomeDoAtor'), mouse_x(), mouse_y(). Do próprio ator: x, y, dir, size. O palco vai de x −240 a 240 e y −180 a 180 (0,0 é o centro).

4. Atores e cenários

＋ Ator e ＋ Cenário abrem uma galeria embutida; Do meu computador… carrega imagens PNG/JPG/GIF/SVG (várias de uma vez). Atores são reduzidos a 128 px e cenários ajustados a 480×360. Altere nome, tamanho (%) e posição abaixo do palco. Clique num cenário para torná-lo o inicial; duplo clique o remove. Use os blocos mude o cenário para e próximo cenário durante o jogo.

5. Variáveis e mensagens

＋ Variável cria um contador exibido no canto do palco. Use faça … = … e mude … em …. Com envie … a todos e quando eu receber … os atores conversam entre si.

6. Salvar e importar

💾 Salvar game baixa um .json com tudo (blocos, imagens, variáveis). 📂 Importar game reabre esse arquivo para continuar editando.

7. Converter para Python

1. Clique em 🐍 Converter para Python: baixa um nome.zip com o jogo descompactado — nome.py mais as pastas imagens/ e sons/.
2. Descompacte e abra a pasta (o .py busca as imagens e os sons ao lado dele, então não importa de onde você rodar).
3. Instale o pygame uma vez: pip install pygame.
4. Rode: python nome.py. Cada script vira uma função Python legível, então você pode estudar e alterar o código.

Se você estiver sem internet na hora de exportar, o botão cai no jeito antigo: um .py só, com as imagens embutidas.

8. Dicas

• Para movimento contínuo use sempre com se tecla … então dentro.
• Use se tocar na borda, volte para não deixar o ator sair do palco.
• Dê nomes diferentes aos atores: touching('Nome') usa o nome.

9. Novidades (Scratch, Tynker e TurboWarp)

• Scratch: diga … por N seg, mude tamanho em, transparência, vá para a frente, estilo de rotação (também na caixa rotação ao lado do nome do ator: girar, só espelhar ou não girar; vale na prévia, no Python e no .sb3) (all gira, lr só espelha esquerda/direita, none não gira — é o bloqueio de rotação), envie … e espere e a tecla any (qualquer tecla) no bloco quando a tecla….
• Tynker (rosa): pule com força e defina o chão (use junto com aplique gravidade) e fim de jogo: texto, que para tudo e mostra a mensagem.
• TurboWarp: o botão ⚙ Projeto muda a taxa de quadros (30/60 FPS, vale também no Python) e liga o modo turbo (só na prévia). Ele também mostra quais blocos cada exportação consegue converter.
• No .sb3, blocos sem equivalente no Scratch (física, transparência, fim de jogo…) são ignorados e o aviso diz quantos.

🎨 Estúdio de desenho

⚙ Projeto (estilo TurboWarp)

Compatibilidade da conversão