Ambient: Environment Reimagined

 Ambient [ALPHA]
 The atmosphere is no longer a static background. It has become a living force.

 ⚠️ WARNING: This mod is currently in ALPHA development (v0.1.0). Core physical simulation engines are functional and covered by automated test suites, but balance updates are ongoing and UI designs will continue to evolve. Back up your worlds and install at your own risk!

 🌍 Overview

Tired of harvesting wheat on frozen mountaintops or seeing torches burn endlessly in sealed underground pockets with no air?

Ambient is not just another visual weather mod; it is a high-fidelity environmental simulation platform designed from the ground up to turn Minecraft into a coherent physical ecosystem. 

Engineered as part of the Simulation Triad, Ambient acts as the planetary and atmospheric engine, calculating real-time thermodynamic and meteorological variables that drive world mechanics and feed external survival systems.

 🛡️ Diagnostic Framework & Performance
Standardized Error System (AMB-xxxx): No more hunting through unreadable stack traces. Configuration errors and malformed datapacks output structured diagnostic codes with identified causes and solutions.
Optimized TPS & Spatial Caching: Employs spatial shelter caches, bit-packed primitive keys for oxygen pockets, and early-exit scanner routines to ensure seamless performance in large modpacks.
Simulation Presets: Includes three pre-calibrated difficulty modes (Casual, Realistic, and Hardcore) applied instantly via GUI or command.

 ⚡ The Simulation Triad
Ambient is designed to operate as a standalone experience or in complete synergy with the other pillars of the suite:

1. 🌤️ Ambient (Atmosphere & Climate): The planetary motor. Simulates temperature, humidity, barometric pressure, astronomical seasons, subterranean oxygen, and agricultural microclimates.
2. 🌋 Genesis (Geodynamics & Calamities – In Development): The tectonic motor. Simulates tectonic stress, cave-ins, structural integrity, seismic faults, and tidal forces.
3. 🧬 Vitality (Physiology & Survival): The biological motor. Simulates human homeostasis, body thermoregulation, thirst, hydration, and stamina reacting directly to Ambient’s climate.

 🔬 Current Modules (v0.1.0 Alpha)

Module 1: Planetary Thermodynamics
Dynamic Temperature: Continuous thermal calculation driven by solar irradiance, sun angle, altitude, wind exposure, shadows, and biome calibration.
Radiant Heat Sources: Campfires, furnaces, and lava radiate physical heat into nearby air blocks.
Solar Lens Ignition: Glass positioned above combustible materials (such as hay bales) focuses midday sunlight, producing smoke and initiating combustion at the focal point.

Module 2: Subterranean Oxygen & Confinement
Finite Air in Sealed Spaces: Open combustion sources (torches, campfires, open fires) in unventilated chambers actively consume oxygen.
Extinction & Asphyxiation (< 12.5% O₂): When oxygen drops below critical levels, active flames snuff out with dense gray smoke.
Unlit Torches: Extinguished torches can be reignited using flint and steel once proper airflow is restored.
Volcanic Displacement: Lava pools in enclosed areas continuously depress oxygen levels, preventing spurious rekindling until the chamber is ventilated.

Module 3: Astronomical Seasons
4 Full Seasons: Spring, Summer, Autumn, and Winter governed by a continuous sinusoidal solar curve.
Freezing Winters & Arid Summers: Temperate lakes freeze during winter nights, while summer peaks introduce heat stress and increased evaporation.
Integrated Control: Query and control cycles seamlessly via `/ambient season get` and `/ambient season set <season>`.

Module 4: Shelters & Greenhouses
Overhead Detection: Recognizes foliage canopy cover, solid ceilings (houses and mines), and transparent skylights.
Functional Greenhouses: Enclosing farmland under glass creates a protected microclimate that traps +8°C to +14°C of solar warmth and +30% relative humidity, enabling agriculture in frozen wastelands or deserts.

Module 5: Crop Physiology & Seasonal Farming
Frost Lethality (< 0°C): Exposed crops halt growth during freezing temperatures. Prolonged exposure converts plants into Frozen Crops (`ambient:frozen_crop`).
Heat Desiccation (> 38°C): Arid heat desiccates unhydrated crops into Withered Crops (`ambient:withered_crop`), reverting farmland back to dirt.
Greenhouse Growth Boost (+40%): Crops sealed inside functional greenhouses gain total climate immunity and accelerated photosynthetic growth.

Module 6: Scientific Instrumentation
Three crafted pixel-art handheld instruments featuring dynamic chromatic tooltips:
* 🌡️ Thermometer: Displays accurate local ambient temperature in °C.
* 💧 Hygrometer: Displays relative humidity (%) with aridity and saturation warnings.
* 🧭 Barometer: Measures atmospheric pressure in hPa with storm alert thresholds.

 ⚙️ In-Game Configuration Hub

Ambient features a clean, scrollable settings interface:
World Creation Button: Configurable directly on the world creation screen under game rules.
Context Mutability Locks: Clear safety badges prevent modifying creation-locked parameters (such as days per season) on existing worlds.
Rich Tooltips: Hover over any slider or toggle to read a thorough breakdown of its physical impact.

 💬 Community & Feedback
Found an issue or have a physics calibration suggestion?
* 🐞 Bug Reports: Open an issue on our GitHub repository.
* 💬 Discord Community: Join our server to discuss modpack configurations and follow the development of Genesis and Vitality.