<?xml version="1.0" encoding="utf-8"?>
<!--
  ═══════════════════════════════════════════════════════════════════════════════
  EntityAirplanePro — Referencia Completa de Configuración de Aeronaves  [ESPAÑOL]
  ═══════════════════════════════════════════════════════════════════════════════

  CÓMO FUNCIONA
  ═════════════
  Todas las aeronaves usan la clase de entidad EntityAirplanePro. Soporta cuatro
  modos de vuelo: Plane (ala fija), TVOL (helicóptero/VTOL), Osprey
  (híbrido que alterna entre ambos) y Delorean (vehículo terrestre
  que cambia a vuelo TVOL).

  Las propiedades van dentro del bloque <property> del vehículo en vehicles.xml.

  REQUISITOS DEL MODELO 3D
  ════════════════════════
  Las rutas de nodos son relativas al transform Mesh (búsqueda recursiva).
  Cualquier nodo bajo un GameObject "Physics" es IGNORADO para visuales.

  Ejemplo de jerarquía de avión:
	  VehicleRoot
	  ├── Physics/                    ← Colliders, WheelColliders (ignorados)
	  └── M/ (Mesh)
		  ├── Fuselage/
		  │   ├── LandingFlapL
		  │   └── LandingFlapR
		  ├── Surfaces/
		  │   ├── AileronL
		  │   ├── AileronR
		  │   ├── Elevator
		  │   └── Rudder
		  ├── Wheels/
		  │   ├── Rear
		  │   ├── Left
		  │   └── Right
		  ├── Effects/
		  │   ├── EngineDistort0
		  │   └── EngineDistort1
		  ├── Propeller/Blade
		  └── Animations/
			  ├── GearAnimator
			  └── EnterExit

  Ejemplo de jerarquía de Osprey / Helicóptero:
	  VehicleRoot
	  ├── Physics/
	  └── M/ (Mesh)
		  ├── RotorTiltL/             ← rotorTilt0
		  │   └── PropL/              ← propSpin0
		  ├── RotorTiltR/             ← rotorTilt1
		  │   └── PropR/              ← propSpin1
		  ├── Wheels/
		  └── Effects/

  Ejemplo de jerarquía DeLorean:
	  VehicleRoot
	  ├── Physics/
	  └── M/ (Mesh)
		  ├── Body/
		  ├── Wheels/
		  │   ├── FL_Pivot/           ← wheelTurn0  (pivot rota al cambiar modo)
		  │   │   └── WheelFL         ← wheel0      (malla gira al conducir)
		  │   ├── FR_Pivot/           ← wheelTurn1
		  │   │   └── WheelFR         ← wheel1
		  │   ├── RL_Pivot/           ← wheelTurn2
		  │   │   └── WheelRL         ← wheel2
		  │   └── RR_Pivot/           ← wheelTurn3
		  │       └── WheelRR         ← wheel3
		  ├── RotorTiltL/             ← rotorTilt0
		  │   └── PropL/              ← propSpin0
		  └── RotorTiltR/             ← rotorTilt1
			  └── PropR/              ← propSpin1

  MODOS DE VUELO
  ══════════════
  ● Plane    → Aerodinámica de ala fija: sustentación, resistencia, pérdida, superficies.
  ● TVOL     → Helicóptero/VTOL: hovering, empuje vertical, estabilización.
  ● Osprey   → Híbrido Plane + TVOL. Se alterna con tecla (por defecto T).
			   Ciclo: TVOL → Plane → TVOL
  ● Delorean → Vehículo terrestre (Vanilla) + coche volador TVOL.
			   El ciclo depende de vanillaTvolOnly:
			   true  → Vanilla ↔ TVOL  (2 modos)
			   false → Vanilla → TVOL → Plane → Vanilla  (3 modos)

  SONIDOS DE TRANSICIÓN (Delorean / Osprey)
  ══════════════════════════════════════════
  Sonidos one-shot opcionales al cambiar de modo de vuelo.
  Usa cualquier ruta de sonido válida del juego (ej. Vehicles/..., misc/...).
  Deja vacío u omite la propiedad para no reproducir sonido en esa transición.

	soundVanillaToTvol  → se reproduce al cambiar: Coche → TVOL
	soundTvolToVanilla  → se reproduce al cambiar: TVOL  → Coche
	soundTvolToPlane    → se reproduce al cambiar: TVOL  → Avión
	soundPlaneToTvol    → se reproduce al cambiar: Avión → TVOL
	soundPlaneToVanilla → se reproduce al cambiar: Avión → Coche  (solo Delorean 3 modos)

  CÓMO DECLARAR LA CLASE DE ENTIDAD
  ══════════════════════════════════
  Se necesitan dos archivos separados:

  1) entityclasses.xml  — declara la clase de entidad y propiedades de nivel entidad:

	<append xpath="/entity_classes">
	  <entity_class name="miAeronave">
		<property name="Class"     value="WitosRoot.EntityAirplanePro,suspension"/>
		<property name="Tags"      value="vehicle"/>
		<property name="Parent"    value="Cars"/>
		<property name="Prefab"    value="#@modfolder:Resources/miAeronave.unity3d?miAeronave"/>
		<property name="ModelType" value="Standard"/>
		<!-- ... otras propiedades de nivel entidad ... -->
	  </entity_class>
	</append>

  2) vehicles.xml  — declara las propiedades de vuelo/comportamiento (mismo nombre que entity_class):

	<append xpath="/vehicles">
	  <vehicle name="miAeronave">
		  <property name="vehicleFlightMode" value="Plane"/>
		  <property name="engineThrust"      value="28000"/>
		  <!-- ... resto de propiedades de vuelo ... -->
	  </vehicle>
	</append>

  El <vehicle name> DEBE coincidir exactamente con el <entity_class name>.
  El formato siempre es:  WitosRoot.EntityAirplanePro,suspension
  (namespace WitosRoot, clase EntityAirplanePro, ensamblado suspension)
