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
| Typ | Standard | Wann ausgelöst |
|---|---|---|
pvp | AN | Spieler tötet Spieler |
pve | AN | Tier oder Umgebung tötet Spieler |
bleed | AN | Verbluten |
fall | AN | Fallschaden-Tod |
suicide | AN | Eigenverschuldeter Tod |
vehicle | AN | Fahrzeugunfall |
explosion | AN | Explosionsschaden |
hypothermia | AN | Kältetod |
hunger | AN | Verhungern |
thirst | AN | Verdursten |
connect | AUS | Spieler verbindet sich |
disconnect | AUS | Spieler trennt die Verbindung |
unknown | AUS | Nicht 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-Status | Poll-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.
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/:slugBeispiel: tera-one.de/de/dz/123456789/mein-server
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.