Leveling
XP-basiertes Aktivitätssystem mit Level-Belohnungen
Das Leveling-Modul belohnt aktive Mitglieder mit Erfahrungspunkten (XP) für Textnachrichten und Zeit in Voice-Channels. Mit steigendem Level schalten User individuelle Rollen frei. Streaks belohnen tägliche Aktivität, Multiplier heben besondere Events oder Channels hervor.
Einrichten
- Leveling-Modul im Dashboard aktivieren
- Ansage-Modus wählen (im selben Channel, dedizierter Channel, DM oder beides)
- Optional: Ansage-Template anpassen und Rank-Card aktivieren
- Rollen-Belohnungen anlegen: Level-Schwelle + Rolle(n) zuweisen
- Optional: No-XP-Channels oder No-XP-Rollen konfigurieren
- Speichern
XP-Raten
| Quelle | Menge | Limit |
|---|---|---|
| Textnachricht | 15–25 XP (zufällig) | 1× pro 60 Sekunden pro User |
| Voice-Minute | 5 XP | 1× pro Minute (Heartbeat alle 60 s) |
| Mindestlänge Nachricht | — | 3 Zeichen (kürzere Nachrichten geben kein XP) |
Level-Kurve
TeraOne verwendet die MEE6-kompatible Formel. Die XP, die benötigt werden, um von Level n auf n+1 aufzusteigen (span), berechnen sich als:
span(n) = 5n² + 50n + 100Gesamtes XP für ausgewählte Level (kumuliert):
| Level | Gesamt-XP benötigt |
|---|---|
| 1 | 100 |
| 5 | 1.075 |
| 10 | 4.550 |
| 20 | 25.550 |
| 50 | 206.550 |
| 100 | 1.671.550 |
Daily Streaks
Wer mindestens einmal täglich eine Nachricht schreibt, baut einen Streak auf. Bei einem Streak-Meilenstein gibt es einen einmaligen Bonus-XP-Schub zusätzlich zum täglichen Streak-Bonus.
Täglicher Streak-Bonus: +10 XP pro Streak-Tag
Freebie: Einmal alle 30 Tage darf ein Tag ohne Aktivität überbrückt werden, ohne den Streak zu brechen.
| Streak-Tage | Einmaliger Meilenstein-Bonus |
|---|---|
| 3 Tage | +50 XP |
| 7 Tage | +100 XP |
| 14 Tage | +200 XP |
| 30 Tage | +500 XP |
Multiplier
Multiplier verändern die Basis-XP für bestimmte Channel, Rollen oder zeitlich begrenzte Events. Der Gesamtmultiplier ist auf 125× begrenzt. Mehrere Multiplier werden multipliziert, nicht addiert.
| Typ | Ziel | Bereich |
|---|---|---|
| Channel | Einzelner Kanal | 0,1× – 5× |
| Rolle | User mit Rolle | 0,1× – 5× |
| Event | Zeitraum mit Endzeit | 0,1× – 5× |
XP-Ausschlüsse
Mit No-XP-Channels und No-XP-Rollen kannst du bestimmte Bereiche vom XP-System ausnehmen. Nützlich für Bot-Spam-Channels oder Admin-Rollen, die keine unfairen XP sammeln sollen.
Ansage-Modi
| Modus | Beschreibung |
|---|---|
off | Kein Level-Up-Post — XP werden trotzdem vergeben |
same_channel | Level-Up-Nachricht im selben Channel, in dem geschrieben wurde |
dedicated_channel | Alle Level-Up-Posts in einem dedizierten Kanal |
dm | Level-Up-Benachrichtigung per Direktnachricht |
both_dedicated_and_dm | Sowohl dedizierter Channel als auch DM |
Ansage-Template
Der Standard-Text lautet: 🎉 {user_mention} hat Level {level} erreicht! — er kann frei angepasst werden.
| Variable | Inhalt |
|---|---|
{user_mention} | Erwähnung des Users |
{user} | Username ohne Erwähnung |
{level} | Neues Level |
{old_level} | Vorheriges Level |
{xp_total} | Gesamtes XP des Users |
{rank} | Aktueller Rang auf dem Leaderboard |
{rolereward} | Name der freigeschalteten Rollen-Belohnung (falls vorhanden) |
Rollen-Belohnungen
Rollen-Belohnungen werden beim Erreichen eines Level-Schwellenwerts automatisch vergeben. Jede Belohnung kann bis zu 3 Rollen gleichzeitig umfassen. Maximal 50 Belohnungen pro Server.
Stapel-Modus: User behalten alle bisher gewonnenen Rollen (Standard). Im Single-Modus wird immer nur die aktuell passende Belohnung vergeben und ältere werden wieder entzogen.
Pausenbedingungen
XP können für bestimmte Zustände automatisch pausiert werden:
- Discord-Timeout: Wenn ein User per Discord-Timeout stummgeschaltet ist, sammelt er kein XP (konfigurierbar).
- Quarantäne: Wenn das Anti-Alt-Modul einen User quarantäniert, sammelt er kein XP (konfigurierbar).
Slash-Commands
/rank [@User] — Zeigt die Rank-Card des eigenen Users oder eines anderen Members/leaderboard — Zeigt das Server-Leaderboard (Top 10)/streak — Zeigt deinen aktuellen Streak und Meilensteine/xp give <@User> <Menge> — Admin: Gibt XP manuell/xp remove <@User> <Menge> — Admin: Entzieht XP/xp set <@User> <Menge> — Admin: Setzt XP auf exakten Wert/xp reset <@User> — Admin: Setzt alle XP des Users auf 0Fehlersuche
- User erhält kein XP beim Schreiben
- Prüfe: (1) Modul aktiviert? (2) Channel in der No-XP-Channel-Liste? (3) User hat eine No-XP-Rolle? (4) Cooldown abgelaufen (60 s)? (5) Nachricht kürzer als 3 Zeichen?
- Level-Up-Nachricht erscheint nicht
- Prüfe den Ansage-Modus und ob der Bot Schreibrechte im Ziel-Channel hat. Bei "same_channel" braucht der Bot Schreibrechte in jedem Channel, in dem User schreiben.
- Rollen-Belohnung wird nicht vergeben
- TeraOne-Rolle muss in der Hierarchie über der Belohnungsrolle stehen. Prüfe außerdem, ob der User tatsächlich das nötige Level erreicht hat.
Häufige Fragen
- Wird XP auch für Bot-Nachrichten vergeben?
- Nein. TeraOne ignoriert alle Nachrichten von Bots (also auch von sich selbst).
- Kann ich XP-Stände von MEE6 importieren?
- Die Level-Formel ist identisch mit MEE6 — du kannst XP-Werte direkt übertragen und das Level stimmt überein.
- Was passiert mit dem Streak, wenn ich einen Tag verpasst habe?
- Einmal alle 30 Tage gibt es ein Freebie: Einen verpassten Tag kannst du überbrücken, ohne den Streak zu verlieren. Bei zwei oder mehr verpassten Tagen bricht der Streak und beginnt bei 1.
- Kann ein User sein Leaderboard-Profil ausblenden?
- Ja, User können ihre Sichtbarkeit im Leaderboard über Servereinstellungen → Datenschutz deaktivieren.