ModiQDocs

Level

XP und Level durch Nachrichten — inklusive Level-Rollen, Voice-Coins und anpassbarer Rangkarte.

Das Level-System vergibt XP, während Mitglieder schreiben; aus genug XP wird eine neue Stufe. Im Dashboard stellst du den XP-Bereich pro Nachricht, den Cooldown und einen Level-Up-Kanal ein, vergibst Level-Rollen und gestaltest die Rangkarte. Voice-Coins belohnen Zeit in Sprachkanälen. Alles läuft über Discord-Befehle wie `/rank` und `/leaderboard`. (level)

Bild folgt

Das Dashboard mit geöffnetem Tab „Level“: links die Modulliste, rechts die Einstellungen mit Speichern-Knopf.

Nur die Seite selbst zeigen – ohne Browserleiste, ohne persönliche Daten.

public/docs-assets/modules/level.png · 1600x900 · dunkles Design

Wie XP zu Leveln werden

XP entstehen beim Schreiben. Jede Nachricht, die den Cooldown passiert, bringt dem Mitglied einen zufälligen Betrag; aktive XP-Booster multiplizieren diesen Wert. Ab 20 XP ist Level 1 erreicht, und mit jedem weiteren Level steigt die insgesamt benötigte XP-Menge um rund 10 %. Angezeigt wird bis Level 100.

  • Der Cooldown gilt pro Mitglied, nicht pro Kanal: Wer schnell hintereinander schreibt, bekommt nur einmal XP.
  • Einen Level-Up meldet der Bot im eingestellten Kanal; ist kein Kanal gewählt, erscheint die Meldung dort, wo geschrieben wurde.
  • Das Dashboard zeigt die Rangliste als Top 10; der Befehl /leaderboard listet bis zu 25 Einträge.

Level-Rollen

Jeder Eintrag verbindet eine Stufe mit einer Rolle. Erreicht ein Mitglied genau die eingetragene Stufe, vergibt der Bot die passende Rolle automatisch — sofern das Mitglied sie noch nicht besitzt.

Rollen werden nicht zurückgenommen

Die Vergabe ist eine Einbahnstraße: Bei einem Aufstieg nimmt der Bot keine früher vergebene Level-Rolle wieder weg. Soll jemand eine Rolle wieder verlieren, musst du sie manuell entziehen.

Voice-Coins

Voice-Coins sind ein eigener Zähler neben den XP: Sie wachsen mit der Zeit in Sprachkanälen, nicht mit Nachrichten, und werden getrennt gespeichert. Pro Minute gibt es den eingestellten Betrag; Kanäle in der Ausschlussliste zählen nicht mit.

  • Die Voice-Coins-Einstellungen liegen in einem eigenen Unterbereich des Tabs und werden dort direkt gespeichert.
  • Für Voice-Coins gibt es eigene Befehle wie /voicecoins und /voicetop.

Befehle

/rankuser?

Zeigt dir deinen Rang an.

/leaderboardanzahl?

Zeigt die XP-Rangliste des Servers

/givexpbenutzer mengeAdministrator

Vergibt XP an einen Benutzer (nur Admin)

/rankcardbackground? color? reset? preview?

Passe deine Rangkarte an

/voicecoinsuser?

Zeigt die Voicecoins eines Benutzers an

/voicetoplimit?

Zeigt die Top-Benutzer nach Voicecoins an

Einstellungen im Dashboard

EinstellungTypBedeutung
Modul Level-System aktivlevelEnabledSchalterSchaltet das Level-System ein oder aus. Bei ausgeschaltetem Modul sind die Einstellungen nicht bearbeitbar.
XP MinlevelXpMinZahlUntere Grenze der XP, die eine Nachricht bringt. Erlaubt sind 1–50. Standard: 2.Standard: 2
XP MaxlevelXpMaxZahlObere Grenze der XP, die eine Nachricht bringt. Erlaubt sind 1–50. Standard: 4.Standard: 4
Cooldown (s)levelXpCooldownMsZahlWartezeit pro Mitglied, bevor erneut XP vergeben wird. Das Feld erwartet Sekunden (0–120); gespeichert wird der Wert in Millisekunden. Standard: 3000 ms, also 3 Sekunden.Standard: 3 (3000 ms)
Level-Up-Kanal (leer = gleicher Kanal)levelUpChannelKanalKanal, in dem der Bot einen Level-Aufstieg meldet. Bleibt das Feld leer, erscheint die Meldung im Kanal, in dem geschrieben wurde. Zur Auswahl stehen Text- und Ankündigungskanäle.
Level-RollenlevelRolesRolleListe aus Stufe und Rolle: Beim Erreichen einer Stufe (1–1000) vergibt der Bot die zugehörige Rolle automatisch.
Voice-CoinsvoiceCoinsEnabledSchalterSchaltet die Voice-Coins ein oder aus. Sie werden getrennt von den XP über die Voicecoins-Einstellungen gespeichert.Standard: Aktiv
Coins/MinvoiceCoinsPerMinuteZahlWie viele Voice-Coins pro Minute in einem Sprachkanal vergeben werden. Erlaubt sind 0–100 (Schrittweite 0,1). Standard: 0,5.Standard: 0,5
Ausgeschlossene Voice-KanälevoiceCoinsExcludedChannelIdsKanalSprachkanäle, in denen keine Voice-Coins verdient werden.

Stolperfallen

  • XP Min und XP Max sind auf 1–50 begrenzt; der tatsächliche XP-Wert pro Nachricht wird zufällig aus diesem Bereich gewählt.
  • Der Cooldown gilt pro Mitglied und wird in Sekunden eingegeben, aber in Millisekunden gespeichert.
  • Rangkarten-Hintergründe: bis zu 8 Bilder pro Server, maximal 4 MB pro Bild, Formate png, jpg, webp oder gif.
  • Der Befehl /leaderboard zeigt bis zu 25 Einträge; die Rangliste im Dashboard zeigt die Top 10.

Siehe auch

ActiveBox
ZurückAutoClearWeiterUmfragen