BooversumDocs Add Bot
Community

Economy

Members earn Boovies 🪙 - your server's own currency - just by being active: chatting, talking in voice, streaming and with their camera on. They spend them in your shop on roles, server XP, items or rewards your team hands out.

Free More shop items: Guild Premium
/daily for the daily reward, /rewards to spend Boovies in the shop.
What a member sees with /balance.

Setup

  1. Open Dashboard › Economy › Economy Settings.
  2. Switch the economy on. Optional: rename the currency and pick another emoji - “Boovies 🪙” is just the default.
  3. Set how much each activity pays and the daily limit per member - the preview shows what a member can earn per hour.
  4. Click Add item to put the first reward into the shop.
  5. Done - members check their balance with /balance and shop with /rewards.
What the bot needs
Manage Roles to give the roles it sells, and its own role must be above those roles. Roles with moderation or admin permissions can never be sold.
Economy Settings: currency, daily limit, what each activity pays - and the shop with all four kinds of items next to it.

Earning

ActivityPays
💬 ChatPer message - at most one paid message per member every 60 seconds (adjustable), so spam doesn’t pay.
🎤 VoicePer minute in a voice or stage channel.
📺 StreamExtra per minute while streaming.
📷 CameraExtra per minute with the camera on.

All four rates can be fractions - 0.5 means one Boovie every two minutes; the parts are collected and paid out as whole coins. 0 switches an activity off.

  • Daily limit - nobody earns more than this per day (default 500). It starts again at midnight in your server's time zone.
  • Not alone - by default voice only pays with at least one other person in the channel. Bots don't count, so a music bot is no company.
  • The AFK channel never pays. Muted or deafened members don't earn in voice either - unless you allow it.
  • Long messages - optionally, a message with at least a set number of characters (100-1,500) pays double. Off by default.
  • Threads and forums - both earn by default; switch either off if you don't want them to.

Which channels and roles earn

For channels and for roles you pick how the list works:

ModeWhat it does
Block listEverything earns <strong>except</strong> the channels or roles on the list. This is the default.
Allow list<strong>Only</strong> the channels or roles on the list earn - handy for “Boovies only in #general and the gaming voice channels”.

A category on the list covers all its channels. A thread follows its channel.

Rules: who earns where - here everywhere except #bot-spam, and everyone except @Muted.

Multipliers

Give roles or channels a multiplier from ×0.1 to ×10 - for example ×2 for server boosters, or ×0.5 in a spam channel. Up to 25 of each.

  • A member with several multiplied roles gets the highest one, not all of them stacked.
  • For channels the most specific one counts: the channel itself, otherwise its parent channel (for threads), otherwise its category.
  • Role and channel multiply each other: a ×2 role in a ×1.5 channel earns ×3.
  • The daily limit still applies on top.
Boosters earn ×2, VIPs ×1.5 - and #bot-spam only pays half.
Fair by design
Boovies come from real activity. Only the multipliers you set yourself change them - XP boosts, events and Premium don't, so nobody can buy their way to the top of the shop.

Daily reward, invites & paying

/daily with a streak - and /pay between two members.
  • /daily - once a day a member collects a bonus (default 50). Every day in a row adds more (default +10), up to day 7 - you choose the last bonus day yourself (1-30, 1 = always the same amount). Missing a day starts again at day 1. It doesn't count against the daily limit.
  • Invite reward - the inviter gets Boovies (default 100) once the invited member has stayed a few days (default 3). It uses the Invite Tracker: members who left again, fake joins and self-invites never pay, and each member pays only once - leaving and rejoining doesn't count again.
  • /pay - members send each other Boovies, with an optional note. A daily sending limit (default 1,000) stops second accounts from collecting coins for one main account.
All three can be adjusted or switched off in Economy Settings.

