System Adapters

Peddler talks to your game system through an adapter. The adapter tells Peddler where a system keeps its data and how to act on it. Everything else in the module is system-agnostic.

What an adapter handles

An adapter covers the system-specific ground:

• Currency. The adapter reads the system’s currency table, knows the conversion rates between denominations, and updates actor funds when a sale closes.
• Item fields. The adapter knows where the system stores an item’s price, quantity, rarity, and level.
• Haggling skills. The adapter supplies the list of skills a shopkeeper can call for and rolls them through the system’s own dice pipeline. See Haggling and Pricing.
• Item stats. The adapter builds the stat lines shown when a shopkeeper presents an item in the vignette.
• Item transfer. The adapter moves purchased items onto the buyer’s sheet and removes sold items, respecting the system’s quantity handling.
• Tree building blocks. An adapter can add its own predicates, effects, and browse filters to the dialogue tree editor.

Supported systems

Dedicated adapters ship for:

• D&D 5e
• Pathfinder 2e
• Daggerheart
• Call of Cthulhu 7e
• D&D 4e
• Draw Steel

Every other system

Any other system falls back to a generic adapter. No feature is hidden or disabled on the fallback. Shops open, dialogue trees run, haggling works, and transactions complete.

The difference is where the configuration comes from. A dedicated adapter fills in field paths and skill lists as presets. On the generic adapter you supply those details yourself in Shop Settings: the item field paths to display as stats, and custom haggle roll rows with your own formulas in place of a preset skill list. Presets are a convenience, not a gate.

Reference effects

Some archetype services grant an active effect, such as a smith sharpening a blade. These reference effects live in a world compendium named Peddler Effects. Peddler creates the compendium for you the first time an archetype needs it and fills in any effects that are missing. Each effect carries an internal reference flag, so you can rename or reflavor the entries without breaking the link. You can also drag any active effect of your own into a grant by its UUID through the tree editor.

Reference effects are defined per system, so a shop grants effects that use your system’s own mechanics.

Requesting a system

There is no public API for third-party adapters. New system support is added in Peddler itself. If your system is not on the list, open a request on the module’s issue tracker and it will be considered for a future release.