How to build VCMI (Windows/Vcpkg)

Prerequisites

• HoMM 3 (can be bought at gog.com)
• Microsoft Visual Studio 2017(download)
• Git or git GUI, for example, SourceTree download

Install dependencies

Create initial directory

Create a directory for vcpkg development, eg. C:\vcpkg We will call this directory as [VCPKG_DIR]

It is recommended to avoid non-ascii characters in the path to your vcpkg folder. The folder should not be write-protected by system. Good location:

• C:\vcpkg

Bad locations:

• C:\Users\Michał\vcpkg (non-ascii character)
• C:\Program Files (x86)\vcpkg (write protection)

Clone vcpkg

• open SourceTree
• File -> Clone
• select https://github.com/microsoft/vcpkg/ as source
• select [VCPKG_DIR] as destination
• click Clone

Build vcpkg

• Run [VCPKG_DIR]/bootstrap-vcpkg.bat

Build dependencies

• For 32-bit build run [VCPKG_DIR]/vcpkg.exe install minizip:x86-windows sdl2:x86-windows sdl2-image:x86-windows sdl2-ttf:x86-windows sdl2-mixer:x86-windows boost:x86-windows qt5:x86-windows ffmpeg:x86-windows
• For 64-bit build run [VCPKG_DIR]/vcpkg.exe install minizip:x64-windows sdl2:x64-windows sdl2-image:x64-windows sdl2-ttf:x64-windows sdl2-mixer:x64-windows boost:x64-windows qt5:x64-windows ffmpeg:x64-windows

Build VCMI

Create initial directory

Create a directory for VCMI development, eg. C:\VCMI We will call this directory as [VCMI_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)

Clone VCMI

• open SourceTree
• File -> Clone
• select https://github.com/vcmi/vcmi/ as source
• select [VCMI_DIR]/source as destination
• click Clone

Compile VCMI

• create [VCMI_DIR]/build
• open [VCMI_DIR]/build in terminal
• execute cmake ../source -DCMAKE_TOOLCHAIN_FILE=[VCPKG_DIR]/scripts/buildsystems/vcpkg.cmake -DCMAKE_INSTALL_PREFIX=[VCMI_DIR]/install
• 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 [VCMI_DIR]/install folder!