Overview
Economy Guide

Economy — The Complete Guide

Everything members and admins need to know about the SYNTHET economy: earning, banking, items, the marketplace, the dashboard, and every command. New to the bot? Start with Getting Started.

What is the Economy?

The SYNTHET economy is a per-server virtual currency system. Each member has a wallet, a bank, an inventory, and independent skill levels for every activity. Coins are earned through engagement (work, fishing, hunting, gathering, cooking, crafting, daily/weekly claims) and spent on the catalogue, the player marketplace, or social features (paying friends, posting bail).

On top of currency the bot ships a full item system: every activity can drop items, items have rarities, marketplace eligibility, and effects (XP boosts, coin multipliers, bag expansions, cooldown resets, role grants). Members trade those items with each other on a server-specific marketplace at www.synthet.gg/m/<server-id> — the same URL !market hands out in Discord.

Admins configure everything from the dashboard. The Catalogue Editor manages shop items, the Currency page sets symbol / cap / interest, the Sources page tunes rewards per activity, the Drops page configures random money drops, the Exchange page covers currency strength + Trade Pacts, and the Audit page surfaces any abuse signals.

What you'll find in this guide

Recently shipped

The Economy module changes constantly. The largest recent additions:

Item & Random Drop System

Every activity can now drop items. Each drop has a rarity (Common → Unique), a drop-rate multiplier chain (server × event × player boost × anti-farm), and per-user / per-server / per-rarity caps so farming can't collapse the economy. See Items, Rarity & Drops.

Player Marketplace

Members list items from their inventory and buy from each other. !market in Discord opens the web marketplace at www.synthet.gg/m/<server-id>; !sell + !offers still work entirely inside Discord. Tax + listing fees are configurable.

Cooking & Crafting

!cook turns ingredients into recipes; !craft assembles materials into gear. Both use a recipe system you edit on the Crafting dashboard page.

Gathering

!gather earns raw materials feeding the crafting and cooking systems.

Exchange

A new Exchange dashboard tracks ledger classification, currency strength, server economy rating, eligibility for the global Exchange, and Trade Pact readiness. Pacts are configured dashboard-only.

Catalogue Editor

The dashboard's former “Shop Editor” is now the Catalogue Editor— full CRUD on shop items with an icon picker that draws from the bot's colorful illustration library (the same icons that appear on Discord cards).

The fastest tour of every command

Every economy command works as both a slash command (e.g. /balance) and a prefix command (e.g. !bal). Some are also exposed as subcommands of /eco so that slash users can discover them from a single root. The aliases in parentheses are interchangeable.

Wallet/balance · /bal · !balShow wallet, bank, escrow, and net worth.
Wallet/daily · !dailyClaim the 24h daily reward (streak-tracked).
Wallet/weekly · !weeklyClaim the 7d weekly reward (streak-tracked).
Wallet/pay · !pay user amountSend coins to another member (tax may apply).
Wallet/eco bank deposit · withdrawMove coins between wallet and bank.
Activity/work · !workPick a job and earn coins (cooldown).
Activity/fish · !fishCast a line in your unlocked biome.
Activity/hunt · !huntHunt creatures in your unlocked region.
Activity/gather · !gatherCollect raw materials.
Activity/cook · !cookCombine ingredients into recipes.
Activity/craft · !craftAssemble materials into gear.
Items/inv · !invOpen your inventory sheet.
Items/eco item view · use · infoInspect, consume, or look up an item.
Items/sell · !sellSell to the bot or list on the marketplace.
Items/market · !marketOpen the web marketplace for this server.
Items/offers · !offersAccept or decline incoming p2p offers.
Crime/beg · !begBeg for spare change (low risk, low reward).
Crime/crime · !crimeRob an NPC target (medium risk).
Crime/rob · !rob userTry to rob another member's wallet.
Crime/heist · !heistRun a crew heist on a high-tier target.
Crime/bail · !bail userPay a member's bail to release them.
Crime/break · !breakAttempt a jailbreak.

How earning works

Every reward funnels through the same ledger. Wallets are server-scoped (your balance on Server A is unrelated to Server B). Available balance is what you can spend; banked balance is protected from /rob. Both are capped — see Wallets & Banking.

Every active command (work, fish, hunt, gather, cook, craft, crime, rob, heist) has a cooldown set by the admin on the dashboard. Failed activities still grant XP at a reduced rate so you keep progressing even on unlucky rolls.

Items dropped from activities are stored in your inventory. You can !use an item to apply its effect (XP boost, coin multiplier, cooldown reset, role grant, …), !sell it to the bot at the floor price, or list it on the player marketplace for any price you set.

Currency symbol & name

The currency name (Coin, Bit, Gem, anything you want) and the symbol shown next to amounts ($, 🪙, 💎, …) are set on the Currency dashboard page. Cards, embeds, and the marketplace all read from those values, so renaming one place updates every surface.

Where the data lives

Operators can skip this — but if you build integrations against the bot, the canonical tables are:

eco_wallet_v2

Per-member wallet + bank balance.

eco_inventory_v2

Each member's item stacks.

eco_shop_item_v2

Catalogue rows the admin curates on the dashboard.

eco_market_listing

Active player marketplace listings.

eco_market_offer

Direct p2p offers awaiting acceptance.

eco_drop_log

Audit trail for every item drop.

eco_activity_log

Every fish/hunt/gather/cook/craft/crime outcome.

eco_user_skill

Per-skill level + XP per member.

XP & leveling at a glance

Every activity has its own independent skill: Work, Fishing, Hunting, Gathering, Cooking, Crafting, Crime, Heist. Levels run 1 → 100. The XP curve is identical across skills:

XP required for level n:

80 + (n × 20)

Level cap

100

Level-up bonus

level × 25 coins

Failed-activity XP

25% of base

Higher skill levels unlock new biomes / regions / job tiers, raise floor rewards, and increase the chance of drop rolls hitting rare tiers.

Anti-abuse & integrity

Several mechanisms keep the economy stable:

Wallet & bank caps

Per-member maximums on available and banked balance. Configurable on the Currency page.

Drop caps

Per-user / per-server / per-rarity / per-day / per-week ceilings. Legendary drops have a weekly cap; Mythic drops have a monthly cap.

Suspicion scoring

Audit signals (rapid re-rolls, stack-and-dump cycles, alt-coordination) raise a per-member suspicion score visible on the Audit page. Quarantine actions are reversible.

Marketplace eligibility

Items have an isMarketplaceEligible flag — admin-minted, bound, or quest-reward items cannot be listed. Stolen items carry an origin tag visible on the inventory card.