Troubleshooting

1. If there are errors after importing:
   1. Try removing the NWH folder and re-importing the asset through Package Manager.
2. If the vehicle doesn't work:
   1. Did VehicleSetupWizard show any errors or warnings (if used)?
   2. Check the vehicles in the demo scene, do they work?
      1. If yes, the issue is likely in the setup of the particular vehicle. Continue with the guide.
      2. If no, try resetting the Project Settings > Time and Project Settings > Physics settings.
3. If the vehicle doesn't receive input:
   1. Check that InputProviders are present, e.g. InputSystemVehicleInputProvider.
   2. Check that the vehicle is enabled (check-box next to the script name in the inspector).
   3. Use the Control > Input tab to verify that there is input.
4. If the vehicle receives input but doesn't move:
   1. Check that the wheels don't have SphereColliders or similar on them; only the WheelController should touch the ground.
   2. Check that the Rigidbody is not constrained or kinematic.
5. If the vehicle moves but experiences jitter, jumping, floating, flipping over, etc.:
   1. Check the model rotation. Guide here.
   2. Check the vehicle scale, as well as the scale of WheelControllers. Both should be [1,1,1].
   3. Check that the vehicle has some type of a Collider. It should cover roughly the whole body of the vehicle. This affects internal Rigidbody inertia calculation.
   4. Check the rotation of WheelControllers; they should face (Z-axis) in the direction of the vehicle.
   5. Attach the VariableCenterOfMass component to the vehicle if not already present.
      1. Check the Center of Mass position through Gizmos. It should be roughly in the center of the vehicle. Too high Center of Mass can cause the vehicle to shake or glide over the surface.
      2. Check the Inertia value. For a typical car, it should be around [700, 1200, 300], or larger. If the vehicle is sliding over the surface, too low Inertia is the likely cause.
6. If the vehicle still doesn't work:
   1. Contact the developer through email or Discord.

For faster debugging sharing the prefab of the vehicle with the developer can be very helpful. This does not require sharing of any of the models, textures, or other assets, just the configuration.

1. If a prefab does not already exist, create a prefab from the vehicle by dragging it into the Project view.
2. Right click on the prefab and select Export Package…
3. Untick Include Dependencies and click Export…

This will result in a prefab containing only the hierarchy and the components and is adequate for debugging, with file size <1Mb. Send the prefab with the bug report, if possible.

You can contact me through email or Discord. It is a good idea to include the following in the report:

• Asset version (Window > Package Manager).
• Unity version.
• Any screenshots, videos, etc. demonstrating the behaviour.