Troubleshooting

Step-by-step Guide

  1. Import errors:

    • Remove the NWH folder and re-import through Package Manager.

  2. Vehicle doesn't work:

    • Check VehicleSetupWizard console output for errors/warnings (if used).
    • Test demo scene vehicles:
      • If demo works: issue is in your vehicle setup, continue below.
      • If demo fails: verify Project Settings > Physics:
        • Fixed Timestep: 0.01667 (60Hz) desktop, 0.0333 (30Hz) mobile
        • Solver Iterations: Minimum 12 velocity, 8 position

  3. No input:

    • Verify InputProvider is present (e.g. InputSystemVehicleInputProvider).
    • Check vehicle is enabled (checkbox next to VehicleController).
    • Use Control > Input tab to verify input is received.

  4. Input works but vehicle doesn't move:

    • Remove any SphereCollider or similar from wheel objects - only WheelController should touch ground.
    • Check Rigidbody is not kinematic or constrained.
    • Verify powertrain is connected: VehicleController > Powertrain > Validate.

  5. Jitter, jumping, floating, or flipping:

    • Model rotation: Must be Z-forward, Y-up, X-right. Fix guide.
    • Scale: Vehicle root and WheelControllers must be [1,1,1]. Use model import settings.
    • Collider: Vehicle needs at least one Collider covering the body for proper inertia calculation.
    • WheelController rotation: Z-axis must point forward in vehicle direction.
    • Center of Mass:
      • VehicleController automatically calculates COM from wheel positions.
      • Verify with Rigidbody Gizmos - should be roughly centered, below geometric center.
      • Too high COM causes instability. Manually adjust Rigidbody.centerOfMass if needed.
      • Optional: Use VariableCenterOfMass for inspector control (Unity 6: adjust Rigidbody directly).
    • Inertia: Typical car ~[700, 1200, 300] or higher. Too low causes sliding.

  6. Still having issues:

    • Export vehicle prefab (see below) and contact via email or Discord.

Exporting the vehicle prefab for debugging

Export vehicle configuration without models/textures for faster debugging:

  1. Create prefab by dragging vehicle into Project view (if not already a prefab).
  2. Right-click prefab > Export Package…
  3. Untick Include Dependencies > Export…

Result: <1MB file containing only hierarchy and component configuration. Include with bug reports when possible.

Contacting the developer

Contact via email or Discord.

Include in bug reports:

  • Asset version (Window > Package Manager)
  • Unity version
  • Screenshots/videos demonstrating the issue
  • Exported vehicle prefab (see above)