phaneron/Kelsidavis-WoWee
1
0
Fork 0
mirror of https://github.com/Kelsidavis/WoWee.git synced 2026-05-10 19:13:52 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

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

Browse source 
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
Download patch file Download diff file Expand all files Collapse all files

10
tools/editor/cli_help.cpp
View file

@ -2559,6 +2559,16 @@ void printUsage(const char* argv0) {
std::printf(" Export binary .wtsc to a human-editable JSON sidecar (defaults to <base>.wtsc.json; emits both vehicleType and factionAccess as int + name string; floats preserved bit-for-bit)\n");
std::printf(" --import-wtsc-json <json-path> [out-base]\n");
std::printf(" Import a .wtsc.json sidecar back into binary .wtsc (vehicleType int OR \"taxi\"/\"zeppelin\"/\"boat\"/\"mount\"; factionAccess int OR \"both\"/\"alliance\"/\"horde\"/\"neutral\")\n");
std::printf(" --gen-prt-alliance <wprt-base> [name]\n");
std::printf(" Emit .wprt 4 Alliance city portals (Stormwind/Ironforge/Darnassus/Theramore) with Rune of Portals reagent (itemId 17032), level 40\n");
std::printf(" --gen-prt-horde <wprt-base> [name]\n");
std::printf(" Emit .wprt 3 Horde city portals (Orgrimmar/Undercity/Thunder Bluff) with Rune of Portals, level 40\n");
std::printf(" --gen-prt-teleports <wprt-base> [name]\n");
std::printf(" Emit .wprt 3 self-teleport spells (Teleport: Stormwind/Ironforge/Orgrimmar) — Teleport kind, costs Rune of Teleportation (itemId 17031), level 20\n");
std::printf(" --info-wprt <wprt-base> [--json]\n");
std::printf(" Print WPRT entries (id / spellId / portalKind / factionAccess / levelRequirement / reagentItemId / destination)\n");
std::printf(" --validate-wprt <wprt-base> [--json]\n");
std::printf(" Static checks: id+spellId+destination required, factionAccess 0..3, portalKind 0..1, no duplicate portalIds, no duplicate spellIds (would conflict on cast); 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 (likely Teleport+Portal pair OR copy-paste bug)\n");
std::printf(" --catalog-pluck <wXXX-file> <id> [--json]\n");
std::printf(" Extract one entry by id from any registered catalog format. Auto-detects magic, dispatches to the per-format --info-* handler internally, then prints just the matching entry. Primary-key field is auto-detected (first *Id field, or first numeric)\n");
std::printf(" --catalog-find <directory> <id> [--magic <WXXX>] [--json]\n");