Server verwalten

Der tägliche Ablauf beim Betrieb von Spieleservern mit Saba-chan, vom Hinzufügen, Starten und Überwachen von Servern über Backups und Zeitpläne bis zum Einladen von Freunden und der Discord-Anbindung.

Server verwalten

Dieses Dokument erklärt, wie Sie Saba-chan aus Anwendersicht verwenden. Auch ohne Modulcode anzufassen oder eigene Erweiterungen zu schreiben, reicht diese eine Seite aus, um ein, zwei Spieleserver für Ihre Freunde zu betreiben.

Die Installation ist in Erste Schritte beschrieben, das Bot-Pairing in Discord-Bot & Cloud-Relay. Hier gehen wir davon aus, dass die Installation abgeschlossen ist, und konzentrieren uns darauf, was Sie bei geöffneter GUI anklicken und worauf Sie achten sollten.


1. Das große Ganze: Die GUI ist die Fernbedienung, der Daemon betreibt die Server

Merken Sie sich zuerst: Wenn Sie das GUI-Fenster schließen, werden Ihre Spieleserver nicht heruntergefahren.

  • saba-chan-gui (Fenster): die Fernbedienung, die Befehle an den Daemon sendet und die Oberfläche darstellt. Die CLI (saba-chan-cli) erfüllt dieselbe Rolle.
  • saba-core (Daemon): der Kernprozess, der im Hintergrund läuft und Spieleserver startet und überwacht. Laufende Server, Backups, geplante Aufgaben und die Discord-Verbindung werden allesamt vom Daemon übernommen.
  • Spieleserver-Prozesse: die eigentlichen Server, die der Daemon startet (java, PalServer.exe usw.).

Ihr Alltag sieht daher so aus:

  1. Starten Sie die GUI, und der Daemon startet mit (läuft er bereits, verbindet sich die GUI mit ihm).
  2. Wenn Ihre Freunde online kommen, klicken Sie im Serverbildschirm auf Starten.
  3. Während des Spielens können Sie das Fenster minimieren oder schließen. Beim Schließen wählen Sie zwischen Nur Oberfläche beenden (der Daemon läuft weiter) und Alles beenden (auch der Daemon wird gestoppt). Damit die Server weiterlaufen, wählen Sie Nur Oberfläche beenden.
  4. Wenn Sie fertig sind, öffnen Sie die GUI erneut und klicken auf Stoppen.

Wenn Sie den PC herunterfahren, werden auch Ihre Spieleserver beendet. Der Daemon läuft nur auf Ihrem eigenen PC. Für einen Betrieb rund um die Uhr nutzen Sie dediziertes Hosting.


2. Den ersten Server erstellen (Kurzfassung)

Die vollständige Anleitung finden Sie unter Erste Schritte. Kurz zusammengefasst:

  1. Klicken Sie im Bildschirm Server auf Server hinzufügen.
  2. Wählen Sie Als neuer Server hinzufügen. Wenn Sie bereits einen Serverordner haben, bindet Vorhandenen Server migrieren ihn stattdessen ein (die Dateien bleiben, wo sie sind).
  3. Wählen Sie ein Spiel (Minecraft / Palworld / Project Zomboid / Terraria usw.) und legen Sie dann den Servernamen und eine empfohlene Voreinstellung fest.
  4. Hat das Spiel Bedingungen, denen zugestimmt werden muss, stimmen Sie hier zu. Minecraft etwa verlangt die Zustimmung zur Minecraft EULA, bevor der Server starten kann (§3.7).
  5. Klicken Sie auf Server hinzufügen. Die Serverdateien werden automatisch heruntergeladen, und der Fortschritt wird im Serverbildschirm angezeigt.
  6. Sobald die Installation abgeschlossen ist, erscheint der Server in der Liste.

Ihren Server können Sie beliebig benennen: „Minecraft mit Freunden“, „Wochenend-Zomboid“ und so weiter. In Discord-Befehlen können Sie einen Server über seinen Namen oder über den Spielnamen (Alias) ansprechen. Solange ein Server gestoppt ist, können Sie ihn über den Stift-Button neben seinem Namen umbenennen.


3. Der tägliche Ablauf

