Stock and Restocking

A shop’s stock is the items on its actor. Peddler adds a restock schedule on top, so shelves refill as world time passes.

Stocking a shop

Drag Items onto the shop actor to stock it. Dragging an Item folder onto the actor stocks everything inside. Whatever sits on the actor is what players can browse and buy in the vignette.

The Stock tab in Shop Settings lists every item in the shop. Each row carries an infinite-stock toggle, a restock quantity, and a restock cadence.

Quantities and infinite stock

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

Marking an item infinite means it never runs out. Purchases do not consume it. Infinite items are skipped by restocking entirely.

Setting a restock schedule

Each item’s cadence is a number paired with a unit of world time. An item with a cadence refills once that much time has passed since its last restock. Cadence lengths follow the world’s active calendar. Leaving the cadence blank makes the item refill every time the shop opens.

The Stock tab also accepts Roll Tables. Drag a Roll Table onto the tab to stock the shop from its results. Each table row sets how many items to roll and its own cadence. A mode setting decides whether a table draw adds to the current stock or first clears the goods that earlier table draws brought in. The mode applies only to table rows; item rows always restock to what their formula rolls.

When restocks fire

A restock runs when its scheduled world time passes. Any module that advances world time can trigger it, including calendar modules and the core clock. Peddler also checks the schedule whenever the shop opens, so a party arriving after a long downtime finds the shelves already refreshed.

Timed restocks only need the world clock to move. Blank-cadence rows wait for the shop to open instead. The Stock tab includes a button to force a restock immediately.

What you see

When a restock lands, a toast summarizes how many items were added and how many were refilled. The same event fires a hook for macros and other modules; the hook is documented on API and Hooks.

Restocking runs on the GM’s client. Players never see the machinery, only the refreshed shelves the next time they step up to the counter.