
Titanium Piano: Gerando Fases de Jogo de Ritmo com Python e IA
Conheça o Titanium Piano, um jogo de ritmo avançado feito em Python que lê o áudio e gera suas próprias fases em tempo real.
Introdução
Normalmente, jogos de ritmo como Osu!Mania ou Guitar Hero dependem de uma comunidade de criadores dedicados fazendo o trabalho braçal de montar os "beatmaps" para cada música. Mas e se o próprio código lesse a música e fizesse isso por você?
Essa é a premissa principal do Titanium Piano: um jogo de ritmo avançado criado em Python que processa qualquer arquivo MP3 da sua máquina e gera os obstáculos dinamicamente em tempo real. E tudo isso entregue em um pacote visual extremamente polido!
Nesse post, decidi separar alguns dos detalhes técnicos que tornam esse projeto tão especial e por que ele considero um dos meus projetos mais maduros no ecossistema Python.
Arquitetura Híbrida: O Melhor dos Dois Mundos
Jogos clássicos em Pygame frequentemente pecam na construção de Menus UI, que acabam ficando rústicos e difíceis de manter. Para resolver isso, o Titanium Piano tem uma arquitetura dividida:
- O Dashboard: Utilizo o
PyQt5para gerar a tela de seleção de músicas. Isso permitiu o uso de sombras (drop-shadows), blocos coloridos para demonstrar o nível de dificuldade (Stripes) e transições fluidas que funcionam assincronamente e sob demanda — mesmo caso você coloque pastas com centenas giga-bytes de MP3s! - A Engine In-Game: Na hora de jogar, o
Pygame-CE(Community Edition) assume renderizando a gameplay com altíssima performance, partículas visuais nativas e mecânicas fluídas.
As pastas são lidas extraindo nativamente os metadados ID3 tags dos MP3 (através da biblioteca mutagen), descobrindo automaticamente quem é o artista, a duração e o nome da pista de áudio para listá-la bonitinho no menu.
O Coração do Ritmo: Librosa
Para abandonar a criação de fases e depender apenas do áudio, utilizei a fantástica biblioteca genialmente voltada a processamento de dados e Machine Learning de áudio, a Librosa.
O Titanium Piano lê os arquivos e mapeia a energia acústica da música digitalmente. Essa análise gera:
- Identificação de Batidas: Para posicionar as tiles (teclas numéricas) no milissegundo exato;
- Chords e Holds: Identificando picos de energia, ele não gera apenas botões únicos; A música entende e injeta "Notas Seguradas" e vários toques simulâneos (acordes) para enriquecer o nível de desafio.
Partículas, Gameplay e UX
O que tira este jogo do aspecto puramente estudantil foi o foco em "Game Feel":
- Neve e Explosões ao Ritmo: O jogo tem um sistema robusto de partículas pulsantes. Se a batida atinge o clímax, as partículas estouram reagindo à furia da música.
- Tamanhos e Resolução Dinâmicos: Um dos grandes incômodos no
Pygameé o "Hard Coding" de valores. Aqui o tamanho total das canaletas do ritmo redimensiona-se esticamente de acordo com sua janela/monitor. - Segurança e Mecânica de Pause: Ao pausar o jogo (e a música), voltamos não abruptamente; há um prático recuo visual e matemático de 3 segundos fundamentais para re-acomodar a coordenação motora!
As "Cerejas do Bolo" Únicas
Algumas mecânicas fecham a experiência desse jogo, o elevando para tentar ser não só um script, mas um produto polido:
- Baixador Embutido do YouTube: A funcionalidade via
yt-dlppermite não apenas baixar o áudio de um vídeo do YouTube on-the-fly, como também extrair e deduzir automaticamente via script o "Artista" pro seu jogo instantaneamente. - Discord RPC: Totalmente integrado para exibir num Rich Presence do seu Discord o fato de que você está jogando, qual música exata está sendo tocada e dependendo, quão "ferozmente" está agindo!
- Instalador Autônomo Inno Setup: Cansado de obrigar seus amigos a darem
pip install? Criei um encapsulamento total mesclado com Inno Setup, onde uma vez "buildado", gera-se um simples instalador Windows do padrão "Avançar" e "Concluir". O amigo joga e nem sonha que ali roda puro Python!
Conclusão
Construir o Titanium Piano foi de longe um dos estudos que mais forçou os limites da unificação de libs como PyQt, Librosa e Pygame-CE numa coisa perfeitamente empacotada. Lidar com áudio na precisão do milissegundo é insano e extremamente gratificante quando funciona e acerta em cheio nos graves da sua música preferida.
Para experimentar esse gerador ou bisbilhotar como as físicas e a Librosa operam: acesse no repositório open-source exclusivo no meu GitHub (TILES-PYTHON).