Wenn Sie einen Server auswählen, öffnet sich rechts sein Bildschirm. Oben befinden sich der Button Starten/Stoppen und der Status, darunter die Tabs. Welche Tabs erscheinen, hängt vom Spiel ab.

TabInhalt
KonsoleServerausgabe und Befehlseingabe (nur bei Spielen mit Konsole)
BefehleDie Befehle, die das Spiel definiert (z. B. Palworld-Ankündigungen, Spielerliste)
EinstellungenSpieleinstellungen (Port, maximale Spielerzahl, Passwort usw.)
Saba-chanEinstellungen, wie Saba-chan den Server handhabt: automatischer Neustart, Speicherlimit, Stopp-Wartezeit, Vorschau der Startargumente, Weiterleitung des Spielchats
Backups & ZeitpläneBackups erstellen und wiederherstellen, geplante Aufgaben
DiscordRufnamen, mit denen dieser Server und seine Befehle in Discord aufgerufen werden
ProtokollWer wann gestartet, gestoppt oder Befehle gesendet hat
InfoPort, Version, Laufzeit, letzte Beendigungen, Serverprüfung, Serverordner öffnen, Server löschen

3.1 Starten / Stoppen / Neu starten

  • Starten: Der Daemon prüft zuerst die Zustimmung zu den Bedingungen und führt die Prüfungen des Moduls aus, dann startet er den Server. Findet die Prüfung ein kritisches Problem, wird der Server nicht gestartet und der Grund angezeigt.
  • Stoppen: Sendet den ordnungsgemäßen Stoppbefehl des Spiels (z. B. Minecraft stop, Zomboid quit) und wartet. Ist der Server nach der Stopp-Wartezeit (standardmäßig 30 Sekunden, je nach Spiel abweichend und im Tab Saba-chan änderbar) nicht beendet, wird er zwangsweise beendet.
  • Neu starten: Führt Stoppen → Starten in einem Schritt aus. Verbundene Spieler werden kurz getrennt.

3.2 Konsole ansehen / Befehle senden

  • Der Tab Konsole zeigt die Ausgabe des Spieleservers in Echtzeit.
  • Geben Sie einen Befehl ein und drücken Sie Enter, um ihn an die Serverkonsole (stdin) zu senden. Beispiele für Minecraft: say hi!, op FriendNick. Mit ↑ holen Sie frühere Befehle zurück.
  • Befehle folgen der Reihenfolge stdin → REST → RCON. Spiele ohne Konsole (etwa Palworld, das nur über seine REST-API gesteuert wird) bedienen Sie über die vordefinierten Befehle im Tab Befehle. RCON wird nur für ein Spiel ohne anderen Weg verwendet, nur über Loopback (127.0.0.1) mit Port und zufälligem Passwort pro Instanz, die der Daemon vergibt.
  • Die Konsole lässt sich in ein eigenes Fenster auslagern, und unter Windows öffnet Im Terminal öffnen eine CLI-Konsole.
  • Für jeden Server hält der Daemon die neuesten Konsolenzeilen (bis zu 10.000) im Speicher und schreibt sie zusätzlich in Dateien unter logs/ im Serverordner.

3.3 Mehrere Server gleichzeitig betreiben

  • Sie können mehrere Server desselben Spiels anlegen (z. B. „Vanilla MC“ und „Modpack MC“) oder verschiedene Spiele parallel betreiben.
  • Die Ports der Server (die Nummern, über die ein Spiel Spieler annimmt) dürfen sich nicht überschneiden. Beim Erstellen eines neuen Servers verschiebt Saba-chan den Standardport so, dass er nicht mit Ihren anderen Servern kollidiert, und überschneiden sich Ports doch, erscheint im Serverbildschirm eine Warnung. Den Port können Sie im Tab Einstellungen ändern.
  • Jeder zusätzliche Server braucht mehr Arbeitsspeicher und CPU Ihres PCs. Prüfen Sie die Daten Ihres PCs, bevor Sie weitere hinzufügen.