-->

<aircraft_reference>

  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   AVIÓN — CONFIGURACIÓN MÍNIMA                                        -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Avion_Minimo">
	  <property name="vehicleFlightMode" value="Plane"/>
	  <property name="engineThrust"      value="28000"/>
	  <property name="wingArea"          value="24"/>
	  <property name="stallSpeed"        value="16"/>
  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   HELICÓPTERO — CONFIGURACIÓN MÍNIMA                                  -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Helicoptero_Minimo">
	  <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 MODOS — CONFIGURACIÓN MÍNIMA  (Vanilla ↔ TVOL)          -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Delorean_2modos_Minimo">
	  <property name="vehicleFlightMode" value="Delorean"/>
	  <!-- vanillaTvolOnly = true se activa automáticamente con 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"/>
	  <!-- Sonidos opcionales de transición -->
	  <property name="soundVanillaToTvol" value="Vehicles/delorean_transform"/>
	  <property name="soundTvolToVanilla" value="Vehicles/delorean_transform"/>
  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   DELOREAN 3 MODOS — CONFIGURACIÓN MÍNIMA  (Vanilla → TVOL → Avión)  -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Delorean_3modos_Minimo">
	  <property name="vehicleFlightMode" value="Delorean"/>
	  <property name="vanillaTvolOnly"   value="false"/>   <!-- activa 3 modos -->
	  <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"/>
	  <!-- Sonidos opcionales de transición -->
	  <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>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   AVIÓN — TODAS LAS OPCIONES                                          -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Avion_Completo">

	  <!-- ─── Modo de Vuelo ──────────────────────────────────────────── -->
	  <property name="vehicleFlightMode" value="Plane"/>

	  <!-- ─── Motor ─────────────────────────────────────────────────── -->
	  <!-- engineThrust: empuje hacia delante en Newtons.                -->
	  <!-- thrustAsAcceleration: ignora la masa (Fuerza→Aceleración).    -->
	  <!-- throttleUpRate / throttleDownRate: velocidad de aceleración    -->
	  <!--   del motor (unidades/seg).                                   -->
	  <!-- idleThrottle: aceleración mínima con motor en marcha (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"/>

	  <!-- ─── Aerodinámica ───────────────────────────────────────────── -->
	  <!-- wingArea: superficie alar (m²). Más = más sustentación + resistencia. -->
	  <!-- airDensity: densidad del aire kg/m³. Nivel del mar = 1.225.   -->
	  <!-- stallSpeed: por debajo de esta velocidad la sustentación cae   -->
	  <!--   a cero (m/s).                                               -->
	  <!-- liftScale: multiplicador global de sustentación.              -->
	  <!-- maxAoADeg: ángulo de ataque máximo antes de entrar en pérdida. -->
	  <!-- maxLiftG: fuerza G máxima de la sustentación.                 -->
	  <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"/>

	  <!-- ─── Resistencia Aerodinámica ──────────────────────────────── -->
	  <!-- baseDrag: coeficiente de resistencia parásita.               -->
	  <!-- inducedDrag: resistencia inducida por la sustentación.       -->
	  <!-- sideDrag: resistencia lateral (evita deslizamiento lateral). -->
	  <!-- verticalDrag: componente vertical de resistencia.            -->
	  <property name="baseDrag"     value="0.016"/>
	  <property name="inducedDrag"  value="0.050"/>
	  <property name="sideDrag"     value="0.9"/>
	  <property name="verticalDrag" value="0.35"/>

	  <!-- ─── Pares de Control ───────────────────────────────────────── -->
	  <!-- pitchTorque: morro arriba/abajo.  rollTorque: alabeo.         -->
	  <!-- yawTorque: timón de dirección.                                -->
	  <!-- turnCoordination: guiñada automática en virajes (0-1).        -->
	  <!-- angularDamping: velocidad a la que decae la rotación tras     -->
	  <!--   soltar el input.                                            -->
	  <!-- controlDeadZone: inputs por debajo de esto son ignorados(0-1).-->
	  <!-- aileronMaxAngle: deflexión máxima de alerones (grados).       -->
	  <!-- elevatorMaxAngle: deflexión máxima del elevador (grados).     -->
	  <!-- surfaceSpeed: grados/seg para todas las animaciones de        -->
	  <!--   superficies de control.                                     -->
	  <!-- invertPitch: invierte la dirección del input de cabeceo.      -->
	  <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 ────────────────────────────────────────────────────── -->
	  <!-- Nivela automáticamente las alas cuando el jugador no alabea.  -->
	  <!-- planeSASTorque: intensidad. planeSASAngDamp: amortiguación.   -->
	  <property name="planeSAS"        value="true"/>
	  <property name="planeSASTorque"  value="6000"/>
	  <property name="planeSASAngDamp" value="0.985"/>

	  <!-- ─── Asistencia al Despegue ────────────────────────────────── -->
	  <!-- Sustentación extra a baja velocidad. Desaparece por encima    -->
	  <!-- de stallSpeed * speedMul.                                     -->
	  <!-- takeoffAssistMax: factor de sustentación extra (0 = desact.). -->
	  <property name="takeoffAssistEnabled"  value="true"/>
	  <property name="takeoffAssistMax"      value="0.35"/>
	  <property name="takeoffAssistSpeedMul" value="1.2"/>

	  <!-- ─── Comportamiento en Caída ───────────────────────────────── -->
	  <!-- Gravedad extra cuando está en el aire y va lento.             -->
	  <!-- Evita que el avión flote.                                     -->
	  <!-- fallSpeedThreshold: velocidad por debajo de la cual se activa.-->
	  <!-- extraFallMultiplier: intensidad de la gravedad extra.         -->
	  <property name="fallSpeedThreshold"  value="16"/>
	  <property name="extraFallMultiplier" value="1.6"/>

	  <!-- ─── Superficies de Control ────────────────────────────────── -->
	  <!-- Rutas simples (legacy) o usa los arrays de slots de abajo.    -->
	  <property name="aileronLeftPath"  value="Surfaces/AileronL"/>
	  <property name="aileronRightPath" value="Surfaces/AileronR"/>
	  <property name="elevatorPath"     value="Surfaces/Elevator"/>
	  <property name="rudderPath"       value="Surfaces/Rudder"/>
	  <!-- Arrays de slots: elevator0..N, rudder0..N sustituyen a las    -->
	  <!-- rutas simples.                                                -->
	  <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 ──────────────────────────────────────────────────── -->
	  <!-- Se despliegan automáticamente en tierra (despegue) o cuando  -->
	  <!-- va lento en vuelo (aterrizaje). Se retraen en 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"/>

	  <!-- ─── Ruedas Visuales (giro) ────────────────────────────────── -->
	  <!-- Giran mientras se conduce. NO son los WheelColliders           -->
	  <!-- (esos están en Physics/).                                     -->
	  <!-- Slots: wheel0..wheelN  (recomendado)                          -->
	  <!-- 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"/>

	  <!-- ─── Supresión de Física de Ruedas ────────────────────────── -->
	  <!-- Desactiva los WheelColliders en altitud para evitar           -->
	  <!-- colisiones fantasma.                                          -->
	  <!-- wheelDisableSpeedMul: umbral = stallSpeed * este valor.       -->
	  <!-- wheelEnableAgl: reactiva cuando la altitud sobre el suelo     -->
	  <!--   (AGL) baje de este valor (metros).                          -->
	  <!-- wheelDisableAgl: desactiva por encima de este AGL (metros).   -->
	  <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"/>

	  <!-- ─── Tren de Aterrizaje ────────────────────────────────────── -->
	  <!-- El Animator se mueve de t=0 (tren abajo) a t=1 (tren arriba).-->
	  <!-- gearDeployAltitude DEBE ser menor que gearRetractAltitude.    -->
	  <!-- gearUseAltitudeAboveGround: true=raycast AGL, false=Y mundial.-->
	  <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"/>

	  <!-- ─── Animaciones de Entrada/Salida ────────────────────────── -->
	  <!-- Varias pistas en un Animator. Cada una recorre startT→endT   -->
	  <!-- al entrar, y endT→startT al salir.                           -->
	  <!-- enterExitAnimSpeed: velocidad global, sobreescrita por _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"/>

	  <!-- ─── Giro de Hélice ────────────────────────────────────────── -->
	  <!-- propSpinExtraTVOL: % extra de RPM en modo TVOL.              -->
	  <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"/>

	  <!-- ─── FX de Distorsión del Motor ───────────────────────────── -->
	  <!-- ParticleSystems que se reproducen cuando el motor está en    -->
	  <!-- marcha.                                                       -->
	  <property name="maxEngineDistortionSlots" value="2"/>
	  <property name="engineDistortion0"        value="Effects/EngineDistort0"/>
	  <property name="engineDistortion1"        value="Effects/EngineDistort1"/>

	  <!-- ─── Intercambio de Sonido del Motor (Flight Gear Sound) ───── -->
	  <!-- Sustituye los gears de sonido del VPEngine por sonidos custom -->
	  <!-- cuando la aeronave entra en modo vuelo (TVOL o Plane).        -->
	  <!-- flightGear1..N: definición del gear separada por comas:       -->
	  <!--   rpmMin,rpmMax,rpmDecel,rpmDownShiftPoint,rpmDownShiftTo,    -->
	  <!--   rpmAccel,rpmUpShiftPoint,rpmUpShiftTo,sonidoAcel,sonidoDes  -->
	  <!--   [,pitchMin,pitchMax,volMin,volMax,fadeMin,fadeMax,           -->
	  <!--    fadeRange,nombre] x N rangos de sonido                     -->
	  <!-- flightSoundGearSlots: máximo de slots a parsear (def 4, máx 8)-->
	  <!-- Omite estas propiedades para mantener el sonido original.    -->
	  <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"/>

	  <!-- ─── Padre Activo en TVOL ──────────────────────────────────── -->
	  <!-- GameObject que se activa SOLO cuando flightMode == TVOL.     -->
	  <!-- Útil para partículas, luces o efectos exclusivos de TVOL.    -->
	  <property name="tvolActiveParentPath" value="M/EfectosTVOL"/>

	  <!-- ─── Padre Activo en Modo Avión ───────────────────────────── -->
	  <!-- GameObject que se activa cuando hay un jugador dentro del    -->
	  <!-- vehículo (hasDriver). Se desactiva al salir.                 -->
	  <property name="airplaneModeActiveParentPath" value="M/EfectosCockpit"/>

	  <!-- ─── Rotor Wash ─────────────────────────────────────────────── -->
	  <!-- El componente RotorWashController lo gestiona automáticamente. -->
	  <!-- rotorWashEnabled: interruptor principal.                       -->
	  <!-- rotorWashDebug: muestra gizmos de depuración en el editor.    -->
	  <property name="rotorWashEnabled" value="true"/>
	  <property name="rotorWashDebug"   value="false"/>

	  <!-- ─── Teclas de Control ─────────────────────────────────────── -->
	  <property name="yawLeftKey"        value="Q"/>
	  <property name="yawRightKey"       value="R"/>
	  <property name="yawLeftJoyButton"  value="JoystickButton4"/>
	  <property name="yawRightJoyButton" value="JoystickButton5"/>

  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   HELICÓPTERO (TVOL) — TODAS LAS OPCIONES                            -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Helicoptero_Completo">

	  <!-- ─── Modo de Vuelo ──────────────────────────────────────────── -->
	  <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: fuerza de hovering relativa al peso.       -->
	  <!--   1.0 = neutro. >1.0 = ligera tendencia ascendente.           -->
	  <!-- tvolMaxUpSpeed: velocidad vertical máxima (m/s).              -->
	  <!-- tvolVyResponse: capacidad de respuesta de velocidad vertical. -->
	  <!-- tvolVyMaxAccel: aceleración vertical máxima (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: velocidad horizontal máxima (m/s).        -->
	  <!-- tvolForwardSpeedMul: límite adelante = planar * este valor.   -->
	  <!-- tvolTranslationalAccel: aceleración horizontal (m/s²).        -->
	  <!-- tvolMaxTiltDeg: inclinación máxima del cuerpo para moverse.   -->
	  <property name="tvolMaxPlanarSpeed"     value="10"/>
	  <property name="tvolForwardSpeedMul"    value="1.5"/>
	  <property name="tvolTranslationalAccel" value="22"/>
	  <property name="tvolMaxTiltDeg"         value="25"/>

	  <!-- ─── TVOL Estabilización ────────────────────────────────────── -->
	  <!-- tvolStabilizeTorque: intensidad de la nivelación automática.  -->
	  <!-- tvolYawTorque: fuerza de guiñada.                             -->
	  <!-- tvolVelDamp: amortiguación de velocidad horizontal.           -->
	  <!-- tvolAngDamp: amortiguación de velocidad angular.              -->
	  <property name="tvolStabilizeTorque" value="10000"/>
	  <property name="tvolYawTorque"       value="20000"/>
	  <property name="tvolVelDamp"         value="0.988"/>
	  <property name="tvolAngDamp"         value="0.985"/>

	  <!-- ─── TVOL Guiñada ───────────────────────────────────────────── -->
	  <!-- tvolUseDirectYaw: true=basado en tasa (suave), false=torque.  -->
	  <!-- tvolYawRateDeg: tasa de guiñada objetivo en grados/s.         -->
	  <!-- tvolYawRateSmooth: factor de suavizado para guiñada directa.  -->
	  <property name="tvolUseDirectYaw"  value="false"/>
	  <property name="tvolYawRateDeg"    value="90"/>
	  <property name="tvolYawRateSmooth" value="6"/>

	  <!-- ─── TVOL Desplazamiento Lateral (teclas Q/R) ──────────────── -->
	  <!-- Las teclas de guiñada también aplican fuerza lateral.         -->
	  <!-- tvolYawStrafeForceMul: multiplicador de fuerza de desplaz.    -->
	  <!-- tvolYawStrafeYawMul: 0=solo desplazamiento, 1=solo guiñada.  -->
	  <property name="tvolYawStrafeEnabled"  value="true"/>
	  <property name="tvolYawStrafeForceMul" value="1.00"/>
	  <property name="tvolYawStrafeYawMul"   value="0.35"/>

	  <!-- ─── Inercia al Cambiar de Modo ────────────────────────────── -->
	  <property name="tvolModeSwitchInertiaDuration" value="1.0"/>

	  <!-- ─── Inclinación de Rotores ────────────────────────────────── -->
	  <!-- Pivots que se inclinan entre TVOL (vertical) y Avión (adelante).-->
	  <!-- rotorTiltTVOLDeg: ángulo en modo TVOL.                        -->
	  <!-- rotorTiltPlaneDeg: ángulo en modo Avión.                      -->
	  <!-- rotorTiltSpeed: grados/seg de la animación de inclinación.   -->
	  <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"/>

	  <!-- ─── Inclinación de Rotores con Cabeceo (visual W/S) ────────── -->
	  <!-- Los rotores se inclinan adelante/atrás visualmente con el     -->
	  <!-- input de cabeceo. Solo cosmético.                             -->
	  <property name="tvolRotorPitchTiltDegMax" value="25"/>
	  <property name="tvolRotorPitchTiltSmooth" value="8"/>

	  <!-- ─── Torsión de Rotores en Guiñada ─────────────────────────── -->
	  <!-- Los rotores se tuercen en direcciones opuestas durante la     -->
	  <!-- guiñada. Solo cosmético. Slot 0 gira +, slot 1 gira -.        -->
	  <property name="rotorYawTwistEnabled"   value="true"/>
	  <property name="rotorYawTwistDegMax"    value="6"/>
	  <property name="rotorYawTwistAxisLocal" value="0,1,0"/>

	  <!-- ─── Giro de Hélice ────────────────────────────────────────── -->
	  <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"/>

	  <!-- ─── Compartido ─────────────────────────────────────────────── -->
	  <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 (HÍBRIDO) — TODAS LAS OPCIONES                               -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--
	Combina Avión + TVOL. La tecla T alterna entre modos en pleno vuelo.
	Necesita parámetros TANTO de avión COMO de TVOL.
	Los rotores se inclinan entre rotorTiltTVOLDeg y rotorTiltPlaneDeg.
  -->
  <vehicle name="Osprey_Completo">

	  <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"/>

	  <!-- Avión -->
	  <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"/>

	  <!-- Visuales tiltrotor -->
	  <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"/>

	  <!-- Tren de aterrizaje -->
	  <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"/>

	  <!-- ─── Sonidos de Transición ──────────────────────────────────── -->
	  <!-- Sonido one-shot al cambiar entre TVOL y Avión (Osprey).       -->
	  <!-- Omite la propiedad o deja vacío para no reproducir sonido.    -->
	  <property name="soundTvolToPlane" value="Vehicles/osprey_transform"/>
	  <property name="soundPlaneToTvol" value="Vehicles/osprey_transform"/>

  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   DELOREAN (COCHE VOLADOR) 2 MODOS — TODAS LAS OPCIONES              -->
  <!--   (Vanilla ↔ TVOL)                                                   -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--
	Vehículo terrestre que cambia a TVOL. Sin modo Avión.
	vanillaTvolOnly = true se configura automáticamente con vehicleFlightMode=Delorean.

	GIRO DE RUEDA vs GIRO DE MALLA:
	  wheelTurnN → PIVOT padre. Rota al cambiar de modo. No gira.
	  wheelN     → MALLA de la rueda (hijo). Gira mientras se conduce.
				   Debe ser hijo del pivot para heredar la rotación.
  -->
  <vehicle name="Delorean_2modos_Completo">

	  <!-- ─── Modo de Vuelo ──────────────────────────────────────────── -->
	  <property name="vehicleFlightMode" value="Delorean"/>
	  <property name="enableTVOL"        value="true"/>
	  <!-- vanillaTvolOnly = true se configura automáticamente. Explícito:-->
	  <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"/>

	  <!-- ─── Giro de Ruedas — pivots rotan al cambiar de modo ────────── -->
	  <!-- wheelTurnAxisLocal: eje de rotación local del pivot.          -->
	  <!--   0,1,0 = Y local → ruedas miran hacia arriba en TVOL.        -->
	  <!-- wheelTurnVanillaDeg: ángulo en modo coche (suelo).            -->
	  <!-- wheelTurnTVOLDeg: ángulo al entrar en TVOL (vuelo).           -->
	  <!-- wheelTurnSpeed: grados/seg de la animación.                   -->
	  <!-- wheelTurnUseTireTransform: true = usa el transform del        -->
	  <!--   WheelCollider como pivot en lugar del nodo XML.             -->
	  <!--   Útil si el pivot visual y el collider coinciden.            -->
	  <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"/>

	  <!-- ─── Giro de Malla — hijos de los 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"/>

	  <!-- ─── Supresión de Ruedas ───────────────────────────────────── -->
	  <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"/>

	  <!-- ─── Inclinación de Rotores — motores se inclinan al entrar en 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"/>

	  <!-- ─── Giro de Hélice ────────────────────────────────────────── -->
	  <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"/>

	  <!-- ─── FX del Motor ──────────────────────────────────────────── -->
	  <property name="maxEngineDistortionSlots" value="2"/>
	  <property name="engineDistortion0"        value="Effects/EngineDistortL"/>
	  <property name="engineDistortion1"        value="Effects/EngineDistortR"/>

	  <!-- ─── Rotor Wash ─────────────────────────────────────────────── -->
	  <property name="rotorWashEnabled" value="true"/>

	  <!-- ─── Caída ─────────────────────────────────────────────────── -->
	  <property name="fallSpeedThreshold"  value="12"/>
	  <property name="extraFallMultiplier" value="0.8"/>

	  <!-- ─── Teclas ────────────────────────────────────────────────── -->
	  <property name="yawLeftKey"  value="Q"/>
	  <property name="yawRightKey" value="R"/>

	  <!-- ─── Sonidos de Transición ──────────────────────────────────── -->
	  <!-- Sonido one-shot al pulsar T para cambiar de modo.             -->
	  <!-- Usa cualquier ruta de sonido válida del juego.                -->
	  <!-- Omite la propiedad o deja vacío para no reproducir sonido.    -->
	  <property name="soundVanillaToTvol" value="Vehicles/delorean_transform"/>
	  <property name="soundTvolToVanilla" value="Vehicles/delorean_transform"/>

  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   DELOREAN (COCHE VOLADOR) 3 MODOS — TODAS LAS OPCIONES              -->
  <!--   Vanilla → TVOL → Avión → Vanilla                                   -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <vehicle name="Delorean_3modos_Completo">

	  <property name="vehicleFlightMode" value="Delorean"/>
	  <property name="enableTVOL"        value="true"/>
	  <property name="vanillaTvolOnly"   value="false"/>   <!-- activa 3 modos -->
	  <property name="allowTVOLToggle"   value="true"/>
	  <property name="tvolToggleKey"     value="T"/>

	  <!-- TVOL (igual que 2 modos) -->
	  <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"/>

	  <!-- Avión (necesario para el 3er modo) -->
	  <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"/>

	  <!-- Giro ruedas, malla, inclinación rotores, hélices (igual que 2 modos) -->
	  <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"/>

	  <!-- ─── Sonidos de Transición ──────────────────────────────────── -->
	  <!-- Sonido one-shot al pulsar T para cambiar de modo.             -->
	  <!-- Usa cualquier ruta de sonido válida del juego.                -->
	  <!-- Omite la propiedad o deja vacío para no reproducir sonido.    -->
	  <!-- En 3 modos están disponibles los 5 pares posibles.           -->
	  <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: Avión → Coche (solo en Delorean 3 modos). -->
	  <property name="soundPlaneToVanilla" value="Vehicles/delorean_transform"/>

  </vehicle>


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   REFERENCIA DE CONTROLES                                             -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--
	MODO AVIÓN:
	● W/S        → Acelerar / Frenar
	● A/D        → Alabeo izquierda/derecha
	● Espacio    → Cabeceo arriba
	● C/Ctrl     → Cabeceo abajo
	● Q/R        → Guiñada izquierda/derecha

	MODO TVOL:
	● Espacio/C  → Subir / Bajar
	● W/S        → Cabeceo (inclinar adelante/atrás)
	● A/D        → Alabeo (inclinar izquierda/derecha)
	● Q/R        → Desplazamiento lateral + Guiñada

	DELOREAN 2 MODOS:
	● T          → Coche ↔ TVOL

	DELOREAN 3 MODOS:
	● T          → Coche → TVOL → Avión → Coche

	OSPREY:
	● T          → TVOL ↔ Avión
  -->


  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--   REFERENCIA DE PROPIEDADES — TABLA COMPLETA                          -->
  <!-- ═══════════════════════════════════════════════════════════════════════ -->
  <!--
	┌────────────────────────────────────┬────────┬──────────┬──────────────────┐
	│ Clave                              │ Tipo   │ Defecto  │ Modo             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ MODO DE VUELO                      │        │          │                  │
	│ vehicleFlightMode                  │ string │ ""       │ Todos            │
	│   Valores: Plane, TVOL, Osprey,    │        │          │                  │
	│            Delorean                │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ INTERRUPTORES DE MODO              │        │          │                  │
	│ 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 modos: Vanilla ↔ TVOL │        │          │                  │
	│   false → 3 modos: Van→TVOL→Avión │        │          │                  │
	│   (auto true con Delorean)         │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ MOTOR                              │        │          │                  │
	│ engineThrust                       │ float  │ 32000    │ Avión/Del 3-modo │
	│ thrustAsAcceleration               │ bool   │ false    │ Avión            │
	│ throttleUpRate                     │ float  │ 2.5      │ Todos            │
	│ throttleDownRate                   │ float  │ 1.2      │ Todos            │
	│ idleThrottle                       │ float  │ 0.06     │ Todos            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ AERODINÁMICA                       │        │          │                  │
	│ wingArea                           │ float  │ 28       │ Avión            │
	│ airDensity                         │ float  │ 1.225    │ Avión            │
	│ stallSpeed                         │ float  │ 18       │ Avión            │
	│ liftScale                          │ float  │ 0.90     │ Avión            │
	│ baseDrag                           │ float  │ 0.016    │ Avión            │
	│ inducedDrag                        │ float  │ 0.050    │ Avión            │
	│ sideDrag                           │ float  │ 0.9      │ Avión            │
	│ verticalDrag                       │ float  │ 0.35     │ Avión            │
	│ maxAoADeg                          │ float  │ 22       │ Avión            │
	│ maxLiftG                           │ float  │ 2.8      │ Avión            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ PARES DE CONTROL                   │        │          │                  │
	│ pitchTorque                        │ float  │ 2600     │ Avión            │
	│ rollTorque                         │ float  │ 5200     │ Avión            │
	│ yawTorque                          │ float  │ 650      │ Avión            │
	│ turnCoordination                   │ float  │ 0.08     │ Avión            │
	│ angularDamping                     │ float  │ 0.995    │ Avión            │
	│ controlDeadZone                    │ float  │ 0.08     │ Todos            │
	│ aileronMaxAngle                    │ float  │ 25       │ Avión            │
	│ elevatorMaxAngle                   │ float  │ 20       │ Avión            │
	│ surfaceSpeed                       │ float  │ 120      │ Avión            │
	│ invertPitch                        │ bool   │ false    │ Todos            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ SAS                                │        │          │                  │
	│ planeSAS                           │ bool   │ true     │ Avión            │
	│ planeSASTorque                     │ float  │ 6000     │ Avión            │
	│ planeSASAngDamp                    │ float  │ 0.985    │ Avión            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ ASISTENCIA AL DESPEGUE             │        │          │                  │
	│ takeoffAssistEnabled               │ bool   │ true     │ Avión            │
	│ takeoffAssistMax                   │ float  │ 0.35     │ Avión            │
	│ takeoffAssistSpeedMul              │ float  │ 1.2      │ Avión            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ CAÍDA                              │        │          │                  │
	│ fallSpeedThreshold                 │ float  │ 16       │ Todos            │
	│ extraFallMultiplier                │ float  │ 1.6      │ Todos            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ 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 ESTABILIZACIÓN                │        │          │                  │
	│ 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 GUIÑADA                       │        │          │                  │
	│ tvolUseDirectYaw                   │ bool   │ false    │ TVOL             │
	│ tvolYawRateDeg                     │ float  │ 90       │ TVOL             │
	│ tvolYawRateSmooth                  │ float  │ 6        │ TVOL             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ TVOL DESPLAZAMIENTO LATERAL        │        │          │                  │
	│ tvolYawStrafeEnabled               │ bool   │ true     │ TVOL             │
	│ tvolYawStrafeForceMul              │ float  │ 1.0      │ TVOL             │
	│ tvolYawStrafeYawMul                │ float  │ 0.35     │ TVOL             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ SONIDOS DE TRANSICIÓN              │        │          │                  │
	│ soundVanillaToTvol                 │ string │ ""       │ Delorean         │
	│ soundTvolToVanilla                 │ string │ ""       │ Delorean         │
	│ soundTvolToPlane                   │ string │ ""       │ Delorean/Osprey  │
	│ soundPlaneToTvol                   │ string │ ""       │ Delorean/Osprey  │
	│ soundPlaneToVanilla                │ string │ ""       │ Delorean 3 modos │
	│   One-shot al cambiar de modo.     │        │          │                  │
	│   Vacío o ausente = sin sonido.    │        │          │                  │
	│   Usa rutas válidas del juego:     │        │          │                  │
	│   Vehicles/.., misc/.., etc.       │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ PADRE ACTIVO (activar GO)          │        │          │                  │
	│ tvolActiveParentPath               │ string │ ""       │ Todos            │
	│   GO activo SOLO en modo TVOL.     │        │          │                  │
	│   Ruta relativa a M/ (Mesh).       │        │          │                  │
	│ airplaneModeActiveParentPath       │ string │ ""       │ Todos            │
	│   GO activo cuando hay conductor.  │        │          │                  │
	│   Se desactiva al salir.           │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ INTERCAMBIO DE SONIDO DE MOTOR     │        │          │                  │
	│ flightGear1..flightGear8           │ string │ ""       │ Todos            │
	│   Sustituye gears de sonido del    │        │          │                  │
	│   VPEngine por sonidos de vuelo    │        │          │                  │
	│   al entrar en modo vuelo.         │        │          │                  │
	│   Formato: rpmMin,rpmMax,rpmDecel, │        │          │                  │
	│   rpmDnPt,rpmDnTo,rpmAccel,        │        │          │                  │
	│   rpmUpPt,rpmUpTo,sonAcel,         │        │          │                  │
	│   sonDesacel[,rango de sonido x N] │        │          │                  │
	│ flightSoundGearSlots               │ int    │ 4        │ Todos            │
	│   Slots máx a parsear (máx 8).     │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ SUPERFICIES DE CONTROL             │        │          │                  │
	│ aileronLeftPath                    │ string │ ""       │ Avión            │
	│ aileronRightPath                   │ string │ ""       │ Avión            │
	│ elevatorPath                       │ string │ ""       │ Avión            │
	│ elevator0..elevatorN               │ string │ ""       │ Avión            │
	│ maxElevatorSlots                   │ int    │ 16       │ Avión            │
	│ rudderPath                         │ string │ ""       │ Avión            │
	│ rudder0..rudderN                   │ string │ ""       │ Avión            │
	│ maxRudderSlots                     │ int    │ 8        │ Avión            │
	│ aileronAxisLocal                   │ vec3   │ 0,0,1    │ Avión            │
	│ elevatorAxisLocal                  │ vec3   │ 1,0,0    │ Avión            │
	│ rudderAxisLocal                    │ vec3   │ 0,1,0    │ Avión            │
	│ rudderMaxAngle                     │ float  │ 25       │ Avión            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ FLAPS                              │        │          │                  │
	│ flapLeftPath                       │ string │ ""       │ Avión            │
	│ flapRightPath                      │ string │ ""       │ Avión            │
	│ flapTakeoffAngle                   │ float  │ 12       │ Avión            │
	│ flapLandingAngle                   │ float  │ 25       │ Avión            │
	│ flapSpeed                          │ float  │ 90       │ Avión            │
	│ flapAxisLocal                      │ vec3   │ 1,0,0    │ Avión            │
	│ flapTakeoffMaxSpeed                │ float  │ 30       │ Avión            │
	│ flapLandingMaxSpeed                │ float  │ 22       │ Avión            │
	│ flapRetractMinSpeed                │ float  │ 35       │ Avión            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ RUEDAS GIRO MALLA (visual)         │        │          │                  │
	│ maxWheelVisualSlots                │ int    │ 64       │ Todos            │
	│ wheel0..wheelN                     │ string │ ""       │ Todos            │
	│ wheelRearVisualPath (legacy)       │ string │ ""       │ Todos            │
	│ wheelLeftVisualPath (legacy)       │ string │ ""       │ Todos            │
	│ wheelRightVisualPath (legacy)      │ string │ ""       │ Todos            │
	│ wheelSpinAxisLocal                 │ vec3   │ 1,0,0    │ Todos            │
	│ wheelSpinSpeed                     │ float  │ 120      │ Todos            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ RUEDAS GIRO PIVOT (cambio de modo) │        │          │                  │
	│ 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 = usa el transform del      │        │          │                  │
	│   WheelCollider como pivot.        │        │          │                  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ SUPRESIÓN DE RUEDAS                │        │          │                  │
	│ wheelDisableSpeedMul               │ float  │ 1.05     │ Todos            │
	│ wheelHighSpeedFriction             │ float  │ 0.25     │ Todos            │
	│ wheelHighSpeedSlip                 │ float  │ 1.6      │ Todos            │
	│ wheelEnableAgl                     │ float  │ 2.0      │ Todos            │
	│ wheelDisableAgl                    │ float  │ 3.5      │ Todos            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ TREN DE ATERRIZAJE                 │        │          │                  │
	│ autoGearEnabled                    │ bool   │ true     │ Todos            │
	│ gearAnimatorPath                   │ string │ ""       │ Todos            │
	│ gearAnimStateName                  │ string │ ""       │ Todos            │
	│ gearAnimSpeed                      │ float  │ 1.0      │ Todos            │
	│ gearUseAltitudeAboveGround         │ bool   │ false    │ Todos            │
	│ gearRetractAltitude                │ float  │ 60       │ Todos            │
	│ gearDeployAltitude                 │ float  │ 30       │ Todos            │
	│ gearRaycastMax                     │ float  │ 300      │ Todos            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ ANIMACIONES ENTRADA/SALIDA         │        │          │                  │
	│ enterExitAnimEnabled               │ bool   │ true     │ Todos            │
	│ enterExitAnimSlots                 │ int    │ 8        │ Todos            │
	│ enterExitAnimatorPath              │ string │ ""       │ Todos            │
	│ enterExitAnimSpeed                 │ float  │ 1.0      │ Todos            │
	│ enterExitAnimN                     │ string │ ""       │ Todos            │
	│ enterExitAnimN_path                │ string │ ""       │ Todos            │
	│ enterExitAnimN_speed               │ float  │ 1.0      │ Todos            │
	│ enterExitAnimN_start               │ float  │ 0.0      │ Todos            │
	│ enterExitAnimN_end                 │ float  │ 1.0      │ Todos            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ INCLINACIÓN DE ROTORES             │        │          │                  │
	│ 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             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ TORSIÓN DE ROTORES EN GUIÑADA      │        │          │                  │
	│ rotorYawTwistEnabled               │ bool   │ true     │ TVOL             │
	│ rotorYawTwistDegMax                │ float  │ 4        │ TVOL             │
	│ rotorYawTwistAxisLocal             │ vec3   │ 0,1,0    │ TVOL             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ GIRO DE HÉLICE                     │        │          │                  │
	│ maxPropSpinSlots                   │ int    │ 8        │ Todos            │
	│ propSpin0..propSpinN               │ string │ ""       │ Todos            │
	│ propSpinAxisLocal                  │ vec3   │ 0,0,1    │ Todos            │
	│ propRpmMax                         │ float  │ 2200     │ Todos            │
	│ propSpinExtraTVOL                  │ float  │ 0.15     │ TVOL             │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ FX DISTORSIÓN DEL MOTOR            │        │          │                  │
	│ maxEngineDistortionSlots           │ int    │ 8        │ Todos            │
	│ engineDistortion0..N               │ string │ ""       │ Todos            │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ ROTOR WASH                         │        │          │                  │
	│ rotorWashEnabled                   │ bool   │ true     │ TVOL/Osprey/Del  │
	│ rotorWashDebug                     │ bool   │ false    │ TVOL/Osprey/Del  │
	├────────────────────────────────────┼────────┼──────────┼──────────────────┤
	│ TECLAS DE CONTROL                  │        │          │                  │
	│ yawLeftKey                         │ string │ Q        │ Todos            │
	│ yawRightKey                        │ string │ R        │ Todos            │
	│ yawLeftJoyButton                   │ string │ (ninguno)│ Todos            │
	│ yawRightJoyButton                  │ string │ (ninguno)│ Todos            │
	└────────────────────────────────────┴────────┴──────────┴──────────────────┘

	FORMATO VECTOR3:   x,y,z   ejemplo: 1,0,0  /  0,0.5,1

	ARRAYS DE SLOTS (indexados desde 0):
	  wheel0..N            → mallas visuales de giro de ruedas
	  wheelTurn0..N        → nodos pivot de giro de ruedas (modo Delorean)
	  rotorTilt0..N        → pivots de inclinación de rotores/motores
	  propSpin0..N         → palas de hélice/rotor
	  elevator0..N         → elevadores múltiples
	  rudder0..N           → timón(es) de dirección
	  engineDistortion0..N → FX de distorsión del motor
	  enterExitAnim0..N    → pistas de animación de entrada/salida

	REGLA: gearDeployAltitude < gearRetractAltitude  (siempre)

	SONIDOS DE TRANSICIÓN — TABLA:
	  ┌─────────────────────────┬──────────────────────┬──────────────────┐
	  │ Propiedad               │ Transición           │ Modo             │
	  ├─────────────────────────┼──────────────────────┼──────────────────┤
	  │ soundVanillaToTvol      │ Coche  → TVOL        │ Delorean         │
	  │ soundTvolToVanilla      │ TVOL   → Coche       │ Delorean         │
	  │ soundTvolToPlane        │ TVOL   → Avión       │ Delorean/Osprey  │
	  │ soundPlaneToTvol        │ Avión  → TVOL        │ Delorean/Osprey  │
	  │ soundPlaneToVanilla     │ Avión  → Coche       │ Delorean 3 modos │
	  └─────────────────────────┴──────────────────────┴──────────────────┘
	  ● Omitir la propiedad o poner value="" = sin sonido en esa transición.
	  ● Usa rutas de sonido válidas del juego: Vehicles/..., misc/..., etc.

	NOTAS:
	● Los nodos bajo "Physics/" son ignorados para todos los visuales.
	● wheelTurnN = PIVOT padre que rota. wheelN = malla de rueda hija que gira.
	● El autopiloto TVOL funciona automáticamente sin XML extra.
	● RotorWashController funciona automáticamente si el componente está presente.
	● El motor requiere combustible, pieza de motor y salud > 0.
	● enterExitAnimSpeed es la velocidad global; enterExitAnimN_speed
	  la sobreescribe por pista individual.
	● tvolActiveParentPath: activa el GO solo en modo TVOL.
	● airplaneModeActiveParentPath: activa el GO cuando hay un jugador dentro;
	  se desactiva al salir. Ambas rutas son relativas a M/ (Mesh).
	● flightGear1..N: sustituye los gears de sonido del VPEngine por sonidos
	  custom al entrar en modo vuelo. Sin ellos el motor vanilla se silencia
	  pero no reproduce sonido de vuelo.
	● wheelTurnUseTireTransform: usa el WheelCollider como referencia de pivot
	  en lugar del nodo XML. Útil cuando ambos coinciden en posición.
	● soundPlaneToVanilla solo se ejecuta en Delorean de 3 modos al volver
	  de Avión a Vanilla/Coche.
  -->

</aircraft_reference>
