Freeserf

Build status

Play

Copy the data file(s) from the original game to the same directory as freeserf. Alternatively you can put the data file in ~/.local/share/freeserf. You may use data file(s) from DOS or Amiga game version.

• DOS data file is called SPAE.PA, SPAD.PA, SPAF.PA or SPAU.PA, depending on the language of the game.
• Amiga files gfxheader, gfxfast, gfxchip, gfxpics, sounds, music.

Keyboard gameplay controls:

• 1, 2, 3, 4, 5: Activate one of the five buttons in the panel.
• b: Toggle overlay showing possibilities for constructions.
• TAB/SHIFT-TAB: Open next notification message; or return from last message.
• +/-: Increase/decrease game speed.
• 0: Reset game speed.
• p: Pause game.
• j: Switch player.

Other keyboard controls:

• F10: Return to main menu to start a new game
• s: Enable/disable sounds playback
• m: Enable/disable music playback
• CTRL+f: Switch fullscreen mode on/off.
• CTRL+z: Save game in current directory.
• [/]: Zoom -/+

Audio

To play back the sound track that is included in the original data files, SDL3_mixer has to be enabled at compile-time. The music of the Amiga data (MOD) needs no more setup. The MIDI music of the DOS data is played by FluidSynth with a General MIDI SoundFont: the build downloads TimGM6mb (GPL-2, about 6 MB) and installs it next to the program (CMake option ENABLE_SOUNDFONT). FreeSerf also finds TimGM6mb.sf2 next to the game data, and SDL_SOUNDFONTS selects any other .sf2 file. See the SDL3_mixer documentation for more information.

Save games

To load a save game file:

$ freeserf -l FILE

Freeserf will (try to) load save games from the original game, as well as saves from freeserf itself. The game is paused after loading so press p to start the game.

Run freeserf -h for more info on command line options.

Bugs

Please report bugs at https://github.com/freeserf/freeserf/issues.

Development

The main source repository for this project is at https://github.com/freeserf/freeserf. See the HACKING document in the source code root for information on how to compile and how to contribute.