Discord-Bot & Cloud-Relay

Konfiguration des Saba-chan-Discord-Bots und der Pairing-Ablauf des Cloud-Relays, mit dem Sie Ihren Server ohne Portweiterleitung steuern.

Discord-Bot & Cloud-Relay

Der Saba-chan-Discord-Bot ist ein offizieller Bot, der auf dem Cloud-Relay-Server betrieben wird. Sie müssen weder selbst einen Bot-Prozess ausführen noch ein Discord-Token verwalten. Laden Sie den offiziellen Bot auf Ihren Discord-Server ein und pairen Sie ihn dann einmalig mit einem Code aus der Saba-chan-App.


1. Funktionsweise

Cloud
DiscordBefehle per Chat
Discord-RelaySaba-chan Bot · Cloud
Dein PC
Saba-chan DaemonDein PC
SpielserverDein PC
  1. 1
    Saba-chan DaemonDiscord-Relay

    Auf neue Befehle warten (Long Polling)

  2. 2
    DiscordDiscord-Relay

    Befehl senden /saba … oder Chat

  3. 3
    Discord-RelaySaba-chan Daemon

    Befehl übergeben

  4. 4
    Saba-chan Daemon

    Rechte prüfen

  5. 5
    Saba-chan DaemonSpielserver

    Start · Konsolenbefehl

  6. 6
    Saba-chan DaemonDiscord-Relay

    Ergebnis senden

  7. 7
    Discord-RelayDiscord

    Mit dem Ergebnis antworten

Dein PC verbindet sich nach außen und holt die Befehle ab, daher muss kein Router-Port geöffnet werden. Anfragen werden mit dem beim Pairing ausgegebenen Token signiert. Alle 60 Sekunden meldet der Daemon dem Relay Serverliste und Status.
  • Der Bot selbst läuft innerhalb des Relay-Servers. Auf Ihrem PC wird nichts Bot-Bezogenes installiert.
  • Die Spieleserver laufen auf Ihrem PC. Der Saba-chan-Daemon auf Ihrem PC verbindet sich per Long-Polling nach außen mit dem Relay-Server, holt Befehle ab und sendet die Ergebnisse zurück.
  • Der Daemon sendet Spielbefehle in der Reihenfolge stdin (Serverkonsole) → REST → RCON. Palworld nutzt seine REST-API. RCON wird nur für ein Spiel verwendet, das ausschließlich RCON unterstützt, und nur über Loopback (127.0.0.1).
  • Der Datenverkehr zwischen Daemon und Relay besteht ausschließlich aus ausgehendem HTTPS von Ihrem PC. Eine Portweiterleitung am Router ist nicht nötig.
  • Musik wird auf der Relay-Seite verarbeitet, ohne über Ihren PC zu laufen, und funktioniert daher auch, wenn Ihr PC aus ist.

2. Pairing

Beim Pairing werden ein Host (der Saba-chan-Daemon) und Nodes (Discord-Server) auf dem Relay-Server registriert. Es ist mit einer einzigen Code-Eingabe erledigt.

2.1 Ablaufdiagramm

Dein PC
GUI-AppDein PC
Saba-chan DaemonDein PC
Cloud
Discord-RelaySaba-chan Bot · Cloud
DiscordSlash-Befehl
  1. 1
    GUI-AppSaba-chan Daemon

    Pairing-Code anfordern

  2. 2
    Saba-chan DaemonDiscord-Relay

    Code ausstellen lassen

  3. 3
    Discord-RelaySaba-chan Daemon

    Code + Poll-Secret (5 Min. gültig)

  4. 4
    Saba-chan DaemonGUI-App

    Code anzeigen

  5. 5
    DiscordDiscord-Relay

    /saba connect code:…

  6. 6
    Discord-Relay

    PC registrieren · Node-Token ausstellen

  7. 7
    GUI-AppSaba-chan Daemon

    Alle 3 s Status prüfen

  8. 8
    Saba-chan DaemonDiscord-Relay

    Status prüfen (mit Poll-Secret)

  9. 9
    Discord-RelaySaba-chan Daemon

    Verbunden + Node-Token (nur einmal)

  10. 10
    Saba-chan Daemon

    Token speichern · Relay-Verbindung starten

  11. 11
    Saba-chan DaemonGUI-App

    „Verbunden“ anzeigen

