Currency and balances

The economy gives every member of your server a balance in a currency you define, and a paper trail for every coin that moves. It is configured on the Economy page, under the Settings tab.

Turning on Enable the economy is the master switch. While it is off, every economy command refuses to run.

Two things to know before you start:

• The economy is a limited rollout. On a server that has not been enrolled, /economy answers with a beta notice instead of running.
• The economy is stored per bot. If you also run a custom bot, it has its own currency, its own shop and its own balances, entirely separate from FlaviBot's.

Naming the currency

Under Currency you set:

• Currency name, the plural form. The default is Coins.
• Singular name, optional, used when the amount is exactly 1, so you get 1 Coin instead of 1 Coins.
• Currency emoji, shown next to every amount in chat. The default is 🪙 and your own server emojis work.
• Currency image URL, optional, used in embeds and on the web.

Every amount the bot prints follows the same shape: emoji, amount, name. With the defaults, 🪙 1,250 Coins.

Wallets

A wallet is created the first time a member touches the economy. Under Balances:

• Starting balance is granted once, at that moment. It defaults to 0.
• Maximum balance is a hard ceiling. Leave it empty for no cap, which is the default.

The cap only ever blocks credits. A payment out of a wallet always lands, so a member sitting at the cap can still spend, and a refund is never blocked by it. When a credit would push a member past the cap, the operation is refused rather than silently trimmed.

A balance can never go below zero. Anything that would overdraw a member is rejected instead.

Members check their own with /economy balance, or someone else's with /economy balance user.

The minimum account age gate

Minimum account age (days), in the Transfers section, is an anti-alt measure. Discord accounts younger than that earn nothing from the passive sources (message activity, voice activity, XP gain and level up), cannot send or receive a payment and cannot rob. /economy daily, /economy work, /economy crime and /economy collect are not gated by it. Setting it to 0, the default, disables the gate.

It is worth setting on a server that has been raided: a throwaway account made this morning cannot farm coins to pass to a main account.

Every movement is recorded

Each coin movement writes one line to a ledger, tagged with a reason: a daily claim, a shop purchase, a transfer, a fine, an admin adjustment. Nothing moves coins outside of it, and lines are never edited: a correction is a new, opposite line.

Members see their own lines with /economy history. Staff with Manage Server can pass a member to /economy history user to inspect someone else's.

The Activity tab of the Economy page is the full picture: how much currency exists, what is minting and what is burning it per day, a breakdown by reason, top earners and top spenders, and the raw ledger with filters by member and by reason.

How far back the dashboard can look depends on your tier:

Correcting a balance

From Discord, with Manage Server:

reset-all is irreversible and asks for a confirmation first. The optional reason on the other three is an audit note, up to 200 characters, stored with the ledger line.

From the dashboard, the Activity tab has a member lookup that shows a member's balance, rank, lifetime earned and spent, inventory and recent history, with the same give, take and set actions. There a reason is mandatory, and it is stored alongside your own user id.

Public pages

Under Visibility and integrations you can expose two read-only web pages for your server, both off by default:

• a public leaderboard of the richest members;
• a public shop page listing your items.

Each has a Copy link button next to it. Visitors need to be signed in with Discord to open either one.

The same section holds Refund ticket cost on close: if a ticket panel charges coins to open a ticket, the coins are returned when the ticket is closed.