Getting Started

Peddler turns an NPC actor into a shop that players visit in person. A player talks to the shopkeeper through branching dialogue, builds a cart, and checks out. You configure everything from the actor’s sheet.

Installation

Peddler requires Foundry VTT v14 and the free 3DS Atlas module. Install both through the Foundry setup screen and enable them in your world. Atlas supplies Peddler’s text and shared theming. It also designates one connected GM as the primary GM, whose client runs shop automation and commits every trade.

Upgrading an existing install

3DS Atlas is a required dependency. A world that ran Peddler before Atlas was required must install and enable Atlas for shop windows to display correctly.

Optional companions

Calendaria adds calendar-driven restocking, market days, and a daily trade ledger. Travel Pace lets a shop sell passage between destinations. Neither is required.

Create your first shop

To turn an NPC into a shop, open its actor sheet and click Create Peddler Shop in the window header. A dialog asks you to pick an archetype for the shop. An archetype installs a ready-made dialogue tree, a matching theme, and stock behavior on the actor. The archetypes are described on Shop Archetypes.

Choosing Blank Shop instead creates a minimal starter tree and opens it in the dialogue editor.

Confirm with Create Shop. Peddler creates a journal entry named after the actor to hold the dialogue tree. Players read the tree from that journal, so leave it in place. After setup the header button reads Peddler Shop Settings and opens the shop’s settings window.

Stock it

To stock the shop, drag Items or an Item folder onto the shop actor. Everything in the actor’s inventory becomes stock the shopkeeper can sell. The settings window’s Stock tab controls quantities and how sold items come back. See Stock and Restocking for the full stocking workflow.

Players enter

Place the shop actor’s token in a scene. A player right-clicks the token to enter the shop. Peddler resolves the buyer from the player’s assigned character, or from a token they control or target. The player then sees a full-screen vignette over the canvas. The shopkeeper greets them, they choose replies, browse wares, and fill a cart. The vignette is covered on The Vignette.

If a player already has an unfinished visit to that shop, Peddler asks “Resume Your Visit?” before reopening it. Declining discards the saved session.

Closing the vignette with items still in the cart asks “Leave the Shop?” to confirm.

Checkout commits the trade on the primary GM’s client, so a GM must be connected for purchases to complete. Gold and items move between the two actors in one transaction.

To walk through the shop yourself, use the Open Peddler Shop button on the shop token’s HUD, or Shift right-click the token. When no shopping character resolves for you, that button reads Peddler Shop Settings and opens the settings window instead.

Where to go next

• Shop Archetypes tours each prebuilt shop.
• Shop Settings covers the settings window on the shop actor.
• Dialogue Tree Editor shows how to author or customize the conversation.