Getting Started

Your first hour with the SYNTHET economy

Two short walkthroughs: one for members who just want to start earning, one for admins turning the economy on for the first time. No prior experience required.

For members — earn, spend, and progress

Everything below works as both a slash command (start typing / in Discord) and a prefix command (start with !). The aliases shown after each command are interchangeable.

Check your balance

Run /balance (or !bal). You'll see three numbers: wallet (spendable), bank (protected from theft), and net worth (the total). Brand-new members start at zero.

Claim your daily reward

/daily gives you a baseline payout that resets every 24 hours. /weekly does the same on a 7-day cooldown with a much larger payout. Both track a streak — the longer your streak, the bigger the bonus.

Pick an activity

Active income comes from activities. Try them in any order:

/work — pick a job from your unlocked tier and clock in.
/fish — cast a line in your unlocked biome.
/hunt — track creatures in your unlocked region.
/gather — collect raw materials.
/cook — turn ingredients into food.
/craft — assemble materials into gear.

Each activity has its own cooldown and its own skill level (1 → 100).

Bank your earnings

Coins in your wallet can be stolen via /rob. Coins in your bank cannot. Run /eco bank deposit <amount> to move funds, or the matching withdraw when you want to spend.

Open your inventory

Activities drop items. /inv opens a card with every stack you own — name, rarity, quantity, source, and whether it's marketplace-eligible. Click any row to view, use, info, or sell.

Use a booster

Many items have effects (+25% fish XP for 30m, cooldown reset, bag expansion, …). Run /eco item use, pick the item from the dropdown, and the effect activates immediately. Active effects appear at the top of your /inv card.

Trade with other members

Two paths:

In Discord: !sell opens a dropdown of your inventory items. Pick one, set a price, and either list it on the marketplace for anyone to buy, or send a direct offer to a specific user. The buyer accepts via !offers.
On the web: /market or !market hands you a link to www.synthet.gg/m/<server-id>. Browse every active listing, buy with one click, list your own items inline, and use the Bank tab to deposit / withdraw / upgrade your personal bank tier. Server owners and members holding Manage Server also get a Guild Vault tab for the server-wide treasury.

See Marketplace.

Track your levels

/profile shows your level + XP for every skill plus lifetime stats (coins earned, items found, fish caught, …). Higher levels unlock new biomes, regions, job tiers, and recipes — every level up also pays a one-time coin bonus.

For admins — turn the economy on

The economy is opt-in per server. The dashboard at www.synthet.gg/dashboard/economy is the one place you configure everything.

Open the Economy hub

Set the currency

Open Currency. Pick a name (Coin, Bit, Gem, …) and a symbol ($, 🪙, an emoji, anything). These appear on every card, embed, and marketplace label. Set wallet / bank caps and the daily / weekly base amounts here too.

Tune the activities

Sources sets how much each activity pays at each tier (work / fish / hunt / cook / craft / gather / crime / rob / beg). Cooldowns live on Activities. The defaults are a sensible starting point — you can ship and tune later.

Curate the catalogue

Catalogue Editor is where you add the items members can buy from /shop. Each row carries a name, price, rarity, stock, an icon (pick from the colorful library — same icons the bot paints on cards), and any item effect. Click Add Default Items on a fresh server to seed a starter catalogue.

Configure the marketplace

Marketplace is for the player-to-player marketplace (different from the catalogue). Toggle the marketplace on, set the tax %, the listing fee %, and the active-listing cap per member.

Configure random drops

Drops controls the random-drop engine — base chance, rarity distribution, anti-farm thresholds, channel allow/deny, message-count gates. Defaults are conservative; the engine respects per-user and per-rarity caps automatically.

Set up the Exchange

Exchange shows your server's economy health, currency strength, and Trade Pact eligibility. Most of this is read-only — you only need to enable participation if you want your server to trade with others.

Watch the audit page

Audit surfaces unusual activity (suspicion scores, drop-cap hits, marketplace anomalies). Glance at it weekly. The majority of the integrity work happens automatically — caps kick in before any single member can dent the economy.

Common pitfalls

Members don't see anything happening when they run a command

Most likely the economy is disabled, the channel is excluded, or the member doesn't have the required role. Double-check the toggles on the Currency page and the channel/role allow lists on the relevant module page.

Cards appear without illustrations on Discord

The bot needs @napi-rs/canvas at runtime. On a fresh self-host the first card render also downloads fonts. If the icons render as letters, that's the canvas module being unavailable; raise the issue with your operator.

A member's marketplace link returns 'Session required'

Their browser session is bound to one host (apex vs www). Have them open www.synthet.gg first, sign in, then click the bot's link again.

An item shows the raw id like fish_muskellunge

That ID came from a non-catalogue item and slipped through an older join path. The humanizer (Fish Muskellunge) is in place; if you still see one, it's a stale build — tell your operator to redeploy.

Where to next

Wallets & Banking

Caps, escrow, daily / weekly, peer transfers.

Work

53 jobs across 10 tiers, four career paths.

Fishing

6 biomes, 49 species, weight variance.

Hunting

6 regions, 38 creatures, boss encounters.

Items, Rarity & Drops

Inventory, effects, the random-drop engine.

Marketplace

Player listings, web marketplace, offers.

Dashboard Guide

Every Economy + Exchange surface, page-by-page.

Configuration Reference

Every config knob with its default and effect.