The Vignette

The vignette is the full-screen scene a player enters when they visit a shop. It replaces the normal Foundry interface with a staged storefront built around the shopkeeper. While it is open, the rest of the Foundry UI is sealed behind it and cannot be clicked. Notifications and tooltips stay active. On your client, Peddler’s own windows stay interactable behind the scene.

The look of the scene comes from the shop’s theme and chassis. The theme sets the backdrop, palette, sound voice, and mood. The chassis sets the physical arrangement of the dialogue, shelf, and cart regions. Both are covered in Themes and chassis.

Entering

A player enters by right-clicking the shop’s token. On your client the Token HUD gains a door button that opens the same scene, and Shift plus right-click works as a shortcut. If the shop’s schedule says it is closed, the tree decides what happens instead of a visit. If the shop limits concurrent shoppers, the player may be placed in a line first. Queueing is covered in Queue and sessions.

Talking and choosing

The shopkeeper speaks first. Dialogue advances line by line, then presents the choices you authored in the shop’s tree. Some choices open the shelf, some branch the conversation, and some accept typed free-text input from the player. Authoring is covered in the Dialogue tree editor.

While the player browses, the shopkeeper keeps up flavor chatter in speech bubbles anchored to the scene. Terminal-style chassis print the chatter into the running log instead.

Browsing and the cart

The shelf shows the stock as cards with a name, price, and quantity stepper. A search box and sort control filter the shelf in place. Clicking a card opens an inspect view with the item’s description and cart controls. Adding an item plays a small flight animation into the cart chip. The cart tracks a running count, the total, the player’s balance, and what remains after the trade. Selling works the same way on trees that offer it, with the player’s own inventory on the shelf.

Checkout

Checkout moves to a confirm step that lists every line in the cart. The player can haggle over the whole cart from here, which is covered in Haggling and pricing. Confirming commits the trade on your client. Items and currency move without the player needing permission to edit the shop actor. The vignette then plays a settle sequence over the totals before returning to the conversation. A refused trade plays a rebuff instead and leaves the cart intact.

Leaving and resuming

The player leaves through the tree’s farewell choices or by pressing Escape. Leaving with items still in the cart asks for confirmation first. An abandoned cart costs the player nothing. Stock and currency only move at checkout. If a session ends unexpectedly, the player is offered the chance to resume it on their next visit, with items that have since sold out dropped from the cart. Resume behavior is covered in Queue and sessions.

Motion effects and interface sounds follow each client’s Ambient motion and Shop sounds settings, listed in the Settings reference. Ambient audio plays through Foundry’s environment audio channel and follows that channel’s volume on each client.