# RaceNames

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

`names/<id>.ron` — OURS; per-race name register (humans stay in `names.rs`; half-elves compose from both parents' tables — the `data/README.md` race-key contract). The `race` field is the file's id (not `id`).

**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 |
| --- | --- | --- | --- |
| `given_female` | `string[]` | required | Female given names. |
| `given_male` | `string[]` | required | Male given names (glossed per line). |
| `given_unisex` | `string[]` | required | Unisex given names (a small chance to draw one); empty where the source distinguishes gender. |
| `namesake` | `string` | required | How a soul is told from a namesake once every name this register can make is already borne in the realm: a form holding `{name}` and `{home}`, such as `"{name} of {home}"`. |
| `place_elements` | `string[]` | required | Place-name elements for settlement/region naming; glosses ride as line comments. |
| `place_position` | `PlacePosition` | required | Whether place elements attach as a prefix, a suffix, or either. |
| `race` | `string` | required | The file's id — the race key this register serves (the `data/README.md` race-key contract). |
| `register` | `string` | required | The naming register/style label (e.g. "old-norse"). |
| `source` | `Source` | required | Authored source for this naming register. |
| `surnames` | `string[]` | required | Surnames — epithets ("the Old") or lineage forms; file comments say which. |

## Nested shapes

<a id="place-position"></a>

### PlacePosition

Where a name fragment sits relative to a place's stem — a prefix, a suffix, or either.

<a id="place-position--prefix"></a>

#### PlacePosition::Prefix

Select the prefix behavior.

<a id="place-position--suffix"></a>

#### PlacePosition::Suffix

Select the suffix behavior.

<a id="place-position--either"></a>

#### PlacePosition::Either

Select the either 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.