Settings Reference
Wiki updated as of 0.7.0 (Oct 2026)Every default, limit, and allowed value in Peddler lives on this page.
Peddler Settings
Section titled “Peddler Settings”Open Configure Settings, choose Peddler, and click Open Settings. Only the GM can open this window. The Shop Sounds client setting applies to the GM’s own device.
General tab
Section titled “General tab”| Section | Setting | Scope | Default | Values |
|---|---|---|---|---|
| Queue | Queue Prompt Timeout | World | 30 | 0 to 600 seconds, in steps of 5; 0 waits forever |
| Queue | Queue Chip Position | World | Top Right | Top Right / Top Left / Bottom Right / Bottom Left |
| Queue | Default Shop Queue | World | On | On / Off |
| This Device | Shop Sounds | Client | 0.4 | Volume from 0 to 1, in steps of 0.05 |
| World | Ambient Motion | World | On | On / Off |
| World | Shopkeeper Breathing | World | On | On / Off |
| World | GM Observer Whispers | World | Off | On / Off |
| World | Whisper Trade Item Lists | World | Off | On / Off |
Default Shop Queue sets the starting queue value for newly created shops. The World section also holds the Manage Named Events and Import buttons.
Economy tab
Section titled “Economy tab”| Section | Setting | Scope | Default | Values |
|---|---|---|---|---|
| Pricing | Default Sell Rate | World | 0.5 | 0 to 5, in steps of 0.05 |
| Pricing | Money Display | World | Decimal | Decimal / Coins |
| Trading | Attunement & Encumbrance | World | Warn only | Warn only / Block the purchase |
| Records | Daily Trade Ledger | World | Off | On / Off |
Default Sell Rate applies to every shop whose own Sell Modifier is blank. Reset every shop under Pricing clears each shop’s Sell Modifier. Daily Trade Ledger appears only while Calendaria is active. Pricing is covered in Haggling and Pricing.
System tab
Section titled “System tab”The tab is labelled with the active system’s id. Its sections are Item Paths, Actor Paths, Attunement, Skills, Currency, Trading, Item Stats, Reference Effects, and Capabilities. Every field defaults to the value the system adapter supplies, and clearing a field returns it to that value. Table fields hold up to 20 rows. Capabilities is a read-only list of what the adapter supports.
| Field | Default | Values |
|---|---|---|
| Sellable Item Types | Adapter’s list | Comma-separated item types, or * for all |
| Default Stock | Adapter’s value | Any number, or infinite |
Shop Settings
Section titled “Shop Settings”Each shop sets these in its own Shop Settings window.
Settings tab
Section titled “Settings tab”| Section | Setting | Default | Values |
|---|---|---|---|
| Keeper | Shop Enabled | On | On / Off |
| Keeper | Dialogue Archetype | None | Any archetype |
| Keeper | Shop Title | Blank | Up to 60 characters |
| Keeper | Shopkeeper Pronoun | Androgynous | Androgynous / Feminine / Masculine |
| Appearance | Theme | Default Look | Any theme |
| Appearance | On tap | None | Up to 6 items |
| Appearance | Accent Color | #c9a86a | Any color |
| Appearance | Ambient Track | Blank | Any audio file |
| Appearance | Quiet the Scene Music | Off | On / Off |
| Appearance | Canvas Reveal | Off | On / Off |
| Availability | Enforced | Off | On / Off |
| Availability | Override | Follow the windows | Follow the windows / Force open / Force closed |
| Availability | Token on Close | Leave it | Leave it / Hide it / Delete it |
| Pricing | Tab Limit | Off | 1 or more |
| Pricing | Merchant Funds | Exact amount | Exact amount / Vague tier / Hidden |
| Pricing | Special Order Payment | Upfront | Upfront / On collection / Half now, half on collection |
| Pricing | Shop Queue | Default Shop Queue | On / Off |
| Pricing | Purchase Mode | Confirm | Confirm / Free / Locked |
| Pricing | Buy Modifier | 1 | 0 or more |
| Pricing | Sell Modifier | Blank (Default Sell Rate) | 0 or more |
| Pricing | Theft DC | Off | 1 to 50 |
| Pricing | Goodwill Lost When Caught | 1 | Any number |
| Hidden Stock | Search DC | Off | 1 to 50 |
| Back Room | Goodwill | Off | Any whole number |
| Back Room | Discovery | Off | 1 or more |
A new opening-hours window starts at 9:00 to 18:00 with no days selected. Times accept 24-hour or am/pm formats.
Haggle settings, covered in Haggling and Pricing:
| Setting | Default | Values |
|---|---|---|
| Enabled | Off | On / Off |
| Skills | Blank (any skill) | Skills from the system adapter |
| Custom Rolls | None | Up to 8 rows, each a roll formula with a die |
| Price Ladder | One tier at DC 15, price 0.9 | Up to 8 tiers |
| Tier DC | 15 | 1 to 50 |
| Tier and Otherwise price | 0.9 / 1.1 | 0.1 to 5 |
| Once per Visit | On | On / Off |
| Push-Your-Luck Re-rolls | Off | 1 or more |
| Goodwill Cost per Re-roll | 1 | Any number |
Tavern shops add a happy hour:
| Setting | Default | Values |
|---|---|---|
| Happy Hour Starts | 17 | Hour, 0 to 23 |
| Happy Hour Ends | 19 | Hour, 0 to 23 |
| Happy Hour Modifier | 0.8 | 0 or more |
| Allow Unlimited Play | Off | On / Off |
Black Market, Spymaster, and Hacker shops add heat settings:
| Setting | Default | Values | Archetypes |
|---|---|---|---|
| Warm price multiplier | 1.15 | 0 to 10 | All three |
| Hot price multiplier | 1.3 | 0 to 10 | All three |
| Heat lasts (hours) | 72 | 1 to 8760 | All three |
| Raid chance (%) | 25 | 0 to 100 | All three |
| Shut after a raid (hours) | 72 | 1 to 8760 | All three |
| Lay low (hours) | 168 | 1 to 8760 | All three |
| Lean DC | 14 | 1 to 99 | Black Market |
| Lean success multiplier | 0.85 | 0 to 10 | Black Market |
| Lean failure multiplier | 1.1 | 0 to 10 | Black Market |
| Rough papers DC | 10 | 1 to 99 | Black Market |
| Passable papers DC | 15 | 1 to 99 | Black Market |
| Perfect papers DC | 20 | 1 to 99 | Black Market |
| Lead lasts (hours) | 72 | 1 to 8760 | Spymaster and Hacker |
| Trusted whisper every (days) | 7 | 1 to 365 | Spymaster |
| Low tier DC | 10 | 1 to 99 | Spymaster and Hacker |
| Middle tier DC | 15 | 1 to 99 | Spymaster and Hacker |
| High tier DC | 20 | 1 to 99 | Spymaster and Hacker |
Applying the Black Market archetype sets Sell Modifier to 0.8 of the Default Sell Rate.
Travel Fares appear only while the Travel Pace module is active. Each destination row carries:
| Field | Default | Values |
|---|---|---|
| Destination | Blank | Any text |
| Distance | 0 | 0 or more |
| Pace | Normal | Slow / Normal / Fast |
| Fare Type | Per Distance | Per Distance / Flat |
| Fare | 0 | 0 or more |
Stock tab
Section titled “Stock tab”| Setting | Default | Values |
|---|---|---|
| Rarity Field | Blank (adapter default) | Any item field path |
| Item Stats | None | Up to 12 rows |
| Exclude Equipped Gear | On | On / Off |
| Hide Out-of-Stock Items | Off | On / Off |
| Keep Depleted Items | Off | On / Off |
| Max Purchase Per Sale | Blank (no cap) | 1 or more |
| Buyback Markup | Blank | 0 or more |
| Announce Restocks | Off | On / Off |
| Default Stock | Tracked | Tracked / Infinite |
| Item row Quantity | Blank (never restocks) | Any roll formula |
| Item row Infinite | Off | On / Off |
| Item row Chance | 100 | 1 to 100 |
| Table row Items to Roll | 1 | Any roll formula |
| Table Restock | Add | Add / Reset / Wipe |
| Items Per Draw | 1 | 1 or more |
| Restock on Day Change | Off | On / Off |
| Market Days | None | Calendaria categories and named events |
Restock on Day Change and Market Days appear only while Calendaria is active or the world has named events.
Restock cadences take a whole number of 1 or more plus a unit: hours, days, weeks, months, or years. The default unit is days. Unit lengths follow the active world calendar. Without a calendar, Peddler assumes a 24-hour day, a 7-day week, 12 months, and a 365-day year. Cadences are covered in Stock and Restocking.