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

feat(pipeline): WTUR tutorial steps catalog (142nd open format)

Browse source 
Novel format covering what vanilla WoW had as a hard-coded LUA
tipbox sequence (TutorialFrame.xml + Tutorial.lua client-side
with no data-driven extension point). Each WTUR entry binds
one tutorial step to a trigger event (Login / ZoneEnter /
LevelUp / ItemPickup / SkillTrain), an ordered stepIndex within
that trigger group, a title + body for the popup, optional UI-
element name to highlight, and a hide-after auto-dismiss timer.

Three presets covering the most common tutorial scenarios:
  --gen-tut-newbie   5 first-login steps (Welcome / Camera /
                     Interact NPCs / OpenQuestLog / OpenBags)
                     with 30s auto-dismiss and UI-element
                     highlight names ("MovementHint",
                     "QuestLogButton", "BagButton")
  --gen-tut-levelup  3 LevelUp-trigger steps gated on
                     specific level milestones (level 2
                     spellbook hint / level 5 trainer visit /
                     level 10 talent unlock)
  --gen-tut-bg       3 ZoneEnter-trigger steps gated to BG
                     mapIds (AV=30 explains 40v40 / WSG=489
                     explains capture-flag / AB=529 explains
                     control-point) — explains each ruleset
                     on first BG entry

Validator catches: id+name+title+body required, triggerEvent
0..4, stepIndex > 0 (sequence starts at 1), no duplicate
tutIds, no duplicate (event,value,step) triples (sequence
ordering ambiguity). CRITICAL: hideAfterSec MUST be 0 (no
auto-dismiss) OR >= 5s — else popup vanishes before player
can read it. Warns on Login event with non-zero triggerValue
(dead data, Login is unconditional), non-Login event with
triggerValue=0 (would fire for ALL events of that kind), and
body length < 10 chars (likely placeholder text).

Format count 141 -> 142. CLI flag count 1472 -> 1479.
This commit is contained in:
Kelsi 2026-05-10 05:40:03 -07:00
parent 4dd1fb09ff
commit ec81c9b529
10 changed files with 762 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
tools/editor/cli_format_table.cpp
View file

@ -144,6 +144,7 @@ constexpr FormatMagicEntry kFormats[] = {
{{'W','A','U','H'}, ".wauh", "economy", "--info-wauh", "Auction house config catalog"},
{{'W','B','R','D'}, ".wbrd", "pvp", "--info-wbrd", "Battleground reward stages catalog"},
{{'W','S','W','P'}, ".wswp", "audio", "--info-wswp", "Sound swap rules catalog"},
{{'W','T','U','R'}, ".wtur", "ui", "--info-wtur", "Tutorial steps catalog"},
{{'W','F','A','C'}, ".wfac", "factions", nullptr, "Faction catalog"},
{{'W','L','C','K'}, ".wlck", "locks", nullptr, "Lock catalog"},
{{'W','S','K','L'}, ".wskl", "skills", nullptr, "Skill catalog"},