RPGX SHOPS & TRADERS

Author: x8xid82 Project: Source Foundry Versions 12+ (Verified 14.364) Last Updated 17 hours, 36 minutes ago

What's Included

Business Setup

Create businesses as NPC actors with a name, business type, location, player-facing description, and GM-only notes
New businesses are automatically organized into a "Businesses" folder in the Actors directory, sorted into subfolders by location
Assign one or more NPC actors as shopkeepers via drag and drop. With multiple shopkeepers assigned, one is chosen at random each visit. A reroll button is available in the shop window at any time
Business Configuration includes a checkbox to enable the Jobs & Rumors tab and a Randomize Base Stock option per shop

Default Inventory Lists

Build named, reusable lists of items with quantities and prices in Settings under Manage Default Inventories
Each item in a list has an editable quantity field and a price override field with denomination selector. Items with a zero value in the compendium, or items with no price field at all, carry the correct price into any shop the list is applied to
Apply a list as starting inventory when creating a new business, or apply it to an existing business to merge items into current stock without removing what is already there
Mark one list as the default so it is pre-selected every time a new business is created

Shop Inventory: Two Sections

Today's Specials

A dedicated top section for session items the GM places manually
Specials have a quantity on hand but no restock level. When a special sells out the GM is prompted to remove it from the shelf
Specials are never touched by Restock or New Day
The shopkeeper's AI-generated greeting calls out specials by name

Store Stock

Permanent inventory drawn from a Default Inventory list, with two GM-editable fields per item: Restock (the baseline) and Current Stock (what is on the shelf today)
The Restock button and New Day both reset Current Stock to the Restock level for every stock item
Items can be moved between Specials and Store Stock using the section toggle button on each row

Randomize Base Stock

Enable per shop in Business Configuration and set a count
Each time New Day runs, the shop clears its permanent stock and pulls that many items at random from the assigned Default Inventory list
Specials are never affected. Works independently of the dialogue and rumor generation

New Day

A single button in the main Shops & Traders menu refreshes every shop at once
Regenerates shopkeeper dialogue for all shops, with AI generation where Proton is available and fallback text where it is not
Generates a new town rumor for shops with the Jobs & Rumors tab enabled, if Proton is connected
Restocks all stock items to their restock baselines, or randomizes stock on shops where that option is enabled

Shop Window

Welcome Tab

Default landing tab when a shop is opened
Shows the active shopkeeper's portrait and a greeting in their voice
With RPGX Proton: AI-generated dialogue drawing on the shopkeeper's biography, alignment, race, and the day's specials
Without Proton: a solid fallback greeting is seeded automatically on first open

Inventory Tab

Split into Today's Specials (top) and Store Stock (bottom)
Players see prices, stock counts, and a cart stepper per item
GMs see inline editing controls for price, restock level, and current stock, plus unlimited toggle, section toggle, and remove buttons

Services Tab

Flat-rate services the GM defines per business, name and cost
Added to cart and checked out alongside inventory items

Sell Loot Tab

Players drag items from their character sheet directly onto this tab to sell back to the shop
Buyback rate is configurable at the world level and can be overridden per business

Jobs & Rumors Tab

Enabled per shop in Business Configuration
Pulls open jobs from RPGX Quest Log filtered by the shop's location. Quests with no location set appear in all shops. Quests with a different location are excluded
With Proton: displays a freshly generated town rumor refreshed each New Day
Without Proton: shows open jobs only, or a message that nothing is available

Cart and Checkout

Running cart total with live funds display for the active character
Haggle button sends a whispered chat message to all GMs requesting a check, without disrupting the session
Shopper selector shown when a player controls more than one character
Checkout relays through the active GM client so players never need write permissions on the shop actor

Currency Configuration

Settings menu with presets for D&D 5E (pp, gp, ep, sp, cp), Pathfinder 2E (pp, gp, sp, cp), and Generic Credits
Custom denomination editor for any other system: set a name, abbreviation, and value relative to the base unit
System mapping for single-currency systems (Shadowrun, Star Wars FFG, Cyberpunk Red, Call of Cthulhu, and others): a field inspector reads numeric fields off an existing actor so the correct data path can be selected without typing anything manually

AI Generation (Requires RPGX Proton)

Generate a shop's name, business type, player-facing description, and GM notes in one pass from the Business Configuration screen
Reads world Game System and Campaign Genre settings to match the tone and setting of the campaign
Checks against existing shop names so duplicates are not generated
Generates shopkeeper dialogue for the Welcome tab drawing on the NPC's biography, alignment, race, and the shop's current specials
Generates town rumors for the Jobs & Rumors tab
All generation runs locally through RPGX Proton. No world data is sent outside the GM's own machine

Multiplayer and Hosting

Works on Forge, a dedicated local server, or Foundry running directly from the GM's computer
All purchases, sales, and haggle requests from players are relayed through the active GM client via Foundry's socket system
Players are given Observer access to shop actors automatically. No manual permission setup required
Token click on a business actor opens the shop window directly

Free vs. Pro

	Free	Pro (RPGX Proton)
Businesses	Up to 3	Unlimited
Full shop window	Yes	Yes
AI shop generation	No	Yes
AI dialogue and rumors	No	Yes
Configurable currency	Yes	Yes
All other features	Yes	Yes

Requirements

Foundry VTT v12 or later (verified on v14)
RPGX Proton (optional, free): required for AI generation features. Download at rpgxstudios.com

Installation

Search for RPGX Shops & Traders in the Foundry module browser, or install via manifest:

https://github.com/x8xid82/rpgx-shops-traders/releases/latest/download/module.json