3.4 Absturzerkennung und automatischer Neustart

  • Wenn ein Server beendet wird, ermittelt der Daemon den Grund: Von dir gestoppt, Im Spiel gestoppt, Absturz oder Unbekannt. Das Ergebnis wird unter Letzte Beendigungen im Tab Info festgehalten.
  • Wird ein Absturz festgestellt, startet der Server standardmäßig automatisch neu. Der erste Neustart erfolgt nach 5 Sekunden, und die Wartezeit verdoppelt sich mit jedem Neustart. Nach mehr als 3 Neustarts innerhalb von 10 Minuten startet Saba-chan nicht mehr neu, und Sie müssen den Server selbst starten.
  • Sie können das unter Automatischer Neustart im Tab Saba-chan ändern.
    • Nach einem Absturz neu starten: wenn der Server eindeutig wegen eines Fehlers beendet wurde (standardmäßig aktiviert).
    • Auch bei unbekanntem Beenden neu starten: umfasst auch Fälle, die sich nicht beurteilen lassen, etwa ein Beenden über den Task-Manager (standardmäßig deaktiviert).
  • Server, die Sie selbst – über Saba-chan oder im Spiel – gestoppt haben, werden nicht neu gestartet.

3.5 Speicherlimit (Windows)

  • Unter Speicherlimit im Tab Saba-chan können Sie den Arbeitsspeicher (MB) begrenzen, den der Server und seine Kindprozesse zusammen nutzen dürfen. Wird das Limit überschritten, wird der Server gestoppt.
  • Lassen Sie das Feld leer, gibt es kein Limit. Bei Java-Servern setzen Sie es 1–2 GB höher als -Xmx.
  • Nur unter Windows; wirksam nach einem Neustart des Servers.

3.6 Vorschau der Startargumente

  • Bei Spielen mit Startargumenten zeigt Vorschau der Startargumente im Tab Saba-chan, mit welcher Befehlszeile der Server unter den aktuellen Einstellungen gestartet würde – ohne ihn zu starten.
  • Argumente, die Sie unter Zusätzliche Argumente eintragen und die nicht im Einstellungsbildschirm vorkommen (z. B. -players=16 -useperfthreads), werden beim Start unverändert übergeben. Fehlerhafte Werte werden direkt in der Vorschau markiert.
  • Werte wie Passwörter werden als *** maskiert.

3.7 Bedingungen zustimmen (Minecraft EULA usw.)

  • Hat ein Spieleserver Bedingungen, die eine Zustimmung erfordern, erscheint beim Erstellen oder ersten Starten des Servers der Dialog Zustimmung erforderlich. Lesen Sie den Originaltext, aktivieren Sie das Kontrollkästchen und klicken Sie auf Zustimmen und starten.
  • Die Zustimmung kann nur über GUI oder CLI auf diesem PC erteilt werden. Versucht jemand, den Server über Discord zu starten, bevor den Bedingungen zugestimmt wurde, stimmen Sie zuerst am PC zu.

4. Backups und geplante Aufgaben

Diese befinden sich im Tab Backups & Zeitpläne. Geplante Aufgaben gibt es für jeden Server; die Backup-Liste und Backup-Aufgaben erscheinen nur bei Spielen, die Backups unterstützen.

4.1 Backups

  • Jetzt sichern komprimiert Welt- und Speicherdateien. Was gesichert wird, entscheidet das Spielmodul (bei Minecraft die Weltordner). Läuft der Server, wird zuerst ein Speicherbefehl (Minecraft save-all usw.) an das Spiel gesendet.
  • Die Backup-Liste zeigt die Art jedes Backups: Manuell, Geplant, Vor Update, Vor Wiederherstellung.
  • Wiederherstellen ist nur bei gestopptem Server möglich. Vor dem Wiederherstellen wird der aktuelle Zustand noch einmal gesichert, sodass selbst ein falsch gewähltes Backup rückgängig gemacht werden kann.
  • Manuelle Backups sind von der automatischen Bereinigung ausgenommen. Die übrigen (geplant, vor Update, vor Wiederherstellung) werden bis zur Anzahl Zu behaltende geplante Backups (standardmäßig 10) aufbewahrt, wobei die ältesten zuerst gelöscht werden.
  • Backup-Dateien werden im Server-(Instanz-)Ordner gespeichert. Beim Löschen des Servers werden auch seine Backups gelöscht; kopieren Sie wichtige Backups daher an einen anderen Ort.

