# GraveGoods

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

`tables/grave_goods.ron` configures original barrow goods and the magic left by incoming bands at every kind of site. Other landscape sites begin without goods. The values are realm tuning, independent of published treasure coin amounts. Omitting this whole table leaves barrows without builder records or original goods and disables move-in magic.

**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 |
| --- | --- | --- | --- |
| `age_max_years` | `uint64` | required | Oldest possible barrow age in whole years, inclusive. Must be at least the minimum and fit a signed 64-bit graph integer. |
| `age_min_years` | `uint64` | required | Youngest possible barrow age in whole years, inclusive. |
| `chief` | `GraveGoodsTier` | required | A chieftain's original size, coin and magic rarities. |
| `chief_one_in` | `uint64` | required | One in this many barrows has a chieftain's standing. Must be positive. |
| `family` | `GraveGoodsTier` | required | A family's original size, coin and magic rarities. |
| `lair` | `LairGoods` | required | Magic count and danger-level weights for each new band's remains. |
| `magic_count_faces` | `uint64` | required | Sides on the one die that determines the magic-item count. Positive. |
| `magic_count_subtract` | `uint64` | required | Subtract this from the die, flooring the result at zero. Must be less than the number of faces. |
| `source` | `Source` | required | Provenance of the authored table. |

## Nested shapes

<a id="grave-goods-tier"></a>

### GraveGoodsTier

The size and original goods of one builder's standing.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `chambers` | `uint32` | required | Interior chamber count, excluding the entrance and final seat. At least five; at most 65,534, so every mission chamber has a 16-bit index. |
| `numeraire_days` | `int64` | required | Original burial coin in apprentice labour days, converted at the realm wage scale when minted before the genesis census. Must be positive. |
| `rarities` | `[MagicRarity, uint32][]` | required | Distinct Common/Uncommon rarities with positive relative weights. Missing loaded pools drop out of the weight total. Choose rarity by weight, then an item uniformly within it, with replacement. |

<a id="lair-goods"></a>

### LairGoods

Magic left unowned in the Seat whenever a new band moves into a site.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `magic_count_faces` | `uint64` | required | Sides on the one die that determines the magic-item count. Positive. |
| `magic_count_subtract` | `uint64` | required | Subtract this from the die, flooring the result at zero. Must be less than the number of faces. |
| `tiers` | `LairGoodsTier[]` | required | Nonempty ascending danger-level policies, starting at level one. |

<a id="lair-goods-tier"></a>

### LairGoodsTier

One lair's magic policy from its minimum danger level upward. The highest reached minimum applies; tiers start at one and strictly increase.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `min_level` | `uint32` | required | Lowest danger level that selects this row, inclusive. |
| `rarities` | `[MagicRarity, uint32][]` | required | Distinct Common/Uncommon rarities with positive relative weights. Missing loaded pools drop out of the weight total. Choose rarity by weight, then an item uniformly within it, with replacement. |

<a id="magic-rarity"></a>

### MagicRarity

SRD 5.1 magic-item rarity. The magic axis is ORTHOGONAL to the quality tier: a +1 sword is Uncommon whatever its craftsmanship, and a Masterwork mundane blade is no rarer than a Poor one. The engine branches on rarity for the worth FACTOR ([`MagicRarity::worth_factor`]) — the one place magic touches the pricing seam.

<a id="magic-rarity--common"></a>

#### MagicRarity::Common

Select the common behavior.

<a id="magic-rarity--uncommon"></a>

#### MagicRarity::Uncommon

Select the uncommon behavior.

<a id="magic-rarity--rare"></a>

#### MagicRarity::Rare

Select the rare behavior.

<a id="magic-rarity--very-rare"></a>

#### MagicRarity::VeryRare

Select the very rare behavior.

<a id="magic-rarity--legendary"></a>

#### MagicRarity::Legendary

Select the legendary behavior.

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