ZUMBI BOT

Manual de instalação local

Como baixar o Zumbi Bot e rodar no seu computador. São uns 5 minutos: instalar duas ferramentas, copiar quatro comandos e abrir o jogo no navegador.

1Quer só jogar?

Não precisa instalar nada: o jogo roda direto em marcelojaloto.github.io/Zumbi-Bot, no computador, no celular ou no tablet. Esta página é para quem quer rodar o jogo na própria máquina (para testar, estudar ou mexer no código).

No celular: deite o aparelho. Os controles de toque aparecem sozinhos: direcional à esquerda e botões à direita. Para jogar em tela cheia, use "Adicionar à tela inicial" no menu do navegador e abra pelo ícone. No iPhone (Safari): toque em Compartilhar > "Adicionar à Tela de Início"; é o único jeito de jogar em tela cheia no iPhone.
App para Android: baixe o zumbi-bot.apk no celular e abra o arquivo para instalar (o Android pede para permitir instalar apps dessa fonte). O app abre em tela cheia e deitado, e o progresso fica salvo no aparelho.
App para iPhone: o app está pronto para o TestFlight e a App Store, mas depende de uma conta de desenvolvedor Apple para ser publicado (veja docs/APP_STORE.md). Enquanto isso, jogue no Safari e use "Adicionar à Tela de Início".
Jogar online com amigos (até 5): uma pessoa toca em Jogar online > Criar sala, escolhe a dificuldade e se o chat de voz é permitido, e recebe um código de 4 letras (ou um link). Os outros tocam em Jogar online > Entrar numa sala e digitam o código. Cada um escolhe o personagem e toca em Pronto; quem criou a sala toca em Começar. Precisa de internet, e cada um guarda o próprio progresso no seu aparelho. Funciona entre computador, Android (navegador e app) e iPhone.
Chat de voz: numa sala com voz, todos conversam com todos. Toque em 🎤 Ligar microfone (na sala), no botão do microfone (na partida) ou aperte V para falar; de novo para ficar mudo. Na primeira vez o aparelho pede permissão para o microfone: toque em Permitir. O volume das vozes fica em Configurações > Áudio.

2O que você precisa

Node.js 22 LTSVersão mínima 20.19 (exigida pelo Vite 8).
GitPara baixar o código.
Navegador com WebGLChrome, Edge, Firefox ou Safari atualizados.

3Instalar as ferramentas

  1. Baixe e instale o Node.js 22 LTS em nodejs.org (instalador .msi; pode aceitar as opções padrão).
  2. Baixe e instale o Git for Windows em git-scm.com.
  3. Feche e abra de novo o PowerShell (menu Iniciar > "PowerShell") para ele enxergar os programas.

Confira se deu certo (o Node deve mostrar v22, ou pelo menos v20.19):

node --version
git --version

4Baixar e rodar o jogo

No terminal, copie e rode estes comandos, um de cada vez:

git clone https://github.com/marcelojaloto/Zumbi-Bot.git
cd Zumbi-Bot
npm install
npm run dev

Quando aparecer Local: http://localhost:5173/Zumbi-Bot/, abra esse endereço no navegador: http://localhost:5173/Zumbi-Bot/

Deixe o terminal aberto enquanto joga: ele é o servidor do jogo. Para parar, volte ao terminal e aperte Ctrl + C. Da próxima vez, basta entrar na pasta (cd Zumbi-Bot) e rodar npm run dev de novo.

Jogar no celular pela mesma rede Wi-Fi

