Game Server Watcher auf ServerPrism einrichten

Diese Anleitung behandelt die Einrichtung Ihres Game Server Watcher Discord Bots, von der Erstellung im Discord Developer Portal bis zur Konfiguration auf Ihrer ServerPrism-Instanz.

Erstellen Sie Ihren Bot im Discord Developer Portal

1. Gehen Sie zum Discord Developer Portal.
2. Klicken Sie auf New Application.
3. Geben Sie Ihrer Anwendung einen Namen (z.B. „Game Server Watcher“) und klicken Sie auf Create.
4. Navigieren Sie in der linken Seitenleiste zum Tab Bot.
5. Klicken Sie auf Add Bot, dann auf Yes, do it!.
6. Klicken Sie unter TOKEN auf Reset Token, dann auf Yes, do it!.
7. Kopieren Sie den angezeigten Token. Diesen benötigen Sie später.
8. Deaktivieren Sie den Schalter Public Bot, wenn Sie nicht möchten, dass andere Ihren Bot einladen.
9. Stellen Sie unter Privileged Gateway Intents sicher, dass PRESENCE INTENT, SERVER MEMBERS INTENT und MESSAGE CONTENT INTENT AUS sind. Game Server Watcher verwendet hauptsächlich Slash-Befehle und benötigt diese Intents nicht.

Laden Sie den Bot auf Ihren Server ein

1. Gehen Sie im Discord Developer Portal zum Tab OAuth2, dann zu URL Generator.
2. Wählen Sie unter SCOPES bot und applications.commands aus.
3. Wählen Sie unter BOT PERMISSIONS Folgendes aus:
   • Send Messages
   • Embed Links
   • Read Message History
   • Use External Emojis
4. Kopieren Sie die generierte URL am unteren Rand.
5. Fügen Sie die URL in Ihren Browser ein, wählen Sie Ihren Discord-Server aus dem Dropdown-Menü und klicken Sie auf Authorize.

Bestellung auf ServerPrism

Falls Sie es noch nicht getan haben, bestellen Sie Ihren Discord Bot Server:

1. Gehen Sie auf die ServerPrism-Website und wählen Sie das Produkt Discord Bots aus.
2. Wählen Sie Game Server Watcher als gewünschte Bot-Laufzeitumgebung.
3. Wir empfehlen mindestens 1 GB RAM für Game Server Watcher, was in der Regel ausreicht, um mehrere Server zu überwachen.
4. Wählen Sie Ihre bevorzugte Region und schließen Sie den Bereitstellungsprozess ab.

Startvariablen konfigurieren

Game Server Watcher benötigt spezifische Umgebungsvariablen, um zu funktionieren. Diese konfigurieren Sie auf dem Tab Startup Ihres ServerPrism-Panels.

1. BOT_TOKEN: Fügen Sie den Bot-Token ein, den Sie aus dem Discord Developer Portal kopiert haben.

2. PREFIX: Legen Sie ein Befehlspräfix für Ihren Bot fest (z.B. !). Beachten Sie, dass Game Server Watcher hauptsächlich Slash-Befehle (/) verwendet, aber einige ältere Funktionen oder Hilfe-Befehle ein Präfix nutzen könnten.

3. OWNER_ID: Ihre Discord-Benutzer-ID. Um diese zu erhalten, aktivieren Sie den Entwicklermodus in Discord (Benutzereinstellungen > Erweitert > Entwicklermodus), klicken Sie dann mit der rechten Maustaste auf Ihren Benutzernamen und wählen Sie ID kopieren.

4. SERVERS: Diese Variable definiert die Spielserver, die Ihr Bot überwachen wird. Es ist ein Array von JSON-Objekten. Jedes Objekt repräsentiert einen Server. Hier ist ein Beispiel für einen Minecraft-Server und einen Counter-Strike-Server:

   [
     {
       "name": "My Minecraft Server",
       "type": "minecraft",
       "host": "play.example.com",
       "port": 25565
     },
     {
       "name": "CS:GO Fun Server",
       "type": "csgo",
       "host": "192.168.1.100",
       "port": 27015
     }
   ]
   

   Eine vollständige Liste der unterstützten Spieltypen und deren Konfigurationsoptionen finden Sie auf der Game Server Watcher GitHub-Seite.

5. STATUS_MESSAGE: (Optional) Eine benutzerdefinierte Nachricht für den Discord-Status des Bots (z.B. Monitoring your games!).

6. UPDATE_INTERVAL: (Optional) Das Intervall in Sekunden für die Überprüfung des Serverstatus (Standard ist 60).

Nachdem Sie alle Variablen eingestellt haben, klicken Sie auf den Restart-Button auf dem Tab Console, um die Änderungen zu übernehmen.

Erster Start

Sobald Sie die Startvariablen konfiguriert und Ihren Server neu gestartet haben, navigieren Sie zum Tab Console.

• Erfolg: Sie sollten eine Ausgabe sehen, die anzeigt, dass der Bot sich mit Discord verbindet und Serverinformationen abruft. Achten Sie auf Meldungen wie [INFO] Logged in as Game Server Watcher und [INFO] Successfully updated slash commands.
• Bot-Status: Ihr Bot sollte auf Ihrem Discord-Server online erscheinen.

Häufige Probleme

• Bot geht nicht online: Überprüfen Sie Ihren BOT_TOKEN auf Tippfehler. Stellen Sie sicher, dass keine zusätzlichen Leerzeichen vorhanden sind.
• Bot ist online, reagiert aber nicht auf Befehle: Vergewissern Sie sich, dass der applications.commands-Scope während des Einladungsprozesses ausgewählt wurde. Stellen Sie außerdem sicher, dass Ihre SERVERS-Variable korrekt als JSON formatiert ist.
• „Invalid Token“ in der Konsole: Ihr BOT_TOKEN ist falsch oder widerrufen. Generieren Sie einen neuen Token im Discord Developer Portal und aktualisieren Sie die Variable BOT_TOKEN.
• Fehler beim Parsen der SERVERS-Variable: Stellen Sie sicher, dass Ihr JSON gültig ist. Verwenden Sie einen Online-JSON-Validator, wenn Sie unsicher sind.

Nächste Schritte

Nachdem Ihr Game Server Watcher Bot läuft, können Sie Slash-Befehle auf Ihrem Discord-Server verwenden, um mit ihm zu interagieren. Versuchen Sie /status, um den aktuellen Status Ihrer konfigurierten Spielserver zu sehen. Für erweiterte Konfigurationen und Befehlsdetails lesen Sie die offizielle Game Server Watcher Dokumentation auf GitHub.