Overview
Dashboard

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.

Top-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 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.

Per-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.

Cooldowns 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.

Toggle, 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.

Full 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.

Recipe 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.

Inventory 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.

Read-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.

Historical 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/exchange

Currency 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:

Currency / Sources / Activities / Marketplace / Holdings / Dropseco_config (one row per guild)
Catalogue Editoreco_shop_item_v2
Craftingeco_recipe + eco_recipe_ingredient
Auditeco_audit_log (read-only)
Marketplace listingseco_market_listing + eco_market_offer (read-only)
Leaderboardeco_wallet_v2 + eco_user_skill (read-only joins)
Analyticseco_ledger + eco_activity_log (read-only aggregates)
Exchangeeco_exchange_snapshot, eco_exchange_pact (read-only)

Common admin tasks

Slow inflation

  1. Open Analytics — confirm faucet > sink.
  2. Marketplace → raise tax % by 2-3 points.
  3. Sources → trim max payout on the highest activity by 5-10%.
  4. Drops → raise the message-count gate.

Boost a quiet weekend

  1. Activities → halve the cooldown for one activity for the duration.
  2. Drops → set an event multiplier on the drops page (1.5×–2×).
  3. Catalogue → enable a limited-edition item with low stock.

Onboard a new server

  1. Currency → pick name + symbol, set caps.
  2. Catalogue → click "Add Default Items".
  3. Marketplace → enable, leave defaults.
  4. Drops → enable, leave defaults.
  5. Audit → check back in a week.

Investigate a suspicious member

  1. Audit → top of the suspicion list.
  2. Click their row → activity log + drop history.
  3. If genuine: clear the flag.
  4. If abuse: quarantine (reversible) → grant rollback if needed.