Stock and Restocking

A shop’s stock is the items on its actor. The Stock tab in Shop Settings controls how each item sells and when it comes back.

Stocking a shop

Drag Items or an Item folder onto the shop actor. Whatever sits on the actor is what players can browse in the vignette.

Generate From Compendium on the Stock tab adds a random selection of items from a compendium. Pick the compendium, set how many items to add, narrow the choice with the filter, and click Generate.

The Journals section sells a journal entry as stock. Buying it gives the buyer’s players Observer access to the journal instead of handing over an item.

To convert Item Piles merchants, open Import Shops in Peddler’s module settings. Each merchant keeps its items, prices, opening hours, and populate tables. Items Item Piles marked not for sale stay off the shelf, and hidden items move to the back room. Importing a merchant again replaces its Peddler shop.

The stock list

The Showing buttons switch the item columns between Restock, Pricing, Visibility, and Pool & Tags. The arrow beside a column header copies the top row’s value to every item. Per-item prices, sell rates, and barter items are covered in Haggling and Pricing.

An item of a type the system does not trade is marked Not Stock. An item the shopkeeper has equipped is marked Equipped while Exclude Equipped Gear is on. Neither reaches the shelf, and their restock fields are locked.

Column	Effect
Sellable	Clearing it hides the item from the buy and sell lists. It still restocks.
Service	Paying for it never hands over the item or touches stock.
Back Room	Hidden until the buyer meets one of the Back Room conditions on the Settings tab.
Tags	Free-form labels that dialogue conditions and Browse filters match.

An item tagged with the name of an opening-hours window appears only while that window is open.

Quantities and infinite stock

The Quantity field sets how much of an item comes back on a restock. It accepts a number or a roll formula. A restock sets the item to the rolled result rather than adding to it. A blank quantity means the item never restocks.

An infinite item never runs out and is never restocked. Setting Default Stock to Infinite makes every item in the shop unlimited.

An item sold down to zero is removed from the actor, and its restock row stops working. Turn on Keep Depleted Items to leave it on the actor at zero so a restock can refill it.

In systems whose items have no quantity field, Peddler tracks each item’s stock count itself. The other Stock Rules options are listed on Settings Reference.

Restock schedules

Each item’s Every field is a number paired with a unit of world time. The item refills once that much time has passed since its last restock. Unit lengths follow the world’s active calendar. A blank cadence refills the item every time the shop opens.

Roll Tables

Drop a Roll Table onto the Roll Tables section to stock the shop from its results. Each table row sets how many items to roll and its own cadence. A drawn item already on the shop raises that item’s quantity instead of adding a copy. A result that points at anything other than an Item, or at a deleted document, is skipped and reported. Plain text results are skipped silently.

Table Restock decides what happens to existing stock before a table draw:

Mode	Effect
Add	Adds the draws to the current stock.
Reset	Deletes items that earlier table draws added, then adds the new draws.
Wipe	Deletes every item on the actor, including ones you added by hand.

Weighted pool

Weighted Pool Restock refills a random subset of items each cycle instead of each item on its own schedule. Mark items In Pool in the Pool & Tags view and turn on Enable Pool Restock. Each cycle draws Items Per Draw different items, weighted by their Chance. Each drawn item restocks to its own Quantity formula. The pool has its own Every field, and pool items ignore their individual cadence.

When restocks fire

A timed restock runs when its scheduled world time passes, whichever module or control advances the clock. Peddler also checks the schedule whenever the shop opens. Blank-cadence rows refill only on open. Timed restocks are skipped while the shop is closed for a holiday set on the Settings tab.

Restock Now at the bottom of the Stock tab restocks every row immediately, regardless of schedule. Its confirmation warns when the current Table Restock mode will delete items.

Day change and market days

With Calendaria active, Restock on Day Change checks a shop’s cadences once as the date changes instead of on every time advance. A row still waits out its own interval.

Market Days limits a day-change shop to days carrying one of the chosen calendar note categories or named events. A row that comes due between market days refills on the next one. Choosing none treats every day as a market day.

What you see

When a restock lands, the GM gets a notification counting items added and refilled, plus a warning for any table results that could not be resolved. Announce Restocks also posts a public chat message when a restock changes something. Some shop layouts show players a countdown to the next restock. The restock hook is documented on API and Hooks.

Scheduled restocks run only on the primary GM’s client, so shelves never refill twice when several GMs are logged in.