Economy: Virtual Currency, Daily Reward, Transfers and Role Shop

The economy is a virtual server currency ("Coins" 🪙 by default). Members earn it, transfer it to each other and use it to buy roles in a shop that you set up. It is independent of the XP system: XP stand for progress, the currency for purchasing power. A server can use both or just one of them. There are no gambling features.

For short walkthroughs, see the guides Setting up the economy and Rewards with the economy.

Requirements

• Access to the module: You sign in to the dashboard with Discord and need the Manage Server permission (or access granted for this module). The admin commands require the same permission.
• For shop roles: Kage needs Manage Roles, and its role must be above the shop roles in the role list.
• Module active: If "Economy active" is off, all /economy commands reply that the economy is not active.

Earning currency

Important:

• Daily applies per member as a rolling 24-hour window from the last claim, not as a calendar day. Anyone using the command too early sees when it is possible again.
• Work has its own cooldown in minutes, which you set.
• The message reward is optional. Per member, at most one message counts within the cooldown, and it uses the same message hook as the XP system, but with its own values. It only works while the economy is active and the plan applies.
• Balances are never negative.

Spending and transferring currency

A purchase in the shop

1. Kage checks that the item exists and its role is still there.
2. If the member already has the role, Kage stops.
3. Kage deducts the price. If the balance is not enough, nothing happens.
4. Kage grants the role. If that fails (for example because of the role order), the member is refunded the price.
5. The purchase appears in the module's Logs tab.

For admins

The following commands need Manage Server. Only you see the replies.

In the dashboard you create items under Shop via + New item and delete them with a confirmation. You also see the leaderboard (highest balance) there. Every transaction is stored with type, amount and the balance afterwards; for admin entries also who triggered them.

Settings at a glance

Checking the result

1. Earning: Run /economy daily. You get the daily amount; the second call names the wait.
2. Balance: /economy balance shows the amount.
3. Shop: Create a test role with /economy shop-create, get a balance with admin-give and buy with /economy buy. The role is granted.
4. History: /economy history lists the entries.

Troubleshooting

All commands report that the economy is not active

"Economy active" is off or not saved.

The purchase does not work

The item or its role no longer exists, the member already has the role, or the balance is not enough. If Kage cannot grant the role, the member gets the price back. In that case, check the role order.

The message reward does not come

Check that it is switched on and the cooldown is not already running. It applies only while the economy is active.

Daily cannot be used again

The 24-hour gap since the last claim applies. The reply names the next time.

The balance does not drop below 0

That is intended. Deductions via admin-give stop at 0.

Further reading

Progress instead of purchasing power: Levels and XP. Awards: Achievements.