Empfehlungen

Das Empfehlungssystem ermöglicht es Spielern, Währungsprämien zu verdienen, indem sie neue Mitglieder in den Discord-Server einladen. Jeder Spieler kann einen einzigartigen, permanenten Discord-Einladungslink generieren. Wenn jemand über diesen Link beitritt und anschließend einen dzbot-Account beansprucht, wird dem Empfehlenden automatisch die konfigurierte Belohnung gutgeschrieben.

Ablauf

1. Ein Spieler mit dem Zugriffsrecht profile.generate_referral erstellt seinen persönlichen Empfehlungslink auf der Profil-Seite.
2. dzbot erstellt eine permanente Discord-Einladung für den ersten verfügbaren Textkanal des Servers und speichert sie.
3. Wenn ein neuer Nutzer dem Discord-Server über diesen Einladungslink beitritt, wird der Beitritt dem Empfehlenden zugeordnet.
4. Beansprucht der neue Nutzer später seinen In-Game-Account über den Bot, wird dem Empfehlenden die konfigurierte Belohnung auf sein Guthaben gutgeschrieben.

Jeder Beitritt wird maximal einmal vergütet – pro Mitglied und pro Empfehlungslink. Falls der neue Nutzer seinen Account bereits vor dem Beitritt beansprucht hatte oder zum Zeitpunkt der Beanspruchung kein offener Beitritt vorliegt, wird keine Belohnung ausgezahlt.

Wie dzbot die verwendete Einladung erkennt

Discord verrät nicht, welche Einladung ein beitretendes Mitglied verwendet hat. Das einzige verfügbare Signal ist die Änderung des Nutzungszählers einer Einladung. dzbot speichert daher den Zählerstand jeder Einladung des Servers – auch der von Mitgliedern selbst erstellten – und vergleicht ihn bei jedem Beitritt mit dem Live-Stand.

Eine Empfehlung wird nur dann gutgeschrieben, wenn serverweit genau eine Nutzung hinzugekommen ist, und zwar bei einer Einladung, die bereits erfasst war. Nur in diesem Fall lässt sich das beitretende Mitglied zweifelsfrei einer Einladung zuordnen.

Alles andere wird als nicht zugeordneter Beitritt erfasst, anstatt der wahrscheinlichsten Empfehlung gutgeschrieben zu werden:

Situation	Verhalten
Eine eigene Einladung eines Mitglieds oder die Vanity-URL wurde verwendet	Zugeordnet, aber ohne Empfehlung – es wird nichts erfasst
dzbot hat das Mitglied beim Verknüpfen des Accounts selbst hinzugefügt	Es wurde keine Einladung verwendet, es gibt also keinen Empfehlenden – es wird nichts erfasst
Mehrere Einladungen wurden im selben Moment verwendet	Wird erfasst, inklusive der infrage kommenden Einladungen
Die Einladung wurde nach der letzten Erfassung erstellt	Wird erfasst
Der Bot war gerade neu gestartet und hatte noch keinen Vergleichsstand	Wird erfasst
Die Einladungsliste konnte nicht gelesen werden (fehlendes Recht Server verwalten)	Wird erfasst

Admins finden diese Einträge unter Admin → Empfehlungen → Nicht zugeordnete Beitritte und können sie dem richtigen Empfehlenden zuweisen. Dabei wird der Beitritt erstellt und die Belohnung ausgezahlt. Einträge, zu denen es tatsächlich keinen Empfehlenden gibt – die Einladung war bereits abgelaufen oder die Liste konnte nicht gelesen werden – lassen sich stattdessen verwerfen.

Beitritte, die erfolgten, während der Bot offline war, sind ein anderer Fall: Discord liefert diese Ereignisse nicht nachträglich aus, das Mitglied wird also nie erfasst und kann in dieser Liste nicht erscheinen. Solche Beitritte werden stattdessen als Vorfall an der betroffenen Empfehlung ausgewiesen, mit der Anzahl der nicht gutgeschriebenen Nutzungen. Da das Mitglied unbekannt ist, lassen sie sich nicht rückwirkend zuordnen.

hinweis

Der Bot benötigt auf dem Server das Recht Server verwalten, um die Einladungsliste lesen zu können. Ohne dieses Recht kann keine Empfehlung zugeordnet werden und jeder Beitritt landet in der Liste der nicht zugeordneten Beitritte.

Konfiguration

Die Belohnungshöhe wird über eine einzige Servereinstellung gesteuert:

Einstellung	Ort	Standard
Empfehlungsbelohnung	Admin → Wirtschaftseinstellungen	0 (deaktiviert)

Wenn die Belohnungshöhe auf 0 gesetzt ist, ist das Empfehlungssystem vollständig deaktiviert. Spieler sehen die Empfehlungskarte auf ihrem Profil nicht, solange keine Belohnung konfiguriert ist.

Spielererfahrung

Spieler rufen die Profil-Seite auf. Wenn die Funktion aktiv ist und sie das erforderliche Zugriffsrecht besitzen, wird eine Empfehlungslink-Karte angezeigt. Die Karte zeigt:

• Die konfigurierte Belohnung pro Empfehlung.
• Eine Schaltfläche Empfehlungslink erstellen (solange noch kein Link existiert).
• Den generierten Einladungslink mit einer Kopierschaltfläche (nach der Erstellung).
• Statistiken: Gesamtanzahl der Discord-Beitritte über den Link und wie viele davon zu einer Auszahlung geführt haben.

Zugriffsrechte

Zugriffsrecht	Wer es benötigt
profile.access	Profilseite aufrufen
profile.generate_referral	Empfehlungslink erstellen und einsehen

Admins vergeben diese Rechte über das Zugriffskontrollsystem. Siehe Zugriffskontrolle.

Verwandte Dokumentation

• Transaktionen
• Zugriffskontrolle
• Discord-Integration