Skip to content

Releases: x8xid82/rpgx-shops-traders

v1.2.0 (Public Release)

24 Jun 00:41
@x8xid82 x8xid82
v1.2.0
6a5d578
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v1.2.0 (Public Release) Latest
Latest

RPGX Shops & Traders v1.2.0

First public release.

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 > 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 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 written 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

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

Assets 4
Loading