Release Healer Man 0.1.9

BALANCE_BENCHMARKS.md

@@ -0,0 +1,52 @@
+# Balance benchmarks
+
+The balance benchmark suite provides repeatable evidence for tuning World of Warcraft, CoA, and Runes of Magic classes. It runs fixed builds through versioned damage, tanking, healing, movement, stacking, and resource-endurance scenarios. The goal is to reveal balance changes and outliers, not to name a universally best class.
+
+## Default cohort
+
+The default comparison cohort is level 60, matching CoA's authored cap while keeping the three content sources in one cohort. It uses the `coefficient-empty` preset: no equipment, so the first cohort isolates base kits, scaling coefficients, talents, and resources. Gear-normalized cohorts should be added separately rather than mixed with this one.
+
+Every comparison must use the same gear preset, scenario version, baseline policy ID, duration scale, and seed set. A changed level, gear preset, scenario, policy, or app version creates a new cohort and should not be compared directly with an older one.
+
+Run the suite with:
+
+```sh
+npm run balance:benchmark
+```
+
+Use `npm run balance:smoke` for a short end-to-end check. The full command accepts comma-separated `--class`, `--role`, `--scenario`, and `--seeds` filters, plus `--level`, `--duration-scale`, and `--output`. For example:
+
+```sh
+npm run balance:benchmark -- --class priest,rom-priest --role healer --seeds 1,2,3
+```
+
+The command is the intended stable entry point for the benchmark runner. Its output directory contains:
+
+- `matrix.json`: raw run reports, build and scenario definitions, seed metadata, validation results, ability details, resources, and event counts.
+- `matrix.csv`: one row per scenario, build, and metric, with observed/null counts plus median, p10, and p90 values.
+- `summary.md`: a concise role-separated comparison for review and pull-request evidence.
+
+Keep the JSON artifact when investigating a result. The CSV and Markdown are derived views and can be regenerated from it.
+
+## Reading results
+
+The reported center is the median across validated seeded runs. The p10–p90 interval shows run-to-run spread; a wide interval calls for more seeds or investigation before tuning. Invalid runs are counted but excluded from distributions. An early death or other scenario stop can be a valid outcome and should not be discarded merely because the full duration was not reached.
+
+Interpret each role as a vector of outcomes, not a single ranking:
+
+- Damage builds emphasize DPS and priority-target damage, with deaths and mechanics failures alongside throughput.
+- Tanks emphasize damage taken per second, mitigation, avoidance, threat control, minimum health, survival, and their damage contribution.
+- Healers emphasize healing per second, consumed absorbs, overheal, party health, deaths, and time to resource failure.
+- Movement and stack scenarios add movement interrupts and stack compliance to the relevant role vector.
+
+No composite score is produced. Compare a build only with other builds in the same scenario version and cohort, and inspect the underlying metrics before making a balance change. A null time to resource failure means the resource was not exhausted during that run; it is not zero. Similarly, a null time to first death means no death occurred.
+
+## Limitations
+
+- The baseline policy is a deterministic, maintainable reference policy, not an optimal player rotation. Skilled play may outperform it, and policy changes can move results without a class-data change.
+- The initial `coefficient-empty` cohort does not model production gear breakpoints or itemization. Add explicit equal-budget gear presets for that work.
+- Runes of Magic coverage is primary-class-only initially. Secondary-class and dual-class interactions require their own explicitly versioned cohort when supported.
+- Results cover mechanics represented by the simulator and scenarios; they do not replace live encounter playtesting, usability review, or PvP testing.
+- Small seed sets can miss rare random outcomes. Treat p10 and p90 as descriptive bounds for the sampled runs, not guarantees.
+- Total metrics depend on scenario duration. Compare rates or fixed-duration totals only within the same scenario definition.
+- Gear-stat budgets must be equivalent, but equivalent budgets do not guarantee identical interactions with every class kit.

PLAYTEST_NOTES.md

@@ -1451,3 +1451,72 @@ Vite's existing large-chunk advisory remains informational.
   passed all 755 cases across 132 files (including the 28 avatar cases), and the
   TypeScript production build completed successfully with 983 modules
   transformed. The existing large-chunk advisory remains informational.
+
+# 2026-08-28 — configurable render caps and idle-loop efficiency
+
+- Opened the saved Human Priest roster after a fresh client reload. The full
+  body and starter staff rendered correctly in the single character-preview
+  canvas, which reported the persisted 30 FPS preview cap and manual frame loop.
+- Entered Wailing Caverns as healer and exercised the gameplay setting live.
+  The performance probe settled at about 30.5 FPS for the 30 FPS option and 60
+  FPS for the 60 FPS option; combat and fixed-step physics continued normally.
+- Pausing switched the dungeon canvas to demand rendering. Its performance
+  counters remained byte-for-byte unchanged over 1.4 seconds, confirming that
+  the local paused scene did not keep rendering in the background.
+- Returned gameplay rendering to the default 60 FPS and left the character
+  preview at 30 FPS. Evidence reviewed during the browser run included the
+  roster-preview and live dungeon screenshots. The final fresh session emitted
+  no errors; the existing third-party initialization deprecation warning
+  remained non-blocking.
+- Verification: the focused efficiency tests passed all 83 cases, all 28 avatar
+  tests passed, the complete Vitest suite passed all 809 cases across 148 files,
+  and the production build completed with 1,043 modules transformed. KTX2 and
+  environment-performance audits remained green; the existing large-chunk
+  advisory remains informational.
+
+# 2026-08-30 — authored weapon grips and ready stances
+
+- Reloaded the offline client and switched a Human female preview directly
+  between Hunter, Warrior, and Priest. The bow, sword/shield, and staff changed
+  immediately to their native HoldBow, Ready1H, and Ready2HL poses; no stale
+  class pose or backward procedural axis remained.
+- Verified RuneWaker Human Warrior and Scout previews against their explicit
+  hand/shield locator frames. The one-hand, shield, and bow silhouettes used the
+  RuneWaker socket-axis adapter and remained proportionate to the character.
+  Also checked the Ascension Human Ranger fallback with its bow visible in a
+  supported ready pose.
+- The saved Human Priest roster preview showed the complete body and staff with
+  both hands aligned to the shaft. In Wailing Caverns, the player and party
+  equipment remained attached through live combat animation without a second
+  local weapon swing or load-time placement jump.
+- Evidence: `playtest-artifacts/2026-08-30-weapon-grip/weapon-grip-roster.png`,
+  `human-hunter-holdbow.png`, `human-warrior-ready1h.png`,
+  `human-priest-ready2hl.png`, `runewaker-warrior-sockets.png`,
+  `runewaker-scout-bow.png`, `ascension-ranger-bow.png`, and
+  `weapon-grip-dungeon.png`.
+- Verification: all 41 avatar tests passed, the 37-test focused weapon/stance
+  suite passed, and the production build completed with 1,047 modules
+  transformed. Asset audits remained green with zero KTX2 fallbacks and zero
+  environment-performance regressions; the existing large-chunk advisory
+  remains informational.
+
+# 2026-08-30 — bounded combat VFX bursts and silent audio default
+
+- Created a fresh offline Human Priest and confirmed the in-game Options panel
+  opened with **Master volume** at 0%. Gameplay and preview frame-rate controls,
+  VFX quality, and per-actor VFX/audio controls remained available.
+- Entered Wailing Caverns as healer, sent the party into combat, and captured a
+  live four-effect spell burst. High quality reported four active effect systems
+  and zero combat point lights; additive particles, impacts, melee arcs, the HUD,
+  and combat telegraphs remained visible.
+- The captured burst reported 60 FPS, a 16.7 ms average frame, a 16.8 ms slowest
+  frame, 258 draw calls, and 353,526 triangles at 1.5 pixel ratio. A three-second
+  combat sample reached five concurrent effects, stayed between 54.1 and 60 FPS,
+  and returned to a 16.7 ms frame average.
+- A cold Vite dynamic import failed once while first opening character creation;
+  reloading after compilation resolved it. The final dungeon run had no further
+  errors; the existing third-party initialization deprecation warning remained.
+- Verification: the complete Vitest suite passed all 839 cases across 153 files,
+  the production build completed with 1,047 modules transformed, KTX2 and
+  environment-performance audits remained green, and the release-candidate
+  check passed. The existing large-chunk advisory remains informational.

dungeon-pipeline/recipes/ahnkahet-old-kingdom.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/arcatraz.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/TempestKeepArcane",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/auchenai-crypts.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/AuchindounDraenei",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/azjol-nerub.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/black-morass.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "burning-crusade",
   "extraction": {

dungeon-pipeline/recipes/blackfathom-deeps.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Blackfathom",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [20, 30]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/blackrock-depths.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/BlackrockDepths",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [50, 60]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/blackrock-spire.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/BlackRockSpire",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [55, 60]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/blood-furnace.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/HellfireDemon",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [58, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/botanica.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/TempestKeepAtrium",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/culling-of-stratholme.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/dire-maul.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/DireMaul",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [0, 0, 0], "yawDegrees": 180},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [50, 60]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/draktharon-keep.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/escape-from-durnholde.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "burning-crusade",
   "extraction": {

dungeon-pipeline/recipes/forge-of-souls.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/gnomeregan.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/GnomeragonInstance",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [25, 40]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/gundrak.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/halls-of-lightning.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/halls-of-reflection.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/halls-of-stone.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/hellfire-ramparts.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/HellfireRampart",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [1262.4427, -60.8902, 1622.5397], "yawDegrees": 262.143},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [58, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/magisters-terrace.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Sunwell5ManFix",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [70, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/mana-tombs.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/AuchindounEthereal",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/maraudon.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Mauradon",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [40, 55]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/mechanar.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/TempestKeepFactory",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/pit-of-saron.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/ragefire-chasm.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/OrgrimmarInstance",
   "environmentMode": "global-wmo",
+  "globalWmoAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [13, 25]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/razorfen-downs.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/RazorfenDowns",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [-2402.2809, 62, 1208.3219], "yawDegrees": 0},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [35, 50]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/razorfen-kraul.json

@@ -8,7 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/RazorfenKraulInstance",
   "environmentMode": "global-wmo",
-  "globalWmoSourceBasis": "flip-x",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [-1952.1803, 87.684, 1587.8923], "yawDegrees": -133},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [25, 40]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/scarlet-monastery.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a",
   "mapDirectory": "World/Maps/MonasteryInstances",
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
+  "adtSourceBasis": "z-y-negative-x",
   "difficultyVariants": [
     { "id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [26, 45] }
   ],

dungeon-pipeline/recipes/scholomance.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/SchoolofNecromancy",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [-141.694, 148.0683, 105.6784], "yawDegrees": 1},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [55, 60]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/sethekk-halls.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/AuchindounDemon",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/shadow-labyrinth.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/AuchindounShadow",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [65, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/shadowfang-keep.json

@@ -7,12 +7,14 @@
   "expansion": "classic",
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Shadowfang",
-  "environmentMode": "global-wmo",
+  "environmentMode": "detect",
+  "coordinateAlignment": "source",
+  "adtSourceBasis": "z-y-negative-x",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [18, 30]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},
-  "extraction": {"rootWmo": "World/wmo/Dungeon/LD_ShadowFang/LD_ShadowFang.wmo", "doodadSets": ["Set_$DefaultGlobal"]},
+  "extraction": {"adtTiles": "all-present"},
-  "navigation": {"cellSize": 0.2, "cellHeight": 0.1, "agentHeight": 1.8, "agentRadius": 0.36, "agentMaxClimb": 0.5, "agentMaxSlope": 50},
+  "navigation": {"cellSize": 0.2, "cellHeight": 0.1, "tileSize": 256, "retainTileIntermediates": false, "agentHeight": 1.8, "agentRadius": 0.36, "agentMaxClimb": 0.5, "agentMaxSlope": 50},
   "review": {"entrance": "required", "bossOrder": "required", "optionalEncounters": "required", "presentation": "required", "offMeshLinks": "required"},
   "exceptions": []
 }

