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
Baixe e instale o Node.js 22 LTS em
nodejs.org (instalador .msi;
pode aceitar as opções padrão).
Feche e abra de novo o PowerShell (menu Iniciar > "PowerShell") para ele enxergar os
programas.
Baixe e instale o Node.js 22 LTS em
nodejs.org (instalador .pkg).
Quem usa Homebrew pode rodar brew install node git.
O Git costuma vir com o macOS: se o Terminal pedir as "ferramentas de linha de comando" na
primeira vez, aceite a instalação.
Abra o Terminal (Spotlight > "Terminal").
Instale o Git pelo gerenciador da sua distribuição, por exemplo
sudo apt install git (Debian/Ubuntu) ou sudo dnf install git (Fedora).
Instale o Node.js 22 seguindo
nodejs.org/en/download
(recomendado: pelo gerenciador de versões nvm). O Node dos repositórios antigos costuma ser
velho demais.
Abra um terminal.
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
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/):
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.
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
Download and install Node.js 22 LTS from
nodejs.org (.msi installer; the
default options are fine).
Download and install Git for Windows from
git-scm.com.
Close and reopen PowerShell (Start menu > "PowerShell") so it can find the new programs.
Download and install Node.js 22 LTS from
nodejs.org (.pkg installer).
Homebrew users can run brew install node git.
Git usually ships with macOS: if Terminal asks to install the "command line developer tools" the
first time, accept it.
Open Terminal (Spotlight > "Terminal").
Install Git with your distribution's package manager, for example
sudo apt install git (Debian/Ubuntu) or sudo dnf install git (Fedora).
Install Node.js 22 following
nodejs.org/en/download
(recommended: the nvm version manager). The Node in older repositories is usually too old.
Open a terminal.
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
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/):
"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).