Mac OS HoMM3 installer

• Prerequisites
• Install
• How to run the game after the install process
• Contribute
• Good to know
• Alternative install method
• Uninstall
• Copyright

This short script helps you installing and running Heroes of Might and Magic 3, HoMM3 HD edition and Horn of the Abyss (HotA) on your older Macbooks. I recommend you to download the two offline HoMM3 installer files (~1 GB) from gog.com (I assume you have the game).

The project's goal is to automatize this well-written install guide.

Prerequisites

• A Macbook with Yosemite, El Capitan, Sierra, High Sierra or Mojave with the latest OS update. If you are using Catalina or Big Sur, check this method.
• Downloaded HoMM3 offline installer files from gog.com.

Install

1 - Open the Terminal (hit Command+Space -> type Terminal and hit Enter).

<p align="center"> <a href="assets/images/open_terminal.png"><img src="assets/images/open_terminal.png" width="400" alt="Open the Terminal" /></a> </p>

2 - Enter the following command:

/bin/bash -c "$(curl -H 'Cache-Control: no-cache' -fsSL https://raw.githubusercontent.com/Peneheals/ihhh/master/install_homm3.sh)"

<p align="center"> <a href="assets/images/curl_run.png"><img src="assets/images/curl_run.png" width="400" alt="Run the script" /></a> </p>

How to run the game after the install process

1. Just open the Terminal (see above how).

2. Enter the below command:

   cd "$HOME/.wine/drive_c/GOG\ Games/HoMM\ 3\ Complete" && wine HD_Launcher.exe
   

3. Check for updates with the "Update" button and install it if you found any!

4. If the basic settings (resolution etc.) look OK, create the HD.exe with the "Create HD exe" button!

5. Now you are ready to play! The above steps are not necessary in the future, just start the launcher in the Terminal with the above command in step #2 (or push the up key for the last executed commands) and hit the "Play" button!

Contribute

If you have any feedback (feature requests, bug reports, problems etc.), feel free to open an issue here. Please upload any related screenshots (maybe to Imgur) and link them in the issue.

Good to know

1. The installer uses common and existing tools:
   1. Brew, to install necessary packages.
   2. Wine, to run the Windows-based game in Mac.
   3. HD mod and HotA.
   4. Planned: this or this to download the offline installer files from GoG.
2. We do not store nor send any credentials to any 3rd party (except gog.com in a future release).
3. Planned: Linux support!

Alternative install method

1 - Download the code.

<p align="center"> <a href="assets/images/download_zip.png"><img src="assets/images/download_zip.png" width="400" alt="Download the code" /></a> </p>

2 - Click on it to unzip.

<p align="center"> <a href="assets/images/open_zip.png"><img src="assets/images/open_zip.png" width="400" alt="Unzip the package" /></a> </p>

3 - Check that it is in the right place (I assume your downloads go to your home's Downloads folder).

<p align="center"> <a href="assets/images/unzipped_zip.png"><img src="assets/images/unzipped_zip.png" width="400" alt="Check the files" /></a> </p>

4 - Open the Terminal (hit Command+Space -> type Terminal and hit Enter).

<p align="center"> <a href="assets/images/open_terminal.png"><img src="assets/images/open_terminal.png" width="400" alt="Open the Terminal" /></a> </p>

5 - Run the script with ~/Downloads/ihhh-master/install_homm3.sh command.

<p align="center"> <a href="assets/images/run_script.png"><img src="assets/images/run_script.png" width="400" alt="Run the script" /></a> </p>

Uninstall

Use with precaution! It will wipe everything!!!

• Brew and all formulas and casks,
• Wine and all your Wine-installed programs,
• HoMM3 and every expansion,
• and all your saved games!

curl -H 'Cache-Control: no-cache' -fsSL https://raw.githubusercontent.com/Peneheals/ihhh/master/install_homm3.sh | bash -s -- -u

To uninstall just your HoMM3 related stuff (deleting your ~/.wine directory), use this:

curl -H 'Cache-Control: no-cache' -fsSL https://raw.githubusercontent.com/Peneheals/ihhh/master/install_homm3.sh | bash -s -- -uh3

Copyright

TODO