Immersive Aerodynamics for Protomanly’s Weather

🌪️ 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 – Adjusts the global strength of wind forces.

/iaero set turbulence – Adjusts the intensity of rotational turbulence.

/iaero set threshold – Sets the minimum wind speed required for physics effects to apply.

/iaero set scaling – Adjusts the mass physics curve. (1.0 = Linear; lower values make heavy aircraft significantly more stable).

/iaero set pocket_chance – Adjusts the probability (per tick) of encountering an air pocket/downdraft.

/iaero set pocket_strength – Adjusts the downward force applied when hitting an air pocket.

/iaero set pitch_bias – Adjusts the asymmetry of turbulence. Higher values make downward pitch forces significantly stronger than upward ones.

/iaero set vibration – 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.