Zurück zum Portfolio
🇩🇪 Deutsch 🇺🇸 English

🚌 Mercedes eCitaro Stream Deck Plugin

Version 1.0.2 • Stream Deck Plugin • Open Source (MIT)
Zum GitHub Repository

📝 Über das Projekt

Ein spezialisiertes Stream Deck Plugin für den Mercedes-Benz eCitaro in The Bus. Nutzt die Mercedes-spezifische Telemetrie-API mit invertierter Boolean-Logik und eigenen Event-Namen. Basierend auf dem TML Studios Plugin, erweitert von BlackMautz.

✨ Mercedes-spezifische Features

🚪 Türverriegelung

Links/Rechts unabhängig mit visuellem Status-Feedback

🚦 Lichtschalter

3-Wege Drehschalter mit 6 Positionen (Aus → Fernlicht → Nebel)

🛑 Auto Kneeling

Automatisches Absenken mit invertierter Boolean-Logik

💡 Innenbeleuchtung

Gedimmt (30%) und Hell (100%) Toggle-Buttons

🎮 Alle Features

🚪 Türsteuerung

  • Door 1-4 - Einzelne Türen öffnen/schließen
  • Türverriegelung Links - Alle linken Türen verriegeln (mit Status)
  • Türverriegelung Rechts - Alle rechten Türen verriegeln (mit Status)
  • Türfreigabe - Öffnungserlaubnis für hintere Türen
  • Türautomatik - Automatisches Türschließen

💡 Lichtschalter

Erstelle 3 Buttons für volle Kontrolle - wie ein echter Drehschalter:

  • Lichtschalter Links - Zeigt die nächste Position
  • Lichtschalter Status - Zeigt die aktuelle Position
  • Lichtschalter Rechts - Zeigt die vorherige Position

Icons ändern sich automatisch je nach Position: Aus → Standlicht → Abblendlicht → Fernlicht → Nebelscheinwerfer vorne → Nebelscheinwerfer hinten

🚦 Bremsen

  • Feststellbremse (Fixing Brake) - Parkbremse mit Icon-Status
  • Haltestellenbremse (Stop Brake) - Mit 2-State Icon-Wechsel

🔄 Kneeling-System

  • Auto Kneeling - Automatisches Kneeling an Haltestellen
  • Kneeling Toggle - Manuelle Steuerung
  • Heben/Senken - Plattform-Lift-Kontrolle

💡 Innenbeleuchtung

  • Interior Light Gedimmt - Schaltet zwischen Normal (Aus) und Gedimmt (30%)
  • Interior Light Hell - Schaltet zwischen Normal (Aus) und Hell (100%)
  • Driver Light - Fahrerbeleuchtung umschalten

⚙️ Weitere Features

  • Gangwahl (D/N/R)
  • Zündung
  • Wechselgeldsystem
  • Ticket-Verkaufsstatus
  • Klimaanlage-Steuerung
  • Fenstersteuerung
  • Scheibenwischer
  • Hupe & Lichthupe
  • Kamera-Umschaltung
  • Info-Displays (Speed, Motor, Fuel, Passengers)

📥 Installation

1. Plugin installieren

Lade die .streamDeckPlugin Datei herunter und führe einen Doppelklick aus. Die Stream Deck Software installiert es automatisch.

2. Telemetrie in The Bus aktivieren

  1. Starte "The Bus"
  2. Gehe zu Einstellungen → Aktiviere "Telemetrie-Schnittstelle"
  3. Starte das Spiel neu

3. Stream Deck konfigurieren

  • Füge eine Aktion aus "BlackMautz TML Telemetry - Mercedes" hinzu
  • In den Aktionseinstellungen konfigurieren:
  • Ziel-IP: 127.0.0.1 (oder PC-IP bei Remote-Verbindung)
  • Ziel-Port: 37337 (Standard)

4. Verbindung testen

Füge einen "Connection Status" Button hinzu zur Verbindungsprüfung. Grün = Verbunden, Rot = Getrennt

⚠️ Mercedes API-Besonderheiten

  • Invertierte Boolean-Logik: Einige Buttons (z.B. Auto Kneeling) verwenden invertierte Logik, wobei false = AN
  • Unterschiedliche Event-Namen: Mercedes verwendet andere Event-Namen als Solaris (z.B. ToggleAutomaticRearDoorClosing statt AutoDoorClose)
  • Button-Light-Namen: Verwendet ButtonLight <Name> Format statt <Name> Light