dungeon-pipeline/recipes/shattered-halls.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/HellfireMilitary",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [60, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/slave-pens.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/CoilfangDraenei",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [60, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/steamvault.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/CoilfangPumping",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [60, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/stratholme.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Stratholme",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source-transform",
+  "coordinateTransform": {"origin": [-3449.6608, 144.3848, -3379.6966], "yawDegrees": 0},
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [55, 60]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/sunken-temple.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/SunkenTemple",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [45, 55]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/the-nexus.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/the-oculus.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/trial-of-the-champion.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/uldaman.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/Uldaman",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [
     {
       "id": "normal",

dungeon-pipeline/recipes/underbog.json

@@ -8,6 +8,7 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/CoilfangMarsh",
   "environmentMode": "global-wmo",
+  "coordinateAlignment": "source",
   "difficultyVariants": [{"id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [60, 70]}],
   "clientSource": {"rootEnvironmentVariable": "WOW_CLIENT_ROOT", "relativeDefault": "../wow335a"},
   "serverSource": {"rootEnvironmentVariable": "WOW_SERVER_DATA", "adapter": "normalized-json", "readOnly": true},

dungeon-pipeline/recipes/utgarde-keep.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/utgarde-pinnacle.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/violet-hold.json

@@ -27,6 +27,7 @@
     }
   ],
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
   "exceptions": [],
   "expansion": "wrath",
   "extraction": {

dungeon-pipeline/recipes/zulfarrak.json

@@ -8,6 +8,8 @@
   "clientBuild": "3.3.5a-Ascension",
   "mapDirectory": "World/Maps/TanarisInstance",
   "environmentMode": "detect",
+  "coordinateAlignment": "source",
+  "adtSourceBasis": "z-y-negative-x",
   "difficultyVariants": [
     { "id": "normal", "difficulty": "normal", "spawnMask": 1, "levelRange": [40, 54] }
   ],

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "healer-man",
-  "version": "0.1.6",
+  "version": "0.1.9",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "healer-man",
-      "version": "0.1.6",
+      "version": "0.1.9",
       "dependencies": {
         "@capacitor/android": "8.4.1",
         "@capacitor/core": "8.4.1",

package.json

@@ -1,7 +1,7 @@
 {
   "name": "healer-man",
   "private": true,
-  "version": "0.1.6",
+  "version": "0.1.9",
   "type": "module",
   "scripts": {
     "dev": "vite --host 0.0.0.0",
@@ -20,7 +20,8 @@
     "coa:sync:live": "node scripts/sync-ascension-coa.mjs --tooltips",
     "coa:icons": "node scripts/export-spell-icons.mjs",
     "ascension:talents": "node scripts/generate-wow335-talents.mjs ../wow335a/Interface/AddOns/PlayerBotManager/PBM/PBM_TalentData.lua ../LadiksMPQEditor/client-current/area-52/patch-D/DBFilesClient/Spell.dbc src/game/wow335Talents.generated.ts ../LadiksMPQEditor/client-current/area-52/patch-D/DBFilesClient/Talent.dbc",
-    "ascension:sync": "npm run coa:sync && npm run wow335:abilities && npm run ascension:talents && npm run coa:icons",
+    "catalogs:shard": "vite-node scripts/generate-catalog-shards.ts",
+    "ascension:sync": "npm run coa:sync && npm run wow335:abilities && npm run ascension:talents && npm run coa:icons && npm run catalogs:shard",
     "manastorm:import": "node scripts/manastorm-import/cli.mjs",
     "manastorm:forensics": "node scripts/manastorm-import/forensics-cli.mjs",
     "manastorm:sync": "npm run manastorm:import && npm run manastorm:forensics && npm run coa:icons",
@@ -91,7 +92,10 @@
     "assets:ktx2:creatures": "node scripts/asset-pipeline/compress-creature-ktx2.mjs",
     "assets:ktx2:audit": "node scripts/asset-pipeline/audit-ktx2.mjs --visual-only --require-all",
     "assets:ktx2:refresh-metadata": "node scripts/asset-pipeline/refresh-ktx2-metadata.mjs",
-    "prebuild": "npm run loot:generate && npm run assets:ktx2:audit",
+    "assets:performance:audit": "node scripts/asset-pipeline/audit-environment-performance.mjs",
+    "balance:benchmark": "vite-node scripts/combat-benchmark/run.ts",
+    "balance:smoke": "vite-node scripts/combat-benchmark/run.ts --class mage --role damage --scenario damage-single-burst --seeds 1 --duration-scale 0.2",
+    "prebuild": "npm run loot:generate && npm run assets:ktx2:audit && npm run assets:performance:audit",
     "build": "node --max-old-space-size=8192 node_modules/typescript/bin/tsc -b && node --max-old-space-size=8192 node_modules/vite/bin/vite.js build",
     "build:android:web": "npm run prebuild && npm run android:prepare && node --max-old-space-size=8192 node_modules/typescript/bin/tsc -b && node --max-old-space-size=8192 node_modules/vite/bin/vite.js build --mode android",
     "android:sync": "npm run build:android:web && cap sync android",

public/assets/game/dungeons/blackrock-depths/dungeon-pack.json

@@ -13,8 +13,8 @@
       {
         "id": "visual",
         "url": "/assets/game/manastorm/230-blackrockdepths/visual.glb",
-        "checksum": "42d57961c31f54ecc7bc78829751110fc89294e6318336b8f260e132e478d13d",
+        "checksum": "7e4c7c75a898f5000fcb686dcfc6d3c1c4e675dc3dac5f7a8d48e53372b9f364",
-        "byteLength": 10266900,
+        "byteLength": 7068884,
         "triangleCount": 248302,
         "compression": "meshopt+ktx2"
       }

public/assets/game/manastorm/230-blackrockdepths/stage-pack.json

@@ -7,8 +7,8 @@
     {
       "id": "visual",
       "url": "/assets/game/manastorm/230-blackrockdepths/visual.glb",
-      "checksum": "42d57961c31f54ecc7bc78829751110fc89294e6318336b8f260e132e478d13d",
+      "checksum": "7e4c7c75a898f5000fcb686dcfc6d3c1c4e675dc3dac5f7a8d48e53372b9f364",
-      "byteLength": 10266900,
+      "byteLength": 7068884,
       "triangleCount": 248302,
       "compression": "meshopt+ktx2"
     }

release-version.json

@@ -1,4 +1,4 @@
 {
-  "versionName": "0.1.6",
+  "versionName": "0.1.9",
-  "versionCode": 1006
+  "versionCode": 1009
 }

scripts/asset-pipeline/audit-environment-performance.mjs

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { access, mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { analyzeGlbFile } from "./glb-performance.mjs";
+
+const projectRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const baselineFile = path.join(
+  projectRoot,
+  "scripts/asset-pipeline/environment-performance-baseline.json",
+);
+const defaultRoots = [
+  path.join(projectRoot, "public/assets/game/manastorm"),
+  path.join(projectRoot, "src/assets/game/dungeons"),
+];
+const defaultThresholds = {
+  maxEstimatedDrawCalls: 1_500,
+  maxUnbatchedDrawCallSavings: 250,
+};
+
+async function exists(file) {
+  try {
+    await access(file);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function collectVisualGlbs(root, files = []) {
+  if (!await exists(root)) return files;
+  const entry = await stat(root);
+  if (entry.isFile()) {
+    if (/(?:^|[-_])visual\.glb$/i.test(path.basename(root))) files.push(root);
+    return files;
+  }
+  for (const child of await readdir(root, { withFileTypes: true })) {
+    const target = path.join(root, child.name);
+    if (child.isDirectory()) await collectVisualGlbs(target, files);
+    else if (/(?:^|[-_])visual\.glb$/i.test(child.name)) files.push(target);
+  }
+  return files;
+}
+
+function projectPath(file) {
+  return path.relative(projectRoot, file).split(path.sep).join("/");
+}
+
+function exceeds(report, limits) {
+  return report.estimatedDrawCalls > limits.maxEstimatedDrawCalls
+    || report.unbatchedDrawCallSavings > limits.maxUnbatchedDrawCallSavings;
+}
+
+const args = process.argv.slice(2);
+const writeBaseline = args.includes("--write-baseline");
+const roots = args.filter((argument) => argument !== "--write-baseline")
+  .map((argument) => path.resolve(projectRoot, argument));
+const files = [...new Set((await Promise.all(
+  (roots.length ? roots : defaultRoots).map((root) => collectVisualGlbs(root)),
+)).flat())].sort();
+const reports = await Promise.all(files.map(async (file) => ({
+  file: projectPath(file),
+  byteLength: (await stat(file)).size,
+  ...(await analyzeGlbFile(file)),
+})));
+
+if (writeBaseline) {
+  const baseline = {
+    schemaVersion: 1,
+    thresholds: defaultThresholds,
+    exceptions: Object.fromEntries(
+      reports
+        .filter((report) => exceeds(report, defaultThresholds))
+        .map((report) => [report.file, {
+          maxEstimatedDrawCalls: Math.max(defaultThresholds.maxEstimatedDrawCalls, report.estimatedDrawCalls),
+          maxUnbatchedDrawCallSavings: Math.max(
+            defaultThresholds.maxUnbatchedDrawCallSavings,
+            report.unbatchedDrawCallSavings,
+          ),
+        }]),
+    ),
+  };
+  await mkdir(path.dirname(baselineFile), { recursive: true });
+  await writeFile(baselineFile, `${JSON.stringify(baseline, null, 2)}\n`, "utf8");
+  console.log(`Wrote ${Object.keys(baseline.exceptions).length} performance exceptions to ${projectPath(baselineFile)}.`);
+  process.exit(0);
+}
+
+if (!await exists(baselineFile)) {
+  throw new Error(`Missing ${projectPath(baselineFile)}. Run this script with --write-baseline.`);
+}
+const baseline = JSON.parse(await readFile(baselineFile, "utf8"));
+const thresholds = { ...defaultThresholds, ...baseline.thresholds };
+const regressions = reports.filter((report) => {
+  const limits = { ...thresholds, ...baseline.exceptions?.[report.file] };
+  return exceeds(report, limits);
+});
+const debt = reports.filter((report) => exceeds(report, thresholds));
+const top = [...reports]
+  .sort((left, right) => right.estimatedDrawCalls - left.estimatedDrawCalls)
+  .slice(0, 12)
+  .map((report) => ({
+    asset: report.file,
+    calls: report.estimatedDrawCalls,
+    avoidable: report.unbatchedDrawCallSavings,
+    gpuBatches: report.gpuInstanceBatches,
+    nodes: report.nodes,
+  }));
+
+console.table(top);
+console.log(JSON.stringify({
+  status: regressions.length ? "blocked" : "green",
+  assets: reports.length,
+  knownBudgetExceptions: debt.length,
+  regressions: regressions.map((report) => ({
+    file: report.file,
+    estimatedDrawCalls: report.estimatedDrawCalls,
+    unbatchedDrawCallSavings: report.unbatchedDrawCallSavings,
+  })),
+}, null, 2));
+if (regressions.length) process.exitCode = 1;

scripts/asset-pipeline/environment-performance-baseline.json

@@ -0,0 +1,249 @@
+{
+  "schemaVersion": 1,
+  "thresholds": {
+    "maxEstimatedDrawCalls": 1500,
+    "maxUnbatchedDrawCallSavings": 250
+  },
+  "exceptions": {
+    "public/assets/game/manastorm/109-sunkentemple/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 320
+    },
+    "public/assets/game/manastorm/129-razorfendowns/visual.glb": {
+      "maxEstimatedDrawCalls": 1507,
+      "maxUnbatchedDrawCallSavings": 1406
+    },
+    "public/assets/game/manastorm/1771-custom-marsh/visual.glb": {
+      "maxEstimatedDrawCalls": 2493,
+      "maxUnbatchedDrawCallSavings": 2114
+    },
+    "public/assets/game/manastorm/1774-custom-tropical/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 910
+    },
+    "public/assets/game/manastorm/1775-custom-tuskarr/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 500
+    },
+    "public/assets/game/manastorm/1776-custom-vrykul1/visual.glb": {
+      "maxEstimatedDrawCalls": 2223,
+      "maxUnbatchedDrawCallSavings": 1818
+    },
+    "public/assets/game/manastorm/1781-forgottenmine/visual.glb": {
+      "maxEstimatedDrawCalls": 5756,
+      "maxUnbatchedDrawCallSavings": 3818
+    },
+    "public/assets/game/manastorm/1785-valsharaharena/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 392
+    },
+    "public/assets/game/manastorm/1787-baradinholdarena/visual.glb": {
+      "maxEstimatedDrawCalls": 10462,
+      "maxUnbatchedDrawCallSavings": 9362
+    },
+    "public/assets/game/manastorm/1794-twistingnether/visual.glb": {
+      "maxEstimatedDrawCalls": 3077,
+      "maxUnbatchedDrawCallSavings": 2557
+    },
+    "public/assets/game/manastorm/209-tanarisinstance/visual.glb": {
+      "maxEstimatedDrawCalls": 4579,
+      "maxUnbatchedDrawCallSavings": 3547
+    },
+    "public/assets/game/manastorm/229-blackrockspire/visual.glb": {
+      "maxEstimatedDrawCalls": 3972,
+      "maxUnbatchedDrawCallSavings": 3598
+    },
+    "public/assets/game/manastorm/269-cavernsoftime/visual.glb": {
+      "maxEstimatedDrawCalls": 5446,
+      "maxUnbatchedDrawCallSavings": 5289
+    },
+    "public/assets/game/manastorm/289-schoolofnecromancy/visual.glb": {
+      "maxEstimatedDrawCalls": 5140,
+      "maxUnbatchedDrawCallSavings": 4790
+    },
+    "public/assets/game/manastorm/309-zul-gurub/visual.glb": {
+      "maxEstimatedDrawCalls": 17377,
+      "maxUnbatchedDrawCallSavings": 15605
+    },
+    "public/assets/game/manastorm/329-stratholme/visual.glb": {
+      "maxEstimatedDrawCalls": 2954,
+      "maxUnbatchedDrawCallSavings": 2725
+    },
+    "public/assets/game/manastorm/34-stormwindjail/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 487
+    },
+    "public/assets/game/manastorm/349-mauradon/visual.glb": {
+      "maxEstimatedDrawCalls": 5624,
+      "maxUnbatchedDrawCallSavings": 5352
+    },
+    "public/assets/game/manastorm/36-deadminesinstance/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 309
+    },
+    "public/assets/game/manastorm/389-orgrimmarinstance/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 881
+    },
+    "public/assets/game/manastorm/429-diremaul/visual.glb": {
+      "maxEstimatedDrawCalls": 5021,
+      "maxUnbatchedDrawCallSavings": 4636
+    },
+    "public/assets/game/manastorm/469-blackwinglair/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 452
+    },
+    "public/assets/game/manastorm/47-razorfenkraulinstance/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 897
+    },
+    "public/assets/game/manastorm/48-blackfathom/visual.glb": {
+      "maxEstimatedDrawCalls": 2164,
+      "maxUnbatchedDrawCallSavings": 1950
+    },
+    "public/assets/game/manastorm/509-ahnqiraj/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 600
+    },
+    "public/assets/game/manastorm/531-ahnqirajtemple/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 953
+    },
+    "public/assets/game/manastorm/532-karazahn/visual.glb": {
+      "maxEstimatedDrawCalls": 8540,
+      "maxUnbatchedDrawCallSavings": 7892
+    },
+    "public/assets/game/manastorm/533-stratholme-raid/visual.glb": {
+      "maxEstimatedDrawCalls": 4165,
+      "maxUnbatchedDrawCallSavings": 4014
+    },
+    "public/assets/game/manastorm/540-hellfiremilitary/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 1150
+    },
+    "public/assets/game/manastorm/542-hellfiredemon/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 444
+    },
+    "public/assets/game/manastorm/543-hellfirerampart/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 296
+    },
+    "public/assets/game/manastorm/545-coilfangpumping/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 674
+    },
+    "public/assets/game/manastorm/546-coilfangmarsh/visual.glb": {
+      "maxEstimatedDrawCalls": 3104,
+      "maxUnbatchedDrawCallSavings": 3033
+    },
+    "public/assets/game/manastorm/547-coilfangdraenei/visual.glb": {
+      "maxEstimatedDrawCalls": 1535,
+      "maxUnbatchedDrawCallSavings": 1455
+    },
+    "public/assets/game/manastorm/548-coilfangraid/visual.glb": {
+      "maxEstimatedDrawCalls": 1916,
+      "maxUnbatchedDrawCallSavings": 1683
+    },
+    "public/assets/game/manastorm/550-tempestkeepraid/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 420
+    },
+    "public/assets/game/manastorm/552-tempestkeeparcane/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 999
+    },
+    "public/assets/game/manastorm/553-tempestkeepatrium/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 1115
+    },
+    "public/assets/game/manastorm/554-tempestkeepfactory/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 872
+    },
+    "public/assets/game/manastorm/555-auchindounshadow/visual.glb": {
+      "maxEstimatedDrawCalls": 2624,
+      "maxUnbatchedDrawCallSavings": 2516
+    },
+    "public/assets/game/manastorm/556-auchindoundemon/visual.glb": {
+      "maxEstimatedDrawCalls": 2095,
+      "maxUnbatchedDrawCallSavings": 1987
+    },
+    "public/assets/game/manastorm/557-auchindounethereal/visual.glb": {
+      "maxEstimatedDrawCalls": 3164,
+      "maxUnbatchedDrawCallSavings": 3026
+    },
+    "public/assets/game/manastorm/558-auchindoundraenei/visual.glb": {
+      "maxEstimatedDrawCalls": 2613,
+      "maxUnbatchedDrawCallSavings": 2523
+    },
+    "public/assets/game/manastorm/560-hillsbradpast/visual.glb": {
+      "maxEstimatedDrawCalls": 28259,
+      "maxUnbatchedDrawCallSavings": 24733
+    },
+    "public/assets/game/manastorm/568-zulaman/visual.glb": {
+      "maxEstimatedDrawCalls": 4307,
+      "maxUnbatchedDrawCallSavings": 3850
+    },
+    "public/assets/game/manastorm/574-valgarde70/visual.glb": {
+      "maxEstimatedDrawCalls": 8271,
+      "maxUnbatchedDrawCallSavings": 7072
+    },
+    "public/assets/game/manastorm/575-utgardepinnacle/visual.glb": {
+      "maxEstimatedDrawCalls": 16277,
+      "maxUnbatchedDrawCallSavings": 14018
+    },
+    "public/assets/game/manastorm/576-nexus70/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 396
+    },
+    "public/assets/game/manastorm/578-nexus80/visual.glb": {
+      "maxEstimatedDrawCalls": 2283,
+      "maxUnbatchedDrawCallSavings": 1896
+    },
+    "public/assets/game/manastorm/585-sunwell5manfix/visual.glb": {
+      "maxEstimatedDrawCalls": 1810,
+      "maxUnbatchedDrawCallSavings": 1618
+    },
+    "public/assets/game/manastorm/595-stratholmecot/visual.glb": {
+      "maxEstimatedDrawCalls": 4353,
+      "maxUnbatchedDrawCallSavings": 3386
+    },
+    "public/assets/game/manastorm/600-draktheronkeep/visual.glb": {
+      "maxEstimatedDrawCalls": 3518,
+      "maxUnbatchedDrawCallSavings": 2876
+    },
+    "public/assets/game/manastorm/602-ulduar80/visual.glb": {
+      "maxEstimatedDrawCalls": 1973,
+      "maxUnbatchedDrawCallSavings": 1295
+    },
+    "public/assets/game/manastorm/619-azjol-lowercity/visual.glb": {
+      "maxEstimatedDrawCalls": 1596,
+      "maxUnbatchedDrawCallSavings": 1243
+    },
+    "public/assets/game/manastorm/658-quarryoftears/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 618
+    },
+    "public/assets/game/manastorm/668-hallsofreflection/visual.glb": {
+      "maxEstimatedDrawCalls": 5464,
+      "maxUnbatchedDrawCallSavings": 4606
+    },
+    "public/assets/game/manastorm/70-uldaman/visual.glb": {
+      "maxEstimatedDrawCalls": 3268,
+      "maxUnbatchedDrawCallSavings": 3115
+    },
+    "public/assets/game/manastorm/821-tinketechshowdown/visual.glb": {
+      "maxEstimatedDrawCalls": 2585,
+      "maxUnbatchedDrawCallSavings": 2379
+    },
+    "public/assets/game/manastorm/90-gnomeragoninstance/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 1051
+    },
+    "public/assets/game/manastorm/908-alvaencounter/visual.glb": {
+      "maxEstimatedDrawCalls": 1500,
+      "maxUnbatchedDrawCallSavings": 1096
+    }
+  }
+}

