Guia passo a passo — escrito pra quem nunca usou um computador pra programar.
👋 BEM-VINDO!
Este manual leva uns 10 minutos pra ler. Depois dele você consegue abrir um jogo, jogar, mudar o código, salvar e até levar pro Raspberry Pi.
Não precisa saber nada antes. Vai dar tudo certo.
📋 ÍNDICE
É um site onde você escreve código Python e vê o jogo rodar na tela na hora — sem instalar nada no computador.
Funciona em qualquer aparelho com navegador: PC, notebook, celular ou tablet.
Quando você tiver o Raspberry Pi, é só clicar em 'Baixar .py' e o mesmo código vai funcionar nos botões físicos.
No menu de cima, clique em JOGOS. Você vai ver uma galeria com os 8 jogos prontos.
Escolha um (sugerimos começar pelo SNAKE — é o mais simples) e clique em ABRIR NO EDITOR.
Pronto! Você está no Studio. À esquerda fica o código, à direita a tela do jogo.
Aperte o botão verde PLAY na parte de cima da tela do jogo.
Na primeira vez vai demorar uns 15-30 segundos — o Python está sendo baixado para o seu navegador. Da segunda vez é instantâneo.
Quando aparecer 'Python pronto', use as setas do teclado (ou os botões na tela) para jogar.
Setas do teclado: movimentam o personagem (cima, baixo, esquerda, direita).
Z = Ataque · X = Especial · C = Ultimate · V = Transformar.
S = Salvar · Q = Sair do jogo.
Quem prefere clicar: os mesmos botões aparecem na tela, abaixo da janela do jogo.
O painel da esquerda é o EDITOR. Tudo que está escrito ali é o código do jogo, em Python.
Procure por linhas com números — por exemplo VELOCIDADE = 5. Mude para VELOCIDADE = 15 e aperte PLAY de novo.
Pronto: você acabou de modificar um jogo! Brinque com as cores, tamanhos e velocidades pra ver o que cada um faz.
O Vits Studio salva tudo SOZINHO no seu navegador. Não precisa apertar nenhum botão.
Pode fechar o site e voltar amanhã que seu código continua lá.
Atenção: se você usar OUTRO computador ou navegador, vai ver os jogos originais — o save fica só na máquina onde você editou.
No alto, ao lado das abas, tem um botão com um '+'. Clique nele.
Dê um nome (ex: 'meu-jogo') e pronto: você tem um arquivo Python em branco com o esqueleto de um jogo Pygame.
Vá na aba APRENDA do menu pra entender como funciona o loop de jogo, os botões GPIO e os erros mais comuns.
Quando o Pi chegar, abra o jogo que você quer levar e clique em BAIXAR .PY PARA O PI (canto superior do editor).
Vai descer um arquivo .py para o seu computador. Coloque ele no Raspberry pelo pen drive ou pela rede.
No Pi, abra o terminal na pasta do arquivo e rode: python3 nome_do_jogo_pi.py
O download já troca a linha 'from gpio_web' por 'from gpiozero' automaticamente — então os botões físicos funcionam de primeira.
No header da tela do jogo, aperte o botão 'Tela cheia' para o canvas ocupar a tela toda.
No celular, ele tenta deitar a tela automaticamente (modo paisagem) — ótimo pra jogar deitado.
Aperte 'Esc' (PC) ou o mesmo botão (mobile) para sair.
Os jogos prontos já tocam sons (tiros, pulos, game over) usando o módulo vits_audio.
Para silenciar tudo, use o botão 🔊/🔇 no canto superior direito do Studio (sua escolha fica salva).
No seu próprio código, é só importar e chamar:
import vits_audio
vits_audio.bip(440, 0.1) # frequência, duração
vits_audio.pulo()
vits_audio.explosao()
vits_audio.pontuacao()
Quando o jogo está rodando, aparece um D-pad à esquerda e botões de ação à direita, sobre a tela.
Eles funcionam com multi-touch — pode segurar 'direita' e apertar 'ataque' ao mesmo tempo.
Cada toque vibra levemente (se o celular suportar).
Quando seu código tem input("Escolha: "), no Raspberry Pi a pessoa digita no terminal.
Aqui no Vits Studio (navegador), o mesmo input() abre uma CAIXINHA na tela pra digitar a resposta — é o jeito do navegador funcionar.
Ou seja: o MESMO código funciona nos dois lugares. Você não precisa mudar nada.
Se aparecer OSError [Errno 29] I/O error mesmo assim, atualize a página (F5) — o Vits foi melhorado pra resolver isso e pode ter ficado uma versão antiga em cache.
Aperte STOP, espere 2 segundos e aperte PLAY de novo.
Se continuar, abra o CONSOLE (caixa preta embaixo). A mensagem em vermelho ali em cima vai dizer onde está o erro.
O Python é chato com espaços. Toda vez que uma linha começa 'pra dentro', use exatamente 4 espaços (ou 1 TAB).
Nunca misture espaço com TAB. Se o editor estranhar, apague o começo da linha e digite 4 espaços de novo.
Pode ser loop infinito. Aperte STOP — o navegador às vezes fica pesado.
Se for muito frequente, atualize a página (F5) e abra de novo.
Manda mensagem no WhatsApp do suporte: (64) 99229-6991. Pode mandar print da tela pra ajudar.
PRONTO PRA COMEÇAR?
Abra um jogo agora e siga o passo 3 do manual.
Sistema desenvolvido por Leonardo Souza — Todos os direitos reservados.