phaneron/Kelsidavis-WoWee
1
0
Fork 0
mirror of https://github.com/Kelsidavis/WoWee.git synced 2026-03-22 23:30:14 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3
Kelsidavis-WoWee/BUILD_INSTRUCTIONS.md
Kelsi eb549a9b7a Fix Windows build process and add Windows asset extraction scripts 
- Add missing MSYS2 packages to CI: vulkan-loader, vulkan-headers,
  shaderc, stormlib (both x86-64 and arm64), unicorn (arm64)
- Make vulkan-1.dll copy conditional via find_file (fixes MSYS2 builds)
- Use find_library for wininet/bz2 in asset_extract (graceful fallback)
- Add extract_assets.ps1 and extract_assets.bat for Windows users
- Expand BUILD_INSTRUCTIONS.md with MSYS2, vcpkg, and macOS sections
- Update README.md to reference Windows scripts and platforms
2026-02-23 18:32:47 -08:00

4.1 KiB
Raw Blame History

WoWee Build Instructions

This document provides platform-specific build instructions for WoWee.

🐧 Linux (Ubuntu / Debian)

Install Dependencies

sudo apt update
sudo apt install -y   build-essential cmake pkg-config git   libsdl2-dev libglew-dev libglm-dev   libssl-dev zlib1g-dev   libavcodec-dev libavformat-dev libavutil-dev libswscale-dev   libunicorn-dev   libstorm-dev

🐧 Linux (Arch)

Install Dependencies

sudo pacman -S --needed   base-devel cmake pkgconf git   sdl2 glew glm   openssl zlib   ffmpeg   unicorn   stormlib

🐧 Linux (All Distros)

Clone Repository

Always clone with submodules:

git clone --recurse-submodules https://github.com/Kelsidavis/WoWee.git
cd WoWee

If you already cloned without submodules:

git submodule update --init --recursive

Build

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j"$(nproc)"

Asset Extraction (Linux)

After building, extract assets from your WoW client:

./extract_assets.sh /path/to/WoW/Data wotlk

Supports classic, tbc, wotlk targets (auto-detected if omitted).

🍎 macOS

Install Dependencies

brew install cmake pkg-config sdl2 glew glm openssl@3 zlib ffmpeg unicorn stormlib

Clone & Build

git clone --recurse-submodules https://github.com/Kelsidavis/WoWee.git
cd WoWee

BREW=$(brew --prefix)
export PKG_CONFIG_PATH="$BREW/lib/pkgconfig:$(brew --prefix ffmpeg)/lib/pkgconfig:$(brew --prefix openssl@3)/lib/pkgconfig"
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_PREFIX_PATH="$BREW" \
  -DOPENSSL_ROOT_DIR="$(brew --prefix openssl@3)"
cmake --build build -j"$(sysctl -n hw.logicalcpu)"

Asset Extraction (macOS)

./extract_assets.sh /path/to/WoW/Data wotlk

🪟 Windows (MSYS2 — Recommended)

MSYS2 provides all dependencies as pre-built packages.

Install MSYS2

Download and install from https://www.msys2.org/, then open a MINGW64 shell.

Install Dependencies

pacman -S --needed \
  mingw-w64-x86_64-cmake \
  mingw-w64-x86_64-gcc \
  mingw-w64-x86_64-ninja \
  mingw-w64-x86_64-pkgconf \
  mingw-w64-x86_64-SDL2 \
  mingw-w64-x86_64-glew \
  mingw-w64-x86_64-glm \
  mingw-w64-x86_64-openssl \
  mingw-w64-x86_64-zlib \
  mingw-w64-x86_64-ffmpeg \
  mingw-w64-x86_64-unicorn \
  mingw-w64-x86_64-vulkan-loader \
  mingw-w64-x86_64-vulkan-headers \
  mingw-w64-x86_64-shaderc \
  mingw-w64-x86_64-stormlib \
  git

Clone & Build

git clone --recurse-submodules https://github.com/Kelsidavis/WoWee.git
cd WoWee
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel $(nproc)

🪟 Windows (Visual Studio 2022)

For users who prefer Visual Studio over MSYS2.

Install

  • Visual Studio 2022 with Desktop development with C++ workload
  • CMake tools for Windows (included in VS workload)
  • LunarG Vulkan SDK (provides Vulkan headers, loader, and glslc)

vcpkg Dependencies

vcpkg install sdl2 glew glm openssl zlib ffmpeg stormlib --triplet x64-windows

Clone

git clone --recurse-submodules https://github.com/Kelsidavis/WoWee.git
cd WoWee

Build

Open the folder in Visual Studio (it will detect CMake automatically) or build from Developer PowerShell:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE="[vcpkg root]/scripts/buildsystems/vcpkg.cmake"
cmake --build build --config Release

🪟 Asset Extraction (Windows)

After building (via either MSYS2 or Visual Studio), extract assets from your WoW client:

.\extract_assets.ps1 "C:\Games\WoW-3.3.5a\Data"

Or double-click extract_assets.bat and provide the path when prompted. You can also specify an expansion: .\extract_assets.ps1 "C:\Games\WoW\Data" wotlk

⚠️ Notes

  • Case matters on Linux (WoWee not wowee).
  • Always use --recurse-submodules when cloning.
  • If you encounter missing headers for ImGui, run: 
    git submodule update --init --recursive