//

Bus Kneeling: Auto Lower Suspension on Door Open (Coaches DLC) [ETS2 1.62]




BUS KNEELING PLUGIN v1.0 for Euro Truck Simulator 2 (Coaches DLC)
Author: HBBDVN
Game version: 1.62.x (64-bit)
=====================================================================

WHAT IT DOES
------------
Brings real coach "kneeling" to the Coaches DLC buses:
 - Doors OPEN   -> front and rear suspension lower to the lowest position.
 - Doors CLOSE  -> suspension goes back to the NORMAL ride height (not the highest).
 - The Caps Lock lamp shows the door state: lamp ON = doors open, lamp OFF = doors closed.
 - Pressing the key again while the doors are still moving is ignored,
   so the suspension always follows the doors, never a double press.

Supported buses: Volvo 9700, MAN Lion's Coach, Scania Touring.
Trucks are not affected.

This is an SCS SDK plugin (.dll), not a mod. It does not appear in the Mod Manager.


INSTALLATION
------------
1. Close the game.

2. Copy BOTH files
      bus_kneeling.dll
      bus_kneeling.ini
   into the game's plugins folder:
      <ETS2 folder>\bin\win_x64\plugins\
   Steam example:
      C:\Program Files (x86)\Steam\steamapps\common\Euro Truck Simulator 2\bin\win_x64\plugins\
   (If the "plugins" folder does not exist, create it.)

3. No need to change your controls. The plugin uses Caps Lock for the doors by itself.
   Only if YOU have bound Caps Lock to "Entrance doors" yourself (Options > Controls),
   remove Caps Lock from it, otherwise the doors would get the command twice.
   Want another key? Change door_key in bus_kneeling.ini.

4. When the game starts it shows a message that SDK plugins are in use.
   This is normal for every plugin. Click OK.


HOW TO USE
----------
 - Stop the bus (below about 2 km/h).
 - Press Caps Lock (lamp ON)  -> doors open, the bus kneels.
 - Press Caps Lock (lamp OFF) -> doors close, the bus returns to normal height.
 - When you get into a bus the plugin assumes the doors are closed and turns the lamp off.
 - The plugin only controls Caps Lock while you drive a Coaches bus and the game window
   is active. In other programs (Alt+Tab) Caps Lock works normally.


SETTINGS (bus_kneeling.ini)
---------------------------
 door_key       Key used for the doors (0x14 = Caps Lock).
 lower_time_ms  How long the suspension is lowered when the doors open (ms).
                Increase it if the bus does not reach the lowest position.
 open_time_ms   Pause after opening before the next press is accepted (ms).
 close_time_ms  Pause after closing before the next press is accepted (ms).
                Do not make these shorter than the time the doors actually move.
 vehicles       Bus id keywords that get kneeling (comma separated).


UNINSTALL
---------
Delete bus_kneeling.dll and bus_kneeling.ini from the plugins folder,
and restore your "Entrance doors" binding if you changed it in step 3.


TROUBLESHOOTING
---------------
The plugin writes its actions to Documents\Euro Truck Simulator 2\game.log.txt
with the prefix [Bus Kneeling]. Please include those lines when reporting a problem.

Credits:
HBBDVN

No comments