Go to file
Duncan a01bd32132
Construction Window ToolUpdate (#1119)
* Start Implementing track tool update

* Further work

* Finish function

* Fix bugs

* Fix view issue

* Extract out common function

* Implement road tool update
2021-08-26 21:42:41 +01:00
.github CI improvements (#1107) 2021-08-15 13:18:19 +01:00
cmake Compile macOS builds (32-bit) using osxcross (#924) 2021-08-12 23:03:25 +02:00
data/language Allow filtering the vehicle list by station or cargo (#997) 2021-06-26 11:12:20 +02:00
distribution Add .desktop file for Linux 2021-01-03 12:52:58 +01:00
dockerfiles Remove Boost from Fedora Dockerfile. 2020-03-19 00:55:49 +01:00
resources Titlecasev files openloco (#604) 2020-09-07 06:42:02 +01:00
scripts rename Thirdparty/FileSystem.hpp (#619) 2020-09-11 08:07:54 +01:00
src Construction Window ToolUpdate (#1119) 2021-08-26 21:42:41 +01:00
.clang-format Update .clang-format for new version of clang-format 2020-03-17 21:02:25 +00:00
.editorconfig Add .editorconfig file (#777) 2021-02-20 19:51:53 +01:00
.gitignore Add CMake build/ directory to gitignore 2020-06-20 10:49:24 +02:00
CHANGELOG.md Fix caption 22 widget text rendering (#1124) 2021-08-23 10:47:48 +02:00
CMakeLists.txt Compile macOS builds (32-bit) using osxcross (#924) 2021-08-12 23:03:25 +02:00
CMakeLists_mingw.txt Add mingw toolchain file for cmake 2018-01-29 00:00:53 +01:00
CONTRIBUTORS.MD zh-CN: add Simplified Chinese translation (#979) 2021-05-21 23:02:18 +02:00
LICENSE Update license to reflect project state. (#281) 2019-02-24 22:54:39 +00:00
README.md Mention code style in readme (#1047) 2021-07-10 08:49:54 +02:00
docker-compose.yml Use OpenLoco's docker images 2020-03-18 23:38:10 +01:00
loco.exe Cleanup loco.exe file (#6) 2018-01-21 13:18:43 +00:00
nuget.config Add nuget.config (#855) 2021-03-27 15:27:17 +00:00
openloco.common.props Add breakpad to MSVC builds 2021-06-19 23:45:44 +02:00
openloco.sln Rename /src/OpenLoco folder (#624) 2020-09-13 22:15:38 +01:00

README.md

OpenLoco

An open source re-implementation of Chris Sawyer's Locomotion. A construction and management simulation video game that simulates running a transport company.


Contents


Build Status

Windows / Linux Download
master CI GitHub release

Chat

Feel free to join our Discord server to talk about developing the game, or for help getting it to run.

Discord

1 Introduction

OpenLoco is an open-source re-implementation of Chris Sawyer's Locomotion (CSL). CSL is the spiritual successor to Transport Tycoon and OpenLoco aims to improve the game similar to how OpenTTD improved Transport Tycoon and OpenRCT2 improved RollerCoaster Tycoon.

Chris Sawyer's Locomotion was originally written by Chris Sawyer in x86 assembly, building on top of his RollerCoaster Tycoon 2 engine. Much of the code is 1:1 with RollerCoaster Tycoon 2. However, the engine has changed substantially enough that OpenLoco currently does not share its codebase with OpenRCT2.

Recent implementation efforts have focussed on re-implementing the UI, so that the data structures involved may be better understood. Once this is done, it is our hope the game logic will be easier to understand and implement.


2 Downloading the game (pre-built)

The latest releases can be downloaded from GitHub. Releases are currently provided for Windows and macOS (32-bit only). For Linux and BSD distributions, we currently do not provide any builds. Please refer to the next section to compile the game manually.

Please note that OpenLoco requires the asset files of the original Chris Sawyer's Locomotion to play the game. It can be bought at e.g. Steam or GOG.com.


3 Contributing

We warmly welcome any contributions to the project, e.g. for C++ code (game implementation, bug fixes, features) or localisation (new translations). Please have a look at our issues for newcomers.

For code contributions, please stick to our code style. You can use clang-format to apply these guidelines automatically.


4 Compiling the game

If you would like to contribute code to OpenLoco, please follow the instructions below to get started compiling the game. Alternatively, we have platform-specific guides for Ubuntu and macOS.

If you just want to play the game, you can just download the latest release from GitHub. Releases are currently provided for Windows and macOS (32-bit only).

4.1 Building prerequisites

Regardless of platform, the following libraries/dependencies are required:

Windows

Linux / macOS

  • cmake
  • make or ninja
  • 32-bit versions of the libraries mentioned above

4.2 Compiling and running

Windows:

  1. Check out the repository. This can be done using GitHub Desktop or other tools.
  2. Open a new Developer Command Prompt for VS 2019, then navigate to the repository (e.g. cd C:\GitHub\OpenLoco).
  3. Run msbuild openloco.sln /t:restore;build
  4. Run mklink /D bin\data ..\data or xcopy data bin\data /EIY
  5. Run mklink openloco.exe bin\ or copy openloco.exe bin\
  6. Run the game, bin\openloco

Linux / macOS:

The standard CMake build procedure is to install the required libraries, then:

mkdir build
cd build
CXXFLAGS="-m32" cmake ..
make

Running the game will need the data directory from the root of the source code next to the binary. Assuming you're in $SRC/build,

ln -s ../data
OR
cp -r ../data ./data 

5 Licence

OpenLoco is licensed under the MIT License.


6 More information