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)

CMake flags

Flag	Meaning
`-DCMAKE_BUILD_TYPE=Debug`	Debug build
`-DCMAKE_BUILD_TYPE=Release`	Release build
`-DCMAKE_BUILD_TYPE=RelWithDebInfo`	Release build with debug symbols
`-DWITH_BETTER_RENDERER=ON/OFF`	Enable/disable NVRHI-based renderer

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

Windows

# 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

Linux

# 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.

Installing

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.

Known Issues

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.

Support

Issues: https://github.com/eu07/maszyna/issues
Developer chat: https://milek7.pl:8065/eu07/channels/dev
Project page: https://eu07.pl/

Minimum requirements

OS: Windows 10 64-bit
Processor: 2 core at least 2 GHz (e.g. Intel Core i3-2100 / AMD Athlon II X2)
RAM: 6 GB RAM
Graphics Card: supporting OpenGL 3.3 with at least 1GB VRAM
150 GB of free disk space
Sound card supporting OpenAL with stereo
Optional COM ports for custom control panel setups.

License

Source code: MPL 2.0
Assets: Custom license

Languages

C++ 63.9%

C 32.6%

HLSL 2.3%

GLSL 0.8%

CMake 0.4%

README.md Unescape Escape

MaSzyna Train Simulator

Table of Contents

Getting Started

Prerequisites