Wer den Code sieht, bekommt ohne das Poll-Secret trotzdem kein Token. Das Token wird nur einmal ausgegeben, und der Daemon speichert es, nicht die GUI. Zum Verbinden auf einem Discord-Server braucht man die Berechtigung „Server verwalten“.
  • Der Pairing-Code ist 32 Zeichen lang, und pollSecret ist 48 Zeichen lang. Der Code ist 5 Minuten gültig.
  • Das Token wird genau einmal zurückgegeben (atomarer Austausch). Der Daemon, nicht die GUI, speichert es sofort nach Eingang in .node_token und baut die Relay-Verbindung auf. Die App gibt das Poll-Secret nur an den Daemon auf Ihrem PC weiter, und der Daemon sendet es in einem Header an das Relay, nie in der URL.
  • Selbst wenn jemand Ihren Pairing-Code sieht, kann er das Token ohne das pollSecret nicht abfangen.
  • Sie können mehrere PCs mit einem Discord-Konto verbinden. Verbinden Sie von einem Konto, das schon einen PC hat, erscheinen die Schaltflächen Als neuen PC verbinden und Neu verbinden für Ihre früheren PCs. Beim Neuverbinden gilt das alte Token dieses PCs nicht mehr. Auch ein Discord-Server kann PCs mehrerer Personen haben (Discord).

2.2 Schritte in der App

  1. Öffnen Sie in der Saba-chan-App Discord → Verbindung und klicken Sie auf Discord-Server verbinden.
  2. Ist der offizielle Saba-chan-Bot noch nicht auf Ihrem Discord-Server, laden Sie ihn zuerst mit Bot einladen ein.
  3. Der Bildschirm zeigt einen Verbindungscode und den einzugebenden Befehl. Klicken Sie auf Kopieren und geben Sie ihn in einem Discord-Kanal als /saba connect code:<Code> ein (die App zeigt unter Umständen den koreanischen Namen /사바쨩 연결 코드:<Code>; es ist derselbe Befehl).
  4. Nur Mitglieder mit der Berechtigung Server verwalten auf diesem Discord-Server können diesen Befehl ausführen. Senden Sie ihn in einer DM mit dem Bot, wird nur der PC mit Ihrem Konto verbunden, ohne Discord-Server.
  5. Verwenden Sie ein Discord-Konto zum ersten Mal, führt der Bot Sie zuerst durch die Registrierung. Mit Registrieren prüfen Sie auf der Website die Nutzungsbedingungen und registrieren sich; danach wird die Antwort zur Verbindungsbestätigung. Vor der Zustimmung wird kein PC verbunden.
  6. Zeigt der Bot einen Button, der fragt, ob verbunden werden soll, klicken Sie auf Verbinden. Gibt jemand anderes Ihnen einen Code, den Sie eingeben, wird dessen PC mit Ihrem Konto verbunden. Klicken Sie daher nur, wenn Sie den Code selbst in Ihrer Saba-chan-App erhalten haben.
  7. Die App prüft den Status alle 3 Sekunden über den Daemon und wechselt zu „Verbunden“, sobald der Daemon .node_token gespeichert hat.

Nach dem Pairing hält der Daemon automatisch eine Long-Poll-Verbindung zum Relay-Server. Schalten Sie in der App den Schalter Befehlsweiterleitung aus, empfängt Ihr PC keine Discord-Befehle mehr, und der Bot antwortet nicht.

2.3 Einen weiteren Discord-Server ohne Code verbinden

