Ein Webhook postet eine kurze Nachricht in einem Discord-Kanal, wenn auf deinem Server etwas passiert: Er startet, stoppt oder stürzt ab, ein Spieler tritt bei oder geht, oder ein Backup ist fertig. Alle im Kanal sehen es, ohne das Panel zu öffnen. Ein Webhook kann auch an jede andere https-Adresse senden, für deine eigenen Tools.
Nur der Besitzer eines Servers kann dessen Webhooks einrichten. Leute, die du zum Server eingeladen hast, sehen die Seite nicht.
1. Einen Webhook in Discord erstellen
Du brauchst die Berechtigung, Webhooks auf dem Discord-Server zu verwalten. Der Besitzer und die Admins haben sie normalerweise.
- Öffne in Discord die Servereinstellungen und gehe zu Integrationen.
- Klicke auf Webhook erstellen, gib ihm einen Namen und wähle den Textkanal, in den er postet, zum Beispiel einen Kanal
#server-alerts. - Klicke auf Webhook-URL kopieren.
Discord erklärt diese Schritte mit Bildern in seiner Anleitung Intro to Webhooks. Behandle die Webhook-URL wie ein Passwort: Jeder, der sie hat, kann in diesem Kanal posten.
2. Zu deinem Server hinzufügen
- Öffne deinen Server im Panel und klicke im linken Menü auf Webhooks.
- Klicke auf Einen hinzufügen oder, wenn der Server schon einen hat, auf Neuer Webhook.
- Gib ihm auf Wunsch einen Namen. Er ist nur für dich und beschriftet den Webhook in deiner Liste.
- Füge die Adresse in URL ein. Sie muss mit
https://beginnen. Ist es ein Discord-Webhook, zeigt das Panel Discord-Webhook erkannt. - Hake unter Senden, wenn die Events an, die du willst (siehe unten). Server abgestürzt ist zu Beginn angehakt, und mindestens eins muss angehakt sein.
- Klicke auf Webhook erstellen.
Die Events
| Event | Wann es gesendet wird |
|---|---|
| Server gestartet | Wenn der Server oben und bereit für Spieler ist, auch nach einem Neustart. |
| Server gestoppt | Ein Stopp, den jemand ausgelöst hat: du, ein Teammitglied oder ein Zeitplan. |
| Server abgestürzt | Der Server ist ausgefallen, ohne dass jemand es wollte. Die Nachricht kommt ein bis zwei Minuten später, sobald wir sicher sind, und sagt, ob der Server von selbst wieder hochkam. |
| Spieler beigetreten | Mit dem Namen des Spielers, bei Spielen, die melden, wer online ist. Spiele, die nur eine Anzahl melden, sagen, wie viele. |
| Spieler gegangen | Dasselbe, wenn jemand geht. Die Spieler werden einmal pro Minute geprüft, solange der Server läuft. |
| Backup fertig | Ob das Backup geklappt hat und wie groß es ist. |
| Installation fertig | Nach der Erstinstallation oder einer Neuinstallation. |
| Umzug fertig | Wenn der Umzug deines Servers abgeschlossen ist. |
Project-Zomboid-Server haben zusätzliche Events, die aus dem Log des Spiels gelesen werden: Spieler gestorben, PvP-Kill, Admin-Aktion, Mod aktualisiert, Neustart-Countdown gestartet und Chat im Spiel weiterleiten. Der Chat wird nur gesendet, wenn du ihn anhakst, und nur der allgemeine Chat: Flüstern, Fraktions- und Safehouse-Chat werden nie gesendet.
Was ankommt
- In Discord kommen die Nachrichten von PlayNHost als kurze Karten mit dem Servernamen, was passiert ist und wann. Discord zeigt die Zeit in der Zeitzone des jeweiligen Lesers.
- Die Nachrichten nennen den Namen deines Servers, enthalten aber nie seine Adresse oder seine ID, deshalb können sie in einem öffentlichen Kanal landen. Um den angezeigten Namen zu ändern, benenne den Server um. Siehe So benennst du deinen Server um und änderst die Spieler-Slots.
- Ein Spieler kann deinen Kanal nicht mit seinem Namen pingen. Ein Name wie
@everyonekommt als normaler Text an. - Jede andere Adresse bekommt die Events als JSON. Siehe Für deine eigenen Tools weiter unten.
Einen Webhook ausschalten, ändern oder löschen
- Mit dem Schalter in der Zeile eines Webhooks schaltest du ihn aus und wieder ein. Seine Einstellungen bleiben erhalten, solange er aus ist.
- Öffne das Menü der Zeile und wähle Bearbeiten, um Name, Adresse oder Events zu ändern, oder Löschen, um ihn zu entfernen. Sonst ist nichts betroffen: Dein Server läuft weiter, und der Kanal bekommt einfach keine Nachrichten mehr.
Gut zu wissen
- Ein Server kann bis zu 10 Webhooks haben, zum Beispiel einen pro Kanal.
- Damit ein Kanal lesbar bleibt, sendet jeder Webhook höchstens 4 Nachrichten pro Minute und 40 pro Stunde. Nachrichten darüber werden übersprungen, statt verspätet gesendet zu werden, und die nächste Nachricht sagt, wie viele frühere Updates übersprungen wurden.
- Wird der Webhook in Discord gelöscht, schaltet das Panel ihn beim nächsten Sendeversuch von selbst aus, und die Zeile zeigt Aus. Erstelle in Discord einen neuen Webhook, wähle Bearbeiten, füge die neue Adresse ein und schalte ihn wieder ein.
- Es gibt keinen Test-Button. Um einen neuen Webhook zu prüfen, hake Server gestartet an und starte deinen Server neu. Die Nachricht kommt kurz, nachdem der Server bereit ist.
- Webhooks sind für einen Kanal, den deine Gruppe teilt. Für Benachrichtigungen nur an dich, im Panel oder per E-Mail, siehe So verwaltest du Benachrichtigungen und Einstellungen.
Für deine eigenen Tools
Eine Adresse, die kein Discord-Webhook ist, bekommt einen POST mit einem JSON-Body:
sourceistPlayNHost.eventsist eine Liste. Jedes Event hat einentype(zum Beispielserver.crashoderplayer.join),server(den Namen des Servers),at(wann es passiert ist), einen lesbarentitleundtextsowie eindata-Objekt mit den Details.skippedist die Zahl früherer Nachrichten, die wegen des obigen Limits ausgelassen wurden.
Die Adresse muss https nutzen und auf eine öffentliche Adresse im Internet zeigen. Weiterleitungen werden nicht verfolgt. Nachrichten sind nicht signiert, halte also die Adresse selbst geheim.
Weiterführend
- So siehst du, was auf deinem Server passiert ist zeigt, wer was wann gestartet, gestoppt oder geändert hat.
- So behebst du, dass ein Server nicht startet hilft, wenn eine Absturzmeldung immer wiederkommt.
