Leveling

Das Flaggschiff: Mitglieder sammeln durch Aktivität Punkte — standardmäßig heißen sie „Aura", du kannst Name und Icon aber pro Server frei ändern. Nachrichten, Voice (inklusive Stage-Kanäle) und Reaktionen zählen; mit /rank ruft jeder seine gestaltete Rank-Card als Bild ab, /leaderboard zeigt die Server-Rangliste.

Für Admins gibt es viel Feintuning: Level-Up-Ankündigungen (Kanal, Häufigkeit, eigene Texte), Rollen-Belohnungen ab bestimmten Leveln, ein globaler Tempo-Regler (×0,25 bis ×5) sowie XP-Faktoren pro Kanal und pro Rolle (0 = kein XP, 2 = doppelt). Ausnahme-Rollen wie @Team sammeln nichts und tauchen nicht in der Rangliste auf — fairer Wettbewerb für die Community.

Du kommst von MEE6? Der Import im Dashboard holt die alten XP-Stände deines Servers mit einem Klick. Loslegen: Modul einschalten und die Einstellungen unter „Leveling" öffnen.

Im Bereich „Aura korrigieren“ (mit dem Namen deiner Punkte, falls du sie umbenannt hast) passt du die Aura einzelner Mitglieder an (genau setzen, dazuzählen, abziehen oder auf 0) — im Dashboard oder direkt in Discord über /levels aura. Vor jedem Speichern fragt das Dashboard noch einmal nach. Seasons — also Wettbewerbe mit Laufzeit, Rangliste, Belohnungen und Neustart — beendest und startest du unter „Seasons verwalten“; der Name der laufenden Season erscheint automatisch in der Rangliste, im /leaderboard und auf der Rang-Karte. Mehr dazu in der Anleitung Seasons.

Level-Ankündigungen

Bei jedem Level-Up postet CAT einen von zehn wechselnden Texten — zufällig ausgewählt und nie zweimal hintereinander derselbe. Meilensteine feiert CAT mit fünf eigenen, größeren Texten: Das sind jedes zehnte Level (10, 20, 30 …) sowie Level 25 und 75.

Bekommt ein Mitglied mit dem Level-Up eine Rolle als Belohnung, steht sie immer in der Nachricht. Erwähnt der gewählte Text die Rolle nicht selbst, hängt CAT automatisch die Zeile „🎁 Neue Rolle: …“ an.

Du willst eigene Texte? Im Dashboard unter „Leveling“ → „Level-Ankündigungen“ legst du bis zu 10 eigene Level-Up-Texte und bis zu 5 eigene Meilenstein-Texte an. Platzhalter: {user} für das Mitglied, {level} für das neue Level und {role} für eine neue Rolle. Sind eigene Texte da, wählt CAT nur aus ihnen; ist eine Liste leer, nimmt CAT dafür die eingebauten CAT-Texte.

Schnellweg in Discord: /levels announce text ersetzt deine normalen Level-Up-Texte durch genau einen neuen. Lässt du den Text leer, gelten wieder die CAT-Texte. Deine Meilenstein-Texte bleiben dabei unberührt.

Einstellungen

Dieser Abschnitt wird automatisch aus dem Dashboard generiert und ist immer aktuell — jedes Feld findest du 1:1 in den Modul-Einstellungen.

Level-Ankündigungen

Level-Up-Ankündigungs-Kanal

Kanal, in dem der Bot Level-Aufstiege verkündet. Leer = keine Level-Up-Nachrichten.

Wann ankündigen?

'Bei jedem Level' meldet jeden Aufstieg. 'Nur Level mit Rollen-Belohnung' meldet nur Aufstiege, bei denen es eine Belohnungs-Rolle gibt — weniger Kanal-Spam.

Standard: Bei jedem Level — Optionen: Bei jedem Level · Nur Level mit Rollen-Belohnung

User im Announce anpingen

An = der User bekommt bei seiner Level-Up-Nachricht eine echte @-Benachrichtigung. Aus = sein Name steht zwar in der Nachricht, pingt ihn aber nicht.

Standard: An

Eigene Level-Up-Texte (bis zu 10)

Bei jedem Level-Up wählt CAT zufällig einen dieser Texte, nie zweimal hintereinander denselben. Platzhalter: {user} (Erwähnung), {level} (neues Level), {role} (Belohnungs-Rolle, bleibt leer wenn keine). Gibt es eine Rollen-Belohnung und der Text nennt {role} nicht, hängt CAT automatisch die Zeile „Neue Rolle: …“ an. Liste leer = CAT-Texte (10 Stück).