Ist Ihr Discord-Konto bereits gepairt, können Sie auf einem anderen Discord-Server einfach /saba connect (ohne Code) ausführen.

  • Der Bot verbindet alle PCs, die mit diesem Konto verknüpft sind, sofort mit diesem Discord-Server. Sie müssen auf dem PC nichts annehmen und keinen PC auswählen.
  • Bei einem neuen Konto registrieren Sie sich zuerst. Mit der Registrierung wird auch dieser Discord-Server bei Saba-chan registriert; ist kein PC verbunden, bleibt er ein Server ohne PC (§2.5). Haben Sie sich registriert, aber keinen PC, fordert der Bot Sie auf, sich mit einem Pairing-Code zu verbinden.
  • Auf einem so verbundenen Discord-Server ist zunächst kein Spieleserver sichtbar. Wählen Sie in der Saba-chan-App auf dem PC die Server aus, die für diesen Discord-Server genutzt werden sollen.
  • Ein per Pairing-Code verbundener Discord-Server folgt der Einstellung Meine Server auf neuen Discord-Servern sofort freigeben im Verbindungsbildschirm von Discord in der App. Ist sie eingeschaltet, sind sofort alle Server sichtbar, andernfalls wählen Sie selbst aus.
  • Wie bei einem Code benötigen Sie die Berechtigung Server verwalten. Ist an einen Discord-Server schon ein anderer PC verbunden, wird er ihm nicht weggenommen, sondern Ihr PC wird zusätzlich verbunden.

2.4 Pairing aufheben

  • Klicken Sie in der App auf Trennen → der Daemon stoppt die Befehlsweiterleitung und löscht .node_token. Dieser PC wird von allen Discord-Servern getrennt.
  • Um nur einen Discord-Server zu lösen, führen Sie auf diesem Server /saba disconnect aus. Das können nur die Person, die ihn verbunden hat, oder der Besitzer des Discord-Servers; die Kanalzuweisungen des Servers werden dabei ebenfalls entfernt.

2.5 Discord-Server ohne PC

Auch wer die Saba-chan-App nicht installiert hat, kann den Bot einladen und die Singende, Sprechende und Vorlesende Saba-chan, die Befehle zur Serververwaltung und Spielstatistiken nutzen.

  • Die Einstellungen werden auf dem Relay gespeichert. Der Besitzer des Discord-Servers oder Personen mit der Berechtigung Server verwalten ändern Sprache, die Kanalzuweisung für Sprechende und Singende Saba-chan, das Emoji-Upscaling sowie die Einstellungen der Sprechenden und der Vorlesenden Saba-chan. Das geht mit dem Discord-Befehl /saba oder über Saba-chan Web; bei der ersten Änderung registrieren Sie sich.
  • Saba-chan-Stufen (die Berechtigungsleiter) und Spieleserver-Befehle gibt es nicht. Kanäle für Hinweise, Spielchat und Status board lassen sich nicht zuweisen, da sie vom PC gesendet werden.
  • Verbinden Sie später einen PC, werden die Einstellungen unverändert übernommen, und ab dann ist dieser PC das Original der Einstellungen.
  • Für die allgemeine Nutzung durch Mitglieder, etwa Musik hören oder sich unterhalten, ist keine Registrierung nötig.

3. Slash-Befehle des Bots

Dies sind die Befehle unter dem Stammbefehl des offiziellen Bots. In Discord-Clients, die auf eine andere Sprache als Koreanisch eingestellt sind, erscheint der Stamm als /saba mit englischen Unterbefehlsnamen; auf Koreanisch ist es /사바쨩. Auf Discord-Servern ohne verbundenen PC sehen Sie nur connect, assign, language, settings, reading, web, big-emoji und help, und statt des „Node-Besitzers“ nutzen sie der Besitzer des Discord-Servers oder Personen mit der Berechtigung „Server verwalten“. Die übrigen Slash-Befehle (/tts, /stats, /clear usw.) finden Sie unter Befehle.

