Kundenhandbuch: Webinterface, Discord-Bot und Ingame-Servermod

Stand: 2026-06-29

Dieses Handbuch erklärt die Bedienung des Kunden-Webinterfaces und den normalen Ablauf mit Discord-Bot und DayZ-Servermod. Es richtet sich an Serverbetreiber, die ihre eigene VoteBot-Instanz verwalten.

Das Dokument ist als Arbeitsanleitung gedacht. Es beschreibt nicht nur, welche Felder es gibt, sondern auch, wann du sie nutzt, welche Auswirkungen Änderungen haben und welche Punkte du bei Problemen zuerst prüfen solltest. Je nach freigeschalteter Version können einzelne Menüpunkte, Buttons oder Felder leicht anders heißen oder nicht sichtbar sein.

Inhaltsverzeichnis

  1. Grundidee
  2. Anmeldung und Instanzauswahl
  3. Aufbau des Webinterfaces
  4. Übersicht
  5. Bot-Einstellungen
  6. Registration-Panel in Discord
  7. Voting und Vote-Erfassung
  8. Boards, Rankings und Archive
  9. Live-Rewards
  10. Wochen-Rewards
  11. Monats-Rewards
  12. Rewards und offene Lieferungen
  13. Shop
  14. Token
  15. Fahrzeug-Presets
  16. Ingame-Servermod und !claim
  17. Typische Arbeitsabläufe
  18. Typische Fehler und schnelle Prüfung
  19. Empfehlungen für den Betrieb
  20. Datenschutz und Verantwortung

1. Grundidee

Der RDM VoteBot verbindet drei Bereiche:

Der typische Ablauf sieht so aus:

  1. Der Betreiber richtet Bot, Discord-Channels, Votinganbieter, Rewards und Shop ein.
  2. Spieler registrieren sich im Discord über das Registration-Panel mit ihrer SteamID.
  3. Spieler voten auf den eingerichteten Votingseiten.
  4. Der Bot erkennt gültige Votes und ordnet sie registrierten Spielern zu.
  5. Je nach Regel erhalten Spieler Token, Items oder Fahrzeug-Rewards.
  6. Token können im Discord-Shop ausgegeben werden.
  7. Offene Item- oder Fahrzeug-Rewards werden ingame mit !claim abgeholt.

Wichtig ist die Trennung zwischen Verwaltung, Discord und Gameserver:

Wenn etwas nicht funktioniert, lässt sich der Fehler meistens einem dieser drei Bereiche zuordnen. Prüfe deshalb zuerst, ob das Problem im Webinterface sichtbar ist, ob Discord die richtigen Nachrichten anzeigt oder ob erst der Gameserver beim Claim scheitert.

2. Anmeldung und Instanzauswahl

  1. Öffne das Kunden-Webinterface.
  2. Melde dich mit Discord an.
  3. Falls deinem Account mehrere eigene oder freigegebene Instanzen zugeordnet sind, wähle die passende Instanz aus.
  4. Es werden nur Instanzen angezeigt, für die dein Discord-Account oder deine freigegebene Discord-ID berechtigt ist.

Der Zugriff wird serverseitig über Discord-Rechte und Portal-Freigaben geprüft. Normalerweise erhalten Discord-Server-Owner, Administratoren, Nutzer mit Server-Verwaltungsrechten oder zusätzlich freigegebene Portal-User Zugriff auf ihre zugehörige Instanz.

Die Instanzauswahl ist keine freie Suche nach fremden Servern. Sie ist eine gefilterte Liste. Das Portal zeigt dir nur Instanzen, die anhand deiner Discord-Anmeldung zugeordnet werden können. Wenn mehrere Einträge sichtbar sind, bedeutet das normalerweise, dass du mehrere eigene Server betreust oder für mehrere Instanzen explizit freigegeben wurdest.

Vor Änderungen solltest du in der Kopfzeile oder Übersicht kontrollieren, ob der richtige Servername, die richtige Discord-Guild und die erwarteten Channels angezeigt werden. Das verhindert, dass du versehentlich die falsche eigene Instanz bearbeitest, wenn du mehrere Communities verwaltest.

Wenn dir eine Instanz fehlt, liegt es meistens an einem dieser Punkte:

Wenn du nach dem Login gar keine Instanz siehst, melde dich ab und erneut mit dem Discord-Account an, der auf dem betreffenden Server die passenden Rechte hat. Falls das nicht reicht, muss ein berechtigter Betreiber oder der Support deine Discord-ID als Portal-User prüfen.

3. Aufbau des Webinterfaces

Das Webinterface ist in Hauptbereiche aufgeteilt. Die genaue Reihenfolge kann je nach Version leicht abweichen, die Funktionen bleiben aber gleich.

Typische Bereiche:

Änderungen werden erst gespeichert, wenn du den jeweiligen Speichern-Button nutzt. Nach dem Speichern zeigt das Webinterface normalerweise eine Erfolgsmeldung oder eine Fehlermeldung an.

Viele Bereiche arbeiten mit Tabellen oder Listen. Einträge können aktiv, inaktiv, sortiert oder archiviert sein. Inaktive Einträge bleiben häufig für die Nachvollziehbarkeit erhalten, werden aber nicht mehr im Discord angezeigt oder für neue Rewards verwendet.

