How to build VCMI (Windows/Cmake)
From VCMI Project Wiki
Contents
Prerequisites
- HoMM 3 (can be bought at gog.com)
- Git or git GUI, for example, SourceTree download
- Libraries pack download
If you want to use Visual Studio compiler
If you want to use MinGW compiler
- Boost libraries source code download (<=1.55, Boost 1.56 has error and incompatible)
Create initial directory
Create a directory for VCMI development, eg. C:\VCMI We will call this directory as [VCMIBUILD_DIR]
It is recommended to avoid non-ascii characters in the path to your VCMI development folder. The folder should not be write-protected by system. Good location:
- C:\VCMI
Bad locations:
- C:\Users\Michał\VCMI (non-ascii character)
- C:\Program Files (x86)\VCMI (write protection)
Preparing place
Clone VCMI
- open SourceTree
- File -> Clone
- select https://github.com/vcmi/vcmi/ as source
- select [VCMIBUILD_DIR]/vcmi/source as destination
- click Clone
Install Boost bundle (only for MSVC)
- Run installer
- Select [VCMIBUILD_DIR]/boost as destination folder
- Install
Install Qt bundle
- Run installer
- Select latest Qt for mingw or msvc
- If you want to compile using MinGW, select latest MinGW version
- Select [VCMIBUILD_DIR]/qt as destination folder
- Install
- Add [VCMIBUILD_DIR]/Qt/Tools/mingw530_32/bin to PATH system variable.
Unpack libraries
- Download libraries pack and unpack it in [VCMIBUILD_DIR]/depends folder
So, you should get
- [VCMIBUILD_DIR]
- depends
- bin
- include
- lib
- share
- depends
Compiling (MinGW)
Create toolchain file
Create [VCMIBUILD_DIR]/toolchain.txt
SET(CMAKE_SYSTEM_NAME Windows) SET(VCMIBUILD_DIR [ENTER YOUR VCMIBUILD_DIR PATH]) SET(CMAKE_C_COMPILER ${VCMIBUILD_DIR}/Qt/Tools/mingw530_32/bin/gcc.exe) SET(CMAKE_CXX_COMPILER ${VCMIBUILD_DIR}/Qt/Tools/mingw530_32/bin/g++.exe) SET(ENV{BOOST_ROOT} ${VCMIBUILD_DIR}/boost) SET(CMAKE_FIND_ROOT_PATH ${VCMIBUILD_DIR}/depends) list(APPEND CMAKE_PREFIX_PATH ${CMAKE_FIND_ROOT_PATH}) list(APPEND CMAKE_PREFIX_PATH ${VCMIBUILD_DIR}/Qt/5.7/mingw530_32) SET(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM BOTH) SET(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY BOTH) SET(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE BOTH)
Compile boost
- Unpack boost archive
- Execute
bootstrap.bat mingw b2 toolset=gcc --without-python --stage
- copy stage/lib to [VCMIBUILD_DIR]/boost/lib
- copy boost dir to [VCMIBUILD_DIR]/boost/boost
So, you should get
- [VCMIBUILD_DIR]
- boost
- boost
- lib
- boost
Compile VCMI
- Open CMake-gui
- Select [VCMIBUILD_DIR]/vcmi/source as source directory
- Select [VCMIBUILD_DIR]/vcmi/binary as binary directory
- click "Configure"
- Select "MinGW makefiles" in combobox
- Select "Specify toolchain file for crosscompiling"
- Select toolchain file
- Set variables:
- CMAKE_INSTALL_PREFIX = [VCMIBUILD_DIR]/vcmi/result
- ENABLE_PCH = OFF (because of cc1plus.exe crash)
- click Configure
- click Generate
- go to [VCMIBUILD_DIR]/vcmi/binary directory
- execute mingw32-make
- execute mingw32-make install
- Grab VCMI in [VCMIBUILD_DIR]/vcmi/result folder!
Compiling (MSVC)
Create toolchain file
Create [VCMIBUILD_DIR]/toolchain.txt
SET(CMAKE_SYSTEM_NAME Windows) SET(VCMIBUILD_DIR [ENTER YOUR VCMIBUILD_DIR PATH]) SET(CMAKE_C_COMPILER cl) SET(CMAKE_CXX_COMPILER cl) set(CMAKE_RC_COMPILER rc) SET(ENV{BOOST_ROOT} ${VCMIBUILD_DIR}/boost) SET(ENV{BOOST_LIBRARYDIR} ${VCMIBUILD_DIR}/boost/lib32-msvc-14.0) SET(CMAKE_FIND_ROOT_PATH ${VCMIBUILD_DIR}/depends) list(APPEND CMAKE_PREFIX_PATH ${CMAKE_FIND_ROOT_PATH}) list(APPEND CMAKE_PREFIX_PATH ${VCMIBUILD_DIR}/Qt/5.7/msvc2015) SET(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM BOTH) SET(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY BOTH) SET(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE BOTH)
Compile VCMI
- Open CMake-gui
- Select [VCMIBUILD_DIR]/vcmi/source as source directory
- Select [VCMIBUILD_DIR]/vcmi/binary as binary directory
- click "Configure"
- Select "Visual Studio 12 2013" in combobox
- Select "Specify toolchain file for crosscompiling"
- Select toolchain file
- Set variables:
- CMAKE_INSTALL_PREFIX = [VCMIBUILD_DIR]/vcmi/result
- click Configure
- click Generate
- go to [VCMIBUILD_DIR]/vcmi/binary directory
- open VCMI.sln in visual studio
- select "Release" build type in combobox
- right click on BUILD_ALL project - build project
- right click on INSTALL project - build project
- Grab VCMI in [VCMIBUILD_DIR]/vcmi/result folder!
Appendix A. Libraries compilation
How to compile ZLib yourself
- Unpack archive to temp folder, for example, [VCMIBUILD_DIR]/zlib/src
- Open CMake-gui
- Select [VCMIBUILD_DIR]/zlib/src as source directory
- Select [VCMIBUILD_DIR]/zlib/bin as binary directory
- click "Configure"
- Select "MinGW makefiles" in combobox
- Select "Specify toolchain file for crosscompiling"
- Select toolchain file
- Set variables:
- INSTALL_BIN_DIR = [VCMIBUILD_DIR]/depends/bin
- INSTALL_INC_DIR = [VCMIBUILD_DIR]/depends/include
- INSTALL_LIB_DIR = [VCMIBUILD_DIR]/depends/lib
- INSTALL_MAN_DIR = [VCMIBUILD_DIR]/depends/share/man
- INSTALL_PKGCONFIG_DIR = [VCMIBUILD_DIR]/depends/share/pkgconfig
- click Configure
- click Generate
- go to [VCMIBUILD_DIR]/zlib/bin directory
- execute mingw32-make
- execute mingw32-make install
Compile FFmpeg (MinGW)
- Download FFmpeg source tarball(link) and unpack it to temp folder, for example, [VCMIBUILD_DIR]/ffmpeg/source
- Download Msys2 (link) and install it
- Open Msys2
- execute
pacman -Syu
and close Msys2 - run
autorebase.bat
and start Msys2 - execute
pacman -S make pkg-config yasm
- Go to /c/[VCMIBUILD_DIR]/ffmpeg/source folder
- Execute
./configure --disable-doc --target-os=mingw32 --enable-shared --prefix=/c/[VCMIBUILD_DIR]/depends make make install
Compile FFmpeg (MSVC)
- Download Msys2 32-bit (download link) and install it to [VCMIBUILD_DIR]/msys
- Download FFmpeg source tarball (download link) and unpack it to temp folder, for example, [VCMIBUILD_DIR]/ffmpeg/source
- Open Visual Studio console ( C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\Tools\Shortcuts\VS2013 x86 Native Tools Command Prompt.lnk )
- Open [VCMIBUILD_DIR]/msys/msys2_shell.bat
- execute
pacman -S yasm
- Go to /c/[VCMIBUILD_DIR]/ffmpeg/source folder
./configure --toolchain=msvc --target-os=win32 --enable-shared --prefix=/c/[VCMIBUILD_DIR]/depends make make install