BefehlWerAktion
/saba statusAlleZeigt den Status des mit diesem Server verbundenen PCs und jedes Spieleservers (CPU, RAM)
/saba connect [code]Berechtigung „Server verwalten“Verbindet mit einem Pairing-Code. Bleibt der Code leer, werden alle PCs Ihres Kontos mit diesem Server verbunden (§2.3). Beim ersten Mal zuerst die Registrierung
/saba disconnectVerbindende Person oder ServerbesitzerTrennt diesen Server von seinem PC
/saba permission <level> [user]Node-BesitzerWählen Sie eine Person, erhält dieses Mitglied die Befehlsstufe (Entfernen in der Stufenliste löscht die eigene Stufe und setzt auf die Standardstufe zurück); ohne Auswahl wird die Standardstufe für Mitglieder ohne eigene Stufe festgelegt (anfangs Benutzer). Die Stufenliste ist die Berechtigungsleiter dieses Servers
Rechtsklick auf ein Mitglied → Apps → Saba-chan-Stufe ändernNode-BesitzerWählen Sie die Befehlsstufe des Mitglieds aus der Liste (auch Entfernen). Dasselbe wie /saba permission. Das Menü sehen nur Personen mit der Berechtigung „Server verwalten“
/saba sleepNode-BesitzerVersetzt den Bot auf diesem Server in den Schlafmodus (ignoriert alle Nachrichten)
/saba wakeNode-BesitzerWeckt den schlafenden Bot auf
/saba assign kind:<Sprechende Saba-chan|Singende Saba-chan|Hinweise|Spielchat|Status board>Node-Besitzer, ServerbesitzerWeist diesen Kanal als Kanal für die Sprechende Saba-chan (mehrere, bis zu 20; die Sprechende Saba-chan spricht nur dort), als Kanal der Singenden Saba-chan (einer; gewöhnliche Nachrichten werden gelöscht, daher wird eine Bestätigung verlangt), als Hinweiskanal (einer; Meldungen zu Serverabstürzen, Updates, Backups und geplanten Neustarts, bei Absturzmeldungen zusätzlich ein Neustart-Button), als Spielchat-Kanal (einer; leitet den Chat aus dem Spieleserver weiter) oder als Status-board-Kanal (einer; eine Statuskarte pro laufendem Server) zu. Details unter Kanalfunktionen in Befehle. Ein Kanal hat nur eine Art; erneutes Ausführen derselben Art entfernt sie. Auch änderbar in der App unter Discord-Server → Tab Server verwalten → Saba-chan zuweisen
/saba language <language>Node-BesitzerSprache, in der der Bot auf diesem Server antwortet (Automatisch = der Sprache der verknüpften App folgen)
/saba readingNode-BesitzerLautstärke, Tempo und Tonhöhe der Vorlesenden Saba-chan auf diesem Server sowie das Ansprechen mit Namen. Nur für Sie sichtbar
/saba big-emoji state:<On|Off>Node-Besitzer, ServerbesitzerNachrichten, die nur ein benutzerdefiniertes Emoji enthalten, als großes Bild neu posten (standardmäßig aus)
/saba webAlle (eigenes Konto)Einmal-Link (5 Minuten) zu Saba-chan Web. Ist ein PC vorhanden, auch für diesen PC, sonst nur für die Einstellungen der Discord-Server, die ich verwalte. Nur für Sie sichtbar
/saba settingsNode-BesitzerÄndert die Einstellungen der Sprechenden Saba-chan auf diesem Server (an/aus, Einmischen, Gedächtnis, KI-Moderation, Bestätigungsstufe vor der Ausführung, Tools pro Kategorie, Auslösewörter). Tools, die in der App über die global erlaubten Tools gesperrt sind, lassen sich nicht einschalten. Nur für Sie sichtbar
/saba helpAlleZeigt die Bedienung von Saba-chan und die Befehlsliste (nur für Sie sichtbar)
/mysaba webAlle (eigenes Konto)Dasselbe wie /saba web. Funktioniert auf jedem Server und in DMs
/mysaba my-pcsAlle (eigene PCs)Listet die PCs an Ihrem Discord-Konto, umbenennen oder entfernen (nur für Sie sichtbar)
/mysaba agentAlle (eigenes Konto)Zeigt die mit Ihrem Discord-Konto verbundenen KI-Agenten (Remote-MCP) an und trennt sie. Gibt es keinen, zeigt der Befehl die Adresse, die Sie im Agenten eintragen. Funktioniert auch in DMs, nur für Sie sichtbar (KI-Agenten verbinden)
/saba updatePerson, die den PC verbunden hatSucht Saba-chan-Updates auf dem PC, der mit diesem Server verbunden ist, und wendet sie nach Klick auf den Bestätigungsbutton an

/mysaba ist ein Befehl zu Ihrem eigenen Konto und steht daher nicht in der Mitgliederliste eines Servers. Installieren Sie Saba-chan mit dem Button Auf meinem Konto installieren, den der Bot nach dem Verbinden eines PCs anzeigt, auf Ihrem Discord-Konto, sehen nur Sie den Befehl auf jedem Server und in DMs. In einer DM mit dem Bot nutzen Sie /saba web, /saba my-pcs und /saba agent auch ohne Installation.

