An open API service indexing awesome lists of open source software.

https://github.com/mackimmolate/ets2scrolldrive

Mouse steering and scroll-wheel throttle/brake controls for Euro Truck Simulator 2, with an optional on-screen input overlay.
https://github.com/mackimmolate/ets2scrolldrive

controls-sii ets2 euro-truck-simulator-2 mouse-controls mouse-steering scroll-wheel-throttle-brake

Last synced: about 1 month ago
JSON representation

Mouse steering and scroll-wheel throttle/brake controls for Euro Truck Simulator 2, with an optional on-screen input overlay.

Awesome Lists containing this project

README

          

# ETS2 Scroll Drive

Mouse steering and scroll-wheel throttle/brake controls for Euro Truck Simulator 2.

## Files

- `controls.sii`: ETS2 controls profile with 3% scroll steps.
- `start_ets2_scroll_overlay.cmd`: overlay that shows the current throttle/brake percentage and enables `Alt` reset.

## Installation

1. Close ETS2.
2. Open your ETS2 profile folder in `Documents\Euro Truck Simulator 2\profiles\` or `Documents\Euro Truck Simulator 2\steam_profiles\`.
3. Back up your existing `controls.sii`.
4. Copy this `controls.sii` into the profile folder.

The overlay `.cmd` file can be placed anywhere. It is self-contained and does not need to be inside the ETS2 profile folder.

Start the overlay before driving if you want `Alt` reset.

## Controls

- Move mouse: steer.
- Scroll up: increase throttle.
- Scroll down: increase brake.
- `Alt`: reset throttle/brake to neutral.
- Hold right mouse: rotate the camera in cab view and external view.
- Right mouse + scroll: camera zoom.
- `Ctrl + Alt + Q`: close the overlay.

## Behavior

The live scroll wheel value is stored by ETS2. The overlay mirrors the same logic so it can show the expected throttle, brake, or neutral state.

Each wheel step changes the stored value by 3%, from full brake to full throttle. Throttle uses a squared curve, so small scroll changes are gentle and full scroll range still reaches 100%. Brake is more direct: about 25% scroll gives about 25% brake, 50% gives about 50%, and full brake still takes the full scroll range.

Press `Alt` to reset throttle/brake to neutral. The overlay handles this by sending a very quick middle-mouse reset pulse while `Alt` is held, then resets its own display.

Do not edit controls that show as `complex` in ETS2's buttons menu. Those are custom bindings from `controls.sii`, and changing them in-game can break the scroll controls.

## Transmission Notes

The mod does not depend on the truck's gearbox model or number of gears.

- Automatic and sequential transmissions are the best fit.
- In simple automatic, scroll down uses ETS2's normal backward input. At a stop, holding brake may engage reverse.
- Real automatic users may need to bind Drive and Reverse separately in ETS2.
- H-shifter/manual users should merge the scroll steering/throttle/brake bindings into their own controls profile instead of replacing it.

## Feedback

Found a problem or have a suggestion? Open an issue on GitHub.

## License

MIT License. See `LICENSE`.