Empfehlungsprogramm: Belohnungen für Einladungen mit Missbrauchsschutz

Das Empfehlungsprogramm belohnt Mitglieder, die neue Mitglieder auf deinen Server holen: Erreicht jemand eine bestimmte Zahl echter Einladungen, vergibt Kage automatisch eine Rolle oder XP. Die Zählung kommt aus dem Einladungs-Tracking, das Gefälschtes und Verlassenes herausrechnet.

Dieses Programm betrifft Einladungen auf deinem Server. Es hat nichts mit dem Kage-Punkte-System der Plattform zu tun. Eine kurze Anleitung findest du im Ratgeber Empfehlungssystem einrichten.

Voraussetzungen

• Einladungs-Tracking: Es läuft automatisch, braucht aber Kages Recht Server verwalten (siehe Einladungs-Tracking).
• Für Rollen-Belohnungen: Kage braucht Rollen verwalten, und seine Rolle muss in der Rollenliste über der Belohnungsrolle stehen.
• Für XP-Belohnungen: Das Level-System sollte eingeschaltet sein (siehe Level und XP), damit die XP etwas bewirken.
• Zugriff: Im Dashboard brauchst du Server verwalten. Die Slash-Befehle /referral sind ebenfalls nur mit diesem Recht nutzbar.

So arbeitet das Programm

1. Ein Mitglied tritt über eine Einladung bei. Das Tracking ordnet den Beitritt der einladenden Person zu und klassifiziert ihn als echt oder gefälscht.
2. Nur wenn der Beitritt nicht gefälscht ist, prüft Kage die Belohnungen der einladenden Person.
3. Kage berechnet ihre Netto-Einladungen (echt und noch auf dem Server).
4. Für jede Belohnung, deren Schwelle erreicht ist und die die Person noch nicht erhalten hat, vergibt Kage die Belohnung:

- Rolle: Kage vergibt die Rolle, falls die Person sie noch nicht trägt.
- XP: Kage schreibt die XP als Event-XP gut. Sie werden nicht multipliziert.

1. Jede Schwelle gilt einmal pro Person. Danach ist sie als vergeben vermerkt.
2. Die Belohnung erscheint im Reiter Logs des Moduls („Referral-Belohnung(en) für …“).

Wichtig:

• Die Prüfung läuft beim Beitritt eines weiteren Mitglieds. Eine Belohnung erscheint also mit dem Beitritt, der die Schwelle erreicht, nicht rückwirkend zu einem späteren Zeitpunkt.
• Verlässt später jemand den Server, entzieht Kage keine bereits vergebene Belohnung.
• Ist die einladende Person im Moment der Prüfung nicht auf dem Server, vergibt Kage keine Rolle, vermerkt die Schwelle aber trotzdem als erreicht. Die Rolle entfällt dann endgültig. XP werden dagegen gutgeschrieben.

Der Missbrauchsschutz

Ein Beitritt zählt nicht als echt, wenn der eingeladene Discord-Account jünger ist als das Mindest-Kontoalter (Standard 7 Tage, einstellbar von 0 bis 365) oder wenn die Person schon einmal auf dem Server war. Gefälschte Beitritte lösen keine Belohnungen aus und zählen nicht zu den Netto-Einladungen. Sie fließen in die Kennzahl „Gefälscht“ des Einladungs-Trackings ein.

Mit dem Wert 0 gilt jedes Konto als alt genug. Das Mindest-Kontoalter wirkt auch auf das Tracking selbst.

Befehle

Die Gruppe /referral ist nur mit Server verwalten nutzbar. Alle Antworten sieht nur du.

Die Befehle add-role und add-xp schalten das Modul zugleich ein. Existiert für eine Schwelle schon eine Belohnung, ersetzt die neue sie. Es sind höchstens 25 Belohnungen möglich.

Einstellungen im Überblick

Pro Schwelle ist nur eine Belohnung möglich, und jede Belohnung braucht eine Rolle oder einen XP-Betrag, sonst lehnt das Dashboard das Speichern ab.

Ergebnis überprüfen

1. Belohnung anlegen: /referral add-role mit Schwelle 1 und einer Testrolle.
2. Testbeitritt: Tritt mit einem Konto, das älter als das Mindest-Kontoalter ist, über eine Einladung eines Testkontos bei.
3. Ergebnis: Das einladende Konto erhält die Rolle, und der Reiter Logs nennt die Belohnung.
4. Kontrolle: /referral list zeigt die Schwellen, /invites die Zahlen.

Fehlerbehebung

Die Belohnung kommt nicht

Prüfe, ob das Programm aktiv ist und die Belohnung gespeichert wurde. Prüfe, ob der Beitritt als echt gezählt wurde (Konto alt genug, nicht schon einmal auf dem Server) und ob die Netto-Zahl die Schwelle erreicht. Hat die Person die Belohnung schon einmal erhalten, bekommt sie sie nicht erneut.

Die Rolle wird nicht vergeben

Kages Rolle steht unter der Belohnungsrolle, oder Kage hat Rollen verwalten nicht. Die Schwelle gilt danach trotzdem als erreicht. Vergib die Rolle in diesem Fall von Hand.

Die Zählung stimmt nicht

Das Einladungs-Tracking ordnet nur Beitritte über lesbare Einladungen zu, und gefälschte oder verlassene Beitritte zählen nicht mit. Prüfe die Zahlen mit /invites.

Weiterführend

Grundlage der Zählung: Einladungs-Tracking. XP und Ränge: Level und XP und Ränge, Level und Belohnungen.