Economy

Create a virtual economy on your Discord server with DraftBot! Let your members earn money, buy items in custom shops and check their wealth in the leaderboards.

Checking your money

To check your own balance, use the /money command.

Card returned by the /money command
Card returned by the /money command

To check another member's balance, add their mention as an argument to the /money command.

Commands

Several handy commands make the economy system as smooth as possible for you.

CommandDescription
/dailyClaims your daily amount.
/moneyDisplays how much money you, or another member, have.
/payGives some of your money to the targeted member.
/shopDisplays the server shop.
/topmoneyDisplays the member leaderboard.
/dropmoneyCreates a message that grants an amount of money to the first person who clicks the button.

Administrators also have the /adminmoney commands to manage members' money. See the Managing members' money section.

Shop

The shop, accessible through the /shop command, lets your members buy articles you have set up!

Shop interface
Shop interface
  • Pagination: articles are displayed in pages of up to 5 articles
  • Article sorting: 5 sorting options are available (creation date, ascending price, descending price, alphabetical name, type)
  • Shop selection: if several shops exist, a selection menu is displayed automatically
  • Secure purchase: confirmation is required before every purchase
TypeDescriptionExample
RoleGrants a Discord role"VIP" role for 5000 💰
Temporary roleGrants a role for a limited time"Boost 7 days" role for 2000 💰
ExperienceXP points from the level system1000 XP for 500 💰
Inventory itemOne or more inventory items3x "Luck potion" for 1500 💰
Custom articleA reward you hand out yourselfPromo code, physical goodies, etc.

You can have 1 shop containing up to 10 articles. Premium <:icon_premium:1096140508625125417> servers can have 5 shops with 500 articles in each.

If you have set up several shops, your members can switch between them easily through the dropdown menu at the bottom of the interface!

Earning money

Money can be earned in various ways on your server. You have full control over how and where your members build up their wealth.

Money per message

The main way to earn money is written participation on the server. Each message grants a random amount of money between two values you configure (15 to 25 💰 by default).

A cooldown (30 seconds by default, configurable) applies between each money gain for the same member, to prevent spamming very short messages.

Premium <:icon_premium:1096140508625125417> servers can customize this interval independently of the voice one.

Money in voice

Premium <:icon_premium:1096140508625125417> servers can enable money gain based on voice activity. Each member active in voice earns a random amount of money (15 to 25 💰 by default, configurable), at a regular interval (every 2 minutes by default, configurable).

This interval is also customizable independently of the message one.

Requirements to earn money in voice:

  • The user must not have muted their microphone or their sound (deafened), whether self-deafened or server-deafened.
  • The channel must not be a stage channel or set as the AFK channel (in the Discord settings).
  • At least 2 human members in total (including the beneficiary) must be present and active (not muted/deafened) in the same channel.

If these conditions are no longer met, the member stops earning money until they are met again.

Other ways to earn money

Thanks to DraftBot's ecosystem, you can grant money through other features:

FeaturesDescription
GiveawaysOffer money as a reward
Starting moneySet an amount given to new members
DailyDaily reward claimable through /daily
Birthday giftsOffer money automatically
Money drop (/dropmoney)Create interactive events where the first to click wins
Advent calendarDaily rewards in December
Custom commandsCreate all kinds of commands tied to the economy

Threads and forums

The economy system distinguishes between two types of discussion spaces:

TypeDescription
ThreadsCreated in text or announcement channels. Their money gain can be enabled or disabled through the "Enable money gain in threads" option.
Forum postsMessages published in forum channels. Their money gain is controlled by the "Enable money gain in forum posts" option.

Threads and forum posts automatically inherit their parent channel's settings regarding allow/deny lists and multipliers.

Allow and deny lists

The role and channel lists let you control precisely who can earn money and where:

ModeDescription
WithOnly the listed members/channels can earn money. For roles, a member earns as soon as they hold at least one role from the list, whatever their other roles.
WithoutThe listed members/channels cannot earn money. For roles, a single forbidden role is enough to block the gain.

