Einführung

bonktools ist eine TypeScript-Bibliothek, die sich direkt über das Spielprotokoll (Socket.IO) mit bonk.io verbindet, ohne einen Browser zu öffnen. Damit erstellst du Räume, steuerst Teams und Spieler, reagierst auf Events und hältst einen Raum rund um die Uhr am Laufen.

Warum es das gibt

bonk.io mit Puppeteer zu automatisieren erfordert pro Raum einen kompletten Browser, unter Linux einen virtuellen Bildschirm und eine anfällige UI-Automatisierung. bonktools ersetzt das durch eine schlanke Verbindung: Jeder Raum ist nur ein Socket, und das gesamte Verhalten (Events, Teams, Reconnect) ist typisierter TypeScript-Code.

Was du tun kannst

• Räume erstellen und ihnen als Host, Spieler oder Zuschauer beitreten.
• Auf Events von Spielern, Chat, Teams und Partien reagieren.
• Spieler zwischen Teams verschieben, Teams sperren und moderieren (Kick/Ban).
• AFK-Spieler anhand von Bewegung und Chat erkennen.
• Partien mit dem korrekten Anfangszustand für jede Karte starten und stoppen.
• Mehrere Räume mit einem einzigen Konto am Leben halten, mit automatischem Reconnect.

Wie das Projekt aufgebaut ist

BonkSession       Raum-Pool, gemeinsame Authentifizierung, Throttle
  └── BonkRoom    Zustand, typisierte Events, Reconnect, Teams, Sperre, Anti-AFK
        └── BonkTransport   Socket.IO v2 (EIO=3) + TLS
              └── bonk.io

Nächste Schritte

• Installation und erster Bot: Starte deinen ersten Bot in wenigen Minuten.
• Räume erstellen und beitreten: alle Optionen.
• Zustand und Events: reagiere auf das, was im Raum passiert.