Arbeite bei größeren Änderungen am besten in dieser Reihenfolge:

  1. Änderung im passenden Bereich eintragen.
  2. Speichern.
  3. Erfolgsmeldung prüfen.
  4. Discord-Panel oder Übersicht kontrollieren.
  5. Bei Reward- oder Shop-Änderungen einen kleinen Test mit einem Testspieler durchführen.

Wenn du mehrere Einstellungen gleichzeitig änderst und danach ein Problem auftritt, ist die Ursache schwerer zu finden. Für produktive Server ist es besser, wichtige Änderungen nacheinander vorzunehmen.

4. Übersicht

Die Übersicht ist der erste Kontrollpunkt nach dem Login.

Sie zeigt dir typischerweise:

Wenn dort eine Servermod-Warnung angezeigt wird, solltest du prüfen, ob eine neue Servermod-ZIP verfügbar ist. Eine veraltete Servermod kann dazu führen, dass neue Reward-Arten oder Fahrzeug-Presets nicht korrekt ausgeliefert werden.

Die Übersicht eignet sich auch als täglicher Schnellcheck. Vor allem nach einem Neustart, nach Änderungen an Votinganbietern oder nach einem Servermod-Update solltest du prüfen, ob der Bot online ist, ob aktive Provider angezeigt werden und ob Warnungen vorhanden sind.

Typische Warnungen bedeuten:

Eine Warnung in der Übersicht löscht keine Daten. Sie ist ein Hinweis, dass ein Teil der Kette geprüft werden sollte, bevor Spieler weitere Votes, Käufe oder Claims melden.

5. Bot-Einstellungen

Die Bot-Einstellungen steuern, wie der Discord-Bot arbeitet und welche externen Dienste aktiv sind.

Dieser Bereich ist die zentrale technische Konfiguration deiner Instanz. Änderungen können direkte Auswirkungen auf Discord-Nachrichten, Vote-Erkennung, Tokenvergabe, Shop-Funktionen und Servermod-Auslieferung haben. Lies Fehlermeldungen nach dem Speichern genau, weil hier häufig fehlende IDs, falsch formatierte URLs oder ungültige API-Daten auffallen.

Wenn ein Feld leer bleibt, bedeutet das je nach Funktion entweder „deaktiviert“ oder „nicht vollständig eingerichtet“. Besonders bei Votinganbietern gilt: Ein Anbieter sollte erst dann als aktiv betrachtet werden, wenn URL und API-Zugangsdaten vollständig gespeichert sind.

Allgemein

In Allgemein werden Grundwerte deiner Instanz verwaltet.

Typische Felder:

Wichtig:

Der Shopname sollte kurz und eindeutig sein, weil er in Discord-Embeds und Shop-Anzeigen auftauchen kann. Vermeide sehr lange Namen, Sonderzeichenfolgen oder Werbetexte, damit Panels auf Mobilgeräten lesbar bleiben.

Wenn du den Shop temporär deaktivierst, prüfe danach:

Das Deaktivieren des Shops ist vor allem sinnvoll, wenn Preise überarbeitet werden, ein Event endet oder ein technisches Problem mit Artikeln geklärt werden muss.

Discord

In Discord werden die Channels gesetzt, in denen der Bot feste Nachrichten erstellt oder laufende Meldungen schreibt.

Typische Channel:

So bekommst du eine Channel-ID:

  1. In Discord den Entwicklermodus aktivieren.
  2. Rechtsklick auf den gewünschten Channel.
  3. ID kopieren auswählen.
  4. Die ID im Webinterface eintragen oder über die Channel-Auswahl auswählen.

Prüfe bei Problemen:

Ändere Channel-IDs nur, wenn du sicher bist, dass der neue Channel zum richtigen Discord-Server gehört. IDs aus einem anderen Server wirken technisch gültig, können aber vom Bot nicht genutzt werden, wenn er dort keinen Zugriff hat oder die Instanz mit einer anderen Guild verbunden ist.

Empfohlene Discord-Rechte für Bot-Channels:

Wenn ein Panel nicht aktualisiert wird, prüfe zuerst die Channel-ID und die Rechte. Ein Neustart des Bots sollte erst der zweite Schritt sein, wenn die Konfiguration korrekt aussieht.

Voting

In Voting werden die Votinganbieter eingerichtet. Ein Anbieter gilt nur als aktiv, wenn die benötigten Werte vollständig gesetzt sind. Fehlt URL oder API-Key/Token, wird der Anbieter ignoriert.

Unterstützte Anbieter:

Pro Anbieter gibt es zusätzlich einen Tokenwert pro Vote.

Standardwerte:

Der Tokenwert beeinflusst nur Token-Gutschriften. Rankings und Boards zeigen weiterhin echte Vote-Anzahlen.

Beispiel:

Provider-Status:

Die Provider-Abfrage arbeitet zeitversetzt. Ein Vote erscheint nicht zwingend sofort im Webinterface, sondern erst nach der nächsten erfolgreichen Abfrage des jeweiligen Anbieters. Außerdem schützen Sperrzeiten davor, dass derselbe Spieler zu schnell mehrfach für denselben Anbieter gewertet wird.

Unterscheide immer zwischen diesen drei Fragen:

Erst wenn alle drei Punkte passen, entstehen Token, Boards und Live-Rewards.

Wenn ein Anbieter nicht aktiv wird:

Beispiel: einfacher Start mit nur Top-Games

Ergebnis: Der Bot nutzt nur Top-Games. Im Registration-Panel erscheint nur der Top-Games-Link. Votes von anderen Plattformen werden nicht erwartet und nicht angezeigt.

