Rank Card & Public Leaderboard

Turn your server's leveling into something members actually want to show off: /rank and /leaderboard now come with a polished image card, and you can publish a public web leaderboard anyone can open, no Discord login required.

🎴 The rank card

When a member runs /rank (or /rank @someone), the reply includes a generated image showing their avatar, rank, level, prestige, an XP progress bar, their title and streak.

The image sits alongside the usual details, total XP, active XP boosts, and everything else stays in the message, so you never lose information. /leaderboard works the same way: a card image plus the full ranked list (the image shows the same page you're viewing).

If image generation ever fails, the command still replies with the full text details, /rank always works.

🎨 Customising the card

Open Levels → Rank Card in the panel:

• Theme: pick a ready-made look: Halloween, Christmas, Valentine, Neon, Summer or Winter. A theme paints its own decorated background and accent (it overrides the background image). Choose None to use your own accent + background instead.
• Accent color: sets the avatar ring, progress bar and background gradient. Defaults to Discord blurple.
• Background image: upload your own JPG or PNG (up to 4 MB). Leave it empty to use an accent-color gradient.

A live preview updates as you change the theme, accent or background, so you see the card before saving.

Changes apply within a few minutes (the bot refreshes its configuration on a short cycle, the panel shows a small countdown).

🌍 Public web leaderboard

Want to share your ranking outside Discord? Turn on Public web leaderboard in Levels → Rank Card.

• Off by default: nothing is published until you explicitly enable it.
• Once on, you get a shareable link (/leaderboard/your-server) that anyone can open in a browser, no login needed.
• The page lists your top 100 members with avatars, levels, XP, prestige and streaks.
• It's search-engine indexable, so your community can find it on Google.

Only usernames and avatars already visible on Discord are shown. Turning the toggle off takes the page offline again immediately.

⬇️ Exporting the leaderboard

The Levels → Leaderboard page offers two exports:

• ↓ CSV Export - a spreadsheet, one row per member.
• ↓ JSON Export - the leaderboard in the exact shape the import reads back in. Keep it as a backup, or move a leaderboard between servers, and it restores as-is.

✏️ Adjusting a member's XP

On Levels → Leaderboard, the Adjust button of a member opens Adjust XP with a Mode and a Value:

• Add XP and Remove XP - change the member's XP by that amount (never below 0).
• Set XP - put the member at exactly that XP.
• Set Level - put the member at the start of that level.

The level is recalculated from the new XP, and respects your level cap. The change is recorded in the Audit Log.

Any change that raises the member's XP behaves like a normal award: the level-up announcement is posted and the reward graph fires for every level crossed and every XP threshold reached. Removing XP, or setting a lower value, is silent. The member must already be on the leaderboard.

📱 On a phone

The leaderboard stacks into cards on a narrow screen instead of a cramped table - one card per member, with Adjust and Reset still reachable from it.

A member's streak is shown as a number of days, written in the language you read the panel in ("5 days", "5 jours").

⌨️ Commands

• /rank [@user]: the rank card for you or another member
• /leaderboard [page] - the ranking, ten members per page (pick the page with the optional page option), with the image of that page
• /top: today's top XP earner