Keybindings and vJoy Mapping

⌨️ Keybindings & vJoy Axis Mapping

🌐 Language / Язык: English | Русский

vWheel Hub provides an intuitive dual-slot keybinding architecture, advanced cursor locking behaviors, conflict detection, and granular control over vJoy axis calibration.

---

⌨️ Dual-Slot Keybinding System

Every action in vWheel Hub supports two simultaneous keybinding slots (Primary / Key 1 and Secondary / Key 2). This allows you to seamlessly mix keyboard keys and mouse buttons.

Keybinding Conflict Detection

The input engine monitors assigned hotkeys in real time. If you attempt to assign an identical key to conflicting actions (for instance, assigning 'D' to both Shift Up and Steer Right), vWheel Hub highlights the conflicting slot with a red border and warns you immediately.

---

📋 Comprehensive Keybindings Table

Action	Primary Slot (Default)	Secondary Slot (Default)	Function & Mechanics
Gas (Throttle)	'W'	Left Mouse Button	Progressive throttle input with Schema V2 Fast/Slow attack and decay.
Brake	'S'	Right Mouse Button	Progressive brake pedal input with two-segment threshold modulation.
Turbo Pedal Attack	Dual Press (Key 1 + Key 2)	Dual Press (Key 1 + Key 2)	Pressing both primary and secondary gas/brake keys simultaneously activates instant Turbo Attack (bypasses threshold stages for launch control / emergency stopping).
Shift Up	'E'	Mouse XButton2 (Forward)	Triggers virtual vJoy Button 1 to upshift gears in-game.
Shift Down	'Q'	Mouse XButton1 (Back)	Triggers virtual vJoy Button 2 to downshift gears in-game.
Steer Left	'A'	Left Arrow	Steers left in Keyboard-Only Steering Mode.
Steer Right	'D'	Right Arrow	Steers right in Keyboard-Only Steering Mode.
Center Steering	Space	Delete	Instantly resets the virtual steering wheel back to $0^\circ$ dead-center.
Toggle Hub Active	None	None	Global system hotkey to enable or pause the vWheel Hub processing engine.
Toggle Mouse Lock	End	Backspace	Toggles permanent mouse cursor lock inside the active game window.
Hold-to-Unlock Cursor	None	None	Temporarily frees the mouse cursor and suspends steering while held. Re-locks immediately upon release!

---

🔒 Mouse Cursor Management Modes

vWheel Hub offers four intelligent cursor management modes to ensure seamless navigation between driving and game menus:

stateDiagram-v2
    [*] --> Unlocked: Application Start
    Unlocked --> Locked: Press Toggle Mouse Lock
    Locked --> Unlocked: Press Toggle Mouse Lock
    Locked --> TempUnlocked: Press & Hold 'Hold-to-Unlock' Key
    TempUnlocked --> Locked: Release 'Hold-to-Unlock' Key
    Locked --> MenuUnlocked: In-Menu Detected (!telemetry.IsDriving)
    MenuUnlocked --> Locked: Return to Track (telemetry.IsDriving)
    Locked --> Unlocked: Game Process Terminates

Loading

1. Permanent Lock Toggle: Locks the mouse cursor into a native Win32 window clip so rapid mouse movements never leave the game screen.
2. Hold-to-Unlock Cursor: Ideal for quickly checking a secondary monitor, Discord, or in-game telemetry overlay. While the key is held, the cursor is unlocked and steering input is suspended. Releasing the key instantly restores cursor lock at the current position.
3. Auto-Unlock Mouse in Menu: In supported games (ACC, AC EVO, LMU, rFactor 2, BeamNG), entering pit setup menus or pausing automatically releases the mouse cursor for easy menu navigation. Returning to the track automatically re-locks the cursor without pressing any hotkey.
4. Game-Exit Auto-Unlock: If your racing simulator exits, crashes, or is closed via Alt+F4, vWheel Hub automatically detects process termination within 250 ms and releases the mouse cursor.

---

🕹️ vJoy Axis Mapping & Calibration

On the vJoy Axes tab, you can inspect and customize how mathematical calculations are mapped to the virtual joystick's output ranges.

Different sim racing game engines calibrate joystick axis ranges differently:

Game / Simulator	Steering Axis (X)	Gas Axis (Y)	Brake Axis (Z / Rz)	Inversion Required
Standard / Universal	-32768 to +32768	-32768 to +32768	-32768 to +32768	None
Le Mans Ultimate (LMU)	0 to 32768 or -32768 to +32768	16384 to 32768	0 to 16384	Invert Brake: Checked
Assetto Corsa Competizione	-32768 to +32768	-16384 to +32768	-16384 to +16384	None

Axis Configuration Fields:

• Steering Axis (X): OutSteerMin, OutSteerMax, and Invert Steering.
• Gas Axis (Y): OutGasMin, OutGasMax, and Invert Gas.
• Brake Axis (Z / Rz): OutBrakeMin, OutBrakeMax, and Invert Brake.

Tip

Stuck Pedals Fix: If your car is constantly braking or accelerating at 100% when you are not touching any keys, simply check the Invert Brake or Invert Gas checkbox on the vJoy Axes tab to match your game's input calibration.

---

⏭️ Next Steps

• 🎮 Configure Steering Sensitivity & Dynamic Clamping
• ⚡ Configure Schema V2 Pedal Dynamics & Turbo Timing
• 📁 Manage 3-Tier Context Profiles & Share Codes