Erste Schritte

Einführung

BonkTools ist jetzt ein offenes Projekt: alles, was wir in unseren Räumen genutzt haben, erklärt, damit du deinen eigenen baust.

BonkTools hat auf bonk.io rund um die Uhr Fußballräume betrieben: Pick-Raum mit Kapitänen, automatischer Spielstand, Replays auf der Website, Discord-Integration und Räume gegen eine selbst trainierte künstliche Intelligenz.

Jetzt hat das Projekt einen neuen Schwerpunkt. Statt eigene Räume zu betreiben, öffnen wir, was wir gelernt haben, damit jeder seinen eigenen bauen kann: die Bibliothek, einen kompletten Beispielraum, die KI-Modelle zum Herunterladen und eine Schritt-für-Schritt-Anleitung, um deine eigene KI zu trainieren.

Was du hier findest

Die Dokumentation hat zwei Reiter (oben in der Seitenleiste):

ReiterWofür
RäumeBibliothek installieren und deinen Raum bauen: Projektstruktur, Pick-System, Befehle und Admins, Spielaufzeichnung, Discord und 24/7 online halten. Dazu die vollständige Bibliotheksreferenz.
Künstliche IntelligenzWie unsere KI funktioniert, Modelle herunterladen, die KI in deinen Raum bringen und deine eigene KI von null trainieren.

Wo anfangen

  1. Noch nie einen bonk-Bot programmiert? Starte mit Installation und erster Bot: In 5 Minuten hast du einen Raum, der auf !ping antwortet.
  2. Du willst einen kompletten Raum? Geh direkt zu Dein Raum, Schritt für Schritt. Dort gibt es ein fertiges Projekt zum Herunterladen, und jede folgende Seite erklärt einen Teil davon.
  3. Du willst eine KI, die spielt? Lade ein fertiges Modell herunter und folge Die KI in deinen Raum bringen.

Wie die Teile zusammenpassen

text
dein Raum (dein Code: Pick, Befehle, Rec, Discord, KI...)
  └── bonktools (Bibliothek, npm)
        BonkSession     mehrere Räume, Wiederverbindung, ein einziges Konto
          └── BonkRoom  Zustand, Ereignisse, Teams, Sperre, Anti-AFK
                └── BonkTransport   Verbindung zum bonk.io-Server
        ScoreTracker / PhysicsSimulator   die ECHTE Spielphysik, ohne Browser

Die Bibliothek spricht direkt über das Spielprotokoll mit bonk.io, ohne einen Browser zu öffnen: Jeder Raum ist nur eine leichte Verbindung. Der ScoreTracker führt die Physik des Spiels selbst aus, um den Spielstand zu kennen, und es ist dieselbe Physik, mit der wir die KI trainieren.

Was du vorher wissen solltest

  • TypeScript/JavaScript-Grundlagen. Die Beispiele sind in TypeScript und laufen mit Node.js 20 oder neuer.
  • Python-Grundlagen, nur wenn du deine eigene KI trainierst.
  • Ein bonk.io-Konto wird für Räume empfohlen, die online bleiben (als Gast geht es auch, mit Einschränkungen).