openOMSI-org / openOMSI

> [!WARNING]
> **Early development. Expect bugs.** Things may be missing, broken or change between
> versions. Please report problems in Issues
> or on our Discord server.
**openOMSI** is a from-scratch recreation of the bus simulator **OMSI 2**, written in Rust:
64-bit, multithreaded, with a modern renderer (Metal / Vulkan / DirectX 12 through wgpu).
It loads the existing OMSI 2 maps, buses, scenery and mods as they are.
> [!IMPORTANT]
> **openOMSI needs an installed copy of OMSI 2.** It contains no game content of its own: it
> plays on the maps, vehicles and other files of your OMSI 2 and **will not start without one**.
## What you get
* **Your OMSI 2 content, unchanged** - maps, buses, AI traffic, scenery, scripts, timetables,
 HOF files, weather and plugins load the way OMSI 2.2.032 loads them. The OMSI 2 folder is
 never written to.
* **A new engine** - 64-bit (no 2 GB limit), tiles and textures loaded on worker threads,
 four graphics modes from *Vanilla* (looks like OMSI 2) to *Enhanced+* (physically based
 lighting with ray-traced shadows and reflections).
* **A launcher** - pick a map, line, tour, bus and livery on one screen with a route map and a
 live bus preview; mods from a folder or a `.zip`/`.7z`/`.rar`; keys and game controllers
 (wheels, pedals, force feedback); updates on a Stable or Beta channel.
* **Multiplayer** - LAN sessions and a dedicated server (docs/SERVER.md).
* **Every platform** - Windows, macOS, Linux and Android; VR through OpenXR on Windows
 (docs/VR.md).
* **More for modders** - PBR materials, larger textures, more lights, and plugins in Lua or
 compiled `.oop` (Lua or WebAssembly), plus OMSI's own plugin DLLs on Windows.
## Download
The newest stable version is always at
**Releases → Latest** and on the
website. Newer, untested builds are published as
*Pre-release* (beta) on the Releases page.
| Platform | File |
| --- | --- |
| Windows x64 / ARM64 | `openOMSI- -windows-x64-setup.exe` / `-windows-arm64-setup.exe` - installs openOMSI for you, no administrator rights (or the `.zip`: run `openomsi.exe`) |
| macOS (Apple silicon / Intel), macOS 11+ | `openOMSI- -macos-arm64.dmg` / `-macos-x64.dmg` - drag `openOMSI.app` onto Applications (or the `.zip`) |
| Linux x64 / ARM64 | `openOMSI- -linux-x64.zip` / `-linux-arm64.zip` - run `openomsi` |
| Android 8.0+ (arm64) | `openOMSI- -android-arm64.apk` - see docs/ANDROID.md |
| Dedicated server | `openOMSI- -server- - .zip` - see docs/SERVER.md |
`SHA256SUMS` in each release lists the checksums of all files.
The launcher keeps itself up to date: when a newer version is out it offers it at the start
and installs it with your yes. **Settings → General → Updates** chooses the channel (Stable or
Beta), turns the check off or installs without asking.
## Installation
You need **OMSI 2** installed (Steam or retail) with its stock content.
1. **Install** it. On Windows the `-setup.exe` installs openOMSI into your user folder
 (`%LOCALAPPDATA%\Programs\openOMSI`) with a Start me