scripts/asset-pipeline/glb-performance.mjs

@@ -0,0 +1,98 @@
+import { open } from "node:fs/promises";
+
+const GLB_MAGIC = 0x46546c67;
+const JSON_CHUNK_TYPE = 0x4e4f534a;
+const GPU_INSTANCING_EXTENSION = "EXT_mesh_gpu_instancing";
+
+function primitiveCount(json, meshIndex) {
+  return json.meshes?.[meshIndex]?.primitives?.length ?? 0;
+}
+
+function gpuInstanceCount(json, node) {
+  const attributes = node.extensions?.[GPU_INSTANCING_EXTENSION]?.attributes;
+  if (!attributes || typeof attributes !== "object") return 0;
+  return Math.max(
+    0,
+    ...Object.values(attributes).map((accessorIndex) => (
+      json.accessors?.[accessorIndex]?.count ?? 0
+    )),
+  );
+}
+
+export function analyzeGlbJson(json) {
+  const repeatedMeshes = new Map();
+  let estimatedDrawCalls = 0;
+  let expandedPrimitiveInstances = 0;
+  let meshNodes = 0;
+  let gpuInstanceBatches = 0;
+  let gpuInstances = 0;
+
+  for (const node of json.nodes ?? []) {
+    if (!Number.isInteger(node.mesh)) continue;
+    meshNodes += 1;
+    const primitives = primitiveCount(json, node.mesh);
+    const instances = gpuInstanceCount(json, node);
+    estimatedDrawCalls += primitives;
+    expandedPrimitiveInstances += primitives * Math.max(1, instances);
+    if (instances > 0) {
+      gpuInstanceBatches += 1;
+      gpuInstances += instances;
+      continue;
+    }
+    repeatedMeshes.set(node.mesh, (repeatedMeshes.get(node.mesh) ?? 0) + 1);
+  }
+
+  let eligibleRepeatedMeshes = 0;
+  let eligibleRepeatedNodes = 0;
+  let unbatchedDrawCallSavings = 0;
+  for (const [meshIndex, count] of repeatedMeshes) {
+    if (count < 3) continue;
+    eligibleRepeatedMeshes += 1;
+    eligibleRepeatedNodes += count;
+    unbatchedDrawCallSavings += (count - 1) * primitiveCount(json, meshIndex);
+  }
+
+  const materials = json.materials ?? [];
+  return {
+    nodes: json.nodes?.length ?? 0,
+    meshNodes,
+    meshes: json.meshes?.length ?? 0,
+    materials: materials.length,
+    textures: json.textures?.length ?? 0,
+    doubleSidedMaterials: materials.filter((material) => material.doubleSided === true).length,
+    blendedMaterials: materials.filter((material) => material.alphaMode === "BLEND").length,
+    estimatedDrawCalls,
+    expandedPrimitiveInstances,
+    gpuInstanceBatches,
+    gpuInstances,
+    eligibleRepeatedMeshes,
+    eligibleRepeatedNodes,
+    unbatchedDrawCallSavings,
+    usesGpuInstancing: (json.extensionsUsed ?? []).includes(GPU_INSTANCING_EXTENSION),
+  };
+}
+
+export async function readGlbJson(file) {
+  const handle = await open(file, "r");
+  try {
+    const header = Buffer.alloc(20);
+    const { bytesRead } = await handle.read(header, 0, header.length, 0);
+    if (bytesRead !== header.length
+      || header.readUInt32LE(0) !== GLB_MAGIC
+      || header.readUInt32LE(4) !== 2
+      || header.readUInt32LE(16) !== JSON_CHUNK_TYPE) {
+      throw new Error(`${file} is not a supported GLB 2.0 file.`);
+    }
+    const jsonLength = header.readUInt32LE(12);
+    const jsonBuffer = Buffer.alloc(jsonLength);
+    const jsonRead = await handle.read(jsonBuffer, 0, jsonLength, 20);
+    if (jsonRead.bytesRead !== jsonLength) throw new Error(`${file} has a truncated JSON chunk.`);
+    return JSON.parse(jsonBuffer.toString("utf8"));
+  } finally {
+    await handle.close();
+  }
+}
+
+export async function analyzeGlbFile(file) {
+  return analyzeGlbJson(await readGlbJson(file));
+}