Rode com --host e abra no celular o endereço "Network" que aparecer no terminal (algo como http://192.168.0.10:5173/Zumbi-Bot/):

npm run dev -- --host

Versão de produção (igual à do site)

npm run build
npm run preview

Depois abra http://localhost:4173/Zumbi-Bot/.

Atualizar para a versão mais nova

cd Zumbi-Bot
git pull
npm install

5Atalhos para testar

Acrescente ao endereço do jogo (por exemplo http://localhost:5173/Zumbi-Bot/?map=arena&god=1):

?map=vila Abre direto um mapa: vila, torre, banco, castelo, toxica, floresta, centro, chamas, guerra, arena.
&god=1 Modo invencível.
&quality=low Força a qualidade gráfica: low, medium ou high.
&debug=1 Ferramentas de teste; F1–F8 criam inimigos na hora.
&mute=1 Sem som.

6Problemas comuns

"node", "npm" ou "git" não é reconhecido como comando
O programa não foi instalado ou o terminal foi aberto antes da instalação. Instale e abra um terminal novo.
Erro de versão do Node ao rodar npm run dev
Seu Node é antigo. Instale o Node.js 22 LTS e confira com node --version.
"Não é possível acessar esse site" em localhost:5173
O servidor não está rodando: o terminal foi fechado ou o npm run dev parou com erro. Rode npm run dev de novo dentro da pasta Zumbi-Bot. O endereço localhost só funciona no computador onde o comando está rodando.
"Port 5173 is already in use"
Outro servidor já está usando a porta. Feche o outro terminal ou use o endereço com a porta que o Vite sugerir.
Tela preta ou erro de WebGL
Ative a aceleração de hardware do navegador (no Chrome: Configurações > Sistema > "Usar aceleração de gráficos quando disponível") e reinicie o navegador.
Sem som
Os navegadores só liberam o áudio depois do primeiro clique ou toque: clique em "Jogar".
Jogo online: "Não existe sala com esse código"
Confira as 4 letras. A sala só existe enquanto o jogo de quem a criou estiver aberto na tela da sala ou na partida; se ele fechou o jogo, é preciso criar uma sala nova.
Jogo online: acha a sala mas não conecta
Algumas redes (de empresas e escolas, por exemplo) bloqueiam a conexão direta entre aparelhos. Tente outra rede, como os dados do celular. Quem criou a sala deve deixar o jogo aberto na tela: é o aparelho dele que conduz a partida de todos.
Chat de voz: "O microfone está bloqueado"
A permissão do microfone foi negada. No computador, clique no ícone ao lado do endereço do site > Microfone > Permitir. No Android (navegador), toque no ícone ao lado do endereço > Permissões > Microfone. No app Android: Configurações > Apps > Zumbi Bot > Permissões > Microfone. No iPhone: "aA" na barra do Safari > Ajustes do Site > Microfone (ou Ajustes > Apps > Safari > Microfone). Depois recarregue a página.
Chat de voz: não ouço os outros
Se aparecer 🔈 Toque para ouvir a conversa, toque nele (o navegador, principalmente no iPhone, só toca som depois de um toque). Confira o volume das vozes em Configurações > Áudio e se "Silenciar tudo" está desligado. No iPhone, a chave de silencioso também deixa o jogo mudo.
Testar o jogo online no próprio computador
Abra duas abas com ?net=local no endereço (por exemplo localhost:5173/Zumbi-Bot/?net=local): uma cria a sala e a outra entra com o código, sem precisar de internet (o chat de voz não funciona nesse modo de teste).

Local installation manual

How to download Zumbi Bot and run it on your computer. It takes about 5 minutes: install two tools, copy four commands and open the game in your browser.

1Just want to play?

No install needed: the game runs at marcelojaloto.github.io/Zumbi-Bot on computers, phones and tablets. This page is for running the game on your own machine (to test it, study it or change the code).

On a phone: turn the device sideways. The touch controls appear on their own: D-pad on the left and buttons on the right. For full screen, use "Add to Home Screen" in the browser menu and open the game from the icon. On iPhone (Safari): tap Share > "Add to Home Screen"; it is the only way to play full screen on an iPhone.
Android app: download zumbi-bot.apk on your phone and open the file to install it (Android asks you to allow installs from that source). The app opens full screen in landscape, and your progress is saved on the device.
iPhone app: the app is ready for TestFlight and the App Store, but publishing it needs an Apple developer account (see docs/APP_STORE.md). Meanwhile, play in Safari and use "Add to Home Screen".
Play online with friends (up to 5): one person taps Play online > Create room, picks the difficulty and whether voice chat is allowed, and gets a 4-letter code (or a link). The others tap Play online > Join a room and type the code. Everyone picks a character and taps Ready; whoever created the room taps Start. It needs internet, and everyone keeps their own progress on their own device. Computers, Android (browser and app) and iPhone play together.
Voice chat: in a room with voice, everyone talks with everyone. Tap 🎤 Turn mic on (in the room), the mic button (in the match) or press V to talk; again to mute. The first time, the device asks for microphone permission: tap Allow. The voice volume is in Settings > Audio.

2What you need

Node.js 22 LTSMinimum version 20.19 (required by Vite 8).
GitTo download the code.
A WebGL browserUp-to-date Chrome, Edge, Firefox or Safari.

3Install the tools

  1. Download and install Node.js 22 LTS from nodejs.org (.msi installer; the default options are fine).
  2. Download and install Git for Windows from git-scm.com.
  3. Close and reopen PowerShell (Start menu > "PowerShell") so it can find the new programs.

Check that it worked (Node should print v22, or at least v20.19):

node --version
git --version

4Download and run the game

In the terminal, copy and run these commands one at a time:

git clone https://github.com/marcelojaloto/Zumbi-Bot.git
cd Zumbi-Bot
npm install
npm run dev

When Local: http://localhost:5173/Zumbi-Bot/ appears, open that address in your browser: http://localhost:5173/Zumbi-Bot/

Keep the terminal open while you play: it is the game's server. To stop it, go back to the terminal and press Ctrl + C. Next time, just go into the folder (cd Zumbi-Bot) and run npm run dev again.

Play on your phone over the same Wi-Fi

Run it with --host and open the "Network" address shown in the terminal on your phone (something like http://192.168.0.10:5173/Zumbi-Bot/):

npm run dev -- --host

Production build (same as the website)

npm run build
npm run preview

Then open http://localhost:4173/Zumbi-Bot/.

Update to the latest version

cd Zumbi-Bot
git pull
npm install

5Testing shortcuts

Add these to the game address (for example http://localhost:5173/Zumbi-Bot/?map=arena&god=1):

?map=vila Opens a map directly: vila, torre, banco, castelo, toxica, floresta, centro, chamas, guerra, arena.
&god=1 God mode.
&quality=low Forces the graphics quality: low, medium or high.
&debug=1 Testing tools; F1–F8 spawn enemies on the spot.
&mute=1 No sound.

6Common problems

"node", "npm" or "git" is not recognized as a command
The program is not installed, or the terminal was opened before installing it. Install it and open a new terminal.
Node version error when running npm run dev
Your Node is too old. Install Node.js 22 LTS and check with node --version.
"This site can't be reached" at localhost:5173
The server is not running: the terminal was closed or npm run dev stopped with an error. Run npm run dev again inside the Zumbi-Bot folder. The localhost address only works on the computer where the command is running.
"Port 5173 is already in use"
Another server is using the port. Close the other terminal or use the address with the port Vite suggests.
Black screen or WebGL error
Turn on hardware acceleration in your browser (in Chrome: Settings > System > "Use graphics acceleration when available") and restart the browser.
No sound
Browsers only allow audio after the first click or tap: click "Play".
Online: "There is no room with that code"
Check the 4 letters. The room only exists while the creator's game is open on the room screen or in the match; if they closed the game, a new room has to be created.
Online: finds the room but does not connect
Some networks (companies and schools, for example) block direct connections between devices. Try another network, such as mobile data. Whoever created the room should keep the game open on screen: their device runs the match for everyone.
Voice chat: "The microphone is blocked"
Microphone permission was denied. On a computer, click the icon next to the site address > Microphone > Allow. On Android (browser), tap the icon next to the address > Permissions > Microphone. In the Android app: Settings > Apps > Zumbi Bot > Permissions > Microphone. On iPhone: "aA" in the Safari bar > Website Settings > Microphone (or Settings > Apps > Safari > Microphone). Then reload the page.
Voice chat: I can't hear the others
If 🔈 Tap to hear the conversation appears, tap it (browsers, especially on iPhone, only play sound after a tap). Check the voice volume in Settings > Audio and that "Mute all" is off. On iPhone, the silent switch also mutes the game.
Testing online play on your own computer
Open two tabs with ?net=local in the address (for example localhost:5173/Zumbi-Bot/?net=local): one creates the room and the other joins with the code, no internet needed (voice chat does not work in this test mode).