Beispiel: drei Votingseiten mit unterschiedlicher Belohnung

Ergebnis: Ein Top-Games-Vote gibt 1 Token, ein DayZ-Servers.org-Vote gibt 10 Token und ein TrackyServer-Vote gibt 10 Token. Im Ranking wird trotzdem nur die echte Vote-Anzahl gezählt, nicht der Tokenwert.

Beispiel: Anbieter bewusst deaktivieren

Ergebnis: Der Anbieter gilt als inaktiv. Er verschwindet aus dem Registration-Panel, wird bei der Presence-Auswahl ignoriert und sollte im Board nicht als aktiver Anbieter auftauchen.

Wenn du einen Anbieter wechselst oder neu einrichtest, dokumentiere die verwendete Vote-URL und den Zeitpunkt der Umstellung. Das hilft später, wenn Spieler nach alten Votes fragen oder wenn unklar ist, ab wann eine Plattform wirklich aktiv war.

Anzeige

In Anzeige stellst du ein, was der Bot als Status bzw. im Bot-Listing anzeigt.

Mögliche Varianten:

Wichtig:

Die Anzeige ist nur eine Darstellung nach außen. Sie entscheidet nicht darüber, ob Votes gezählt werden. Maßgeblich für die Vote-Erfassung sind die aktiv eingerichteten Anbieter im Bereich Voting.

Wenn die Anzeige nicht zum erwarteten Anbieter passt, prüfe:

Freigegebene Portal-User

Falls vorhanden, kannst du hier zusätzliche Discord-User für das Kundenportal freigeben.

Das ist sinnvoll, wenn:

Gib nur Personen frei, denen du die Verwaltung deiner Instanz anvertrauen willst. Diese Nutzer können je nach Freigabe wichtige Einstellungen ändern.

Freigegebene Portal-User sind kein Spieler-Feature. Sie sind für Personen gedacht, die administrativ helfen sollen. Ein freigegebener Nutzer kann je nach Portalumfang Bot-Einstellungen, Rewards, Shop-Artikel oder Servermod-Downloads sehen und ändern.

Empfehlung:

Discord-Namen können sich ändern. Die Discord-ID bleibt stabiler und ist deshalb die richtige Grundlage für Portal-Freigaben.

Servermod-ZIP

In diesem Bereich kannst du die Servermod-ZIP herunterladen.

Die ZIP enthält typischerweise:

Wichtig:

Die Servermod-ZIP ist instanzbezogen. Nutze sie nur für den Gameserver, der zu dieser VoteBot-Instanz gehört. Wenn du mehrere Server betreibst, darfst du die ZIPs nicht untereinander vertauschen, weil API-Zugangsdaten, Routing und Instanzzuordnung unterschiedlich sein können.

Nach dem Download solltest du prüfen:

Packe keine PBO aus diesem Handbuch heraus neu. Verwende die bereitgestellte Servermod-ZIP so, wie sie für die Instanz erzeugt wurde.

6. Registration-Panel in Discord

Das Registration-Panel ist die feste Discord-Nachricht, über die Spieler sich registrieren.

Es enthält:

Der Bot zeigt nur aktive Votinganbieter an. Wenn du im Webinterface einen Anbieter hinzufügst oder entfernst, wird das Registration-Panel automatisch aktualisiert.

Das Panel ist für Spieler der wichtigste Einstiegspunkt. Es sollte in einem Channel stehen, den neue Spieler gut finden können, aber nicht in einem stark genutzten Chat untergeht. Empfehlenswert ist ein eigener Channel wie vote, voting, registrierung oder rewards.

Vor der Veröffentlichung solltest du prüfen:

Provider-Hinweise:

Wenn Spieler falsch voten:

Eine Registrierung ersetzt nicht den Vote auf der externen Plattform. Sie sorgt nur dafür, dass der Bot später weiß, welche SteamID oder Discord-ID zu welchem Spieler gehört. Wenn Spieler mit einer falschen SteamID registriert sind, können korrekte Votes trotzdem beim falschen Konto landen oder gar nicht zugeordnet werden.

Bei Registrierungsproblemen prüfe zuerst:

  1. Hat der Spieler wirklich den richtigen Discord-Account genutzt?
  2. Ist die gespeicherte SteamID64 vollständig und korrekt?
  3. Wurde die Registrierung nach einer Namensänderung weiterhin derselben SteamID zugeordnet?
  4. Hat der Spieler beim Votinganbieter exakt die geforderte Angabe verwendet?

7. Voting und Vote-Erfassung

Der Bot fragt aktive Votinganbieter regelmäßig ab und speichert neue Votes.

Aktuelle botseitige Sperrzeiten nach einem gezählten Vote:

Diese Sperrzeiten minimieren Doppelzählungen. Die externen Votingplattformen können zusätzlich eigene Wartezeiten haben.

Die Sperrzeit beginnt erst, wenn der Bot einen Vote erfolgreich gezählt hat. Sie ist nicht automatisch identisch mit der Sperrzeit der externen Votingplattform. Dadurch kann es vorkommen, dass eine Plattform einen Vote schon wieder zulässt, der Bot aber noch keinen neuen gültigen Vote für denselben Anbieter wertet.

Votes werden normalerweise mit einem Fingerprint gespeichert. Dadurch soll verhindert werden, dass derselbe Vote mehrfach belohnt wird, wenn ein Anbieter dieselben Daten erneut liefert.