Money multipliers

You can apply multipliers (x1.5, x2, x2.5, x3) to certain roles or channels to boost money gain.

Premium <:icon_premium:1096140508625125417> servers can use custom values ranging from x0.1 to x10.

  • If a member holds several boosted roles, only the highest boost is applied.
  • If a channel inherits its category's boost and has its own boost, only the channel's boost is applied.
  • Role boosts and channel boosts, however, stack with each other (multiplication).

Example: a member holding an x2 role who posts in an x1.5 channel earns x3 (2 × 1.5). Conversely, if they hold two boosted roles (x2 and x1.5), only the x2 is applied.

Additional options

Other advanced options are available to fine-tune the system:

OptionDescription
Money gain per message in voice channelsDetermines whether text messages sent in voice channels grant money, following three modes: Everyone (any message grants money, whether or not the author is connected to voice), Only if voice-connected (money is only granted if the member is also connected to the voice channel), or Disabled (no text message in voice channels grants money).
Long messages count doubleMessages of 250 characters or more (threshold configurable between 100 and 1500) grant double money.
Allow viewing other members' moneyIf disabled, members only see their own balance through /money and the /topmoney command becomes unavailable. In that case, the command becomes ephemeral (visible only to the user who ran it). Administrators can still check every member's money.
Reset money when leaving the serverIf enabled, members who leave the server lose their money for good. If they come back, they start from zero.
Reset money on banIf enabled, banned members lose their money for good.
Starting moneySet an amount of money given automatically to new members joining the server.
Daily moneyConfigure the amount claimable every day through the /daily command.
Currency customizationChange the emoji of your currency.<:icon_premium:1096140508625125417>
Color customizationChange the color of economy embeds and cards.<:icon_premium:1096140508625125417>

Features marked with the <:icon_premium:1096140508625125417> symbol are reserved for premium <:icon_premium:1096140508625125417> servers.

Leaderboard

You can display the member leaderboard, from the wealthiest to the poorest, in three ways:

The /topmoney command

Result of the /topmoney command
Result of the /topmoney command

To display a specific number of rows (only the top 3, for instance), pass that number as an argument: /topmoney number:3.

If the "Allow viewing other members' money" option is disabled, members can only check their own balance with /money, and the /topmoney command becomes unavailable to non-administrators. To disable the online leaderboard as well, see the Online leaderboard section below.

Online leaderboard

You can open it from the "View the whole leaderboard" button of the /topmoney command.

Online leaderboard
Online leaderboard

If you are a server administrator, you can also reach it from the panel, in the Economy module, through the "Access to the leaderboard" button.

If you want to disable the online leaderboard, an option is provided for that on the panel or through /config.

Real-time leaderboard

Premium <:icon_premium:1096140508625125417> servers can set up an automatic member leaderboard in a dedicated channel.

Automatic Discord leaderboard
Automatic Discord leaderboard

The message displays up to 25 members and is updated automatically every 10 minutes, only if the leaderboard has changed.

Configuring the economy system

⫸ Open the DraftBot panel

To enable the module, the first step is to click the button in the top right corner:

Enabling the economy system from the panel
Enabling the economy system from the panel

Every feature then appears:

Economy module enabled on the panel
Economy module enabled on the panel

Once your changes are done, remember to save them with the "Save" button at the bottom of the page!

Configuring shops

⫸ Open the DraftBot panel

To create a shop from the panel, click the "Create shop" button in the "Shop configuration" section:

Shop creation button on the panel
Shop creation button on the panel

A window opens to configure your new shop:

Shop creation menu
Shop creation menu

Shop settings:

  • Name: the name of your shop (50 characters maximum)
  • Description: a description of the shop (500 characters maximum)
  • Style: choose between Classic (a neutral look, suitable for any theme) or Black Market (a dark styling with a mysterious tone, ideal for roleplay servers or rare item shops)

