Difference between revisions of "Installation on macOS"

From VCMI Project Wiki
Jump to: navigation, search
(recommend using vcmibuilder)
(removed obsolete section about deleting quarantine attribute)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
'''For iOS installation look here: https://wiki.vcmi.eu/Installation_on_iOS'''
 +
 
= Download and install VCMI =
 
= Download and install VCMI =
  
* Release 1.0.0 (recommended): https://github.com/vcmi/vcmi/releases/tag/1.0.0
+
* 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
** ARM builds: https://builds.vcmi.download/branch/develop/macOS/arm
+
** Apple Silicon (arm64) builds: https://builds.vcmi.download/branch/develop/macOS/arm
  
If the app doesn't open:
+
If the app doesn't open, right-click the app bundle - select ''Open'' menu item - press ''Open'' button.
* 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''):
 
<nowiki>xattr -d com.apple.quarantine /Applications/VCMI.app</nowiki>
 
* otherwise, right-click the app bundle - select ''Open'' menu item - press ''Open'' button
 
  
 
Please report about gameplay problem on forums: [https://forum.vcmi.eu/c/international-board/help-bugs Help & Bugs]
 
Please report about gameplay problem on forums: [https://forum.vcmi.eu/c/international-board/help-bugs Help & Bugs]
Line 20: Line 19:
  
 
# 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 "Data", "Maps" and "Mp3" from Heroes III to:
+
# Copy (or symlink) '''Data''', '''Maps''' and '''Mp3''' directories from Heroes III to:
 
<pre>
 
<pre>
 
~/Library/Application\ Support/vcmi/
 
~/Library/Application\ Support/vcmi/

Latest revision as of 10:33, 27 December 2022

For iOS installation look here: https://wiki.vcmi.eu/Installation_on_iOS

Download and install VCMI

If the app doesn't open, 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

  1. Find a way to unpack Windows Heroes III or GOG installer. For example, use vcmibuilder script inside app bundle or install the game with CrossOver / Wineskin.
  2. 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