Ränge, Level und Belohnungen: Einstellungen und Fehlerbehebung

Aus den gesammelten XP leitet Kage zwei voneinander unabhängige Fortschritte ab: das feine Level (1, 2, 3, …) und den groben, benannten Rang (zum Beispiel Member, VIP). Beide beruhen auf derselben Gesamt-XP, haben aber getrennte Einstellungen und getrennte Rollen. Dadurch kannst du zum Beispiel Level 20 mit einer besonderen Rolle belohnen und zusätzlich fünf Ränge mit einem Rollenwechsel pflegen.

Woher die XP kommen, steht in Level und XP: Quellen, Limits und Schutz vor Farming. Befehle, Multiplikatoren und den Season-Reset erklärt Level und XP verwalten. Eine kurze Anleitung für Rollen findest du im Ratgeber Level-Rollen vergeben.

Voraussetzungen

• Zugriff auf das Modul: Du meldest dich im Dashboard mit Discord an und brauchst das Recht Server verwalten (oder einen für dieses Modul freigegebenen Zugriff).
• Modul einschalten: „Rang-/EXP-System aktiv“ muss an sein.
• Rollen in Discord: Lege die Rollen für Ränge, Newcomer und Level-Belohnungen an.
• Rollenreihenfolge und Recht: Kages Rolle muss in der Rollenliste über allen Rang- und Belohnungsrollen stehen. Kage braucht außerdem das Recht Rollen verwalten (in der Standard-Einladung enthalten).
• Für Nachrichten: Kage muss im gewählten Kanal Nachrichten senden dürfen.

Level

Die Level-Kurve

Die Gesamt-XP, die für Level *n* nötig ist, berechnet Kage als Basis × n². Die Formel-Basis ist standardmäßig 100:

Anfangs steigt man schnell auf, später kostet jedes Level spürbar mehr. Unter Eigene Level-Schwellen legst du für einzelne Level eine exakte XP-Zahl fest. Ein solcher Eintrag gilt für genau dieses Level, alle anderen Level folgen weiter der Formel. Die höchste mögliche Stufe ist Level 1000.

Level-Belohnungen

Unter Level-Belohnungen ordnest du einem Level eine Rolle zu:

• Die Belohnung wird ab diesem Level vergeben. Überspringt ein Mitglied das Level (zum Beispiel von 9 auf 11 durch Bonus-XP), bekommt es die Rolle trotzdem.
• Mitglieder, die den Schwellwert schon früher erreicht haben, bekommen die Rolle nachträglich einmal automatisch (innerhalb weniger Minuten, in kleinen Schritten, damit Discord nicht überlastet wird). Eine neu eingetragene oder geänderte Belohnung wird ebenfalls einmal nachgeholt. Entziehst du später jemandem die Rolle absichtlich, vergibt Kage sie nicht erneut.
• Rollen stapeln sich: Kage entfernt keine frühere Belohnungsrolle. Das unterscheidet sie von den Rang-Rollen.
• Pro Level ist nur eine Belohnung möglich, und jede Zeile braucht Level und Rolle, sonst lehnt das Dashboard das Speichern ab.
• Springt ein Mitglied durch eine große Vergabe (zum Beispiel per Admin-Befehl) über mehrere Level, vergibt Kage nur die Belohnung des erreichten Levels. Belohnungen übersprungener Level gibt es nicht nachträglich.

Level-Up-Nachricht

Kage sendet eine Nachricht, wenn ein Mitglied ein neues Level erreicht, aber nur, wenn du einen Level-Up-Kanal gewählt hast. Ohne Kanal bleibt es still, damit häufige Aufstiege nicht ungewollt Spam erzeugen. Im Text kannst du die Platzhalter {member} (Erwähnung) und {level} verwenden. Der vorausgefüllte Standardtext ist deutsch und lässt sich frei ändern.

Ränge

Die fünf Stufen

Kage kennt fünf Rang-Stufen in fester Reihenfolge. Bezeichnung und Rolle stellst du pro Stufe ein, die Standardschwellen sind:

Eine Stufe gilt erst als erreicht, wenn auch alle vorherigen Stufen ihre Schwelle erreicht haben: Die wirksame Schwelle einer Stufe ist das Maximum aus ihrer eigenen und den Schwellen aller Vorgänger. Lässt du bei VIP versehentlich 0 stehen, obwohl Premium Member bei 1.000 liegt, wird VIP trotzdem erst ab 1.000 XP vergeben. /level-info zeigt die tatsächlich wirksamen Schwellen.

Eine Stufe ohne gewählte Rolle vergibt keine Rolle und erscheint nicht in der Liste von /level-info. Der Rangname selbst wird bei /level und /leaderboard nicht angezeigt, dort stehen nur Level und XP.

Was bei einem Rang-Aufstieg passiert

Erreicht ein Mitglied durch XP eine neue Stufe:

1. Kage vergibt die Rolle der neuen Stufe.
2. Ist „Vorherige Rang-Rolle beim Aufstieg entfernen (statt zu stapeln)“ an (Standard) und hat die neue Stufe eine Rolle, entfernt Kage alle anderen Rang-Rollen (einschließlich der Newcomer-Rolle), nicht nur die rechnerisch vorherige. So bleibt auch bei übersprungenen Stufen genau eine Rang-Rolle übrig.
3. Kage sendet die Rang-Aufstiegs-Nachricht, je nach Einstellung Senden an: *Kanal*, *Direktnachricht* oder *Keine Nachricht*. Für *Kanal* musst du einen Rang-Aufstiegs-Kanal wählen, sonst entfällt die Nachricht. Platzhalter: {member} und {rank}.
4. Der Vorgang erscheint im Reiter Logs des Moduls.

Sinkt der Rang durch einen XP-Abzug, passt Kage die Rang-Rolle ebenfalls an. Die Dashboard-Option „Bei EXP-Rücknahme automatisch zurückstufen“ wird vom Bot derzeit nicht ausgewertet.

Newcomer → Member

Der Aufstieg aus Newcomer läuft nicht über XP, sondern über Bedingungen:

1. Beitritt: Wer dem Server beitritt, bekommt die Newcomer-Rolle, sofern das Modul an ist und eine Newcomer-Rolle gewählt wurde. Bots sind ausgenommen. Mitglieder, die schon vor der Einrichtung auf dem Server waren, bekommen sie nicht nachträglich.
2. Fortschritt: Kage zählt, wie viele Nachrichten, Reaktionen und Voice-Minuten das Mitglied gesammelt hat. Eine Nachricht zählt auch dann, wenn sie kürzer als die XP-Mindestlänge ist.
3. Bedingungen: Standardmäßig braucht es 1 Nachricht und 1 Reaktion, Voice-Minuten sind mit 0 keine Bedingung. Sobald alle aktivierten Bedingungen erfüllt sind, wechselt Kage einmalig die Newcomer-Rolle gegen die Rolle der Stufe *Member*.
4. Der Aufstieg ist dauerhaft und wird nie zurückgesetzt, auch wenn du die Schwellen später erhöhst. Eine Nachricht zum Aufstieg sendet Kage dabei nicht.

Ohne gewählte Newcomer-Rolle zählt Kage den Fortschritt gar nicht. Ausnahme-Rollen und komplett ausgenommene Kanäle blockieren den Fortschritt wie die XP.

Ob Reaktionen auf eigene Nachrichten zählen, bestimmt allein die XP-Einstellung „Reaktionen auf eigene Nachrichten geben keine EXP“. Die Checkbox „Reaktionen auf eigene Nachrichten zählen für die Newcomer-Bedingung“ wird derzeit nicht ausgewertet.

Einstellungen im Überblick

Ergebnis überprüfen

1. Stand eines Mitglieds: /level zeigt Level, Gesamt-XP und den Fortschritt zum nächsten Level.
2. Rangliste: /leaderboard (deutsch /rangliste) zeigt die Top 10 mit Platz, Name und Level.
3. Regeln des Servers: /level-info listet die Rang-Stufen mit Rolle und wirksamer Schwelle.
4. Rollen in Discord: Prüfe bei einem Testkonto, ob die erwartete Rolle vergeben und die vorherige entfernt wurde.
5. Protokoll: Im Reiter Logs erscheinen Level- und Rang-Aufstiege.

Fehlerbehebung

Die Rang- oder Belohnungsrolle wird nicht vergeben

Meist ist es die Rollenreihenfolge: Kages Rolle muss über der Rolle stehen, außerdem muss Kage das Recht Rollen verwalten haben. In Discord erscheint dazu keine Meldung, der Fehler steht nur im Betriebslog. Prüfe außerdem, ob die Rolle in Discord noch existiert, eine gelöschte Rolle überspringt Kage.

Ein Mitglied hat den Rang nicht, obwohl es genug XP hat

Prüfe, ob für diese Stufe eine Rolle gewählt ist und ob die Schwellen der Vorgänger-Stufen niedriger liegen (es gilt das laufende Maximum). /rank-xp recalculate-roles gleicht die Rang-Rolle eines Mitglieds mit dem aktuellen XP-Stand ab.

Ein Mitglied hängt in der Newcomer-Rolle fest

Prüfe, ob eine Newcomer-Rolle gewählt und gespeichert ist, ob die Bedingungen erreichbar sind (zum Beispiel Voice-Minuten) und ob das Mitglied nicht durch eine Ausnahme-Rolle oder einen ausgenommenen Kanal blockiert wird. Eine Reaktion auf die eigene Nachricht zählt standardmäßig nicht.

Zu viele Mitglieder werden sofort zu Member

Mit Schwelle 0 gilt die Stufe *Member* bereits ab 0 XP. Der Wechsel aus der Newcomer-Rolle hängt trotzdem an den Newcomer-Bedingungen. Beachte, dass /rank-xp recalculate-roles die Rolle allein nach den XP setzt und die Newcomer-Bedingungen nicht prüft.

Die Level-Up-Nachricht fehlt

Kage sendet sie nur, wenn ein Level-Up-Kanal gewählt ist, auch wenn das Dashboard in der Kanalliste die Option „im Kanal der Nachricht posten“ anbietet. Prüfe außerdem, ob Kage im Kanal Nachrichten senden darf.

Die Level-Belohnung fehlt

Mögliche Gründe: Das Mitglied hat das Level übersprungen, es trägt die Rolle schon, die Rolle wurde gelöscht oder liegt über Kages Rolle.

Die Rang-Nachricht fehlt

Prüfe „Senden an“ und, bei *Kanal*, ob ein Rang-Aufstiegs-Kanal gewählt ist. Bei *Direktnachricht* scheitert die Zustellung, wenn das Mitglied Direktnachrichten von Servermitgliedern gesperrt hat.

Weiterführend

Quellen und Limits der XP: Level und XP: Quellen, Limits und Schutz vor Farming. Befehle, Multiplikatoren und Season-Reset: Level und XP verwalten. Rollen allgemein: Auto-Rollen und Reaktionsrollen.