4.2 Geplante Aufgaben

Mit Aufgabe hinzufügen lassen Sie Folgendes automatisch in einem festen Intervall (alle N Minuten) oder täglich zu einer festen Uhrzeit (HH:MM, in der Zeitzone des PCs) ausführen.

AufgabeWas sie tut
BackupSichert, während der Server läuft
NeustartStartet den Server neu, wenn er läuft
AnkündigungSendet eine Nachricht im Spiel, wenn der Server läuft
UpdatePrüft auf ein Spieleserver-Update und spielt es ein, falls vorhanden (startet den Server neu, wenn er lief)
  • Neustart- und Update-Aufgaben können Spieler im Spiel vorab warnen (z. B. 10, 5, 1 Minuten vorher). Ankündigungen und Warnungen sind nur verfügbar, wenn das Spiel einen Ankündigungsbefehl unterstützt.
  • Startet der Daemon neu, beginnen Intervallaufgaben ab diesem Zeitpunkt neu zu zählen. Aufgaben, deren Zeitpunkt verstrichen ist, während der Daemon aus war, werden danach nicht gesammelt nachgeholt.

5. Freunde verbinden lassen

Wenn Sie den Spieleserver eingerichtet haben, Ihre Freunde aber nicht hineinkommen, liegt es fast immer an einem dieser drei Fälle.

5.1 Freunde im selben WLAN (LAN)

Keine zusätzliche Einrichtung nötig. Verbinden Sie sich einfach über die private IP des Server-PCs (z. B. 192.168.0.10) und den Port.

5.2 Freunde von außerhalb: der Router unterstützt Portweiterleitung

Portweiterleitung ist eine Router-Einstellung, die Verbindungen von außen an den Server-PC weiterreicht.

  1. Leiten Sie auf der Verwaltungsseite Ihres Routers den Spielport an die private IP des Server-PCs weiter.
  2. Geben Sie Ihren Freunden die Adresse <öffentliche IP>:<Port>. Ihre öffentliche IP finden Sie auf Seiten wie whatismyip.com.
  3. Erlauben Sie in der Windows-Firewall eingehenden Datenverkehr (Verbindungen von außen) auf diesem Port.

5.3 Freunde von außerhalb: Portweiterleitung nicht möglich

Portweiterleitung ist in Schul- und Firmennetzwerken, hinter CGNAT des Internetanbieters und in Gast-WLANs oft gesperrt. Auch dort können Sie Server über das Cloud-Relay weiterhin aus Discord starten und stoppen.

  • Holen Sie sich im Bildschirm Discord der GUI über Discord-Server verbinden einen Code und geben Sie ihn dann auf Ihrem Discord-Server mit dem Slash-Befehl /saba connect ein.
  • Danach können Ihre Freunde Server aus Discord starten und stoppen oder ihren Status abfragen.
  • Den ausführlichen Ablauf finden Sie unter Discord-Bot & Cloud-Relay.

Das Cloud-Relay leitet nur Steuerbefehle (Starten/Stoppen/Status usw.) weiter, keinen Spielverkehr. Wenn sich Ihre Freunde nicht direkt mit dem Spieleserver verbinden können, brauchen Sie unter Umständen zusätzlich eine weitere Lösung (z. B. ZeroTier, Tailscale).


6. Den Discord-Bot nutzen: Übersicht auf einer Seite

Sobald der Bot gepairt ist, lässt sich ein Großteil des Alltagsbetriebs aus Discord erledigen, ohne die GUI zu öffnen. Nachrichtenbefehle haben die Form <Präfix> <Server> <Befehl>, und das Standardpräfix ist Saba-chan (in den Bot-Einstellungen änderbar). Für <Server> verwenden Sie den Servernamen oder den Spielnamen (Alias).

SituationEingabe in Discord (Standardpräfix)
„Lass uns heute MC anwerfen“Saba-chan minecraft start
„Läuft der Server gerade?“Saba-chan minecraft status
„Fahren wir ihn runter“Saba-chan minecraft stop
„Welche Server gibt es?“Saba-chan list
„Was kann ich eingeben?“Saba-chan help

