RPGX Shops & Traders

RPGX Shops & Traders

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

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

Links

• Website: rpgxstudios.com
• Patreon: patreon.com/c/rpgxstudios
• Discord: discord.gg/9PAuuDVUZJ
• Bug reports: discord.gg/BAXavrCxyT