Upgrade Notes
Important changes and migration steps for upgrading between versions of NWH Aerodynamics.
14.x (Unity 6 package generation)
NWH Aerodynamics 14.x is distributed as UPM package com.nwh.aerodynamics. The current package
manifest requires:
- Unity
6000.0.80f1or newer - Input System
1.11.2 - Universal Render Pipeline
17.0.3 - NWH Common
14.3.0
When migrating from an Asset Store or pre-UPM installation:
- Back up the project and remove the old, embedded NWH Aerodynamics folders before installing the UPM package. Keeping both layouts can compile duplicate types and assemblies.
- Install NWH Aerodynamics through Package Manager and let it resolve the declared dependencies.
- Use File > Build Profiles for platform configuration and set Active Input Handling to Input System Package (New), or Both only if the project still uses a legacy provider.
- Re-import the NWH Common Base Sample before the Aerodynamics Base Sample.
- Recheck materials and renderer assets after moving to URP 17. Existing Built-in or older URP materials are not converted by the Aerodynamics package.
- Revalidate aircraft mass, center of mass, inertia, control-surface direction, input bindings, and prefab overrides before replacing the previous package version.
Package assembly definitions are part of the supported layout. Custom user assemblies should
reference NWH.Aerodynamics; do not delete the package assembly definition.
14.2 beta to 14.3.0
- Shipped Input Actions wrappers no longer regenerate during package import, preventing supported Input System versions from rewriting package-cache source. Use runtime rebinding or a project-owned action asset/provider for custom controls. Maintainers editing a writable embedded package must explicitly enable Generate C# Class, regenerate and review the wrapper, then disable generation again before publishing.
- Re-resolve packages after upgrading. Aerodynamics 14.3.0 requires NWH Common 14.3.0 because it uses the current vehicle input-availability API.
AircraftController.Airspeedis now air-relative: Rigidbody world velocity minus the activeWindGeneratorBasevelocity.RateOfClimbremains ground-relative world-Y velocity.- Angle of attack and sideslip (
Yaw) now come from air-relative velocity in aircraft body axes. Heading, pitch, and roll are attitude values derived from world basis vectors. - Custom
WindGeneratorBasesubclasses may continue to override publicAwake()and should callbase.Awake(). Registration is also refreshed on enable, so pooled generators work correctly. Atmosphere.rhoDefaultremains a mutable static fallback for compatibility. Its ISA sea-level default changed from 1.2 to 1.225 kg/m3; useAtmosphere.StandardAirDensitywhen a compile-time constant is required.VariableCenterOfMass.UpdateInertia(bool)remains as an obsolete compatibility overload. The legacyCalculateInertiaTensorOffset(Vector3)retains its old result; new code should callCalculateCompositeInertiaTensorOffset(combinedCenterOfMass)for the corrected parallel-axis calculation.- Public
AircraftInputManager.Update()andForcedInduction.Update()remain as obsolete ABI shims. Do not call them from new code: input collection runs once inLateUpdate, while forced induction runs once per physics step inFixedUpdate. ControlSurface.angleSmoothing = 0now snaps exactly to the commanded angle. Positive values retain the existing smoothed actuation behavior.- All shipped
AirfoilProfilecurves were regenerated with the corrected post-stall generator. Regenerate custom profiles with Parse Polar Data; this changes their curve domain to -180 to +180 degrees and can change deep-stall/reversed-flight behavior. - The corrupt, unreferenced
AirfoilProfile_n642415asset was removed from both the bundled and optional profile libraries. Projects that assigned it manually will show a missing asset reference after the upgrade; select a validated replacement with suitable source polar data and revalidate the aircraft. Its unrecoverable numeric-overflow rows were not guessed or silently interpolated. - The Cirrus SR22 sample and tutorial propeller coefficient changed from 1.0 to 1.5 to compensate for removal of the former force fudge factors. Treat 1.5 as a migration baseline and play-test cruise speed, climb, and takeoff distance before shipping a derived aircraft.
EngineAircraftFuelConsumernow usespowerKW / (10 * efficiency)litres per hour before applyingconsumptionMultiplier. The beta usedpowerKW / 10 * (1 - efficiency), so existing physical efficiency values produce higher, corrected fuel burn. Re-test endurance. To approximate the old gameplay burn while retaining the same efficiency, start withnew consumptionMultiplier = old multiplier * efficiency * (1 - efficiency)and then tune from measured range.- The
AircraftFuelConsumer.GetConsumption()XML documentation now reflects its existing runtime contract: return litres consumed during the current physics update, not litres per second. Custom consumers that calculate a per-second rate must multiply it byTime.fixedDeltaTimebefore returning. - Smoke particle lifetime now uses
trailDistance / airspeed. All shipped smoke systems migratedtrailMinLifetimefrom 3 s to 0.1 s; custom prefabs keep their serialized beta value and should be reviewed. TheHUD_Heading.degreesPerUnitdefault and shipped generic instrument changed from -1 to +1; existing custom serialized values do not change automatically. - New
Airfoilcomponents defaultmomentCoefficientto 1 so the profile pitching-moment curve is effective. Existing serialized zero values remain zero and continue to suppress pitching moment; opt in and re-trim the aircraft explicitly. - The beta public surface remains callable:
AircraftLightsManager.FixedUpdate,LightSource.TurnOn,InputSystemAircraftInputProvider.Awake,AircraftEngineBase.FixedUpdate,CrashAircraftSoundComponent.Update/PlayCollisionSound, andControlSurfaceEditor.OnInspectorNUIretain their public signatures. The serialized smoke, instrument, fuel-efficiency, and airfoil-moment fields also retain their names and types. - The
Airfoilposition handle andAerodynamicDragObject.Centerno longer apply the hierarchy scale of the GameObject they sit on. Both now behave like the rest of the airfoil geometry, which never applied it. An aircraft whose parts sit under a scaled parent will have its airfoil planes and drag boxes in different places after the upgrade; check the gizmos and re-fit if needed. On an unscaled hierarchy nothing moves. - Piston and turbine engines divide power by the stall speed rather than by 0.1 rad/s once the shaft
is slower than that, so torque near rest follows the power curve instead of diverging. Both shipped
turbines have power curves that pass through the origin, where
power / omegais already constant, so nothing changes for them. A custompowerCurvewith a non-zero value at zero RPM will produce less torque at very low RPM and during the starter transient than in the beta; raisestarterTorqueif the engine now cranks too slowly. PropellerPropulsormultiplies blade lift and drag by the blade profile'sclCoefficientandcdCoefficient, which the beta ignored. Both default to 1, so only propellers assigned a profile with adjusted coefficients change thrust. Re-test those.AircraftFuelTank.Amountis clamped to the tankcapacity. Code that over-filled a tank by writing a larger value now gets the capacity instead.com.unity.burstis no longer a declared dependency of the package. It is unreferenced, and URP still brings it into the project, so no manifest change is needed on upgrade.- The package no longer ships its editor and play-mode test assemblies, and its
README.mdbecameReadme.txt. Project code should not referenceNWH.Aerodynamics.Tests.EditororNWH.Aerodynamics.Tests.Runtime.
1.1
- Clean import required.
- Required adjustment of
CenterOfMassonVariableCenterOfMassscript since the CoM is now set as an absolute value instead of an offset.
0.9.4
VariableCenterOfMassCenter Of Mass OffsetandInertia Scalemight need re-adjusting due to changes in theVariableCenterOfMassscript. Effective inertia in the new version will be ~3 times lower than the calculated value in the previous version. Due to the bug fix that affected center of mass calculation, the center of mass with the new version will be different if anyIMassAffectors have been attached.