<?xml version="1.0" encoding="utf-8"?>
<!--
  ═══════════════════════════════════════════════════════════════════════════════
  EntityAirplanePro — Complete Aircraft Configuration Reference  [ENGLISH]
  ═══════════════════════════════════════════════════════════════════════════════

  HOW IT WORKS
  ════════════
  All aircraft use the entity class EntityAirplanePro. Supports four
  flight modes: Plane (fixed-wing), TVOL (helicopter/VTOL), Osprey
  (hybrid that switches between both) and Delorean (ground vehicle
  that switches to TVOL flight).

  Properties go inside the vehicle's <property> block in vehicles.xml.

  3D MODEL REQUIREMENTS
  ═════════════════════
  Node paths are relative to the Mesh transform (searched recursively).
  Any node under a "Physics" GameObject is IGNORED for visuals.

  Airplane hierarchy example:
	  VehicleRoot
	  ├── Physics/                    ← Colliders, WheelColliders (ignored)
	  └── M/ (Mesh)
		  ├── Fuselage/
		  │   ├── LandingFlapL
		  │   └── LandingFlapR
		  ├── Surfaces/
		  │   ├── AileronL
		  │   ├── AileronR
		  │   ├── Elevator
		  │   └── Rudder
		  ├── Wheels/
		  │   ├── Rear
		  │   ├── Left
		  │   └── Right
		  ├── Effects/
		  │   ├── EngineDistort0
		  │   └── EngineDistort1
		  ├── Propeller/Blade
		  └── Animations/
			  ├── GearAnimator
			  └── EnterExit

  Osprey / Helicopter hierarchy example:
	  VehicleRoot
	  ├── Physics/
	  └── M/ (Mesh)
		  ├── RotorTiltL/             ← rotorTilt0
		  │   └── PropL/              ← propSpin0
		  ├── RotorTiltR/             ← rotorTilt1
		  │   └── PropR/              ← propSpin1
		  ├── Wheels/
		  └── Effects/

  DeLorean hierarchy example:
	  VehicleRoot
	  ├── Physics/
	  └── M/ (Mesh)
		  ├── Body/
		  ├── Wheels/
		  │   ├── FL_Pivot/           ← wheelTurn0  (pivot rotates on mode switch)
		  │   │   └── WheelFL         ← wheel0      (mesh spins while driving)
		  │   ├── FR_Pivot/           ← wheelTurn1
		  │   │   └── WheelFR         ← wheel1
		  │   ├── RL_Pivot/           ← wheelTurn2
		  │   │   └── WheelRL         ← wheel2
		  │   └── RR_Pivot/           ← wheelTurn3
		  │       └── WheelRR         ← wheel3
		  ├── RotorTiltL/             ← rotorTilt0
		  │   └── PropL/              ← propSpin0
		  └── RotorTiltR/             ← rotorTilt1
			  └── PropR/              ← propSpin1

  FLIGHT MODES
  ════════════
  ● Plane    → Fixed-wing aerodynamics: lift, drag, stall, surfaces.
  ● TVOL     → Helicopter/VTOL: hover, vertical thrust, stabilization.
  ● Osprey   → Plane + TVOL hybrid. Toggle with key (default T).
			   Cycle: TVOL → Plane → TVOL
  ● Delorean → Ground vehicle (Vanilla) + TVOL flying car.
			   Cycle depends on vanillaTvolOnly:
			   true  → Vanilla ↔ TVOL  (2 modes)
			   false → Vanilla → TVOL → Plane → Vanilla  (3 modes)

  TRANSITION SOUNDS (Delorean / Osprey)
  ══════════════════════════════════════
  Optional one-shot sounds played when switching flight modes.
  Use any valid game sound path (e.g. Vehicles/..., misc/...).
  Leave empty or omit the property to play no sound on that transition.

	soundVanillaToTvol  → played when switching: Car    → TVOL
	soundTvolToVanilla  → played when switching: TVOL   → Car
	soundTvolToPlane    → played when switching: TVOL   → Plane
	soundPlaneToTvol    → played when switching: Plane  → TVOL
	soundPlaneToVanilla → played when switching: Plane  → Car  (3-mode Delorean only)

  HOW TO DECLARE THE ENTITY CLASS
  ═════════════════════════════════
  Two separate files are required:

  1) entityclasses.xml  — declare the entity class and entity-level properties:

	<append xpath="/entity_classes">
	  <entity_class name="myAircraft">
		<property name="Class"     value="WitosRoot.EntityAirplanePro,suspension"/>
		<property name="Tags"      value="vehicle"/>
		<property name="Parent"    value="Cars"/>
		<property name="Prefab"    value="#@modfolder:Resources/myAircraft.unity3d?myAircraft"/>
		<property name="ModelType" value="Standard"/>
		<!-- ... other entity-level properties ... -->
	  </entity_class>
	</append>

  2) vehicles.xml  — declare the flight/behavior properties (same name as entity_class):

	<append xpath="/vehicles">
	  <vehicle name="myAircraft">
		  <property name="vehicleFlightMode" value="Plane"/>
		  <property name="engineThrust"      value="28000"/>
		  <!-- ... rest of flight properties ... -->
	  </vehicle>
	</append>

  The <vehicle name> MUST match the <entity_class name> exactly.
  The format is always:  WitosRoot.EntityAirplanePro,suspension
  (namespace WitosRoot, class EntityAirplanePro, assembly suspension)
-->

