fheroes2(6)

NAME
fheroes2 - free remake of the Heroes of Might and Magic II game engine

SYNOPSIS
fheroes2

DESCRIPTION
fheroes2 is a free implementation of the Heroes of Might and Magic II game engine, a classic turn-based strategy game, with significant improvements in gameplay, graphics and logic (including support for high-resolution graphics, improved AI, numerous fixes and UI improvements).

To play the game, the assets from the demo version or the full version of the original Heroes of Might and Magic II game are needed.

GAME DATA PATHS

  The engine assets are searched for in the following directories:

/usr/share/games/fheroes2
    System-wide data directory that can be accessed by all users.

$FHEROES2_DATA
    This environment variable may contain the path to a custom assets directory.

Game engine executable directory
    Directory containing the executable file used to run the engine.

$HOME/.local/share/fheroes2
    Per-user data directory. This path can be overridden by XDG_DATA_HOME environment variable.

  The structure of engine assets is as follows:

anim/*.smk
anim2/*.smk
heroes2/anim/*.smk
    Video files of the original game.

data/*.agg
    Assets of the original game (required).

files/data/*.h2d
    Additional non-original assets from the fheroes2 project. These assets are inextricably linked to a specific version of the engine, and must be updated when the engine version changes.

files/lang/*.mo
    Translations of the fheroes2 project into different languages.

files/soundfonts/*.sf2
files/soundfonts/*.sf3
    Additional SoundFont files for the MIDI synthesizer.

files/timidity/timidity.cfg
    Configuration file for the TiMidity MIDI synthesizer.

files/timidity/instruments/*.pat
    GUS patches (samples of musical instruments) for the TiMidity MIDI synthesizer.

maps/*.fh2m
    Map files in the fheroes2 format.

maps/*.h2c
maps/*.hxc
    Campaign map files.

maps/*.mp2
maps/*.mx2
    Map files in the original game format.

music/*.flac
music/*.mp3
music/*.ogg
    Music tracks ripped from the original game CD. These tracks should be named as homm2_XX.ext or TrackXX.ext where XX is a track number and ext is an extension. Numeration starts from 01 for the homm2_ prefix and from 02 for the Track prefix.

ENVIRONMENT

FHEROES2_DATA
    See the section GAME DATA PATHS above.

FILES

$HOME/.config/fheroes2
    This directory contains per-user configuration files. fheroes2.cfg is for game options and fheroes2.key is for hotkeys. This path can be overridden by the XDG_CONFIG_HOME environment variable.

$HOME/.local/share/fheroes2/files/save
    This directory contains per-user save files.