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. 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.

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