<aircraft_reference>

  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   AIRPLANE — MINIMAL SETUP                                            -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Airplane_Minimal">
	  <property name="vehicleFlightMode" value="Plane"/>
	  <property name="engineThrust"      value="28000"/>
	  <property name="wingArea"          value="24"/>
	  <property name="stallSpeed"        value="16"/>
  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   HELICOPTER — MINIMAL SETUP                                          -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Helicopter_Minimal">
	  <property name="vehicleFlightMode" value="TVOL"/>
	  <property name="enableTVOL"        value="true"/>
	  <property name="startInTVOL"       value="true"/>
	  <property name="tvolHoverForceMul" value="1.03"/>
	  <property name="tvolMaxUpSpeed"    value="6"/>
  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   DELOREAN 2 MODES — MINIMAL SETUP  (Vanilla ↔ TVOL)                 -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Delorean_2modes_Minimal">
	  <property name="vehicleFlightMode" value="Delorean"/>
	  <!-- vanillaTvolOnly = true is set automatically by vehicleFlightMode=Delorean -->
	  <property name="tvolHoverForceMul" value="1.03"/>
	  <property name="tvolMaxUpSpeed"    value="6"/>
	  <property name="maxWheelTurnSlots" value="4"/>
	  <property name="wheelTurn0"        value="Wheels/FL_Pivot"/>
	  <property name="wheelTurn1"        value="Wheels/FR_Pivot"/>
	  <property name="wheelTurn2"        value="Wheels/RL_Pivot"/>
	  <property name="wheelTurn3"        value="Wheels/RR_Pivot"/>
	  <property name="wheelTurnTVOLDeg"  value="90"/>
	  <!-- Optional transition sounds -->
	  <property name="soundVanillaToTvol" value="Vehicles/delorean_transform"/>
	  <property name="soundTvolToVanilla" value="Vehicles/delorean_transform"/>
  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   DELOREAN 3 MODES — MINIMAL SETUP  (Vanilla → TVOL → Plane)         -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Delorean_3modes_Minimal">
	  <property name="vehicleFlightMode" value="Delorean"/>
	  <property name="vanillaTvolOnly"   value="false"/>   <!-- enables 3 modes -->
	  <property name="tvolHoverForceMul" value="1.03"/>
	  <property name="tvolMaxUpSpeed"    value="6"/>
	  <property name="engineThrust"      value="28000"/>
	  <property name="wingArea"          value="24"/>
	  <property name="stallSpeed"        value="16"/>
	  <property name="maxWheelTurnSlots" value="4"/>
	  <property name="wheelTurn0"        value="Wheels/FL_Pivot"/>
	  <property name="wheelTurn1"        value="Wheels/FR_Pivot"/>
	  <property name="wheelTurn2"        value="Wheels/RL_Pivot"/>
	  <property name="wheelTurn3"        value="Wheels/RR_Pivot"/>
	  <property name="wheelTurnTVOLDeg"  value="90"/>
	  <!-- Optional transition sounds -->
	  <property name="soundVanillaToTvol" value="Vehicles/delorean_transform"/>
	  <property name="soundTvolToVanilla" value="Vehicles/delorean_transform"/>
	  <property name="soundTvolToPlane"   value="Vehicles/airplane_transform"/>
	  <property name="soundPlaneToTvol"   value="Vehicles/airplane_transform"/>
  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   AIRPLANE — ALL OPTIONS                                              -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Airplane_Full">

	  <!-- ─── Flight Mode ────────────────────────────────────────────── -->
	  <property name="vehicleFlightMode" value="Plane"/>

	  <!-- ─── Engine ─────────────────────────────────────────────────── -->
	  <!-- engineThrust: forward thrust in Newtons.                      -->
	  <!-- thrustAsAcceleration: ignores mass (Force→Acceleration).      -->
	  <!-- throttleUpRate / throttleDownRate: spool speed (units/sec).   -->
	  <!-- idleThrottle: minimum throttle while engine is running (0-1). -->
	  <property name="engineThrust"         value="32000"/>
	  <property name="thrustAsAcceleration" value="false"/>
	  <property name="throttleUpRate"       value="2.5"/>
	  <property name="throttleDownRate"     value="1.2"/>
	  <property name="idleThrottle"         value="0.06"/>

	  <!-- ─── Aerodynamics ───────────────────────────────────────────── -->
	  <!-- wingArea: wing surface (m²). More = more lift + drag.         -->
	  <!-- airDensity: kg/m³. Sea level = 1.225.                         -->
	  <!-- stallSpeed: below this speed lift drops to zero (m/s).        -->
	  <!-- liftScale: global lift multiplier.                            -->
	  <!-- maxAoADeg: max angle of attack before stall (degrees).        -->
	  <!-- maxLiftG: max G-force from lift.                              -->
	  <property name="wingArea"    value="28"/>
	  <property name="airDensity"  value="1.225"/>
	  <property name="stallSpeed"  value="18"/>
	  <property name="liftScale"   value="0.90"/>
	  <property name="maxAoADeg"   value="22"/>
	  <property name="maxLiftG"    value="2.8"/>

	  <!-- ─── Drag ───────────────────────────────────────────────────── -->
	  <!-- baseDrag: parasitic drag coefficient.                         -->
	  <!-- inducedDrag: drag from generating lift (increases with AoA).  -->
	  <!-- sideDrag: lateral drag (prevents sideways sliding).           -->
	  <!-- verticalDrag: vertical drag component.                        -->
	  <property name="baseDrag"     value="0.016"/>
	  <property name="inducedDrag"  value="0.050"/>
	  <property name="sideDrag"     value="0.9"/>
	  <property name="verticalDrag" value="0.35"/>

	  <!-- ─── Control Torques ────────────────────────────────────────── -->
	  <!-- pitchTorque: nose up/down.  rollTorque: banking.              -->
	  <!-- yawTorque: rudder. turnCoordination: auto-yaw in banks (0-1). -->
	  <!-- angularDamping: how fast rotation decays after input release.  -->
	  <!-- controlDeadZone: inputs below this are ignored (0-1).         -->
	  <!-- aileronMaxAngle: max aileron deflection (degrees).            -->
	  <!-- elevatorMaxAngle: max elevator deflection (degrees).          -->
	  <!-- surfaceSpeed: deg/sec for all control surface animations.     -->
	  <!-- invertPitch: reverses pitch input direction.                  -->
	  <property name="pitchTorque"      value="2600"/>
	  <property name="rollTorque"       value="5200"/>
	  <property name="yawTorque"        value="650"/>
	  <property name="turnCoordination" value="0.08"/>
	  <property name="angularDamping"   value="0.995"/>
	  <property name="controlDeadZone"  value="0.08"/>
	  <property name="aileronMaxAngle"  value="25"/>
	  <property name="elevatorMaxAngle" value="20"/>
	  <property name="surfaceSpeed"     value="120"/>
	  <property name="invertPitch"      value="false"/>

	  <!-- ─── SAS ────────────────────────────────────────────────────── -->
	  <!-- Auto-levels wings when player is not rolling.                 -->
	  <!-- planeSASTorque: strength. planeSASAngDamp: damping during SAS.-->
	  <property name="planeSAS"        value="true"/>
	  <property name="planeSASTorque"  value="6000"/>
	  <property name="planeSASAngDamp" value="0.985"/>

	  <!-- ─── Takeoff Assist ─────────────────────────────────────────── -->
	  <!-- Extra lift at low speed. Fades above stallSpeed*speedMul.     -->
	  <!-- takeoffAssistMax: extra lift factor (0 = disabled).           -->
	  <property name="takeoffAssistEnabled"  value="true"/>
	  <property name="takeoffAssistMax"      value="0.35"/>
	  <property name="takeoffAssistSpeedMul" value="1.2"/>

	  <!-- ─── Fall Behavior ──────────────────────────────────────────── -->
	  <!-- Extra gravity when airborne and slow. Prevents floating.      -->
	  <!-- fallSpeedThreshold: speed below which extra gravity starts.   -->
	  <!-- extraFallMultiplier: strength of extra gravity.               -->
	  <property name="fallSpeedThreshold"  value="16"/>
	  <property name="extraFallMultiplier" value="1.6"/>

	  <!-- ─── Control Surfaces ───────────────────────────────────────── -->
	  <!-- Single paths (legacy) or use slot arrays below.               -->
	  <property name="aileronLeftPath"  value="Surfaces/AileronL"/>
	  <property name="aileronRightPath" value="Surfaces/AileronR"/>
	  <property name="elevatorPath"     value="Surfaces/Elevator"/>
	  <property name="rudderPath"       value="Surfaces/Rudder"/>
	  <!-- Slot arrays: elevator0..N, rudder0..N override single paths.  -->
	  <property name="maxElevatorSlots" value="2"/>
	  <property name="maxRudderSlots"   value="2"/>
	  <property name="elevator0"        value="Surfaces/ElevatorL"/>
	  <property name="elevator1"        value="Surfaces/ElevatorR"/>
	  <property name="rudder0"          value="Surfaces/RudderTop"/>
	  <property name="rudder1"          value="Surfaces/RudderBot"/>
	  <property name="aileronAxisLocal"  value="0,0,1"/>
	  <property name="elevatorAxisLocal" value="1,0,0"/>
	  <property name="rudderAxisLocal"   value="0,1,0"/>
	  <property name="rudderMaxAngle"    value="25"/>

	  <!-- ─── Flaps ──────────────────────────────────────────────────── -->
	  <!-- Auto-deploy when grounded (takeoff) or slow airborne (land).  -->
	  <!-- Retract at flapRetractMinSpeed.                               -->
	  <property name="flapLeftPath"        value="Surfaces/FlapL"/>
	  <property name="flapRightPath"       value="Surfaces/FlapR"/>
	  <property name="flapTakeoffAngle"    value="12"/>
	  <property name="flapLandingAngle"    value="25"/>
	  <property name="flapSpeed"           value="90"/>
	  <property name="flapAxisLocal"       value="1,0,0"/>
	  <property name="flapTakeoffMaxSpeed" value="30"/>
	  <property name="flapLandingMaxSpeed" value="22"/>
	  <property name="flapRetractMinSpeed" value="35"/>

	  <!-- ─── Wheel Visuals (spin) ───────────────────────────────────── -->
	  <!-- Spin while driving. NOT the WheelColliders (those are in Physics/) -->
	  <!-- Slots: wheel0..wheelN  (preferred)                            -->
	  <!-- Legacy: wheelRearVisualPath, wheelLeftVisualPath, etc.        -->
	  <property name="maxWheelVisualSlots" value="3"/>
	  <property name="wheel0"              value="Wheels/Rear"/>
	  <property name="wheel1"              value="Wheels/Left"/>
	  <property name="wheel2"              value="Wheels/Right"/>
	  <property name="wheelSpinAxisLocal"  value="1,0,0"/>
	  <property name="wheelSpinSpeed"      value="120"/>

	  <!-- ─── Wheel Physics Suppression ──────────────────────────────── -->
	  <!-- Disables WheelColliders at altitude to avoid ghost collisions. -->
	  <!-- wheelDisableSpeedMul: suppress threshold = stallSpeed * this.  -->
	  <!-- wheelEnableAgl: re-enable when AGL below this (meters).        -->
	  <!-- wheelDisableAgl: disable above this AGL (meters).              -->
	  <property name="wheelDisableSpeedMul"   value="1.05"/>
	  <property name="wheelHighSpeedFriction" value="0.25"/>
	  <property name="wheelHighSpeedSlip"     value="1.6"/>
	  <property name="wheelEnableAgl"         value="2.0"/>
	  <property name="wheelDisableAgl"        value="3.5"/>

	  <!-- ─── Landing Gear ───────────────────────────────────────────── -->
	  <!-- Animator scrubbed t=0 (gear down) to t=1 (gear up).          -->
	  <!-- gearDeployAltitude MUST be less than gearRetractAltitude.     -->
	  <!-- gearUseAltitudeAboveGround: true=AGL raycast, false=world Y.  -->
	  <property name="autoGearEnabled"            value="true"/>
	  <property name="gearAnimatorPath"           value="Animations/GearAnimator"/>
	  <property name="gearAnimStateName"          value="GearAnim"/>
	  <property name="gearAnimSpeed"              value="1.0"/>
	  <property name="gearUseAltitudeAboveGround" value="true"/>
	  <property name="gearRetractAltitude"        value="60"/>
	  <property name="gearDeployAltitude"         value="30"/>
	  <property name="gearRaycastMax"             value="300"/>

	  <!-- ─── Enter/Exit Animations ──────────────────────────────────── -->
	  <!-- Multiple tracks on one Animator. Each scrubs startT→endT on  -->
	  <!-- enter, endT→startT on exit.                                   -->
	  <!-- enterExitAnimSpeed: global speed, overridden per-slot by _speed -->
	  <property name="enterExitAnimEnabled"  value="true"/>
	  <property name="enterExitAnimSlots"    value="2"/>
	  <property name="enterExitAnimatorPath" value="Animations/EnterExit"/>
	  <property name="enterExitAnimSpeed"    value="1.0"/>
	  <property name="enterExitAnim0"        value="CockpitOpen"/>
	  <property name="enterExitAnim0_path"   value="Animations/EnterExit"/>
	  <property name="enterExitAnim0_speed"  value="1.0"/>
	  <property name="enterExitAnim0_start"  value="0.0"/>
	  <property name="enterExitAnim0_end"    value="1.0"/>
	  <property name="enterExitAnim1"        value="LadderExtend"/>
	  <property name="enterExitAnim1_path"   value="Animations/EnterExit"/>
	  <property name="enterExitAnim1_speed"  value="0.8"/>
	  <property name="enterExitAnim1_start"  value="0.0"/>
	  <property name="enterExitAnim1_end"    value="1.0"/>

	  <!-- ─── Propeller Spin ─────────────────────────────────────────── -->
	  <!-- propSpinExtraTVOL: extra RPM% in TVOL mode.                   -->
	  <property name="maxPropSpinSlots"  value="1"/>
	  <property name="propSpin0"         value="Propeller/Blade"/>
	  <property name="propSpinAxisLocal" value="0,0,1"/>
	  <property name="propRpmMax"        value="2200"/>
	  <property name="propSpinExtraTVOL" value="0.15"/>

	  <!-- ─── Engine Distortion FX ───────────────────────────────────── -->
	  <!-- ParticleSystems that play when engine is running.             -->
	  <property name="maxEngineDistortionSlots" value="2"/>
	  <property name="engineDistortion0"        value="Effects/EngineDistort0"/>
	  <property name="engineDistortion1"        value="Effects/EngineDistort1"/>

	  <!-- ─── Flight Gear Sound (engine sound swap) ──────────────────── -->
	  <!-- Replaces the vehicle's VPEngine gear sounds with custom ones  -->
	  <!-- when the aircraft enters flight mode (TVOL or Plane).         -->
	  <!-- flightGear1..N: comma-separated gear definition:              -->
	  <!--   rpmMin,rpmMax,rpmDecel,rpmDownShiftPoint,rpmDownShiftTo,    -->
	  <!--   rpmAccel,rpmUpShiftPoint,rpmUpShiftTo,accelSound,decelSound -->
	  <!--   [,pitchMin,pitchMax,volMin,volMax,fadeMin,fadeMax,fadeRange,name] x N -->
	  <!-- flightSoundGearSlots: max slots to parse (default 4, max 8). -->
	  <!-- Omit these properties to keep the original engine sound.     -->
	  <property name="flightSoundGearSlots" value="1"/>
	  <property name="flightGear1"          value="800,2400,200,900,800,300,2200,2400,Vehicles/airplane_engine_accel,Vehicles/airplane_engine_decel,0.8,1.4,0.4,1.0,800,2400,1600,EngineLoop"/>

	  <!-- ─── TVOL Active Parent ─────────────────────────────────────── -->
	  <!-- GameObject activated ONLY when flightMode == TVOL.           -->
	  <!-- Useful for particles, lights or effects exclusive to TVOL.   -->
	  <property name="tvolActiveParentPath" value="M/TvolEffects"/>

	  <!-- ─── Airplane Mode Active Parent ───────────────────────────── -->
	  <!-- GameObject activated when a player is inside the vehicle.    -->
	  <!-- Deactivated when the player exits.                           -->
	  <property name="airplaneModeActiveParentPath" value="M/CockpitEffects"/>

	  <!-- ─── Rotor Wash ─────────────────────────────────────────────── -->
	  <!-- RotorWashController component drives this automatically.      -->
	  <!-- rotorWashEnabled: master toggle.                              -->
	  <!-- rotorWashDebug: show debug gizmos in editor.                  -->
	  <property name="rotorWashEnabled" value="true"/>
	  <property name="rotorWashDebug"   value="false"/>

	  <!-- ─── Input Keys ─────────────────────────────────────────────── -->
	  <property name="yawLeftKey"        value="Q"/>
	  <property name="yawRightKey"       value="R"/>
	  <property name="yawLeftJoyButton"  value="JoystickButton4"/>
	  <property name="yawRightJoyButton" value="JoystickButton5"/>

  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   HELICOPTER (TVOL) — ALL OPTIONS                                     -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Helicopter_Full">

	  <!-- ─── Flight Mode ────────────────────────────────────────────── -->
	  <property name="vehicleFlightMode" value="TVOL"/>
	  <property name="enableTVOL"        value="true"/>
	  <property name="startInTVOL"       value="true"/>
	  <property name="allowTVOLToggle"   value="false"/>
	  <property name="tvolToggleKey"     value="T"/>

	  <!-- ─── TVOL Vertical ──────────────────────────────────────────── -->
	  <!-- tvolHoverForceMul: hover force relative to weight.            -->
	  <!--   1.0 = neutral. >1.0 = slight upward tendency.              -->
	  <!-- tvolMaxUpSpeed: max vertical speed (m/s).                     -->
	  <!-- tvolVyResponse: vertical speed responsiveness.                -->
	  <!-- tvolVyMaxAccel: max vertical acceleration (m/s²).             -->
	  <property name="tvolHoverForceMul" value="1.03"/>
	  <property name="tvolMaxUpSpeed"    value="6"/>
	  <property name="tvolVyResponse"    value="6"/>
	  <property name="tvolVyMaxAccel"    value="18"/>

	  <!-- ─── TVOL Horizontal ────────────────────────────────────────── -->
	  <!-- tvolMaxPlanarSpeed: max horizontal speed (m/s).               -->
	  <!-- tvolForwardSpeedMul: forward limit = planar * this.           -->
	  <!-- tvolTranslationalAccel: horizontal acceleration (m/s²).       -->
	  <!-- tvolMaxTiltDeg: max body tilt for movement (degrees).         -->
	  <property name="tvolMaxPlanarSpeed"     value="10"/>
	  <property name="tvolForwardSpeedMul"    value="1.5"/>
	  <property name="tvolTranslationalAccel" value="22"/>
	  <property name="tvolMaxTiltDeg"         value="25"/>

	  <!-- ─── TVOL Stabilization ─────────────────────────────────────── -->
	  <!-- tvolStabilizeTorque: auto-level strength.                     -->
	  <!-- tvolYawTorque: yaw force.                                     -->
	  <!-- tvolVelDamp: horizontal velocity damping (0.99=slow stop).    -->
	  <!-- tvolAngDamp: angular velocity damping.                        -->
	  <property name="tvolStabilizeTorque" value="10000"/>
	  <property name="tvolYawTorque"       value="20000"/>
	  <property name="tvolVelDamp"         value="0.988"/>
	  <property name="tvolAngDamp"         value="0.985"/>

	  <!-- ─── TVOL Yaw ───────────────────────────────────────────────── -->
	  <!-- tvolUseDirectYaw: true=rate-based (smooth), false=torque.     -->
	  <!-- tvolYawRateDeg: target yaw rate deg/s (direct mode only).     -->
	  <!-- tvolYawRateSmooth: smoothing factor for direct yaw.           -->
	  <property name="tvolUseDirectYaw"  value="false"/>
	  <property name="tvolYawRateDeg"    value="90"/>
	  <property name="tvolYawRateSmooth" value="6"/>

	  <!-- ─── TVOL Strafing (Q/R keys) ───────────────────────────────── -->
	  <!-- Yaw keys also apply lateral force when enabled.               -->
	  <!-- tvolYawStrafeForceMul: strafe force multiplier.               -->
	  <!-- tvolYawStrafeYawMul: 0=pure strafe, 1=pure yaw.              -->
	  <property name="tvolYawStrafeEnabled"  value="true"/>
	  <property name="tvolYawStrafeForceMul" value="1.00"/>
	  <property name="tvolYawStrafeYawMul"   value="0.35"/>

	  <!-- ─── Mode Switch Inertia ────────────────────────────────────── -->
	  <property name="tvolModeSwitchInertiaDuration" value="1.0"/>

	  <!-- ─── Rotor Tilt ─────────────────────────────────────────────── -->
	  <!-- Pivots that tilt between TVOL (vertical) and Plane (forward). -->
	  <!-- rotorTiltTVOLDeg: angle in TVOL mode.                         -->
	  <!-- rotorTiltPlaneDeg: angle in Plane mode.                       -->
	  <!-- rotorTiltSpeed: deg/sec of the tilt animation.                -->
	  <property name="maxRotorTiltSlots"  value="2"/>
	  <property name="rotorTilt0"         value="RotorTiltL"/>
	  <property name="rotorTilt1"         value="RotorTiltR"/>
	  <property name="rotorTiltAxisLocal" value="1,0,0"/>
	  <property name="rotorTiltTVOLDeg"   value="90"/>
	  <property name="rotorTiltPlaneDeg"  value="0"/>
	  <property name="rotorTiltSpeed"     value="120"/>

	  <!-- ─── Rotor Pitch Tilt (W/S visual) ──────────────────────────── -->
	  <!-- Rotors tilt forward/back visually with pitch input. Cosmetic. -->
	  <property name="tvolRotorPitchTiltDegMax" value="25"/>
	  <property name="tvolRotorPitchTiltSmooth" value="8"/>

	  <!-- ─── Rotor Yaw Twist ────────────────────────────────────────── -->
	  <!-- Rotors twist opposite directions during yaw. Cosmetic.        -->
	  <!-- Slot 0 twists +, slot 1 twists -.                             -->
	  <property name="rotorYawTwistEnabled"   value="true"/>
	  <property name="rotorYawTwistDegMax"    value="6"/>
	  <property name="rotorYawTwistAxisLocal" value="0,1,0"/>

	  <!-- ─── Prop Spin ──────────────────────────────────────────────── -->
	  <property name="maxPropSpinSlots"  value="2"/>
	  <property name="propSpin0"         value="RotorTiltL/PropL"/>
	  <property name="propSpin1"         value="RotorTiltR/PropR"/>
	  <property name="propSpinAxisLocal" value="0,0,1"/>
	  <property name="propRpmMax"        value="2400"/>
	  <property name="propSpinExtraTVOL" value="0.2"/>

	  <!-- ─── Shared ─────────────────────────────────────────────────── -->
	  <property name="maxWheelVisualSlots" value="3"/>
	  <property name="wheel0"              value="Wheels/Rear"/>
	  <property name="wheel1"              value="Wheels/Left"/>
	  <property name="wheel2"              value="Wheels/Right"/>
	  <property name="wheelSpinAxisLocal"  value="1,0,0"/>
	  <property name="wheelSpinSpeed"      value="360"/>
	  <property name="wheelEnableAgl"      value="2.0"/>
	  <property name="wheelDisableAgl"     value="3.5"/>

	  <property name="maxEngineDistortionSlots" value="2"/>
	  <property name="engineDistortion0"        value="Effects/EngineDistortL"/>
	  <property name="engineDistortion1"        value="Effects/EngineDistortR"/>

	  <property name="rotorWashEnabled" value="true"/>

	  <property name="fallSpeedThreshold"  value="10"/>
	  <property name="extraFallMultiplier" value="0.5"/>
	  <property name="controlDeadZone"     value="0.08"/>

	  <property name="yawLeftKey"  value="Q"/>
	  <property name="yawRightKey" value="R"/>

  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   OSPREY (HYBRID) — ALL OPTIONS                                       -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--
	Combines Plane + TVOL. T key switches mid-flight.
	Needs BOTH plane AND TVOL parameters.
	Rotors tilt between rotorTiltTVOLDeg and rotorTiltPlaneDeg.
  -->
  <vehicle name="Osprey_Full">

	  <property name="vehicleFlightMode" value="Osprey"/>
	  <property name="enableTVOL"        value="true"/>
	  <property name="startInTVOL"       value="true"/>
	  <property name="allowTVOLToggle"   value="true"/>
	  <property name="tvolToggleKey"     value="T"/>

	  <!-- TVOL -->
	  <property name="tvolHoverForceMul"             value="1.02"/>
	  <property name="tvolMaxUpSpeed"                value="8"/>
	  <property name="tvolVyResponse"                value="6"/>
	  <property name="tvolVyMaxAccel"                value="18"/>
	  <property name="tvolMaxPlanarSpeed"            value="14"/>
	  <property name="tvolForwardSpeedMul"           value="1.5"/>
	  <property name="tvolTranslationalAccel"        value="20"/>
	  <property name="tvolMaxTiltDeg"                value="22"/>
	  <property name="tvolStabilizeTorque"           value="9500"/>
	  <property name="tvolYawTorque"                 value="15000"/>
	  <property name="tvolVelDamp"                   value="0.99"/>
	  <property name="tvolAngDamp"                   value="0.985"/>
	  <property name="tvolYawStrafeEnabled"          value="true"/>
	  <property name="tvolYawStrafeForceMul"         value="1.0"/>
	  <property name="tvolYawStrafeYawMul"           value="0.25"/>
	  <property name="tvolModeSwitchInertiaDuration" value="1.0"/>
	  <property name="tvolUseDirectYaw"              value="false"/>
	  <property name="tvolYawRateDeg"                value="90"/>
	  <property name="tvolYawRateSmooth"             value="6"/>

	  <!-- Plane -->
	  <property name="engineThrust"         value="30000"/>
	  <property name="thrustAsAcceleration" value="false"/>
	  <property name="throttleUpRate"       value="2.5"/>
	  <property name="throttleDownRate"     value="1.2"/>
	  <property name="idleThrottle"         value="0.06"/>
	  <property name="wingArea"             value="30"/>
	  <property name="airDensity"           value="1.225"/>
	  <property name="stallSpeed"           value="16"/>
	  <property name="liftScale"            value="0.90"/>
	  <property name="maxAoADeg"            value="22"/>
	  <property name="maxLiftG"             value="2.8"/>
	  <property name="baseDrag"             value="0.016"/>
	  <property name="inducedDrag"          value="0.050"/>
	  <property name="sideDrag"             value="0.9"/>
	  <property name="verticalDrag"         value="0.35"/>
	  <property name="pitchTorque"          value="2600"/>
	  <property name="rollTorque"           value="5200"/>
	  <property name="yawTorque"            value="650"/>
	  <property name="turnCoordination"     value="0.08"/>
	  <property name="angularDamping"       value="0.995"/>
	  <property name="controlDeadZone"      value="0.08"/>
	  <property name="planeSAS"             value="true"/>
	  <property name="planeSASTorque"       value="6000"/>
	  <property name="planeSASAngDamp"      value="0.985"/>
	  <property name="takeoffAssistEnabled" value="true"/>
	  <property name="takeoffAssistMax"     value="0.30"/>
	  <property name="fallSpeedThreshold"   value="14"/>
	  <property name="extraFallMultiplier"  value="1.2"/>

	  <!-- Tiltrotor visuals -->
	  <property name="maxRotorTiltSlots"        value="2"/>
	  <property name="rotorTilt0"               value="RotorTiltL"/>
	  <property name="rotorTilt1"               value="RotorTiltR"/>
	  <property name="rotorTiltAxisLocal"       value="1,0,0"/>
	  <property name="rotorTiltTVOLDeg"         value="90"/>
	  <property name="rotorTiltPlaneDeg"        value="0"/>
	  <property name="rotorTiltSpeed"           value="120"/>
	  <property name="tvolRotorPitchTiltDegMax" value="20"/>
	  <property name="tvolRotorPitchTiltSmooth" value="8"/>
	  <property name="rotorYawTwistEnabled"     value="true"/>
	  <property name="rotorYawTwistDegMax"      value="5"/>
	  <property name="rotorYawTwistAxisLocal"   value="0,1,0"/>

	  <property name="maxPropSpinSlots"  value="2"/>
	  <property name="propSpin0"         value="RotorTiltL/PropL"/>
	  <property name="propSpin1"         value="RotorTiltR/PropR"/>
	  <property name="propSpinAxisLocal" value="0,0,1"/>
	  <property name="propRpmMax"        value="2400"/>
	  <property name="propSpinExtraTVOL" value="0.15"/>

	  <!-- Landing gear -->
	  <property name="autoGearEnabled"            value="true"/>
	  <property name="gearAnimatorPath"           value="Animations/GearAnimator"/>
	  <property name="gearAnimStateName"          value="GearAnim"/>
	  <property name="gearAnimSpeed"              value="1.0"/>
	  <property name="gearUseAltitudeAboveGround" value="true"/>
	  <property name="gearRetractAltitude"        value="60"/>
	  <property name="gearDeployAltitude"         value="30"/>
	  <property name="gearRaycastMax"             value="300"/>

	  <property name="maxWheelVisualSlots" value="3"/>
	  <property name="wheel0"              value="Wheels/Rear"/>
	  <property name="wheel1"              value="Wheels/Left"/>
	  <property name="wheel2"              value="Wheels/Right"/>
	  <property name="wheelSpinAxisLocal"  value="1,0,0"/>
	  <property name="wheelSpinSpeed"      value="200"/>
	  <property name="wheelDisableSpeedMul"   value="1.05"/>
	  <property name="wheelHighSpeedFriction" value="0.25"/>
	  <property name="wheelHighSpeedSlip"     value="1.6"/>
	  <property name="wheelEnableAgl"         value="2.0"/>
	  <property name="wheelDisableAgl"        value="3.5"/>

	  <property name="maxEngineDistortionSlots" value="2"/>
	  <property name="engineDistortion0"        value="Effects/EngineDistortL"/>
	  <property name="engineDistortion1"        value="Effects/EngineDistortR"/>

	  <property name="rotorWashEnabled" value="true"/>
	  <property name="yawLeftKey"       value="Q"/>
	  <property name="yawRightKey"      value="R"/>

	  <!-- ─── Transition Sounds ──────────────────────────────────────── -->
	  <!-- One-shot sound when switching between TVOL and Plane (Osprey).-->
	  <!-- Omit the property or leave empty to play no sound.            -->
	  <property name="soundTvolToPlane" value="Vehicles/osprey_transform"/>
	  <property name="soundPlaneToTvol" value="Vehicles/osprey_transform"/>

  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   DELOREAN (FLYING CAR) 2 MODES — ALL OPTIONS  (Vanilla ↔ TVOL)      -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--
	Ground vehicle that switches to TVOL. No Plane mode.
	vanillaTvolOnly = true is set automatically by vehicleFlightMode=Delorean.

	WHEEL TURN vs WHEEL SPIN:
	  wheelTurnN → PIVOT parent. Rotates on mode switch. No spin.
	  wheelN     → WHEEL MESH child. Spins while driving.
				   Must be child of pivot to inherit the turn rotation.
  -->
  <vehicle name="Delorean_2modes_Full">

	  <!-- ─── Flight Mode ────────────────────────────────────────────── -->
	  <property name="vehicleFlightMode" value="Delorean"/>
	  <property name="enableTVOL"        value="true"/>
	  <!-- vanillaTvolOnly = true auto-set by Delorean mode. Explicit:  -->
	  <property name="vanillaTvolOnly"   value="true"/>
	  <property name="allowTVOLToggle"   value="true"/>
	  <property name="tvolToggleKey"     value="T"/>

	  <!-- ─── TVOL ───────────────────────────────────────────────────── -->
	  <property name="tvolHoverForceMul"             value="1.03"/>
	  <property name="tvolMaxUpSpeed"                value="8"/>
	  <property name="tvolVyResponse"                value="6"/>
	  <property name="tvolVyMaxAccel"                value="18"/>
	  <property name="tvolMaxPlanarSpeed"            value="14"/>
	  <property name="tvolForwardSpeedMul"           value="1.5"/>
	  <property name="tvolTranslationalAccel"        value="20"/>
	  <property name="tvolMaxTiltDeg"                value="20"/>
	  <property name="tvolStabilizeTorque"           value="9500"/>
	  <property name="tvolYawTorque"                 value="16000"/>
	  <property name="tvolVelDamp"                   value="0.99"/>
	  <property name="tvolAngDamp"                   value="0.985"/>
	  <property name="tvolYawStrafeEnabled"          value="true"/>
	  <property name="tvolYawStrafeForceMul"         value="1.0"/>
	  <property name="tvolYawStrafeYawMul"           value="0.3"/>
	  <property name="tvolModeSwitchInertiaDuration" value="1.2"/>
	  <property name="tvolUseDirectYaw"              value="false"/>
	  <property name="tvolYawRateDeg"                value="90"/>
	  <property name="tvolYawRateSmooth"             value="6"/>
	  <property name="controlDeadZone"               value="0.08"/>

	  <!-- ─── Wheel Turn — pivots rotate on mode switch ──────────────── -->
	  <!-- wheelTurnAxisLocal: local rotation axis of the pivot.         -->
	  <!--   0,1,0 = local Y → wheels face up in TVOL mode.             -->
	  <!-- wheelTurnVanillaDeg: angle in car/ground mode.               -->
	  <!-- wheelTurnTVOLDeg: angle when entering TVOL/flight.           -->
	  <!-- wheelTurnSpeed: deg/sec of the rotation animation.           -->
	  <!-- wheelTurnUseTireTransform: true = use the WheelCollider       -->
	  <!--   transform as pivot instead of the XML node.                -->
	  <property name="maxWheelTurnSlots"         value="4"/>
	  <property name="wheelTurn0"                value="Wheels/FL_Pivot"/>
	  <property name="wheelTurn1"                value="Wheels/FR_Pivot"/>
	  <property name="wheelTurn2"                value="Wheels/RL_Pivot"/>
	  <property name="wheelTurn3"                value="Wheels/RR_Pivot"/>
	  <property name="wheelTurnAxisLocal"        value="0,1,0"/>
	  <property name="wheelTurnVanillaDeg"       value="0"/>
	  <property name="wheelTurnTVOLDeg"          value="90"/>
	  <property name="wheelTurnSpeed"            value="60"/>
	  <property name="wheelTurnUseTireTransform" value="false"/>

	  <!-- ─── Wheel Spin — children of the pivots ───────────────────── -->
	  <property name="maxWheelVisualSlots" value="4"/>
	  <property name="wheel0"              value="Wheels/FL_Pivot/WheelFL"/>
	  <property name="wheel1"              value="Wheels/FR_Pivot/WheelFR"/>
	  <property name="wheel2"              value="Wheels/RL_Pivot/WheelRL"/>
	  <property name="wheel3"              value="Wheels/RR_Pivot/WheelRR"/>
	  <property name="wheelSpinAxisLocal"  value="1,0,0"/>
	  <property name="wheelSpinSpeed"      value="180"/>

	  <!-- ─── Wheel Suppression ──────────────────────────────────────── -->
	  <property name="wheelDisableSpeedMul"   value="1.05"/>
	  <property name="wheelHighSpeedFriction" value="0.25"/>
	  <property name="wheelHighSpeedSlip"     value="1.6"/>
	  <property name="wheelEnableAgl"         value="2.0"/>
	  <property name="wheelDisableAgl"        value="3.5"/>

	  <!-- ─── Rotor Tilt — engines tilt when entering TVOL ──────────── -->
	  <property name="maxRotorTiltSlots"        value="2"/>
	  <property name="rotorTilt0"               value="RotorTiltL"/>
	  <property name="rotorTilt1"               value="RotorTiltR"/>
	  <property name="rotorTiltAxisLocal"       value="1,0,0"/>
	  <property name="rotorTiltTVOLDeg"         value="90"/>
	  <property name="rotorTiltPlaneDeg"        value="0"/>
	  <property name="rotorTiltSpeed"           value="80"/>
	  <property name="tvolRotorPitchTiltDegMax" value="20"/>
	  <property name="tvolRotorPitchTiltSmooth" value="8"/>
	  <property name="rotorYawTwistEnabled"     value="true"/>
	  <property name="rotorYawTwistDegMax"      value="5"/>
	  <property name="rotorYawTwistAxisLocal"   value="0,1,0"/>

	  <!-- ─── Prop Spin ──────────────────────────────────────────────── -->
	  <property name="maxPropSpinSlots"  value="2"/>
	  <property name="propSpin0"         value="RotorTiltL/PropL"/>
	  <property name="propSpin1"         value="RotorTiltR/PropR"/>
	  <property name="propSpinAxisLocal" value="0,0,1"/>
	  <property name="propRpmMax"        value="2400"/>
	  <property name="propSpinExtraTVOL" value="0.15"/>

	  <!-- ─── Engine FX ──────────────────────────────────────────────── -->
	  <property name="maxEngineDistortionSlots" value="2"/>
	  <property name="engineDistortion0"        value="Effects/EngineDistortL"/>
	  <property name="engineDistortion1"        value="Effects/EngineDistortR"/>

	  <!-- ─── Rotor Wash ─────────────────────────────────────────────── -->
	  <property name="rotorWashEnabled" value="true"/>

	  <!-- ─── Fall ───────────────────────────────────────────────────── -->
	  <property name="fallSpeedThreshold"  value="12"/>
	  <property name="extraFallMultiplier" value="0.8"/>

	  <!-- ─── Keys ───────────────────────────────────────────────────── -->
	  <property name="yawLeftKey"  value="Q"/>
	  <property name="yawRightKey" value="R"/>

	  <!-- ─── Transition Sounds ──────────────────────────────────────── -->
	  <!-- One-shot sound when pressing T to switch mode.                -->
	  <!-- Use any valid game sound path.                                -->
	  <!-- Omit the property or leave empty to play no sound.            -->
	  <property name="soundVanillaToTvol" value="Vehicles/delorean_transform"/>
	  <property name="soundTvolToVanilla" value="Vehicles/delorean_transform"/>

  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   DELOREAN (FLYING CAR) 3 MODES — ALL OPTIONS                        -->
  <!--   Vanilla → TVOL → Plane → Vanilla                                   -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Delorean_3modes_Full">

	  <property name="vehicleFlightMode" value="Delorean"/>
	  <property name="enableTVOL"        value="true"/>
	  <property name="vanillaTvolOnly"   value="false"/>   <!-- enables 3 modes -->
	  <property name="allowTVOLToggle"   value="true"/>
	  <property name="tvolToggleKey"     value="T"/>

	  <!-- TVOL (same as 2-mode) -->
	  <property name="tvolHoverForceMul"             value="1.03"/>
	  <property name="tvolMaxUpSpeed"                value="8"/>
	  <property name="tvolVyResponse"                value="6"/>
	  <property name="tvolVyMaxAccel"                value="18"/>
	  <property name="tvolMaxPlanarSpeed"            value="14"/>
	  <property name="tvolForwardSpeedMul"           value="1.5"/>
	  <property name="tvolTranslationalAccel"        value="20"/>
	  <property name="tvolMaxTiltDeg"                value="20"/>
	  <property name="tvolStabilizeTorque"           value="9500"/>
	  <property name="tvolYawTorque"                 value="16000"/>
	  <property name="tvolVelDamp"                   value="0.99"/>
	  <property name="tvolAngDamp"                   value="0.985"/>
	  <property name="tvolYawStrafeEnabled"          value="true"/>
	  <property name="tvolYawStrafeForceMul"         value="1.0"/>
	  <property name="tvolYawStrafeYawMul"           value="0.3"/>
	  <property name="tvolModeSwitchInertiaDuration" value="1.2"/>

	  <!-- Plane (required for the 3rd mode) -->
	  <property name="engineThrust"         value="28000"/>
	  <property name="thrustAsAcceleration" value="false"/>
	  <property name="throttleUpRate"       value="2.5"/>
	  <property name="throttleDownRate"     value="1.2"/>
	  <property name="idleThrottle"         value="0.06"/>
	  <property name="wingArea"             value="26"/>
	  <property name="airDensity"           value="1.225"/>
	  <property name="stallSpeed"           value="18"/>
	  <property name="liftScale"            value="0.90"/>
	  <property name="maxAoADeg"            value="20"/>
	  <property name="maxLiftG"             value="2.5"/>
	  <property name="baseDrag"             value="0.018"/>
	  <property name="inducedDrag"          value="0.055"/>
	  <property name="sideDrag"             value="0.9"/>
	  <property name="verticalDrag"         value="0.35"/>
	  <property name="pitchTorque"          value="2400"/>
	  <property name="rollTorque"           value="4800"/>
	  <property name="yawTorque"            value="600"/>
	  <property name="turnCoordination"     value="0.08"/>
	  <property name="angularDamping"       value="0.995"/>
	  <property name="controlDeadZone"      value="0.08"/>
	  <property name="planeSAS"             value="true"/>
	  <property name="planeSASTorque"       value="5500"/>
	  <property name="planeSASAngDamp"      value="0.985"/>
	  <property name="takeoffAssistEnabled" value="true"/>
	  <property name="takeoffAssistMax"     value="0.30"/>
	  <property name="fallSpeedThreshold"   value="14"/>
	  <property name="extraFallMultiplier"  value="1.2"/>

	  <!-- Wheel Turn, Spin, Rotor Tilt, Props (same as 2-mode) -->
	  <property name="maxWheelTurnSlots"   value="4"/>
	  <property name="wheelTurn0"          value="Wheels/FL_Pivot"/>
	  <property name="wheelTurn1"          value="Wheels/FR_Pivot"/>
	  <property name="wheelTurn2"          value="Wheels/RL_Pivot"/>
	  <property name="wheelTurn3"          value="Wheels/RR_Pivot"/>
	  <property name="wheelTurnAxisLocal"  value="0,1,0"/>
	  <property name="wheelTurnVanillaDeg" value="0"/>
	  <property name="wheelTurnTVOLDeg"    value="90"/>
	  <property name="wheelTurnSpeed"      value="60"/>

	  <property name="maxWheelVisualSlots" value="4"/>
	  <property name="wheel0"              value="Wheels/FL_Pivot/WheelFL"/>
	  <property name="wheel1"              value="Wheels/FR_Pivot/WheelFR"/>
	  <property name="wheel2"              value="Wheels/RL_Pivot/WheelRL"/>
	  <property name="wheel3"              value="Wheels/RR_Pivot/WheelRR"/>
	  <property name="wheelSpinAxisLocal"  value="1,0,0"/>
	  <property name="wheelSpinSpeed"      value="180"/>
	  <property name="wheelDisableSpeedMul"   value="1.05"/>
	  <property name="wheelHighSpeedFriction" value="0.25"/>
	  <property name="wheelHighSpeedSlip"     value="1.6"/>
	  <property name="wheelEnableAgl"         value="2.0"/>
	  <property name="wheelDisableAgl"        value="3.5"/>

	  <property name="maxRotorTiltSlots"        value="2"/>
	  <property name="rotorTilt0"               value="RotorTiltL"/>
	  <property name="rotorTilt1"               value="RotorTiltR"/>
	  <property name="rotorTiltAxisLocal"       value="1,0,0"/>
	  <property name="rotorTiltTVOLDeg"         value="90"/>
	  <property name="rotorTiltPlaneDeg"        value="0"/>
	  <property name="rotorTiltSpeed"           value="80"/>
	  <property name="tvolRotorPitchTiltDegMax" value="20"/>
	  <property name="tvolRotorPitchTiltSmooth" value="8"/>
	  <property name="rotorYawTwistEnabled"     value="true"/>
	  <property name="rotorYawTwistDegMax"      value="5"/>
	  <property name="rotorYawTwistAxisLocal"   value="0,1,0"/>

	  <property name="maxPropSpinSlots"  value="2"/>
	  <property name="propSpin0"         value="RotorTiltL/PropL"/>
	  <property name="propSpin1"         value="RotorTiltR/PropR"/>
	  <property name="propSpinAxisLocal" value="0,0,1"/>
	  <property name="propRpmMax"        value="2400"/>
	  <property name="propSpinExtraTVOL" value="0.15"/>

	  <property name="maxEngineDistortionSlots" value="2"/>
	  <property name="engineDistortion0"        value="Effects/EngineDistortL"/>
	  <property name="engineDistortion1"        value="Effects/EngineDistortR"/>
	  <property name="rotorWashEnabled"         value="true"/>
	  <property name="yawLeftKey"               value="Q"/>
	  <property name="yawRightKey"              value="R"/>

	  <!-- ─── Transition Sounds ──────────────────────────────────────── -->
	  <!-- One-shot sound when pressing T to switch mode.                -->
	  <!-- Use any valid game sound path.                                -->
	  <!-- Omit the property or leave empty to play no sound.            -->
	  <!-- All 5 transition pairs are available in 3-mode.              -->
	  <property name="soundVanillaToTvol"  value="Vehicles/delorean_transform"/>
	  <property name="soundTvolToVanilla"  value="Vehicles/delorean_transform"/>
	  <property name="soundTvolToPlane"    value="Vehicles/airplane_transform"/>
	  <property name="soundPlaneToTvol"    value="Vehicles/airplane_transform"/>
	  <!-- soundPlaneToVanilla: Plane → Car (3-mode Delorean only).     -->
	  <property name="soundPlaneToVanilla" value="Vehicles/delorean_transform"/>

  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   CONTROLS REFERENCE                                                  -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--
	PLANE MODE:
	● W/S        → Throttle up / Brake
	● A/D        → Roll left/right
	● Space      → Pitch up
	● C/Ctrl     → Pitch down
	● Q/R        → Yaw left/right

	TVOL MODE:
	● Space/C    → Ascend / Descend
	● W/S        → Pitch (tilt forward/back)
	● A/D        → Roll (tilt left/right)
	● Q/R        → Strafe + Yaw

	DELOREAN 2 MODES:
	● T          → Car ↔ TVOL

	DELOREAN 3 MODES:
	● T          → Car → TVOL → Plane → Car

	OSPREY:
	● T          → TVOL ↔ Plane
  -->


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   PROPERTY REFERENCE — COMPLETE TABLE                                 -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--
	┌────────────────────────────────────┬────────┬──────────┬──────────────────┐
	│ Key                                │ Type   │ Default  │ Mode             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ FLIGHT MODE                        │        │          │                  │
	│ vehicleFlightMode                  │ string │ ""       │ All              │
	│   Values: Plane, TVOL, Osprey,     │        │          │                  │
	│           Delorean                 │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ MODE TOGGLES                       │        │          │                  │
	│ enableTVOL                         │ bool   │ false    │ TVOL/Osprey/Del  │
	│ startInTVOL                        │ bool   │ false    │ TVOL/Osprey      │
	│ allowTVOLToggle                    │ bool   │ false    │ Osprey/Delorean  │
	│ tvolToggleKey                      │ string │ T        │ Osprey/Delorean  │
	│ enableVanillaCycle                 │ bool   │ false    │ Delorean         │
	│ vanillaTvolOnly                    │ bool   │ false    │ Delorean         │
	│   true  → 2 modes: Vanilla ↔ TVOL │        │          │                  │
	│   false → 3 modes: Van→TVOL→Plane │        │          │                  │
	│   (auto true with Delorean mode)   │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ ENGINE                             │        │          │                  │
	│ engineThrust                       │ float  │ 32000    │ Plane/3-mode Del │
	│ thrustAsAcceleration               │ bool   │ false    │ Plane            │
	│ throttleUpRate                     │ float  │ 2.5      │ All              │
	│ throttleDownRate                   │ float  │ 1.2      │ All              │
	│ idleThrottle                       │ float  │ 0.06     │ All              │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ AERODYNAMICS                       │        │          │                  │
	│ wingArea                           │ float  │ 28       │ Plane            │
	│ airDensity                         │ float  │ 1.225    │ Plane            │
	│ stallSpeed                         │ float  │ 18       │ Plane            │
	│ liftScale                          │ float  │ 0.90     │ Plane            │
	│ baseDrag                           │ float  │ 0.016    │ Plane            │
	│ inducedDrag                        │ float  │ 0.050    │ Plane            │
	│ sideDrag                           │ float  │ 0.9      │ Plane            │
	│ verticalDrag                       │ float  │ 0.35     │ Plane            │
	│ maxAoADeg                          │ float  │ 22       │ Plane            │
	│ maxLiftG                           │ float  │ 2.8      │ Plane            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ CONTROL TORQUES                    │        │          │                  │
	│ pitchTorque                        │ float  │ 2600     │ Plane            │
	│ rollTorque                         │ float  │ 5200     │ Plane            │
	│ yawTorque                          │ float  │ 650      │ Plane            │
	│ turnCoordination                   │ float  │ 0.08     │ Plane            │
	│ angularDamping                     │ float  │ 0.995    │ Plane            │
	│ controlDeadZone                    │ float  │ 0.08     │ All              │
	│ aileronMaxAngle                    │ float  │ 25       │ Plane            │
	│ elevatorMaxAngle                   │ float  │ 20       │ Plane            │
	│ surfaceSpeed                       │ float  │ 120      │ Plane            │
	│ invertPitch                        │ bool   │ false    │ All              │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ SAS                                │        │          │                  │
	│ planeSAS                           │ bool   │ true     │ Plane            │
	│ planeSASTorque                     │ float  │ 6000     │ Plane            │
	│ planeSASAngDamp                    │ float  │ 0.985    │ Plane            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ TAKEOFF ASSIST                     │        │          │                  │
	│ takeoffAssistEnabled               │ bool   │ true     │ Plane            │
	│ takeoffAssistMax                   │ float  │ 0.35     │ Plane            │
	│ takeoffAssistSpeedMul              │ float  │ 1.2      │ Plane            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ FALL                               │        │          │                  │
	│ fallSpeedThreshold                 │ float  │ 16       │ All              │
	│ extraFallMultiplier                │ float  │ 1.6      │ All              │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ TVOL VERTICAL                      │        │          │                  │
	│ tvolHoverForceMul                  │ float  │ 1.02     │ TVOL             │
	│ tvolMaxUpSpeed                     │ float  │ 10       │ TVOL             │
	│ tvolVyResponse                     │ float  │ 6        │ TVOL             │
	│ tvolVyMaxAccel                     │ float  │ 18       │ TVOL             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ TVOL HORIZONTAL                    │        │          │                  │
	│ tvolMaxPlanarSpeed                 │ float  │ 18       │ TVOL             │
	│ tvolForwardSpeedMul                │ float  │ 1.5      │ TVOL             │
	│ tvolTranslationalAccel             │ float  │ 18       │ TVOL             │
	│ tvolMaxTiltDeg                     │ float  │ 18       │ TVOL             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ TVOL STABILIZATION                 │        │          │                  │
	│ tvolStabilizeTorque                │ float  │ 9000     │ TVOL             │
	│ tvolYawTorque                      │ float  │ 1400     │ TVOL             │
	│ tvolVelDamp                        │ float  │ 0.985    │ TVOL             │
	│ tvolAngDamp                        │ float  │ 0.985    │ TVOL             │
	│ tvolModeSwitchInertiaDuration      │ float  │ 1.0      │ Osprey/Delorean  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ TVOL YAW                           │        │          │                  │
	│ tvolUseDirectYaw                   │ bool   │ false    │ TVOL             │
	│ tvolYawRateDeg                     │ float  │ 90       │ TVOL             │
	│ tvolYawRateSmooth                  │ float  │ 6        │ TVOL             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ TVOL STRAFE                        │        │          │                  │
	│ tvolYawStrafeEnabled               │ bool   │ true     │ TVOL             │
	│ tvolYawStrafeForceMul              │ float  │ 1.0      │ TVOL             │
	│ tvolYawStrafeYawMul                │ float  │ 0.35     │ TVOL             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ TRANSITION SOUNDS                  │        │          │                  │
	│ soundVanillaToTvol                 │ string │ ""       │ Delorean         │
	│ soundTvolToVanilla                 │ string │ ""       │ Delorean         │
	│ soundTvolToPlane                   │ string │ ""       │ Delorean/Osprey  │
	│ soundPlaneToTvol                   │ string │ ""       │ Delorean/Osprey  │
	│ soundPlaneToVanilla                │ string │ ""       │ Delorean 3-mode  │
	│   One-shot on mode switch.         │        │          │                  │
	│   Empty or absent = no sound.      │        │          │                  │
	│   Use valid game paths:            │        │          │                  │
	│   Vehicles/.., misc/.., etc.       │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ ACTIVE PARENT (enable/disable GO)  │        │          │                  │
	│ tvolActiveParentPath               │ string │ ""       │ All              │
	│   GameObject active ONLY in TVOL.  │        │          │                  │
	│   Path relative to Mesh (M/).      │        │          │                  │
	│ airplaneModeActiveParentPath       │ string │ ""       │ All              │
	│   GameObject active when a player  │        │          │                  │
	│   is inside the vehicle (hasDriver)│        │          │                  │
	│   Deactivated on exit.             │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ FLIGHT GEAR SOUND SWAP             │        │          │                  │
	│ flightGear1..flightGear8           │ string │ ""       │ All              │
	│   Replaces VPEngine gear sounds    │        │          │                  │
	│   with custom flight sounds when   │        │          │                  │
	│   entering flight mode.            │        │          │                  │
	│   Format: rpmMin,rpmMax,rpmDecel,  │        │          │                  │
	│   rpmDnPt,rpmDnTo,rpmAccel,        │        │          │                  │
	│   rpmUpPt,rpmUpTo,accelSnd,        │        │          │                  │
	│   decelSnd[,soundRange x N]        │        │          │                  │
	│ flightSoundGearSlots               │ int    │ 4        │ All              │
	│   Max slots to parse (max 8).      │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ CONTROL SURFACES                   │        │          │                  │
	│ aileronLeftPath                    │ string │ ""       │ Plane            │
	│ aileronRightPath                   │ string │ ""       │ Plane            │
	│ elevatorPath                       │ string │ ""       │ Plane            │
	│ elevator0..elevatorN               │ string │ ""       │ Plane            │
	│ maxElevatorSlots                   │ int    │ 16       │ Plane            │
	│ rudderPath                         │ string │ ""       │ Plane            │
	│ rudder0..rudderN                   │ string │ ""       │ Plane            │
	│ maxRudderSlots                     │ int    │ 8        │ Plane            │
	│ aileronAxisLocal                   │ vec3   │ 0,0,1    │ Plane            │
	│ elevatorAxisLocal                  │ vec3   │ 1,0,0    │ Plane            │
	│ rudderAxisLocal                    │ vec3   │ 0,1,0    │ Plane            │
	│ rudderMaxAngle                     │ float  │ 25       │ Plane            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ FLAPS                              │        │          │                  │
	│ flapLeftPath                       │ string │ ""       │ Plane            │
	│ flapRightPath                      │ string │ ""       │ Plane            │
	│ flapTakeoffAngle                   │ float  │ 12       │ Plane            │
	│ flapLandingAngle                   │ float  │ 25       │ Plane            │
	│ flapSpeed                          │ float  │ 90       │ Plane            │
	│ flapAxisLocal                      │ vec3   │ 1,0,0    │ Plane            │
	│ flapTakeoffMaxSpeed                │ float  │ 30       │ Plane            │
	│ flapLandingMaxSpeed                │ float  │ 22       │ Plane            │
	│ flapRetractMinSpeed                │ float  │ 35       │ Plane            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ WHEELS SPIN (visual)               │        │          │                  │
	│ maxWheelVisualSlots                │ int    │ 64       │ All              │
	│ wheel0..wheelN                     │ string │ ""       │ All              │
	│ wheelRearVisualPath (legacy)       │ string │ ""       │ All              │
	│ wheelLeftVisualPath (legacy)       │ string │ ""       │ All              │
	│ wheelRightVisualPath (legacy)      │ string │ ""       │ All              │
	│ wheelSpinAxisLocal                 │ vec3   │ 1,0,0    │ All              │
	│ wheelSpinSpeed                     │ float  │ 120      │ All              │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ WHEELS TURN (pivot — mode switch)  │        │          │                  │
	│ maxWheelTurnSlots                  │ int    │ 8        │ Delorean         │
	│ wheelTurn0..wheelTurnN             │ string │ ""       │ Delorean         │
	│ wheelTurnAxisLocal                 │ vec3   │ 0,1,0    │ Delorean         │
	│ wheelTurnVanillaDeg                │ float  │ 0        │ Delorean         │
	│ wheelTurnTVOLDeg                   │ float  │ 90       │ Delorean         │
	│ wheelTurnSpeed                     │ float  │ 120      │ Delorean         │
	│ wheelTurnUseTireTransform          │ bool   │ false    │ Delorean         │
	│   true = use WheelCollider         │        │          │                  │
	│   transform as pivot.              │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ WHEEL SUPPRESSION                  │        │          │                  │
	│ wheelDisableSpeedMul               │ float  │ 1.05     │ All              │
	│ wheelHighSpeedFriction             │ float  │ 0.25     │ All              │
	│ wheelHighSpeedSlip                 │ float  │ 1.6      │ All              │
	│ wheelEnableAgl                     │ float  │ 2.0      │ All              │
	│ wheelDisableAgl                    │ float  │ 3.5      │ All              │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ LANDING GEAR                       │        │          │                  │
	│ autoGearEnabled                    │ bool   │ true     │ All              │
	│ gearAnimatorPath                   │ string │ ""       │ All              │
	│ gearAnimStateName                  │ string │ ""       │ All              │
	│ gearAnimSpeed                      │ float  │ 1.0      │ All              │
	│ gearUseAltitudeAboveGround         │ bool   │ false    │ All              │
	│ gearRetractAltitude                │ float  │ 60       │ All              │
	│ gearDeployAltitude                 │ float  │ 30       │ All              │
	│ gearRaycastMax                     │ float  │ 300      │ All              │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ ENTER/EXIT ANIMATIONS              │        │          │                  │
	│ enterExitAnimEnabled               │ bool   │ true     │ All              │
	│ enterExitAnimSlots                 │ int    │ 8        │ All              │
	│ enterExitAnimatorPath              │ string │ ""       │ All              │
	│ enterExitAnimSpeed                 │ float  │ 1.0      │ All              │
	│ enterExitAnimN                     │ string │ ""       │ All              │
	│ enterExitAnimN_path                │ string │ ""       │ All              │
	│ enterExitAnimN_speed               │ float  │ 1.0      │ All              │
	│ enterExitAnimN_start               │ float  │ 0.0      │ All              │
	│ enterExitAnimN_end                 │ float  │ 1.0      │ All              │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ ROTOR TILT                         │        │          │                  │
	│ maxRotorTiltSlots                  │ int    │ 8        │ TVOL/Osprey/Del  │
	│ rotorTilt0..rotorTiltN             │ string │ ""       │ TVOL/Osprey/Del  │
	│ rotorTiltAxisLocal                 │ vec3   │ 1,0,0    │ TVOL/Osprey/Del  │
	│ rotorTiltPlaneDeg                  │ float  │ 0        │ TVOL/Osprey/Del  │
	│ rotorTiltTVOLDeg                   │ float  │ 90       │ TVOL/Osprey/Del  │
	│ rotorTiltSpeed                     │ float  │ 120      │ TVOL/Osprey/Del  │
	│ tvolRotorPitchTiltDegMax           │ float  │ 25       │ TVOL             │
	│ tvolRotorPitchTiltSmooth           │ float  │ 8        │ TVOL             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ ROTOR YAW TWIST                    │        │          │                  │
	│ rotorYawTwistEnabled               │ bool   │ true     │ TVOL             │
	│ rotorYawTwistDegMax                │ float  │ 4        │ TVOL             │
	│ rotorYawTwistAxisLocal             │ vec3   │ 0,1,0    │ TVOL             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ PROP SPIN                          │        │          │                  │
	│ maxPropSpinSlots                   │ int    │ 8        │ All              │
	│ propSpin0..propSpinN               │ string │ ""       │ All              │
	│ propSpinAxisLocal                  │ vec3   │ 0,0,1    │ All              │
	│ propRpmMax                         │ float  │ 2200     │ All              │
	│ propSpinExtraTVOL                  │ float  │ 0.15     │ TVOL             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ ENGINE DISTORTION FX               │        │          │                  │
	│ maxEngineDistortionSlots           │ int    │ 8        │ All              │
	│ engineDistortion0..N               │ string │ ""       │ All              │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ ROTOR WASH                         │        │          │                  │
	│ rotorWashEnabled                   │ bool   │ true     │ TVOL/Osprey/Del  │
	│ rotorWashDebug                     │ bool   │ false    │ TVOL/Osprey/Del  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ INPUT KEYS                         │        │          │                  │
	│ yawLeftKey                         │ string │ Q        │ All              │
	│ yawRightKey                        │ string │ R        │ All              │
	│ yawLeftJoyButton                   │ string │ (none)   │ All              │
	│ yawRightJoyButton                  │ string │ (none)   │ All              │
	└────────────────────────────────────┴────────┴──────────┴──────────────────┘

	VECTOR3 FORMAT:   x,y,z   example: 1,0,0  /  0,0.5,1

	SLOT ARRAYS (zero-indexed):
	  wheel0..N            → visual wheel spin meshes
	  wheelTurn0..N        → wheel pivot nodes (Delorean mode switch)
	  rotorTilt0..N        → rotor/engine tilt pivots
	  propSpin0..N         → propeller/rotor blades
	  elevator0..N         → multiple elevators
	  rudder0..N           → multiple rudders
	  engineDistortion0..N → engine distortion FX
	  enterExitAnim0..N    → enter/exit animation tracks

	RULE: gearDeployAltitude < gearRetractAltitude  (always)

	TRANSITION SOUNDS — TABLE:
	  ┌─────────────────────────┬──────────────────────┬──────────────────┐
	  │ Property                │ Transition           │ Mode             │
	  ├─────────────────────────┼──────────────────────┼──────────────────┤
	  │ soundVanillaToTvol      │ Car   → TVOL         │ Delorean         │
	  │ soundTvolToVanilla      │ TVOL  → Car          │ Delorean         │
	  │ soundTvolToPlane        │ TVOL  → Plane        │ Delorean/Osprey  │
	  │ soundPlaneToTvol        │ Plane → TVOL         │ Delorean/Osprey  │
	  │ soundPlaneToVanilla     │ Plane → Car          │ Delorean 3-mode  │
	  └─────────────────────────┴──────────────────────┴──────────────────┘
	  ● Omit property or set value="" = no sound on that transition.
	  ● Use valid game sound paths: Vehicles/..., misc/..., etc.

	NOTES:
	● Nodes under "Physics/" are ignored for all visual features.
	● wheelTurnN = PIVOT parent that rotates. wheelN = wheel mesh child that spins.
	● TVOL Autopilot works automatically without any extra XML.
	● RotorWashController works automatically if the component is present.
	● Engine requires fuel, an engine part and health > 0.
	● enterExitAnimSpeed is the global speed; enterExitAnimN_speed
	  overrides it per individual track.
	● tvolActiveParentPath: activates the GO only in TVOL mode.
	● airplaneModeActiveParentPath: activates the GO when a player is inside;
	  deactivated on exit. Both paths are relative to M/ (Mesh).
	● flightGear1..N: replaces the VPEngine gear sounds with custom ones
	  when entering flight mode. Without them the vanilla engine is silenced
	  but no flight sound plays.
	● wheelTurnUseTireTransform: uses the WheelCollider as the pivot reference
	  instead of the XML node. Useful when both coincide in position.
	● soundPlaneToVanilla only fires in 3-mode Delorean when returning
	  from Plane to Vanilla/Car.
  -->

</aircraft_reference>