Für die Fehlersuche ist wichtig:

Top-Games

Top-Games liefert Votes über die API. Der Bot ordnet Votes über die SteamID zu, die der Spieler beim Vote als Benutzername einträgt.

Wichtig:

Top-Games kann zusätzlich für Rank- oder Statusanzeigen genutzt werden, wenn die Serverseite erreichbar ist und die konfigurierte URL zur richtigen Serverseite führt. Wenn der Rank nicht angezeigt wird, aber Votes gezählt werden, liegt das Problem oft nur bei der Anzeige der Serverseite und nicht bei der Vote-Erfassung.

Bei Top-Games-Problemen prüfe:

DayZ-Servers.org

DayZ-Servers.org wird über API-Key und Votingadresse angebunden.

Wichtig:

DayZ-Servers.org wird typischerweise mit längerer Sperrzeit betrieben, weil die Plattform auf tägliche Votes ausgelegt ist. Prüfe bei Spieleranfragen deshalb immer, ob der letzte gezählte Vote weniger als 23 Stunden 30 Minuten zurückliegt.

Wenn keine neuen Votes erscheinen, prüfe:

TrackyServer

TrackyServer arbeitet anders als die anderen Anbieter.

Der Bot prüft registrierte Spieler:

  1. zuerst per SteamID,
  2. danach per DiscordUID, falls nötig.

Statusverhalten:

Wichtig:

TrackyServer hat zwei typische Fehlerbilder:

In beiden Fällen kann die Plattform den Vote akzeptieren, während der Bot ihn nicht eindeutig dem Spieler zuordnet.

8. Boards, Rankings und Archive

Der Bot erstellt Discord-Boards für laufende und abgeschlossene Zeiträume.

Boards sind eine Auswertung gespeicherter Bot-Votes, keine Live-Ansicht der externen Webseiten. Wenn eine externe Plattform andere Zahlen zeigt, liegt das meistens an unterschiedlichen Zeiträumen, Anbieter-Sperren, nicht zugeordneten Votes oder daran, dass die Plattform Gesamtvotes zählt, während der Bot Wochen- oder Monatszeiträume auswertet.

Typische Anzeigen:

Aktuelles Wochenboard

Das aktuelle Wochenboard zeigt den laufenden Stand der aktuellen Woche.

Es kann anzeigen:

Nur aktive Votinganbieter werden im Anbieterblock angezeigt.

Das aktuelle Wochenboard eignet sich für Spielertransparenz während der Woche. Spieler können sehen, ob ihre Votes ankommen und wie sie im Vergleich zu anderen stehen. Betreiber sollten das Board nach Änderungen an Votinganbietern prüfen, weil fehlende Anbieter oder falsche Channel-Rechte hier schnell sichtbar werden.

Wochenarchiv

Das Wochenarchiv zeigt abgeschlossene Wochen.

Wichtig:

Das Wochenarchiv ist besonders wichtig für Supportfälle. Wenn ein Spieler später fragt, warum er eine Wochenbelohnung bekommen oder nicht bekommen hat, lässt sich der damalige Stand nachvollziehen. Ändere alte Wochenwerte nur, wenn du genau weißt, welche Folge das für Rewards und Tokenbuchungen hat.

Monatsarchiv

Monatslisten können ebenfalls gecacht werden. Das ist sinnvoll, weil abgeschlossene Monate sonst beim Start aus allen Votes neu berechnet werden müssten.

Wenn Monatsübersichten nicht aktiv sichtbar sind, kann das Caching trotzdem sinnvoll sein. Dadurch stehen Daten später schneller bereit, falls Monatsansichten oder Monatsrewards genutzt werden.

Monatsdaten sind meist für größere Belohnungen relevant. Prüfe bei Monats-Rewards immer, ob der angezeigte Monat wirklich abgeschlossen ist. Ein laufender Monat sollte nicht als endgültige Grundlage für große Belohnungen verwendet werden.

9. Live-Rewards

Live-Rewards werden sofort vergeben, wenn ein neuer gültiger Vote erkannt wurde.

„Sofort“ bedeutet hier: direkt nach der erfolgreichen Bot-Erfassung. Der Spieler muss dafür nicht online auf dem Gameserver sein. Item- und Fahrzeugbelohnungen werden als offene Rewards gespeichert und können später ingame abgeholt werden.

Typische Felder:

Beispiele:

Beispiel: kleine direkte Vote-Belohnung

Erklärung: Die Live-Regel bleibt einfach, weil sie immer 1 als Grundwert nutzt. Die eigentliche Gewichtung passiert über den Anbieter. Dadurch kannst du später den Wert einer Plattform ändern, ohne die Live-Regel selbst umbauen zu müssen.

Beispiel: kleines Item pro Vote

Erklärung: Jeder gültige Vote erzeugt einen offenen Item-Reward. Der Spieler bekommt das Item nicht sofort in Discord, sondern holt es später ingame mit !claim ab.

Beispiel: was du vermeiden solltest

Erklärung: Das kann schnell zu viele Fahrzeuge erzeugen, weil jeder gültige Vote einen offenen Fahrzeug-Reward erstellt. Fahrzeuge eignen sich meistens besser für Wochen- oder Monats-Rewards.

Live-Rewards eignen sich für:

