Revision as of 12:00, 13 September 2022

Download and install VCMI

• Release 1.0.0 (recommended): https://github.com/vcmi/vcmi/releases/tag/1.0.0
• Daily builds (might be unstable)
  • Intel (x86_64) builds: https://builds.vcmi.download/branch/develop/macOS/intel
  • ARM builds: https://builds.vcmi.download/branch/develop/macOS/arm

If the app doesn't open:

• if error message says VCMI is damaged and must be moved to Trash, then open Terminal, paste the following command and press Return (note that you might have other path than /Applications/VCMI.app):

xattr -d com.apple.quarantine /Applications/VCMI.app

• otherwise, right-click the app bundle - select Open menu item - press Open button

Please report about gameplay problem on forums: Help & Bugs

If your problem is Mac-specific: DMG corrupted or if it doesn't start please use following topic:

• VCMI for macOS

Make sure to specify what hardware and macOS version you use.

Installing Heroes III data files

• Find a way to unpack Windows Heroes III or GOG installer. For example, install the game with CrossOver or Wineskin.

• Copy "Data", "Maps" and "Mp3" from Heroes III to:

~/Library/Application\ Support/vcmi/

Connect to the mod repository (optional)

• If that's your first installation, connection to the mod repository will be configured automatically, you'll see mods available to install from VCMI launcher
  • We recommend you to install VCMI extras to support different screen resolutions and active various helpful UI tools
  • If you don't see mods available to install, go to settings tab of the launcher and make sure that you have correct link in "repositories" text field:
    • https://raw.githubusercontent.com/vcmi/vcmi-mods-repository/develop/github.json