The rank card and the leaderboard
/rank
/rank posts a rank card as an image. Run it on its own for your own card, or
pass a member to see theirs.
The card shows the member's avatar and name, their level, their XP inside that level, the XP the level needs, a progress bar, their position in the ranking, and how many messages they have sent on the server.
In Separate mode with voice XP on, the card carries a second track as well: voice level, voice XP and progress, voice rank, and minutes spent in voice. In Sum mode the level shown is text level plus voice level, matching what the announcement and the leaderboard say.
/rank refuses to run when leveling is disabled, and it says so when the
member has never earned anything on either track.
For the card to arrive, the bot needs Embed Links and Attach Files in the channel.
Redesigning the card
The Levels page has a visual card editor under Rank Card Customization. Start from the built-in design or create your own template, then set it active.
A template is a stack of layers you place on a canvas. The layer types are:
| Layer | What it is for |
|---|---|
| Background | Solid colour, gradient or image |
| Text | Text with variables, so it can say the level, the rank, the name |
| Avatar | The member's avatar |
| Image | An overlay: a logo, a badge, artwork |
| Progress bar | An XP bar, or a custom one |
| Shape | Rectangle, circle, line |
| Decoration | Grids, glows, patterns |
| Group | Several layers moved and edited together |
Twenty-four ready-made designs ship with the bot, from Glass and Neon to Luxe, Ocean, Retro and Monochrome, and you can start from any of them instead of a blank canvas. Templates can be duplicated, saved to your personal library so you can reuse them on another server, and deleted.
Two active cards in Separate mode
Servers in Separate mode with voice XP on have two active card slots: the
Text + Voice card, which is what /rank serves, and the single-bar
card, which is used if you switch the mode back to Combined or Sum. The editor
shows a tab for each and marks the one currently in use.
A different card per role
Role-Based Rank Cards assigns a different template to members holding a given role. The list is ordered, and the first matching role from the top wins, so put your most exclusive role first. Members with none of the listed roles get the server default.
| Tier | Role-based cards |
|---|---|
| Free | 1 |
| Silver | 5 |
| Gold | 10 |
| Platinum | 25 |
The leaderboard
/leaderboard (or lb) does not post a ranking in chat. It replies with a
button that opens the ranking for your server on the FlaviBot website.
The web ranking pages 100 members at a time and shows, next to each member, their level, their progress and their message count. It also carries a summary for the whole server: total XP, average level, total messages, how many members are ranked, and a seven-day activity chart. Members who have left the server keep their place and are flagged as gone rather than disappearing.
In Separate mode the page has a switch between the text and voice rankings, since they are two different competitions. In Sum mode the ranking is by the combined level.
Opening the ranking requires signing in with Discord.
Making it public, or not
Online Leaderboard on the Levels page controls whether the web ranking answers for your server at all. It is on by default. Turn it off and the page tells visitors the server has hidden its leaderboard. Disabling the whole level system hides it too.
Deeper statistics
The ranking is a scoreboard, not an analysis. For XP and level trends over time, the Server Stats page has an XP tab, reachable from the View level stats button at the top of the Levels page.
