Level und XP verwalten: Befehle, Multiplikatoren und Season-Reset

Diese Seite beschreibt die Werkzeuge, mit denen du das Level-System im laufenden Betrieb steuerst: XP von Hand vergeben oder abziehen, XP mit Multiplikatoren beschleunigen, ein Erklär-Embed posten und am Ende einer Saison alle XP zurücksetzen. Die Quellen der XP stehen in Level und XP: Quellen, Limits und Schutz vor Farming, die Ränge und Level in Ränge, Level und Belohnungen.

Voraussetzungen

• Modul eingeschaltet: „Rang-/EXP-System aktiv“ muss an sein. Die Befehle add, remove, event und recalculate-roles antworten sonst, dass das System nicht aktiv ist.
• Recht für die Admin-Befehle: Die Befehle der Gruppe /rank-xp sind standardmäßig nur für Mitglieder mit dem Recht Server verwalten sichtbar und nutzbar. Unter *Servereinstellungen → Integrationen* kannst du das in Discord anpassen.
• Season-Reset: Nur echte Server-Admins (Discord-Recht Server verwalten) dürfen ihn ausführen, ein einzeln freigegebener Modulzugriff reicht dafür nicht.

Befehle für Mitglieder

Admin-Befehle

Alle Antworten sehen nur du selbst (ephemer). Vergaben laufen durch dieselbe Verarbeitung wie normale XP: Rang- und Level-Rollen, Belohnungen und Nachrichten greifen also ganz normal.

Bei Admin-Vergaben gilt:

• Sie werden nicht multipliziert und nicht von Ausnahme-Rollen blockiert.
• add und remove sind im Verlauf als Quelle „Admin“ gespeichert, event als „Event“.
• Das Event-EXP-Angebot pflegst du im Dashboard im Event-EXP-Katalog (Schlüssel, Anzeigename, Betrag). Voreingestellt sind Eventteilnahme 25, Besonderes Event 50 und Event gewonnen 100.

Zurücksetzen eines Mitglieds

/rank-xp reset fragt zuerst nach. Nur die Person, die den Befehl ausgeführt hat, kann die Schaltfläche bestätigen, und die Anfrage läuft nach 60 Sekunden ab. Der Reset:

• setzt Gesamt-XP, alle Quellen-Summen, Level, Rang-Zwischenspeicher und die Tagesbonus-Serie auf 0,
• schreibt den alten Stand als Admin-Eintrag in den Verlauf,
• berührt keine Discord-Rollen und nicht den Newcomer-Status. Passe Rollen bei Bedarf mit /rank-xp recalculate-roles an oder entferne sie von Hand.

/rank-xp recalculate-roles richtet sich nur nach den XP und prüft keine Newcomer-Bedingungen. Bei 0 XP gilt mit den Standardschwellen die Stufe Member.

Multiplikatoren

Mit Multiplikatoren belohnst du ausgewählte Rollen, Kanäle oder Zeiträume mit mehr XP, oder sperrst sie weich mit dem Faktor 0. Sie gelten nur für die passiven Quellen: Nachrichten, Reaktionen und Voice. Tagesbonus, Server-Boost, Events und Admin-Vergaben werden nie multipliziert.

Reihenfolge der Berechnung

Kage bestimmt den Betrag in dieser Reihenfolge:

1. Basiswert: der gewürfelte Betrag zwischen Minimum und Maximum, oder der feste Betrag eines Kanal-Overrides.
2. Rollen-Multiplikator: Trifft mehr als eine Rolle des Mitglieds zu, gewinnt die höchste. Die Faktoren werden nicht addiert.
3. Kanal-Multiplikator: Der Faktor des Kanal-Overrides (bei Voice des Sprachkanals).
4. Zeitfenster: Alle gerade aktiven Fenster, die sich überschneiden dürfen, werden alle multipliziert.
5. Globaler Dauer-Multiplikator: gilt immer, Standard 1.

Die Faktoren werden multipliziert und der Betrag danach gerundet. Ergibt sich 0, gibt es keine XP. Erst danach greift das Tageslimit: Es zählt den Betrag nach der Multiplikation.

Einstellungen

Wichtige Hinweise zu Zeitfenstern:

• Start und Ende sind Pflicht, die Zeiten gelten als UTC.
• Optional schränkst du ein Fenster auf Wochentage ein (Montag bis Sonntag, ebenfalls nach UTC). Ohne Auswahl gilt es jeden Tag im Zeitraum.
• Abgelaufene Fenster zeigt /level-info nicht mehr, kommende mit ihrem Zeitraum.

/level-info zeigt Mitgliedern die aktiven Boni, solange sie größer als 1 sind. Ausschlüsse mit Faktor 0 sind für Mitglieder kein Bonus und werden nicht gezeigt.

Das Erklär-Embed

Im Dashboard postet Erklär-Embed posten eine fertige Nachricht in einen Kanal deiner Wahl, die live aus deinen Einstellungen erklärt, wie und wie viel XP man womit verdient: Nachrichten, Reaktionen, Voice, Tagesbonus, Boost, Events, Boni und Ränge.

