Copa Aspirador: um jogo de futebol de robôs aspiradores feito em Python que roda no navegador

· Python, pygame, WebAssembly, Game Dev, Pixel Art

Copa Aspirador é um jogo que eu fiz: futebol arcade 5 contra 5 em que os jogadores são robôs aspiradores. Ele é escrito 100% em Python com pygame e roda direto no navegador, sem instalar nada, em copaaspirador.brunokobi.tech. Começou como um futebol simples e virou um RPG de robôs com campanha, carreira de clubes, torcida que canta e narrador. Este post mostra o que o jogo faz hoje e os desafios para chegar até aqui.

Menu principal do Copa Aspirador com os seis modos de jogo
O menu: amistosos, carreira, Modo Robôs e a campanha. O slogan resume o jogo.

TL;DR


1. O jogo hoje

Partidas de robôs

Cada robô tem um de 6 chassis (Disco, Tanque, Velocista, Goleiro, Orbital e Titã) e 8 atributos: velocidade, aceleração, chute, controle (sucção), defesa, visão, bateria e QI. Eles mudam de verdade o comportamento em campo: a bateria gasta ao correr e chutar e recarrega parado, e robô com bateria baixa solta faísca e fumaça. Há 5 formações, de RETRANCA a PRESSÃO, que mudam onde cada robô fica e para onde volta.

Partida na câmera de estádio, com a torcida comemorando o gol e o narrador na faixa de TV
Câmera de estádio: torcida nas cores dos times, faixas na grade, "GOOOOL!" e o narrador Tonho na faixa de TV.

Em volta do campo fica uma torcida de até cerca de 520 pessoas, cada uma com pele, cabelo, chapéu, camisa e cachecol sorteados. Ela reage a gol, chance, defesa e trave, faz ola e mosaico e puxa cânticos nas pausas. O piso muda a cada partida: arena neon ou um piso de casa, como cozinha em xadrez ou taco de madeira, afinal são aspiradores jogando dentro de casa. O narrador Tonho e a comentarista Cleide comentam lance a lance com o nome dos robôs.

Robôs personalizados em campo na câmera aproximada
Câmera PERTO: robôs com peças visíveis, anel de LED, barra de bateria e cosméticos.

A campanha: A Garagem do Vô

O modo história segue o Téo, que acha na garagem do avô o Zé Poeira: um Aspiradex Turbo 74 remendado com fita crepe, com uma rodinha que cai sozinha e um chinelo preso ("o chinelo é estrutural"). Com ele, Téo tenta salvar o clube de robótica da escola e acaba enfrentando a corporação Limpex e seu dono alérgico a pó, da Copa Interclasses ao Mundial de Aspiradores em Neo-Tóquio.

Diálogo da campanha com personagens em pixel art
Diálogos com personagens em pixel art que piscam, mexem a boca e mudam de expressão.

São 3 atos e 13 capítulos, com torneios de copa, liga e série de duelos, 14 missões secundárias, escolhas que mudam aliados e adversários e 3 finais, um deles secreto. Depois do final abrem a Turnê Lendária (novo jogo+) e a Torre do Pó, com 40 andares e modificadores de arena como goleiro gigante e bola pesada.

Mapa da campanha com os capítulos da escola ao Mundial
O mapa do Ato 1, da escola ao Mundial, com o escudo do chefe de cada capítulo.

Garagem, peças e habilidades

No Modo Robôs e na campanha você monta e evolui a equipe: 8 slots de peças por robô, sets, relíquias, peças Míticas, 16 habilidades numa árvore de Ataque, Controle e Defesa, itens de partida e cosméticos como antena, adesivo e rastro. Cada peça mostra o antes e o depois nos atributos.

Garagem com a bancada de oito slots de peças
A garagem: 8 slots, sets e relíquias, com o efeito de cada peça.
Árvore de habilidades dos robôs
A árvore de habilidades e a tática do time.

Carreira de clubes

Na carreira, no estilo Elifoot, você é o técnico: 24 clubes em 3 divisões, mercado de transferências, finanças, promoção e rebaixamento. Os jogadores são robôs com nome de robô ("Zumbido", "Faísca", "Turbo Mk2"...), tirados de um catálogo de cerca de 4,7 mil nomes. No lugar da idade, eles têm horas de uso: amaciando, auge, desgaste e fim de vida, quando vão para a reciclagem. Dá para mandar um robô para a revisão e ganhar mais uma temporada dele.

Elenco da carreira com robôs, horas de uso e revisão
O elenco: horas de uso coloridas pela fase e o botão de REVISÃO.

