tinqs/animation
5
0
Fork 0
Code Pull Requests Actions Packages Projects Releases Wiki Activity Issues

docs(naming): ceremony codes follow game item-id convention (snake_case DanceType)

Browse Source 
13 ceremony slots tabled in the registry (12 DanceType + rain_dance),
provisional ids now nd_##; codes like war_dance_01 / WarDance01.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Jeremy
2026-07-16 14:36:03 -07:00
parent 6a1290b1d1
commit 9b190e742e
2 changed files with 41 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/dances/REGISTRY.md
+31 -11
View File
@@ -4,20 +4,22 @@ Every dance clip in the pipeline is tracked here. **Numbers are never reused.**
## Naming system
**Stage 1 — provisional (new dances).** Every new take gets the next free `nd##`
Names follow the **game's item-id convention: lowercase snake_case** (like
`ceremonial_garb`, `dance_platform`, `war_challenge`).
**Stage 1 — provisional (new dances).** Every new take gets the next free `nd_##`
number at conversion time, regardless of what the PC-side export was called:
pack/file `nd08`, clip `ND08`, dance JSON `nd08.json`. Variants keep the base id +
suffix: `nd08_pp` / `ND08PP`. The `nd` prefix means "not yet adopted — subject to
pack/file `nd_08`, clip `ND08`, dance JSON `nd_08.json`. Variants keep the base id +
suffix: `nd_08_pp` / `ND08PP`. The `nd` prefix means "not yet adopted — subject to
rename or archive". Never name a new dance after its content (a take called
"firedance1" turned out to be dance1's choreography — content-guessed names lie).
**Stage 2 — adopted (chosen for a specific dance ceremony).** Dance codes are named
after the **ceremony the dance belongs to in the game**: `<ceremony><NN>` — the
ceremony slug in lowercase ascii (no spaces/diacritics: `powhiri`, `kapahaka`, `wero`,
`hulakahiko`, `hulaauana`, `sivaafi`, …), a two-digit index for multiple dances within
the same ceremony, PascalCase clip. Examples: pack `powhiri01` / clip `Powhiri01`,
variants `powhiri01_pp` / `Powhiri01PP`. A take is only renamed once Jeremy says which
ceremony it corresponds to. Rename with:
**Stage 2 — adopted (chosen for a specific dance ceremony).** Dance codes are the
**game ceremony** the dance belongs to — snake_case of the sim's `DanceType` enum
(`sim/arena/src/GameSystems.cs`) + a two-digit index for multiple takes per ceremony:
pack `war_dance_01`, clip `WarDance01` (PascalCase, matching the enum), dance JSON
`war_dance_01.json`, variants `war_dance_01_pp` / `WarDance01PP`. A take is only
renamed once Jeremy says which ceremony it corresponds to. Rename with:
```bash
/Applications/Blender.app/Contents/MacOS/Blender --background --python tools/rename_clip.py -- \
@@ -29,6 +31,24 @@ ceremony it corresponds to. Rename with:
**Archive.** Rejected/superseded takes move to `archive/` (this repo) and
`archive/dances/` (ariki-game, `.gdignore`d) — never deleted, never renamed.
## Ceremony slots (from the sim's `DanceType` enum + tech tree)
| ceremony code | Age | status | take |
|---|---|---|---|
| `water_dance_01` | 1 | awaiting take | — |
| `fire_dance_01` | 1 | awaiting take | — (the old "firedance1" was mislabeled dance1 choreography) |
| `tide_dance_01` | 1 | awaiting take | — |
| `fertility_dance_01` | 1 | awaiting take | candidate: aloha1 (hula) |
| `food_dance_01` | 1 | awaiting take | candidate: aloha1 / dance1 |
| `taming_dance_01` | 1 | awaiting take | — |
| `sailing_dance_01` | 2 | awaiting take | — |
| `war_dance_01` | 2 | awaiting take | candidate: hakadance1 (haka) |
| `building_dance_01` | 2 | awaiting take | — |
| `colony_shield_dance_01` | 2 | awaiting take | — |
| `age_progression_dance_01` | 3 | awaiting take | — (gates Age advancement) |
| `star_watching_dance_01` | 3 | awaiting take | — |
| `rain_dance_01` | tech | awaiting take | — (tech-tree "Rain Maker"; not in DanceType enum yet) |
## Register
| id | status | pack(s) | clip | origin take | notes |
@@ -42,5 +62,5 @@ ceremony it corresponds to. Rename with:
| — | archived | `hakaOG` | `HakaOG` | hakaOG | near-identical to hakadance1 |
| — | archived | `haka_mocap` | `HakaFull` | MediaPipe video mocap (2026-07-13) | pre-iClone experiment |
Next free provisional number: **nd01** (none issued yet — the five keepers predate
Next free provisional number: **nd_01** (none issued yet — the five keepers predate
the system and keep legacy names until adopted).