Settings
Everything you can change from Discord with /server settings or from the
dashboard, grouped the same way in both places.
Setup
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Result-Log channel |
channel (Text) | none bot needs Send Messages + Embeds |
Where sold/expired results post; ignored while Inline Results (Behavior toggles) is on — results post in the listing's own channel instead |
Audit-Log channel |
channel (Text) | none bot needs Send Messages + Embeds |
Where all activity logs post |
Currency symbol |
string | $ |
Default currency display symbol |
Decimal places |
int | 2 ≥ 0 |
Price precision |
Server time |
Time | UTC valid 24-hour time |
Guild timezone |
Economy & currency
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Server Economy |
enum | Disabled Disabled, Built-in (AuctionBot), UnbelievaBoat, Raid-Helper |
Whether balances are required for transactions; which provider |
Default Currency |
currency | first currency any configured currency |
Currency used when none specified |
Cross-currency exchange |
bool | off on/off |
When on, users may convert between their wallet's currency balances using the guild's fixed exchange rates. When off, balances are held/spent per currency only. Backed by the CrossCurrencyExchange feature flag. Holding/using any registered currency is always allowed; this only governs in-wallet conversion. |
Default Starting Balance |
decimal | 0 (disabled) ≥ 0 |
Seeded into a Buyer-role member's built-in-economy wallet right before their first charge (entry fee, settlement, donation) if they don't have one yet. No member/role-change event exists, so this fires lazily off the first debit rather than the instant the role is granted; a balance read or admin credit never seeds it. Meaningless for any Server Economy other than Built-in (AuctionBot). |
Channels
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Result Logs |
channel | — |
sold/expired results destination; ignored while Inline Results (Behavior toggles) is on |
Audit Logs |
channel | — |
activity log destination |
Duration
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Minimum Duration |
TimeSpan | — ≥ 0 |
Lower bound for listing length (RestrictDuration) |
Maximum Duration |
TimeSpan | — > min |
Upper bound |
Default Duration |
TimeSpan | 0 (= use min/max default) within [min, max] |
Used when no duration supplied |
Default to Min/Max |
bool | — |
When Default Duration is 0, pick min (true) or max (false) |
Bidding & timing
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Snipe Trigger |
TimeSpan | Disabled 0, 5s, 10s, 15s, 30s, 1m, 2m, 3m, 5m |
Window before end where a bid triggers extension |
Snipe Extension |
TimeSpan | — time period |
Amount added on a snipe |
Bidding Recall Limit |
TimeSpan | — Disable (0), 5s, 10s, 15s, 30s, Always (sentinel) |
Window to undo own bid |
Minimum Bid Limit |
Delta (absolute + percentage) | 0 each value > 0 when set |
Minimum amount a bid must increase by |
Min Bid Button |
bool (HideMinMaxButtons) | shown |
Show/hide the min-bid button on auctions |
Limits
| Setting | Type | Starts as | What it does |
|---|---|---|---|
User Listing Limit |
int (MaxListingsLimit) | 0 (unlimited) > 0 to enable |
Max active listings per user; Brokers/Managers exempt |
Behavior toggles
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Early Offer Acceptance |
bool (AcceptOffers) | — |
Allow accepting an offer and closing before end. Auctions: enables the Accept Offer button once a bid exists. Giveaways: enables the Draw Now button (owner-only; draws immediately once ≥ 1 entrant exists) — Draw Now is also shown once the giveaway's Max Participant Limit is reached, regardless of this setting. |
Shill Bidding |
bool (ShillBidding) | — |
Owners may bid on their own listings |
Recall Listings |
bool (RecallListings) | — |
Owners may withdraw after an offer exists |
Min Bid Button |
bool (HideMinMaxButtons) | — |
Off = hide the min/max bid buttons |
Sealed Payout |
bool (SealedPayout) | — |
Sealed winner pays second-highest vs own bid |
Donations |
bool (Donations) | — |
Enable user-to-user gifting (/economy give); built-in economy only |
Confirm Transactions |
bool (ConfirmTransactions) | — |
Require owner confirmation for market/trade completion (economy disabled) |
Attach Logs |
bool (AttachLogs) | — |
Attach full bid log file to auction result message |
Auto-Reschedule |
bool (DisableRelisting) | — |
On = prevent auto-reschedule/relisting |
Inline Results |
bool (InlineResults) | off |
All showroom types: keep a concluded listing's result in place instead of deleting it once there's no relist path — a Category showroom's auto-created channel, a Text/News message, or a Withdrawn Forum post (locked and archived, same as Sold/Expired) — and post the separate result-log entry in that same channel instead of the Result Logs channel (Channels group), which is ignored while this is on. One setting for both — restores legacy's ResultLogChannelId == 1 behavior as part of it rather than a second toggle. |
Confirm Purchases |
bool (ConfirmPurchases) | off |
Insert an ephemeral Confirm/Cancel step before Buy Now, Buy All, and the direct Trade fulfil button execute (#83.3). Off by default so the default surface stays single-click. |
Access roles
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Manager Role |
role | unset (Manage-Server qualifies) |
Admin over any listing + economy admin |
Broker Role |
role | unset (Manage-Server qualifies) |
List on behalf of others |
Merchant Role |
role | @everyone |
Create own listings |
Buyer Role |
role | @everyone |
Participate (bid/buy/join) |
Allowed listings
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Allowed Listings |
set of the 12 listing types | — |
Which listing types members may create; unselected types are blocked |
Showrooms
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Showroom channel |
channel | — one per family; Text/News/Forum/Category |
Where a listing family posts |
Listing family |
enum | — Auction/Market/Trade/Giveaway |
Binds the channel to a family |
Opens At / Closes At |
Time | — both required together; valid 24-hour; supports overnight |
Business hours; listing/start/end must fall within |
Fixed schedule |
list of (Weekday, Time) slots | none each day a real DayOfWeek; at most 28 slots |
Channel-wide (not per-family) — forces every listing in that channel to end at the next slot. Parsed from, and written directly to, the channel's own Discord topic (a Schedule: line) rather than a database column; an empty slot list is how it's disabled. |
Categories & currencies
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Categories |
list | — title ≤ 25 chars |
Classify listings; a subcategory requires its category |
Currencies |
list | first registered = default unique by code |
Code, symbol (may be a Discord custom emoji), decimals, minimum amount; the minimum amount gates bid/price minimums |
Exchange rates |
rate per currency | — requires Cross-currency exchange on |
Fixed rate = units of that currency per 1 unit of the default currency; used only by the wallet convert action; a missing rate makes that conversion unavailable |
Fees
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Listing Fee |
fixed amount | — |
Deducted from owner on listing creation; credited to the guild's Discord owner |
Broker Fee mode |
enum | — Fixed vs percentage |
Controls the fee charged when a Broker lists for an owner |
Broker Fee |
amount | — |
Charged when a Broker lists for an owner, credited to that broker. Fixed mode: charged at creation, non-refundable. Percentage mode: charged at completion against the final sale price, skipped if the listing doesn't sell |
Entry Fee mode |
enum | — Fixed vs percentage |
Controls premium-auction entry fee |
Percentage Fee |
percentage | — |
Deducted from sale on completion; credited to the guild's Discord owner. Trades are exempt; balance-dependent fees apply only with the built-in economy. |
Announcements
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Custom message (Default) |
template string | — {owner} {winner} {quantity} {itemName} {listingType} {forumPost} {@RoleName} |
Fallback announcement template used when a listing family has none set |
Custom message (Auction) |
template string | — {owner} {winner} {quantity} {itemName} {listingType} {forumPost} {@RoleName} |
Auction-specific override |
Custom message (Market) |
template string | — {owner} {winner} {quantity} {itemName} {listingType} {forumPost} {@RoleName} |
Market-specific override |
Custom message (Trade) |
template string | — {owner} {winner} {quantity} {itemName} {listingType} {forumPost} {@RoleName} |
Trade-specific override |
Custom message (Giveaway) |
template string | — {owner} {winner} {quantity} {itemName} {listingType} {forumPost} {@RoleName} |
Giveaway-specific override |
Custom message (Listing) |
template string | — {owner} {winner} {quantity} {itemName} {listingType} {forumPost} {@RoleName} |
Listing-specific override |
Listing requirements
| Setting | Type | Starts as | What it does |
|---|---|---|---|
Image |
bool (per listing family) | off |
Require an attached image at creation |
Description |
bool (per listing family) | off |
Require an item description at creation |
Category |
bool (per listing family) | off |
Require a category selection |
Subcategory |
bool (per listing family) | off |
Require a subcategory selection |
Hidden Message |
bool (per listing family) | off |
Require a message to winner/buyer |
Max Bid Increase |
bool (auctions only) | off |
Require a maximum bid increment (auctions only) |