Leveling

Leveling

🌐 English · Deutsch

Leveling is a MEE6-style XP system: members earn XP for messages (random amount with a cooldown) and for voice activity (once per minute), climb levels on the MEE6 curve and can be granted role rewards. Includes a paginated leaderboard and configurable level-up announcements. Bilingual (DE/EN), opt-in per guild, with Web Dashboard integration. Author: pd-codes · requires Red 3.5.0+ · Status: Alpha 0.1.0.

Installation

[p]repo add PDC https://github.com/pd-codes/PDC_Redbot_Cogs
[p]cog install PDC leveling
[p]load leveling
[p]slash sync

Enable it per server: [p]levelset enable true.

Commands

All commands are hybrid (prefix + slash). level has the aliases rank and xp; levelset has the alias lvlset.

Member commands

Command	What it does
level show [member] (aliases card, me)	Rank card embed: level, rank position, XP and a progress bar.
level leaderboard (aliases lb, top)	Paginated server leaderboard (10 per page).

Admin commands (levelset, requires Manage Server)

Command	What it does
levelset enable <on/off>	Enable/disable the module (off by default).
levelset xp <min> <max>	XP range per counted message (0–1000).
levelset cooldown <seconds>	Per-member message cooldown, 0–3600 s (default 60).
levelset voicexp <amount>	XP per minute in voice, 0 disables voice XP (default 5).
levelset voiceignore <muted> <deafened> <alone>	Exclude muted/deafened/lone members from voice XP.
levelset announce <off|current|channel> [#channel]	Level-up announcement mode (same channel or a fixed one).
levelset message <text>	Announcement template — {member} and {level} are replaced.
levelset reward add/remove/list	Level → role rewards.
levelset stack <on/off>	Stack reward roles or keep only the highest.
levelset noxp channel <channel> · levelset noxp role <role>	Toggle no-XP channels/roles.
levelset addxp/removexp <member> <amount>	Grant or remove XP manually.
levelset setlevel <member> <level>	Set a level directly (XP is set to the level floor).
levelset reset [member]	Reset one member — or the whole server — with button confirmation.
levelset language <de-DE|en-US> · levelset settings	Language / settings overview.

How it works

Each counted message grants a random amount of XP (default 15–25) with a per-member cooldown (default 60 s). A background loop awards voice XP once per minute to members in voice channels — the AFK channel never counts, and muted, deafened or lone members can be excluded. Levels follow the MEE6 curve (5·L² + 50·L + 100 XP per level). On level-up the bot announces it (same channel, fixed channel, or off) and syncs role rewards — stacked, or replace-mode where only the highest earned role is kept. Removing XP lowers the level and re-syncs the roles. No-XP channels/roles are excluded from both message and voice XP.

Dashboard

• Under Guild Settings, a Leveling panel (admin) with all settings: enabled, XP range, cooldown, voice XP + ignore switches, announcement mode/channel/message, role stacking and language.
• A guild-scoped Leaderboard page (any member) with a table of the top members (rank, member, level, XP).