Auf Discord-Servern mit verbundenem PC werden Berechtigungs-, Schlaf-, Sprach-, Singende-Saba-chan- und Vorlesende-Saba-chan-Einstellungen in Saba-chan auf Ihrem PC gespeichert; diese Befehle wirken daher, solange Ihr PC eingeschaltet ist (Server ohne PC: §2.5). Dieselben Einstellungen lassen sich auch im Discord-Server-Bildschirm der App ändern. Berechtigungen stellen Sie im Tab Instanzen ein: Klicken Sie auf einen Server und öffnen Sie die Bildschirme Befehle pro Stufe und Stufen pro Mitglied. Singende und Vorlesende Saba-chan haben jeweils einen eigenen Tab, Sprache, Präfix und Aussehen der Slash-Befehle stehen im Tab Bot-Einstellungen. Alle Discord-Server auf einmal schlafen zu legen geht im Bildschirm Discord → Verbindung.

3.1 Slash-Befehle pro Server und das Aktionsmenü

Nach dem Pairing registriert der Bot in jedem Discord-Server zusätzliche Befehle.

  • /<Servername> command:<Befehl> arg1:… arg2:…: pro Spieleserver-Instanz ein Befehl. In der Discord-Befehlsliste erscheint pro Server nur eine Zeile. Klicken Sie auf das Feld command, erscheinen die auf diesem Server verfügbaren Befehle (Starten, Stoppen, Status, Aufgaben, Modulbefehle) als Liste, und beim Tippen wird nach dem Namen gefiltert. Die Argumentfelder zeigen passend zum gewählten Befehl eine Auswahlliste, Ja/Nein, einen Zahlenbereich oder einen Eingabehinweis.
  • In der Befehlsliste fehlen Befehle, die Sie mit Ihrer Stufe nicht nutzen können, und Befehle, die zum aktuellen Serverstatus nicht passen (Start bei einem laufenden, Stopp bei einem gestoppten Server); die Befehle, die Sie auf diesem Server zuletzt genutzt haben, stehen zuerst. Ob Sie einen Befehl wirklich nutzen dürfen, prüft die Saba-chan-App noch einmal.
  • Aktionen: Aktionen, die die Saba-chan-App für Discord freigibt (Neustart, Sicherung usw.), stehen in derselben Befehlsliste. Aktionen, die laut Rückfrage-Einstellung (§5) eine Bestätigung brauchen, zeigen, was sich ändert, und die anfragende Person muss die Ausführen-Schaltfläche drücken. Updates der Saba-chan-App stehen nicht im Aufgabenmenü; nutzen Sie /saba update.
  • Spieler: Server, deren Spiel die Anzeige der verbundenen Spieler unterstützt, bekommen einen Befehl Spieler in der Liste. Er zeigt, wie viele Personen online sind und wie sie heißen.
  • Backup wiederherstellen: Sie wählen das Backup aus einer Liste (Tippen grenzt sie ein). Läuft der Server, fragt der Bot zuerst; Stoppen und fortfahren stoppt den Server und stellt danach wieder her. Wiederherstellen ist eine gefährliche Aktion, daher wird noch einmal bestätigt. Nur die anfragende Person kann die Knöpfe drücken.
  • Bereit-Meldung: Wenn Sie einen Server mit seinem Slash-Befehl /<Servername>, dem Knopf Neu starten einer Meldung oder der Sprechenden Saba-chan starten oder neu starten, meldet der Bot im selben Kanal „Alles gestartet“, sobald der Server Spieler annimmt. Startet er nicht, erhalten Sie den Grund in einer Zeile.
  • Es erscheinen nur Instanzen, die für diesen Server erlaubt sind (in der App unter Discord-Server → Tab Instanzen).

4. Chat-Befehle (Präfix)

Nach dem Pairing können Sie Server aus Discord-Textkanälen mit präfixbasierten Befehlen steuern.

Saba-chan <server> <command> [args…]

Das Standardpräfix ist Saba-chan. In der App können Sie es unter Discord-Server → Tab Bot-Einstellungen → Befehlspräfix für jeden Discord-Server ändern oder ergänzen.