scripts/asset-pipeline/glb-performance.test.mjs

@@ -0,0 +1,54 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { analyzeGlbJson } from "./glb-performance.mjs";
+
+test("counts repeated mesh placements as avoidable draw calls", () => {
+  const report = analyzeGlbJson({
+    meshes: [
+      { primitives: [{}, {}] },
+      { primitives: [{}] },
+    ],
+    nodes: [
+      { mesh: 0 },
+      { mesh: 0 },
+      { mesh: 0 },
+      { mesh: 1 },
+    ],
+    materials: [
+      { doubleSided: true, alphaMode: "BLEND" },
+      {},
+    ],
+    textures: [{}, {}],
+  });
+
+  assert.equal(report.estimatedDrawCalls, 7);
+  assert.equal(report.expandedPrimitiveInstances, 7);
+  assert.equal(report.eligibleRepeatedMeshes, 1);
+  assert.equal(report.eligibleRepeatedNodes, 3);
+  assert.equal(report.unbatchedDrawCallSavings, 4);
+  assert.equal(report.doubleSidedMaterials, 1);
+  assert.equal(report.blendedMaterials, 1);
+});
+
+test("counts one draw-call set for an EXT_mesh_gpu_instancing batch", () => {
+  const report = analyzeGlbJson({
+    extensionsUsed: ["EXT_mesh_gpu_instancing"],
+    accessors: [{ count: 12 }],
+    meshes: [{ primitives: [{}, {}, {}] }],
+    nodes: [{
+      mesh: 0,
+      extensions: {
+        EXT_mesh_gpu_instancing: {
+          attributes: { TRANSLATION: 0 },
+        },
+      },
+    }],
+  });
+
+  assert.equal(report.estimatedDrawCalls, 3);
+  assert.equal(report.expandedPrimitiveInstances, 36);
+  assert.equal(report.gpuInstanceBatches, 1);
+  assert.equal(report.gpuInstances, 12);
+  assert.equal(report.unbatchedDrawCallSavings, 0);
+  assert.equal(report.usesGpuInstancing, true);
+});

scripts/combat-benchmark/run.ts

