2015-11-03 17:21:08 -05:00
|
|
|
# SuperTuxKart Installation Instructions
|
2014-01-17 11:02:53 -05:00
|
|
|
|
2016-05-14 17:17:13 -04:00
|
|
|
Note: If you obtained this source code from Github, you also need to download
|
|
|
|
the game assets from Sourceforge using SVN.
|
2014-01-17 11:02:53 -05:00
|
|
|
|
|
|
|
`svn checkout https://svn.code.sf.net/p/supertuxkart/code/stk-assets stk-assets`
|
|
|
|
|
|
|
|
Place the `stk-assets` folder next to the source root `stk-code` folder.
|
2016-06-28 18:27:15 -04:00
|
|
|
See <https://supertuxkart.net/Source_control> for more information
|
2014-01-17 11:02:53 -05:00
|
|
|
|
|
|
|
|
2015-11-03 17:21:08 -05:00
|
|
|
## Building STK on Linux
|
2014-01-17 11:02:53 -05:00
|
|
|
|
|
|
|
First, make sure that you have the following packages installed:
|
|
|
|
|
|
|
|
* OpenGL (mesa)
|
|
|
|
* OpenAL (recommended: openal-soft-devel)
|
|
|
|
* Ogg (libogg-dev)
|
|
|
|
* Vorbis (libvorbis-dev)
|
2016-04-24 21:18:37 -04:00
|
|
|
* Freetype (libfreetype6-dev)
|
2014-01-17 11:02:53 -05:00
|
|
|
* libcurl (libcurl-devel)
|
|
|
|
* libbluetooth (bluez-devel)
|
2015-01-18 20:44:10 -05:00
|
|
|
* libpng (libpng-devel)
|
|
|
|
* zlib (zlib-devel)
|
|
|
|
* jpeg (libjpeg-turbo-devel)
|
2014-01-17 11:02:53 -05:00
|
|
|
|
|
|
|
Ubuntu command:
|
|
|
|
|
2014-01-17 12:31:15 -05:00
|
|
|
```
|
2016-05-14 17:17:13 -04:00
|
|
|
sudo apt-get install build-essential cmake libbluetooth-dev \
|
|
|
|
libcurl4-gnutls-dev libfreetype6-dev libfribidi-dev libgl1-mesa-dev \
|
|
|
|
libjpeg-dev libogg-dev libopenal-dev libpng-dev libvorbis-dev libxrandr-dev \
|
|
|
|
mesa-common-dev pkg-config zlib1g-dev
|
2014-01-17 12:31:15 -05:00
|
|
|
```
|
2014-01-17 11:02:53 -05:00
|
|
|
|
|
|
|
Unpack the files from the tarball like this:
|
|
|
|
|
2014-01-17 12:31:15 -05:00
|
|
|
```
|
|
|
|
tar xzf supertuxkart-*.tar.gz
|
|
|
|
cd supertuxkart-*
|
|
|
|
```
|
2014-01-17 11:02:53 -05:00
|
|
|
|
|
|
|
where `*` is the version of SuperTuxkart you downloaded - eg `0.8.0`. Then:
|
|
|
|
|
|
|
|
|
|
|
|
Compile SuperTuxKart:
|
|
|
|
|
2014-01-17 12:31:15 -05:00
|
|
|
```
|
|
|
|
mkdir cmake_build
|
|
|
|
cd cmake_build
|
|
|
|
cmake ..
|
|
|
|
make VERBOSE=1 -j2
|
|
|
|
```
|
2014-01-17 11:02:53 -05:00
|
|
|
|
|
|
|
To create a debug version of STK, use:
|
|
|
|
|
2015-11-03 17:21:08 -05:00
|
|
|
```
|
|
|
|
cmake .. -DCMAKE_BUILD_TYPE=Debug
|
|
|
|
```
|
2014-01-17 11:02:53 -05:00
|
|
|
|
|
|
|
To test the compilation, supertuxkart can be run from the build
|
|
|
|
directory by ./bin/supertuxkart
|
|
|
|
|
|
|
|
To install the file, as root execute:
|
|
|
|
|
2015-11-03 17:21:08 -05:00
|
|
|
```
|
|
|
|
make install
|
|
|
|
```
|
2014-01-17 11:02:53 -05:00
|
|
|
|
|
|
|
The default install location is `/usr/local`, i.e. the data files will
|
|
|
|
be written to `/usr/local/share/games/supertuxkart`, the executable
|
|
|
|
will be copied to `/usr/local/bin`. To change the default installation
|
|
|
|
location, specify `CMAKE_INSTALL_PREFIX` when running cmake, e.g.:
|
|
|
|
`cmake .. -DCMAKE_INSTALL_PREFIX=/opt/stk`
|
|
|
|
|
|
|
|
|
2015-11-03 17:21:08 -05:00
|
|
|
## Building STK on OS X
|
2016-06-28 18:27:15 -04:00
|
|
|
See <https://supertuxkart.net/Building_and_packaging_on_OSX>
|
2014-01-17 11:02:53 -05:00
|
|
|
|
|
|
|
|
2015-11-03 17:21:08 -05:00
|
|
|
## Building STK on Windows
|
2016-06-28 18:27:15 -04:00
|
|
|
See <https://supertuxkart.net/How_to_build_the_Windows_version>
|