Skip to content

Leveling

Domekologe edited this page Jun 30, 2026 · 2 revisions

Leveling

🌐 English · Deutsch

Leveling awards XP for chatting, with levels, a leaderboard, rank cards (rendered as an image with a clean embed fallback) and optional level-up role rewards. Opt-in per guild, bilingual (DE/EN), 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

Rank cards use Pillow if it is installed; otherwise an embed is shown instead — no hard dependency.

Commands

Command Type What it does
rank [@member] Hybrid Show your (or someone's) rank card.
leaderboard Hybrid Top 10 members by XP (aliases: levels, top).
xpset enable <on/off> Admin Enable/disable leveling for this server.
xpset cooldown <seconds> Admin Per-member XP cooldown.
xpset xprange <min> <max> Admin XP awarded per message.
xpset announce [#channel] Admin Level-up channel (omit = message's channel).
xpset levelrole <level> [@role] Admin Add/remove a level→role reward.
xpset noxp <#channel> Admin Toggle a channel where no XP is awarded.
xpset language <de-DE|en-US> Admin Output language.

XP curve

A MEE6-like cumulative curve: the XP needed for level n is 5·n² + 50·n + 100. XP is granted once per message, limited by the cooldown, in the configured min–max range. Role rewards can stack or replace lower ones (configurable). The bot needs Manage Roles for role rewards.

Dashboard

Appears under Guild Settings as a Leveling panel: Enabled, Announce level-ups, Level-up channel, Cooldown, XP min/max and Language. Level roles and no-XP channels are managed via the commands.

Clone this wiki locally