Zum Hauptinhalt springen

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 / Switch 2), verbunden mit dem Nitrado-Konto, dem er gehört
  • Ein Discord-Konto, um sich bei dzbot anzumelden

Du hast noch kein Nitrado-Konto oder keinen Server? Folge zuerst der Anleitung Nitrado-Server einrichten und kehre dann hierher zurück.

Warte, bis dein DayZ-Server bei Nitrado vollständig verfügbar ist, bevor du startest.

1) Starte auf dzbot.de​

Klicke auf dzbot.de auf Kostenlos starten – oder auf Server verbinden in der oberen Navigation, wenn du schon angemeldet bist. Ein kurzer geführter Start bringt dich durch vier Schritte:

  1. Wie willst du starten? Wähle dzbot Free (kostenlos, für immer: Discord-Killfeed, Eintrag in der Serverliste, Wiki, Karte und Rangliste, mit kurzer Einrichtung) oder dzbot Pro (14 Tage kostenlos, danach der Monatspreis: alle Funktionen, keine Kreditkarte und der volle Setup-Assistent). Die Vorschau neben der Auswahl zeigt, was jeweils drin ist. Kommst du über Server eintragen in der Serverliste, ist Free schon ausgewählt. Bis zur Serverauswahl kannst du die Wahl ändern, und ein Server mit Free kann den Pro-Test später jederzeit starten.
  2. Mit Discord anmelden. Discord zeigt die App als „DayZ Server" an: Das ist dzbot. Der Name ist bewusst neutral, weil deine Spieler ihn in Discord ebenfalls sehen. Die Seite erklärt vorher, wofür jede angefragte Berechtigung gebraucht wird.
  3. Nitrado verbinden. Melde dich mit dem Nitrado-Konto an, über das der Server gemietet ist. Das ist bei beiden Wegen nötig: Darüber wird geprüft, dass der Server dir gehört, und Spielerzahl, Karte und Filter in der Serverliste kommen direkt vom Server.
  4. Server wählen. dzbot listet die DayZ-Server dieses Nitrado-Kontos. Server, die schon mit dzbot verbunden sind, sind markiert und lassen sich direkt öffnen. Mit der Auswahl wird der Server bei dzbot angelegt. Hast du den Pro-Test gewählt, beginnt er in diesem Moment. Ein Server, den du einer bestehenden Organisation hinzufügst, übernimmt deren Tarif.

Danach landest du im Admin-Bereich deines neuen Servers, wo der Setup-Assistent übernimmt.

Nach der Anmeldung listet Meine Server in der Website-Navigation alle deine verbundenen Server.

2) Wenn das Verbinden scheitert​

  • "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.
  • "Nur der Inhaber kann den Server verbinden": Du hast dich mit einem Nitrado-Konto angemeldet, das nur Zugriff auf den Server bekommen hat. Melde dich mit dem Konto an, über das der Server gemietet wurde – ein freigegebener Zugriff kann Rechte vermissen lassen, die dzbot braucht, zum Beispiel FTP.
  • Token abgelaufen: Erneut verbinden über Server-Admin → Einstellungen. dzbot zeigt auch eine Warnung im Admin-Bereich an, wenn eine erneute Verbindung erforderlich ist.
  • Verbindung dauerhaft getrennt: Ein Server, der 30 Tage lang nicht mit Nitrado verbunden ist und kein aktives dzbot-Abo hat, wird gelöscht – mit seinen Spielern, Logs und Einstellungen. Seine Buchhaltung bleibt bei deiner Organisation. War es der einzige Server deiner Organisation, wird auch die Organisation gelöscht, außer sie hat Buchhaltungsdaten: Die bleiben erhalten, alles andere wird gelöscht. Verbinde ihn innerhalb dieser 30 Tage neu, um ihn zu behalten.

3) Der Setup-Assistent​

Später erreichst du den Admin-Bereich über Server Admin oben links auf deiner Serverseite; Shop öffnen in der Admin-Kopfzeile bringt dich zurück zur Spieleransicht.

Der Setup-Assistent führt dich Bildschirm für Bildschirm durch das Wichtigste: Servername, Subdomain, Zeitzone, dein Ingame-Name und – verpflichtend und nur einmal pro Organisation – Land & Währung: das Land deiner Organisation und die Buchungswährung, in der ihre Bücher, Supportzahlungen und Spieler-Abos laufen. Die Währung ist endgültig und lässt sich später nicht ändern. Danach folgen optional, wer deine Bannliste und Whitelist verwaltet (siehe Synchronisation der Spielerlisten), Discord, die Umstellung auf die cfggameplay.json (nötig vor Shop und jedem Mod, siehe cfggameplay.json), ein Start-Shop (oder eine Kopie des Shops eines anderen Servers deiner Organisation) und die DayZ++-Migration. Was du überspringst, taucht als Checkliste auf dem Dashboard auf. Die folgenden Schritte beschreiben dieselben Einstellungen im Detail.