If your server already has shops, they appear at the bottom of the screen, where you can edit or delete them.

Premium <:icon_premium:1096140508625125417> servers can create up to 5 shops.

Customizing your shop

Once your shop is created, you can customize it further:

SettingDescription
EmojiAdd an emoji displayed next to the shop's name
DescriptionChoose a description to build your shop's story
StyleChoose between Classic or Black Market (see the description above)
Default sortingSet the default sort order of the articles
Access conditionsRestrict access to the shop: required or forbidden roles, minimum level, etc.
ColorCustomize the color of the shop interface<:icon_premium:1096140508625125417>
BannerAdd a banner image at the top of the shop (800x137px recommended) (10MB max)<:icon_premium:1096140508625125417>

Features marked with the <:icon_premium:1096140508625125417> symbol are reserved for premium <:icon_premium:1096140508625125417> servers.

Creating a shop article

To add articles to your shop:

⫸ Open the DraftBot panel

  1. Click the "Edit" button of the shop concerned
  2. Click "Create an article"
Article creation menu
Article creation menu

Information common to every article type:

  • Type: the article type (role, temporary role, experience, item, custom)
  • Price: the cost of the article in server money
  • Description: a description of the article (1000 characters maximum)
  • Stock: quantity available (see the Stock of an article section)

You can let your members obtain roles (temporary or permanent) in exchange for currency. To add a role to the shop, select the article type "role" or "temporary role" in the article creation menu.

Then choose:

  • The price of the article
  • The role to assign
  • The description of the article
  • The duration of the role (for a temporary role)
Role selling menu, temporary (left) and standard (right)
Role selling menu, temporary (left) and standard (right)

The selected role must have been created on your server beforehand, and must be accessible to DraftBot (so it must not sit higher than DraftBot's highest role).

If a member tries to buy a role they already have, the purchase is refused with an explicit error message.

Stock of an article

An article has an unlimited quantity by default. By expanding the "Advanced" menu, premium <:icon_premium:1096140508625125417> servers can set a limited stock for each article. Once it runs out, the article can no longer be bought until you restock it manually.

Stock is managed article by article. You can have some articles with unlimited stock and others with a limited quantity in the same shop.

Stock configuration option
Stock configuration option

Managing members' money

As an administrator, you have several commands to manage members' money:

CommandDescription
/dropmoneyCreates a message with a button: the first member to click wins the money. You can set a time limit (10 minutes maximum).
/adminmoney add memberAdds money to a specific member.
/adminmoney add serverAdds money to every member of the server (asynchronous operation).
/adminmoney add roleAdds money to every member holding a specific role (asynchronous operation).
/adminmoney remove memberRemoves money from a member.
/adminmoney remove serverRemoves money from every member of the server (asynchronous operation).
/adminmoney remove roleRemoves money from every member holding a specific role (asynchronous operation).
/adminmoney setSets a member's money to an exact amount (replaces their current money).
/adminmoney transferTransfers money from one member to another (the giver loses the transferred money).
/adminmoney reset serverResets all the money on the server. This action cannot be undone!

Admin commands can only be used by members of your server holding the administrator permission.

Bulk operations: commands targeting "every member" or "a role" run asynchronously. A progress message is displayed and updates automatically. You can cancel the operation at any time with the button provided.

Using the /dropmoney command
Using the /dropmoney command

Migrating from UnbelievaBoat

If you were already using an economy system through UnbelievaBoat, you can import your members' money into DraftBot's economy system!

The feature is available through the /config command, in the "Economy" tab.

Economy import button
Economy import button

After clicking Import UnbelievaBoat and confirming that you want to proceed with the import, DraftBot automatically retrieves all of the members' money information. The imported money replaces the members' current money in DraftBot.

Make sure UnbelievaBoat is present on your server at the time of the import!

The import can be run again later if needed, but it will overwrite the DraftBot balances again with the UnbelievaBoat values of the moment.