fheroes2

A recreation of the Heroes of Might and Magic II game engine.

fheroes2 Installation Guide

Requirements

You will need to have a demo version or the full version of Heroes of Might and Magic II game to be able to play. We strongly advise to purchase the original game on GOG or Ubisoft Store platforms.

Alternatively, you can download a free demo version of the game (in English only) using the bundled script. See detailed instructions below.

Installation

Precompiled binaries of the release version are currently available for the following platforms and operating systems:

Alternatively, you can download the precompiled binaries of the latest commit (snapshot) here.

Windows

Windows Installer

Windows ZIP Archive

Troubleshooting Missing Microsoft Visual C++ DLLs

If you see complaints about missing DLLs when running fheroes2, then you may need to install the Microsoft Visual C++ redistributable package.

You can download it using the following URLs:

Windows Version C++ Package
For 64-bit x64 fheroes2 builds https://aka.ms/vs/17/release/vc_redist.x64.exe
for 32-bit x86 fheroes2 builds https://aka.ms/vs/17/release/vc_redist.x86.exe

macOS

Homebrew on macOS

If you are using Homebrew, you can install the game by running the following command:

brew install fheroes2

Follow the instructions below to gather resources necessary for fheroes2 to function as expected.

MacPorts

If you are using MacPorts, you can install the game by running the following command:

port install fheroes2

Then follow the instructions on the screen.

Follow the instructions below to gather resources necessary for fheroes2 to function as expected.

macOS ZIP Archive

Follow the instructions below to gather resources necessary for fheroes2 to function as expected.

macOS Native App

brew bundle --file script/macos/Brewfile.app_bundle

make FHEROES2_MACOS_APP_BUNDLE=ON

Follow the instructions below to gather resources necessary for fheroes2 to function as expected.

Gathering Game Resources

Once you obtain the fheroes2 executable using any of the options above, you should follow these steps to load in the correct resources:

Linux

Flatpak

If you are using Flatpak and Flathub, you can install the game by running the following command:

flatpak install flathub io.github.ihhub.Fheroes2

And launch from the start menu or the console:

flatpak run io.github.ihhub.Fheroes2

Alternatively, you can use an application manager like Discover, which is also available on Steam Deck.

After the first start you will be asked for the original files. There are three possibilities:

  1. Install GOG version (recommended)
  2. Manual install
  3. Install demo

The recommended option requires the Heroes of Might and Magic II installer file (*.exe) from GOG. This will extract the appropriate resources by itself.

For the manual installation you have to copy the subdirectories ANIM, DATA, MAPS and MUSIC from the original game or demo directory to the ~/.var/app/io.github.ihhub.Fheroes2/data/fheroes2 directory. The destination folder will be opened when this option is selected.

Gentoo Package

If you are using Gentoo, you can install the game using package manager. There are several options:

GOG Version

If you purchased the game from GOG, add games-strategy/homm2-gold-gog GOG-EULA line to your /etc/portage/package.license, then use the following command:

sudo emerge -av games-strategy/homm2-gold-gog

It will ask you to put the .exe installer of the game and optionally the zip file with FLAC music to your distfiles directory, and if it’s there, it will unpack everything to the correct places and pull games-engines/fheroes2 as a dependency.

USE-flag flac determines whether the game will use FLAC music or OGG music.

Demo Version

You can install the demo version for free by adding games-strategy/homm2-demo HoMM2-Demo line to your /etc/portage/package.license, then using the following command:

sudo emerge -av games-strategy/homm2-demo

If you installed the game from original CD, use the following commands:

sudo emerge -av games-engines/fheroes2
/usr/share/fheroes2/extract_homm2_resources.sh

The second command (Note: run it without root) will ask you where your data files are.

Homebrew on Linux

If you are using Homebrew, you can install the game by running the following command:

brew install fheroes2

If you have a legally purchased copy of the original game, copy the subdirectories ANIM, DATA, MAPS and MUSIC (some of them may be missing depending on the version of the original game) from the original game directory to the $XDG_DATA_HOME/fheroes2 (usually ~/.local/share/fheroes2) directory. Otherwise, you can download and install the demo version of the original game by running the /usr/share/fheroes2/download_demo_version.sh script.

AUR Package

If you are using Arch Linux or compatible distribution, you can install fheroes2 package from AUR (Arch User Repository).

Install Using AUR Helper

If you use one of AUR helpers, e.g. yay, you can install the game by running the following command:

yay -S aur/fheroes2

Install Using the Official Guide

Follow the official guide. One of possible command sets:

git clone https://aur.archlinux.org/fheroes2.git
cd fheroes2
makepkg -si

Debian and Ubuntu

fheroes2 is available from contrib repositories for Debian (since 13) and Ubuntu (since 24.04). You can install it by running:

apt install fheroes2

These distributions may not provide the latest version of the game due to their release cycle.

Game Resources

To play the game you need the original game resources. You can install them to per-user paths (man fheroes2 for more info, or you can install them to the system-wide path (/usr/share/games/fheroes2) with game-data-packager program (since v70). To make the resource package:

game-data-packager heroes2 <path_to_installed_original_game>
apt install ./homm2-data_<version>_all.deb

You can get more info about resource packaging by running game-data-packager heroes2 --help

Linux ZIP Archive

Android

PlayStation Vita

Please note: you need to be running custom firmware for it to work.

Nintendo Switch

Please note: you need to be running custom firmware for it to work.

Snapshots (Latest Builds)

You can download the precompiled binaries of the latest commit (snapshot)

Platform Version Release
Windows x64 SDL2 fheroes2-windows-x64-SDL2
Windows x86 SDL2 fheroes2-windows-x86-SDL2
macOS x86-64 fheroes2-osx-sdl2_dev
Ubuntu x86-64 fheroes2-linux-sdl2_dev
Ubuntu ARM fheroes2-linux-arm-sdl2_dev
Android fheroes2-android
PlayStation Vita fheroes2-psv-sdl2_dev
Nintendo Switch fheroes2-switch-sdl2_dev

These binaries incorporate all the latest changes, but also all the latest bugs, and are mainly intended for developers.

DON’T EXPECT THEM TO WORK PROPERLY.