AeroDrive
Dokumentation · Version 1.0

AeroDrive einrichten

Von der Installation bis zur ersten assistierten Fahrt in vier Schritten. Die Achsen werden nur einmal zugewiesen – danach reicht ein Tastendruck.

Voraussetzungen

  • Windows 10 oder 11 (64 Bit)
  • Euro Truck Simulator 2 1.62 – die Speicherzugriffe gelten für 1.62.1
  • Fenster- oder randloser Fenstermodus, wenn du das Overlay nutzen willst

1 · Installation

  1. Release herunterladen

    Lade das aktuelle Windows-Release herunter und entpacke es in einen Ordner deiner Wahl, z. B.C:\Programme\AeroDrive.

    Zum Release

  2. Spiel-Plugin kopieren

    Kopiere aerodrive_plugin.dll in den Plugin-Ordner des Spiels. Gibt es den Ordnerplugins noch nicht, lege ihn an:

    …\Euro Truck Simulator 2\bin\win_x64\plugins\aerodrive_plugin.dll

  3. ETS2 starten und SDK bestätigen

    Beim ersten Start fragt das Spiel nach den erweiterten SDK-Funktionen – bestätige den Hinweis. InDokumente\Euro Truck Simulator 2\game.log.txt erscheinen jetzt Zeilen mit[AeroDrive].

  4. Achsen einmalig zuweisen

    AeroDrive meldet sich im Spiel als Eingabegerät sdk.aerodrive mit den Achsen Lenkung, Gas, Bremse und Kupplung. Öffne im Spiel Optionen → Steuerung (das Spiel pausiert) und klicke jeweils die passende Zeile an, während der Achsen-Helfer die Achse bewegt:

    control_test zuweisen         # Lenkung, 30 s
control_test zuweisen gas     # Gas, 10 s
control_test zuweisen bremse  # Bremse, 10 s

    Gas und Bremse nur im Pausenmenü zuweisen.

  5. Pedalachsen prüfen

    Übernimm die Optionen, beende ETS2 und öffne profiles\<Profil>\controls.sii. Die Pedale müssen als halbe, nicht umgekehrte Achse eingetragen sein:

    c_jzthrottle: 1    c_jzbrake: 1
c_jithrottle: 0    c_jibrake: 0

    Stimmen die Werte nicht, bedeutet der Ruhewert 0 halbes Gas und halbe Bremse.

2 · Erste Fahrt

ProgrammWofür
aerodrive-overlayAssistent mit Anzeige über dem Spiel (empfohlen)
aerodriveAssistent mit Statuszeile im Terminal
aerodrive-guiEinstellungsprogramm – Cockpit, Autopilot, Overlay, Module

Nie aerodrive-overlay und aerodrive gleichzeitig starten. Beide enthalten die Regelschleife und würden gleichzeitig steuern. Das Einstellungsprogramm darf immer parallel laufen.

  1. ETS2 starten und den Lkw auf eine Straße mit Spurlinie stellen.

  2. aerodrive-overlay starten, optional aerodrive-gui auf dem zweiten Monitor.

  3. Füße von den Pedalen und Einfg drücken – AeroDrive wechselt in den Zustand Assistiert.

  4. Bremsen beendet die Assistenz, Gas übersteuert, Lenken pausiert das Spurhalten. F12 ist Not-Aus.

3 · Plugin-Setup

Jede Assistenzfunktion ist ein Plugin – Tempolimit, ACC, Ampel und Spurhalten sind eingebaut. Zusätzliche Funktionen kommen als DLL dazu.

Eingebaute Module

Im Einstellungsprogramm unter Module schaltest du jede Funktion einzeln an oder aus und stellst sie ein. Änderungen wirken sofort im laufenden Assistenten.

Aus dem Katalog

Module → Modul-Katalog zeigt alle freigegebenen Plugins. Ein Klick installiert das Plugin; die Datei wird vorher per SHA-256 geprüft.

Von Hand

Lege die Plugin-DLL in den Plugin-Ordner. AeroDrive lädt sie innerhalb von 2 Sekunden – ohne Neustart.

%LOCALAPPDATA%\AeroDrive\plugins\

Was Plugins dürfen

  • Das Zieltempo senken – nie erhöhen.
  • Neben aktivem Spurhalten leicht mitlenken (höchstens ±0,1).
  • Die Sicherheitsregeln (Not-Aus, Fahrer-Übersteuern) gelten auch für Plugins.

Eigene Plugins entwickelst du in Rust mit dem Crate aerodrive-plugin-api und dem Makroexport_plugin!. Ein Beispiel („Kurventempo“) liegt im Quellcode.

4 · Hotkeys

Die Tasten wirken auch, wenn ETS2 im Vordergrund ist. Assistenz, Quittieren und Not-Aus lassen sich im Einstellungsprogramm ändern.

TasteWirkung
F12Not-Aus: verriegelt, alle Achsen sofort auf 0. Immer aktiv, zusätzlich zu einer eigenen Not-Aus-Taste.
Num −Not-Aus quittieren → zurück in den Zustand Manuell.
EinfgAssistenz an/aus – auch im Stand. Die Pedale müssen dafür mindestens 1 s in Ruhe sein.
F10Overlay: kompakte Anzeige ↔ Anzeige über dem Spielbild.
Bild ↑ / Bild ↓Overlay: Blickwinkel anpassen.

Fehlerbehebung

Im game.log.txt steht nichts von AeroDrive.
Die DLL liegt im falschen Ordner. Sie gehört nach bin\win_x64\plugins, nicht in den Dokumente-Ordner.
Der Lkw gibt Gas oder bremst, obwohl die Assistenz aus ist.
Die Pedalachsen sind als volle oder umgekehrte Achse zugewiesen. Prüfe controls.sii wie in Schritt 1.5.
Die Assistenz lässt sich nicht einschalten.
Pedale mindestens 1 s in Ruhe lassen und sicherstellen, dass das Spiel läuft (nicht pausiert). Nach einem Not-Aus erst mit Num − quittieren.
Das Overlay ist nicht zu sehen.
ETS2 im Fenster- oder randlosen Fenstermodus starten – über exklusivem Vollbild kann kein Fenster liegen.

Nicht gelöst? Frag in unserem Discord nach.