Back to homepage
Instructions for building Hedgewars on Windows
Phase-Implementation, Phase-Design, Phase-Support
Updated Fri, 07 Apr 2023 19:39:42 +0300 by alfadur

Building on Windows


These build instructions require at least Windows 7. First of all, figure out whether your system is a 32-bit or a 64-bit system. You can use the guide at On a 64-bit system both 32-bit and 64-bit builds can be made, although 64-bit is preferred. Making a 64-bit build on a 32-bit system might be possible, but hasn't been tested.

Required Tools

Choose either 32-bit or 64-bit depending on your system and which build you want to make.


  • Install CMake, but please ensure you select "Add CMake to the system PATH for all users", so you can run CMake directly from the command line.
  • Install FreePascal and if necessary the 64-bit cross-compiler plugin (the one with cross.x86_64-win64 in the file name).
  • Install Visual Studio, ensuring the Workloads → Desktop development with C++ and Language packs → English options are selected.
  • Install Vcpkg by following the instructions under Quick Start section on the project page. If you don't have Git, use the Clone or download → Download ZIP option and extract the ZIP file. Create VCPKG_ROOT environment variable pointing to the directory you've cloned/extracted it to.
  • Install TortoiseHg / Mercurial
  • Restart the computer
  • Download the Hedgewars source code:
    • Using TortoiseHg:
    • Using command-line Mercurial
      • Shift + Right-click in the folder where you want to download the source and select "Open Command Prompt Window Here" or "Open PowerShell? window here".
      • Type and execute (The initial clone of the repository will take a while): hg clone trunk
  • Navigate to the Vcpkg directory in the command line and build the necessary libraries (this will also take a while, especially for Qt). The command is:
    • For 32-bit builds: .\vcpkg.exe install sdl2 sdl2-image sdl2-ttf sdl2-mixer sdl2-net physfs openssl qt5-base qt5-tools ffmpeg
    • For 64-bit builds: .\vcpkg.exe install sdl2 sdl2-image sdl2-ttf sdl2-mixer sdl2-net physfs openssl qt5-base qt5-tools ffmpeg --triplet=x64-windows
  • Build Hedgewars
    • From the Start menu run either "x86 Native Tools Command Prompt for VS 2019" or "x64 Native Tools Command Prompt for VS 2019" (if you want Hedgewars to install to the default location in C:\Program Files , run it as administrator).
    • Navigate to <hedgewars_root>\tools where <hedgewars_root> is the directory where you cloned the repository source to.
    • Run build_vcpkg.bat script
  • After building, you can run Hedgewars from the installed location (default is C:\Program Files\hedgewars\hedgewars.exe )

Additional options

Check the top section of build_vcpkg.bat to change some of the build options.