Liste mit Spalten: Text

Eigene Meilenstein-Texte (bis zu 5)

Meilensteine sind jedes 10. Level sowie 25 und 75 — dort nimmt CAT zufällig einen dieser Texte statt eines normalen. Platzhalter wie oben: {user}, {level}, {role}; die Zeile „Neue Rolle: …“ kommt auch hier automatisch dazu, wenn der Text {role} nicht nennt. Liste leer = CAT-Texte (5 Meilenstein-Texte).

Liste mit Spalten: Text

Belohnungen

Level-Belohnungen (Level → Rolle)

Rollen-Belohnungen: Erreicht ein User das eingetragene Level, vergibt der Bot die Rolle automatisch — z. B. Level 10 → @Aktiv.

Liste mit Spalten: Level · Rolle

Rang-Rollen beim Aufstieg

'Nur höchste Rolle behalten' entzieht beim Aufstieg automatisch die niedrigeren Rang-Rollen — jedes Mitglied trägt genau seinen aktuellen Rang, die Mitgliederliste bleibt sauber. 'Alle Rollen behalten' stapelt die Rollen wie bei MEE6: Wer Level 20 erreicht, behält auch die Rollen von Level 5 und 10.

Standard: Nur höchste Rolle behalten — Optionen: Nur höchste Rolle behalten · Alle Rollen behalten (stapeln)

Streak-Meilensteine (Tage → Punkte → Text)

Belohnt Aktiv-Streaks: Erreicht ein Mitglied die eingetragene Tage-Zahl am Stück, gibt es die Punkte einmalig gutgeschrieben. Faustformel: Tage × 20 Punkte. Der Text wird im Level-Up-Kanal gefeiert (Platzhalter {user}, {days}, {aura}, {xp_name}); leer = Standardtext. Bis zu 10 Stufen. Die ersten 5 vergeben zusätzlich ein Streak-Abzeichen. Liste leeren = Streak-Belohnung aus.

Liste mit Spalten: Tage · Punkte · Announce-Text (optional)

Teilnahmerolle (optional)

Leer = alle sammeln Punkte wie bisher. Ist eine Rolle gewählt, sammeln nur ihre Träger neue Punkte und erscheinen in der Season- und Ära-Wertung; die Gesamtwertung zeigt weiterhin alle. Wird die Rolle wieder entzogen, stoppt das Sammeln und die laufende Season- und Ära-Platzierung entfällt — die bereits erreichten Stände bleiben unverändert und in der Gesamtwertung sichtbar. Achtung: wird die gewählte Rolle gelöscht, sammelt niemand mehr.

Gnadentag für Streaks

An = ein einzelner verpasster Tag bricht die Streak nicht (max. 1 Fehltag pro Streak). Aus = jeder verpasste Tag setzt die Streak zurück.

Standard: Aus

Sprach-Punkte begrenzen

Tägliches Zeitlimit für Sprach-Punkte

An = ein Mitglied sammelt pro Tag höchstens so viele qualifizierte Minuten Sprach-Punkte, wie unten eingestellt. Voice und Stage teilen sich dieses Budget; ein Kanalwechsel setzt nichts zurück. Der Tag wechselt um 00:00 UTC. Niemand wird getrennt oder verschoben — es gibt nur keine weiteren Punkte.

Standard: An

Minuten pro Tag

Qualifizierte Sprach-Minuten pro Mitglied und Tag (1–1440). Gezählt werden nur Minuten, die die Teilnahmebedingungen erfüllen. Wichtig: Für die Sprach-Abzeichen läuft die Zeit auch nach dem Limit weiter — gestoppt werden die Punkte, nicht die Zeitmessung.

Standard: 180

Tägliches Punkte-Limit für Sprache

An = ein Mitglied bekommt pro Tag höchstens so viele Sprach-Punkte, wie unten eingestellt — einschließlich aller Multiplikatoren und des Clan-Boosts. Unabhängig vom Zeitlimit: Du kannst beides, eines oder keines benutzen.

Standard: Aus

Punkte pro Tag

Nur wirksam, wenn der Schalter darüber an ist. Erreicht ein Mitglied die Grenze mitten in einer Minute, bekommt es genau den Rest — nicht mehr und nicht nichts.

Standard: 1000

XP-Feintuning

Globales Tempo

Tempo-Regler für den GANZEN Server: ×2 = alle sammeln doppelt so schnell, ×0,5 = halb so schnell. Wirkt auf Nachrichten, Voice und Reaktionen gleichermaßen. Kanal-/Rollen-Faktoren und XP-Events gelten zusätzlich. ×1 = Normal-Tempo.

