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: SDK 2.22.1 (latest stable)
  • Caelum: version 0.6.1 at least, has to be compatible with Ogre 1.7/1.8
  • mygui: svn revision 4344 (specific SVN version)
  • mysocketw: latest
  • ogre: 1.7.x or 1.8.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-8
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


svn co my-gui -r 4344
cd my-gui
cmake -DFREETYPE_INCLUDE_DIR=/usr/include/freetype2/ \
make -j2
sudo make install
cd ..

For Ubuntu 12.04 ppa is available:

wget -q -O - | sudo apt-key add -
sudo sh -c 'echo "deb precise-getdeb games" >> /etc/apt/sources.list.d/getdeb.list'
sudo apt-get update
sudo apt-get install libmygui3 libmygui-dev

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


hg clone -r 3b0f1afccf5cb75c65d812d0361cce61b0e82e52 caelum 
cd caelum
make -j2
sudo make install
cd .. 
# important step, so the plugin can load:
sudo ln -s /usr/local/lib/ /usr/local/lib/OGRE/

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 30th Dec, 2014
  • 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/
  • Ubuntu 10.4 32 bit --tdev 00:13, 24 June 2010 (UTC)
  • Ubuntu 10.10 64 bit --User:berserk9779 09:09 25 January 2011 (GMT-3)

All dependencies compile fine at the time of writing, but another issue prevents from me from running the game and properly test things out at this time.

All dependencies compiled fine, but RoR svn version 1603 had a broken selector/menu, but 0.37.126 from sourceforge worked.

  • Gentoo 64 bit (x86_64) no-multilib, 2.6.36-gentoo-r5
    • --Tdev 12:04, 19 March 2011 (UTC)
    • --Tdev 11:53, 13 February 2011 (UTC)
    • --Tdev 17:56, 25 March 2011 (UTC)
      • fixed caelum installation instructions: compiling from source now
    • note: on gentoo you need to fix the installation prefix of all packages from /usr/local to /usr/
  • Gentoo 32 bit 3.2.12-gentoo - more details at User:mudrd8mz
  • Linux Mint 10 (Ubuntu 10.10) 64 bit--User:KingBeetle 03:04 03 March 2011 (GMT-5)
    • Had to change install prefix in makefile for Hydrax from /usr to /usr/local
  • Debian Squeeze (Debian 6) 64 bit User:woozy 13 April 2011:
    • Also had to change install prefix in makefile for Hydrax from /usr to /usr/local. Edited the wiki to incorporate the change
  • Debian Squeeze (/etc/debian_version "6.0.3", amd64, x86_64 GNU/Linux)
    • User:beardy Sat Jan 28 18:42:15 CET 2012 Building instructions worked.

(please extend)

About Rigs of Rods

    Rigs of Rods is a unique soft body physics simulator.

Some Tools


Follow us

Twitter youtube Facebook RSS Feed