Builder's Manual · Chapter 19

Building a Trade & Services Venue

A trade & services establishment — a smithy, an outfitter, a med-bay, a scrap yard, a dock handler — is where the economy stops being a tier ladder in the Player's Handbook and becomes a place the party can actually walk into. This chapter is how you author one: a thin sub-type of a Location, spoken as its own file type (Trade and services), with its own catalog, its own buying list, and its own cash register.

The venue is a place with a register

The venue carries designation location, so it behaves like a place you can be in and pin to a map. Through its location reference it can point at a real Location for a map/root sheet. Its name and description are the pitch — what kind of shop it is, who runs it, what it smells like — and establishmentType gives the hero its subtitle.

Everything else is the register:

  • workingHours — when it's open.
  • restockPeriod — how often the catalog refreshes. It is a promise: the venue only fills if the route behind it is open (GM 07).

Categories are the venue's reach

categories is a multi-select over the goods folders in Transport / Equipment / Services — Tr_Armor, Tr_Energy, Tr_Engine, Tr_Gear, Tr_Weapon, Ammunition, Armor, Artifact, Consumables, Food, Gear, Weapon, Healing, Information, Repair, Crafting, … The category set is what the venue trades in, and it bounds what a player can sell there. Keep it honest: a smithy does not catalogue a med-bay.

Stock and buying are reference arrays

  • stock — the catalog the party can buy. Each row is (item, quantity, unitPrice, modifier); item is a reference to an Equipment or Ammunition file — exactly the reference direction as a character's inventory. The venue points at the goods; the goods do not list their sellers. modifier is Produced on site | Import | Shortage | Surplus, and unitPrice is already what the venue charges after the modifier.
  • buying — what the venue will buy back, as (item, quantity, buyPrice). This is the boundary of the Sell tab.

The register does the math

Three computed fields keep the counter honest:

stockValue   = Σ(stock: unitPrice × quantity)
cashRegister = cash + stockValue
stockCount   = Σ(stock: quantity)

You write cash (the coin on hand); the sheet derives cashRegister (total worth on the counter) and stockCount. Never hand-type a computed total — change cash, quantities or prices and let the machine re-solve, per The Computing Layer.

The Deal tab is one trade

The deal array is a working cart for a single transaction: rows of (item, side: buy | sell, quantity, unitPrice). side says which way the coin flows — buy means the party pays, sell means the party receives. From the cart the sheet derives:

dealBuyTotal  = Σ(deal: side == buy  ? unitPrice × quantity : 0)
dealSellTotal = Σ(deal: side == sell ? unitPrice × quantity : 0)
dealNet       = dealSellTotal − dealBuyTotal      (net to the player)

When the trade is accepted, flip dealSettled and log a dealLog row (when / side / item / quantity / total). The sheet writes only to the venue file, so the real transfer — moving items and money between the party's character/transport and the venue — is the Master's job at the table; the deal cart just keeps the accounting visible and the math right.

Services are contracts, not a second economy

A service — a vehicle repair, an analytical report, a month's hire of a bartender, a security escort — is not a separate file type. It is a one-shot contract riding the same Equipment / Consumables template as any good, sitting in the venue's stock / buying like anything else:

  • Vehicle repair service — spent to restore a transport's integrity (components, HP, fuselage).
  • Analytical report: target audience — spent to refresh a venue's / faction's demand & expenditure numbers (the hub layer below).
  • Labor contract: bartender (1 month) — spent to bind a specific Key Actor to the venue's register.
  • Security escort agreement — spent to lower hazards on a trade caravan / transport route.

You author it as a normal Equipment/Consumables file (see Building Consumables), price it on the same tier, ride it through the same deal cart, and its effect lands once on use. Do not invent a separate "services" catalogue in the schema — the whole point is that the world answers with the same template and the same coin.

Hubs answer, they don't simulate

An analytics / labor / relations hub — a labor exchange, an insights bureau, an outreach office — is the same venue type, but its catalog is mostly reports about the world: who's hiring, what a faction will pay, what a district spends and earns. It does not march a running city-simulation every turn:

  • The hub recomputes its income / expenditure / demand numbers when you ask — the party walks in, names the report, and the Master runs the calculation once and hands back the world's answer.
  • Automatic refresh happens on restockPeriod, and only for the categories the hub trades in — never a per-turn district re-derivation.
  • Target audience / faction representatives are real single characters or small groups you meet — the reports are about them; acting means going to them.

This keeps hubs cheap to run and honest — a writing of one report costs one pass of arithmetic, not an always-on economy that the Master has to keep ticking.

Owner-run venues & the micro-economy module

A venue needs no owner to be traded at — but the moment a player owns it, the Master turns on the micro-economy module. Ownership and the five modules all key off the venue's linked Lore file:

  • keyActors (Lore) — the owning character. This reference is the proof of ownership; the open the module on that character. Through it the owner can appoint managers.
  • suppliers + localMultiplier / importMultiplier (Lore) — factories, farms, corps feeding the venue, each with a base-price multiplier (local 0.8, import 1.3, …). Restock honors these: local-produced runs cheap, imports run dear.
  • services (Lore) — the venue's own signature offerings, invented through Craft productions / craft sheets (Research & Recipes) and delivered as Equipment/Consumables contracts in stock.
  • targetAudience (Lore) — the factions who patronize the venue; reputation here gates coin and Gossip / Data income.
  • storage (Lore → Storage) — the venue's warehouse file; its summary and inventorization journal are the physical stock the register sells down, pulling ingredients and materials with every patron transaction.

Because these all live on the Lore, build the venue's Lore first, then the venue points the module at it. Run the ledger on restockPeriod (or on an owner action), not every turn.

Pricing honors the economy

None of the numbers on the sheet are free. unitPrice / buyPrice are set from the price tiers of Skills, Crafting & the Market and the modifiers of GM 07, all riding on GENREVALUE (see Genre & Tech Level). Reconcile a venue's prices against Lore on production, supply chains and faction influence before the party ever haggles — a venue detached from the world's economy is exactly the kind of silent break the system guards against.

Checklist

  • establishmentType, workingHours, restockPeriod and categories are set; categories matches a real set of goods the venue trades in.
  • stock / buying reference existing Equipment or Ammunition files (plain slug or equipment/<slug> / ammunition/<slug>) — never prose.
  • unitPrice / buyPrice already reflect the venue's modifier and a price tier; cash is set.
  • cashRegister, stockCount, stockValue, dealBuyTotal, dealSellTotal, dealNet are left computed — never hand-typed.
  • A deal's side is buy or sell; settlement flips dealSettled and logs a dealLog row.
  • Services are Equipment/Consumables contracts in the venue's catalog — no separate services scheme.
  • Any hub computes on request and refreshes on its restockPeriod; workingHours, categories and cash stay honest.
  • If a player owns the venue: the Lore names the owner in keyActors and carries suppliers, multipliers, services, targetAudience and storage.
  • Prices trace back to GENREVALUE tiers and GM 07 modifiers — the venue earns its place in the world's economy.
Manual updated Nov 7, 2026.