🔄 API-Kompatibilität

  • Unterstützt sowohl Mercedes API (/sendeventpress, /sendeventrelease)
  • Rückwärtskompatibel mit Solaris API (/sendevent)
  • Handhabt gemischte Boolean- und zustandsbasierte Button-Systeme

📄 Lizenz

Basierend auf dem TML Studios Telemetry Plugin, angepasst von BlackMautz für Mercedes-Kompatibilität. Open Source (MIT)

👨‍💻 Credits

  • Original Plugin: TML Studios
  • Mercedes Customization: BlackMautz
Zurück zum Portfolio GitHub Repository

🚌 Mercedes eCitaro Stream Deck Plugin

Version 1.0.2 • Stream Deck Plugin • Open Source (MIT)
GitHub Repository

📝 About the Project

A specialized Stream Deck plugin for the Mercedes-Benz eCitaro in The Bus. Uses the Mercedes-specific telemetry API with inverted boolean logic and custom event names. Based on the TML Studios plugin, extended by BlackMautz.

✨ Mercedes-Specific Features

🚪 Door Locking

Left/Right independent with visual status feedback

🚦 Light Switch

3-way rotary switch with 6 positions (Off → High Beam → Fog)

🛑 Auto Kneeling

Automatic lowering with inverted boolean logic

💡 Interior Lighting

Dimmed (30%) and Bright (100%) toggle buttons

🎮 All Features

🚪 Door Control

  • Door 1-4 - Open/close individual doors
  • Door Lock Left - Lock all left doors (with status)
  • Door Lock Right - Lock all right doors (with status)
  • Door Release - Opening permission for rear doors
  • Door Automatic - Automatic door closing

💡 Light Switch

Create 3 buttons for full control - like a real rotary switch:

  • Light Switch Left - Shows next position
  • Light Switch Status - Shows current position
  • Light Switch Right - Shows previous position

Icons automatically change by position: Off → Parking → Low Beam → High Beam → Front Fog → Rear Fog

🚦 Brakes

  • Parking Brake (Fixing Brake) - Parking brake with icon status
  • Stop Brake - With 2-state icon change

🔄 Kneeling System

  • Auto Kneeling - Automatic kneeling at stops
  • Kneeling Toggle - Manual control
  • Raise/Lower - Platform lift control

💡 Interior Lighting

  • Interior Light Dimmed - Switches between Normal (Off) and Dimmed (30%)
  • Interior Light Bright - Switches between Normal (Off) and Bright (100%)
  • Driver Light - Toggle driver cabin lighting

⚙️ Additional Features

  • Gear selection (D/N/R)
  • Ignition
  • Change dispensing system
  • Ticket sales status
  • Air conditioning control
  • Window control
  • Windshield wipers
  • Horn & light horn
  • Camera switching
  • Info displays (Speed, Engine, Fuel, Passengers)

📥 Installation

1. Install Plugin

Download the .streamDeckPlugin file and double-click it. The Stream Deck software will install it automatically.

2. Enable Telemetry in The Bus

  1. Start "The Bus"
  2. Go to Settings → Enable "Telemetry Interface"
  3. Restart the game

3. Configure Stream Deck

  • Add an action from "BlackMautz TML Telemetry - Mercedes"
  • Configure in action settings:
  • Target IP: 127.0.0.1 (or PC IP for remote connection)
  • Target Port: 37337 (default)

4. Test Connection

Add a "Connection Status" button to check the connection. Green = Connected, Red = Disconnected

⚠️ Mercedes API Specifics

  • Inverted Boolean Logic: Some buttons (e.g. Auto Kneeling) use inverted logic where false = ON
  • Different Event Names: Mercedes uses different event names than Solaris (e.g. ToggleAutomaticRearDoorClosing instead of AutoDoorClose)
  • Button-Light Names: Uses ButtonLight <Name> format instead of <Name> Light

🔄 API Compatibility

  • Supports both Mercedes API (/sendeventpress, /sendeventrelease)
  • Backward compatible with Solaris API (/sendevent)
  • Handles mixed boolean and state-based button systems

📄 License

Based on the TML Studios Telemetry Plugin, adapted by BlackMautz for Mercedes compatibility. Open Source (MIT)

👨‍💻 Credits

  • Original Plugin: TML Studios
  • Mercedes Customization: BlackMautz
Back to Portfolio GitHub Repository