Shop Settings

Each shop has its own settings window. Open it with the Peddler Shop Settings button in the shop actor’s sheet header. The window has four tabs: Settings, Stock, Queue, and History. The Queue tab is hidden while Shop Queue is off.

The footer holds Edit Shop Tree, Export Shop, Reset, and Save Configuration. Save Configuration writes the Settings and Stock tabs. Reset discards unsaved edits, and closing the window with unsaved edits asks for confirmation. Region, mount, restock, log, and queue buttons act immediately.

Export Shop downloads the shop’s settings and dialogue tree as a file. Import it with Import Shops in the module settings, listed on the settings reference.

Settings

Keeper

Shop Enabled turned off hides the shop from every player, even inside its region.

Edit Actor opens the actor sheet, where the portrait, name, and pronouns come from. Remove Shop deletes everything Peddler stored on the actor and keeps the actor and its items. The confirmation can also delete the dialogue journal. It refuses while someone is shopping.

Dialogue Archetype picks a ready-made shop script from the archetype library. Saving a different archetype asks for confirmation, then replaces the dialogue tree, shop title, theme, accent color, and usually the ambient track. Some archetypes also replace opening hours, haggling, and the tab limit. Theme, title, accent, and track changes made in the same save are kept.

Shop Title is the name on the shop’s sign and in chat cards. Shopkeeper Pronoun controls how the shop’s own lines refer to the shopkeeper.

Appearance

Field	What it does
Theme	The shop’s look and layout. The hint names its chassis. See Themes and Chassis.
Room	Which building the shop occupies, for themes that offer rooms.
On tap	Taproom Counter theme only. The items poured behind the bar.
Accent Color	Overrides the theme accent.
Backdrop Image	Overrides the theme backdrop.
Font Override	Font for the shop’s body text.
Ambient Track	A sound file looped during a visit.
Quiet the Scene Music	Lowers the scene’s playlist while a player is inside.
Canvas Reveal	Lets the real scene show through behind the shop backdrop.

Availability

Enforced puts the shop on its opening hours. While it is off, the shop is always open. Override forces the shop open or closed, ignoring the hours, until you set it back.

Each opening window has days, an Opens and Closes time, and an optional Tag that dialogue conditions can read. Add Window creates more windows for split schedules.

Holiday Festivals and Holiday Categories close the shop on days carrying those Calendaria festivals or calendar note categories, while hours are enforced. They appear only when the calendar has options to pick.

Draw Region minimizes the window so you can draw a region on the current scene. A player token entering it opens the shop. Once linked, the button becomes Modify Region, and the trash button deletes the region.

Token on Close leaves, hides, or deletes the shop’s token when the last player leaves.

Pricing

Tab Limit is how much a buyer can owe the shop. Leave it blank to turn off running a tab. Merchant Funds sets how much of the shop’s coin the sell screen shows. Special Order Payment sets when a buyer pays for a special order.

Shop Queue serves one player at a time, with later arrivals waiting their turn. Turning it off clears the line and the active visit. See Queue and Sessions.

Purchase Mode decides how a trade settles. Confirm shows a settle-up screen, Free settles instantly, and Locked sends every purchase to you for approval.

Buy Modifier multiplies what a player pays. Sell Modifier multiplies what the shop pays for an item a player sells. Leave it blank to follow the world default. Per-Player Price Modifiers lists price modifiers set for individual players, and the trash button clears one.

Theft DC turns on stealing. Leave it blank to turn stealing off. Allowed Skills limits the check, and Goodwill Lost When Caught sets the penalty for a failed attempt.

Haggle

Enabled lets a player argue the price at the confirm screen. Skills limits which skills the player may use. Custom Rolls adds named roll formulas as alternatives. A warning appears when the system has no haggling skills and no custom roll is set.

Price Ladder pairs each DC with a price multiplier, an optional label, and a goodwill change. Only the highest DC the player beats counts. The Otherwise row applies when the haggle fails.

Once per Visit limits haggling to one attempt. With it on, Push-Your-Luck Re-rolls lets a buyer pay goodwill for extra attempts, at the Goodwill Cost per Re-roll. See Haggling and Pricing.

Hidden Stock

Hidden Stock Table is a roll table of items a player finds only by searching. Search DC is the check to beat, and the skills field limits which skills count.

Archetype sections

Tavern shops show Tavern: Happy Hour, with start and end hours, a happy-hour buy multiplier, and Allow Unlimited Play for tavern games.

Stable shops show Mounts. Pick an Actor folder or compendium as the Mount source, then click Stock mounts and tick the creatures to add as stock rows. Set their prices on the Stock tab.

Black Market, Spymaster, and Hacker shops show a section named after the archetype. It holds the heat price multipliers, heat and raid timers, raid chance, lay-low timer, and roll difficulties. Each field is listed on the settings reference. Fees are set on the choices in the Dialogue Tree Editor.

Back Room

Items marked Back Room on the Stock tab stay hidden until the buyer meets any one condition. Hand-picked players always have access. Goodwill unlocks at a goodwill value, and Discovery unlocks after a number of visits.

Travel Fares

Travel Fares appears when the Travel Pace module is active. Each destination has a name, a distance in Travel Pace’s units, a pace, a fare type, and a fare. A flat fare is charged once. A per-distance fare is multiplied by the distance. Add Destination opens a dialog, and the pencil and trash buttons edit and remove a row. The dialogue tree offers passage through a fare node.

Stock

The Stock Rules section holds Rarity Field, Item Stats, and Exclude Equipped Gear. See Stock and Restocking.

Queue

The Queue tab shows who is inside the shop and who is waiting, with controls to reorder, remove, force-close, or advance. The tab label shows how many players are waiting. See Queue and Sessions.

History

The Ledger section totals revenue, transactions, and average sale. Once a theft has been attempted, it also shows the caught-stealing rate. It charts top customers and most popular wares, and lists outstanding tabs.

The Log section records trades, visits, dialogue choices, thefts, and tab activity. Log Cap sets how many entries it keeps. Filter by type, player, or period, including a custom date range. Clear Log empties the record after a confirmation.

The Daily Trade Ledger world setting also writes completed trades to one Calendaria note per in-world day. See the settings reference.