Erste Schritte
Dieser Leitfaden kombiniert die Installation und die wesentlichen ersten Schritte, damit dzbot nach der Verbindung mit deinem Server zuverlässig funktioniert.
Anforderungen
- Ein DayZ-Server gehostet auf Nitrado (PC / PS / XBOX)
- Ein Discord-Konto, um sich bei dzbot anzumelden
Warte, bis dein DayZ-Server bei Nitrado vollständig verfügbar ist, bevor du startest.
1) Melde dich bei dzbot an
Öffne dzbot.de und verwende Anmelden in der oberen Navigation.
Nach dem Login:
- Meine Server zeigt alle verbundenen Server direkt in der Website-Navigation. Auf Mobilgeräten verwende Meine Server in der Hauptnavigation, um ein Server-Modal mit der Aktion Server verbinden zu öffnen.
2) Verbinde deinen Server
Verwende Server verbinden in der oberen Navigation (oder Neuen Server verbinden auf der Startseite), um den Nitrado OAuth-Flow zu starten.
- Wenn dein Konto einen DayZ-Server hat, verbindet dzbot ihn direkt.
- Wenn dein Konto mehrere DayZ-Server hat, kannst du auswählen, welchen du verbinden möchtest.
Nach der Verbindung wirst du zu deiner Server-Startseite weitergeleitet.
Verbindungshinweise
- "Kein Code bereitgestellt": Der OAuth-Rückruf wurde unterbrochen. Starte den Verbindungsprozess erneut aus der Website-Navigation.
- "Keine DayZ-Server gefunden": Überprüfe, ob dein Nitrado-Konto mindestens einen aktiven DayZ-Dienst hat.
- Token abgelaufen: Erneut verbinden über Server-Admin → Einstellungen. dzbot zeigt auch eine Warnung im Admin-Bereich an, wenn eine erneute Verbindung erforderlich ist.
3) Öffne das Admin-Panel
Verwende Server-Admin oben links auf deiner Serverseite, um den Admin-Bereich zu betreten.
Tipp: Du kannst jederzeit mit Shop öffnen in der Admin-Kopfzeile zur Spieleransicht zurückkehren.
4) Stelle den Admin-Spielernamen ein
Öffne Server-Admin → Spieler und finde den Spieler admin. Ändere den Benutzernamen in deinen In-Game-Benutzernamen, damit dzbot kein zweites Spielerprofil erstellt, wenn Logs ankommen.
Falls bereits ein Spielerprofil mit deinem Benutzernamen existiert, öffne ein Ticket in Discord, damit ein Moderator die Konten zusammenführen kann.
5) Führe die DayZ++-Benutzermigration aus (optional)
Wenn dieser Server aktuell DayZ++ / killfeed.xyz nutzt und du deine bereits verknüpften Benutzer behalten möchtest, verwende den Schritt Benutzermigration im Setup, bevor du den restlichen Erstaufbau abschließt.
Nutze die separate Anleitung Benutzermigration, um API-Zugriff anzufordern, den richtigen API-Key zu erstellen und den Import aus Server-Admin → Setup zu starten.
6) Aktualisiere die wichtigsten Servereinstellungen
Navigationspfad:
Server-Admin→Einstellungen
Empfohlene Werte zur Überprüfung:
- Servername: Kurzer Community-Name, der in der Benutzeroberfläche verwendet wird.
- Subdomain: Deine spielerseitige URL (
<subdomain>.dzbot.de). - Zeitzone: Wird vom Scheduler und zeitbasierten Logs verwendet.
7) Synchronisierung der Spielerlisten aktivieren
In Einstellungen → Integrationen:
- Aktiviere Spielerlisten synchronisieren.
Dadurch wird dzbot zur maßgeblichen Quelle für Whitelist-, Einschränkungs-(Bann-) und Prioritätslisten und hält Nitrado auf dem neuesten Stand. Alle Bann-, Whitelist- und Prioritätseinträge, die beim Verbinden des Servers in Nitrado vorhanden waren, wurden bereits automatisch importiert – es gehen keine Einträge verloren. Sobald die Synchronisierung aktiv ist, überschreibt dzbot diese Listen bei jedem Sync – Änderungen, die direkt in Nitrado oder über andere Tools vorgenommen werden, werden überschrieben.
8) Whitelist-Automatisierung aktivieren (optional, empfohlen)
In Einstellungen → Spieler & Zugriff:
- Aktiviere Whitelist aktiviert, wenn du eine kontrollierte Community betreibst.
- Aktiviere Automatische Whitelist für verknüpfte Spieler, um manuelle Genehmigungen zu reduzieren.
Für das vollständige Verhalten und die Smart-Whitelist-Logik siehe Whitelisting.
9) Discord-Integration verbinden
Schritt 1: Server verbinden und Bot installieren
In Einstellungen → Discord:
- Discord-Server aus den Servern auswählen, die über dein verbundenes Discord-Konto verfügbar sind
- Speichern deiner Einstellungen
Nach dem Speichern überprüft dzbot die Discord-Verbindung. Wenn der Bot nicht installiert ist, siehst du eine Admin-Warnung mit einem Installationslink. Folge diesem Link, um den Bot zu deinem Discord-Server hinzuzufügen.
Schritt 2: Optionale Discord-Kanäle konfigurieren
Nachdem der Bot installiert ist, kehre zu Einstellungen → Discord zurück und wähle die optionalen Discord-Ziele über die Dropdowns aus:
- Discord-Support-Channel (Support-/Aufgabenbenachrichtigungen)
- Discord-Online-Spieler-Channel (Live-Listenkanal)
- Discord-Basisalarm-Kategorie (automatisch verwaltete Kanäle)
- Discord-Killfeed-Channel (PvP-Kill-Nachrichten)
- Discord-Damagefeed-Channel (PvP-Schadensnachrichten)
- Synchronisierung von Discord-Namen (optional)
Wenn du den Discord-Server gerade geändert hast, speichere zuerst und öffne anschließend den Discord-Reiter in den Einstellungen erneut, nachdem der Bot dort hinzugefügt wurde, damit die Channel- und Kategorien-Dropdowns für diesen Server aktualisiert werden.
Für das vollständige Integrationsmodell und die Rollenerfordernisse siehe Discord-Integration Konzept.
10) Log-Import-Gesundheit überprüfen
Viele Funktionen hängen von importierten Server-Logs ab (Kartenaktivitäten, Killfeed, Spieler-Routen, Log-Explorer, Aktionen).
Prüfe Server-Admin → Log Explorer und stelle sicher, dass du aktuelle Einträge siehst. Falls keine Ergebnisse angezeigt werden, warte einige Minuten und kontrolliere erneut. Zu erwartende Verzögerungen findest du unter Logs-Import-Konzept.
Nächste Schritte
Fahre fort mit Zweite Schritte für eine tiefere Einrichtung und optionale Verbesserungen.