Compiling SLUDGE on Debian/Ubuntu

There are generic instructions how to compile SLUDGE in the INSTALL file which is included in the source archieve. The following instructions describe the installation of SLUDGE on Debian or Ubuntu a little bit more detailed. If you keep in mind that other distributions may have other ways to gain root privileges (than sudo, use su on Debian), other packaging management tools (than apt-get) and other package names, these instructions should help you installing SLUDGE on any Linux distribution.

Dependencies

First you have to make shure that a graphics driver with 3D acceleration is installed.

Then install the following dependencies from the repositories:

build-essential (compilers and build tools)
libalure-dev (>= 1.1)
libsdl1.2-dev
libglew-dev
libglu1-mesa-dev
libpng12-dev
libopenal-dev
libvorbis-dev
libflac-dev
libdumb1-dev
libvpx-dev
xdg-utils
libgtk2.0-dev (only needed for the Dev Kit)
libgtkglext1-dev (only needed for the Dev Kit)

Package list for copying:

sudo apt-get install build-essential libalure-dev libsdl1.2-dev libglew-dev libglu1-mesa-dev libpng12-dev libopenal-dev libvorbis-dev libflac-dev libdumb1-dev libvpx-dev xdg-utils

The additional dependencies for the Dev Kit:

sudo apt-get install libgtk2.0-dev libgtkglext1-dev

Installing SLUDGE

Now it's time to download the SLUDGE source archieve (sludge-*-source.tar.gz) from the GitHub releases page and extract, compile und install the program.

cd path/to/sludge-(version)

./configure                     # install only the Engine
                                # or
./configure --enable-devkit     # install Engine and Dev Kit

make

sudo make install

Getting the latest development version

In order to get the latest bugfixes, it can sometimes be necessary to install the latest development version. This requires that the packages git and automake are installed.

The code can be cloned using:

git clone https://github.com/opensludge/opensludge.git

Before SLUDGE can be compiled as described above, the configure script has to be generated using the autogen.sh script:

cd opensludge

./autogen.sh

OpenGL ES 2

SLUDGE 2.2 has experimental support for OpenGL ES 2. This means it should work on mobile devices such as smartphones without much effort. To use OpenGL ES 2 on Debian or Ubuntu, the dependencies libglew-dev and libglu1-mesa-dev are replaced by libgles2-mesa-dev and configuring is done by

./configure --enable-gles2