Files
animation/docs/dances/REGISTRY.md
T
2026-07-16 14:28:35 -07:00

2.8 KiB

Dance registry — single source of truth for names

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

/Applications/Blender.app/Contents/MacOS/Blender --background --python tools/rename_clip.py -- \
  --src exchange/<dir>/nd08.glb --out exchange/<dir>/haka01.glb --name Haka01

…then rename the dance JSON (+ its name and clip fields) in ariki-game, re-run game.sh import, and git mv the old files out. Update the row below.

Archive. Rejected/superseded takes move to archive/ (this repo) and archive/dances/ (ariki-game, .gdignored) — never deleted, never renamed.

Register

id status pack(s) clip origin take notes
candidate (legacy name) aloha1, aloha1_pp Aloha1, Aloha1PP aloha1 (iClone, 2026-07-15) hula; rename to hula## on adoption
candidate (legacy name) dance1, dance1_pp Dance1, Dance1PP dance1 (iClone, 2026-07-15) rename on adoption
candidate (legacy name) hakadance1 HakaDance1 hakadance1 (iClone, 2026-07-15) haka; rename to haka## on adoption
archived hakadance2 HakaDance2 hakadance2 near-duplicate of hakadance1 take family
archived alohaOG AlohaOG alohaOG superseded by aloha1
archived firedance1 FireDance1 firedance1 same choreography as dance1 — mislabeled export
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 the system and keep legacy names until adopted).