# Background

> Kinbarrow modding reference — content tree `b2f73c2ab65ff925`, version `0.2.0+main.a22009f4c`.

`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.

**Note on syntax:** these files are RON, not JSON. The shapes below are exact,
but punctuation follows RON — read a real `data/*.ron` file alongside.

## Fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `abilities` | `[Ability, int8][]` | default `[]` | Ability-score bumps this origin grants — `(ability, +bonus)` pairs, the `RaceDef::asi` idiom, composed on top of the racial ASI the way every other increase composes. |
| `coins` | `uint32` | default `0` | Starting coin the origin outfits the soul with — minted to its purse at genesis (`Time::ZERO`). |
| `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 (`soul::finalize`). |
| `source` | `Source` | required | Authored source. |

## Nested shapes

<a id="ability"></a>

### Ability

An open, validated Ability id interned from authored data.

<a id="background-feature"></a>

### 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 `data/goods/`. |
| `text` | `string` | required | The feature's prose — what standing or knack the origin confers, shown on the creator sheet and quotable in the chronicle. |

<a id="equipment-grant"></a>

### 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 `data/goods/` id, resolved to a concept at placement. |
| `qty` | `uint32` | required | How many of the good to mint into the soul's hand. |

<a id="provision"></a>

### Provision

One generic travel provision supplied by a composed feature.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `good` | `string` | required | A `data/goods/` id supplied on the road. |
| `units_per_day` | `uint32` | required | Units supplied per travel day. |

<a id="skill"></a>

### Skill

An open, validated Skill id interned from authored data.

<a id="source"></a>

### Source

Every file's top-level value carries `source`.

<a id="source--srd51"></a>

#### Source::Srd51

SRD 5.1 — retained nonconflicting catalogue material.

<a id="source--srd52"></a>

#### Source::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.

<a id="source--original"></a>

#### Source::Original

Original content authored for this game (not from the SRD).

<a id="source--phb2024"></a>

#### Source::Phb2024

Material transcribed from the 2024 Player's Handbook. This source is not redistributable by this project and belongs in a `phb2024` mod.

<a id="source--dmg2024"></a>

#### Source::Dmg2024

Material transcribed from the 2024 Dungeon Master's Guide. This source is not redistributable by this project and belongs in a `dmg2024` mod.

<a id="source--mm2024"></a>

#### Source::Mm2024

Material transcribed from the 2024 Monster Manual. This source is not redistributable by this project and belongs in an `mm2024` mod.

<a id="source--tce"></a>

#### Source::Tce

Material transcribed from Tasha's Cauldron of Everything. This source is not redistributable by this project and belongs in a `tce` mod.

<a id="source--xge"></a>

#### Source::Xge

Material transcribed from Xanathar's Guide to Everything. This source is not redistributable by this project and belongs in an `xge` mod.