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.
Levels and the economy work together
Both are available on every server, and each one works without the other. When both are on, the economy can pay members for the XP they earn and for every level they reach: see the Earning tab of the Economy page.
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 menu, /casino ... | everyone, when the casino is enabled | Wager games against the server currency |
/casino trivia | everyone, when trivia is enabled | Trivia: answer the server's questions to earn |
/economy quests | everyone, when the server has quests | Quests: your goals and the rewards to claim |
/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 belongs to the server, not to a bot. FlaviBot and a custom bot share one currency, one shop and the same balances, so switching the dashboard from one bot to another shows the same economy.
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, The shop, items and trading, Trivia and Quests cover the economy.
