Crie sua sala

Deixar a sala no ar 24/7

Onde hospedar, quanto de máquina precisa, systemd ou PM2, atualizações e o que aprendemos mantendo salas no ar.

Rodar a sala no seu PC é ótimo para testar. Para ela ficar no ar dia e noite, você precisa de um servidor (VPS) ligado o tempo todo. Esta página mostra o caminho que usamos.

Quanto de máquina precisa

Números medidos nas salas da BonkTools (Node 22, Linux):

SalaMemória (RSS)CPU
Pick com placar automático e rec~200–250 MBbaixa (picos no fim da partida)
Sala com a IA jogando (2 simulações: placar e "olhos")~450 MB1 núcleo dá conta de 1–2 salas

Uma VPS com 1 núcleo e 1 GB aguenta uma sala de pick. Com 2 núcleos e 4–6 GB cabem várias salas e o bot do Discord.

Preparar o servidor (Ubuntu)

bash
# Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs git

# o projeto (do seu git, ou envie o zip com scp)
git clone https://github.com/voce/minha-sala.git ~/minha-sala
cd ~/minha-sala
npm ci
nano .env        # conta, nome da sala, Discord...

Opção 1: systemd (recomendado)

O systemd já vem no Ubuntu: ele sobe a sala no boot e reinicia se o processo cair. Crie /etc/systemd/system/minha-sala.service:

ini
[Unit]
Description=Minha sala do bonk.io
After=network-online.target
Wants=network-online.target

[Service]
User=ubuntu
WorkingDirectory=/home/ubuntu/minha-sala
ExecStart=/usr/bin/npx tsx src/index.ts
Restart=always
RestartSec=5
Environment=NODE_ENV=production
# limites de segurança
MemoryMax=800M
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target
bash
sudo systemctl daemon-reload
sudo systemctl enable --now minha-sala     # liga agora e em todo boot
systemctl status minha-sala                # está rodando?
journalctl -u minha-sala -f                # logs ao vivo (o link da sala aparece aqui)
sudo systemctl restart minha-sala          # depois de mudar o .env ou o código

Opção 2: PM2

bash
sudo npm install -g pm2
pm2 start "npx tsx src/index.ts" --name minha-sala
pm2 save && pm2 startup     # siga a instrução que ele imprimir
pm2 logs minha-sala

Várias salas

  • Mesmo código, configurações diferentes: crie .env.sala2 e um segundo serviço com ExecStart=/usr/bin/node --env-file=.env.sala2 --import tsx src/index.ts.
  • Uma conta, várias salas: funciona. A BonkSession espaça a criação das salas para não esbarrar no limite do servidor.
  • Cada sala com placar automático roda a física num worker próprio: conte ~200 MB por sala.

Atualizar sem derrubar ninguém

Reiniciar a sala com gente jogando derruba todo mundo. O que fazíamos:

  1. A sala expõe quantos jogadores tem (um /status local, ou só um arquivo atualizado a cada minuto).
  2. Um script de atualização faz git pull && npm ci, espera a sala ficar vazia e só então reinicia.
bash
#!/bin/bash
cd ~/minha-sala && git pull --ff-only && npm ci
until [ "$(cat jogadores.txt 2>/dev/null)" = "0" ]; do sleep 30; done
sudo systemctl restart minha-sala

(No exemplo, grave room.state.players.size - 1 em jogadores.txt a cada entrada e saída.)

O que aprendemos no caminho

  • O bonk.io pode banir a conta da sala. Em outubro de 2026 as contas das nossas salas foram banidas de uma vez. Tenha um plano B: deixe a sala funcionar como convidado e mantenha uma lista de nomes alternativos.
  • Vazamento de memória mata salas devagar. Cada jogador que entra abre uma conexão WebRTC; numa versão antiga da biblioteca elas não eram fechadas quando a pessoa saía, e a sala ia de 12% a 86% de CPU em 40 minutos. Use a bonktools 0.2.7 ou mais nova e acompanhe a memória (systemctl status mostra).
  • Um vigia ajuda. Um timer que, a cada minuto, confere se a sala respondeu recentemente e reinicia se a CPU ficar travada no alto por 3 minutos evitou várias horas de sala fora do ar.
  • Erros de edição no .env derrubam a sala. Um caractere a mais no começo do arquivo deixou uma das nossas salas 3 horas em reinício infinito. Faça cópia antes de editar e confira o log depois de reiniciar.
  • Segredos fora do git. .env, tokens do Discord e chaves nunca vão para o repositório. Se vazar, troque na hora.
  • Acesso ao servidor. Use chave SSH (nunca senha) e, se puder, deixe a porta 22 aberta só para o seu IP ou atrás de uma VPN.