Files
healer-man/dungeon-pipeline/FIVE_PLAYER_IMPORT_TODO.md
T
2026-08-14 15:56:39 -04:00

119 lines
4.4 KiB
Markdown

# Five-player dungeon import checklist
Each dungeon is complete only when its actual instance environment, collision,
navigation, AzerothCore population, boss roster, and native animated creature
models are packaged under `public/assets/game/dungeons/<slug>/`.
Run one dungeon at a time:
```powershell
npm run dungeon:five-player:import -- <slug> --refresh
npm run dungeon:catalog
npm run dungeon:five-player:verify
npm test
```
To run that command separately for every unchecked dungeon and record each
result, use `npm run dungeon:five-player:import:remaining`. Progress and exact
blockers are written to `FIVE_PLAYER_IMPORT_RUN_REPORT.md`.
Verified 2026-07-26: 51/54 dungeons are authoritative. The native registry has
50 packaged imports, Wailing Caverns remains the authored golden fixture, all
2,007 unique native assets passed checksum/size validation, all 1,251 packaged
creature-entry mappings resolved to animated models, 496 tests passed, and the
TypeScript/production bundle checks passed.
## Baseline
- [x] Wailing Caverns (`43`) - native golden fixture; keep as the reference.
## Classic
- [x] Shadowfang Keep (`33`) - native environment and 31/31 combat models packaged.
- [x] The Stockade (`34`)
- [x] The Deadmines (`36`)
- [x] Razorfen Kraul (`47`)
- [x] Blackfathom Deeps (`48`)
- [x] Uldaman (`70`)
- [x] Gnomeregan (`90`)
- [x] The Temple of Atal'Hakkar / Sunken Temple (`109`)
- [x] Razorfen Downs (`129`)
- [x] Scarlet Monastery (`189`)
- [x] Zul'Farrak (`209`)
- [x] Blackrock Spire (`229`)
- [x] Blackrock Depths (`230`)
- [x] Scholomance (`289`)
- [x] Stratholme (`329`)
- [x] Maraudon (`349`)
- [x] Ragefire Chasm (`389`)
- [x] Dire Maul (`429`)
## Burning Crusade
- [x] The Shattered Halls (`540`)
- [x] The Blood Furnace (`542`)
- [x] Hellfire Ramparts (`543`)
- [x] The Steamvault (`545`)
- [x] The Underbog (`546`)
- [x] The Slave Pens (`547`)
- [x] The Arcatraz (`552`)
- [x] The Botanica (`553`)
- [x] The Mechanar (`554`)
- [x] Shadow Labyrinth (`555`)
- [x] Sethekk Halls (`556`)
- [x] Mana-Tombs (`557`)
- [x] Auchenai Crypts (`558`)
- [x] Magisters' Terrace (`585`)
## Caverns of Time and Wrath
- [x] The Black Morass (`269`)
- [x] The Escape From Durnholde (`560`)
- [x] Utgarde Keep (`574`)
- [x] Utgarde Pinnacle (`575`)
- [x] The Nexus (`576`)
- [x] The Oculus (`578`)
- [x] The Culling of Stratholme (`595`)
- [x] Halls of Stone (`599`)
- [x] Drak'Tharon Keep (`600`)
- [x] Azjol-Nerub (`601`)
- [x] Halls of Lightning (`602`)
- [x] Gundrak (`604`)
- [x] The Violet Hold (`608`)
- [x] Ahn'kahet: The Old Kingdom (`619`)
- [x] The Forge of Souls (`632`)
- [x] Trial of the Champion (`650`)
- [x] Pit of Saron (`658`)
- [x] Halls of Reflection (`668`)
## Ascension-specific five-player instances
- [ ] Tinkertech Showdown (`821`) - blocked on authoritative Ascension server
population/model data. Encounter identity exists for Mechatron (`663012`),
but no creature template, display mapping, or spawn rows exist locally.
- [ ] Frozen Reach (`908`) - blocked on authoritative Ascension server
population/model data. Encounter identity exists for Alva (`97700`), but no
creature template, display mapping, or spawn rows exist locally.
- [ ] Forgotten Mine (`1781`) - blocked on authoritative Ascension server
population/model data. Encounter identity exists for Geolord Vek (`254272`),
but no creature template, display mapping, or spawn rows exist locally.
The individual command has been run for all three blocked instances. Their maps
and encounter identities are present in the installed client, but the installed
client and available creature caches do not provide the server-only
entry-to-display and spawn data needed to package their actual mobs/bosses.
They intentionally remain on the documented procedural fallback until an
Ascension server snapshot or reviewed creature/spawn export is supplied.
## Per-dungeon completion gate
These gates passed for every checked dungeon above:
- [x] Correct five-player `Map.dbc`/LFG identity and recipe.
- [x] Instance visual, collision, and navigation GLBs packaged outside Manastorm.
- [x] Stock/custom instance population imported with ambient/event-only actors excluded.
- [x] Every required mob and boss has a native animated model.
- [x] Boss order, entrance, and coordinates reviewed.
- [x] Generated campaign catalog points at `/assets/game/dungeons/<slug>/`.
- [x] Catalog verification, tests, type-check, and production bundle pass.