Earning coins

A new economy mints nothing. There is no default income: until you add an earning rule, every member sits at their starting balance forever, and /economy daily answers that it is not configured.

That is deliberate. Every coin that exists on your server exists because you switched on a source for it, which is what makes the currency worth anything.

Rules live on the Economy page, Earning tab. Each rule can be switched off without deleting it, and edited at any time.

The eight kinds

You can only have one rule of each kind, except Role income, which can have one rule per role.

Message activity

Pays a random amount between a minimum and a maximum for a message, then holds a cooldown before that member can earn again. The cooldown defaults to 60 seconds and cannot go below 30.

You can limit it to a list of channels, or exclude a list of channels, and set a daily cap on how much one member can earn from chatting per day. Days run on UTC.

This is independent of message XP: it works whether or not the level system is on, and it uses its own cooldown, not the 50 second XP one.

Voice activity

Pays a fixed amount per tick, where a tick is a number of minutes you choose, from 1 to 60, defaulting to 5. A 22 minute call at a 5 minute tick pays four ticks. It also takes a daily cap.

Members who are deafened or muted earn nothing: if you cannot take part, you do not get paid. Note that this is stricter than voice XP, which only skips deafened members.

Like voice XP, this depends on the Server Stats voice tracking module being enabled. With it off, no voice time is recorded and nothing is paid.

Daily reward

/economy daily claims a base amount, plus a streak bonus that grows with each consecutive day claimed. The bonus defaults to 10% per day, capped at 300% of the base, and grace days (1 by default) is how many missed days are forgiven before the streak resets to zero.

Two reset behaviours are available:

• Once per day, the default: claimable again at midnight, in a timezone you pick. The timezone defaults to UTC.
• Cooldown after claim: claimable again a fixed number of hours after the last claim, 24 by default.

The command tells the member their new streak and when they can claim next.

Work and crime

/economy work pays a random amount between a minimum and a maximum, on a cooldown that defaults to one hour.

/economy crime is the same shape with a gamble on top: a fail chance, 60% by default, and on a failure the member is fined a random percentage of their balance, 20% to 40% by default, instead of being paid.

Both take custom replies: lines of flavour text, up to 300 characters each, picked at random. Write {{amount}} where the payout should appear. Crime takes two lists, one for successes and one for failures.

Level up and XP gain

Level up pays whenever a member gains a level. Either a flat amount per level, or an exact amount for specific levels (up to 100 of them), so you can make level 10 and level 50 feel like milestones. It pays on voice level-ups as well as text ones.

XP gain pays proportionally to XP earned, expressed as coins per 100 XP. It is the smoothest faucet of the three, because it tracks activity directly rather than milestones.

Both only pay for organic XP, earned by talking or by being in voice. XP handed out by /xp or by an automation never mints coins.

Both obviously need the level system to be on.

Role income

Pays members holding a role a fixed amount, daily or weekly. Two payout styles:

• Claim with collect: the member runs /economy collect to take it. Income from several roles stacks and is collected in one go.
• Automatic: the bot pays everyone with the role on schedule, without them asking.

Either way a member is only paid once per period, even if a payout runs twice.

When passive earnings actually appear

Message, voice and XP-gain earnings are batched and written to balances roughly once a minute. A member who checks their balance the second after sending a message may not see it yet. Everything triggered by a command (daily, work, crime, collect) is immediate.

How many rules you can have

Two more sources, off by default

The Settings tab also has two optional faucets that move coins between members rather than minting them:

• Rob lets a member try to steal from another. The odds are not fixed: the richer the robber is compared to their target, the likelier they fail, between 20% and 80%. A success takes at most a percentage of the target's balance, 10% by default; a failure fines the robber a percentage of their own, 20% to 40% by default. Either way the cooldown is consumed, four hours by default. Members who joined the server less than 24 hours ago can neither rob nor be robbed, and so can accounts below the minimum age gate.
• Casino (/casino) offers blackjack, roulette, slots, coinflip and higher or lower, with a minimum and maximum bet and a limit on how many games a member can start inside a time window (4 games per 5 minutes by default). You can disable individual games and keep the rest.

Both are off until you switch them on. FlaviBot can also pause the casino across all servers at any time; while it is paused, casino commands answer with a temporarily-disabled message and the rest of the economy carries on.

Paying coins from an automation

Autoresponder actions can add, remove or set a member's balance, so an automation can pay a reward for anything you can trigger on. There is also an economy_balance_threshold trigger, which fires when a member's balance crosses an amount you set, in the direction you set, once per crossing rather than on every transaction. See actions and triggers.