Marketplace

Two surfaces, one engine: the in-Discord !sell / !offers flow and the web marketplace at www.synthet.gg/m/<server-id>. Both write to the same tables, both honour the same tax / fee / eligibility rules.

Catalogue vs Marketplace

The catalogue (/shop, !shop) is curated by the admin — fixed items at fixed prices. The marketplace (this page) is player-driven — anyone with a tradeable item can list at any price. Both are configurable independently on the dashboard.

Listing an item for sale

Two paths from the same starting point — pick whichever feels easier.

In Discord

Run /sell (or !sell). The bot opens a dropdown of every marketplace-eligible item in your inventory.

Pick the item. The bot prompts for quantity, price per unit, and an optional recipient.

If you leave the recipient blank, the listing goes to the public marketplace and any member can buy. If you specify a recipient, it becomes a direct offer — only that member can accept it.

Confirm. The item moves into escrow immediately (it leaves your inventory but doesn't belong to the buyer until they accept), and a marketplace card posts in chat with a Buy button if it's a public listing.

On the web

Run /market or !market in any channel. The bot replies with a card containing a link to www.synthet.gg/m/<server-id>.

Open the link. Sign in with Discord if you haven't already. The page lists every active listing on this server plus your inventory at the bottom.

Click Sell next to any inventory row. A modal opens with quantity, price, and optional recipient.

Submit. Same escrow + listing flow as the Discord side — the listing appears for everyone in real time.

Buying from the marketplace

In Discord

When a member lists an item, the marketplace card posts in chat with a Buy button. Click it to purchase one of that listing immediately at the listed price.

For older listings that have scrolled off, run /eco market buy id:<listing-id> with the listing id (visible in the listing's footer).

On the web

Open www.synthet.gg/m/<server-id>. Listings render as cards with the item illustration, rarity tag, seller, quantity, and price.

Use the tabs at the top to switch surfaces: Local (this server's listings) · Global (cross-server Exchange listings, when both servers qualify) · Bank (your personal bank — deposit, withdraw, upgrade tier) · Guild Vault (the server-wide treasury — visible only to the server owner and members holding the Manage Server permission).

Click Buy on any card. The button blocks if your inventory is full, the seller is yourself, or the listing has already sold.

Bank and Guild Vault tabs

The Bank tab on www.synthet.gg/m/<server-id> manages your personal bank — the same balance the bot tracks under !bal. You can deposit from wallet, withdraw back to wallet, and upgrade your tier. Higher tiers raise your bank-balance cap (Tier 1 = 1M, Tier 2 = 25M, Tier 3 = 500M by default; admins tune these in the dashboard).

The Guild Vault tab is the server-wide treasury. Any member with the tab open can see the balance, but only the server owner and members holding the Manage Server Discord permission can deposit, withdraw, or upgrade the vault tier (1 = 100M cap, 2 = 2.5B, 3 = 50B). The upgrade cost comes from the manager's personal wallet — same model as the bank-tier upgrade.

Direct offers

When the seller specifies a recipient, the listing becomes a direct offer — invisible to the rest of the server, only acceptable by the named user.

The recipient receives a DM (if their privacy allows) and sees the offer in their /offers command. The command shows every pending offer with Accept / Decline buttons.

/offers

List your incoming offers.

/offers · Accept

Charge your wallet, transfer the item.

/offers · Decline

Return the item to the seller, no charge.

/eco market cancel

Sellers cancel a public listing they own.

Tax, listing fees, and limits

Three knobs admins set on the Marketplace dashboard page:

Marketplace tax %

Percentage of every sale that goes back to the server pool (sink). Typical setting: 5–10%.

Listing fee %

Up-front fee paid by the seller when posting a listing. Burns on cancel — discourages spam listings.

Active-listing cap

Maximum simultaneous listings any one member can post. Prevents wallet camping.

The buyer pays the listed price exactly. The tax is deducted from the seller's payout behind the scenes — buyers always pay the visible sticker price.

What can be listed

Items with isMarketplaceEligible=true

Default for most catalogue items, fish, hunt loot, gathered materials, crafted gear.

Standard rarity tiers

Common through Mythic. Relic / Unique items often have isMarketplaceEligible=false because they’re bound.

Quest reward items

Almost always bound (isProtected=true). Cannot be listed.

Admin-granted items

Origin = ADMIN_GRANTED. Cannot be listed by default.

Protected items

isProtected=true. Cannot be listed, sold, or stolen.

Listing lifecycle

Active

Posted, item in escrow, visible / acceptable for 7 days.

Sold

Buyer paid, item transferred, seller payout (minus tax) credited.

Cancelled

Seller revoked the listing. Item returned to inventory; listing fee burned.

Expired

No buyer in 7 days. Item returned to seller automatically.

Listings older than 7 days are auto-cleaned by the engine on the next economy tick.

Web vs Discord

Available on Discord

• /sell, /offers, /eco market buy
• Per-listing buttons in posted marketplace cards.
• Notifications when an offer arrives.

Available on the web

• Full listings grid with rarity / price / seller filters.
• Local / Trade Pact / Global Exchange tabs.
• Bulk listing from inventory in one session.
• Pricing insights and recent sale history.

Admin angle

On the Marketplace dashboard page admins can:

Toggle the marketplace on / off.
Set tax %, listing fee %, and the active-listing cap.
Browse every active listing and read-only sale history.
Force-cancel any listing (admin override) — items return to seller, no fee refund.
See pricing analytics — trending items, average sale price, top sellers.