Background
backgrounds/<id>.ron — an origin: the GRANT half of the grant/use split. A soul's background is where its skill proficiencies come from; the trade it works is its [Profession], which USES those skills at the bench, never grants them. The SRD ships one background (Acolyte); the rest are OURS, the profession precedent.
A D&D origin is a BUNDLE, not a skill pair: beyond skills it may nudge ability scores, carry a named feature, and outfit the soul with starting coins and equipment. All four extras default empty, so thin origins and any mod file parse unchanged. Tools stay OFF the origin — trade competence is a trained tier the profession owns.
| Field | Type | Required | Description |
|---|---|---|---|
| abilities | [Ability, int8][] | default [] | Ability-score bumps this origin grants — |
| coins | uint32 | default 0 | Starting coin the origin outfits the soul with — minted to its purse at genesis ( |
| equipment | EquipmentGrant[] | optional | Starting goods the origin outfits the soul with — minted as stacks it carries at genesis. |
| feature | BackgroundFeature | optional | The origin's feature — the "more than a stat" half of a D&D background (Shelter of the Faithful, Criminal Contact). DERIVED onto a soul from its carried background id, never stored twice. |
| id | string | required | Authored id. |
| name | string | required | Authored name. |
| skills | Skill[] | required | The skill proficiencies this origin grants (an SRD background grants two); unioned onto the soul's set at generation ( |
| source | Source | required | Authored source. |
Nested shapes
Every shape Background closes over, so this page stands alone.
Ability
An open, validated Ability id interned from authored data.
BackgroundFeature
A named origin feature: the half of a D&D background that is not a number. Every feature carries a validated mechanical provision row. text is the flavor the creator sheet shows and the chronicle can quote.
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | required | The feature's short title (Never Lost, Never Hungry). |
| provisions | Provision[] | required | Goods this origin can provide while travelling. The validator requires at least one row and resolves every good against |
| text | string | required | The feature's prose — what standing or knack the origin confers, shown on the creator sheet and quotable in the chronicle. |
EquipmentGrant
One starting-goods grant an origin outfits the soul with: qty stacks of the good (a data/goods/ id), minted at genesis.
| Field | Type | Required | Description |
|---|---|---|---|
| good | string | required | The good granted — a |
| qty | uint32 | required | How many of the good to mint into the soul's hand. |
Provision
One generic travel provision supplied by a composed feature.
| Field | Type | Required | Description |
|---|---|---|---|
| good | string | required | A |
| units_per_day | uint32 | required | Units supplied per travel day. |
Skill
An open, validated Skill id interned from authored data.
Source
Every file's top-level value carries source.
Srd51
SRD 5.1 — retained nonconflicting catalogue material.
Srd52
SRD 5.2.1 — the 2024-revision System Reference Document, the same CC-BY-4.0 grant as 5.1 and the current rules chassis. Its files carry the .srd52.ron suffix so provenance reads off the path; see data/README.md for which document rules a given value.
Original
Original content authored for this game (not from the SRD).
Phb2024
Material transcribed from the 2024 Player's Handbook. This source is not redistributable by this project and belongs in a phb2024 mod.
Dmg2024
Material transcribed from the 2024 Dungeon Master's Guide. This source is not redistributable by this project and belongs in a dmg2024 mod.
Mm2024
Material transcribed from the 2024 Monster Manual. This source is not redistributable by this project and belongs in an mm2024 mod.
Tce
Material transcribed from Tasha's Cauldron of Everything. This source is not redistributable by this project and belongs in a tce mod.
Xge
Material transcribed from Xanathar's Guide to Everything. This source is not redistributable by this project and belongs in an xge mod.