Eigener Raum

Den Raum 24/7 online halten

Wo hosten, wie viel Rechner nötig ist, systemd oder PM2, Updates und was wir beim Betrieb von Räumen gelernt haben.

Den Raum auf deinem PC laufen zu lassen, ist super zum Testen. Damit er Tag und Nacht online bleibt, brauchst du einen Server (VPS), der immer an ist. Diese Seite zeigt den Weg, den wir gegangen sind.

Wie viel Rechner nötig ist

In den BonkTools-Räumen gemessene Werte (Node 22, Linux):

RaumSpeicher (RSS)CPU
Pick mit automatischem Spielstand und Rec~200–250 MBgering (Spitzen am Spielende)
Raum mit spielender KI (2 Simulationen: Spielstand und „Augen“)~450 MB1 Kern schafft 1–2 Räume

Ein VPS mit 1 Kern und 1 GB schafft einen Pick-Raum. Mit 2 Kernen und 4–6 GB passen mehrere Räume und der Discord-Bot.

Den Server vorbereiten (Ubuntu)

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

# das Projekt (aus deinem git, oder das Zip per scp hochladen)
git clone https://github.com/du/minha-sala.git ~/minha-sala
cd ~/minha-sala
npm ci
nano .env        # Konto, Raumname, Discord...

Option 1: systemd (empfohlen)

systemd ist bei Ubuntu schon dabei: Es startet den Raum beim Booten und startet ihn neu, wenn der Prozess stirbt. Leg /etc/systemd/system/minha-sala.service an:

ini
[Unit]
Description=Mein bonk.io-Raum
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
# Sicherheitsgrenzen
MemoryMax=800M
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target
bash
sudo systemctl daemon-reload
sudo systemctl enable --now minha-sala     # jetzt starten und bei jedem Boot
systemctl status minha-sala                # läuft er?
journalctl -u minha-sala -f                # Live-Logs (hier erscheint der Raum-Link)
sudo systemctl restart minha-sala          # nach Änderungen an .env oder Code

Option 2: PM2

bash
sudo npm install -g pm2
pm2 start "npx tsx src/index.ts" --name minha-sala
pm2 save && pm2 startup     # der ausgegebenen Anweisung folgen
pm2 logs minha-sala

Mehrere Räume

  • Gleicher Code, andere Einstellungen: leg .env.sala2 und einen zweiten Dienst mit ExecStart=/usr/bin/node --env-file=.env.sala2 --import tsx src/index.ts an.
  • Ein Konto, mehrere Räume: funktioniert. Die BonkSession verteilt das Erstellen der Räume zeitlich, um nicht an das Server-Limit zu stoßen.
  • Jeder Raum mit automatischem Spielstand führt die Physik in einem eigenen Worker aus: rechne mit ~200 MB pro Raum.

Aktualisieren, ohne jemanden rauszuwerfen

Den Raum neu zu starten, während gespielt wird, wirft alle raus. So haben wir es gemacht:

  1. Der Raum gibt aus, wie viele Spieler er hat (ein lokales /status, oder einfach eine Datei, die jede Minute aktualisiert wird).
  2. Ein Update-Skript macht git pull && npm ci, wartet, bis der Raum leer ist, und startet erst dann neu.
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

(Schreib im Beispiel bei jedem Beitritt und Abgang room.state.players.size - 1 in jogadores.txt („Spieler“).)

Was wir unterwegs gelernt haben

  • bonk.io kann das Konto des Raums sperren. Im Oktober 2026 wurden die Konten unserer Räume auf einen Schlag gesperrt. Hab einen Plan B: Lass den Raum als Gast funktionieren und führe eine Liste mit Ersatznamen.
  • Speicherlecks töten Räume langsam. Jeder Spieler, der beitritt, öffnet eine WebRTC-Verbindung; in einer alten Version der Bibliothek wurden sie beim Verlassen nicht geschlossen, und der Raum ging in 40 Minuten von 12 % auf 86 % CPU. Nutze bonktools 0.2.7 oder neuer und behalte den Speicher im Blick (systemctl status zeigt ihn).
  • Ein Wachhund hilft. Ein Timer, der jede Minute prüft, ob der Raum kürzlich geantwortet hat, und ihn neu startet, wenn die CPU 3 Minuten lang oben hängt, hat uns viele Stunden Ausfall erspart.
  • Fehler beim Bearbeiten der .env legen den Raum lahm. Ein überzähliges Zeichen am Dateianfang hielt einen unserer Räume 3 Stunden in einer Neustartschleife. Mach vor dem Bearbeiten eine Kopie und prüfe nach dem Neustart das Log.
  • Geheimnisse raus aus git. .env, Discord-Tokens und Schlüssel kommen nie ins Repository. Wenn etwas leakt, sofort austauschen.
  • Serverzugang. Nutze einen SSH-Schlüssel (nie ein Passwort) und öffne Port 22 möglichst nur für deine IP oder hinter einem VPN.