🌤️ Project Atmosphere

Dynamic Weather & Climate Engine for Forge 1.20.1
(IN ACTIVE DEVELOPMENT — Beta RELEASE)

TO POST YOUR IDEAS OR ISSUES PLEASE JOIN THE DISCORD SERVER IT’S EASIER FOR ME TO TRACK THEM

Project Atmosphere is a comprehensive weather and climate simulation mod for Minecraft Forge 1.20.1.
It fully replaces vanilla weather with an integrated system including:

• 🌡️ Temperature
• 💧 Humidity
• 🌀 Pressure
• 🌫️ Visual atmospheric effects

Built from the ground up for performance and mod compatibility, it simulates realistic biome-based weather and supports shader blending, Simple Clouds, and mods like Serene Seasons Extended and Pretty Rain.

---

🌦️ Core Features

☁️ Dynamic Cloud System (via Simple Clouds)

• Fully integrated with Simple Clouds
• Cloud behavior reacts to temperature, humidity, and pressure
• Cloud types vary per biome and weather
• Supports manual injection, forecast-based spawning, and persistent clouds
• Planned: fog-cloud merging and shader-linked visuals

🌡️ Realistic Temperature Engine

• Biome-aware and season-driven
• Native integration with Serene Seasons and Serene Seasons Extended
• Temperature interpolated every 50 ticks (10 in-game minutes)
• Forms sinusoidal day curves with min/max precomputed per day
• Includes realistic features:
  • Desert day–night swings
  • Frozen biome cold stability
  • Tropical moderation
• Data generated asynchronously

🌫️ Humidity & Pressure Systems

• Humidity varies with biome, time, and temperature
• Pressure is tracked per biome and affects:
  • 🌥️ Cloud buildup
  • 🌩️ Storm potential
  • 🌁 Fog density
• These values influence rain, fog intensity, and cloud formation

📊 Forecast System

• Precomputes a 7-day forecast per biome for:
  • Temperature (min/max)
  • Humidity
  • Pressure
  • Wind
  • Storm probability
• Forecasts are saved in JSON and loaded asynchronously
• Used by the cloud and fog systems to simulate evolving weather

🌪️ Weather Variability Modules

🔥 SpikeManager

• Simulates heatwaves, cold drops, and pressure anomalies
• Configurable per-biome-group

🌈 VariationGenerator

• Adds natural daily fluctuations
• Prevents repetitive weather while respecting seasonal logic

🌁 Visual & Atmospheric Effects

• Fog varies based on:
  • Temperature vs dew point
  • Humidity
  • Biome and time of day
• Future plans:
  • Shader-linked fog density (e.g., Complementary or Iris)
  • Cloud–fog blending

---

🔁 Compatibility & Mod Integration

✅ Supported Mods

• Serene Seasons
• Simple Clouds
• Pretty Rain
• Serene Seasons Extended

🔜 Planned Support

• Farmer’s Delight (crop hydration/weather)
• Create (machine overheating & freezing)
• Tough As Nails (temperature)
• Legendary Survival Overhaul

---

🧱 Architecture & Performance

• Async-first design: all forecasts, interpolation, and storage run off-thread
• Uses chunk-aware managers for per-biome effects
• Zero-tick-impact: designed for multiplayer performance
• Modular core for easy third-party mod integration

---

🔧 Developer Tools

• /weatherdebug and /forecast commands:
  • View forecast per biome
  • Force weather conditions
  • Debug cloud spawning state
• Public API (planned — DM if interested in early access)

---

🗺️ Current & Upcoming Modules

✅ Implemented

• 🌬️ Wind Simulation — affects cloud movement, particles, and (future) projectile drift
• ❄️ Snow Accumulation
  • Based on real temperature, not just tags
  • Snow melts with sun/heat/rain
  • Per-block, terrain-blending behavior

🔜 Coming Soon

• 🌾 Crop Health — affected by drought, overwatering, or extreme heat
• 🧊 Freezing Logic — temperature-based effects on items, blocks, fluids, entities
• ☔ Rain Quality System — soil saturation, evaporation, and rainfall depth

---

⚙️ Requirements

• Minecraft Forge 1.20.1
• Serene Seasons
• Simple Clouds
• Pretty Rain
• Serene Seasons Extended Fix

---

⚡ Performance Requirements

Project Atmosphere is heavy on both CPU and GPU due to its simulation and rendering systems.

• RTX-class GPUs are recommended as the minimum requirement to run the mod smoothly.
• Current testing has been done using an RTX 4070 Ti SUPER (main reference) and an RTX 2060 (low-end reference).
• For CPUs, testing has been done with a Ryzen 5 3600X as the lower-end benchmark.
• Anything below an RTX 2060 GPU or R5 3600X CPU cannot be guaranteed to run the mod at acceptable performance levels.

⚠️ Disclaimer

Project Atmosphere is currently in BETA.
Some features may be incomplete or unstable. Use at your own risk, especially on production servers.
Please report bugs or issues via Discord — feedback is welcome and helps shape development.

---

💬 Notes

Project Atmosphere aims to become the climate simulation backbone for realism-focused modpacks.
Whether you’re seeking immersive visuals, dynamic weather systems, or interaction with crops and machines, this mod provides a modular, asynchronous, and server-safe infrastructure.