Compiling 3rd party libraries

From Rigs of Rods Wiki

Jump to:navigation, search


This is the first step needed for packaging RoR so it can be included in a Linux repository, since this will allow you to package and update each component of RoR individually. The motivation for writing this article is that some devs (including the initial author of this page) feel that dealing with the current cmake system is too cumbersome as the 3rd party library should rarely if ever be altered, and thus not included in the source tree.

You can find shell scripts that summarize all steps into one script here: Ubuntu/Debian/Mint


Libraries required for RoR:

  • AngelScript: 2.22.1
  • Caelum: version >= 0.6.2, compatible with Ogre 1.9
  • mygui: latest
  • mysocketw: latest
  • ogre: 1.9.x
  • OIS: 1.3 (any version >= 1.2 should work)
  • openal-soft >= 1.8.466 (older versions could work)
  • paged geometry: latest
  • wxWidgets >= 2.6 (older versions could work)
  • (Hydrax >= 0.5.2) -> included in RoR's source tree


  • replace -j2 parameter after make with the appropriate CPU core number (if unsure use the number which "grep -c processor /proc/cpuinfo" prints)
  • when using sudo, be prepared to enter your password. Sudo is used to install the compiled software most of the time.
  • on gentoo you need to change the installation prefix of all packages to /usr instead of the default /usr/local (EDIT: not really, see this page for more info. At that page, slightly different versions are reported to work, too)


These sections are listed in the order they should be done. Ogre should be done first since several of the other libraries require that it is installed such as Caelum, MyGUI, and Paged Geometry

it is recommended to create a dependencies directory and work in that:

mkdir ~/ror-deps
cd ~/ror-deps


You will need freeimage for Ogre. Its not a direct Dependency of RoR. if your distribution does not have a package for freeimage, you have to compile it by hand:

wget -O
cd FreeImage
make -j2
sudo make install
cd ..


sudo apt-get install libfreeimage-dev


Let's start off with Ogre since it is required by other libraries.

Ogre3D is the graphic engine RoR uses.

hg clone -b v1-9
cd ogre
cmake \
-DFREETYPE_INCLUDE_DIR=/usr/include/freetype2/ \
make -j2
sudo make install
cd ..

DON'T FORGET THE " ." after "...BOOL=OFF"


Handles user input, included in some distributions' repositories.

build latest SVN:

svn co ois-trunk
cd ois-trunk
bash bootstrap
make -j2
sudo make install
cd ..


  • you may need to comment out "export WANT_AUTOMAKE='1.7'" to "#export WANT_AUTOMAKE='1.7'" in the file bootstrap


sudo apt-get install libois-dev


git clone
cd mygui
git pull
cmake \
-DFREETYPE_INCLUDE_DIR=/usr/include/freetype2/ \
make -j2
make install
cd ..

Paged Geometry

git clone
cd ogre-paged
make -j2
sudo make install
cd ..
since there is no uninstall script run this to remove PagedGeometry
sudo rm /usr/local/lib/
sudo rm -rf /usr/local/include/Paged


git clone
cd caelum
git pull
cmake .
make -j2
make install
# important step, so the plugin can load:
sudo ln -s /usr/local/lib/ /usr/local/lib/OGRE/
cd ..

since there is no uninstall script run this to remove Caelum

sudo rm /usr/local/lib/libCaelum.a
sudo rm -rf /usr/local/include/Caelum


NOTE: You have to install the OpenSSL development package before you compile. In Ubuntu and Debian run
sudo apt-get install libssl-dev
, in CentOS run
yum install libssl-dev
git clone
cd mysocketw
make -j2 shared
sudo make install
cd ..

since there is no uninstall script run this to remove SocketW

sudo rm /usr/local/lib/libSocketW*
sudo rm /usr/local/include/SocketW.h
sudo rm /usr/local/include/sw_*.h


OpenAL usually is provided by your distribution's repository.


sudo apt-get install libopenal1 libopenal-dev


RoR needs wxWidgets version 2.6 at least. Should be available in most repositories.


sudo apt-get install libwxgtk3.0-dev


Important: Hydrax is included in RoR's source tree at the moment so this step is not needed but kept for reference.

If you get errors running the make command on e.g. Debian and Ubuntu, you might need to change the makefile. Uncomment the lines marked below:

git clone
cd CommunityHydrax
# make fails on some distributions. If that is the case, use this command instead:
# make -j2 PREFIX=/usr/local
make -j2
sudo make install
cd ..


mkdir angelscript
cd angelscript
unzip angelscript_*.zip
cd sdk/angelscript/projects/gnuc
SHARED=1 VERSION=2.22.1 make -j2 --silent
# sudo make install fails when making the symbolic link, this removes the existing versions
rm -f ../../lib/*
sudo SHARED=1 VERSION=2.22.1 make install
#cleanup files made by root
rm -f ../../lib/*
cd ../../../../../

LUA (deprecated)

LUA scripting support was removed from Rigs of Rods in SVN revision 1899.
You only need to install this if you use an older Rigs of Rods revision.

You need version 5.1+ which is provided by many distributions.


sudo apt-get install liblua5.1-0 liblua5.1-0-dev

Compiling RoR

see Compiling_Sources_under_Linux

Verification of the instruction on this page

  • Ubuntu 14.04.1 64 bit -- User:Hiradur 15th Sep, 2015
  • Ubuntu 12.04 64 bit --User:emgiezet 14:14, 9 Oct 2012 (GMT+1) - cannot install MyGUI, libois (OIS) is available from apt-get repo
  • Ubuntu 11.10 64 bit --User:Blackthorn 22:37, 01 June 2012 (GMT-7) plugins.cfg is in the wrong location, it can be found in /ror-trunk/tools/linux/binaries/ it should be in /ror-trunk/bin/

(please extend)