RingBRP/README.md

THE CUSTODIANS

A Basic Roleplaying game of crossings, as a Foundry VTT system.

A drab British government agency deals with crossings. Reality keeps a record of what belongs where, and it can be made to get it wrong. Agents are civil servants: they carry warrant cards and cordon tape, they file in triplicate, and the thing that makes them dangerous is that they know how the record works.

The tone is bureaucratic horror. Most cases close with an arrangement rather than a fight, and the supernatural is a filing error somebody committed on purpose.

---

Installing

In Foundry: Game Systems → Install System → Manifest URL

https://gitea.timevans.uk/slaguru666/RingBRP/raw/branch/main/system.json

Or by hand: clone this repository into your Foundry data directory as Data/systems/ringbrp, then restart Foundry.

git clone https://gitea.timevans.uk/slaguru666/RingBRP.git ringbrp

Requires Foundry v13+ (verified against v14.364). No modules are required. Dice So Nice is supported but optional — the system registers four of its own dice textures.

Deploying to a remote Foundry server

The built compendia in packs/ are committed on purpose, so a remote server needs nothing but the files:

cd /path/to/foundrydata/Data/systems
git clone https://gitea.timevans.uk/slaguru666/RingBRP.git ringbrp
# restart Foundry

node_modules/ is not committed. You only need it if you intend to rebuild the packs or regenerate art on that machine:

npm install          # pulls classic-level, used to write the LevelDB packs
npm run build        # rebuilds packs/ from tools/content.mjs
npm run check        # the three guards; the build refuses to run if they fail

To update a deployed server: git pull and restart Foundry. If the pull touches packs/, Foundry must be stopped first — LevelDB will not tolerate its files changing underneath a running server.

---

What is in the box

Roles	25 postings, each with a key characteristic, trained skills, talents and its own kit
Catalogue	175 items — 118 gear, 30 weapons, 13 armour, 14 vehicles
Eras	modern, antique, future, anomalous — the agency is old and never abolishes anything
Icons	231, all generated from tools/icons.mjs; no external art
Compendia	pregens, NPCs, skills, weapons, armour, gear, vehicles, powers, tables, rules, a starter case
Rules journal	8 pages, generated from rules.mjs so the book cannot drift from the code

---

The rules, in brief

d100 roll-under, banding into critical / special / success / failure / fumble. 96–99 always fail, 00 always fumbles, and every skill has a 1% floor.

Reaction Lanes replace Strike Rank. Initiative is 3 × max(⌈DEX/3⌉, ⌈readiness/10⌉) less carried load, plus a d6, re-rolled every round — including the first, so the opening round is ordered like every other.

Coherence runs 10 → 0 and measures how well-filed an agent is in reality. It bands into Anchored / Loose / Adrift / Unmoored / Displaced, and spending it is how the supernatural works.

The Quiet Arts are deliberate misfilings, not spells. They cost Coherence, and they only ever arrive from a crossing that goes wrong.

Defences are graded. A defence stops a blow of its own quality or worse outright; against something better it only reduces it by as many steps as it was outclassed by. Only a critical stops a critical.

Access is a record. There is no hacking skill and nothing to break into — see below.

---

Borrowed Authority — the access subsystem

Deliberately not cyberpunk. Nobody jacks into anything.

What an agent has is a named credential belonging to somebody real, with a scope of things that person could plausibly do, a Trust that erodes as it is used, and red flags describing how the real owner behaves.

• Inside its scope there is no roll. A facilities contractor opening a plant room is not intrusion, it is Tuesday. It costs 1 Trust and it works.
• One tier beyond is a stretch — roll, at −20 for each red flag you break. The system is not testing whether you are clever. It is testing whether you are behaving like the person whose name is on the record.
• Two tiers beyond is impossible at any skill. No percentage on any sheet gets a contractor issuing accounts.
• A fumble burns the credential, and somebody real is going to be asked about it.

A credential is assembled, not found: up to three dossier items, each a separate scene using a different skill, at most one of them at a keyboard. Items make the credential better, never the roll easier.

AI is a posture on the target rather than an opponent — a gatekeeper raises what counts as routine, an analyst writes a new red flag every time you stretch, an asset stands in for a dossier item.

And you may spend Coherence to widen a scope, because reality can be made to remember that the person always held that duty. It works. It always works. Push a credential past what its Trust will carry and your file and theirs converge one step, and nothing in this game spends anything to converge them back.

---

Repository layout

ringbrp.mjs          the system: sheets, engine, hooks (~4,900 lines)
rules.mjs            THE SINGLE AUTHORITY for every rule formula
system.json          Foundry manifest
template.json        data model for every Actor and Item type
templates/           Handlebars sheets
styles/              one stylesheet
lang/en.json         all user-facing text
icons/  dice/  fonts/   generated art
packs/               built LevelDB compendia (committed — see Deploying)
tools/
  content.mjs        the catalogue: skills, weapons, armour, gear, vehicles, NPCs
  build-packs.mjs    builds packs/ — runs the three guards first and refuses on failure
  make-icons.mjs     draws all 231 icons
  make-dice-textures.mjs
  rules-text.mjs     generates the rules journal FROM rules.mjs
  mission.mjs        the case generator
  mission-tables.mjs its content tables
  check-rules.mjs    guard: no rule may be defined twice
  check-kits.mjs     guard: every posting's kit must exist and be usable
  check-lang.mjs     guard: no localisation key may be both a value and a branch
docs/REVIEW_LOG.md   the design and defect log, R-1 onward

The one rule this codebase enforces on itself

No rule formula may exist in more than one place. Everything lives in rules.mjs, and tools/check-rules.mjs fails the build if a formula is restated, if an alias stops being identity-equal to what it aliases, if a constant is re-declared as a literal, or if an exported rule has no spot-check. The packs used to be built under one set of numbers and played under another; this makes that impossible to ship.

The build runs all three guards before it writes anything:

check-rules: 40 rules, 12 files scanned, 132 formulas verified
check-kits:  25 roles, 162 catalogue items, every kit key resolves
check-lang:  738 keys, no leaf/branch collisions