feat(pipeline): WPRT mage portal destinations catalog (129th open format)
Some checks are pending
Build / Build (arm64) (push) Waiting to run
Build / Build (x86-64) (push) Waiting to run
Build / Build (macOS arm64) (push) Waiting to run
Build / Build (windows-arm64) (push) Waiting to run
Build / Build (windows-x86-64) (push) Waiting to run
Security / CodeQL (C/C++) (push) Waiting to run
Security / Semgrep (push) Waiting to run
Security / Sanitizer Build (ASan/UBSan) (push) Waiting to run

Novel replacement for the implicit portal-spell -> destination-
coordinate binding vanilla WoW carried in scattered pieces:
SpellEffects.dbc effect-71 (TELEPORT_UNITS) + per-spell hard-
coded destination tables in the server's SpellMgr +
AreaTrigger.dbc destination rows. Each WPRT entry binds one
Teleport/Portal spellId to its destination world coords,
faction-access gate, level requirement, and reagent
requirement.

PortalKind enum captures the canonical Teleport (self-only,
Rune of Teleportation, level 20) vs Portal (group, Rune of
Portals, level 40) distinction.

Three presets:
  --gen-prt-alliance   4 Alliance city portals (Stormwind /
                       Ironforge / Darnassus / Theramore) with
                       canonical spellIds 10059/11416/11419/
                       49361 and Rune of Portals reagent
  --gen-prt-horde      3 Horde city portals (Orgrimmar /
                       Undercity / Thunder Bluff)
  --gen-prt-teleports  3 self-teleports paired across factions
                       (Teleport: Stormwind/Ironforge Alliance +
                       Teleport: Orgrimmar Horde) — illustrates
                       the Teleport-vs-Portal kind distinction
                       with proper reagent (Rune of Teleportation
                       17031 NOT Rune of Portals 17032)

Validator catches: id+spellId+destination required,
factionAccess/portalKind range, no duplicate portalIds, no
duplicate spellIds (cast-handler conflict). Warns on
levelRequirement < 20 (vanilla mage cannot unlock), Portal kind
without Rune of Portals (17032), Teleport kind without Rune of
Teleportation (17031), and duplicate destination names (could be
legitimate Teleport+Portal pair OR copy-paste bug — the editor
flags both).

Format count 128 -> 129. CLI flag count 1355 -> 1362.
This commit is contained in:
Kelsi 2026-05-10 04:01:42 -07:00
parent 85ac2e0248
commit be3a253dcc
10 changed files with 772 additions and 0 deletions

View file

@ -153,6 +153,7 @@ constexpr FormatRow kFormats[] = {
{"WSPK", ".wspk", "spells", "SkillLineAbility + per-spec tab order","Spell pack catalog (per-class spellbook tab layout)"},
{"WPHM", ".wphm", "anim", "implicit M2 movementState->anim map","Player movement-to-animation map (per race/gender/state)"},
{"WTSC", ".wtsc", "transit", "TaxiNodes + zeppelin GO scripts", "Transit schedule catalog (taxi/zeppelin/boat scheduled departures)"},
{"WPRT", ".wprt", "portals", "SpellEffect TELEPORT_UNITS + AreaTrigger","Mage portal destinations catalog (spellId -> coords binding)"},
// Additional pipeline catalogs without the alternating
// gen/info/validate CLI surface (loaded by the engine