128 escudos sem nenhuma imagem

Todos os 128 times têm escudo em pixel art, gerado por código a partir do nome: formato, padrão nas cores do time, um símbolo de 15×15 pixels (tubarão, dragão, coroa, aspirador-robô, pão, vassoura...) e as iniciais. O mesmo nome gera sempre o mesmo escudo, e os chefes da campanha ganham coroa, estrelas e louros.

Grade com os 128 escudos dos times
Os 128 escudos, todos desenhados por código.
Cartão de melhor do jogo com as estatísticas da partida
Fim de partida: estatísticas, nota de cada robô e o MELHOR DO JOGO.

2. Os desafios da implementação

Python no navegador

O pygbag empacota o código e os recursos num arquivo game.apk e roda o Python compilado para WebAssembly dentro da página. Funciona muito bem, mas tem regras próprias:

Desempenho: zero Surface por quadro

No WebAssembly o pygame é bem mais lento que no desktop, e uma torcida de centenas de pessoas animadas a cada quadro derrubaria o jogo. A regra do projeto virou lei e tem teste: nenhuma `pygame.Surface` nova é criada durante o desenho de um quadro. Tudo é pré-renderizado: torcedores num atlas, escudos e robôs em cache, e o desenho só copia pedaços prontos. A torcida tem 3 níveis de detalhe automáticos e some na velocidade MAX.

O orçamento é de até 1,5 ms de desenho por quadro no desktop (cerca de 3 ms estimados no navegador). Uma ferramenta de medição roda o desenho em modo sem tela e compara com a medida anterior a cada mudança grande.

Áudio: síntese, gravações e um bug de taxa

O som começou 100% sintetizado por código: efeitos e músicas chiptune gerados com math e array. Depois entraram gravações reais de torcida, apito, "acabou!" e até uma caixa registradora, e a síntese virou o plano B se algum arquivo faltar. Para não travar o menu, a geração é feita aos poucos: no navegador leva cerca de 1,2 s de CPU, espalhados em quase 2 s, com o menu respondendo.

Deploy sem cache velho

Depois de publicar uma versão nova, alguns navegadores continuavam abrindo o pacote antigo. Um script agora acrescenta ao index.html do build um parâmetro com o hash do pacote:

game.apk?v=<sha256 curto do game.apk>

Cada deploy muda a URL do pacote, e nenhum cache serve a versão anterior. Outro detalhe: o pygbag converte os áudios e só refaz a conversão quando a cópia não existe, então trocar um .ogg exige apagar a cópia antiga, senão o som velho vai para o pacote.

Balanceamento medido, não chutado

Partidas que você assiste rodam no motor real; as que você manda SIMULAR usam um modelo estatístico, muito mais rápido. Os dois precisam dar resultados parecidos, senão simular vira trapaça. Para isso há scripts que jogam centenas de partidas no motor real e ajustam o simulador. A campanha inteira é jogada por simulação centenas de vezes para conferir a chance de vencer cada treino, jogo, semifinal e chefe.

E para mudanças no motor não alterarem partidas sem querer, existem os goldens: 80 placares gravados que precisam sair idênticos depois de qualquer mudança. Todo recurso novo do motor fica atrás de uma opção desligada por padrão, para os 80 placares continuarem iguais.

Saves que nunca se perdem

O jogo cresceu muito depois de publicado, então os saves mudaram de formato várias vezes: da campanha de um ato para três, de jogadores com nome de pessoa e idade para robôs com horas de uso. Cada save tem versão e uma migração que só acrescenta. Um save inválido nunca é sobrescrito sem confirmação, e um build antigo que encontra um save novo o trata como desconhecido em vez de apagar. Os testes usam 4 saves reais do capítulo 5 para garantir a migração.


3. Em números

4. O que vem por aí


Principais lições

  1. Python roda no navegador de verdade. O pygbag torna isso viável, desde que o loop seja assíncrono e você respeite o navegador.
  2. Uma regra de desempenho com teste vale mais que otimizar no fim. "Zero Surface por quadro" segurou o desempenho enquanto torcida, efeitos e telas novas entravam.
  3. Gerar arte por código escala. 128 escudos e dezenas de personagens sem desenhar uma imagem sequer.
  4. Balanceamento é medição. Simulação em massa e placares de referência evitam que o jogo fique fácil ou impossível sem você perceber.
  5. Respeite o save do jogador. Versão, migração e nunca apagar.

Quer ver tudo isso funcionando? Jogue em copaaspirador.brunokobi.tech. O código está no GitHub em github.com/brunokobi/soccerrobo.

Todos os posts