Standard: 1.0

XP-Faktor pro Kanal (0 = kein XP, 2 = doppelt)

XP-Faktor pro Kanal: 0 = in diesem Kanal gibt es kein XP (z. B. Spam-Kanal), 2 = doppeltes XP. Threads erben den Faktor ihres Eltern-Kanals; nicht gelistete Kanäle zählen normal (Faktor 1).

Liste mit Spalten: Kanal · Faktor

XP-Faktor pro Rolle

XP-Faktor pro Rolle: 0 = kein XP, 2 = doppeltes XP. Hat ein User mehrere gelistete Rollen, zählt nur der höchste Faktor — er wird mit dem Kanal-Faktor multipliziert.

Liste mit Spalten: Rolle · Faktor

Ausnahmen

Ausnahme-Rollen (kein XP, nicht in der Rangliste)

Mitglieder mit einer dieser Rollen (z. B. @Team) sammeln kein XP mehr und tauchen nicht in der Rangliste auf — egal welche Faktoren sonst gelten. Bereits gesammelte Punkte bleiben erhalten; /rank zeigt ihnen weiterhin die eigenen Werte. Tipp: Für Kanäle ohne XP stattdessen oben den Kanal-Faktor auf 0 setzen.

Liste mit Spalten: Rolle

Benennung

Name der Punkte

So heißen deine Fortschrittspunkte überall im Bot — z. B. „Aura“ oder „Pfoten“ statt „XP“. Wirkt in /rank, /leaderboard, der Level-Up-Nachricht und im Web-Dashboard. Leer = Standard „Aura“. (Die Befehlsnamen /rank und /leaderboard bleiben gleich.)

Standard: Aura

Icon der Punkte

Symbol vor der Punktzahl (Standard: Funkel-Sterne). Leer = Standard-Icon.

Standard: ✨

Befehle

Befehl	Beschreibung
/rank	Zeigt deinen Level-Fortschritt.
/leaderboard	Top-Mitglieder nach XP.
/levels reward add 🔒 Team	Rolle bei Erreichen eines Levels vergeben.
/levels reward remove 🔒 Team	Rollen-Belohnung für ein Level entfernen.
/levels reward list 🔒 Team	Alle Level-Rollen-Belohnungen anzeigen.
/levels reward mode 🔒 Team	Modus: stack (sammeln) oder replace (nur höchste).
/levels announce channel 🔒 Team	Kanal für Level-Up-Ankündigungen setzen.
/levels announce off 🔒 Team	Level-Up-Ankündigungen ausschalten.
/levels announce mode 🔒 Team	Wann ankündigen: jedes Level oder nur Rollen-Level.
/levels announce ping 🔒 Team	Den aufsteigenden User anpingen?
/levels announce text 🔒 Team	Ersetzt die Level-Up-Texte durch einen eigenen. Leer = CAT-Texte. {user} {level} {role}
/levels announce status 🔒 Team	Aktuelle Ankündigungs-Einstellungen anzeigen.
/levels noxp add 🔒 Team	Einen Kanal vom XP-Sammeln ausschließen.
/levels noxp remove 🔒 Team	Den XP-Ausschluss eines Kanals aufheben.
/levels multiplier channel 🔒 Team	XP-Faktor für einen Kanal (0 = kein XP, 1 = normal).
/levels multiplier role 🔒 Team	XP-Faktor für eine Rolle (1 = normal/zurücksetzen).
/levels multiplier list 🔒 Team	Alle XP-Faktoren (Kanäle + Rollen) anzeigen.
/levels reactionxp on 🔒 Team	Reaktions-XP aktivieren.
/levels reactionxp off 🔒 Team	Reaktions-XP deaktivieren.
/levels reactionxp status 🔒 Team	Aktuellen Reaktions-XP-Zustand anzeigen.
/levels event start 🔒 Team	Startet ein zeitlich begrenztes XP-Event.
/levels event stop 🔒 Team	Beendet das laufende XP-Event sofort.
/levels event status 🔒 Team	Zeigt das aktuelle XP-Event.
/levels aura set 🔒 Team	Aura eines Mitglieds auf einen genauen Wert setzen.
/levels aura add 🔒 Team	Aura addieren oder abziehen (negativ = abziehen).
/levels aura reset 🔒 Team	Aura eines Mitglieds auf 0 zurücksetzen.
/levels import 🔒 Team	XP von MEE6 importieren (die MEE6-Rangliste muss öffentlich sein).