1

Pitch: Como colocamos o MU Online clássico para rodar no navegador e no celular

OpenMU — MU Online Season 6 no navegador

Quem jogou MU Online lá por 2005 lembra do ritual: baixar um client de quase 1 GB, rodar o main.exe, torcer para o DirectX não reclamar. Resolvemos ver até onde dava para levar o MU Season 6 para o navegador, sem instalar nada, inclusive no celular. O resultado é o OpenMU, um servidor brasileiro que hoje roda assim. Neste post eu conto as partes técnicas que deram mais trabalho.

O ponto de partida: projetos abertos

Não começamos do zero, e é justo dar o crédito:

  • Servidor: MUnique/OpenMU, uma reimplementação open source do servidor de MU em C# / .NET com PostgreSQL.
  • Client web: Ignies/OpenMu-Client-Babylon, feito em TypeScript + Babylon.js, que nasceu do JSClient do afrokick.

Nós mantemos forks dos dois (servidor com plugins próprios, client com dezenas de mudanças) e a ideia é devolver aos projetos originais o que for genérico.

Problema 1: o navegador não fala TCP

O protocolo do MU é binário e roda em TCP puro: pacotes com cabeçalho C1/C2 (sem criptografia) e C3/C4 (criptografados). O navegador não abre socket TCP, só WebSocket.

A solução foi uma ponte pequena, escrita em Bun, que fica entre os dois mundos:

navegador ──WebSocket (wss://ws.openmu.com.br)──▶ ponte (Bun) ──TCP──▶ servidor OpenMU (.NET)

Ela repassa os bytes nos dois sentidos e cuida de algumas coisas que o TCP do jogo não previa:

  • Keepalive: ping/pong a cada poucos segundos. Celular em rede móvel some sem fechar a conexão; se não vier pong em 45 s, a ponte derruba a sessão e o personagem sai do jogo em vez de ficar "fantasma".
  • Log de cada conexão com a conta e o motivo do fechamento (by=keepalive, by=server, by=desync). É isso que permite responder "o jogo me derrubou" com dados.
  • Presença: a ponte sabe qual conta está em qual aba, e outros serviços (mercado, áudio no chat) usam isso como autenticação.

Do lado do client, os pacotes não são escritos à mão: um script em Bun lê as definições de pacotes em XML (tipo de cada campo, endianness, estruturas aninhadas) e gera o código TypeScript de leitura e escrita. Mudou o pacote, roda o gerador.

Problema 2: os arquivos do jogo no navegador

O MU guarda modelos em .bmd, texturas em .ozj/.ozt (JPEG/TGA com cabeçalho próprio) e mapas em arquivos de terreno binários. Na build:

  • os modelos são convertidos para GLB (glTF binário), que o Babylon.js carrega nativamente;
  • cada arquivo comprimível ganha um gzip ao lado (arquivo.gz). Como TGA e GLB não são comprimidos por padrão e hospedagem estática não comprime esses tipos, isso derruba o tráfego para cerca de um terço;
  • os arquivos de cada grupo (mapa, personagens, itens) são empacotados em um único arquivo (MUB1 + cabeçalho JSON com nome e tamanho de cada parte). O primeiro acesso baixa poucos arquivos grandes em vez de milhares de pequenos, e um service worker recorta e guarda cada parte no cache. Na segunda vez, o jogo abre quase sem rede.

Há ainda uma variante "leve" de texturas para aparelhos mais fracos.

Problema 3: FPS no celular (e em PC fraco)

Renderizar Lorencia cheia de gente no WebGL de um celular intermediário exigiu cortar onde não aparece:

  • Sombra projetada só para o seu personagem e os 12 corpos mais próximos.
  • Efeitos de equipamento (brilho de arma +13, asas) completos só nos 6 jogadores mais próximos; os outros recebem uma versão barata.
  • Brilhos e partículas de itens no chão só nos 12 mais próximos.
  • Modo leve automático: se o FPS fica abaixo de 22 por um tempo, o client baixa a qualidade sozinho.
  • Vazamento de memória que fazia a aba crescer até travar: cada troca de equipamento clonava o modelo sem descartar o anterior. Hoje o clone antigo é descartado inteiro e só recarregamos quando o visual muda de fato.
  • Perda de contexto WebGL (comum no celular quando o sistema precisa de memória): o client detecta, recria os recursos e, se não conseguir, mostra um botão "Recarregar" em vez de uma tela preta.

Para o toque, o client detecta pointer: coarse e liga o modo celular: joystick virtual, ataque automático, botões grandes e o MU Helper (o "bot" oficial do jogo) acessível na tela.

Jogando no celular

Problema 4: hospedar barato e sem cair

Tudo roda numa VM ARM da Oracle Cloud (2 OCPU, 12 GB) com Docker: servidor do jogo, Postgres 18, ponte, site (Next.js), mercado e alguns serviços menores, atrás de nginx e da Cloudflare. A porta 443 só aceita as faixas de IP da Cloudflare, e as portas dos containers ficam presas em 127.0.0.1.

Algumas regras que aprendemos apanhando:

  • Nada vai ao ar sem commit. Toda imagem é gerada a partir de um commit que já está no GitHub (git archive <hash>), nunca da pasta de trabalho, e leva o hash no nome (openmu-site:git-1991e4802).
  • Build no PC, deploy na VM. A VM é ARM; as imagens são compiladas no PC com docker buildx --platform linux/arm64 e enviadas com docker save | gzip | ssh docker load. O build do client (Bun) leva uns 2 minutos.
  • Troca travada: o script de publicação só troca a versão se a que está no ar for a esperada (mais de uma publicação pode estar em andamento), guarda o docker-compose.yml anterior e testa as rotas depois. Voltar é um cp e um docker compose up -d.
  • Backup diário do banco com cópia fora da VM e restauração testada, mais uma página pública de status com a disponibilidade medida a cada 5 minutos.

O que o navegador permitiu fazer de diferente

Estar na web abriu espaço para coisas que o client antigo não tinha:

  • Mercado entre jogadores com custódia: o item fica guardado pelo sistema até a venda, com preço em zen ou em joias.
  • Consulta de drop no site: busca o item e mostra qual monstro solta e em que mapa, direto das tabelas do servidor.
  • Laboratório de balanceamento público: um boneco de treino registra o dano real de cada skill, e os números ficam abertos no site.

Para quem quiser olhar mais de perto

Se alguém já brigou com WebGL no celular, protocolo binário via WebSocket ou build ARM cruzada, quero muito ouvir nos comentários o que fariam diferente.

Carregando publicação patrocinada...