🕹️ MouseShifter

MouseShifter allows you to use your mouse as an H-pattern gear shifter in games, providing precise control and an engaging driving experience.

It supports popular sim racing and driving games like Euro Truck Simulator 2, American Truck Simulator, BeamNG.drive, Project CARS, and more.

⚠ Note: This doesn’t disable mouse steering/looking — you can still use mouse steering/looking while using MouseShifter! It simply adds gear shifting functionality without interfering with your existing controls.

---

✨ Features

• 🎛️ Mouse-Based H-Shifter
• 🗂️ Customizable Gear Layouts
• ⚙️ 12/16 Gearbox Support
• 🎮 Built-in vJoy Support
• 🕹️ Experimental Controller Support
• 🖱️ Mouse-Look / XInput Blocking
• 🛞 Dual Mouse Control (Steering + Shifting)
• 🎨 Fully Customizable Controls and Layout

---

---

🖥️ Requirements

• ✅ vJoy driver – This virtual joystick driver is necessary for input mapping.
• ✅ DS4Windows – An optional tool for PlayStation controllers to enable XInput support.

---

⚡ How to Use

1. Download the latest release from GitHub and extract the ZIP file.

<details> <summary>⚠️ IMPORTANT</summary>

• Make sure you have at least 12 buttons set and all axes enabled in vJoy settings, must always be vJoy Device: 1.

Start -> Search "Configure vJoy"

</details>

2. Run MouseShifter.exe as Administrator.
3. Position the overlay window where you want it, then press Tab.
4. Press F12 to temporarily disable the knob.
5. Launch your game.
6. Open the control settings and bind your gear controls.
   
7. Done — you’re ready to play!

⚠️ Tip: If the overlay doesn’t appear or function properly, try setting your game to borderless mode.

---

<details> <summary>📚 Guides: Euro Truck Simulator 2 & American Truck Simulator</summary>

Video Guide: https://www.youtube.com/watch?v=w5_lFoCMoK4

⚠️ Important

• Before proceeding, create a backup of your controls.sii file.

• Disable Steam Cloud

• Run MouseShifter as Admin

• Make sure you have atleast 12 buttons set and all axes enabled in vJoy settings, must always be vJoy Device: 1.

  Start -> Search "Configure vJoy"

---

🚛 Using in Euro Truck Simulator 2 / American Truck Simulator

1. Make sure all gears are bound to vJoy buttons in the app (default bindings are included).
2. Open the app, then launch the game.
3. Go to Options → Controls, and choose Keyboard + vJoy Device as the main device.

4. Scroll to H-Shifter and map all gears and togglers.
   
5. Shift gears with your mouse while holding Right Click to look around.

---

🖱 Using Mouse Steering

1. Enable Mouse Steering in the app.
2. Choose H-Shifter Mouse Device and Mouse Steering Device.
3. Within the game, go to Options → Controls, and:
   • ❌ Do not enable Keyboard + Mouse Steering.
4. Bind the steering axis, and optionally bind the acceleration or brake axes for mouse throttle or brake.

⚠️ Warning: Press F11 to temporarily turn off mouse steering before pausing or accessing in-game menus.
ℹ️ Tip: If you want to use dual mouse steering + H-Shifter, see the Dual Mouse Setup below.

---

🛞 Using Wheel or Pedals

1. In the game, go to Options → Controls.
2. Keep Keyboard + vJoy Device selected as your primary device.
3. Pick your wheel or pedals as an additional device.
4. Bind the steering, throttle, brake, or clutch as needed.
5. That’s it — you’re ready to drive!

---

🎮 Using Experimental Controller Support

Detailed Video Guide: https://www.youtube.com/watch?v=7qyDuhJJklw

1. Enable Controller in the app.
2. DO NOT SELECT Your controller yet as an additional device.
3. Bind Look Axis in the game if needed.
4. Select your XInput controller as an additional device.
5. Bind H-Shifter togglers, buttons, acceleration, and brake axes.
6. Use the Assist Knob button to shift gears.

---

