Troubleshooting and FAQ

🔧 Troubleshooting & FAQ

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

Common questions, troubleshooting solutions, diagnostic procedures, and fixes for vWheel Hub, the vJoy virtual driver, and supported racing simulators.

---

🛠️ vJoy Driver Issues

1. "vJoy driver is not installed or disabled in Windows"

Cause: The vJoy kernel-mode driver is not installed or was disabled in Windows Device Manager.

How to Fix:

1. Download and install the latest vJoy installer from GitHub Releases.
2. Open Windows Device Manager (devmgmt.msc).
3. Expand Human Interface Devices (HID).
4. Locate vJoy Device, right-click it, and ensure it is Enabled.

2. "vJoyInterface.dll was not found"

How to Fix: On the vWheel Hub Dashboard, click "Auto-Configure vJoy". vWheel Hub automatically detects vJoyInterface.dll in C:\Program Files\vJoy\x64\vJoyInterface.dll and synchronizes it into the application directory.

3. "vJoy Device #1 is BUSY / Owned by another application"

Cause: Another joystick remapping software (such as UCR, JoyToKey, FreePIE, or a second instance of vWheel Hub) holds exclusive ownership of vJoy Device #1.

How to Fix: Close any background joystick mapping tools, verify only one instance of vWheelHub.exe is running in Task Manager, and restart vWheel Hub.

---

🏆 Le Mans Ultimate (LMU) Input Stuttering & 1000 Hz Setup

"Steering or pedals stutter and drop inputs in Le Mans Ultimate at high polling rates"

Cause: By default, LMU uses an internal "High Precision Input" sampler for DirectInput controllers. When receiving high-frequency updates from virtual joystick drivers (vJoy) above 200 Hz, LMU's internal sampler skips frames and stutters.

The 1-Click Fix:

1. Open vWheel Hub and navigate to the Dashboard.
2. Under the Le Mans Ultimate diagnostic card, click "Apply LMU Input Compatibility Fix".
3. vWheel Hub safely patches <GamePath>\UserData\player\current controls.json with "DirectInput Fallback": true.
4. Restart Le Mans Ultimate.
5. Result: LMU switches to standard Windows DirectInput message polling. You can now set your Hub Polling Rate to the full 1000 Hz for silky-smooth, zero-stutter steering!
6. To revert: Click "Revert LMU Input Fix" at any time; vWheel Hub verifies SHA256 integrity and restores your original configuration backup.

---

🔒 Mouse Cursor Locking & Menu Behaviors

1. "My mouse cursor is trapped in the center when I want to click in menus"

• Solution A (Automatic): In the Telemetry settings, ensure Auto-Unlock Mouse Cursor in Menu is enabled. In ACC, AC EVO, LMU, rFactor 2, and BeamNG, vWheel Hub will automatically free the cursor in menus and re-lock it when driving.
• Solution B (Hold-to-Unlock): Assign a key to Hold-to-Unlock Cursor in Keybindings (e.g. a mouse thumb button). Holding this key frees your cursor and pauses steering; releasing it immediately re-locks the cursor.
• Solution C (Toggle): Press your assigned Toggle Mouse Lock hotkey (default End or Backspace).

2. "The cursor unlocks automatically when I exit the game"

• Behavior: This is an intentional safety feature. vWheel Hub's telemetry monitor checks active game processes every 250 ms. If the game exits or crashes, vWheel Hub automatically releases the mouse lock so your desktop cursor is never trapped.

---

⏸️ In-Menu Control Suspension

"Throttle and brake keys do not respond when I am in the pit garage or setup menu"

Behavior: This is an intentional feature called In-Menu Control Suspension. When you are in garage menus or setup screens (when paused or in menus), vWheel Hub neutralizes gas and brake outputs to $0%$ and gear shift buttons to $0$. This prevents accidental engine revving, clutch burnout, or false starts while clicking setup options. Controls immediately reactivate as soon as you enter the car and leave the garage.

---

🧠 Adaptive Grip Learning Cache

"The ABS or Traction Control assist feels overly restrictive after changing vehicle setup or tires"

Cause: The Adaptive Grid Cache learned tire grip limits based on your previous aerodynamic wing setup, tire compound, or weather condition.

How to Fix:

1. Navigate to the Telemetry Helpers tab in vWheel Hub.
2. Click "Reset Car" to clear the learned grip matrices (dry.json and wet.json) for your current vehicle.
3. The engine will instantly reset to theoretical tire friction circle limits and re-learn your new vehicle setup within 1–2 clean laps.
4. To wipe the entire database across all cars, click "Reset All".

---

💻 .NET 10 Runtime Missing Error

"A fatal error occurred: .NET Desktop Runtime was not found"

Cause: vWheel Hub is built natively on modern .NET 10 and requires the 64-bit desktop runtime.

How to Fix:

1. Download and install Microsoft .NET 10 Desktop Runtime (x64) from Microsoft: 👉 Download .NET 10 Desktop Runtime
2. Run the installer and relaunch vWheelHub.exe.

---

🎮 Steering & Pedal Calibration

1. "The car holds 100% Brake/Gas when NOT pressing keys, or pedals only reach 50%"

How to Fix:

1. In vWheel Hub, navigate to the vJoy Axes tab.
2. Check or uncheck "Invert Brake" or "Invert Gas".
3. Adjust OutGasMin / OutGasMax or OutBrakeMin / OutBrakeMax to match your simulator's calibration profile.

2. "Steering feels jittery or coarse"

• Mouse DPI: Ensure your physical mouse hardware sensor is configured to 1600–3200 DPI. Low DPI values (e.g. 400 DPI) send sparse coordinate packets.
• In-Game Settings: Ensure game Steering Deadzone is set to 0% and Linearity / Gamma is set to 1.0 (Linear).

---

❓ Frequently Asked Questions (FAQ)

Is vWheel Hub safe to use in online multiplayer and competitive leagues?

Yes. vWheel Hub interacts with racing simulators exclusively through standard Windows DirectInput (vJoy) and official, read-only game Shared Memory telemetry interfaces. It never injects DLLs into game memory or modifies executable code, making it 100% compliant with anti-cheat software (such as Easy Anti-Cheat, BattlEye, and league anti-cheat monitors).

Can I play simulators that are not listed on the auto-detection menu?

Yes! Select the Universal profile context. High-resolution mouse steering, keyboard steering mode, and Schema V2 pedal dynamics work in ANY PC game that supports standard USB controllers.

How do I report a bug or suggest a feature?

Join our Discord Community or open an issue on the official GitHub Repository!