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, so every player and the GM can set them independently.

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 toggles the coin and chime cues on that device.

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
Shopkeeper pronoun	They	They / She / He
Rarity field	Blank (adapter default)	Any item field path
Item stats	None	Up to 12 rows

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 DC	15	1 to 50, whole numbers
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
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

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.

Defaults set at shop creation

These values are written when a shop is first configured. They are not exposed in the Shop Settings window. Dialogue tree effects can change the price modifiers at runtime; the other values are internal shop data.

Value	Default	Allowed values
Concurrency	Queue	Queue / Parallel
Buy price modifier	1.0	Any number of 0 or more
Sell price modifier	0.5	Any number of 0 or more
Stock mode	Tracked	Tracked / Infinite

Concurrency controls whether players take turns or shop simultaneously, covered in Queue and Sessions. The buy and sell modifiers scale what the shop charges and what it pays, covered in Haggling and Pricing.