NWH Aerodynamics
Search Results for

    Show / Hide Table of Contents

    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.80f1 or 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:

    1. 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.
    2. Install NWH Aerodynamics through Package Manager and let it resolve the declared dependencies.
    3. 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.
    4. Re-import the NWH Common Base Sample before the Aerodynamics Base Sample.
    5. Recheck materials and renderer assets after moving to URP 17. Existing Built-in or older URP materials are not converted by the Aerodynamics package.
    6. 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.Airspeed is now air-relative: Rigidbody world velocity minus the active WindGeneratorBase velocity. RateOfClimb remains 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 WindGeneratorBase subclasses may continue to override public Awake() and should call base.Awake(). Registration is also refreshed on enable, so pooled generators work correctly.
    • Atmosphere.rhoDefault remains a mutable static fallback for compatibility. Its ISA sea-level default changed from 1.2 to 1.225 kg/m3; use Atmosphere.StandardAirDensity when a compile-time constant is required.
    • VariableCenterOfMass.UpdateInertia(bool) remains as an obsolete compatibility overload. The legacy CalculateInertiaTensorOffset(Vector3) retains its old result; new code should call CalculateCompositeInertiaTensorOffset(combinedCenterOfMass) for the corrected parallel-axis calculation.
    • Public AircraftInputManager.Update() and ForcedInduction.Update() remain as obsolete ABI shims. Do not call them from new code: input collection runs once in LateUpdate, while forced induction runs once per physics step in FixedUpdate.
    • ControlSurface.angleSmoothing = 0 now snaps exactly to the commanded angle. Positive values retain the existing smoothed actuation behavior.
    • All shipped AirfoilProfile curves 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_n642415 asset 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.
    • EngineAircraftFuelConsumer now uses powerKW / (10 * efficiency) litres per hour before applying consumptionMultiplier. The beta used powerKW / 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 with new 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 by Time.fixedDeltaTime before returning.
    • Smoke particle lifetime now uses trailDistance / airspeed. All shipped smoke systems migrated trailMinLifetime from 3 s to 0.1 s; custom prefabs keep their serialized beta value and should be reviewed. The HUD_Heading.degreesPerUnit default and shipped generic instrument changed from -1 to +1; existing custom serialized values do not change automatically.
    • New Airfoil components default momentCoefficient to 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, and ControlSurfaceEditor.OnInspectorNUI retain their public signatures. The serialized smoke, instrument, fuel-efficiency, and airfoil-moment fields also retain their names and types.
    • The Airfoil position handle and AerodynamicDragObject.Center no 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 / omega is already constant, so nothing changes for them. A custom powerCurve with a non-zero value at zero RPM will produce less torque at very low RPM and during the starter transient than in the beta; raise starterTorque if the engine now cranks too slowly.
    • PropellerPropulsor multiplies blade lift and drag by the blade profile's clCoefficient and cdCoefficient, which the beta ignored. Both default to 1, so only propellers assigned a profile with adjusted coefficients change thrust. Re-test those.
    • AircraftFuelTank.Amount is clamped to the tank capacity. Code that over-filled a tank by writing a larger value now gets the capacity instead.
    • com.unity.burst is 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.md became Readme.txt. Project code should not reference NWH.Aerodynamics.Tests.Editor or NWH.Aerodynamics.Tests.Runtime.

    1.1

    • Clean import required.
    • Required adjustment of CenterOfMass on VariableCenterOfMass script since the CoM is now set as an absolute value instead of an offset.

    0.9.4

    • VariableCenterOfMass Center Of Mass Offset and Inertia Scale might need re-adjusting due to changes in the VariableCenterOfMass script. 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 any IMassAffectors have been attached.
    In this article
    Back to top Copyright © NWH - Vehicle Physics, Aerodynamics, Dynamic Water Physics