OpenEnroth is an open-source reimplementation of the Might & Magic VI-VIII game engine, allowing you to play the original games on modern platforms. It uses the original game data, so you will need a copy of the game to play.

Currently only MM7 is playable. MM6 and MM8 support is planned — check the milestones to see where we're at.

Supported platforms: Windows, Linux, macOS, and Android (experimental).

Prebuilt binaries are available from our releases page.

Currently only nightly builds are available, which may have bugs. A stable release is in progress — see the v0.1 milestone.

Join our Discord to discuss, track progress, or get involved in development.

You will need two things: the OpenEnroth binary and the original Might and Magic VII game data.

You can buy Might and Magic VII from GOG.com. Copies from other sources (e.g. an original retail disc) should also work.

At the very least, OpenEnroth requires the ANIMS, DATA, MUSIC and SOUNDS directories from the game data.

Install or extract your copy of the game as normal.

On Windows, run the GOG installer to extract the game data to your computer.

The installer cannot be run directly on Linux and macOS, but you can use innoextract to extract its contents.

• On macOS, install Homebrew if you don't have it already and run brew install innoextract
• On Linux, the exact command depends on your distribution:
  • Ubuntu or Debian-based (including Linux Mint, Pop!OS, etc): sudo apt install -y innoextract
  • Fedora or other RedHat-based (except "immutable" distributions like Bazzite): sudo dnf install -y innoextract
  • For other systems, Repology lists the package name for most distributions.

Once you have innoextract, run:

innoextract -e -d <new game data directory> <path to GOG installer .exe>

You can set an environment variable called OPENENROTH_MM7_PATH to point to the location of the game data. If set, OpenEnroth will look for game assets only in that location. You may want to add this to your shell profile (e.g. ~/.profile on Linux or ~/.zshrc on Mac):

export OPENENROTH_MM7_PATH="<path-to-mm7-game-assets>"

1. Download one of the prebuilt releases and unzip the files.
2. Copy OpenEnroth.exe and OpenEnroth.pdb to the directory containing the game data.
3. Run OpenEnroth.exe.

1. Move the game data to ~/Library/Application Support/OpenEnroth, creating this directory if needed.
2. Download one of the prebuilt releases and unzip the files.
3. Run xattr -rc <extracted-path>/dist/OpenEnroth.app. This clears the quarantine flag — macOS will refuse to launch unsigned binaries without this step.
4. Run OpenEnroth.app.

The Flatpak package is the easiest choice if you aren't using Ubuntu 24.04, or you cannot install system packages on your computer (e.g. on "atomic"/"immutable" distributions like Bazzite or SteamOS).

1. Check for Flatpak support:
   • Run flatpak --version. If you get a version number, you're ready; otherwise visit https://flatpak.org/setup/ for setup instructions.
2. Install OpenEnroth:
   • Download the io.github.openenroth.openenroth_*.flatpak package from the releases page.
   • Run flatpak install --user /path/to/io.github.openenroth.openenroth_*.flatpak.
   • Create ~/.var/app/io.github.openenroth.openenroth/data/mm7/data/
   • Move the game data (at least ANIMS, DATA, MUSIC and SOUNDS) into this new directory.
3. Run OpenEnroth from your application menu or using flatpak run io.github.openenroth.openenroth.

The loose executable is better if you want direct access to the binary (e.g. for development), or need full control over install location. Requires Ubuntu 24.04 or a distribution with compatible system libraries.

1. Install required libraries: sudo apt-get install libdwarf1 libelf++* libgl1 (Ubuntu 24.04). For other distributions, check your package manager for equivalent packages.
2. Download a prebuilt release and unzip it.
3. Copy the game data (ANIMS, DATA, MUSIC and SOUNDS) next to the OpenEnroth executable.
4. Run OpenEnroth (you may need chmod a+x OpenEnroth first).

Android is not actively tested by the dev team — expect issues and be prepared to troubleshoot.

1. Download openenroth-release.apk from the releases page.
2. Install the APK on your device (you will need to allow installation from unknown sources in your device settings).
3. Copy the game data (ANIMS, DATA, MUSIC and SOUNDS) to /sdcard/Android/data/io.github.openenroth.openenroth/files/ on your device.

See HACKING.md for build instructions, code style guidelines, and contribution guidelines.