ALPHA version - expect chaos
Instructions for building Hedgewars on Mac OS X
Updated Sun, 17 Jan 2016 12:54:56 +0000 by Wuzzy

Building on Mac OS X


  • XCode must be installed with command line tools
  • some knowledge of Terminal is preferred


  1. it has been reported that Xcode 3.2.6 creates problem when linking frameworks! If you can't use another version, try this:
  2. for Xcode 4 onwards, you need to install the command line tools: open Xcode, go to Preferences, select "Downloads" and install the "Command Line Tools".
  3. for Qt series 4.7, only versions 4.7.0 and 4.7.4 are not suffering from this bug any other version will not work with online games.
  4. Lion has an incompatible ABI with older version of Freepascal! Use only the new Freepascal version 2.6.0 or newer. See

Necessary libraries

Download the following libraries and place them under /Library/Frameworks/

Optional libraries

The following libraries are optional:

Compiling Ogg Vorbis

Since there is no framework distribution for ogg vorbis libraries, we will need to compile our own. Extract the sources and open the relative .xcodeproj file.

It is likely that you will need to adjust some parameters, such as the Base SDK you have installed and for which architecture (ppc, i386, x86_64) you want to build. Go into "Project"->"Edit Project Settings", under "Build" set Architectures to Standard and Base SDK to 10.5 (otherwise newer).

After that build as usual and copy the generated framework to the usual /Library/Frameworks/ directory.

(Optional) Server

If you want to compile server for hosting lan games, you need to download a Haskell compiler: we are going to use the Glasgow Haskell Compiler.

sudo cabal install gameServer/hedgewars-server.cabal

Necessary tools

Download and install the following toolchains

Building process

  • download the source tarball or clone the hg repo
  • configure the sources with the following line
cmake . -DQT_QMAKE_EXECUTABLE=/usr/bin/qmake -DCMAKE_BUILD_TYPE=Release
  • run make and make install