New members, leaving & the log

  • Starting money - every new member gets this once when they join (members who were already here don't). Rejoining doesn't pay it again.
  • Reset on leave / on ban - optionally a member's balance is set to 0 when they leave or are banned. Both are off by default; the history keeps a line for it.
  • Birthday gift - with Birthdays set up, members get Boovies on their birthday - once per year.

Economy log - its own section in Economy Settings: pick a channel and switch on what gets posted there - shop purchases and rewards to hand out, admin changes (including resets, drops and changes made in the dashboard), /pay, /daily, invite rewards and starting money, birthday and giveaway Boovies, mini-games. Everything is on except /daily and mini-games, which would be a message for nearly every member every day. Nobody gets pinged.

Members & log: starting money, the log channel, the birthday gift and what happens when someone leaves.

Mini-games

Three small games let Boovies leave the economy again - and give members something to do with them. Every game is one line in the history (two for a duel).

CommandWhat it does
/game coinflipHeads or tails against the bot. Right: your bet on top. Wrong: your bet is gone. The bot keeps nothing - it is a fair 50 : 50.
/game slotsThree reels. A pair pays 1.5× your bet, three of a kind 10×, three 7s 25×. Over time the slots pay out about 97 % of what goes in - the rest leaves the economy.
/game duelChallenge a member for a bet. They get 60 seconds to accept; then both put in the same amount and the winner takes everything. Both need the Boovies at that moment.

In Economy Settings you switch the games on or off, set the highest bet (default 500) and a pause between games per member (default 30 seconds). Lost bets count as spent, won bets don't count as earned - the Who earns how much chart stays about activity.

Balances & the leaderboard

/balance shows your own Boovies and your rank on the server. /balance @member shows someone else's, and /richest lists the richest members (up to 25).

Don't want members to see each other's balances? Switch off Members can see each other's balance - then only admins can look at others and use /richest.

The shop

Members open the shop with /rewards (or the button under /balance), pick an item and confirm. Every item is one of four types:

TypeWhat the member gets
🎭 RoleGives a role - for 1 hour up to a year, or permanently. When the time is up, the bot takes it away again.
✨ Server XPAdds XP in one category (chat, voice, stream or camera) on this server - level-ups and level roles follow as usual. Never global XP.
📦 ItemGoes into the member’s <code>/inventory</code> - a badge of honour, a ticket for your next event, a running gag. 1 to 1,000 at a time.
🎁 Custom rewardAnything your team does by hand: a shout-out, a custom emoji, a game with the owner. It shows up as an open request - see below.
One shop, four kinds of items - and buying the XP boost.
  • Buying a timed role again adds the time on top. A permanent role can only be bought once - and a role the member had before buying is never taken.
  • Stock - limit how many can be sold in total, and/or how many each member may buy.
  • Pause an item to hide it from the shop - roles already bought keep running.
  • If something can't be handed out (missing permission, role deleted), the Boovies come back straight away - exactly once.
A shop item: emoji, name, what the member gets (here 500 Voice XP), price, stock and limit per member.
/inventory: roles and when they end, items, and custom rewards still waiting for the team.
PlanShop
Free3 shop items
Guild PremiumUp to 25 shop items

Custom rewards: open requests

When a member buys a custom reward, the Boovies are held and the request appears under Open requests in Dashboard › Economy › Economy Activity (and in the log channel, if you set one). Once your team has done it, click Done. Can't do it? Click Refund - the member gets every Boovie back. Members see their waiting requests in /inventory.

Two custom rewards waiting for the team.

Removing items from an inventory

Items stay in a member's inventory - also when you remove the item from the shop. To take them away, click the member in Dashboard › Economy › Economy Activity (in Richest members, the history or Give or take): their inventory opens, and Remove takes one or as many as you enter. In Discord: /economy take-item. The Boovies are not refunded; the history and the log channel show what was removed and by whom.

Admin commands

Everything you can do in the dashboard also works straight in Discord with /economy - for members with Manage Server. A reason is optional; if you give one, it's stored in the history.

CommandWhat it does
/economy giveGive Boovies to one member.
/economy takeTake Boovies from one member - never below 0.
/economy setSet a member’s balance to an exact amount.
/economy transferMove Boovies from one member to another.
/economy take-itemRemove items from a member’s inventory (no refund).
/economy give-roleGive Boovies to everyone with a role.
/economy take-roleTake Boovies from everyone with a role.
/economy give-allGive Boovies to every member of the server.
/economy take-allTake Boovies from every member of the server.
/economy resetA new season: every balance back to 0. Type <code>RESET</code> to confirm - the history keeps everything.
/economy dropDrop Boovies in the channel: the first member to click the button gets them. Open for 1-10 minutes.
100 Boovies for every booster at once - and a drop, grabbed by the fastest.

On big servers give-role, give-all and the like work through the members in batches and show their progress. If the database hiccups, the bot retries on its own - nobody is paid twice. With a log channel set, every admin change is posted there.

Boovies as a giveaway prize

Add Boovies to any giveaway - in the dashboard or with the boovies option of /giveaway create. Every winner gets them automatically when the giveaway ends, and new winners get them on a reroll. Each winner is paid only once, and only while the economy is switched on.

Economy Activity

Dashboard › Economy › Economy Activity shows how the economy is doing:

  • Numbers: Boovies in circulation, members with a balance, earned and bought in the last 7 days, spent in total.
  • Who earns how much - a chart of the Boovies earned per day over 7, 30 or 90 days: the top 5 members in their own colours, everyone else added up. Activity, daily rewards, invite rewards and drops count; admin changes and /pay don't.
  • Open requests - custom rewards waiting for your team.
  • Richest members - click one to see only their history.
  • Give or take - add or remove Boovies by hand, e.g. for an event winner. A reason is required and stored.
  • History - every single change: activity, purchases, refunds, /daily, /pay, invite rewards, drops, giveaway and birthday Boovies and admin changes (with who made them). Activity older than 30 days is summed up into one line per member and day - the totals stay exactly the same.
Economy Activity in the dashboard.
The history: every change, with who made it and why.

Private or public replies

By default /balance, /richest, /rewards, /inventory, /daily and /pay answer only the member (“Only you can see this”). Switch it off in Economy Settings to post them in the channel for everyone - in a public shop anyone can buy with the menu, each with their own balance. Purchase confirmations and errors always stay private. With private replies, /pay tells the receiver by DM.

Safe by design

  • Every Boovie that moves is one line in the history - nothing appears or disappears without a trace.
  • A balance can never go below 0, and two clicks at the same moment can't buy more than a member can afford or more than is in stock. A drop has exactly one winner.
  • If the database is briefly unreachable, earnings wait and are booked later - never twice.
  • Boovies belong to one server and have no real-money value: they can't be bought or cashed out.

Commands

CommandWhat it does
/balanceYour Boovies (or another member’s), your rank, what you earned today and your /daily streak.
/richestThe richest members on this server.
/rewardsThe shop - spend your Boovies.
/inventoryYour roles, items and waiting requests.
/dailyCollect your daily bonus - more for every day in a row.
/paySend Boovies to another member, with an optional note.
/game coinflip · slots · duelMini-games - see <a href="#games">Mini-games</a>.
/economy …Admin tools - see <a href="#admin">Admin commands</a>.

All economy commands at a glance: Commands → Economy.