The Economy module
The Economy module gives your server a currency, ways to earn it, and things to spend it on. It works in three parts: earnings, the shop, and what links them — the leaderboard.
Updated 12 September 2026
Earnings: how currency enters the server
Nothing gets spent if there is nothing to earn. The module offers several sources, which stack and are configured independently from the dashboard.
- Text earnings: an amount per message, with a minimum delay between gains so one-word spam earns nothing.
- Voice earnings: an amount per period spent in voice. Essential on a server whose life happens in voice, otherwise the leaderboard only reflects the talkative.
- Multiplier roles: a role that multiplies its holder’s earnings. Rewards boosters, subscribers or veterans without creating a second currency.
- Cross-module branches: other modules can pay out — join bonus, event reward, handled report. That is what keeps the economy from staying a side game.
Set earnings BEFORE opening the shop. A currency whose flow you do not know produces invented prices you will have to redo — and lowering a price is easy, raising it reads as a betrayal.
The shop: what people buy
The shop takes two kinds of item, and the difference matters.
A role is granted on purchase and stays. It is the simplest and most requested item: name colour, channel access, status badge.
An item goes into the member’s inventory. It does nothing on its own — it is a token that you, or another module, use afterwards: a raffle ticket, a right to a request, something to trade with other members.
- Start with two or three items, not fifteen. A fully stocked shop on day one does not get read.
- For a role, check it carries no sensitive permission: it is for sale, so anyone can get it.
- Check the Kuratos role sits above the roles being sold, otherwise the purchase fails at payment.
- Decide what is limited — in stock or in time. A permanent unlimited item loses all interest once everyone owns it.
The currency: name and emoji
The currency name and emoji are customisable. That is not cosmetic: a currency named after your server gets adopted, one called “credits” stays a bot mechanic.
The emoji appears everywhere — balances, shop, leaderboard, earning messages. Pick one that stays legible when small, and that is not already used by a role or a channel category.
The balance leaderboard
The balance leaderboard is visible in Discord and on your server’s public page. It doubles as the economy’s dashboard: an average balance that only ever rises means earnings far exceed spending, so the shop no longer offers anything worth having.
It is the module’s most useful signal. When it appears, add or limit items — do not cut earnings.
Key points
- Set earnings before opening the shop: with no known flow, prices are invented.
- A role for sale can be bought by anyone: no sensitive permission on it.
- The Kuratos role must sit above the roles sold, or the purchase fails.
- Voice earnings stop the leaderboard rewarding only the talkative.
- An ever-rising average balance means the shop has nothing left to offer.
Frequently asked questions
Why does buying a role fail?
The role sold sits above the Kuratos role in the server role list. Discord then refuses the grant, whatever permissions the bot holds.
What is the difference between a role and an item in the shop?
A role is granted immediately and shows on the profile. An item goes to the inventory and does nothing alone: it is a token for a member trade, an event, or a request to staff.
Can the currency name be changed later?
Yes, name and emoji can be changed at any time from the dashboard; existing balances are untouched.
Put this guide into practice
Kuratos sets up in minutes what this guide describes, and is configured from a web interface rather than through commands.