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

4.4 KiB

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:

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

  • Wailing Caverns (43) - native golden fixture; keep as the reference.

Classic

  • Shadowfang Keep (33) - native environment and 31/31 combat models packaged.
  • The Stockade (34)
  • The Deadmines (36)
  • Razorfen Kraul (47)
  • Blackfathom Deeps (48)
  • Uldaman (70)
  • Gnomeregan (90)
  • The Temple of Atal'Hakkar / Sunken Temple (109)
  • Razorfen Downs (129)
  • Scarlet Monastery (189)
  • Zul'Farrak (209)
  • Blackrock Spire (229)
  • Blackrock Depths (230)
  • Scholomance (289)
  • Stratholme (329)
  • Maraudon (349)
  • Ragefire Chasm (389)
  • Dire Maul (429)

Burning Crusade

  • The Shattered Halls (540)
  • The Blood Furnace (542)
  • Hellfire Ramparts (543)
  • The Steamvault (545)
  • The Underbog (546)
  • The Slave Pens (547)
  • The Arcatraz (552)
  • The Botanica (553)
  • The Mechanar (554)
  • Shadow Labyrinth (555)
  • Sethekk Halls (556)
  • Mana-Tombs (557)
  • Auchenai Crypts (558)
  • Magisters' Terrace (585)

Caverns of Time and Wrath

  • The Black Morass (269)
  • The Escape From Durnholde (560)
  • Utgarde Keep (574)
  • Utgarde Pinnacle (575)
  • The Nexus (576)
  • The Oculus (578)
  • The Culling of Stratholme (595)
  • Halls of Stone (599)
  • Drak'Tharon Keep (600)
  • Azjol-Nerub (601)
  • Halls of Lightning (602)
  • Gundrak (604)
  • The Violet Hold (608)
  • Ahn'kahet: The Old Kingdom (619)
  • The Forge of Souls (632)
  • Trial of the Champion (650)
  • Pit of Saron (658)
  • 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:

  • Correct five-player Map.dbc/LFG identity and recipe.
  • Instance visual, collision, and navigation GLBs packaged outside Manastorm.
  • Stock/custom instance population imported with ambient/event-only actors excluded.
  • Every required mob and boss has a native animated model.
  • Boss order, entrance, and coordinates reviewed.
  • Generated campaign catalog points at /assets/game/dungeons/<slug>/.
  • Catalog verification, tests, type-check, and production bundle pass.