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.

                                                   April 2025                                        fheroes2(6)