Discord-Referral-Bot: Einladungen tracken, Mitglieder belohnen, Fake-Beitritte blockieren

Ein Referral-Bot gibt jedem Mitglied einen eigenen Einladungslink, erfasst, wer darüber beigetreten ist, und vergibt Belohnungsrollen, sobald jemand genug Leute geholt hat. Das Schwierige ist nicht das Zählen der Beitritte, sondern das Ablehnen der falschen. Das Referral-Modul von Noxyr kann beides, ist kostenlos und lässt sich mit einem Befehl aktivieren. Diese Anleitung erklärt, wie die Zuordnung funktioniert, die vier Regeln gegen Farming und die Einstellungen, die du festlegen solltest, bevor du einen Referral-Wettbewerb ankündigst.

Wie die Zuordnung von Discord-Einladungen tatsächlich funktioniert

Discord sagt einem Bot nie, welche Einladung ein neues Mitglied benutzt hat. Offengelegt wird aber der Nutzungszähler jeder Einladung auf dem Server. Ein Referral-Bot speichert diese Zähler im Arbeitsspeicher und sucht im Moment eines Beitritts nach der Einladung, deren Zähler um eins gestiegen ist. Deshalb braucht der Bot die Berechtigung Server verwalten (um Einladungen zu lesen) und den Gateway-Intent für Einladungen; ohne eins von beidem werden Beitritte einfach nicht zugeordnet, und sonst geht nichts kaputt.

Noxyr fügt noch ein Teil hinzu: /referrals link erstellt eine persönliche Einladung für das Mitglied, das den Befehl ausführt, und zwar durch den Bot. Dadurch wird der Beitritt diesem Mitglied zugeordnet, selbst wenn es den Einladungsdialog von Discord nie benutzt hat. Mitglieder teilen diesen Link, und jeder Beitritt darüber zählt für sie.

Was Referral-Farming verhindert

Jede Belohnung für Referrals wird innerhalb einer Stunde ausgenutzt, wenn die Regeln nicht eingebaut sind. Noxyr wendet vier davon an:

• Ein Referral pro Mitglied, für immer. Ein Mitglied, das geht und über einen anderen Link wieder beitritt, zählt nicht doppelt. Der Eintrag ist pro Mitglied und Server dauerhaft eindeutig.
• Keine Selbsteinladungen, keine Bots. Wenn du deinen eigenen Zweitaccount oder einen Bot einlädst, zählt das nie.
• Mindestkontoalter. Setze min_account_age (0 bis 365 Tage), dann werden Konten, die jünger sind, als wahrscheinliche Zweitaccounts abgelehnt.
• Ein Verweildauer-Timer. Aktiviere hold, dann wartet ein Referral hold_hours (1 bis 720) ab, bevor es zählt, und es zählt nur, wenn das neue Mitglied am Ende noch auf dem Server ist. Einladen und sofort wieder verlassen bringt nichts.

Zwei Wege, Referrals zu erfassen: Log oder Ticket

Jedes Referral wird angekündigt. Im Log-Modus geht ein Embed in einen Kanal deiner Wahl: wer wen eingeladen hat und ob es gezählt wurde oder noch auf den Verweildauer-Timer wartet. Im Ticket-Modus öffnet jedes Referral einen privaten Kanal für das Team mit den Buttons Genehmigen und Ablehnen, sodass ein Mensch es bestätigt, bevor es zählt. Der Ticket-Modus ist die richtige Wahl, wenn Referrals etwas Wertvolles auszahlen; für eine rein kosmetische Rolle reicht der Log-Modus.

Belohnungsrollen

/referrals reward-add count:5 role:@Recruiter vergibt eine Rolle automatisch in dem Moment, in dem ein Mitglied fünf gezählte Referrals erreicht. Du kannst beliebig viele Schwellenwerte hinzufügen (jeweils bis zu 1.000 Referrals), sie für Stufen stapeln und mit /referrals reward-remove wieder entfernen. Da Belohnungen Rollen sind, wird alles, was Discord mit einer Rolle kann (Kanalzugriff, eine Farbe, ein angepinnter Name), ohne weitere Konfiguration zu einem Referral-Vorteil.

Einrichtung

• 1. Stelle sicher, dass Noxyr die Berechtigung Server verwalten hat (Administrator schließt sie mit ein).
• 2. Führe /referrals setup enabled:true mode:log log_channel:#referrals aus oder öffne im Dashboard Community → Referrals und fülle dort dieselben Felder aus.
• 3. Lege die Regeln fest: hold:true hold_hours:24 und min_account_age:7 sind ein vernünftiger Standard für einen öffentlichen Server.
• 4. Füge Belohnungsstufen mit /referrals reward-add hinzu.
• 5. Sag den Mitgliedern, dass sie /referrals link ausführen und teilen sollen. /referrals me zeigt ihre Gesamtzahl und wie viele noch warten; /referrals top ist die Bestenliste.

Das Team kann jedes Mitglied mit /referrals user prüfen, und /referrals settings zeigt die aktuelle Konfiguration und die bisher gezählte Gesamtzahl.

Ideen für eine Referral-Kampagne

• Eine monatliche Rolle „Top-Recruiter“ plus eine Shout-out in den Ankündigungen, mit /referrals top.
• Ein Shop-Gutschein für die ersten fünf Referrals, vom Team im Ticket-Modus verteilt. Siehe Gutscheincodes.
• Früher Zugang zu einem Produkt-Drop für alle mit der Belohnungsrolle, da Rollen den Kanalzugriff steuern.

Häufige Fragen

Funktioniert es mit Vanity-URLs? Beitritte über eine Vanity-URL sind keinem Mitglied zugeordnet, deshalb werden sie niemandem gutgeschrieben.

Was passiert, wenn eine Einladung bei diesem Beitritt ihr Nutzungslimit erreicht? Eine Einladung, die verschwindet, weil ihre letzte Nutzung gerade verbraucht wurde, wird trotzdem zugeordnet, Links mit begrenzter Nutzungszahl zählen also ebenfalls.

Kann ich ausstehende Referrals sehen? Ja, /referrals me und /referrals user zeigen gezählte und wartende Zahlen getrennt an.

Ist es kostenlos? Ja, wie jedes Modul von Noxyr.

Aktiviere es über das Dashboard und kombiniere es mit Team-Bewerbungen, um deine besten Recruiter zu Moderatoren zu machen.