Plane Live-Rewards eher klein und regelmäßig. Sie wirken stark auf die Economy, weil sie bei jedem einzelnen gültigen Vote entstehen. Wenn drei Votinganbieter aktiv sind, kann ein Spieler je nach Plattformregeln mehrere Live-Rewards pro Tag erhalten.

Vorsicht:

Wenn Spieler melden, dass ein Live-Reward fehlt, prüfe in dieser Reihenfolge:

  1. Wurde der Vote im Anbieterstatus oder Vote-Verlauf erkannt?
  2. War die Live-Regel zum Zeitpunkt des Votes aktiv?
  3. Passte die Aktion der Regel zu Token, Item oder Fahrzeug?
  4. Gibt es eine Tokenbuchung oder einen offenen Reward?
  5. Greift eventuell noch eine Sperrzeit?

10. Wochen-Rewards

Wochen-Rewards werden beim Abschluss einer Kalenderwoche vergeben.

Sie werden nicht bei jedem Vote sofort erstellt, sondern erst für den abgeschlossenen Wochenzeitraum. Dadurch eignen sie sich für Ranglisten, Teilnahmebelohnungen und stärkere Belohnungen, die Spieler zum regelmäßigen Voten motivieren sollen.

Sie beziehen sich auf:

Typische Regelarten:

Typische Aktionen:

Optionen:

Beispiel für eine einfache Wochenlogik:

Dadurch bekommen die Top-Spieler mehr, während normale Teilnehmer weiterhin belohnt werden.

Beispiel: Top 3 extra belohnen

Regel 1:

Regel 2:

Erklärung: Ein Spieler in den Top 3 bekommt pro gültigem Wochenvote mehr Token als normale Teilnehmer. Wenn sich Regel 2 auf alle Teilnehmer bezieht, bekommen Top-3-Spieler beide Belohnungen. Wenn das nicht gewünscht ist, muss Regel 2 erst ab Platz 4 beginnen.

Beispiel: feste Teilnahmebelohnung

Erklärung: Jeder Teilnehmer bekommt einmalig 25 Token, egal ob er 1 Vote oder 20 Votes hatte. Das ist einfacher und vermeidet große Unterschiede.

Beispiel: Item für Platz 1

Erklärung: Nur der Wochensieger erhält diesen Item-Reward. Der Reward wird offen erstellt und kann ingame mit !claim abgeholt werden.

Wichtig:

Bei Wochenregeln ist die Überschneidung der wichtigste Punkt. Eine Teilnehmerregel kann zusätzlich zu einer Top-3-Regel greifen. Das ist manchmal gewollt, manchmal nicht. Benenne Regeln so eindeutig, dass du später in Buchungen und Rewards erkennen kannst, warum ein Spieler etwas bekommen hat.

Vor dem Aktivieren einer neuen Wochenlogik:

  1. Prüfe den gewünschten Zeitraum.
  2. Prüfe, ob Top-Spieler zusätzlich Teilnehmerbelohnungen erhalten sollen.
  3. Berechne grob die maximale Tokenmenge.
  4. Lege bei Items fest, ob genug Platz und Balancing vorhanden ist.
  5. Teste die Regel mit einem kleinen Wert oder in einer ruhigen Woche.

11. Monats-Rewards

Monats-Rewards funktionieren ähnlich wie Wochen-Rewards, beziehen sich aber auf einen abgeschlossenen Monat.

Monats-Rewards haben eine größere Außenwirkung, weil sie seltener vergeben werden und oft wertvoller sind. Nutze sie für besondere Ziele, nicht für jede kleine Standardbelohnung.

Sie eignen sich für:

Typische Monatsregeln:

Beispiel: Monatsgewinner mit Fahrzeug

Erklärung: Der beste Spieler des Monats bekommt ein besonderes Fahrzeug. Das Fahrzeug wird nicht direkt gespawnt, sondern als offener Reward gespeichert und später ingame über !claim ausgeliefert.

Beispiel: Top 10 Monatsbonus

Erklärung: Jeder Spieler in den Top 10 bekommt einmalig 250 Token. Das ist übersichtlich und leichter zu kontrollieren als eine Multiplikation nach Votes.

Beispiel: Monatsbonus nach Leistung

Erklärung: Spieler mit mindestens 10 Votes erhalten pro gezähltem Monatsvote 20 Token. Diese Variante belohnt starke Aktivität, kann aber viele Token ausschütten.

Wichtig:

Wenn du Monats-Rewards änderst, entscheide vorher, ob die Änderung nur für kommende Monate gelten soll oder ob sie auch einen bereits abgeschlossenen Monat betrifft. Rückwirkende Änderungen können Spieler verwirren und zu doppelten oder fehlenden Belohnungen führen.

Empfohlene Praxis:

12. Rewards und offene Lieferungen

Der Bereich Rewards zeigt offene und bereits abgeholte Reward-Auslieferungen.

Ein Reward kann entstehen durch:

Typische Zustände:

Wichtige Aktionen:

Der Reward-Bereich ist die zentrale Stelle, wenn Spieler sagen: „Ich habe etwas bekommen, aber ingame ist nichts angekommen.“ Prüfe dort zuerst, ob überhaupt ein offener Reward existiert. Wenn kein Reward vorhanden ist, musst du im Vote-Verlauf, im Shop-Kauf oder bei den Wochen-/Monatsregeln weiter suchen.

