tapscrollWIKI

Discord-Integration

Bot einladen, Kanal binden — Reports und Alerts dort, wo dein Team ohnehin schon ist.

PulseNode v5.0.2Paper · Spigot1.21 – 1.21.x

Reports per E-Mail übersieht man leicht. Der Discord-Bot legt sie in den Kanal, den dein Team ohnehin offen hat.

Einrichtung

  1. Bot einladen

    Im Dashboard: Server → Integrationen → Discord verbinden. Das öffnet Discords eigenen Autorisierungsdialog für deinen Server.

    Der Bot braucht die Rechte, den Kanal zu sehen und dort zu schreiben. Sonst nichts.

  2. Kanal wählen

    Zurück im Dashboard wählst du, welcher Kanal die Reports und Alerts dieses Servers bekommt.

    Die Bindung gilt pro PulseNode-Server. Ein Netzwerk kann survival und lobby also in verschiedene Kanäle schicken — oder beide in denselben, jeweils mit Servernamen gekennzeichnet.

  3. Auswählen, was gepostet wird

    Unter Server → Alerts entscheidest du, welche Ereignisse nach Discord gehen und welche nur per E-Mail kommen. Reports und kritische Alerts sind die sinnvolle Standardwahl; alles andere wird schnell zu Rauschen.

Was gepostet wird

EreignisWann
ReportWöchentlich, bei Business täglich
Kritische TPSWenn die TPS unter critical-tps fällt
Server offlineWenn das Plugin länger als die Karenzzeit nichts mehr sendet
Server wieder onlineWenn es weitergeht
Security-EreignisGefährliche Befehle, Verbindungsfluten, Login-Fehlschläge (tarifabhängig)

Alerts sind auf maxAlertsPerDay deines Tarifs begrenzt — 10 bei Free, unbegrenzt bei Pro und Business. Der Deckel existiert, damit ein um 3 Uhr flatternder Server nicht 400 Nachrichten erzeugt.

Kanalwahl

Nimm einen team-internen Kanal

Alerts nennen Spieler, und Security-Ereignisse enthalten IP-Adressen. Das gehört nicht in einen öffentlichen Kanal.

Ein praxistaugliches Setup für ein Netzwerk:

  • #pulsenode-reports — wöchentliche und tägliche Reports, ruhig und lesbar
  • #pulsenode-alerts — kritische TPS und Offline-Alerts, mit Ping fürs Team
  • Security-Ereignisse in die Alerts, oder in einen dritten privaten Kanal, wenn dein Moderationsteam größer ist als dein Technikteam

Offline-Erkennung

Das Dashboard merkt, wenn ein Server aufhört zu senden. „Offline" bedeutet dabei eine Karenzzeit von mehreren Intervallen, nicht eine einzelne verpasste Übertragung — eine verlorene Anfrage oder ein kurzer Netzwerkaussetzer soll niemanden aus dem Bett holen.

Für geplante Neustarts ist das echt praktisch: Ein Neustart, der länger dauert als sonst, erscheint als Offline-Alert gefolgt von einer Wiederherstellung, mit der Dauer dazwischen.

Integration entfernen

Unter Server → Integrationen trennen oder den Bot aus deinem Discord-Server entfernen. Reports gehen dann wieder nur per E-Mail; sonst ändert sich nichts und es gehen keine Daten verloren.

Fehlersuche

Es kommt nichts an. Prüfe, ob der Bot den Kanal überhaupt sehen kann — bei einem privaten Kanal muss seine Rolle explizit hinzugefügt werden, und Discord warnt dich nicht davor.

Reports kommen, Alerts nicht. Alerts werden separat unter Server → Alerts konfiguriert, und im kostenlosen Tarif kann das Tageslimit von 10 bereits aufgebraucht sein.

Doppelte Nachrichten. Zwei PulseNode-Server sind an denselben Kanal gebunden und posten beide. Das ist unterstützt und oft gewollt — schau auf den Servernamen im Nachrichtenkopf, bevor du es für einen Fehler hältst.