Levels and economy
This module covers two systems that are built to work together but are configured, enabled and used separately.
Levels turn activity into progress. Members earn XP for talking and for sitting in voice channels, XP becomes levels, and levels can hand out roles, post an announcement, fill a rank card and rank everyone on a leaderboard.
Economy is a per-server currency. Members hold a balance, earn coins from the sources you switch on, and spend them in a shop you write yourself.
Neither is on by default, and neither needs the other. You can run levels with no economy, an economy with no levels, or wire them together (paying coins on every level-up is one of the earning rules).
Where each one lives
| System | Dashboard page | Commands |
|---|---|---|
| Levels | Levels | /rank, /leaderboard, /xp |
| Economy | Economy | /economy, /casino |
The Levels page has one master switch at the top (Enable Level System). The Economy page has its own (Enable the economy). Until the switch is on, the bot ignores the feature entirely and its commands refuse to run.
The economy is a limited rollout
The economy is still being rolled out server by server. On a server that has
not been enrolled, /economy replies with a short beta notice pointing at the
support server instead of running, and the Economy page is hidden from the
dashboard menu. Levels have no such gate and are available everywhere.
What members can run
| Command | Who can run it | What it does |
|---|---|---|
/rank [user] | everyone | Posts the rank card for you or someone else |
/leaderboard (alias lb) | everyone | Links to the web leaderboard for this server |
/xp add|remove|set|reset | Manage Server | Edits a member's XP directly |
/economy ... | everyone (the admin group needs Manage Server) | Balance, earning, shop, items, trading |
/casino ... | everyone, when the casino is enabled | Wager games against the server currency |
/rank needs the bot to have Embed Links and Attach Files in the
channel it answers in, because the card is an image. /leaderboard needs
Embed Links.
One bot owns the numbers
If you run FlaviBot alongside a custom bot, only one of them processes XP for your server. That bot is set every time the Levels page is saved: saving from a given bot's dashboard makes that bot the one that grants XP, posts level-up announcements and gives out reward roles. The other bot simply stops counting.
The economy works differently: it is stored per bot. Each bot has its own currency settings, its own shop and its own balances, so switching the dashboard from one bot to another shows a completely separate economy rather than the same one.
Where to go next
- How XP is earned covers messages, voice, the cooldown, multipliers and channel restrictions.
- Levels and role rewards explains the level curve and how roles are handed out.
- Level-up announcements is the message members actually see.
- The rank card and the leaderboard
covers
/rank, the card editor and the public ranking. - Currency and balances, Earning coins and The shop, items and trading cover the economy.
