Difference between revisions of "Installation on macOS"
From VCMI Project Wiki
(recommend using vcmibuilder) |
m |
||
| Line 1: | Line 1: | ||
= Download and install VCMI = | = Download and install VCMI = | ||
| − | * | + | * The latest release (recommended): https://github.com/vcmi/vcmi/releases/latest |
* Daily builds (might be unstable) | * Daily builds (might be unstable) | ||
** Intel (x86_64) builds: https://builds.vcmi.download/branch/develop/macOS/intel | ** Intel (x86_64) builds: https://builds.vcmi.download/branch/develop/macOS/intel | ||
| − | ** | + | ** Apple Silicon (arm64) builds: https://builds.vcmi.download/branch/develop/macOS/arm |
If the app doesn't open: | 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''): | + | * if error message says something like ''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''): |
<nowiki>xattr -d com.apple.quarantine /Applications/VCMI.app</nowiki> | <nowiki>xattr -d com.apple.quarantine /Applications/VCMI.app</nowiki> | ||
* otherwise, right-click the app bundle - select ''Open'' menu item - press ''Open'' button | * otherwise, right-click the app bundle - select ''Open'' menu item - press ''Open'' button | ||
| Line 20: | Line 20: | ||
# Find a way to unpack Windows Heroes III or GOG installer. For example, use <code>vcmibuilder</code> script inside app bundle or install the game with [https://www.codeweavers.com/crossover CrossOver] / [https://github.com/Gcenx/WineskinServer Wineskin]. | # Find a way to unpack Windows Heroes III or GOG installer. For example, use <code>vcmibuilder</code> script inside app bundle or install the game with [https://www.codeweavers.com/crossover CrossOver] / [https://github.com/Gcenx/WineskinServer Wineskin]. | ||
| − | # Copy | + | # Copy (or symlink) '''Data''', '''Maps''' and '''Mp3''' directories from Heroes III to: |
<pre> | <pre> | ||
~/Library/Application\ Support/vcmi/ | ~/Library/Application\ Support/vcmi/ | ||
Revision as of 10:02, 19 October 2022
Download and install VCMI
- The latest release (recommended): https://github.com/vcmi/vcmi/releases/latest
- Daily builds (might be unstable)
- Intel (x86_64) builds: https://builds.vcmi.download/branch/develop/macOS/intel
- Apple Silicon (arm64) builds: https://builds.vcmi.download/branch/develop/macOS/arm
If the app doesn't open:
- if error message says something like 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:
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, use
vcmibuilderscript inside app bundle or install the game with CrossOver / Wineskin. - Copy (or symlink) Data, Maps and Mp3 directories 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:
