How to build VCMI (macOS)

From VCMI Project Wiki
Revision as of 13:05, 2 May 2014 by Stopiccot (talk | contribs) (Prerequisites)
Jump to: navigation, search


  • Xcode. Can be downloaded from Mac App Store.
  • CMake. Can be downloaded from (link) or installed from Homebrew/MacPorts
  • Any git client you prefer.

Preparing place

  • Unzip downloaded archive
  • Open terminal and go to extracted xcode-pack directory
  • Checkout source via git:
git clone
  • Open vcmibuilder.xcodeproj located at vcmi/osx/osx-vcmibuilder
  • Archive it (Product -> Archive) and than (in Organizer window press Distribute -> Export as: Application) save it in vcmi/osx directory


  • Open terminal in vcmi directory:
mkdir build && cd build
cmake -G Xcode ..
  • Open generated Xcode project vcmi.xcodeproj
  • Select vcmiclient in list of targets and press Run (Command + R)