<server> kann ein Instanzname, ein Server-Alias oder ein Modulname bzw. -alias sein. Befehle, die alle Module gemeinsam haben:

BefehlBeschreibung
startServer starten. Beispiel: Saba-chan minecraft start
stopServer stoppen
statusStatus abfragen

Die Rufnamen für Server und Befehle legen Sie in der Serveransicht der App im Tab Discord fest. Die vollständige Befehlsliste finden Sie im Dokument Befehle.


5. Berechtigungsstufen

Die Stufen sind Besitzer (3) > Admin (2) > Benutzer (1) > Gast (0) > Gesperrt (-1). Die Stufen sind kumulativ: Eine höhere Stufe nutzt alle Befehle der niedrigeren.

  • Der Besitzer ist die Person, die den Server verbunden hat (der Node-Besitzer). Er kann alle Befehle verwenden und nicht herabgestuft werden.
  • Jeder Befehl hat ein Risiko (Sicher, Vorsicht, Gefährlich). Mit der Standardvorgabe sind die erforderlichen Stufen Sicher = Gast, Vorsicht = Benutzer, Gefährlich = Admin. Klicken Sie in der App unter Discord-Server → Tab Instanzen auf einen Server; in der Treppe Befehle pro Stufe wählen Sie die Vorgabe (Locker, Standard, Streng) oder schieben einen Befehls-Chip auf eine andere Stufe. Stufen von Mitgliedern und die Standardstufe legen Sie am selben Ort unter Stufen pro Mitglied fest; sie gelten gemeinsam für alle Server dieses Discord-Servers.
  • Hilfe und Listen kann jeder nutzen, der nicht gesperrt ist. Gesperrte Mitglieder können keine Bot-Funktion nutzen, auch nicht die Singende und die Sprechende Saba-chan.
  • Anfragen über die Sprechende Saba-chan können die Grenze für die Sprechende Saba-chan (anfangs Gast) nicht überschreiten.

Rückfragen: Ob vor der Ausführung ein Bestätigungsbutton an die anfragende Person geht, stellen Sie in der App unter Discord-Server → Tab Bot-Einstellungen in der Karte Rückfragen ein (oder mit saba-chan-cli bot confirm). Bei Anfragen direkt an den Bot (Präfix, Slash) wird anfangs nur bei gefährlichen Befehlen gefragt, bei der Sprechenden Saba-chan anfangs bei allen Befehlen; beide lassen sich auf Alle Befehle, Ab Vorsicht, Nur gefährliche Befehle oder Nie fragen stellen. Welche Risikostufe pro Befehl für die Rückfrage gilt, ändern Sie im Chip-Bearbeitungsfenster des Berechtigungsbildschirms (die nötige Stufe ändert sich dadurch nicht). Von der Sprechenden Saba-chan gewählte Verwaltungsaktionen werden unabhängig von der Einstellung immer abgefragt. Den Bestätigungsbutton kann nur die anfragende Person drücken.


6. Singende Saba-chan

Die Musikwiedergabe übernimmt der offizielle Musikserver (music-server), der neben dem Relay-Server läuft.

  • Wenn Sie einen Befehl wie Saba-chan play … ausführen, übergibt der Bot ihn an den Musikserver, der den Ton in den Discord-Sprachkanal streamt.
  • Sie müssen weder ffmpeg noch yt-dlp auf Ihrem PC installieren.
  • Musikbefehle funktionieren in jedem Kanal. Haben Sie mit /saba assign kind:Singende Saba-chan einen Kanal der Singenden Saba-chan festgelegt, können Sie dort Befehle ohne Präfix (oder nur einen Suchbegriff) eingeben, und es wird eine Player-Anzeige eingeblendet.
  • Die Singende Saba-chan ist von Anfang an eingeschaltet; schalten Sie sie in der App unter Discord-Server → Tab Singende Saba-chan aus. Auf Servern, auf denen sie eingeschaltet ist, gibt es den Slash-Befehl /music (Befehle, Abschnitt zur Singenden Saba-chan).

