Upgrade Notes

Upgrade notes between different version of NWH Vehicle Physics 2. Version of currently installed package can be found under the Package Manager (Window > Package Manager).

Important: It is always best to do a clean import after upgrade by removing the NWH folder and then importing. Doing this will not break the project in any way, or cause missing scripts, as Unity keeps the references.

13.x to 14.x

  • Unity 6000 required
  • URP is now a package dependency (use Tools > NWH > URP to Built-in Converter for Built-in RP)
  • Clean import recommended
  • Breaking API changes:
    • VC_Update() → VC_Update(float DeltaTime)
    • VC_FixedUpdate() → VC_FixedUpdate(float DeltaTime)
    • wheelUAPI renamed to wheelController
    • Wheel properties moved to structs (e.g., .Radius → .wheel.radius)
    • Friction moved to separate StandardFriction component
    • WheelController.Step() → Step(float deltaTime, Matrix4x4 vehicleMatrix)
  • Force Feedback: SteeringWheelInputProvider → FFBInputProvider (DirectInput, supports all wheels)
  • Powertrain: New clutch lockup protection, differential types (Open/LSD/Locked/Torsen), gear skipping
  • WheelController: ARB system (arbStiffness, arbDamping), static friction, substepping via WheelControllerManager

For complete migration guide including API changes, see Upgrading from v13 to v14.

11.x to 12.x

  • Clean import recommended
  • WheelController: rotatingVisual and nonRotatingVisual replaced with Rotating and NonRotating containers (use Upgrade from v11 button)
  • Differential: Single differential with adjustable settings replaces fixed types
    • Open: Stiffness = 0
    • LSD: Stiffness > 0, Slip torque ~200
    • Locked: Stiffness = 1, Slip torque > 1000

11.10f to 11.11f

  • Clean import required due to the resources that were moved.

10.x to 11.x

  • Unity 2020.3.40f minimum
  • Clean import required
  • Powertrain outputs need re-assignment
  • EngineStartComponent → EngineStartStopComponent (StateDefinition settings need re-assignment)
  • Clutch type changed to enum (re-assign if not Automatic)

9.x (1.9.x) to 10.x

  • MAJOR UPDATE - Clean import required (remove NWH folder completely)
  • Unity 2021.3.16f minimum
  • WheelController3D: Major rewrite, new API, Force Coefficient → Grip, Slip Coefficient → Stiffness
  • Vehicle:
    • NRigidbody removed (use Fixed Delta Time instead: 0.01-0.01667 for desktop)
    • Center of mass/inertia moved to optional VariableCenterOfMass script
    • Anti-roll bar replaced with WheelController Force Application Point Distance
    • Automatic Sequential transmission removed (use Automatic + Is Sequential)
    • Clutch PID replaced with clutchEngagementRPM and clutchEngagementRange
    • Wheel camber set on WheelController (not WheelGroup)
  • Scene: CharacterVehicleChanger integrated into VehicleChanger, tag-based vehicle finding removed

v1.8.x to v1.9.x (v9.x)

  • Clean import required.

v1.7.x to v1.8.x

  • Clean import required.

v1.7.5 to v1.7.6

  • Clean import required.

v1.7.3 to v1.7.4

  • Clean import required (asmdef changes)
  • Lateral friction calculation improved (may require friction coefficient adjustment)

v1.6.x to v1.7

  • Powertrain inertia changes (vehicles accelerate faster)
  • Multiplayer: NetworkRigidbody option added (don't use with NetworkTransform simultaneously)

v1.5.x to v1.6.x

  • Clean import required (asset restructuring)
  • .NET 4.x API Compatibility Level required
  • Assembly definition files added (reference NVP2 from other assemblies)
  • Multiple NWH assets require simultaneous update (Common folder restructure)
  • Torque converter removed (use clutch slip torque)
  • CVT uses single forward/reverse gear ratio (minimum ratio for each direction)
  • SteeringWheelInput requires assembly definition setup for Logitech SDK

v1.5 to v1.5.1

  • PIDController.cs may duplicate on import (remove if occurs)

v1.4 to v1.5

  • Clean import required (folder restructure for multi-asset compatibility)
  • WheelController damper settings need ~50% reduction
  • Input classes renamed: Input → VehicleInputHandler, InputStates → VehicleInputStates

v1.3 to v1.4

  • NRigidbody component now required (add manually to existing vehicles)

v1.2 to v1.3

  • No changes required

v1.1 to v1.2

  • Delete Scripts folder before upgrading (namespace changes)
  • InputProviders split: SceneInputProvider (scene input) + VehicleInputProvider (vehicle input)
  • Shared scripts moved to NWH/Common directory

v1.0 to v1.1

  • Delete Scripts > Vehicle > Input folder before upgrading
  • InputSystem package required (auto-installed)
  • InputManager binding changes:
    • Horizontal → Steering
    • Vertical split to Throttle and Brakes
    • Add: CameraRotation, CameraPanning, CameraRotationModifier, CameraPanningModifier, CameraZoom, FPSMovement, ToggleGUI
  • vehicleController.input.Vertical retained for AI compatibility

NWH Vehicle Physics 1 to NWH Vehicle Physics 2

  • Remove all previous NWH Vehicle Physics and Wheel Controller 3D versions
  • Manual vehicle upgrade required (major differences)
  • Use Vehicle Setup Wizard to expedite setup