Ein Reward sollte nicht vorschnell gelöscht werden. Besser ist meistens:

  1. Status ansehen.
  2. SteamID vergleichen.
  3. Entstehungsquelle prüfen.
  4. Servermod-Log prüfen.
  5. Erst danach Status zurücksetzen oder Support-Korrektur buchen.

Wenn ein Reward auf reserviert hängt, hat die Servermod ihn vermutlich abgefragt, aber nicht sauber abgeschlossen. Das kann nach einem Serverabsturz, Scriptfehler oder Spawnproblem passieren. Setze so einen Reward nur zurück, wenn klar ist, dass der Spieler die Lieferung nicht erhalten hat.

Vorsicht beim Zurücksetzen:

13. Shop

Der Shop-Bereich verwaltet Artikel, die Spieler im Discord-Shop mit Token kaufen können.

Der Shop ist direkt mit dem Tokenkonto und dem Reward-System verbunden. Beim Kauf werden Token abgezogen und ein offener Reward erzeugt. Der Spieler bekommt den Gegenstand nicht im Discord, sondern später über die Servermod im Spiel.

Vor dem Aktivieren des Shops solltest du mindestens einen Testkauf durchführen:

  1. Testspieler registrieren.
  2. Testweise Token gutschreiben.
  3. Kleinen Shopartikel kaufen.
  4. Prüfen, ob Token abgezogen wurden.
  5. Prüfen, ob ein offener Reward entstanden ist.
  6. Ingame mit !claim ausliefern.

Artikel anlegen

Typische Felder:

Wichtig:

Wähle Preise so, dass sie zu deinen Vote-Werten passen. Wenn ein Spieler pro Tag sehr viele Token bekommen kann, müssen Shoppreise entsprechend höher sein. Wenn Token selten sind, sollten einfache Verbrauchsitems günstiger bleiben.

Prüfe bei jedem Artikel:

Beispiel: einfacher Item-Shopartikel

Erklärung: Spieler kaufen im Discord-Shop den Artikel Tactical Bacon. Nach dem Kauf werden 15 Token abgezogen und ein offener Reward mit 3 Dosen erstellt.

Beispiel: Munitionspaket

Erklärung: Der Spieler kauft ein Munitionspaket. Die Menge bestimmt, wie viel die Servermod später ausliefern soll. Ob die Menge gestapelt oder aufgeteilt wird, hängt vom Item und der Servermod-Logik ab.

Beispiel: Fahrzeug im Shop

Erklärung: Der Classname beschreibt die Fahrzeugkarosserie. Das Fahrzeug-Preset ergänzt Türen, Räder und optional Cargo. Ohne passendes Preset kann ein Fahrzeug unvollständig gespawnt werden.

Beispiel: Artikel vorbereiten, aber noch nicht veröffentlichen

Ergebnis: Der Artikel bleibt in der Verwaltung sichtbar, erscheint aber noch nicht im Discord-Shop.

Artikel bearbeiten

Wenn du einen Artikel bearbeitest:

Preisänderungen wirken normalerweise nur auf zukünftige Käufe. Wenn ein Spieler direkt vor einer Preisänderung gekauft hat, bleibt dieser Kauf mit dem alten Preis nachvollziehbar. Das ist wichtig für Supportfälle und verhindert, dass alte Käufe nachträglich unklar werden.

Artikel deaktivieren

Deaktivieren ist meistens besser als Löschen.

Vorteile:

Deaktiviere Artikel, wenn ein Classname fehlerhaft ist, ein Event endet oder du Preise überarbeiten willst. Löschen solltest du nur, wenn sicher ist, dass der Artikel nicht mehr für Historie, Support oder Auswertung gebraucht wird.

Sortierung

Die Sortierung legt fest, in welcher Reihenfolge Artikel im Shop angezeigt werden. Wenn Drag-and-drop aktiv ist, kannst du Artikel direkt verschieben. Nach dem Speichern oder automatischen Sortieren sollte die Anzeige im Discord-Shop geprüft werden.

14. Token

Der Token-Bereich ist in Unterseiten aufgeteilt.

Kontostände

Hier siehst du die Tokenkonten der Spieler.

Typische Informationen:

Du kannst diesen Bereich nutzen, um schnell zu prüfen:

Ein Tokenkonto entsteht normalerweise durch Registrierung, Vote-Belohnung, manuelle Buchung oder Shop-Aktivität. Wenn ein Spieler kein Konto hat, obwohl er aktiv ist, prüfe zuerst Registrierung und Vote-Zuordnung.

Der angezeigte Kontostand ist das Ergebnis aller Buchungen. Wenn er falsch wirkt, suche nicht nur nach der letzten Buchung, sondern prüfe den Verlauf rund um den Zeitpunkt, an dem der Spieler das Problem bemerkt hat.

Manuelle Buchung

Je nach Ansicht kannst du Token manuell hinzufügen oder abziehen.

Beispiele:

Wichtig:

Nutze manuelle Buchungen für Supportfälle, Eventgutschriften oder klare Korrekturen. Verwende keine allgemeinen Gründe wie fix oder test, weil später niemand mehr erkennt, warum die Buchung erfolgt ist.

Käufe

Die Kaufübersicht zeigt Shop-Bestellungen.

Typische Informationen:

Nutze diese Ansicht, wenn ein Spieler sagt, dass Token abgezogen wurden, aber kein Reward angekommen ist.

