Skip to content

Economy overview

A virtual currency system per server. Members earn coins via messages + daily claims, can transfer to each other, and spend in the Casino. Independent of XP — they share members but not balances.

Currency

Each server defines:

  • Currency namecoins, gems, bucks, whatever fits your vibe.
  • Currency symbol🪙, 💎, $. Shown in embeds.

These are purely cosmetic; the balances themselves are always whole numbers.

How members earn

SourceDefault
Per qualifying messageRandom in [min, max] (default 5–10), with cooldown (default 60s).
Daily claimOnce per 24h. Default 100. Optional streak bonus.
From other membersTransfers (/peconomy transfer), optionally with a percent tax.
From staff/peconomy give (admin) grants any amount with optional reason.

Pages

PageWhat for
SettingsCurrency name/symbol, earn-on-message + daily + transfer tunables, multipliers, blacklist.
EarningChannel + role multipliers; blacklisted channels.
LeaderboardPublic ranking.
AnalyticsMoney supply, top earners, recent ledger activity.
LedgerFull transaction log — every grant, transfer, daily, casino bet/payout.

Where it lives

Dashboard: Economy.

Slash commands

  • /peconomy balance [user] — your balance (or someone else's)
  • /peconomy daily — claim today's daily
  • /peconomy transfer @user <amount> — send currency
  • /peconomy leaderboard — top earners

Admin (gated by economy.edit):

  • /peconomy give @user <amount> [reason] — grant
  • /peconomy take @user <amount> [reason] — burn
  • /peconomy set @user <amount> [reason] — set absolute balance
  • /peconomy reset @user — wipe to zero

Limits

  • Earn min/max: 0–1000
  • Cooldown: 5–86400 seconds
  • Daily amount: 1–1,000,000
  • Transfer tax: 0–50%
  • Max balance: configurable up to 1 trillion (default 1B)

Permissions

  • economy.view — see settings, leaderboard, analytics, ledger
  • economy.edit — change tunables, admin grant/take/set/reset

Integration with other modules

  • Casino uses Economy balances. Disabling Economy kills the Casino.
  • Trivia rewards can be in currency (in addition to / instead of XP).
  • Counting can reward correct counts with currency.
  • Tickets, Levelling are independent; they don't read or write Economy.

Phantom is a product of Hydra Labs. The bot is run as a managed service; you do not need to host it yourself.