Kelsidavis / WoWee

WoWee - World Of Warcraft Engine Experiment A native C++ World of Warcraft client with a custom Vulkan renderer. Protocol Compatible with **Vanilla (Classic) 1.12 + TBC 2.4.3 + WotLK 3.3.5a**. > **Legal Disclaimer**: This is an educational/research project. It does not include any Blizzard Entertainment assets, data files, or proprietary code. World of Warcraft and all related assets are the property of Blizzard Entertainment, Inc. This project is not affiliated with or endorsed by Blizzard Entertainment. Users are responsible for supplying their own legally obtained game data files and for ensuring compliance with all applicable laws in their jurisdiction. Status & Direction (2026-03-07) • **Compatibility**: **Vanilla (Classic) 1.12 + TBC 2.4.3 + WotLK 3.3.5a** are all supported via expansion profiles and per-expansion packet parsers ( , ). All three expansions are roughly on par — no single one is significantly more complete than the others. • **Tested against**: AzerothCore, TrinityCore, Mangos, and Turtle WoW (1.17). • **Current focus**: instance dungeons, visual accuracy (lava/water, shadow mapping, WMO interiors), and multi-expansion coverage. • **Warden**: Full module execution via Unicorn Engine CPU emulation. Decrypts (RC4→RSA→zlib), parses and relocates the PE module, executes via x86 emulation with Windows API interception. Module cache at . • **CI**: GitHub Actions builds for Linux (x86-64, ARM64), Windows (MSYS2), and macOS (ARM64). Security scans via CodeQL, Semgrep, and sanitizers. Features Rendering Engine • **Terrain** -- Multi-tile streaming with async loading, texture splatting (4 layers), frustum culling, expanded load radius during taxi flights • **Atmosphere** -- Procedural clouds (FBM noise), lens flare with chromatic aberration, cloud/fog star occlusion • **Characters** -- Skeletal animation with GPU vertex skinning (256 bones), race-aware textures, per-instance NPC hair/skin textures • **Buildings** -- WMO renderer with multi-material batches, frustum culling, collision (wall/floor classification, slope sliding), interior glass transparency • **Instances** -- WDT parser for WMO-only dungeon maps, area trigger portals with glow/spin effects, seamless zone transitions • **Water & Lava** -- Terrain and WMO water with refraction/reflection, magma/slime rendering with multi-octave FBM noise flow, Beer-Lambert absorption, M2 lava waterfalls with UV scroll • **Particles** -- M2 particle emitters with WotLK struct parsing, billboarded glow effects, lava steam/splash effects • **Lighting** -- Shadow mapping with PCF filtering, per-frame shadow updates, AABB-based culling, interior/exterior light modes, WMO window glass with fresnel reflections • **Performance** -- Binary keyframe search for animations, incremental spatial index, static doodad skip, hash-free render/shadow culling Asset Pipeline • Extracted loose-file ** ** tree indexed by ** ** (fast lookup + caching) • Optional **overlay layers** for multi-expansion asset deduplication • + (Linux/macOS) / (Windows) for MPQ extraction (StormLib tooling) • File formats: **BLP** (DXT1/3/5), **ADT**, **M2**, **WMO**, **DBC** (Spell/Item/Faction/etc.) Gameplay Systems • **Authentication** -- Full SRP6a implementation with RC4 header encryption • **Character System** -- Creation (with nonbinary gender option), selection, 3D preview, stats panel, race/class support • **Movement** -- WASD movement, camera orbit, spline path following, transport riding (trams, ships, zeppelins), movement ACK responses • **Combat** -- Auto-attack, spell casting with cooldowns, damage calculation, death handling, spirit healer resurrection • **Targeting** -- Tab-cycling with hostility filtering, click-to-target, faction-based hostility (using Faction.dbc) • **Inventory** -- 23 equipment slots, 16 backpack slots, drag-drop, auto-equip, item tooltips with weapon damage/speed • **Bank** -- Full bank support for all expansions, bag slots, drag-drop, right-click deposit (non-equippable items) • **Spells** -- Spellbook with specialty, general, profession, mount, and companion tabs; drag-drop to action bar; item use support • **Talents** -- Talent tree UI with proper visuals and functionality • **Action Bar** -- 12 slots, drag-drop from spellbook/inventory, click-to-cast, keybindings • **Trainers** -- Spell trainer UI, buy spells, known/available/unavailable states • **Quests** -- Quest markers (! and ?) on NPCs and minimap, quest log, quest details, turn-in flow, quest item progress tracking • **Auction House** -- Search with filters, pagination, sell picker with tooltips, bid/buyout • **Mail** -- Item attachment support for sending • **Vendors** -- Buy, sell, and buyback (most recent sold item), gold tracking, inventory sync • **Loot** -- Loot window, gold looting, item pickup, chest/gameobject looting • **Gossip** -- NPC interaction, dialogue options • **Chat** -- Tabs/channels, emotes, chat bubbles, clickable URLs, clickable item links with tooltips • **Party** -- Group invites, party list, out-of-range member health via SMSG_PARTY_MEMBER_STATS • **Pets** -- Pet tracking via SMSG_PET_SPELLS, action bar (10 slots with icon/autocast tinting/tooltips), dismiss button • **Map Exploration** -- Subzone-level fog-of-war reveal matching retail behavior • **Warden** -- Warden anti-cheat module execution via Unicorn Engine x86 emulation (cross-platform, no Wine) • **UI** -- Loading screens with progress bar, settings window with graphics quality presets (LOW/MEDIUM/HIGH/ULTRA), shadow distance slider, minimap with zoom/rotation/square mode, top-right minimap mute speaker, separate bag windows with compact-empty mode (aggregate view) Graphics & Performance Quality Presets WoWee includes four built-in graphics quality presets to help you quickly balance visual quality and performance: | Preset | Shadows | MSAA | Normal Mapping | Clutter Density | |--------|---------|------|----------------|-----------------| | **LOW** | Off | Off | Disabled | 25% | |…