Ein Kauf besteht aus zwei Teilen: Tokenabbuchung und Reward-Erstellung. Wenn Token abgezogen wurden, aber kein Reward sichtbar ist, liegt wahrscheinlich ein Fehler zwischen Shop und Reward-Erstellung vor. Wenn ein Reward sichtbar ist, aber nicht ankommt, liegt die Prüfung eher bei Servermod, SteamID oder Claim-Status.

Buchungsverlauf

Der Buchungsverlauf zeigt einzelne Tokenbuchungen.

Typische Informationen:

Der Buchungsverlauf ist die wichtigste Ansicht, wenn du nachvollziehen willst, warum ein Spieler mehr oder weniger Token hat.

Filtere bei Supportfällen nach SteamID, nicht nur nach Spielernamen. Namen können sich ändern oder mehrfach vorkommen. Die SteamID ist die stabilere technische Zuordnung.

Beispiel: manuelle Gutschrift wegen Supportfall

Erklärung: Der Spieler erhält 50 Token. Im Buchungsverlauf bleibt sichtbar, dass es eine manuelle Korrektur war.

Beispiel: falsche Gutschrift korrigieren

Erklärung: Dem Spieler werden 25 Token abgezogen. Negative Korrekturen sollten nur genutzt werden, wenn der Grund klar nachvollziehbar ist.

Beispiel: Shop-Kauf prüfen

  1. Bereich Käufe öffnen.
  2. Nach Spielername oder SteamID suchen.
  3. Kaufzeitpunkt und Artikel prüfen.
  4. Verknüpften Reward prüfen, falls eine Reward-ID angezeigt wird.
  5. Bei Problemen im Bereich Rewards nach dieser Reward-ID suchen.

Erklärung: So findest du heraus, ob ein Spieler wirklich gekauft hat, ob Token abgezogen wurden und ob ein offener Reward erzeugt wurde.

15. Fahrzeug-Presets

Fahrzeug-Presets speichern vorbereitete Fahrzeuge.

Ein Fahrzeug-Preset beschreibt, wie ein Fahrzeug beim Claim aufgebaut werden soll. Es ist mehr als nur ein Shopartikel: Es enthält die Karosserie, Anbauteile, Räder und optional Cargo. Dadurch können Fahrzeuge reproduzierbar ausgeliefert werden.

Typische Felder:

Cargo-Format:

Wichtig:

Fahrzeug-Presets haben eine höhere Fehleranfälligkeit als einfache Items, weil mehrere Classnames zusammenpassen müssen. Ein falsches Rad, eine falsche Tür oder ein ungeeigneter Cargo-Eintrag kann dazu führen, dass der Claim nicht wie erwartet funktioniert.

Empfehlung:

Beispiel: einfaches Fahrzeug-Preset

Erklärung: Das Preset beschreibt nicht nur die Karosserie, sondern auch die Teile und den Inhalt. Wenn dieses Preset in einem Shop-Artikel gewählt wird, soll die Servermod das Fahrzeug mit diesen Teilen ausliefern.

Beispiel: Preset testen

  1. Fahrzeug-Preset anlegen.
  2. Kleinen Test-Shopartikel oder Test-Reward mit diesem Preset erstellen.
  3. Mit einem Testspieler kaufen oder Reward erzeugen.
  4. Ingame !claim ausführen.
  5. Prüfen, ob Fahrzeug, Türen, Räder und Cargo korrekt gespawnt wurden.

Erklärung: So findest du falsche Classnames, bevor normale Spieler den Reward kaufen oder gewinnen.

16. Ingame-Servermod und !claim

Die Servermod verbindet deinen DayZ-Server mit der Reward-API.

Sie ist der Teil, der aus einem offenen Reward tatsächlich ein Item oder Fahrzeug im Spiel macht. Der Bot erstellt nur die Daten. Die Servermod prüft beim Spieler, ob offene Rewards vorhanden sind, reserviert sie und meldet nach erfolgreicher Übergabe zurück.

Normaler Ablauf:

  1. Ein Spieler erhält durch Vote, Wochenreward, Monatsreward oder Shop-Kauf einen offenen Reward.
  2. Der Spieler joint den Gameserver.
  3. Die Servermod prüft automatisch, ob für seine SteamID offene Rewards vorhanden sind.
  4. Der Spieler nutzt im Chat !claim.
  5. Die Servermod reserviert die Rewards über die API.
  6. Die Items oder Fahrzeuge werden im Spiel gespawnt.
  7. Nach erfolgreicher Übergabe markiert die Servermod den Reward als abgeholt.

Wenn beim Spawnen ein Fehler auftritt, bricht die Servermod den Claim ab. Dadurch soll verhindert werden, dass ein Reward als abgeholt gilt, obwohl er nicht korrekt übergeben wurde.

Der Claim ist absichtlich mehrstufig. Dadurch wird verhindert, dass zwei gleichzeitige Abfragen denselben Reward doppelt ausliefern oder dass ein Reward als erledigt markiert wird, obwohl der Spawn fehlgeschlagen ist.

Wichtig für Betreiber:

Typische Ursachen für Claim-Probleme:

Ein sauberer Testclaim nach jeder Änderung spart später Supportzeit. Nutze dafür einen kleinen Item-Reward, bevor du große Fahrzeug-Rewards testest.

17. Typische Arbeitsabläufe