Jeder Server erhält außerdem einen eigenen Slash-Befehl /<Servername>. Die vollständige Befehlsliste und das Registrieren von Aliassen sind unter Befehle beschrieben.

Einrichtung, Pairing und Funktionsweise des Relays für den Bot selbst finden Sie unter Discord-Bot & Cloud-Relay.


7. Updates und Aufräumen

7.1 Saba-chan aktualisieren

  • Saba-chan prüft regelmäßig eine signierte Release-Liste und zeigt in der GUI die Benachrichtigung Updates verfügbar, wenn eine neue Version erschienen ist.
  • Unter Einstellungen → Saba Storage können Sie im Tab Komponenten Updates pro Komponente (Kern, Module, Erweiterungen usw.) herunterladen und anwenden. Bei Komponenten, deren laufende Dateien ersetzt werden müssen, etwa beim Kern, stoppt der Installer (saba-chan-installer) kurz den Daemon, tauscht die Dateien aus und startet nur das Geänderte wieder. Hat sich nur der Daemon geändert, bleibt das App-Fenster offen, und nur der Daemon startet neu.
  • Da der Daemon neu startet, spielen Sie Updates ein, wenn niemand spielt.

7.2 Einen Spieleserver aktualisieren

  • Ist eine neue Version des Spieleservers verfügbar, erscheint im Serverbildschirm der Button Aktualisieren. Das Update kann bei gestopptem Server angewendet werden.
  • Zuvor wird automatisch ein Backup Vor Update angelegt (bei Spielen, die Backups unterstützen).
  • Sie können Updates auch mit der geplanten Aufgabe Update (§4.2) automatisch zu einer festen Uhrzeit einspielen.

7.3 Einen Server löschen

  • Löschen Sie ihn mit Server löschen im Tab Info. Ein Server kann erst gelöscht werden, nachdem er gestoppt wurde.
  • Bei Servern, die Saba-chan heruntergeladen und erstellt hat, wird der Serverordner (einschließlich Spieleserver-Dateien und Backups) vollständig gelöscht. Kopieren Sie vorher alle Welten oder Backups, die Sie brauchen.
  • Bei Servern, die mit Vorhandenen Server migrieren eingebunden wurden, bleiben die Spieldateien im ursprünglichen Ordner erhalten.

7.4 Saba-chan deinstallieren

  • Deinstallieren Sie Saba-chan in Windows unter Einstellungen → Apps → Installierte Apps.
  • Das Deinstallationsprogramm beendet zuerst laufende Server ordnungsgemäß und entfernt dann den Installationsordner, den Datenordner (%APPDATA%\saba-chan\) und die Verknüpfungen. Dateien und Backups der von Saba-chan erstellten Server liegen standardmäßig ebenfalls in diesem Datenordner; kopieren Sie daher alle Welten, die Sie behalten möchten, vor der Deinstallation. Wenn Sie Keep game servers ankreuzen, bleiben Serverdateien, Welten, Backups und die Einstellungen der einzelnen Server erhalten, und mit Keep settings bleiben die App-Einstellungen und die Discord-Verbindung erhalten, sodass eine Neuinstallation sie übernimmt. Nutzt eine andere Saba-chan-Installation den Datenordner noch, bleibt er bestehen.

8. Wenn etwas schiefgeht

  • Erscheinen rote Zeilen in der Konsole, suchen Sie zuerst nach genau dieser Meldung. Saba-chan zeigt die Ausgabe des Spieleservers unverändert an.
  • Server prüfen und Protokoll analysieren im Tab Info prüfen auf Konfigurationsprobleme und bekannte Fehler in den letzten Protokollen.
  • Hilft das nicht weiter, finden Sie auf der Seite Fehlerbehebung häufige Szenarien und deren Lösung.
  • Stoßen Sie auf ein neues Problem, melden Sie es bitte zusammen mit der Konsolenausgabe unter GitHub Issues. GUI-Protokolle werden in %APPDATA%\saba-chan\logs\ gespeichert; diesen Ordner können Sie mit Protokollordner öffnen in dem Fenster öffnen, das erscheint, wenn Sie oben auf den Daemon-Status klicken. Wenn Sie diese Dateien anhängen, geht die Diagnose deutlich schneller.