Ein Server, der mit dzbot Free startet, bekommt einen kurzen Assistenten: Name, Subdomain, Zeitzone, dein Ingame-Name und der Eintrag selbst (Beschreibung, Tags, Sprachen und ein Discord-Einladungslink). dzbot ändert Dateien und Spielerlisten des Servers erst, wenn du das einschaltest. Am Ende bietet der Assistent einmal den Pro-Test an; Nein danke, erst mal Free lässt den Server bei Free. Startest du den Test später, kommen die Pro-Einrichtungsschritte zurück in den Setup-Assistenten und in die Checkliste auf dem Dashboard.

Testzeitraum und Zahlung​

dzbot hat zwei Tarife: dzbot Free, das nichts kostet, und dzbot Pro, ein Abo pro Server mit allen Funktionen – siehe dzbot Free und Pro. Jede Organisation kann dzbot Pro 14 Tage testen, ohne Zahlungsdaten anzugeben. Der Test gehört zur Organisation: Solange er läuft, sind alle Server der Organisation auf Pro, und sie wechseln gemeinsam. Jeder UTC-Kalendertag, an dem der Test läuft, auch nur kurz, verbraucht einen der 14 Tage. Du kannst ihn beliebig oft einschalten und pausieren, bis die Tage aufgebraucht sind; pausierte Tage bleiben dir und verfallen nicht. Wie der Test funktioniert: Der Pro-Test.

  • Test starten kannst du mit der Wahl dzbot Pro am Anfang des geführten Starts, unter Organisation → Zahlung (Pro-Test starten, mit den verbleibenden Tagen), auf jeder Pro-Seite, die ein Server mit Free öffnet, oder am Ende des kurzen Setup-Assistenten. Starten darf, wer das Abrechnungsrecht Abrechnung ansehen (admin.billing.access oder org.billing.access) oder das Einrichtungsrecht (admin.setup.access) hat. Startet ihn jemand ohne Abrechnungsrecht, bekommen die Abrechnungs-Admins der Organisation eine Discord-Nachricht.
  • Test pausieren kannst du unter Organisation → Zahlung mit Pro-Test pausieren; dafür brauchst du das Abrechnungsrecht. Eine Pause wirkt wie das Ende des Tests: Alle Server der Organisation wechseln sofort zu dzbot Free (siehe unten), gelöscht wird nichts. Startest du den Test dort wieder, ist alles zurück; die Mod-Dateien von dzbot kommen mit dem nächsten Neustart wieder. Eine Pause verschickt keine Nachricht über das Testende.
  • Wer für einen Server zahlt, macht ihn sofort zu Pro: Sein Abo startet und wird sofort abgerechnet. Ein bezahlter Server bleibt auf Pro, wenn der Test pausiert oder endet; für die anderen Server der Organisation gilt der Test weiter.
  • Solange der Test läuft, zeigt das Dashboard, wie lange er noch dauert, und sobald höchstens 11 Tage übrig sind, zeigt ein Banner auf jeder Admin-Seite, wann er endet. In seiner letzten Woche bekommen die Abrechnungs-Admins der Organisation zusätzlich ein paar Erinnerungen per Discord-Nachricht. Ein pausierter Test verschickt keine.
  • Auf Pro upgradest du unter Organisation → Zahlung. Checkout, das Stripe-Kundenportal und die Rechnungen nennen den Server, für den ein Abo läuft, damit eine Organisation mit mehreren Servern sie auseinanderhalten kann.
  • Das Pro-Abo kostet Euro. Nutzt deine Organisation eine andere Buchungswährung, zeigt Stripe den Preis beim Bezahlen in deiner Landeswährung an, und deine Buchhaltung erfasst, was deine Karte tatsächlich belastet hat.
  • Nach der ersten Zahlung bekommen die Abrechnungs-Admins eine Dankesnachricht mit dem Datum der nächsten Zahlung.
  • Nachrichten von dzbot zur Zahlung beginnen mit dzbot · Abrechnung für und dem Servernamen. Der Bot trägt den Namen deines Servers und teilt sich den Chat mit den Nachrichten deines Gameservers; an dieser Zeile erkennst du, dass sie von dzbot kommen.
  • In der letzten Woche nennen die Erinnerungen die Pro-Funktionen, die dein Server tatsächlich nutzt – denn die sind es, die ruhen.
  • Endet der Test ohne Zahlung, wechselt jeder Server der Organisation zu dzbot Free: Eintrag in der Serverliste, Wiki, Karte, Rangliste, Killfeed, Regeln und eigene Seiten laufen weiter; Discord-Bot, Shop, Tickets, Automatiken, Neustarts und die anderen Pro-Funktionen ruhen, Spieler-Abos verlängern sich nicht mehr, und die Mod-Dateien, die dzbot auf deinem Gameserver installiert hat, werden wieder entfernt (wirksam mit dem nächsten Neustart). Gelöscht wird nichts, und Logs werden weiter gesammelt. Steigst du auf Pro um, läuft alles wieder, und deine Mods kommen mit dem nächsten Neustart zurück. Die Abrechnungs-Admins bekommen eine Discord-Nachricht, wenn der Server zu Free wechselt. Details: Wenn ein Server zu Free wechselt.
  • Dasselbe gilt, wenn ein bezahltes Pro-Abo endet.

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 für Zeitangaben verwendet. Die Uhrzeiten in den Logs deines Gameservers erkennt dzbot automatisch.