Neue Instanz einrichten

  1. Discord-Bot-Token und Guild-ID setzen.
  2. Bot starten und prüfen, ob der Login funktioniert.
  3. Discord-Channels im Webinterface setzen.
  4. Registration-Panel und Shop-Panel erstellen lassen.
  5. Votinganbieter eintragen.
  6. Live-Rewards, Wochen-Rewards und Monats-Rewards prüfen.
  7. Shop-Artikel und Fahrzeug-Presets anlegen.
  8. Servermod-ZIP herunterladen und auf dem Gameserver einrichten.
  9. Testregistrierung und Testclaim durchführen.

Nach der Einrichtung sollte die Instanz nicht sofort mit allen großen Rewards live gehen. Starte mit einfachen Tokenwerten, einem kleinen Live-Reward und einem Test-Shopartikel. Wenn Registrierung, Vote-Erfassung, Tokenbuchung, Shop-Kauf und Claim funktionieren, kannst du Wochen-, Monats- und Fahrzeug-Rewards ausbauen.

Neuen Votinganbieter aktivieren

  1. In Bot-Einstellungen zu Voting wechseln.
  2. Vote-URL eintragen.
  3. API-Key oder Token eintragen.
  4. Tokenwert pro Vote prüfen.
  5. Speichern.
  6. Registration-Panel im Discord prüfen.
  7. Provider-Status im Webinterface prüfen.

Führe danach einen echten Testvote durch, wenn die Plattform das zulässt. Prüfe anschließend nicht nur das Board, sondern auch Tokenbuchung und Live-Rewards. So erkennst du, ob der Anbieter nur angezeigt wird oder wirklich vollständig in der Belohnungskette funktioniert.

Neue Wochenregel anlegen

  1. Bereich Wochen-Rewards öffnen.
  2. Regelname setzen.
  3. Rangbereich oder Teilnehmerbedingung einstellen.
  4. Aktion wählen: Token, Item oder Fahrzeug.
  5. Betrag, Classname, Menge oder Preset setzen.
  6. Regel aktivieren.
  7. Speichern.
  8. Prüfen, ob sie sich mit anderen Regeln überschneidet.

Wenn mehrere Regeln aktiv sind, rechne ein Beispiel manuell durch. Beispiel: Ein Spieler auf Platz 1 mit 12 Votes bekommt Top-3-Token, Teilnehmer-Token und eventuell zusätzliche Item-Rewards. Erst wenn diese Summe gewollt ist, sollte die Regel produktiv bleiben.

Neuen Shop-Artikel anlegen

  1. Bereich Shop öffnen.
  2. Anzeigename setzen.
  3. Optional Kategorie setzen.
  4. Classname und Menge setzen.
  5. Preis in Token setzen.
  6. Optional Fahrzeug-Preset wählen.
  7. Artikel aktivieren.
  8. Speichern.
  9. Discord-Shop prüfen.

Danach solltest du mindestens einen Testkauf machen. Ein Artikel ist erst wirklich fertig, wenn Kauf, Tokenabbuchung, offener Reward und Claim funktionieren. Besonders bei Fahrzeugen reicht es nicht, dass der Artikel im Discord-Shop sichtbar ist.

Spielerproblem prüfen

Wenn ein Spieler meldet, dass etwas fehlt:

  1. SteamID prüfen.
  2. Registrierung prüfen.
  3. Bei Vote-Problemen Anbieterstatus prüfen.
  4. Bei Token-Problemen Buchungsverlauf prüfen.
  5. Bei Shop-Problemen Käufe prüfen.
  6. Bei Claim-Problemen offene Rewards und Servermod-Log prüfen.

Notiere bei Supportfällen immer den ungefähren Zeitpunkt, die SteamID, den Discord-User und den betroffenen Anbieter oder Artikel. Ohne diese Angaben dauert die Suche deutlich länger, weil Namen und Discord-Anzeigenamen nicht immer eindeutig sind.

18. Typische Fehler und schnelle Prüfung

Vote wird nicht gezählt

Zusätzlich prüfen:

Registration-Panel zeigt falsche Links

Bot schreibt keine Nachrichten

Shop-Artikel erscheint nicht

Spieler kann Reward nicht claimen

Zusätzlich prüfen:

Tokenstand stimmt nicht

Zusätzlich prüfen:

Fahrzeug spawnt unvollständig

Portal zeigt keine Instanz

19. Empfehlungen für den Betrieb

Zusätzlich bewährt sich:

20. Datenschutz und Verantwortung

Der Bot verarbeitet Discord-IDs, Discord-Namen, SteamIDs, Votes, Tokenstände, Käufe, Rewards, Claim-Zeitpunkte und technische Logdaten. Betreiber sollten ihre Spieler darüber informieren und die verwendeten Votingplattformen in Datenschutz- und Regeltexten nennen.

Diese Daten werden benötigt, damit Votes zu Spielern zugeordnet, Tokenstände berechnet, Shopkäufe abgewickelt und Rewards ausgeliefert werden können. Ohne SteamID und Discord-Zuordnung kann der Bot viele Funktionen nicht zuverlässig bereitstellen.

Du bist als Serverbetreiber verantwortlich für:

Empfohlen ist ein kurzer Hinweis im Discord oder Regelwerk, der erklärt:

Gib Bot-Token, API-Keys, Routing-Token und Servermod-Konfigurationen niemals öffentlich weiter. Wer diese Daten besitzt, kann je nach Schlüssel sensible Funktionen deiner Instanz beeinflussen oder technische Schnittstellen missbrauchen.