7. Sprechende Saba-chan (KI-Chat)

  • Die Sprechende Saba-chan funktioniert erst, nachdem Sie in der App einen API-Schlüssel hinterlegt und sie für jeden Discord-Server eingeschaltet haben (im Tab Sprechende Saba-chan des Discord-Server-Bildschirms oder mit /saba settings; auf neuen Servern ist sie aus). Der Schlüssel ist nur Ihrem PC und dem Relay bekannt und wird in Discord nie angezeigt.
  • Auch die nutzbaren Tools (Spieleserver steuern, Websuche, Statistiken zu LoL, TFT und PUBG, MapleStory-Charaktere, Suche über mehrere Spiele, Alltagsinformationen, Bilderzeugung) schalten Sie pro Discord-Server ein. Tools, die Sie im gemeinsamen Menü der App unter Global erlaubte Tools gesperrt haben, werden auf keinem Server genutzt. Ist das Tool für Spieleserver nicht eingeschaltet, rührt sie keinen Server an.
  • Die Sprechende Saba-chan spricht nur in Kanälen, die mit /saba assign kind:Sprechende Saba-chan zugewiesen wurden. In anderen Kanälen antwortet sie nicht, selbst wenn sie angesprochen wird.
  • Die Sprechende Saba-chan kann nur Aktionen nutzen, die ein Modul oder eine Erweiterung für sie freigibt. Alles andere wird abgelehnt.
  • Abfragen laufen sofort. Aktionen, die etwas ändern, werden zuerst zu einem Plan und laufen je nach Rückfragestufe (§5, anfangs alle Befehle) über einen Bestätigungsknopf. Verwaltende Aktionen warten immer auf einen Bestätigungsknopf. Nur die anfragende Person kann den Knopf drücken.
  • Sie führt nie etwas oberhalb der Grenze für die Sprechende Saba-chan (§5) aus.
  • Ist die Sprechende Saba-chan aktiviert, wird ein Chat-Befehl, den der Daemon nicht erkennt, von ihr in einen exakten Befehl umgewandelt und noch einmal versucht.
  • Fragen Sie die Sprechende Saba-chan nach Logs, liest sie die Server-Logs, auch frühere Läufe. Bitten Sie um eine Datei, hängt sie eine .log-Datei an, ohne sie durch die KI zu schicken (bis 4 MiB, sonst der neueste Teil; IPs, Geheimnisse und Pfade werden verdeckt).

8. Sicherheitsmodell

  • Der Daemon sendet das Node-Token aus dem Pairing (sbn_{hostId}.{secret}) über HTTPS im Header Authorization: Bearer. Das Relay prüft dieses Token gegen seinen gespeicherten Argon2-Hash.
  • Der Relay-Server speichert das Token selbst nie, sondern vergleicht mit einem Argon2-Hash.
  • Der Daemon nimmt keine eingehenden Verbindungen an. Spieleserver-Passwörter werden nicht an das Relay gesendet.

9. Fehlerbehebung

SymptomUrsache / Lösung
Bot reagiert nichtPrüfen Sie das Präfix (Standard Saba-chan) und dass danach ein Leerzeichen steht. Der Bot muss auf dem Server sein, das Pairing muss abgeschlossen und Befehlsweiterleitung in der App eingeschaltet sein. Prüfen Sie auch, dass der Bot nicht mit /saba sleep schlafen gelegt wurde
Saba-chan … start → Server nicht gefundenDas erste Wort ist der Server (Instanzname/-alias oder Modulname/-alias), das zweite der Befehl. Betreiben Sie mehrere Server desselben Spiels, verwenden Sie den Instanznamen oder einen Server-Alias
Pairing-Code abgelaufenDer Code ist 5 Minuten gültig, und diese Zeit ist vorbei. Holen Sie sich in der App einen neuen Code
Die App wartet endlosPrüfen Sie, ob der Slash-Befehl /saba connect tatsächlich ausgeführt wurde und Sie die Berechtigung „Server verwalten“ haben
Discord-Befehle erreichen den PC nichtWählen Sie beim Pairing an anderer Stelle mit Neu verbinden diesen PC aus, wird die frühere Verbindung dieses PCs getrennt. Pairen Sie diesen PC erneut

Detailliertere Abläufe zur Fehlersuche finden Sie im Dokument Fehlerbehebung.