</details> <details> <summary>🖱️ Mouse Steering Guide</summary>

Single Mouse Setup

1. Open the MouseShifter app.
2. Enable Mouse Steering.
3. Select H-Shifter Mouse Device: choose your USB mouse for H-Shifter.
4. Select Mouse Steering Device: select the same mouse as the H-Shifter.
5. Your H-Shifter will now be temporarily disabled; hold down the Activate Knob Key to use H-Shifter.
6. Open your game and go to Control Options.
   • Do NOT enable Mouse Steering if your game enables it by default.
7. Bind your steering:
   • For key bindings: select left/right and move your mouse accordingly.
   • For steering axes bindings: select the axis and move your mouse (method may vary per game).
8. If you haven’t already, bind H-Shifter buttons.
9. Done! You can now play with mouse steering while holding the Activate Knob Key to use H-Shifter.

⚠️ Note: Always press F11 to temporarily disable mouse steering before pausing the game or accessing menus.

---

Dual Mouse Setup

1. Open the MouseShifter app.
2. Enable Mouse Steering.
3. Select H-Shifter Mouse Device: choose the mouse you want for H-Shifter.
4. Select Mouse Steering Device: choose your second mouse for steering.
5. Open your game and go to Control Options.
   • Do NOT enable Mouse Steering if your game enables it by default.
6. Bind your steering(method may vary per game):
   • For key/button bindings: select left/right and move your steering mouse accordingly.
   • For steering axes bindings: select the axis and move your mouse.
7. If you haven’t already, bind H-Shifter buttons.
8. Done! You can now play with mouse steering enabled while using the second mouse for H-Shifter.

⚠️ Note: Always press F11 to temporarily disable mouse steering before pausing the game or accessing menus.

</details> <details> <summary>🎮 Forza Horizon 5 Guides</summary>

⚠️ Before You Start

• Make sure you have control bindings for Shifter togglers set up (do not use the mouse).
• Use any rarely used key in-game for bindings.

• Make sure you have atleast 12 buttons set and all axes enabled in vJoy settings, must always be vJoy Device: 1.

Start -> Search "Configure vJoy"

Tip: If the game crashes when starting with MouseShifter:

1. Close MouseShifter.
2. Open Forza Horizon 5.
3. Then reopen MouseShifter.

---

🛠 Setting Up Wheel Controls

1. Open Forza Horizon 5.
2. Go to Options → Controls → Change Input Mapping → Wheel.
3. Select Select Layout and press an arrow key to load a custom wheel profile.

4. Scroll down to the Gears section and start binding gears accordingly.

---

🔧 Bypassing Required Bindings

(YOU CAN SKIP THIS STEP IF HAVE A WHEEL.)

1. Scroll up to see Required Bindings/Buttons.
2. Use the Shifter togglers button you set up in the first step.
3. Assign all required bindings to the same button — this tricks the game into allowing H-Shifter use.

---

🖱️ Using Mouse Steering / Throttle / Brake (Optional)

1. Open the MouseShifter app and enable Mouse Steering.
2. Be careful: don’t move the mouse too much, or the game may get confused.
   • If it does, disable Mouse Steering from the app and re-enable it, or restart the game.
3. Bind the Steering axis and Acceleration/Brake axis (enable the combined toggle).

---

✅ Final Steps

• Go back to the game.
• You should now see the H-Shifter working.
• You’re ready to drive!

</details> <details> <summary>🕹️ Scroll to Clutch Guide</summary>

Enable Scroll-to-Clutch in MouseShifter

• Open the MouseShifter app
• Enable Scroll to Clutch
• Adjust any sensitivity or direction options

In-Game Setup

• Open your game and go to Control Options
• Bind the Clutch Axis to your scroll wheel (or the axis assigned by MouseShifter)

⚠️ Tip: Make sure no other controls conflict with the scroll wheel. If the clutch behaves incorrectly, disable and re-enable Scroll-to-Clutch in the app

✅ Final Steps

• Your scroll wheel now works as a clutch!
• You can engage and r