Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
You can download and compile the Rigs of Rods sources completely with tools that are available for free.
Download and install all required software first:
- Visual Studio 2017 Community
- Latest RoR sources: https://github.com/RigsOfRods/rigs-of-rods/archive/master.zip (alternatively you can clone them with git from https://github.com/RigsOfRods/rigs-of-rods.git)
(restart your computer after installing all the above tools)
Setting up the environment
Since 0.39.2 it is possible to build Rigs of Rods under Windows with precompiled dependencies for 32 bit and 64 bit. Depending on what you compile, some steps might slightly differ. Also, you can only build x64 (64-bit version) on a real 64-bit platform. However, you can still build x86 (32 bit) on a 64-bit platform due to backwards compatibility.
Preparing the source code
- Create an empty directory anywhere where you have enough free disk space (~3 GB) for example, we chose this now:
- Unpack the file master.zip into that directory. It will create a new directory called
- Rename unpacked
Installing the dependencies
Create a folder called
Open a PowerShell window in the build folder (Shift + right click --> Open PowerShell window here)
Setup Conan with
Add the ror-dependencies and bincrafters-public remote to conan with
conan remote add ror-dependencies https://api.bintray.com/conan/anotherfoxguy/ror-dependencies conan remote add bincrafters-public-conan https://api.bintray.com/conan/bincrafters/public-conan
conan install --build=missing ..to install the dependencies
Start cmake from the Windows start menu: START-->Programs-->CMake-->cmake-gui
Where is the source code:
Where to build the binaries:
- Click the
Visual Studio 15 2017 Win64and
Use default native compilers.
- Click the
yesif it asked if the directory should be created.
Configuretwice until all entries are white
Generateand close CMake
Compiling the source code
Navigate in Windows Explorer to the folder
C:\dev\rigsofrods-source\buildand open the file RoR.sln. Visual Studio should open. (if you are asked, open with Visual Studio for C++)
In Visual Studio, do the following: from the menu: Build -> build Solution.
The compilation is done when you can read something like the following in the bottom text output window:
========== Build: succeeded ==========
Done! After building you will find RoR ready to use in the bin\Release directory. You can navigate with the Windows Explorer to
C:\dev\rigsofrods-source\bin\Release\ and use it the same way as game directory if it was installed there.
Note: the only difference is that the resources will reside one directory higher, but RoR should figure that out itself.
- If the compile step is ok but you don't see any executable or the log writes some missing libs, it may be something wrong with the linking step.
- It may happen that RoR won't start in the bin directory. Simply put the new executable into main release folder and try launch from there. If it doesn't, you simply missed something.
- These compile steps and hints are valid only with Visual Studio and Windows, although they may be similar for other configurations.
- If you need any help compiling or have any other questions, join our discord(https://discord.gg/rigsofrods) and ask your question in the #dev channel