Settings Reference

This page lists every default, limit, and allowed value in one place. For what each feature does, follow the links to the feature pages.

Client settings

These live in Foundry’s module settings under Peddler. Each is per user: every player and the GM set them independently. Logging verbosity for Peddler is controlled from 3DS Atlas, not from Peddler’s own settings.

Setting	Scope	Default	Values
Ambient motion	Client	On	On / Off
Shop sounds	Client	On	On / Off

Ambient motion toggles the drifting dust and lamplight in the vignette on that device. Shop sounds does the same for the coin and chime cues.

World settings

These live alongside the client settings and apply to everyone in the world.

Setting	Scope	Default	Values
Daily Trade Ledger	World	Off	On / Off
Sellable Item Types	World	Blank	Comma-separated item types

Daily Trade Ledger records every completed trade in one Calendaria note per in-world day. It needs Calendaria installed and active. Sellable Item Types names the item types every shop may trade, replacing the list the system adapter supplies. Leave it blank to use the adapter’s own list.

Peddler also registers one hidden world-scope setting as internal storage; it does not appear in the settings window and has nothing for you to configure.

Per-shop settings

Everything below is set per shop in the Shop Settings window.

Settings tab

Setting	Default	Allowed values
Dialogue archetype	None	Any archetype
Shop title	Blank	Up to 60 characters
Shop theme	None	Any theme
Ambient track	Blank	Any sound file path
Shop queue	On	On / Off
Shopkeeper pronoun	They	They / She / He
Rarity field	Blank (adapter default)	Any item field path
Item stats	None	Up to 12 rows
Price the shop charges	1.0	Any number of 0 or more
Price the shop pays	0.5	Any number of 0 or more
Travel destinations	None	Any number of rows; needs the Travel Pace module

The two price fields are covered in Haggling and Pricing. Each travel destination row carries these fields:

Field	Default	Allowed 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

Haggling defaults and bounds, covered in Haggling and Pricing:

Setting	Default	Allowed values
Allow haggling	Off	On / Off
Skills	Any skill	Skills from the system adapter
Custom rolls	None	Up to 8 rows, each a valid roll formula with at least one die
Target DCs	One tier at DC 15, price 0.9	Up to 8 tiers
Tier DC	15	1 to 50, whole numbers
Tier price on a win	0.9	0.1 to 1
Price on a loss	1.1	1 to 5
Once per visit	On	On / Off

Opening hours are off by default, which leaves the shop always open. A new schedule window starts at 9:00 to 18:00 with no days selected. Times accept 24-hour or am/pm formats.

Stock tab

Setting	Default	Allowed values
Exclude Equipped Gear	On	On / Off
Table restock mode	Add to the current stock	Add to the current stock / Clear the stock first
Item row quantity	Blank (no restock)	Any roll formula
Item row infinite	Off	On / Off
Table row draw quantity	1	Any roll formula
Restock cadence	None	Positive whole number plus a unit
Restock on Day Change	Off	On / Off
Market Days	None	Any calendar note categories

The day-change and market-day fields appear only while Calendaria is active.

The restock mode applies only to Roll Table rows. Item rows always restock to what their formula rolls.

Cadence units are hours, days, weeks, months, and 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. How cadences resolve against world time is covered in Stock and Restocking.

History tab

The History tab has no configurable values. It filters and clears the transaction log described in Shop Settings.

Queue tab

The Queue tab has no configurable values. It shows who is in the shop and who is waiting, with controls to force-close the active session, advance to the next visitor, reorder waiters, and remove one from the queue.

Defaults set at shop creation

This value is written when a shop is first configured. It is not exposed in the Shop Settings window.

Value	Default	Allowed values
Stock mode	Tracked	Tracked / Infinite