serenity
4 min read

Marketplace

Player-to-player listings for gear, items, and businesses — browse, buy, sell, and undercut.

Replace [prefix] with your server's prefix.

The marketplace is where players sell to each other, not to the game. Three kinds of things can be listed: equipment, stackable items (materials, consumables, pet eggs — anything in your inventory), and businesses.

// Syntax
[prefix]market

// Example
;market

Opens a browsing view with Browse and Mine tabs. Every listing shows what it is, its price, who's selling it, and when it expires.

The marketplace is never empty. When real listings run low, Serenity itself lists a handful of generated items and gear to keep it worth checking — those show up under the bot's own name and rotate out every few hours.

Listing Gear or Items

// Syntax
[prefix]market sell [item] [price] [quantity] [hours]

// Example
;market sell 1234 500000
;market sell void_crystal 25000 10

Give it an equipment id to list gear, or an item name plus a quantity to list a stack. Either way:

Listing fee2% of the asking price, charged up front, kept whether or not it sells
Sale tax5% out of the seller's payout when it sells
Minimum price1,000
Duration24 hours (up to 72h, donor perk — see below)
Active listingsUp to 20 at once (50, donor perk)

The listing fee is non-refundable. List something nobody buys and you're out 2% of the asking price when it expires and comes back to you.

Listing a Business

// Syntax
[prefix]market sell-business [id] [price] [hours]

// Example
;market sell-business 42 2000000

A separate command from market sell because a business id and an equipment id are both bare numbers — this avoids any ambiguity about which one you mean. Same fee, tax, and duration rules as above. The business leaves your ownership the instant it's listed, same as gear does.

BusinessesA rotating market of passive-income businesses you can buy, upgrade, and trade.

Buying

// Syntax
[prefix]market buy [listing id]

// Example
;market buy 42

Works the same regardless of what's listed — gear, an item stack, or a business. You can't buy your own listing. The seller gets a DM when it sells.

Undercutting

When you list gear or an item that's already listed by someone else, the listing view offers an undercut option — a price set to exactly one coin under the current cheapest ask for that same item. Handy for not having to check the going rate yourself before listing.

Managing Your Listings

// Syntax
[prefix]market mine
[prefix]market cancel [listing id]
[prefix]market extend [listing id] [hours]

// Example
;market mine
;market cancel 42
;market extend 42 24

cancel pulls a listing down early and hands back whatever was listed. extend pushes the expiry out — donor only, since a non-donor's listing is already created at the shared 24-hour duration with nothing to extend into.

Donors get listings up to 72 hours instead of 24, and 50 active listings instead of 20 — see donator perks for the rest of what that unlocks.

Checking Prices

// Syntax
[prefix]market price [material]

// Example
;market price void_crystal

Shows what a material has actually sold for on the marketplace recently — average, lowest, and highest, from real completed sales rather than a fixed vendor price.

Last edited