1. Wähle unter Info-Panel-Kanal den Zielkanal und klicke Jetzt posten.
2. Kage speichert die Nachricht. Sobald du die Einstellungen speicherst, aktualisiert Kage die Nachricht automatisch. Du musst nicht neu posten.
3. Wählst du denselben Kanal erneut, wird die vorhandene Nachricht aktualisiert statt eine zweite zu posten. Wurde sie gelöscht, postest du sie hier neu.

Kage braucht im Kanal Nachrichten senden und Links einbetten.

Season-Reset

Der Season-Reset setzt die XP aller Mitglieder auf 0, wie ein Neustart nach einer Saison. Du findest ihn im Dashboard unter Level & XP im Bereich Season-Reset.

Ablauf

1. Vorschau: Das Dashboard zeigt, wie viele Mitglieder XP haben und wie viel XP es zusammen sind.
2. Sichern (empfohlen): Rangliste als CSV sichern lädt alle Mitglieder mit XP als Datei herunter, mit Rang, Level, Quellen-Summen und den Namen der ersten 200 Plätze.
3. Rang-Rollen (optional): Mit Rang-Rollen aller Mitglieder zurücksetzen auf wählst du eine Stufe. Wer aktuell eine Rang-Rolle trägt, behält danach in Discord nur die Rolle dieser Stufe, alle anderen Rang-Rollen werden entzogen. Hat die gewählte Stufe keine Rolle, werden nur Rollen entzogen. Ohne diese Option behalten alle ihre bisherigen Rang-Rollen.
4. Bestätigen: Tippe RESET ein und starte den Reset.

Was zurückgesetzt wird und was bleibt

Wählst du bei den Rang-Rollen die Stufe Newcomer, beginnt die Newcomer-Phase für alle von vorn: Der Newcomer-Status und der Fortschritt werden dann ebenfalls zurückgesetzt.

Der Rollenabgleich läuft im Hintergrund und schont die Discord-Ratenlimits, deshalb kann er bei großen Servern dauern. Das Ergebnis steht im Reiter Logs („Season-Reset: … Rang-Rollen-Änderungen bei … Mitgliedern“).

Ergebnis überprüfen

1. Vergabe: /rank-xp history zeigt die Buchung mit Quelle „Admin“ oder „Event“ und deinem Grund.
2. Stand: /level für das betroffene Mitglied.
3. Multiplikator: Prüfe /level-info, ob der Bonus mit der erwarteten Zeitspanne erscheint.
4. Season-Reset: Die Vorschau im Dashboard zeigt danach 0 Mitglieder mit XP, und der Reiter Logs enthält den Reset.

Fehlerbehebung

Die Befehle /rank-xp sind nicht sichtbar

Du brauchst das Recht Server verwalten. Prüfe außerdem unter *Servereinstellungen → Integrationen*, ob der Befehl für deine Rolle eingeschränkt wurde, und dass Kage auf dem Server eingeladen ist.

Der Befehl meldet, das System sei nicht aktiv

„Rang-/EXP-System aktiv“ ist aus oder nicht gespeichert.

Ein Event-Typ erscheint nicht in der Liste

Er steht nicht im Event-EXP-Katalog oder ist dort ohne Schlüssel angelegt. Das Dashboard verlangt für jeden Eintrag Schlüssel und Bezeichnung und lehnt doppelte Schlüssel ab. Die Liste zeigt höchstens 25 Einträge.

Der Multiplikator wirkt nicht

Prüfe, ob die Quelle passiv ist (Nachricht, Reaktion, Voice). Prüfe bei Zeitfenstern Start, Ende und Wochentage, denn alles gilt in UTC. Bei mehreren Rollen gewinnt die höchste, es wird nicht addiert. Ein Wert unter 1 verringert die XP, ein Kanal-Override mit „Komplett keine EXP“ sperrt den Kanal ganz.

Mitglieder bekommen weniger XP als erwartet

Der Betrag wird nach der Multiplikation vom Tageslimit begrenzt. Prüfe außerdem Cooldown, Mindestlänge und Ausnahmen aus Level und XP: Quellen, Limits und Schutz vor Farming.

Das Erklär-Embed aktualisiert sich nicht

Die Nachricht wurde gelöscht oder Kage hat im Kanal keine Rechte mehr. Poste sie im Dashboard neu.

Beim Season-Reset ändern sich die Rollen nicht

Die Option Rang-Rollen aller Mitglieder zurücksetzen auf war nicht gewählt, oder Kage darf die Rollen wegen der Rollenreihenfolge nicht ändern. Fehler zählt der Eintrag im Reiter Logs mit.

Weiterführend

Quellen und Limits der XP: Level und XP: Quellen, Limits und Schutz vor Farming. Ränge, Level und Belohnungsrollen: Ränge, Level und Belohnungen. Die Rangliste im Detail steht im Ratgeber XP-Rangliste.