BSO Docs

Alles, was du für BSO – Bus Simulator Online brauchst: Installation, Freunde und Lobby, Spielen.

Erste Schritte

Voraussetzungen: Windows 10/11 (64 Bit), Bus-Simulator 2012 über Steam und die .NET 10 Runtime (x64) – die Mod braucht sie, der Launcher prüft das und zeigt den Download an.

Setup herunterladen (BSO-Launcher-Setup.exe) und starten. Der Assistent fragt nach Sprache, Ordner (Standard %LocalAppData%\Programs\BSO Launcher) und Verknüpfungen – ohne Admin-Rechte.
Konto erstellen oder anmelden.
Mod herunterladen – oder einfach spielen, der Launcher installiert sie dann selbst.
Unter Freunde Freunde hinzufügen, eine Lobby erstellen und zusammen spielen.

Warnt Windows beim ersten Start vor einem unbekannten Herausgeber (SmartScreen): Weitere Informationen → Trotzdem ausführen. Die Datei ist (noch) nicht signiert.

Launcher

Spielen – Status von Spiel, BSO-Mod und .NET-Runtime. Mod herunterladen holt jederzeit die neueste Mod.
Freunde – Freunde, Anfragen und deine Lobby (siehe unten).
Neuigkeiten – Änderungen der letzten Versionen von Mod und Launcher.
Einstellungen – Sprache (Deutsch/Englisch), Launcher und BSO automatisch aktualisieren, Nach Updates suchen, Launcher offen lassen, Spielordner, Deinstallieren.

Updates sind mit dem BSO-Release-Schlüssel signiert. Der Launcher installiert nur geprüfte Dateien – auch wenn jemand den Download-Server übernehmen würde. Gibt es beim Start einen neuen Launcher, installiert er sich gleich selbst und startet neu; neue BSO-Versionen kommen beim Start und vor jedem Spielstart. Beides lässt sich in den Einstellungen abschalten.

Freunde & Lobby

Freunde hinzufügen: unter Freunde den BSO-Benutzernamen eingeben. Der andere nimmt die Anfrage an. Ein grüner Punkt heißt: gerade online.
Lobby erstellen und Freunde mit Einladen dazuholen. Sie sehen die Einladung im Launcher und treten bei.
Wer die Lobby erstellt hat, drückt SPIELEN: Damit startet der Server der Lobby auf dem BSO-Relay – niemand muss etwas hosten oder Ports im Router freigeben.
Danach drücken die anderen SPIELEN: Bus-Simulator 2012 startet und verbindet automatisch mit dem Server der Lobby.

Wer die Lobby erstellt hat, kann Mitglieder entfernen und die Lobby auflösen. Ist 15 Minuten niemand aus der Lobby online, wird sie geschlossen; der Server stoppt, sobald keiner mehr drauf ist. Bricht die Verbindung im Spiel ab, verbindet BSO alle 10 Sekunden von selbst neu.

Im Spiel

Oben links steht die BSO-Anzeige: deine Position, ob du zu Fuß oder im Bus bist, und darunter alle Mitspieler mit Entfernung und Tempo. Mitspieler siehst du in der Welt als Bus bzw. Spielfigur mit Namensschild.

BSO läuft in der 64-Bit-Version des Spiels (Steam startet sie auf 64-Bit-Windows automatisch).

Tasten

Taste	Was
F9	BSO-Anzeige ein/aus
F10	Alle Objekte der Szene in eine Datei schreiben (Diagnose)
F11	Vollbild im Fenster ↔ normales Fenster (wenn im Spiel „Vollbild“ aus ist)

Konto

Mit deinem BSO-Konto meldest du dich im Launcher an; der Benutzername ist dein Name im Spiel. Unter Profil kannst du E-Mail und Passwort ändern, angemeldete Geräte abmelden und dein Konto löschen. Passwörter liegen nur als Hash auf dem Server, die Anmeldung im Launcher bleibt 30 Tage gespeichert.

Probleme?

Problem	Lösung
„Bus-Simulator 2012 nicht gefunden“	Im Launcher den Spielordner wählen (der Ordner mit `Bin_High_Win64`).
„.NET 10 Runtime fehlt“	.NET Runtime 10 (x64) installieren.
Keine BSO-Anzeige im Spiel	`Bin_High_Win64\BSO\BSO_Loader.txt` ansehen – dort steht, wie weit BSO gekommen ist.
SPIELEN in der Lobby ist grau	Der Server läuft noch nicht – er startet, sobald der Ersteller der Lobby auf SPIELEN drückt.
„Kein Zugang zu dieser Lobby“	Im Launcher in der Lobby neu auf SPIELEN drücken (das Ticket gilt nur für die Lobby, in der du gerade bist).
„Nicht über den BSO Launcher gestartet“	Das Spiel im Launcher mit SPIELEN starten – nur so bekommt BSO dein Konto.
„Spiel-Ticket abgelaufen“	Das Ticket gilt 24 Stunden: Spiel beenden und im Launcher neu starten.
BSO lässt sich nicht aktualisieren	Erst das Spiel schließen – solange es läuft, sind die Dateien gesperrt.
Launcher-Fenster bleibt weiß	WebView2-Runtime installieren.