@@ -0,0 +1,174 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { CLASSES, type ClassId } from "../../src/app/characterCatalog";
+import {
+  CANONICAL_BENCHMARK_LEVEL,
+  loadCanonicalBenchmarkBuilds,
+} from "../../src/game/benchmark/benchmarkBuilds";
+import { BENCHMARK_POLICY_ID } from "../../src/game/benchmark/benchmarkController";
+import {
+  renderBenchmarkMatrixMarkdown,
+  serializeBenchmarkMatrixCsv,
+} from "../../src/game/benchmark/benchmarkReport";
+import { runCombatBenchmark } from "../../src/game/benchmark/benchmarkRunner";
+import { BENCHMARK_SCENARIOS } from "../../src/game/benchmark/benchmarkScenarios";
+import type { BenchmarkMatrixReport } from "../../src/game/benchmark/benchmarkTypes";
+import type { PartyRole } from "../../src/game/partyRoles";
+
+interface CliOptions {
+  readonly level: number;
+  readonly classIds: readonly ClassId[] | null;
+  readonly roles: readonly PartyRole[] | null;
+  readonly scenarioIds: readonly string[] | null;
+  readonly seeds: readonly number[];
+  readonly durationScale: number;
+  readonly output: string | null;
+}
+
+const projectRoot = resolve(import.meta.dirname, "../..");
+
+function argumentValue(arguments_: readonly string[], name: string): string | null {
+  const index = arguments_.indexOf(name);
+  if (index < 0) return null;
+  const value = arguments_[index + 1];
+  if (!value || value.startsWith("--")) throw new Error(`${name} requires a value.`);
+  return value;
+}
+
+function list(value: string | null): readonly string[] | null {
+  if (value === null) return null;
+  const values = value.split(",").map((entry) => entry.trim()).filter(Boolean);
+  if (!values.length) throw new Error("A comma-separated filter cannot be empty.");
+  return values;
+}
+
+function finiteNumber(value: string | null, fallback: number, name: string): number {
+  if (value === null) return fallback;
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) throw new Error(`${name} must be a finite number.`);
+  return parsed;
+}
+
+function parseOptions(arguments_: readonly string[]): CliOptions {
+  const knownClasses = new Set(CLASSES.map((definition) => definition.id));
+  const classIds = list(argumentValue(arguments_, "--class"));
+  if (classIds?.some((id) => !knownClasses.has(id as ClassId))) {
+    throw new Error(`Unknown class filter: ${classIds.find((id) => !knownClasses.has(id as ClassId))}.`);
+  }
+  const roles = list(argumentValue(arguments_, "--role"));
+  if (roles?.some((role) => !["tank", "healer", "damage"].includes(role))) {
+    throw new Error(`Unknown role filter: ${roles.find((role) => !["tank", "healer", "damage"].includes(role))}.`);
+  }
+  const scenarioIds = list(argumentValue(arguments_, "--scenario"));
+  const knownScenarios = new Set(BENCHMARK_SCENARIOS.map((scenario) => scenario.id));
+  if (scenarioIds?.some((id) => !knownScenarios.has(id))) {
+    throw new Error(`Unknown scenario filter: ${scenarioIds.find((id) => !knownScenarios.has(id))}.`);
+  }
+  const seeds = (list(argumentValue(arguments_, "--seeds")) ?? ["1", "2", "3"])
+    .map((seed) => Number(seed));
+  if (!seeds.length || seeds.some((seed) => !Number.isSafeInteger(seed))) {
+    throw new Error("--seeds must contain comma-separated safe integers.");
+  }
+  const durationScale = finiteNumber(argumentValue(arguments_, "--duration-scale"), 1, "--duration-scale");
+  if (durationScale <= 0) throw new Error("--duration-scale must be greater than zero.");
+  return {
+    level: Math.trunc(finiteNumber(argumentValue(arguments_, "--level"), CANONICAL_BENCHMARK_LEVEL, "--level")),
+    classIds: classIds as readonly ClassId[] | null,
+    roles: roles as readonly PartyRole[] | null,
+    scenarioIds,
+    seeds,
+    durationScale,
+    output: argumentValue(arguments_, "--output"),
+  };
+}
+
+function help(): string {
+  return [
+    "Healer Man balance benchmark",
+    "",
+    "Usage: npm run balance:benchmark -- [options]",
+    "",
+    "Options:",
+    "  --class mage,templar       Limit primary classes.",
+    "  --role damage,healer       Limit roles.",
+    "  --scenario id,id           Limit scenario IDs.",
+    "  --level 60                 Comparison level (default 60).",
+    "  --seeds 1,2,3              Deterministic seeds.",
+    "  --duration-scale 1         Scale scenario duration (smoke tests only below 1).",
+    "  --output path              Output directory under the current path or absolute.",
+    "  --help                     Show this help.",
+    "",
+  ].join("\n");
+}
+
+function timestampDirectory(iso: string): string {
+  return iso.replaceAll(":", "-").replace(/\.\d{3}Z$/u, "Z");
+}
+
+async function main(): Promise<void> {
+  const arguments_ = process.argv.slice(2);
+  if (arguments_.includes("--help")) {
+    process.stdout.write(help());
+    return;
+  }
+  const options = parseOptions(arguments_);
+  const generatedAt = new Date().toISOString();
+  const packageJson = JSON.parse(readFileSync(resolve(projectRoot, "package.json"), "utf8")) as { version: string };
+  const builds = (await loadCanonicalBenchmarkBuilds(options.level, options.classIds ?? undefined))
+    .filter((build) => !options.roles || options.roles.includes(build.role));
+  const scenarios = BENCHMARK_SCENARIOS.filter((scenario) => (
+    !options.scenarioIds || options.scenarioIds.includes(scenario.id)
+  ));
+  const pairs = builds.flatMap((build) => scenarios
+    .filter((scenario) => scenario.roles.includes(build.role))
+    .map((scenario) => ({ build, scenario })));
+  if (!pairs.length) throw new Error("The selected filters produced no compatible build/scenario pairs.");
+
+  const totalRuns = pairs.length * options.seeds.length;
+  const runs = [];
+  let completed = 0;
+  for (const pair of pairs) {
+    for (const seed of options.seeds) {
+      completed += 1;
+      process.stdout.write(
+        `[${completed}/${totalRuns}] ${pair.build.classId}:${pair.build.role} / ${pair.scenario.id} / seed ${seed}\n`,
+      );
+      const run = await runCombatBenchmark(pair.build, pair.scenario, {
+        seed,
+        durationScale: options.durationScale,
+      });
+      runs.push(run);
+      if (!run.validation.valid) {
+        process.stderr.write(`  invalid: ${run.validation.reasons.join("; ")}\n`);
+      }
+    }
+  }
+
+  const report: BenchmarkMatrixReport = {
+    schemaVersion: 1,
+    generatedAt,
+    appVersion: packageJson.version,
+    cohort: {
+      level: options.level,
+      gearPresetId: builds[0]?.gearPresetId ?? "coefficient-empty",
+      seeds: options.seeds,
+      durationScale: options.durationScale,
+      policyId: BENCHMARK_POLICY_ID,
+    },
+    scenarios,
+    builds,
+    runs,
+  };
+  const defaultOutput = resolve(projectRoot, "artifacts/combat-benchmarks", timestampDirectory(generatedAt));
+  const output = options.output ? resolve(process.cwd(), options.output) : defaultOutput;
+  mkdirSync(output, { recursive: true });
+  writeFileSync(resolve(output, "matrix.json"), `${JSON.stringify(report, null, 2)}\n`, "utf8");
+  writeFileSync(resolve(output, "matrix.csv"), serializeBenchmarkMatrixCsv(report), "utf8");
+  writeFileSync(resolve(output, "summary.md"), renderBenchmarkMatrixMarkdown(report), "utf8");
+  process.stdout.write(`Wrote ${runs.length} run(s) to ${output}\n`);
+}
+
+main().catch((error: unknown) => {
+  process.stderr.write(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+  process.exitCode = 1;
+});

scripts/dungeon-pipeline/audit-coordinate-alignment.mjs

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { NodeIO } from "@gltf-transform/core";
+import { ALL_EXTENSIONS } from "@gltf-transform/extensions";
+import { BufferAttribute, BufferGeometry, Vector3 } from "three";
+import { MeshBVH } from "three-mesh-bvh";
+import { MeshoptDecoder } from "meshoptimizer";
+
+const projectRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const campaign = await import("../../src/game/generated/dungeonCampaignCatalog.json", {
+  with: { type: "json" },
+}).then((module) => module.default);
+const useCollision = process.argv.includes("--collision");
+const requestedSlugs = new Set(process.argv.slice(2).filter((argument) => argument !== "--collision"));
+const definitions = campaign.definitions.filter((definition) => (
+  !requestedSlugs.size || requestedSlugs.has(definition.id)
+));
+
+if (!definitions.length) {
+  throw new Error("No matching dungeon definitions. Pass one or more dungeon slugs.");
+}
+
+await MeshoptDecoder.ready;
+const io = new NodeIO()
+  .registerExtensions(ALL_EXTENSIONS)
+  .registerDependencies({ "meshopt.decoder": MeshoptDecoder });
+const point = new Vector3();
+
+function normalizerFor(accessor, array) {
+  if (!accessor.getNormalized()) return (value) => value;
+  if (array instanceof Int16Array) return (value) => Math.max(value / 32_767, -1);
+  if (array instanceof Uint16Array) return (value) => value / 65_535;
+  if (array instanceof Int8Array) return (value) => Math.max(value / 127, -1);
+  if (array instanceof Uint8Array) return (value) => value / 255;
+  return (value) => value;
+}
+
+async function geometryTrees(file) {
+  const document = await io.read(file);
+  const trees = [];
+  for (const node of document.getRoot().listNodes()) {
+    const mesh = node.getMesh();
+    if (!mesh) continue;
+    const matrix = node.getWorldMatrix();
+    for (const primitive of mesh.listPrimitives()) {
+      const accessor = primitive.getAttribute("POSITION");
+      const source = accessor?.getArray();
+      if (!accessor || !source) continue;
+      const normalize = normalizerFor(accessor, source);
+      const positions = new Float32Array(source.length);
+      for (let offset = 0; offset < source.length; offset += 3) {
+        const x = normalize(source[offset]);
+        const y = normalize(source[offset + 1]);
+        const z = normalize(source[offset + 2]);
+        positions[offset] = matrix[0] * x + matrix[4] * y + matrix[8] * z + matrix[12];
+        positions[offset + 1] = matrix[1] * x + matrix[5] * y + matrix[9] * z + matrix[13];
+        positions[offset + 2] = matrix[2] * x + matrix[6] * y + matrix[10] * z + matrix[14];
+      }
+      const geometry = new BufferGeometry();
+      geometry.setAttribute("position", new BufferAttribute(positions, 3));
+      const indices = primitive.getIndices()?.getArray();
+      if (indices) geometry.setIndex(new BufferAttribute(indices, 1));
+      trees.push(new MeshBVH(geometry));
+    }
+  }
+  return trees;
+}
+
+function nearestDistance(trees, position) {
+  point.fromArray(position);
+  let distance = Infinity;
+  for (const tree of trees) {
+    const result = tree.closestPointToPoint(point);
+    distance = Math.min(distance, result?.distance ?? Infinity);
+  }
+  return distance;
+}
+
+function percentile(sorted, proportion) {
+  return sorted[Math.min(sorted.length - 1, Math.floor(sorted.length * proportion))] ?? 0;
+}
+
+const results = [];
+for (const definition of definitions) {
+  const geometryUrls = useCollision
+    ? definition.assets.collision.map((chunk) => chunk.url)
+    : [definition.assets.navigation.url];
+  const trees = (await Promise.all(geometryUrls.map((url) => (
+    geometryTrees(path.join(projectRoot, "public", url.replace(/^\//, "")))
+  )))).flat();
+  const samples = [
+    { id: "entrance", position: definition.entrance.footPosition },
+    ...definition.staticSpawns.map((spawn) => ({ id: spawn.id, position: spawn.position })),
+    ...definition.roamingPacks.flatMap((pack) => (
+      pack.waypoints.map((position, index) => ({ id: `${pack.id}:${index}`, position }))
+    )),
+  ];
+  const distances = samples
+    .map((sample) => ({ ...sample, distance: nearestDistance(trees, sample.position) }))
+    .sort((left, right) => left.distance - right.distance);
+  const values = distances.map((sample) => sample.distance);
+  results.push({
+    dungeonId: definition.id,
+    geometry: useCollision ? "collision" : "navigation",
+    coordinateAlignment: definition.provenance.coordinateAlignment,
+    coordinateTransform: definition.provenance.coordinateTransform,
+    samples: values.length,
+    withinOneMeter: values.filter((distance) => distance <= 1).length,
+    medianDistance: percentile(values, 0.5),
+    p90Distance: percentile(values, 0.9),
+    maximumDistance: values.at(-1) ?? 0,
+    furthest: distances.slice(-5).reverse().map(({ id, position, distance }) => ({
+      id,
+      position,
+      distance,
+    })),
+  });
+}
+
+console.log(JSON.stringify(results, null, 2));

scripts/dungeon-pipeline/compile-campaign-catalog.mjs

@@ -175,6 +175,10 @@ function interpolate(left, right, alpha) {
   return left.map((value, axis) => rounded(value + (right[axis] - value) * alpha));
 }
 
+function horizontalDistanceSquared(left, right) {
+  return (left[0] - right[0]) ** 2 + (left[2] - right[2]) ** 2;
+}
+
 function normalizedName(value) {
   return String(value ?? "").toLowerCase().replace(/[^a-z0-9]+/g, "");
 }
@@ -201,7 +205,7 @@ const ADT_SOURCE_BASES = new Set([
   "z-y-negative-x",
 ]);
 const GLOBAL_WMO_SOURCE_BASES = new Set(["draft", "flip-x"]);
-const GLOBAL_WMO_ALIGNMENTS = new Set(["player-anchor", "source"]);
+const COORDINATE_ALIGNMENTS = new Set(["player-anchor", "source", "source-transform"]);
 
 function sourceBasisFor(recipe, environmentMode) {
   if (environmentMode !== "adt-hybrid") {
@@ -222,14 +226,42 @@ function sourceBasisFor(recipe, environmentMode) {
 }
 
 function coordinateAlignmentFor(recipe, environmentMode) {
-  if (environmentMode !== "global-wmo") return "player-anchor";
+  const legacyGlobalWmoAlignment = environmentMode === "global-wmo"
-  const alignment = recipe.globalWmoAlignment ?? "player-anchor";
+    ? recipe.globalWmoAlignment
-  if (!GLOBAL_WMO_ALIGNMENTS.has(alignment)) {
+    : undefined;
-    throw new Error(`${recipe.slug}: unsupported global WMO alignment ${alignment}.`);
+  if (
+    recipe.coordinateAlignment
+    && legacyGlobalWmoAlignment
+    && recipe.coordinateAlignment !== legacyGlobalWmoAlignment
+  ) {
+    throw new Error(`${recipe.slug}: coordinate alignment overrides disagree.`);
+  }
+  const alignment = recipe.coordinateAlignment ?? legacyGlobalWmoAlignment ?? "player-anchor";
+  if (!COORDINATE_ALIGNMENTS.has(alignment)) {
+    throw new Error(`${recipe.slug}: unsupported coordinate alignment ${alignment}.`);
   }
   return alignment;
 }
 
+function sourceTransformFor(recipe, alignment) {
+  const transform = recipe.coordinateTransform;
+  if (alignment !== "source-transform") {
+    if (transform) {
+      throw new Error(`${recipe.slug}: coordinateTransform requires source-transform alignment.`);
+    }
+    return undefined;
+  }
+  if (!transform || !Array.isArray(transform.origin) || transform.origin.length !== 3) {
+    throw new Error(`${recipe.slug}: source-transform alignment requires a three-value coordinateTransform.origin.`);
+  }
+  const origin = transform.origin.map(Number);
+  const yawDegrees = Number(transform.yawDegrees ?? 0);
+  if (!origin.every(Number.isFinite) || !Number.isFinite(yawDegrees)) {
+    throw new Error(`${recipe.slug}: coordinateTransform values must be finite numbers.`);
+  }
+  return { origin, yawDegrees };
+}
+
 /**
  * Runtime drafts retain the original pipeline convention. wow.export ADT
  * packages have an additional horizontal basis change baked into their GLBs.
@@ -248,10 +280,39 @@ function sourceToPackageBasis(position, environmentMode, sourceBasis) {
     : point;
 }
 
-function coordinateMapper(draft, environmentMode, playerAnchor, sourceBasis, alignment) {
+function rotateAroundY(position, yawDegrees) {
+  const radians = yawDegrees * Math.PI / 180;
+  const cosine = Math.cos(radians);
+  const sine = Math.sin(radians);
+  return vector([
+    position[0] * cosine - position[2] * sine,
+    position[1],
+    position[0] * sine + position[2] * cosine,
+  ]);
+}
+
+function coordinateMapper(
+  draft,
+  environmentMode,
+  playerAnchor,
+  sourceBasis,
+  alignment,
+  sourceTransform,
+) {
   if (alignment === "source") {
     return (position) => sourceToPackageBasis(position, environmentMode, sourceBasis);
   }
+  if (alignment === "source-transform") {
+    const basisOrigin = sourceToPackageBasis(
+      sourceTransform.origin,
+      environmentMode,
+      sourceBasis,
+    );
+    return (position) => rotateAroundY(
+      subtract(sourceToPackageBasis(position, environmentMode, sourceBasis), basisOrigin),
+      sourceTransform.yawDegrees,
+    );
+  }
   const sourceEntrance = draft?.entrance
     ?? draft?.spawns?.[0]?.position
     ?? playerAnchor.position;
@@ -778,6 +839,7 @@ async function compile() {
     const environmentMode = inferEnvironmentMode(recipe, assetPackage);
     const sourceBasis = sourceBasisFor(recipe, environmentMode);
     const coordinateAlignment = coordinateAlignmentFor(recipe, environmentMode);
+    const sourceTransform = sourceTransformFor(recipe, coordinateAlignment);
     const playerAnchor = assetPackage.anchors.find((anchor) => anchor.kind === "player");
     const trashAnchor = assetPackage.anchors.find((anchor) => anchor.kind === "trash");
     const bossAnchor = assetPackage.anchors.find((anchor) => anchor.kind === "boss");
@@ -788,7 +850,7 @@ async function compile() {
       trashAnchor.position[0] - playerAnchor.position[0],
       trashAnchor.position[2] - playerAnchor.position[2],
     );
-    const entranceYaw = Number.isFinite(playerAnchor.yaw)
+    let entranceYaw = Number.isFinite(playerAnchor.yaw)
       ? playerAnchor.yaw
       : inferredEntranceYaw;
 
@@ -809,6 +871,7 @@ async function compile() {
       playerAnchor,
       sourceBasis,
       coordinateAlignment,
+      sourceTransform,
     );
     const entrancePosition = mapPosition(
       draft?.entrance
@@ -896,16 +959,49 @@ async function compile() {
       const entry = Number(spawn.entityId.replace("entry-", ""));
       if (!bossCandidatesByEntry.has(entry)) bossCandidatesByEntry.set(entry, spawn);
     }
+    const mappedNativeRoutePositions = coordinateAlignment !== "player-anchor"
+      ? (draft?.spawns ?? [])
+        .map((spawn) => mapPosition(spawn.position))
+        .filter((position) => position.every(Number.isFinite))
+        .sort((left, right) => (
+          horizontalDistanceSquared(left, entrancePosition)
+          - horizontalDistanceSquared(right, entrancePosition)
+        ))
+      : [];
+    const entranceDirectionTarget = mappedNativeRoutePositions.find((position) => (
+      Math.abs(position[1] - entrancePosition[1]) <= 3
+      && horizontalDistanceSquared(position, entrancePosition) >= 16
+    ));
+    if (entranceDirectionTarget) {
+      entranceYaw = Math.atan2(
+        entranceDirectionTarget[0] - entrancePosition[0],
+        entranceDirectionTarget[2] - entrancePosition[2],
+      );
+    }
+    const entranceLevelRoutePositions = mappedNativeRoutePositions.filter(
+      (position) => Math.abs(position[1] - entrancePosition[1]) <= 2.5,
+    );
+    const nativeRoutePositions = (
+      bossCandidatesByEntry.size === 0
+      && entranceLevelRoutePositions.length >= encounters.length
+    )
+      ? entranceLevelRoutePositions
+      : mappedNativeRoutePositions;
     const usedBossSpawnIds = new Set();
     const bossObjectives = encounters.map((encounter, index) => {
       const candidate = bossCandidatesByEntry.get(Number(encounter.creatureId));
       const alpha = encounters.length <= 1 ? 1 : index / (encounters.length - 1);
-      const routePosition = interpolate(trashAnchor.position, bossAnchor.position, 0.18 + alpha * 0.82);
+      const routeAlpha = 0.18 + alpha * 0.82;
+      const nativeRoutePosition = nativeRoutePositions.length
+        ? nativeRoutePositions[Math.round(routeAlpha * (nativeRoutePositions.length - 1))]
+        : undefined;
+      const routePosition = nativeRoutePosition
+        ?? interpolate(trashAnchor.position, bossAnchor.position, routeAlpha);
       const position = encounter.eventOnly
         ? [-151.27, -102.82, 252.26]
         : candidate
           ? mapPosition(candidate.position)
-          : offsetPosition(routePosition, index % 5, 2.4);
+          : nativeRoutePosition ?? offsetPosition(routePosition, index % 5, 2.4);
       const id = encounter.eventOnly
         ? "mutanus-spawn"
         : candidate?.id ?? `encounter-${encounter.encounterId}`;
@@ -1000,8 +1096,9 @@ async function compile() {
 
     const allPoints = [
       entrancePosition,
-      trashAnchor.position,
+      ...(coordinateAlignment === "player-anchor" || syntheticTrash
-      bossAnchor.position,
+        ? [trashAnchor.position, bossAnchor.position]
+        : []),
       ...staticSpawns.map((spawn) => spawn.position),
       ...roamingPacks.flatMap((pack) => pack.waypoints),
     ];
@@ -1032,6 +1129,8 @@ async function compile() {
         ? ["Trash identities and placements are procedural; boss identities come from the installed Ascension encounter catalog."]
         : coordinateAlignment === "source"
           ? [`Server positions use the packaged ${environmentMode} environment's native world coordinates.`]
+          : coordinateAlignment === "source-transform"
+            ? [`Server positions use the packaged ${environmentMode} environment's authoritative WDT placement transform.`]
           : [`Server positions were aligned to the packaged ${environmentMode} environment at its reviewed player anchor.`]),
     ];
 
@@ -1078,6 +1177,7 @@ async function compile() {
       serverGameObjects: draft?.gameObjects ?? [],
       provenance: {
         clientBuild: recipe.clientBuild,
+        coordinateAlignment,
         clientArchiveHashes: assetPackage.source.checksums ?? {},
         databaseAdapter: databaseKind,
         databaseRevision: draft?.spawns?.length
@@ -1090,6 +1190,8 @@ async function compile() {
           ? sourceBasis === "z-y-negative-x"
             ? "three(x,y,z)=(wow.y,wow.z,wow.x)"
             : "three(x,y,z)=(-wow.y,wow.z,wow.x)"
+          : coordinateAlignment === "source-transform"
+            ? `three(x,y,z)=rotate-y(${sourceBasis === "flip-x" ? "(-draft.x,draft.y,draft.z)" : "draft(x,y,z)"}-[${sourceTransform.origin.join(",")}],${sourceTransform.yawDegrees}deg)`
           : coordinateAlignment === "source"
             ? sourceBasis === "flip-x"
               ? "three(x,y,z)=(-draft.x,draft.y,draft.z)"

scripts/generate-catalog-shards.ts

@@ -0,0 +1,106 @@
+import {
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  unlinkSync,
+  writeFileSync,
+} from "node:fs";
+import { basename, resolve } from "node:path";
+import {
+  CLASSES,
+  COA_CLASS_IDS,
+  type ClassId,
+  type CoaClassId,
+} from "../src/app/characterCatalog";
+import { TALENT_NODES, TALENT_TREES } from "../src/game/talentCatalog";
+
+const projectRoot = resolve(import.meta.dirname, "..");
+const talentOutputDirectory = resolve(projectRoot, "src/game/generated/talentUi");
+const coaAbilityOutputDirectory = resolve(projectRoot, "src/game/generated/coaAbilities");
+
+function writeJson(file: string, value: unknown): void {
+  writeFileSync(file, `${JSON.stringify(value)}\n`, "utf8");
+  console.log(`Wrote ${file}`);
+}
+
+function removeStaleJson(directory: string, expectedNames: ReadonlySet<string>): void {
+  for (const name of readdirSync(directory)) {
+    if (!name.endsWith(".json") || expectedNames.has(name)) continue;
+    unlinkSync(resolve(directory, name));
+  }
+}
+
+mkdirSync(talentOutputDirectory, { recursive: true });
+const talentClassIds = new Set<ClassId>(TALENT_TREES.map((tree) => tree.classId));
+const talentFileNames = new Set([...talentClassIds].map((classId) => `${classId}.json`));
+removeStaleJson(talentOutputDirectory, talentFileNames);
+
+for (const classId of talentClassIds) {
+  const trees = TALENT_TREES.filter((tree) => tree.classId === classId).map((tree) => ({
+    id: tree.id,
+    classId: tree.classId,
+    name: tree.name,
+    icon: tree.icon,
+    background: tree.background,
+    description: tree.description,
+    system: tree.system,
+  }));
+  const treeIds = new Set(trees.map((tree) => tree.id));
+  const nodes = TALENT_NODES.filter((node) => treeIds.has(node.treeId)).map((node) => ({
+    id: node.id,
+    treeId: node.treeId,
+    index: node.index,
+    prerequisiteId: node.prerequisiteId,
+    prerequisiteRank: node.prerequisiteRank,
+    prerequisites: node.prerequisites,
+    column: node.column,
+    row: node.row,
+    icon: node.icon,
+    maxRank: node.maxRank,
+    name: node.name,
+    description: node.description,
+    rankDescriptions: node.rankDescriptions,
+    system: node.system,
+    entryType: node.entryType,
+    abilityEssenceCost: node.abilityEssenceCost,
+    talentEssenceCost: node.talentEssenceCost,
+    requiredClassPoints: node.requiredClassPoints,
+    requiredSpecPoints: node.requiredSpecPoints,
+    requiredLevel: node.requiredLevel,
+    isPassive: node.isPassive,
+  }));
+  writeJson(resolve(talentOutputDirectory, `${classId}.json`), {
+    schemaVersion: 1,
+    classId,
+    trees,
+    nodes,
+  });
+}
+
+interface CoaAbilitySnapshot {
+  readonly schemaVersion: 1;
+  readonly abilitiesByClass: Readonly<Record<CoaClassId, readonly unknown[]>>;
+  readonly resourcesByClass: Readonly<Record<CoaClassId, unknown>>;
+  readonly triggeredAbilitiesBySpellId: Readonly<Record<string, { readonly classId?: ClassId }>>;
+}
+
+const coaAbilityInput = resolve(projectRoot, "src/game/generated/coaAbilityRuntimeCatalog.json");
+const coaSnapshot = JSON.parse(readFileSync(coaAbilityInput, "utf8")) as CoaAbilitySnapshot;
+mkdirSync(coaAbilityOutputDirectory, { recursive: true });
+const coaAbilityFileNames = new Set(COA_CLASS_IDS.map((classId) => `${classId}.json`));
+removeStaleJson(coaAbilityOutputDirectory, coaAbilityFileNames);
+
+for (const classId of COA_CLASS_IDS) {
+  const triggeredAbilitiesBySpellId = Object.fromEntries(Object.entries(
+    coaSnapshot.triggeredAbilitiesBySpellId,
+  ).filter(([, ability]) => ability.classId === classId));
+  writeJson(resolve(coaAbilityOutputDirectory, `${classId}.json`), {
+    schemaVersion: 1,
+    classId,
+    abilities: coaSnapshot.abilitiesByClass[classId] ?? [],
+    resource: coaSnapshot.resourcesByClass[classId],
+    triggeredAbilitiesBySpellId,
+  });
+}
+
+console.log(`Generated ${talentFileNames.size} talent UI shards and ${coaAbilityFileNames.size} Conquest ability shards from ${basename(coaAbilityInput)}.`);

scripts/manastorm-pipeline/cli.mjs

@@ -404,15 +404,23 @@ async function optimizeStage(slug) {
       const source = path.join(staging, entry.path);
       const outputName = optimizedChunkName(role, index, entries.length);
       const output = path.join(staging, outputName);
-      await run(process.execPath, [
-        cli,
-        "meshopt",
-        source,
-        output,
-        "--level",
-        "high",
-      ]);
       if (role === "visual") {
+        await run(process.execPath, [
+          cli,
+          "optimize",
+          source,
+          output,
+          "--compress",
+          "meshopt",
+          "--meshopt-level",
+          "high",
+          "--instance",
+          "true",
+          "--instance-min",
+          "3",
+          "--texture-size",
+          "2048",
+        ]);
         await run(process.execPath, [
           path.join(projectRoot, "scripts/asset-pipeline/compress-ktx2.mjs"),
           output,
@@ -421,6 +429,15 @@ async function optimizeStage(slug) {
           "--jobs",
           "2",
         ]);
+      } else {
+        await run(process.execPath, [
+          cli,
+          "meshopt",
+          source,
+          output,
+          "--level",
+          "high",
+        ]);
       }
       const geometry = await inspectGlb(output);
       const descriptor = {

src/App.tsx

@@ -1,5 +1,7 @@
-import { lazy, Suspense, useEffect } from "react";
+import { lazy, Suspense, useEffect, useMemo, useState, type ReactNode } from "react";
+import { BASE_CLASS_IDS, classById } from "./app/characterCatalog";
 import { useShellStore } from "./app/shellStore";
+import { preloadAbilityCatalogsForClasses } from "./game/abilityCatalog";
 import { useManastormAdminStore } from "./game/manastormAdminStore";
 import { useAuthoritativeDualScreenSync, useForcedThorDisplays } from "./platform/useThorDualScreen";
 import { LoginScreen } from "./ui/LoginScreen";
@@ -18,6 +20,39 @@ function ShellTransition() {
   return <div className="world-transition"><span>HM</span><strong>Opening expedition</strong><small>Preparing the next screen...</small></div>;
 }
 
+function RuntimeCatalogGate({ children }: { readonly children: ReactNode }) {
+  const character = useShellStore((state) => (
+    state.characters.find((candidate) => candidate.id === state.selectedCharacterId) ?? null
+  ));
+  const classIds = useMemo(() => {
+    if (!character) return [];
+    const definition = classById(character.classId);
+    if (definition.mode === "conquest") return [...BASE_CLASS_IDS, character.classId];
+    return [character.classId, ...(character.secondaryClassId ? [character.secondaryClassId] : [])];
+  }, [character]);
+  const requestKey = classIds.join(":");
+  const [loadedKey, setLoadedKey] = useState("");
+  const [failedKey, setFailedKey] = useState("");
+
+  useEffect(() => {
+    if (!requestKey) return;
+    let active = true;
+    setFailedKey("");
+    void preloadAbilityCatalogsForClasses(classIds).then(() => {
+      if (active) setLoadedKey(requestKey);
+    }).catch(() => {
+      if (active) setFailedKey(requestKey);
+    });
+    return () => { active = false; };
+  }, [classIds, requestKey]);
+
+  if (!requestKey || loadedKey === requestKey) return children;
+  if (failedKey === requestKey) {
+    return <div className="world-transition"><span>!</span><strong>Catalog unavailable</strong><small>Reload the app to retry loading combat data.</small></div>;
+  }
+  return <ShellTransition />;
+}
+
 export default function App() {
   useForcedThorDisplays();
   useAuthoritativeDualScreenSync();
@@ -39,5 +74,6 @@ export default function App() {
   else if (phase === "manastorms") screen = <Suspense fallback={<ShellTransition />}><ManastormSelectScreen /></Suspense>;
   else if (phase === "gm-admin") screen = <Suspense fallback={<ShellTransition />}><GmAdminScreen /></Suspense>;
   else if (phase === "game") screen = <Suspense fallback={<ShellTransition />}><GameRuntime /></Suspense>;
-  return <><OnlineGroupCoordinator />{screen}</>;
+  const requiresRuntimeCatalog = !["login", "characters", "create-character"].includes(phase);
+  return <><OnlineGroupCoordinator />{requiresRuntimeCatalog ? <RuntimeCatalogGate>{screen}</RuntimeCatalogGate> : screen}</>;
 }

src/avatar/CharacterModel.tsx

@@ -61,10 +61,13 @@ import {
 import {
   EquipmentAttachments,
   equipmentAttachmentHand,
+  resolveEquipmentAttachmentTransforms,
 } from "./equipmentAttachments";
 import {
   ApproximateStarterEquipment,
   StarterWeaponAttachments,
+  characterWeaponStance,
+  estimateAvatarWeaponScale,
   type AvatarHand,
 } from "./starterWeapons";
 
@@ -192,6 +195,14 @@ function LoadedCharacterModel({
 }) {
   const gltf = useGLTF(resolveContentUrl(entry.model));
   const scene = useMemo(() => cloneAvatarScene(gltf.scene), [gltf.scene]);
+  const equipmentAttachmentTransforms = useMemo(
+    () => resolveEquipmentAttachmentTransforms(scene, entry),
+    [entry, scene],
+  );
+  const fallbackEquipmentScale = useMemo(
+    () => estimateAvatarWeaponScale(scene),
+    [scene],
+  );
   const mixer = useMemo(() => new AnimationMixer(scene), [scene]);
   const currentAction = useRef<AnimationAction | null>(null);
   const overrideAction = useRef<AnimationAction | null>(null);
@@ -199,7 +210,6 @@ function LoadedCharacterModel({
   const overrideLooping = useRef(false);
   const currentMotion = useRef<CharacterLocomotionMotion | null>(null);
   const observedAttackPulse = useRef(attackPulseRef?.current ?? 0);
-  const equipmentAttackPulseRef = useRef(attackPulseRef?.current ?? 0);
   const observedAnimationRevision = useRef(animationEventRef?.current?.revision ?? 0);
   const attackElapsed = useRef(ATTACK_PRESENTATION_DURATION_SECONDS);
   const attackJoint = useMemo(
@@ -233,6 +243,15 @@ function LoadedCharacterModel({
     }))] as AvatarHand[],
     [resolved.equipmentModels],
   );
+  const weaponStance = useMemo(() => characterWeaponStance(
+    identity.classId,
+    equipment,
+    resolved.equipmentModels.flatMap((itemModel) => (
+      itemModel.attachment === "handLeft" || itemModel.attachment === "handRight"
+        ? [itemModel.itemId]
+        : []
+    )),
+  ), [equipment, identity.classId, resolved.equipmentModels]);
 
   useEffect(() => {
     let cancelled = false;
@@ -339,7 +358,7 @@ function LoadedCharacterModel({
   };
 
   const selectClip = (motion: CharacterBaseMotion): AnimationClip | undefined => (
-    selectCharacterBaseClip(gltf.animations, motion)
+    selectCharacterBaseClip(gltf.animations, motion, weaponStance)
       ?? namedClip(entry.animations[motion])
       ?? namedClip(entry.animations.idle)
       ?? gltf.animations[0]
@@ -347,7 +366,6 @@ function LoadedCharacterModel({
 
   const switchMotion = (motion: CharacterLocomotionMotion, moving: boolean) => {
     if (overrideAction.current) return;
-    if (currentMotion.current === motion) return;
     const verticalSelection = motion === "rising" || motion === "falling" || motion === "landing"
       ? selectCharacterVerticalClip(gltf.animations, motion, moving)
       : null;
@@ -356,6 +374,7 @@ function LoadedCharacterModel({
       motion === "idle" || motion === "walk" || motion === "run" ? motion : fallbackMotion,
     );
     if (!clip) return;
+    if (currentMotion.current === motion && currentAction.current?.getClip() === clip) return;
     const loop = verticalSelection?.loop ?? true;
     const next = mixer.clipAction(clip, scene);
     next.enabled = true;
@@ -462,15 +481,11 @@ function LoadedCharacterModel({
     if (nextAnimationEvent && nextAnimationEvent.revision !== observedAnimationRevision.current) {
       observedAnimationRevision.current = nextAnimationEvent.revision;
       playAnimationEvent(nextAnimationEvent);
-      if (nextAnimationEvent.kind === "attack" || nextAnimationEvent.kind === "ability-release") {
-        equipmentAttackPulseRef.current = nextAnimationEvent.revision;
-      }
     }
     const nextAttackPulse = attackPulseRef?.current ?? 0;
     if (nextAttackPulse !== observedAttackPulse.current) {
       observedAttackPulse.current = nextAttackPulse;
       if (nextAttackPulse > 0) {
-        equipmentAttackPulseRef.current = nextAttackPulse;
         playAnimationEvent({ revision: nextAttackPulse, kind: "attack" });
       }
     }
@@ -513,17 +528,16 @@ function LoadedCharacterModel({
         />
       </group>
       <StarterWeaponAttachments
-        attackPulseRef={equipmentAttackPulseRef}
         classId={identity.classId}
+        entry={entry}
         occupiedHands={occupiedEquipmentHands}
         root={scene}
       />
       <EquipmentAttachments
-        attackPulseRef={equipmentAttackPulseRef}
-        classId={identity.classId}
         entry={entry}
+        fallbackScale={fallbackEquipmentScale}
         models={resolved.equipmentModels}
-        root={scene}
+        transforms={equipmentAttachmentTransforms}
       />
     </>
   );

src/avatar/attachmentPoints.test.ts

@@ -0,0 +1,111 @@
+import {
+  Bone,
+  BufferGeometry,
+  Group,
+  MeshBasicMaterial,
+  Skeleton,
+  SkinnedMesh,
+  Vector3,
+} from "three";
+import { describe, expect, it } from "vitest";
+import {
+  findAvatarSkinBone,
+  resolveAvatarAttachmentPoint,
+} from "./attachmentPoints";
+
+const expectVectorClose = (actual: Vector3, expected: Vector3): void => {
+  expect(actual.x).toBeCloseTo(expected.x, 6);
+  expect(actual.y).toBeCloseTo(expected.y, 6);
+  expect(actual.z).toBeCloseTo(expected.z, 6);
+};
+
+function attachmentRig() {
+  const world = new Group();
+  world.position.set(4, -2, 7);
+  world.rotation.set(0.2, -0.35, 0.1);
+  world.scale.setScalar(1.7);
+
+  const root = new Group();
+  root.position.set(-1, 3, 2);
+  root.rotation.set(-0.1, 0.25, -0.15);
+  root.scale.setScalar(0.8);
+  world.add(root);
+
+  const internalRig = new Group();
+  internalRig.scale.setScalar(0.1);
+  root.add(internalRig);
+  const unusedBone = new Bone();
+  const attachmentBone = new Bone();
+  attachmentBone.position.set(2, 4, -3);
+  internalRig.add(unusedBone, attachmentBone);
+
+  const mesh = new SkinnedMesh(new BufferGeometry(), new MeshBasicMaterial());
+  mesh.bind(new Skeleton([unusedBone, attachmentBone]));
+  root.add(mesh);
+
+  return { attachmentBone, root, world };
+}
+
+describe("avatar attachment-point transforms", () => {
+  it("converts manifest positions into the selected skin bone", () => {
+    const { attachmentBone, root, world } = attachmentRig();
+    const point = { bone: 1, position: [0.45, 0.9, -0.2] as const };
+
+    const transform = resolveAvatarAttachmentPoint(root, point, null);
+    expect(transform?.target).toBe(attachmentBone);
+    expect(findAvatarSkinBone(root, 1)).toBe(attachmentBone);
+
+    world.updateWorldMatrix(true, true);
+    const expectedWorldPosition = root.localToWorld(new Vector3(...point.position));
+    const actualWorldPosition = attachmentBone.localToWorld(transform!.position.clone());
+    expectVectorClose(actualWorldPosition, expectedWorldPosition);
+  });
+
+  it("cancels internal locator scale without cancelling the avatar scale", () => {
+    const { attachmentBone, root, world } = attachmentRig();
+    const transform = resolveAvatarAttachmentPoint(root, undefined, attachmentBone)!;
+    const portalChild = new Group();
+    portalChild.scale.copy(transform.scale);
+    attachmentBone.add(portalChild);
+
+    world.updateWorldMatrix(true, true);
+    expectVectorClose(
+      portalChild.getWorldScale(new Vector3()),
+      root.getWorldScale(new Vector3()),
+    );
+  });
+
+  it("keeps authored hand joints at local zero after the skeleton animates", () => {
+    const { attachmentBone, root } = attachmentRig();
+    attachmentBone.position.set(-6, 8, 4);
+    attachmentBone.rotation.set(0.7, -0.4, 0.2);
+
+    const transform = resolveAvatarAttachmentPoint(
+      root,
+      { bone: 1, position: [0.45, 0.9, -0.2] },
+      null,
+      { useTargetOrigin: true },
+    );
+
+    expect(transform?.target).toBe(attachmentBone);
+    expect(transform?.position.toArray()).toEqual([0, 0, 0]);
+  });
+
+  it("falls back safely when a manifest joint is unavailable", () => {
+    const { root } = attachmentRig();
+    const fallback = new Group();
+    root.add(fallback);
+
+    const withMissingJoint = resolveAvatarAttachmentPoint(
+      root,
+      { bone: 99, position: [0.1, 0.2, 0.3] },
+      fallback,
+    );
+    expect(withMissingJoint?.target).toBe(fallback);
+
+    const withoutMetadata = resolveAvatarAttachmentPoint(root, undefined, fallback);
+    expect(withoutMetadata?.target).toBe(fallback);
+    expect(withoutMetadata?.position.toArray()).toEqual([0, 0, 0]);
+    expect(resolveAvatarAttachmentPoint(root, undefined, null)).toBeNull();
+  });
+});

src/avatar/attachmentPoints.ts

@@ -0,0 +1,63 @@
+import { SkinnedMesh, Vector3, type Object3D } from "three";
+import type { AvatarAttachmentPoint } from "./characterManifest";
+
+export interface AvatarAttachmentTransform {
+  readonly target: Object3D;
+  readonly position: Vector3;
+  readonly scale: Vector3;
+}
+
+export interface AvatarAttachmentOptions {
+  /** The manifest point is the authored origin of its referenced attachment joint. */
+  readonly useTargetOrigin?: boolean;
+}
+
+const safeScaleRatio = (rootScale: number, targetScale: number): number => (
+  Number.isFinite(rootScale)
+  && Number.isFinite(targetScale)
+  && Math.abs(targetScale) > 1e-6
+    ? rootScale / targetScale
+    : 1
+);
+
+function attachmentScale(root: Object3D, target: Object3D): Vector3 {
+  const rootScale = root.getWorldScale(new Vector3());
+  const targetScale = target.getWorldScale(new Vector3());
+  return new Vector3(
+    safeScaleRatio(rootScale.x, targetScale.x),
+    safeScaleRatio(rootScale.y, targetScale.y),
+    safeScaleRatio(rootScale.z, targetScale.z),
+  );
+}
+
+export function findAvatarSkinBone(root: Object3D, boneIndex: number): Object3D | null {
+  let bone: Object3D | null = null;
+  root.traverse((node) => {
+    if (bone) return;
+    const skinnedMesh = node as SkinnedMesh;
+    if (!skinnedMesh.isSkinnedMesh) return;
+    bone = skinnedMesh.skeleton.bones[boneIndex] ?? null;
+  });
+  return bone;
+}
+
+/** Converts a manifest point from avatar-local space into its target bone. */
+export function resolveAvatarAttachmentPoint(
+  root: Object3D,
+  point: AvatarAttachmentPoint | undefined,
+  fallbackTarget: Object3D | null,
+  options: AvatarAttachmentOptions = {},
+): AvatarAttachmentTransform | null {
+  const skinBone = point ? findAvatarSkinBone(root, point.bone) : null;
+  const target = skinBone ?? fallbackTarget;
+  if (!target) return null;
+  root.updateWorldMatrix(true, true);
+  const scale = attachmentScale(root, target);
+  if (!point || (skinBone && options.useTargetOrigin)) {
+    return { target, position: new Vector3(), scale };
+  }
+
+  const position = root.localToWorld(new Vector3(...point.position));
+  target.worldToLocal(position);
+  return { target, position, scale };
+}