7) Synchronisation der Spielerlisten​

Synchronisation der Spielerlisten (in Einstellungen → Whitelist & Konten) ist bei einem neu verbundenen Server aus – dzbot ändert also nichts, was ein anderer Bot oder das Nitrado-Panel verwaltet. Der Setup-Assistent fragt, wer diese Listen verwalten soll.

Schaltest du sie ein, wird dzbot zur maßgeblichen Quelle für Whitelist-, Einschränkungs-(Bann-) und Prioritätslisten und hält Nitrado auf dem neuesten Stand. Vor dem ersten Sync übernimmt dzbot alle Bann-, Whitelist- und Prioritätseinträge, die in diesem Moment in Nitrado stehen – es gehen keine Einträge verloren. Nitrado-Banns werden in dzbot zu dauerhaften Banns. Ab dann überschreibt dzbot diese Listen bei jedem Sync – Änderungen, die direkt in Nitrado oder über andere Tools vorgenommen werden, werden überschrieben. Das Schreiben der Listen gehört zu dzbot Pro.

Solange die Einstellung aus ist, erreichen Banns, Whitelist- und Prioritätseinträge aus dzbot deinen Server nie. dzbot weist dich überall darauf hin, wo du bannst, whitelistest oder Priorität vergibst, und sobald dzbot solche Einträge hat, zeigt der Admin-Bereich einen Hinweis, bis du sie einschaltest.

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 Whitelist-Verhalten siehe Whitelisting.

9) Discord-Integration verbinden​

Schritt 1: Server verbinden und Bot installieren​

Am einfachsten geht es im Schritt Discord des Setup-Assistenten:

  • Klick auf Bot zu Discord hinzufügen. Discord öffnet sich im selben Tab; wähl dort deinen Discord-Server aus und bestätige.
  • Danach schickt dich Discord direkt zurück in den Assistenten. Dein Discord-Server ist schon ausgewählt und gespeichert, und der Schritt wird grün, sobald dzbot den Bot sieht. Brichst du bei Discord ab, landest du wieder im selben Schritt.
  • Dir muss der Discord-Server gehören, oder du brauchst dort die Berechtigung Administrator. Die Liste zeigt nur Discord-Server, auf die das zutrifft und auf denen der Bot schon ist. Ein Discord-Server, der bereits mit einem Server einer anderen Organisation verbunden ist, wird nicht angeboten.
  • Discord fragt, ob der Bot Administrator bekommen soll. Damit sieht er auch private Kanäle (Online-Liste, Tickets, Spenden- oder Log-Kanäle, die nur bestimmte Rollen sehen). Du kannst das Häkchen abwählen; der Bot sieht dann nur die Kanäle, in denen du seiner Rolle (sie heißt wie der Bot) selbst Kanal anzeigen und Nachrichten senden gibst, und jeder private Kanal, den dzbot nutzen soll, braucht das von Hand.

Du kannst es auch von Hand unter Einstellungen → Discord erledigen: Discord-Server auswählen und Speichern. Ist der Bot dort noch nicht drauf, siehst du eine Admin-Warnung mit einem Installationslink, der dich auf dieselbe Weise zurückbringt.

Sobald der Bot beitritt, schreibt er einmalig eine kurze Nachricht in den Systemkanal des Discord-Servers (den Kanal, in dem Discord Beitrittsnachrichten zeigt, falls es einen gibt): dass dzbot mit deinem Server verbunden ist, mit einem Link, um die Einrichtung abzuschließen. Wird der Bot später erneut hinzugefügt, schreibt er das nicht noch einmal.

Schritt 2: Optionale Discord-Kanäle konfigurieren​

Ist der Bot verbunden, bietet der Assistent Standard-Kanäle anlegen an. Das ist optional: Es legt eine Kategorie „dzbot“ mit einem Killfeed-Kanal und einem Online-Spieler-Kanal an (dort schreibt nur der Bot) sowie eine Kategorie „Tickets“, die zur Kategorie des ersten Support-Levels wird. Die Kanäle werden in den passenden Einstellungen ausgewählt. Was schon einen Kanal oder eine Kategorie hat, bleibt, wie es ist – du kannst es also erneut ausführen, um Lücken zu füllen.

Oder wähl eigene Kanäle: 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-Ranglisten-Kanal (Ranglisten, alle 15 Minuten aufgefrischt)
  • 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​

Bevor du das Dashboard öffnest, lies Was sich nach dem Setup ändert — dort sind die neuen Regeln für Neustarts, Dateiänderungen und Spielerlisten beschrieben, die deinen Server vom ersten Tag an betreffen.

Verwandte Dokumentation​