Dashboard Guide

Every game gets a real-time economy dashboard with metrics, charts, and an AI advisor.

Overview Metrics

The dashboard shows four key health indicators at the top:

📈Gini Coefficient

Wealth inequality (0 = equal, 1 = one player owns everything). Green < 0.4, amber < 0.6, red ≥ 0.6.

💰Gold Minted

Total currency ever created by faucets (grants). Shows the total supply.

🏦Gold in Circulation

Currency currently held by all players. Difference from minted = drained by sinks.

📊Transactions

Total trades, grants, and purchases processed through the economy.

Time-Series Charts

Below the metrics, interactive charts show currency flows over time — total minted, spent, and in circulation. Hover for exact values. Data updates in real time via Convex subscriptions.

Wealth Distribution

A top-10 leaderboard shows the wealthiest players with relative bar charts. Combined with the Gini coefficient, this tells you at a glance whether your economy has concentration problems.

Transaction Feed

A live scrolling feed of recent transactions — each showing timestamp, type (GRANT/SPEND/BUY/TRADE), amount, reason, and player name. Color-coded: grants in green, spends in red, trades in purple.

🤖 AI Economy Advisor

The right sidebar contains a chat interface connected to an AI advisor that has full context on your economy data. Ask questions in plain English:

"Why is gold inflating?"
"Is my economy healthy?"
"What should I change about my pricing?"
"Which items are too cheap?"
"Show me the wealth distribution trend"

The advisor analyzes your live transaction data, player wallets, and currency flows. Toggle Write Mode to let it make adjustments (rebalance prices, adjust faucets) directly.

Accessing the Dashboard

Each game's dashboard is at /games/<slug>/economy. The three built-in showcases have their own dashboards: