Getting Started

Peddler turns an NPC actor into a shop that players visit in person. A player talks to the shopkeeper through branching dialogue, fills a cart, and checks out.

Installation

Peddler requires Foundry VTT v14 and the free 3DS Atlas module. Install both from the Foundry setup screen and enable them in your world. Peddler works with several game systems, listed on System Adapters.

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

Create your first shop

Open the NPC’s actor sheet and click Create Peddler Shop in the window header. This opens the Shop Builder.

On the first step, enter the Shop name and Shopkeeper name, then pick an archetype. Each archetype brings its own dialogue tree, theme, and shop mechanics. The archetypes are described on Shop Archetypes. Blank Shop starts from a minimal greet, browse, and leave tree.

Next, choose Import the tree to step through the archetype’s dialogue and tweak each branch, or Start fresh to write every line and choice yourself. The builder then walks through each branch in turn and ends on a review page. Click the Create button to finish the shop, or Open in editor to finish it and continue in the Dialogue Tree Editor.

Closing the builder partway saves a draft on the actor. Clicking Create Peddler Shop again picks it up where you left off.

Peddler stores the dialogue tree in a new journal entry named after the actor. Leave that journal in place. Once the shop exists, the header button reads Peddler Shop Settings and opens the shop settings window.

Stock it

Drag Items or an Item folder onto the shop actor’s sheet, or onto the drop zone in the Shop Builder. The shop sells the physical items in the actor’s inventory. Gear the shopkeeper has equipped stays off the shelves unless you clear Exclude Equipped Gear on the Stock tab. See Stock and Restocking for restock rules.

Players enter

A player enters a shop in any of these ways:

• Right-clicking the shop’s token on the canvas.
• Clicking Enter Shop in the header of the shop actor’s sheet.
• Walking a token into a shop region. The player confirms an Enter Shop? prompt first.

To create a shop region, open the scene, then click Draw Region under Shop Region on the Settings tab of the shop settings window. Draw the region on the canvas and Peddler links it to the shop.

Peddler picks the buyer from the player’s assigned character, then a token they control, then a token they target. In D&D 5e, when the player owns the primary party actor, Peddler asks whether to shop as themselves or as the party. The visit opens in the vignette.

If a player left a visit unfinished, Peddler asks to resume it. Declining discards the saved visit.

Trades commit on the primary GM’s client, so a GM must be connected for purchases to complete.

To walk through a shop yourself, Shift right-click its token, or click Open Peddler Shop on the token HUD. When no shopping character resolves for you, the HUD 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.
• Player Trading covers trades between players.