Bastelhof - Animated Steering Wheel Plugin

Ingame-Plugin für Euro Truck Simulator 2 und American Truck Simulator zur animierten Lenkradverstellung im Cockpit.

Das Plugin blendet ein kompaktes DirectX-11/ImGui-Overlay ein. Dort können Fahrposition, Parkposition, Animationsdauer, Verzögerung und Easing eingestellt werden. Die Animation kann anhand von Fahrzeugelektrik oder Motorstatus automatisch zwischen Fahr- und Parkposition wechseln.

Aktuelle Version: 0.1.48

Build-Artefakte

Im Repository gilt jetzt eine klare Trennung:

• out/ enthält nur technische CMake-/Compiler-Ausgaben.
• build/ enthält nur fertige auslieferbare Builds.

Die fertigen Pakete liegen so:

build/
├── player/
│   └── 0.1.48/
└── diagnostic/
    └── 0.1.48/

Jeder Variantenordner enthält das fertige Plugin, Dokumentation, Symbole, Checksummen und zusätzlich ein ZIP-Archiv derselben Variante.

Getestet mit:

• Euro Truck Simulator 2 1.60
• Euro Truck Simulator 2 1.61 experimentelle Beta

Funktionen

• Animierte Lenkradposition für Höhe und Tiefe.
• Separate Fahr- und Parkposition.
• Trigger über Fahrzeugelektrik, Motorstatus, Elektrik oder Motor, oder manuell.
• Einstellbare Animationsdauer, Startverzögerung und Easing.
• Live-Ansicht und echte Ingame-Übernahme der Werte.
• Bedienung per Maus sowie per Tastatur mit Tab, Pfeiltasten, Enter und Space.
• Overlay-Hotkey: Numpad 0.
• Eingeklappter Diagnosebereich für Logs, Signaturtest und Fehlersuche.

Installation

1. Spiel vollständig beenden.
2. Die Datei bastelhof_steering_wheel.dll in den Pluginordner kopieren.

ETS2:

Euro Truck Simulator 2/bin/win_x64/plugins/

ATS:

American Truck Simulator/bin/win_x64/plugins/

Falls der Ordner plugins fehlt, kann er manuell erstellt werden.

Beim ersten Start erzeugt das Plugin neben der DLL den Ordner BastelhofAnimatedSteeringWheelPlugin. Darin liegen Konfiguration, Logs und weitere Plugin-Daten.

Bedienung

1. ETS2 oder ATS im DirectX-11-Modus starten.
2. Profil laden und ins Spiel gehen.
3. Overlay mit Numpad 0 öffnen.
4. Animation und Live ins Spiel schreiben aktivieren.
5. Fahrposition und Parkposition über Höhe und Tiefe einstellen.
6. Mit Dauer die Animationsgeschwindigkeit einstellen.
7. Mit Verzögerung und Easing das Bewegungsverhalten feinjustieren.
8. Einstellungen mit Speichern sichern.

Tastaturbedienung im Overlay:

• Tab: nächstes Control fokussieren.
• Pfeiltasten: fokussierten Slider verändern.
• Enter oder Space: fokussierten Button oder Toggle aktivieren.
• Escape: Overlay schließen.
• Alt-Tab: bleibt frei und gibt die Maus an Windows zurück.

Konfiguration

Die Konfiguration liegt nach dem ersten Start hier:

<Spiel>/bin/win_x64/plugins/BastelhofAnimatedSteeringWheelPlugin/config.json

Wichtige Werte:

• enabled: aktiviert oder deaktiviert die Lenkradfunktion.
• hotkey.key: Standard ist NUMPAD0.
• trigger.mode: electricity, engine, electricityOrEngine oder manual.
• animation.durationMs: Animationsdauer in Millisekunden.
• animation.delayMs: Startverzögerung in Millisekunden.
• animation.easing: linear, easeIn, easeOut, easeInOut oder easeInOutCubic.
• drivingPosition.verticalOffset: Höhe der Fahrposition.
• drivingPosition.depthOffset: Tiefe der Fahrposition.
• parkedPosition.verticalOffset: Höhe der Parkposition.
• parkedPosition.depthOffset: Tiefe der Parkposition.
• runtimeWrite.enabled: schreibt die Runtime-Animation live ins Spiel.
• runtimeWrite.restoreOnShutdown: stellt beim Beenden die Originalwerte wieder her.

Beschädigte Konfigurationen werden automatisch gesichert und durch eine neue Standardkonfiguration ersetzt.

Logs

Logs liegen unter:

<Spiel>/bin/win_x64/plugins/BastelhofAnimatedSteeringWheelPlugin/logs/

Wichtige Dateien:

• bastelhof_steering_wheel.log: normales Plugin-Log.
• bastelhof_action_debug.log: Aktionen, Overlay-Eingaben, Telemetrie- und Runtime-Wechsel.
• bastelhof_signature_diagnostics.json: Diagnose zur Spiel- und Signaturerkennung.

Entfernen

1. Spiel beenden.
2. bastelhof_steering_wheel.dll aus dem Pluginordner entfernen.
3. Optional den Ordner BastelhofAnimatedSteeringWheelPlugin löschen, wenn Konfiguration und Logs ebenfalls entfernt werden sollen.

Weitere Dokumentation

Ausführlichere Unterlagen liegen im Ordner docs/, darunter Installation, Konfiguration, Fehlerbehebung, Sicherheit und Entwicklung.

Neue Architekturplanung:

• docs/architecture.md
• docs/builds.md
• docs/player.md
• docs/diagnostic.md
• docs/rmlui.md
• docs/profiles.md
• docs/truck-detection.md
• docs/development.md