ALPHA version - expect chaos
Instructions for building Hedgewars on Windows (Currently outdated)
Updated Thu, 24 Mar 2016 09:55:10 -0400 by nemo

Building on Windows


These build instructions are very outdated. Try to build under GNU/Linux, if you can.

If you have managed to get a successful Windows build for a recent Hedgewars build, please get in touch with us (Try the forums, for example:

Things to download

First of all, please use this guide over here ( to see whether your OS is 32 or 64 bit. You will need it while doing the setup.

  1. CMake - download the Windows (Win32 Installer)
  2. FreePascal? - download the Download as installer
  3. Qt SDK - Select the online installer, as it will save you ~1 GB of bandwidth. Nokia will also require you to register an account to download it.
  4. Mercurial - pick one (TortoiseHg has a GUI and is more user-friendly)
    1. TortoiseHg? - Chose one based on your OS version
  5. Command-line mercurial
  6. Windows building archive - it contains everything you need to compile Hedgewars on Windows.


  1. Install CMake, but please ensure you select "Add CMake to the system PATH for all users", so you can run CMake directly from command line.
  2. Install FreePascal.
  3. Install Qt SDK, with the "Custom" option:
    • Click the DESELECT ALL button. We will then check only what we need
    • Check Qt SDK/Miscellaneous/MinGW <any version>
    • Check Qt SDK/Development Tools/Desktop Qt/Qt <newest version>/Desktop Qt <newest version> - Mingw
    • !!If there are any error message boxes, just press ignore until they are all gone. :)
  4. Install TortoiseHg? / Mercurial
  5. Restart the computer
  6. Download the Hedgewars source:
    1. Using TortoiseHg?
  7. Using command-line Mercurial
    • If you have Windows 7 skip the next 3 steps, and instead, SHIFT + Right click in the folder where you want to download the source.
    • Start Run... ( WINDOWS Key + R , or Start -> Run... )
    • Enter:
  • Navigate to where you want to download the source
  • Type and execute ( The initial clone of the repository will take a while, is about 550MiB or so... ):
hg clone trunk
  1. Navigate to the where you cloned the repository source to.
  2. Go to the "tools/build_windows.bat" file, and modify the following:
    • SET PASCAL=<put the path to the directory that contains fpc's executable (fpc.exe)> (for example: c:\FPC\2.4.4\bin\i386-win32\)
    • SET SET QTDIR=<path to the QtSDK\Desktop\Qt\<your version>> (for example: c:\QtSDK\Desktop\Qt\4.8.1\)
  3. You can now build hedgewars, by running the tools/build_windows.bat command.
  4. After building it, you can run it from the Desktop - using the Hedgewars shortcut.

Additional setup for Visual Studio 2010

To build Hedgewars using Visual Studio 2010, you will need to update a few SDL files using this zip file ( Just download and overwrite it into your currect hedgewars project folder. This is mainly an update to SDL_mixer (updating it to version 1.2.12), and changing the SDLconfig.h file to work with the sperate platform headers instead of the current one.

Next you will need to change some project settings. If you don't have the SDL directives set correctly in CMake then your project files will be incorect (they still may be incorrect even if you did get them set right). You need to change the following Project Settings for the 'hedgewars' project.

  1. Make sure that under C/C++ => Additional Include Directories you have \hedgewars\misc\winutils\include\.
  2. Change the Linker => Input => Additional Dependencies option to have the following at the end:
    • \hedgewars\misc\winutils\lib\SDL.lib
    • \hedgewars\misc\winutils\lib\SDLmain.lib
    • \hedgewars\misc\winutils\lib\SDL_mixer.lib
  3. Adjust the Output Directory under the General settings to be just \hedgewars\bin\.

Building process

Run the tools/build_windows.bat file each time you want to build the source. Please note that there might some incompatibilities with the environment paths of this script in case that you are running MinSYS or Cygwin: we are quite confident that if you use such software you're quite able to correctly set up any paths.