DASHBOARD GUIDE
Fun hub
The Fun hub is the umbrella for every social and game-like feature in SYNTHET. From here you can open economy, shop, games, leaderboards, birthdays, music tracking, game night, campaigns, guilds, and houses.
Path
DashboardEngagementFunModule
funRequired permission
fun.viewBefore you start
The Fun hub is the launch pad for many sub-modules. A few things should be in place first.
- The Fun module is enabled on the server (the Enable Fun button shows when it isn’t).
- Your role has the fun.view permission to load the hub at all.
- For currency-related actions you also need fun.economy.manage.
- PRO and PREMIUM tiers unlock guilds, houses, game night, and campaigns. The hub still loads on FREE — those tiles just show a tier badge.
- A general or off-topic channel exists for command output (like /balance, /leaderboard, /quote).
What you'll see
The Fun hub itself isn't tabbed \u2014 it's a stat strip plus a tile grid that links to dedicated dashboards.
Stats strip
Modules grid
Tier badges
Refresh
Stats strip
Currency name and symbol, total wallets, transactions today, and total currency in circulation.
Modules grid
One tile per sub-module. Click a tile to open the module-specific dashboard.
Tier badges
PRO and PREMIUM tiles are tagged so you know which features need a paid plan.
Refresh
A refresh button in the header re-pulls counts and economy stats on demand.
Stats strip
Four cards at the top of the hub summarise the state of your economy.
What each card means
- Currency
- Your server's currency symbol and name. Defaults to a coin emoji and the word Coins until you change them in Fun > Economy.
- Wallets
- Total number of users that have ever earned, received, or held currency on this server.
- Transactions today
- Currency transactions recorded since midnight server time, including earnings, transfers, shop purchases, and admin grants.
- In circulation
- The sum of every wallet plus banked balance — a quick sanity check on inflation.
Live data
Stats refresh whenever you open the page or click Refresh. There's no caching toggle to flip — the numbers are pulled directly from the API each time.
Modules grid
Each tile opens a dedicated dashboard. Tiles are colour-coded with the economy accent and tagged with their tier when relevant.
Always-available modules
- Confessions — anonymous post system. Opens DashboardFunConfessions.
- Economy — currency, sources, sinks, shop, banks, defense, claims, seasons, work, fishing, hunting, cooking, heist, enforcement, audit. Opens DashboardFunEconomy.
- Shop items — manage items, prices, stock, and roles for sale. Opens DashboardFunShop.
- Games — slot, blackjack, roulette, dice, trivia toggles and house edge. Opens DashboardFunGames.
- Quotes — server quote book, attribution, and channel routing. Opens DashboardFunQuotes.
- Leaderboards — voice, messages, currency, and XP rankings. Opens DashboardFunLeaderboard.
- Birthdays — collect dates, announce, and gift currency. Opens DashboardBirthdays.
- FM (last.fm) — link last.fm and post now-playing cards. Opens DashboardFunFM.
- Audit log — every change made anywhere under Fun. Opens DashboardFunAudit.
Tiered modules
- Game Night (PREMIUM) — schedule recurring game sessions, RSVPs, and reminders.
- Campaigns (PREMIUM) — multi-week storyline events with stages and rewards.
- Guilds (PRO) — opt-in player guilds with their own xp, treasury, and ranks.
- Houses (PRO) — server-wide team factions with weekly point totals and seasonal scoring.
Economy sub-dashboard
The Economy tile opens the densest dashboard in the Fun hub. It uses tabs of its own \u2014 here's what each one covers.
OverviewCurrencySourcesSinksShopMarketplaceCraftingBanksDefenseClaimsSeasonsEnforcementAuditWorkFishingHuntingCookingHeist
| Setting | Type | Default | Description |
|---|---|---|---|
| Currency name | Text | Coins | Plural noun used in command output and embeds. |
| Currency symbol | Emoji / text | coin emoji | Short symbol shown next to amounts. |
| Starting balance | Number | 0 | Currency given to a wallet on first interaction. |
| Max wallet balance | Number | 1,000,000 | Hard cap on a user wallet (banked funds count separately). |
| Max bank balance | Number | 10,000,000 | Cap on the bank-held portion of a user funds. |
| Integer only | Toggle | On | Reject fractional amounts in transfers and rewards. |
| Earning sources | Multi-toggle | All on | Master switches for daily, work, fishing, hunting, cooking, heist, gather, craft. |
| Spending sinks | Multi-toggle | All on | Switches for shop, marketplace, banks, claims, gambling. |
Use the Audit tab when balances look wrong
The Economy tab has its own audit log that records every grant, deduction, and config change. Filter by user or action to track down a discrepancy quickly.
Shop, games, leaderboards & quotes
Quick map of the simpler sub-dashboards.
Shop items
- Add an item with name, description, price, optional stock, and category (consumable, role grant, booster, tool, cooking ingredient, loot crate).
- Roles can be granted on purchase — pick the role from the searchable selector.
- Toggle Featured to pin an item in /shop output.
- Each row supports edit, duplicate, archive, and delete.
Games
- Master switch per game: slot, blackjack, roulette, dice, trivia, coinflip, rock-paper-scissors.
- House-edge sliders, min/max bet, and per-game cooldown.
- Optional channel allow-list — restrict gambling to a single channel if you want.
Leaderboards
- Pick which boards to expose: messages, voice minutes, currency, level, custom XP.
- Set a refresh cadence and a top-N (default top 10).
- Optionally route a daily or weekly snapshot to a channel.
Quotes
- Add quotes manually with attribution, or capture them from Right-click → Apps → Add quote.
- Browse the server quote book with search and tag filters.
- Configure where /quote posts and whether anonymous quotes are allowed.
Confessions
Anonymous post box, with an optional staff approval queue, blocked-words list, and per-user cooldown.
FM (last.fm)
Pair user accounts to last.fm, schedule periodic now-playing posts, and configure embed style.
PRO and PREMIUM modules
Tiles tagged with a tier badge load only on the matching subscription. The hub still shows them so you can preview what you'd unlock.
Game Night
Schedule recurring or one-off play sessions. Members RSVP, get reminders, and receive a recap when the session ends.
Campaigns
Multi-week themed events with stages, currency rewards, leaderboards, and a finale ceremony post.
Guilds
Player-run guilds with their own treasuries, member ranks, and inter-guild competition.
Houses
Server-wide factions. Members earn house points from any participating module, and you crown a winner per season.
Common tasks
Three workflows that touch the hub directly.
1
Enable Fun for a brand new server
Open DashboardFun.
- If the module is off you'll see an empty state with an Enable Fun button. Click it.
- The hub reloads with the stats strip and the modules grid.
- Open Economy first and set the currency name, symbol, and starting balance.
- Open Shop and add at least one item so /shop isn't empty.
- Optionally turn on the modules you want from the grid (Birthdays, FM, Quotes).
2
Spot-check the economy
Open DashboardFun.
- Look at the In circulation card. Has it grown unexpectedly?
- Click Economy, switch to Audit, and filter to today.
- Look for unusually large grants or refunds. Cross-check with the originating user.
- If you find an issue, use the Enforcement tab in Economy to deduct or freeze.
3
Open the global Fun audit log
Open DashboardFunAudit.
- The Audit log tile in the modules grid jumps straight to /dashboard/fun/audit.
- Filter by sub-module (economy, shop, quotes, games, etc.) and time range.
- Click any row for the JSON-style payload of the change.
Troubleshooting
Things to check when the hub isn't behaving.
The hub keeps showing 'Module disabled'
You toggled the master switch off, the bot lost permission, or your session lost the server context. Reload, pick the right server in the sidebar, and click Enable Fun again. If the toggle won't stick, check your role has fun.manage.
A tile says 'Tier required' when I open it
Guilds, Houses, Game Night, and Campaigns require PRO or PREMIUM. Either upgrade in DashboardBilling or hide the tile from your team's view by turning the module off in Fun → Economy.
Stats strip shows zero everywhere
The hub reads from /api/servers/:id/fun and /api/servers/:id/fun/economy. A 0 across the board usually means no commands have been run yet. Run /balance or grant a small amount via the Economy tab to confirm everything is wired up.
Currency symbol renders as a question mark
Discord falls back to a placeholder when the chosen emoji isn't accessible to the bot in that channel. Either pick a Unicode emoji or upload the custom emoji to a server the bot is in.