Economy Dashboard Guide
Page-by-page walkthrough of every surface under /dashboard/economy and the related Exchange hub. Each entry below explains what the page does, what an admin configures there, and what happens to the bot when the value changes.
Economy hub
/dashboard/economyTop-level dashboard with module status, key stats, and tiles linking to every config page.
When to use it: Quickly toggle the economy on/off, see a snapshot of activity, and jump into any sub-page.
Currency
/dashboard/economy/currencyCurrency name + symbol, daily / weekly base amounts, streak settings, wallet & bank caps, bank interest %.
When to use it: This is the first page to visit on a fresh server. Pick the currency, then set caps that match your community’s pace.
Sources
/dashboard/economy/sourcesPer-activity reward ranges (work / fish / hunt / cook / craft / gather / crime / rob / beg).
When to use it: Tune how much each command pays. Defaults are calibrated; only touch when you want a faster or slower curve.
Activities
/dashboard/economy/activitiesCooldowns and per-activity multipliers. Booster effect ceilings live here too.
When to use it: Shorter cooldowns mean more action and faster currency velocity. Defaults: work 20m, fish 15m, hunt 25m.
Marketplace
/dashboard/economy/marketplaceToggle, marketplace tax %, listing fee %, active-listing cap, and a read-only browser of every active listing + sale history.
When to use it: See the Marketplace doc — most servers run with 5–8% tax and a 10–25 active-listing cap.
Catalogue Editor
/dashboard/economy/catalogueFull CRUD on /shop items: name, description, price, type, rarity, max stock, icon, item effect, and enabled flag.
When to use it: Click "Add Default Items" on a fresh server to seed a starter catalogue. Use the icon picker to give every item a colorful disc.
Crafting
/dashboard/economy/craftingRecipe definitions: ingredients, products, success threshold, XP reward.
When to use it: Edit recipes here to match the items in your catalogue. Recipes feed both /craft and /cook depending on category.
Holdings
/dashboard/economy/holdingsInventory caps, per-rarity holding limits, equipped slots, bag-expansion behaviour.
When to use it: Set the base inventory cap (default 50). Bag-expansion items increase it permanently for the member who uses them.
Random-drop engine config: enabled/off, drop channel allow list, message-count gate, money-amount range, anti-farm thresholds.
When to use it: See the Items doc. Conservative defaults: drops fire after 30–60 messages, 5–25 coins each, no farming penalty kicks in until 5+ in 10 minutes.
Leaderboard
/dashboard/economy/leaderboardRead-only top earners and per-activity rankings.
When to use it: Useful for picking event winners or running monthly recognition. No config — pure data.
Suspicion scores, drop-cap hits, marketplace anomalies, admin actions log, quarantine list.
When to use it: Check weekly. Most flags resolve themselves automatically — only intervene when a member sits at the top of the suspicion list.
Analytics
/dashboard/economy/analyticsHistorical graphs: earnings velocity, transaction volume, per-activity heatmap, top sinks vs faucets.
When to use it: Use this to spot inflation or stagnation. If the faucet line outpaces the sink line, raise tax or shorten event uptime.
Exchange (separate hub)
/dashboard/exchangeCurrency strength, ledger classification, server economy rating, eligibility checks, Trade Pact readiness.
When to use it: Read-only health board. Once your eligibility ticks all green you can opt into Trade Pacts and the cross-server marketplace.
Where each page writes
For operators integrating against the bot, here's the quick map between dashboard pages and database tables:
eco_config (one row per guild)eco_shop_item_v2eco_recipe + eco_recipe_ingredienteco_audit_log (read-only)eco_market_listing + eco_market_offer (read-only)eco_wallet_v2 + eco_user_skill (read-only joins)eco_ledger + eco_activity_log (read-only aggregates)eco_exchange_snapshot, eco_exchange_pact (read-only)Common admin tasks
Slow inflation
- Open Analytics — confirm faucet > sink.
- Marketplace → raise tax % by 2-3 points.
- Sources → trim max payout on the highest activity by 5-10%.
- Drops → raise the message-count gate.
Boost a quiet weekend
- Activities → halve the cooldown for one activity for the duration.
- Drops → set an event multiplier on the drops page (1.5×–2×).
- Catalogue → enable a limited-edition item with low stock.
Onboard a new server
- Currency → pick name + symbol, set caps.
- Catalogue → click "Add Default Items".
- Marketplace → enable, leave defaults.
- Drops → enable, leave defaults.
- Audit → check back in a week.
Investigate a suspicious member
- Audit → top of the suspicion list.
- Click their row → activity log + drop history.
- If genuine: clear the flag.
- If abuse: quarantine (reversible) → grant rollback if needed.