BSO entfernen: im Launcher unter Einstellungen → BSO deinstallieren oder Windows-Einstellungen → Apps.

Für Entwickler

BSO-Mod – Mod (C#, .NET 10) und Loader (dinput8.dll, C++)
BSO-Launcher – Launcher
BSO-Website – diese Website: Konten, Freunde, Lobbys, Releases
BSO-Relay – die Lobby-Server, über WebSocket ohne Portfreigabe

Die Mod hängt sich über eine Proxy-dinput8.dll ins Spiel, startet .NET und ruft die Havok Vision Engine über ihre exportierten Funktionen auf – Spieldateien werden nicht verändert.

BSO Docs

Everything you need for BSO – Bus Simulator Online: installation, friends and lobby, playing.

Getting started

Requirements: Windows 10/11 (64-bit), Bus-Simulator 2012 on Steam and the .NET 10 Runtime (x64) – the mod needs it, the launcher checks for it and shows the download.

Download the setup (BSO-Launcher-Setup.exe) and start it. The wizard asks for language, folder (default %LocalAppData%\Programs\BSO Launcher) and shortcuts – no admin rights needed.
Create an account or sign in.
Download mod – or just play, the launcher then installs it by itself.
Under Friends add friends, create a lobby and play together.

If Windows warns about an unknown publisher on first start (SmartScreen): More info → Run anyway. The file is not signed (yet).

Launcher

Play – status of the game, the BSO mod and the .NET runtime. Download mod fetches the latest mod at any time.
Friends – friends, requests and your lobby (see below).
News – changes in the latest versions of mod and launcher.
Settings – language (German/English), update launcher and BSO automatically, check for updates, keep the launcher open, game folder, uninstall.

Updates are signed with the BSO release key. The launcher only installs verified files – even if someone took over the download server. If there is a new launcher on start, it installs itself right away and restarts; new BSO versions come on start and before every game start. Both can be turned off in the settings.

Friends & lobby

Add friends: enter their BSO username under Friends. The other player accepts the request. A green dot means: online right now.
Create a lobby and bring friends in with Invite. They see the invitation in the launcher and join.
The lobby's creator presses PLAY: this starts the lobby's server on the BSO relay – nobody has to host anything or forward ports in their router.
Then the others press PLAY: Bus-Simulator 2012 starts and connects to the lobby's server automatically.

The lobby's creator can remove members and close the lobby. If nobody from the lobby is online for 15 minutes, it is closed; the server stops as soon as nobody is on it. If the connection drops in the game, BSO reconnects by itself every 10 seconds.

In the game

The BSO display is in the top left: your position, whether you are on foot or in a bus, and below it all other players with distance and speed. You see other players in the world as a bus or character with a name tag.

BSO runs in the 64-bit version of the game (Steam starts it automatically on 64-bit Windows).

Keys

Key	What
F9	BSO display on/off
F10	Write all objects of the scene to a file (diagnostics)
F11	Borderless fullscreen ↔ normal window (when "Fullscreen" is off in the game)

Account

You sign in to the launcher with your BSO account; the username is your name in the game. Under Profile you can change your email and password, sign out devices and delete your account. Passwords are only stored as a hash on the server, the launcher sign-in is kept for 30 days.

Problems?

Problem	Solution
"Bus-Simulator 2012 not found"	Choose the game folder in the launcher (the folder containing `Bin_High_Win64`).
".NET 10 Runtime missing"	Install the .NET Runtime 10 (x64).
No BSO display in the game	Look at `Bin_High_Win64\BSO\BSO_Loader.txt` – it shows how far BSO got.
PLAY in the lobby is greyed out	The server is not running yet – it starts as soon as the lobby's creator presses PLAY.
"No access to this lobby"	Press PLAY in the lobby in the launcher again (the ticket only works for the lobby you are in right now).
"Not started via the BSO Launcher"	Start the game with PLAY in the launcher – that is the only way BSO gets your account.
"Game ticket expired"	The ticket is valid for 24 hours: quit the game and start it again from the launcher.
BSO cannot be updated	Close the game first – the files are locked while it runs.
Launcher window stays white	Install the WebView2 Runtime.

Removing BSO: in the launcher under Settings → Uninstall BSO or in Windows Settings → Apps.

For developers

BSO-Mod – mod (C#, .NET 10) and loader (dinput8.dll, C++)
BSO-Launcher – launcher
BSO-Website – this website: accounts, friends, lobbies, releases
BSO-Relay – the lobby servers, over WebSocket without port forwarding

The mod hooks into the game through a proxy dinput8.dll, starts .NET and calls the Havok Vision Engine through its exported functions – no game files are changed.