DayZ-Killfeed

Live-Events deines DayZ-Servers direkt in Discord

Das DayZ-Killfeed-Modul verbindet TeraOne mit deinem Nitrado-DayZ-Server (PC, PS4/5 oder Xbox). Kills, Tode, Connects, Disconnects und andere Spieler-Events erscheinen automatisch als Embeds in einem Discord-Channel. Alle Ereignisse sind filterbar — du bestimmst, was angezeigt wird.

Voraussetzungen

  • Ein Nitrado-DayZ-Server (PC, PlayStation oder Xbox)
  • Nitrado-Account mit Zugang zum Developer-Portal
  • Korrekte Nitrado-Log-Einstellungen (siehe Schritt 2)

Schritt-für-Schritt-Einrichtung

Schritt 1: Long-Life Access Token (LLAT) erstellen

Öffne das Nitrado Developer-Portal unter https://server.nitrado.net/deu/developer/index und erstelle einen neuen LLAT. Wähle einen aussagekräftigen Namen (z. B. "TeraOne-Bot") und setze die Ablaufzeit auf maximal (2 Jahre empfohlen). Kopiere den Token sofort — er wird nur einmal angezeigt.

Schritt 2: Nitrado-Log-Einstellungen prüfen

Im Nitrado-Gameserver-Panel unter Einstellungen → Allgemein müssen folgende Optionen korrekt gesetzt sein:

  • "Log-Ausgabe reduzieren" → AUS (sehr wichtig!)
  • "Admin Log" → AN
  • "Server Log" → AN
  • "Gebäude-Log" → AN
  • "Platzierungs-Log" → AN
  • "Spielerliste-Log" → AN

Schritt 3: Token im TeraOne-Dashboard anlegen

Öffne Dashboard → DayZ-Killfeed → Tab "Tokens". Klicke "Token hinzufügen", gib einen Label ein und füge den LLAT ein. Speichern.

Schritt 4: Server hinzufügen

Öffne Tab "Server". Klicke "Server hinzufügen". Wähle deinen Token aus dem Dropdown — die Nitrado-Service-Liste lädt automatisch. Wähle den Gameserver aus, vergib einen Slug (URL-freundlicher Kurzname, 2–32 Zeichen, nur Kleinbuchstaben und Bindestriche) und einen Anzeigename.

Schritt 5: Kill-Channel und Events konfigurieren

Wähle einen Discord-Channel für den Killfeed. Aktiviere die gewünschten Event-Typen (Standard: alle außer Connect/Disconnect/Unknown).

Event-Typen

TypStandardWann ausgelöst
pvpANSpieler tötet Spieler
pveANTier oder Umgebung tötet Spieler
bleedANVerbluten
fallANFallschaden-Tod
suicideANEigenverschuldeter Tod
vehicleANFahrzeugunfall
explosionANExplosionsschaden
hypothermiaANKältetod
hungerANVerhungern
thirstANVerdursten
connectAUSSpieler verbindet sich
disconnectAUSSpieler trennt die Verbindung
unknownAUSNicht erkannter Ereignistyp

Separate Channels pro Event-Typ

Du kannst für jeden Event-Typ einen eigenen Discord-Channel konfigurieren. Nützlich, um z. B. Connects und Disconnects in einen separaten #connect-log zu schicken, der nicht den Kill-Channel verstopft. Ohne Override landen alle Events im konfigurierten Kill-Channel.

Adaptives Polling-Intervall

TeraOne fragt die Nitrado-API adaptiv ab — je nach letzter Aktivität auf dem Server:

Server-StatusPoll-Intervall
Heiß (letztes Event < 5 min)~30 Sekunden
Warm (< 15 min)~60 Sekunden
Kühl (< 60 min)~3 Minuten
Kalt (>= 60 min oder nie)~10 Minuten

Die Intervalle haben einen Jitter von ±5 Sekunden, damit mehrere Server auf demselben Token nicht gleichzeitig abfragen.

Wenn ein Server nach langer Inaktivität wieder aktiv wird, erkennt TeraOne das beim nächsten Kalt-Poll (max. 10 Minuten) und wechselt automatisch in den Hot-Mode.

Rate-Limits

Die Nitrado-API erlaubt ca. 30 Anfragen pro Minute pro Token. TeraOne ist bei 25 Anfragen/Minute gedeckelt, damit ein Puffer für andere Nitrado-Anwendungen bleibt.

Öffentliches Leaderboard

Wenn aktiviert, ist das Kill-Leaderboard unter folgender URL öffentlich erreichbar:

tera-one.de/:locale/dz/:guildId/:slug

Beispiel: tera-one.de/de/dz/123456789/mein-server

Den Slug vergibst du bei der Server-Einrichtung. Er ist nur aus Kleinbuchstaben, Ziffern und Bindestrichen zusammengesetzt (2–32 Zeichen).

Fehlersuche

Keine Events im Killfeed
Prüfe Schritt 2: Sind alle Log-Einstellungen auf Nitrado korrekt? Insbesondere: "Log-Ausgabe reduzieren" muss AUS sein. Ändere die Einstellung und starte den Server neu.
"Token abgelaufen" oder "Unauthorized"-Fehler
Erstelle einen neuen LLAT im Nitrado Developer-Portal. Trage ihn im Dashboard → Tokens → Token bearbeiten ein. Der alte Token ist danach ungültig.
Events kommen sehr spät (10+ Minuten Verzögerung)
Der Server befindet sich im Cold-Poll-Mode (keine Aktivität in letzter Stunde). Sobald neue Events ankommen, wechselt TeraOne automatisch in den Hot-Mode (~30 s Intervall).
Serverwechsel (neue Nitrado-Service-ID nach Umzug)
Lösche den alten Server im Dashboard und lege einen neuen an mit der neuen Service-ID. Der Slug kann gleich bleiben.
Killfeed postet, aber Channel ist falsch
Prüfe die Channel-Overrides: Wenn du pro Event-Typ Channels konfiguriert hast, hat der Override Vorrang vor dem Standard-Kill-Channel.

Häufige Fragen

Funktioniert das Modul auch für PS4/5 und Xbox DayZ-Server auf Nitrado?
Ja, Nitrado stellt für alle Plattformen dieselbe API bereit. Der Setup-Prozess ist identisch.
Kann ich mehrere Nitrado-Server mit einem Token verwalten?
Ja, ein LLAT hat Zugriff auf alle Gameserver deines Nitrado-Accounts. Im Dashboard kannst du mehrere Server unter demselben Token registrieren.
Gibt es ein Limit, wie viele DayZ-Server ich pro Discord-Server verwalten kann?
Maximal 10 Server pro Discord-Server.
Werden Kills auch erfasst, die passieren, während TeraOne kurz offline war?
Nein. TeraOne liest die aktuellen Logs beim Poll — bereits verarbeitete Logs werden nicht doppelt gemeldet, aber Events aus einer Offline-Phase werden übersprungen.
DayZ-Killfeed · TeraOne Docs · TeraOne