$ show Kruithne/wow.export
wow.export is a desktop application for extracting, previewing, and exporting assets from World of Warcraft (Retail, Classic, and other versions). It reads game data from local installations (CASC and MPQ archives) or remote CDN servers, parsing proprietary formats including M2 models, WMO world objects, ADT terrain tiles, BLP textures, DB2/WDC data tables, and audio/video files. The application provides a tabbed UI for browsing and exporting assets to standard formats such as OBJ, GLTF, STL, PNG, WebP, CSV, and SQL. It includes a real-time 3D preview powered by WebGL2 with skeletal animation, skinning, and environment effects like fog and lighting. Architecturally, the application is a monolithic desktop client built with NW.js and Vue.js. The core data pipeline consists of archive readers (CASC and MPQ), format parsers/loaders, and export writers. A module system registers tabs and context menus, and a central event bus coordinates state. WebGL rendering is abstracted through a set of helper classes (GLContext, VertexArray, ShaderProgram) used by multiple renderers for M2, WMO, terrain, and liquids. The application relies on Node.js built-ins for file I/O and binary data handling, and uses native addons (mmap) for efficient access to large listfiles. Key entry points include src/app.js (application bootstrap), src/js/core.js (central state and events), src/js/modules/tab_home.js and other tab modules, and the various loaders and exporters in src/js/3D/. External dependencies include NW.js, Vue.js, and a few npm packages like adm-zip and webp-wasm. The application is actively maintained with frequent updates to support new WoW patches and export features. Notable reusable components include BufferWrapper (binary read/write with BLTE support), WDCReader (generic DB2/WDC file parser), and GLTFWriter (glTF binary exporter). These modules are isolated and could be extracted for other projects dealing with binary formats or 3D asset pipelines.
The LLM identified 3 files worth highlighting for reuse:
BufferWrapper is a comprehensive binary data reading/writing utility that wraps Node.js Buffer. It provides methods for reading/writing integers of various sizes, strings, and arrays, with support for BLTE (Blizzard's encryption/compression format). It is used throughout the entire codebase for parsing game files. Its isolated nature and clear API make it reusable in any project that needs to handle binary data with seek/read/write operations.
GLTFWriter implements the glTF 2.0 specification for writing both JSON (.gltf) and binary (.glb) formats. It handles chunk-based GLB writing with proper alignment, padding, and structure. It is used by both M2 and WMO exporters to output 3D models. The module is self-contained and could be extracted for any project requiring glTF/GLB export, demonstrating solid understanding of the spec.
WDCReader is a parser for Blizzard's WDC2-WDC5 database formats (used in WoW from Battle for Azeroth onward). It handles multiple sections, field definitions, copy tables, relationship maps, and encrypted sections with lazy row loading. This module demonstrates advanced reverse-engineering of a proprietary binary format and is reusable for any project that needs to read WDC/DB2 files, provided the schema is known.