Files
healer-man/dungeon-pipeline/FIVE_PLAYER_IMPORT_TODO.md
T
2026-09-09 11:21:33 -04:00

5.3 KiB

Five-player dungeon import checklist

This checklist tracks the native asset and population import, not complete instance gameplay. A checked dungeon has its environment, collision, navigation, AzerothCore population, boss roster, and native animated creature models packaged under public/assets/game/dungeons/<slug>/. Use WOW_DUNGEON_FUNCTIONALITY_REPORT.md for the separate production-fidelity gate covering doors, objects, scripted progression, waves, escorts, vehicles, traversal, resets, checkpoints, and completion playtests.

Instance-source review status (2026-09-08): 54/54 reviewed, 51/54 backed by an executable instance controller, and 3/54 pinned as source-exact no-op instance scripts. These counts describe implemented runtime coverage; they do not close the native game-object export or end-to-end playtest gates.

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) - playable HealerMan-authored adaptation. Mechatron (663012) and the environment are exact; the candidate machine spell cluster, trash, cadence, positions, models, and phase rules remain explicitly authored because no server binding or spawn snapshot survived.
  • Frozen Reach (908) - playable source-backed adaptation. Alva (97700), Arktos (97701), 85 exact spell rows, and summon links for entries 97703, 97731, and 97770 were recovered. Server cadence, positions, stats, models, targeting, and exact phase behavior remain authored.
  • Forgotten Mine (1781) - playable source-backed adaptation. Geolord Vek (254272), 33 exact spell rows, Geospike (254278), and Resonite Shard (254051) were recovered. Server cadence, positions, trash, models, and the exact crystal rule remain authored.

The individual import command has been run for all three source-limited instances. Their checksummed recovery manifest lives under ascension/ and is validated by npm run dungeon:ascension:recovery:validate. Runtime adapters consume the recovered evidence while retaining explicit source-backed-adapted or healer-man-authored labels. The checklist remains open until an authoritative Ascension creature/spawn/object/server-script snapshot and native display mappings replace the remaining authored portions.

Per-dungeon asset/import 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.

These checks do not certify instance-script behavior. A dungeon remains functionally incomplete until its entry in WOW_DUNGEON_FUNCTIONALITY_REPORT.md is green.