Skip to content

Latest commit

 

History

History
201 lines (137 loc) · 5.16 KB

INSTALL.md

File metadata and controls

201 lines (137 loc) · 5.16 KB
Raw

Building and installing Hedgewars

This file explains to you how to build/compile Hedgewars and how to install it.

See also: https://hedgewars.org/kb/BuildingHedgewars

Dependencies

Hardware dependencies

See README.md.

Core dependencies

To compile and install Hedgewars, you need at least:

  • A C++ compiler (e.g. GCC)
  • CMake >= 2.6.0
  • A make program (e.g. GNU Make)
  • Free Pascal Compiler (FPC) >= 2.2.4
  • Qt 5
  • SDL >= 2.0
  • SDL_net >= 2.0
  • SDL_mixer >= 2.0
  • SDL_image >= 2.0
  • SDL_ttf >= 2.0
  • PhysFS >= 3.0.0

On FreeBSD, you also need the package “fpc-rtl-extra”.

Recommended optional dependencies

These are not strictly required to build Hedgewars, but it's usually better to have them installed. Hedgewars has fallback mechanisms in if these are not found on your system.

  • Lua = 5.1.0

Optional dependencies

For some additional features, you can optionally install these dependencies:

  • For PNG screenshots:
    • libpng >= 1.2
  • For video recording:
    • FFmpeg or Libav
  • For the Hedgewars Server:
    • GHC >= 6.10
    • Various Haskell packages (see below)

Lua will be automatically built if not found.

Hedgewars Server dependencies

The Hedgewars Server is an optional separate application. It provides the online lobby and allows players to create rooms. You will also be able to launch the server from the frontend (network play → local network → start server).

Most players do not need this!

To compile it, you need:

  • Glasgow Haskell Compiler (GHC) >= 6.10
  • These Haskell packages:
    • containers
    • vector
    • bytestring
    • network >= 2.3
    • random
    • time
    • mtl >= 2
    • sandi
    • hslogger
    • process
    • deepseq
    • utf8-string
    • SHA
    • entropy
    • zlib >= 0.5.3 and < 0.7
    • regex-tdfa
    • binary >= 0.8.5.1

Building

Summary

To build and install Hedgewars, obtain all dependencies, then run:

$ cmake . $ make

make install

Step 1: Configure

For a default install with all dependencis, use this command:

$ cmake .

To build with a custom install directory, instead run:

$ cmake -DCMAKE_INSTALL_PREFIX="<install_prefix>" .

(Replace <install_prefix> with the directoy in which you want Hedgewars to be installed.)

Add the -DNOSERVER=ON switch if you do not want to build the server.

CMake options

For more detailed build settings, change some CMake options. Run ccmake for an interactive way to edit them.

Important CMake options:

  • CMAKE_INSTALL_PREFIX: Installation directory
  • NOSERVER: Set to ON to not build the server
  • NOVIDEOREC: Set to ON to not build the video recorder
  • GHC_DYNAMIC: Set to ON to build dynamically-linked haskell object files and executables (needed for some distributions)

Step 2: Make

Run:

$ make

This creates the following files:

  • bin/hedgewars: Hedgewars
  • bin/hwengine: Game engine, can be used to play demos and saved games
  • bin/hedgewars-server: Hedgewars Server (optional)

Step 3: Installation

To install Hedgewars to the install directory run:

# make install

That's all! Enjoy!

Troubleshooting

Qt is installed but it can't be found

If this happens, set the following CMake option:

QT_QMAKE_EXECUTABLE="<path_to_qmake>"

(Replace <path_to_qmake> with the path to the qmake application.)

If this didn't work, make sure you have the correct Qt version (see above).

Broken/missing Haskell dependencies

First, try to obtain the missing Haskell packages and make sure GHC is up-to date, then try again. Read the error messages carefully to figure out missing package names.

If everything fails and you don't need the server, set the CMake option NOSERVER=ON so the server isn't built at all.

Error messages related to libavcodec / libavformat

Update Libav or FFmpeg (whatever is present on your system) to the latest version or install one of them if you haven't already. Then try to build again.

If this still doesn't work and you give up, set the CMake option NOVIDEOREC=ON, but then the video recording functionality will not be available.

Error messages related to Lua, “undefined reference to `lua_tonumber'”, and so on

If you get error messages like these:

  • /home/username/hw/hedgewars//uScript.pas:226: undefined reference to `lua_tonumber'
  • /home/username/hw/hedgewars/CMakeFiles/hwengine.dir/uScript.o: In function `LUATOVISUALGEARTYPEORD':

There might be something wrong with your Lua installation. Try to install Lua 5.1. If this doesn't work, or you don't want to install Lua 5.1, try to build Hedgewars with the bundled Lua version.

To build with the bundled Lua version, adding the CMake option SYSTEM_LUA=OFF, then repeat the building process.

Cleaning up

In case you want to start over and start with a clean build, run make clean, then go back to step 2.

If things got seriously out of hand, you may want to reset everything (even your configuration). If you use the Mercural repository, you can run hg purge --all. Proceed with step 1.

Still can't build Hedgewars?

Visit us in the forums or IRC (see README.md) and ask for help.