
Immersive Aerodynamics for Protomanly's Weather
Highly configurable bridge between Immersive Aircraft and PM Weather. Wind affects speed, introduces turbulence, and more!
🌪️ Immersive Aerodynamics
Immersive Aerodynamics acts as a physics bridge between Immersive Aircraft and Protomanly's Weather. It injects real-time atmospheric data into flight calculations, causing wind speed, direction, and turbulence to physically affect aircraft movement and stability.
✈️ Key Features
True Wind Physics: Wind calculated by PM Weather is simulated as a physical force.
Drift Mechanics: Crosswinds push aircraft off course, requiring pilots to angle the nose into the wind to maintain a straight heading.
Velocity Scaling: Tailwinds increase ground speed, while a drag dampening system prevents aircraft from exceeding realistic maximum velocities.
Altitude Gradient: Wind strength increases with altitude. Low-altitude flight remains relatively stable, while high-altitude travel exposes aircraft to stronger currents.

📉 Mass & Inertia
The physics engine accounts for the weight of different aircraft types.
Variable Stability: Heavier vehicles (such as Warships or Cargo Blimps) resist wind forces significantly better than lighter airframes (such as Biplanes).

Non-Linear Scaling: A calibrated mass curve ensures that while heavy aircraft are more stable, they remain subject to drift in severe weather conditions.
⚠️ Advanced Turbulence
The turbulence system introduces three distinct instability mechanics based on storm intensity:
Air Pockets: Strong storms generate randomized downdrafts that force the aircraft downward, requiring immediate pitch correction.
Directional Instability:
Headwinds cause pitch oscillation (nose bobbing).
Crosswinds cause yaw instability (tail wagging).
Structural Shudder: High speeds or severe winds cause high-frequency visual vibration of the airframe.
🔧 Commands & Configuration
All physics values can be tuned in-game using the /iaero command suite as well as in the config file.
/iaero set influence <0-100> - Adjusts the global strength of wind forces.
/iaero set turbulence <0-50> - Adjusts the intensity of rotational turbulence.
/iaero set threshold <0-500> - Sets the minimum wind speed required for physics effects to apply.
/iaero set scaling <0.0-1.0> - Adjusts the mass physics curve. (1.0 = Linear; lower values make heavy aircraft significantly more stable).
/iaero set pocket_chance <0.0-1.0> - Adjusts the probability (per tick) of encountering an air pocket/downdraft.
/iaero set pocket_strength <0.0-10.0> - Adjusts the downward force applied when hitting an air pocket.
/iaero set pitch_bias <1.0-10.0> - Adjusts the asymmetry of turbulence. Higher values make downward pitch forces significantly stronger than upward ones.
/iaero set vibration <0.0-10.0> - Adjusts the intensity of high-frequency visual vibration (shudder) during high speeds or storms.
/iaero debug - Toggles a real-time physics readout in the chat bar.
📦 Requirements
This mod requires both:
Immersive Aircraft (for the planes)
ProtoManly's Weather (for the wind data)
⚠️ Other Notes
- This is a beta release of the mod, and more tuning is likely to improve overall results.
- Unknown comaptability issues may exist.
