Kelsidavis-WoWee/src/pipeline
Kelsi 0ceb70f3e7 feat(editor): add WIFS (Item Flag Set) open catalog format
Open replacement for the bit-flag meanings used in Item.dbc /
item_template.Flags. Documents every individual bit of the
32-bit item flags field with a human-readable name, description,
kind classification, and is-positive hint.

WoW's Item.dbc Flags field packs ~25 bits of metadata like
Heroic, Lootable, NoLoot, Conjured, BindOnPickup, BindOnEquip —
each controlling a specific gameplay behavior. The hardcoded
client knows what each bit means via a switch statement; this
catalog exposes that table to data-driven editors so:
  - server admins can document custom flag bits
  - tooltip generators can decode "why is this item soulbound?"
    via flag-name lookup (decode(0x40240000) returns
    ["Heroic", "BindOnPickup", "Unique"])
  - validators can warn about contradictory flag combinations

Seven flagKind values classify the bit families (Quality / Drop
/ Trade / Magic / Account / Server / Misc), and an isPositive
hint tells UIs whether the flag enhances the item (green) or
restricts it (red).

Cross-references back to WIT (decodes WIT.flags into the
matching named flag list) and WIQR (validators can pair Heroic
flag with WIQR Epic+ quality requirement).

Three preset emitters: --gen-ifs (8 canonical Item.dbc bits
matching the standard 3.3.5a constants), --gen-ifs-binding (5
binding-related flags BindOnPickup / BindOnEquip / etc — all
restrictive so isPositive=0), --gen-ifs-server (5 server-custom
bits in the upper range demonstrating how to overlay extra
metadata without colliding with Blizzard's bits).

Validation enforces id+name+bitMask presence, flagKind 0..6, no
duplicate ids, no duplicate bitMasks (collision means engine
would only honor first matching name when decoding); warns on
multi-bit masks (unusual — usually want individual bits).

decode(flagsValue) is the engine helper that expands a raw
flags integer into its named flag list — used directly by the
tooltip generator and item info renderers. Wired through the
cross-format table; WIFS appears automatically in all 16
cross-format utilities. Format count 85 -> 86; CLI flag count
1018 -> 1023.
2026-05-09 23:10:35 -07:00
..
adt_loader.cpp fix(adt): scrub NaN/inf in MDDF + MODF placement floats 2026-05-06 06:05:17 -07:00
asset_manager.cpp feat(runtime): pick up JSON DBC sidecars from --emit-json-dbc 2026-05-06 10:43:13 -07:00
asset_manifest.cpp Replace MPQ runtime with loose file asset system 2026-02-12 20:32:14 -08:00
blp_loader.cpp refactor: name ADT vertex constants, add BLP decompression comments 2026-03-30 14:28:22 -07:00
custom_zone_discovery.cpp fix(zones): clamp discovery mapId and tile coords on scan 2026-05-06 07:00:04 -07:00
dbc_layout.cpp fix: auto-detect CharSections.dbc layout and add Blood Elf/Draenei NPC voices 2026-03-23 11:00:49 -07:00
dbc_loader.cpp fix(dbc): skip non-array rows in loadJSON instead of failing 2026-05-06 10:07:49 -07:00
loose_file_reader.cpp Replace MPQ runtime with loose file asset system 2026-02-12 20:32:14 -08:00
m2_loader.cpp feat(rendering): implement spell visual effects with bone-tracked ribbons and particles 2026-04-07 11:27:59 +03:00
terrain_mesh.cpp fix(terrain): hide chunk grid by tiling textures 4× per chunk 2026-05-08 12:34:16 -07:00
wdt_loader.cpp fix(parsing): bail on suspicious maskBlockCount in CREATE_OBJECT blocks 2026-04-05 20:12:17 -07:00
wmo_loader.cpp fix: guard fsPath underflow, name WMO doodad mask, add why-comments 2026-03-30 14:33:08 -07:00
wowee_achievement_criteria.cpp feat(editor): add WACR (Achievement Criteria) open catalog format 2026-05-09 22:43:44 -07:00
wowee_achievements.cpp feat(pipeline): add WACH (Wowee Achievement Catalog) format 2026-05-09 16:04:30 -07:00
wowee_animations.cpp feat(pipeline): add WANI (Wowee Animation) catalog 2026-05-09 19:19:13 -07:00
wowee_auction.cpp feat(pipeline): add WAUC (Wowee Auction House) catalog 2026-05-09 18:34:54 -07:00
wowee_bags.cpp feat(pipeline): add WBNK (Wowee Bag / Bank Slot) catalog 2026-05-09 20:46:06 -07:00
wowee_battlegrounds.cpp feat(pipeline): add WBGD (Wowee Battleground Definition) format 2026-05-09 17:30:59 -07:00
wowee_building.cpp fix(wob): reject load on out-of-range string lengths 2026-05-06 09:23:19 -07:00
wowee_channels.cpp feat(pipeline): add WCHN (Wowee Chat Channel) catalog 2026-05-09 18:43:26 -07:00
wowee_char_features.cpp feat(pipeline): add WCHF (Wowee Character Customization Feature) catalog 2026-05-09 20:35:21 -07:00
wowee_chars.cpp feat(pipeline): add WCHC (Wowee Character Classes/Races) format 2026-05-09 16:47:04 -07:00
wowee_cinematics.cpp feat(pipeline): add WCMS (Wowee Cinematic) catalog 2026-05-09 18:50:43 -07:00
wowee_collision.cpp fix(woc): cap triangle count and clamp tile coords on save 2026-05-06 09:08:07 -07:00
wowee_combat_ratings.cpp feat(pipeline): add WCRR (Wowee Combat Rating Conversion) catalog 2026-05-09 21:11:26 -07:00
wowee_companions.cpp feat(pipeline): add WCMP (Wowee Companion Pet) catalog 2026-05-09 20:05:06 -07:00
wowee_conditions.cpp feat(pipeline): add WPCD (Wowee Player Condition) format 2026-05-09 18:18:27 -07:00
wowee_creature_difficulties.cpp feat(editor): add WCDF (Creature Difficulty) open catalog format 2026-05-09 22:10:09 -07:00
wowee_creature_equipment.cpp feat(pipeline): add WCEQ (Wowee Creature Equipment) — 50th open format 2026-05-09 19:48:13 -07:00
wowee_creature_families.cpp feat(editor): add WCEF (Creature Family) open catalog format 2026-05-09 21:54:00 -07:00
wowee_creatures.cpp feat(pipeline): add WCRT (Wowee Creature Template) format 2026-05-09 15:18:44 -07:00
wowee_currency_types.cpp feat(editor): add WCTR (Currency Type) open catalog format 2026-05-09 22:31:42 -07:00
wowee_events.cpp feat(pipeline): add WSEA (Wowee Seasonal Event) format 2026-05-09 17:14:46 -07:00
wowee_factions.cpp feat(pipeline): add WFAC (Wowee Faction Catalog) format 2026-05-09 15:37:59 -07:00
wowee_game_tips.cpp feat(pipeline): add WGTP (Wowee Game Tips) catalog 2026-05-09 20:00:56 -07:00
wowee_gems.cpp feat(pipeline): add WGEM (Wowee Gem / Enchantment) format 2026-05-09 18:01:48 -07:00
wowee_glyph_slots.cpp feat(editor): add WGFS (Glyph Slot) open catalog format 2026-05-09 22:05:05 -07:00
wowee_glyphs.cpp feat(pipeline): add WGLY (Wowee Glyph) catalog 2026-05-09 18:55:22 -07:00
wowee_gossip.cpp feat(pipeline): add WGSP (Wowee Gossip Menu) format 2026-05-09 16:20:07 -07:00
wowee_guilds.cpp feat(pipeline): add WGLD (Wowee Guild) catalog format 2026-05-09 18:10:45 -07:00
wowee_holidays.cpp feat(pipeline): add WHOL (Wowee Holiday) catalog 2026-05-09 19:05:33 -07:00
wowee_item_flags.cpp feat(editor): add WIFS (Item Flag Set) open catalog format 2026-05-09 23:10:35 -07:00
wowee_item_materials.cpp feat(editor): add WMAT (Item Material) open catalog format 2026-05-09 22:14:44 -07:00
wowee_item_qualities.cpp feat(editor): add WIQR (Item Quality) open catalog format 2026-05-09 22:59:27 -07:00
wowee_item_sets.cpp feat(pipeline): add WSET (Wowee Item Set / Tier Bonus) catalog 2026-05-09 19:54:36 -07:00
wowee_item_suffixes.cpp feat(pipeline): add WSUF (Wowee Item Random Suffix) catalog 2026-05-09 21:05:49 -07:00
wowee_items.cpp feat(pipeline): add WIT (Wowee Item Template) format 2026-05-09 15:04:48 -07:00
wowee_keybindings.cpp feat(pipeline): add WKBD (Wowee Keybinding) catalog 2026-05-09 20:13:37 -07:00
wowee_lfg.cpp feat(pipeline): add WLFG (Wowee Looking-for-Group) catalog 2026-05-09 20:24:21 -07:00
wowee_light.cpp feat(pipeline): add WOL preset variants for cave/dungeon/night 2026-05-09 14:01:26 -07:00
wowee_liquids.cpp feat(pipeline): add WLIQ (Wowee Liquid Type) catalog 2026-05-09 19:10:03 -07:00
wowee_loading_screens.cpp feat(pipeline): add WLDS (Wowee Loading Screen) catalog 2026-05-09 20:59:25 -07:00
wowee_locks.cpp feat(pipeline): add WLCK (Wowee Lock Template) format 2026-05-09 15:44:26 -07:00
wowee_loot.cpp feat(pipeline): add WLOT (Wowee Loot Table) format 2026-05-09 15:11:08 -07:00
wowee_macros.cpp feat(pipeline): add WMAC (Wowee Macro / Slash Command) catalog 2026-05-09 20:30:17 -07:00
wowee_mail.cpp feat(pipeline): add WMAL (Wowee Mail Template) format 2026-05-09 17:41:03 -07:00
wowee_maps.cpp feat(pipeline): add WMS (Wowee Map / Area) catalog format 2026-05-09 16:40:00 -07:00
wowee_model.cpp feat(extract): emit WOM and WOB side-files (M2/WMO → open formats) 2026-05-06 10:32:17 -07:00
wowee_model_fromm2.cpp feat(extract): emit WOM and WOB side-files (M2/WMO → open formats) 2026-05-06 10:32:17 -07:00
wowee_mounts.cpp feat(pipeline): add WMOU (Wowee Mount catalog) format 2026-05-09 17:23:00 -07:00
wowee_objects.cpp feat(pipeline): add WGOT (Wowee Game Object Template) format 2026-05-09 15:31:49 -07:00
wowee_pets.cpp feat(pipeline): add WPET (Wowee Pet System) catalog 2026-05-09 18:27:02 -07:00
wowee_player_conditions.cpp feat(pipeline): add WPCN (Wowee Player Condition) catalog 2026-05-09 19:36:56 -07:00
wowee_player_spawn_profiles.cpp feat(editor): add WPSP (Player Spawn Profile) open catalog format 2026-05-09 22:22:57 -07:00
wowee_pvp.cpp feat(pipeline): add WPVP (Wowee PvP Honor / Rank) — 60th open format 2026-05-09 20:41:09 -07:00
wowee_quest_sorts.cpp feat(pipeline): add WQSO (Wowee Quest Sort) catalog 2026-05-09 21:23:38 -07:00
wowee_quests.cpp feat(pipeline): add WQT (Wowee Quest Template) format 2026-05-09 15:25:02 -07:00
wowee_runes.cpp feat(pipeline): add WRUN (Wowee DK Rune Cost) catalog 2026-05-09 20:52:19 -07:00
wowee_skill_costs.cpp feat(editor): add WSCS (Skill Cost) open catalog format 2026-05-09 23:04:02 -07:00
wowee_skills.cpp feat(pipeline): add WSKL (Wowee Skill Catalog) format 2026-05-09 15:50:25 -07:00
wowee_sound.cpp feat(pipeline): add WSND (Wowee Sound Catalog) format 2026-05-09 14:47:16 -07:00
wowee_spawns.cpp feat(pipeline): add WSPN (Wowee Spawn Point catalog) format 2026-05-09 14:57:53 -07:00
wowee_spell_aura_types.cpp feat(editor): add WAUR (Spell Aura Type) — companion to WSEF, CLI flag count breaks 1000 2026-05-09 22:54:53 -07:00
wowee_spell_cast_times.cpp feat(editor): add WSCT (Spell Cast Time Index) open catalog format 2026-05-09 21:37:42 -07:00
wowee_spell_cooldowns.cpp feat(editor): add WSCD (Spell Cooldown Category) open catalog format 2026-05-09 21:49:13 -07:00
wowee_spell_durations.cpp feat(editor): add WSDR (Spell Duration Index) — completes WSRG/WSCT/WSDR triplet 2026-05-09 21:41:55 -07:00
wowee_spell_effect_types.cpp feat(editor): add WSEF (Spell Effect Type) open catalog format 2026-05-09 22:50:13 -07:00
wowee_spell_mechanics.cpp feat(pipeline): add WSMC (Wowee Spell Mechanic) catalog 2026-05-09 20:09:44 -07:00
wowee_spell_power_costs.cpp feat(editor): add WSPC (Spell Power Cost) — completes spell-bucket five-pack 2026-05-09 22:00:55 -07:00
wowee_spell_ranges.cpp feat(editor): add WSRG (Spell Range Index) open catalog format 2026-05-09 21:33:17 -07:00
wowee_spell_reagents.cpp feat(editor): add WSPR (Spell Reagent) — 80th open format milestone 2026-05-09 22:38:36 -07:00
wowee_spell_schools.cpp feat(pipeline): add WSCH (Wowee Spell School) catalog 2026-05-09 20:19:34 -07:00
wowee_spell_visuals.cpp feat(pipeline): add WSVK (Wowee Spell Visual Kit) catalog 2026-05-09 19:23:36 -07:00
wowee_spells.cpp feat(pipeline): add WSPL (Wowee Spell Catalog) format 2026-05-09 15:58:09 -07:00
wowee_talent_tabs.cpp feat(editor): add WTLE (Talent Tab) open catalog format 2026-05-09 22:27:18 -07:00
wowee_talents.cpp feat(pipeline): add WTAL (Wowee Talent catalog) format 2026-05-09 16:33:45 -07:00
wowee_taxi.cpp feat(pipeline): add WTAX (Wowee Taxi catalog) format 2026-05-09 16:26:27 -07:00
wowee_terrain_loader.cpp fix(wot): cap doodadNames/wmoNames at 65536 + guard non-string entries 2026-05-06 10:06:20 -07:00
wowee_titles.cpp feat(pipeline): add WTIT (Wowee Title catalog) format 2026-05-09 17:07:56 -07:00
wowee_tokens.cpp feat(pipeline): add WTKN (Wowee Token catalog) format 2026-05-09 16:53:11 -07:00
wowee_trade_skills.cpp feat(pipeline): add WTSK (Wowee Trade Skill / Recipe) catalog 2026-05-09 19:41:49 -07:00
wowee_trainers.cpp feat(pipeline): add WTRN (Wowee Trainer / Vendor catalog) format 2026-05-09 16:12:58 -07:00
wowee_triggers.cpp feat(pipeline): add WTRG (Wowee Area Trigger) format 2026-05-09 17:01:43 -07:00
wowee_unit_movement.cpp feat(pipeline): add WUMV (Wowee Unit Movement Type) catalog 2026-05-09 21:18:03 -07:00
wowee_vehicles.cpp feat(pipeline): add WVHC (Wowee Vehicle) catalog 2026-05-09 18:59:49 -07:00
wowee_weather.cpp feat(pipeline): add Wowee Open Weather (.wow) zone schedule 2026-05-09 14:10:13 -07:00
wowee_world_map.cpp feat(pipeline): add WOMX (Wowee World Map index) format 2026-05-09 14:38:05 -07:00
wowee_world_state_ui.cpp feat(pipeline): add WWUI (Wowee World-State UI) catalog 2026-05-09 19:32:15 -07:00