MagicDeath — Testing Front and Backend performance with a cute (and deadly) game
gamedevpythonfastapijavascriptestudo

MagicDeath — Testing Front and Backend performance with a cute (and deadly) game

A duo project focused on web architecture, procedural generation, and the balance between Python FastAPI and Vanilla JS.

3 min read

A melhor forma de aprender como duas tecnologias se conversam não é fazendo outro To-Do list. É levando elas ao limite.

MagicDeath 🌸💀 nasceu com esse propósito. Foi um trabalho de estudos que desenvolvi em dupla. Queríamos testar a performance e a estabilidade de um ecossistema com Frontend e Backend separados, mas rodando mecânicas contínuas de um jogo.

E, claro, decidimos fazer isso embalado em um jogo fofo, com estética rosa, mas cheio de inimigos bizarros.

O Desafio da Arquitetura

O jogo roda no navegador, mas funciona com uma arquitetura de aplicação pesada:

Backend: Python + FastAPI

Escolhemos o ecossistema Python (FastAPI rodando no Uvicorn) para ser o cérebro da engine. Ele não apenas serve os arquivos, mas lida com o estado. Para gerenciar o ciclo de vida do jogo sem vazamento de memória ou conflito de estados, implementamos metodologias GoF (Design Patterns). O nosso GameManager foi construído usando o núcleo do padrão Singleton, garantindo que as instâncias do mundo e dos jogadores rodassem unificadas.

Frontend: Vanilla JS de alta performance

Ao invés de frameworks como React, fomos direto no Vanilla JavaScript, construindo sistemas de áudio (AudioManager.js), renderização de efeitos (EffectManager.js) e lógicas de câmera dinâmica simulando o acompanhamento fluido dos jogos antigos do Mario. O foco era performance bruta.

Também criamos um modo "App". Se o usuário rodar pelo CLI (python run.py), o jogo abre silenciosamente uma instância do Chrome/Edge em --app=, se disfarçando perfeitamente sob os panos como um executável de Desktop nativo.

Geração Procedural: FBM e Perlin Noise

Criar mapas na mão não é divertido depois da quinta vez. A resposta natural foi focar na geração procedural. O mundo é praticamente infinito, gerado por camadas e focado em algoritmos como Perlin Noise combinado com Fractal Brownian Motion (FBM), criando montanhas suaves em tempo real e definindo limites.

Isso nos permitiu criar três limites geográficos bizarros:

  1. Bioma Mágico 🌸: A área inicial da nossa heroína, Lilya. Árvores rosas, campos fáceis e pôneis mortais.
  2. Bioma Mágico Corrompido 🥀: Onde o algoritmo corta a magia base. Os tons escurecem, e entidades de madeira e corvos dominam o céu.
  3. Bioma de Carne / Sombras 🥩🌑: O auge da loucura gerada pelo algoritmo. Criaturas puramente carnívoras e olhos gigantes.

O Aprendizado

Sincronizar a dinâmica de spawn de inimigos na lógica Python e animá-los de forma leve no Vanilla JS nos ensinou gargalos de performance que eu jamais veria construindo um site de formulários comum. Descobrir que podíamos empacotar tudo em um executável autônomo e focar numa estética dualística provou que aprender desenvolvimento de software brincando é o método mais eficiente que existe.

As lições aprendidas aqui ditaram grande parte de como eu arquiteto código limpo até hoje.

Código Fonte

Se quiser dar uma olhada em como essa loucura funciona por debaixo dos panos, o repositório deste estudo está disponível no meu GitHub de estudante:

🔗 Acessar o Repo do MagicDeath - GitHub