Kelsidavis-WoWee/tools
Kelsi 1b385fb39c feat(pipeline): add WBGD (Wowee Battleground Definition) format
Novel open replacement for Blizzard's BattlemasterList.dbc +
PvpDifficulty.dbc + the AzerothCore-style
battleground_template SQL tables. The 33rd open format
added to the editor.

Defines per-BG gameplay rules: player count brackets,
score-to-win, time limit, objective type (annihilation /
capture flag / control nodes / king of hill / resource race
/ carry object), per-team start positions, respawn timer,
and the WTKN currency token awarded on win.

Cross-references with previously-added formats:
  WBGD.entry.mapId       -> WMS.map.mapId
                            (where mapType=Battleground)
  WBGD.entry.markTokenId -> WTKN.entry.tokenId
                            (Mark of Honor for that BG)

The classic preset's markTokenId fields (102/103/104)
deliberately match WTKN.makePvp's "Mark of Honor: Warsong
Gulch / Arathi Basin / Alterac Valley" token ids — so the
demo content stack already wires together: WBGD.scoreToWin
reached → grant WTKN mark → which a vendor in WTRN can
charge in via item.extendedCost.

Format:
  • magic "WBGD", version 1, little-endian
  • per BG: battlegroundId / mapId / name / description /
    objectiveKind / min+maxPlayersPerSide /
    minLevel..maxLevel / scoreToWin / timeLimitSeconds /
    bracketSize / allianceStart vec3 + facing /
    hordeStart vec3 + facing / respawnTimeSeconds /
    markTokenId

Enums:
  • ObjectiveKind (6): Annihilation / CaptureFlag /
                       ControlNodes / KingOfHill /
                       ResourceRace / CarryObject

API: WoweeBattlegroundLoader::save / load / exists /
findById.

Three preset emitters showcase typical BG shapes:
  • makeStarter — 1 king-of-hill BG (10v10, 3-cap to win)
  • makeClassic — 3 classic BGs with authentic player
                   counts, level brackets, scoring, and
                   WTKN cross-refs (Warsong Gulch CTF /
                   Arathi Basin nodes / Alterac Valley
                   resource race)
  • makeArena   — 3 arena formats (Nagrand 2v2 / Blade's
                   Edge 3v3 / Lordaeron 5v5) — annihilation
                   objective + no respawn + 25 min cap

CLI added (5 flags, 628 documented total now):
  --gen-bg / --gen-bg-classic / --gen-bg-arena
  --info-wbgd / --validate-wbgd

Validator catches: bgId=0 + duplicates, empty name, unknown
objectiveKind, player count=0, min>max counts/levels,
scoreToWin=0 (no win condition), non-annihilation BG with
respawnTimeSeconds=0 (losing side cannot recover).
2026-05-09 17:30:59 -07:00
..
asset_extract feat(extract): --purge-proprietary --json for machine-readable purge report 2026-05-06 11:32:42 -07:00
auth_login_probe Auth: include CRC in legacy proof; extend Turtle integrity set 2026-02-13 01:41:59 -08:00
auth_probe Add authenticator opcode support + auth_probe tool 2026-02-13 00:55:36 -08:00
blp_convert Replace MPQ runtime with loose file asset system 2026-02-12 20:32:14 -08:00
dbc_to_csv tools: fix DBC string-column detection false positives in both dbc_to_csv and asset_extract 2026-03-10 03:49:06 -07:00
editor feat(pipeline): add WBGD (Wowee Battleground Definition) format 2026-05-09 17:30:59 -07:00
asset_pipeline_gui.py feat(animation): 452 named constants, 30-phase character animation state machine 2026-04-04 23:02:53 +03:00
backup_assets.sh Fix macOS build process and make shell scripts cross-platform 2026-02-23 18:35:53 -08:00
diff_classic_turtle_opcodes.py chore: fix executable permissions on 6 scripts 2026-03-30 18:55:15 -07:00
gen_opcode_registry.py chore: fix executable permissions on 6 scripts 2026-03-30 18:55:15 -07:00
generate_ffx_sdk_vk_permutations.sh Fix FSR3 permutation script failures on arm64 Linux and Windows 2026-03-09 13:11:03 -07:00
m2_viewer.py feat(animation): 452 named constants, 30-phase character animation state machine 2026-04-04 23:02:53 +03:00
opcode_map_utils.py chore: fix executable permissions on 6 scripts 2026-03-30 18:55:15 -07:00
validate_opcode_maps.py chore: fix executable permissions on 6 scripts 2026-03-30 18:55:15 -07:00