This repository is no longer actively maintained.

👉 The project has been moved to:
https://github.com/MaSzyna-EU07/maszyna

Please update your bookmarks and follow the new repository for ongoing development.

A free, Polish train simulator.

Website · Report an issue · Dev chat

MaSzyna executable source code is licensed under the MPL 2.0 and comes with a large pack of free assets under a custom license.

• Getting Started

  • Prerequisites

  • CMake flags

  • Windows

  • Linux

• Installing

• Known Issues

• Support

• License

MaSzyna compiles and runs natively on Linux and Windows. Other platforms are not tested.

Heads-up
Our dev team is small; we keep improving the build process, but issues may still occur. If you get stuck, please ask on the dev chat.

For runtime requirements see Minimum Requirements.

1) Software (oldest tested in parentheses)

• CMake (3.0)

• make

• A C++ compiler with C++14 support (we use some C++17 features, but older compilers may still work):

  • Windows: Visual Studio 2022

  • Linux: GCC (12.3.1)

Note: MinGW is currently not supported.

2) Libraries (oldest tested in parentheses)

• GLFW 3.x (3.2.1)
  If a link error occurs, pass -DGLFW3_LIBRARIES="<path>" to CMake.

• GLM (0.9.9.0)

• libserialport (0.1.1)

• libsndfile (1.0.28)

• LuaJIT (2.0.5)

• GLEW (2.1.0)

• libpng (1.6.34)

• OpenAL (1.18.2)

• pthread

• Python 2.7

• Asio (1.12)

3) Graphics API

• OpenGL 3.0 or newer
• DirectX 12 via NVRHI (optional, Windows only, for Better Renderer)

Linux note: WITH_BETTER_RENDERER uses DirectX 12 through NVRHI and is not supported on Linux.

# Clone repository with submodules
git clone --recursive https://github.com/eu07/maszyna.git

cd maszyna

# Init vcpkg
call setup.bat

# Create directory for CMake build files
mkdir build
cd build

# Generate CMake project (replace %CONFIG% with Debug/Release/RelWithDebInfo)
cmake .. -G "Visual Studio 17 2022" -A x64 -DCMAKE_BUILD_TYPE=%CONFIG%

# Build (replace %CONFIG% accordingly)
cmake --build . --config %CONFIG% --parallel

# Install dependencies (Fedora/RHEL family)
sudo dnf install -y \
  @development-tools \
  cmake \
  mesa-libGL-devel \
  glew-devel \
  glfw-devel \
  python2-devel \
  libpng-devel \
  openal-soft-devel \
  luajit-devel \
  libserialport-devel \
  libsndfile-devel \
  gcc \
  g++ \
  wayland-devel \
  wayland-protocols-devel \
  libxkbcommon-devel

# Clone repository with submodules
git clone --recursive https://github.com/eu07/maszyna.git

cd maszyna

# Create directory for CMake build files
mkdir build
cd build

# Generate Makefiles (NVRHI is not supported on Linux)
cmake .. -DWITH_BETTER_RENDERER=OFF

# Compile using all cores
make -j"$(nproc)"

Tip (Ubuntu/Debian): Package names differ; install equivalent build-essential, libgl1-mesa-dev, libglew-dev, libglfw3-dev, python2-dev, libpng-dev, libopenal-dev, libluajit-5.1-dev, libserialport-dev, libsndfile1-dev, and Wayland/X11 dev packages as needed.

There is no make install yet. Copy the built executable to your MaSzyna installation manually.

• Output directory: ./bin

• File name format: eu07_YYYY-MM-DD_<commit>[_d]

  • YYYY-MM-DD – build date

  • <commit> – short commit hash

  • _d – present in Debug builds

If you already have the MaSzyna assets, copy the executable to the install dir. Assets can be downloaded from eu07.pl.

Rainsted on Linux

If Rainsted (a third‑party starter) fails to detect the executable under Linux, you can create a small wrapper script named eu07.exe:

#!/bin/sh
./eu07 "$1" "$2" "$3" "$4" "$5"

If detection still fails, padding the file (with comments) up to ~1 MB may help.

• GLFW linking – On some systems you must provide the GLFW library path explicitly with -DGLFW3_LIBRARIES.

• X11/Wayland linking order – Linking order of X11 and related libs can matter.

• NVRHI on Linux – The NVRHI/"Better Renderer" path targets DirectX 12 and is currently unsupported on Linux.

• Issues: https://github.com/eu07/maszyna/issues

• Developer chat: https://milek7.pl:8065/eu07/channels/dev

• Project page: https://eu07.pl/

• Processor: Intel Core i5-7600 or AMD Ryzen 5 1600
• RAM: 16 GB
• Graphics Card: NVIDIA GeForce GTX 970 or AMD Radeon RX 580
• 75 GB of free disk space
• Sound card supporting OpenAL with stereo
• Optional COM ports for custom control panel setups.

• Source code: MPL 2.0

• Assets: Custom license