diff --git a/.claude/skills/animation/SKILL.md b/.claude/skills/animation/SKILL.md index 8515775..8411318 100644 --- a/.claude/skills/animation/SKILL.md +++ b/.claude/skills/animation/SKILL.md @@ -32,15 +32,16 @@ This skill is the accumulated **do-it-this-way** knowledge from real runs. Blender here is **5.1.2**. When running from this repo the `--target` is **required** — the tool's default target path is ariki-relative and won't resolve. ## Naming system (registry: `docs/dances/REGISTRY.md` — read it, it is the source of truth) -Two-stage names. **New dances get a provisional id, never a content name**: at -conversion, assign the next free `nd##` from the registry — pack `nd08`, clip `ND08`, -JSON `nd08.json`, variants `nd08_pp`/`ND08PP` — regardless of what the PC export was -called (a take named "firedance1" turned out to be dance1's choreography). Only when -Jeremy **adopts** a take for a specific in-game dance is it renamed to its dance code — -codes are named after the **dance ceremony** the take corresponds to: `` -lowercase-ascii pack (`powhiri01`, `hulakahiko01`, `sivaafi01`), PascalCase clip -(`Powhiri01`) — via `tools/rename_clip.py` + JSON rename + registry update. Never -guess the ceremony; Jeremy assigns it. Rejected takes are archived +Two-stage names, following the **game's item-id convention (lowercase snake_case)**. +**New dances get a provisional id, never a content name**: at conversion, assign the +next free `nd_##` from the registry — pack `nd_08`, clip `ND08`, JSON `nd_08.json`, +variants `nd_08_pp`/`ND08PP` — regardless of what the PC export was called (a take +named "firedance1" turned out to be dance1's choreography). Only when Jeremy **adopts** +a take for a specific in-game dance ceremony is it renamed to its dance code — +snake_case of the sim's `DanceType` enum + index: pack `war_dance_01`, clip +`WarDance01`, variants `war_dance_01_pp`/`WarDance01PP`. The 13 ceremony slots are +tabled in the registry. Rename via `tools/rename_clip.py` + JSON rename + registry +update. Never guess the ceremony; Jeremy assigns it. Rejected takes are archived (`archive/` here; `archive/dances/` in ariki-game, which is `.gdignore`d), never deleted. Numbers are never reused. Always update the registry row when converting/adopting/archiving. diff --git a/docs/dances/REGISTRY.md b/docs/dances/REGISTRY.md index f406e43..f41f383 100644 --- a/docs/dances/REGISTRY.md +++ b/docs/dances/REGISTRY.md @@ -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**: `` — 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).