Disasters of the Overworld

### 🌋 Apocalypse (Disasters of the Overworld) v1.0.0 - Initial Release

An immersive, highly dynamic post-apocalyptic world survival mod for Minecraft 1.21.4 (Fabric).

#### 🌟 Key Features:
- **Dynamic Progression System**: 6 Stages ranging from Stage 0 (Normal World) to Stage 5 (The Aftermath).
- **22 Unique Catastrophic Disasters**:
  - **Meteors & Explosions**: Meteor Impact, Subterranean Methane Blast, Falling Debris.
  - **Seismic & Volcanic**: Massive Earthquakes (with ground fissures), Volcanic Eruptions (lava peaks & ash fall), Sinkholes, Landslides.
  - **Oceanic & Water**: Tsunamis, Flash Floods, Acid Rain, Great Drought.
  - **Severe Storms & Weather**: F5 Tornadoes, Category 5 Hurricanes, Supercell Thunderstorms, Plasma Lightning Storms, Sandstorms, Glacial Blizzards, Solar Heatwaves.
  - **Atmospheric & Solar**: Coronal Mass Ejections (Solar Storms), Void Eclipse Darkness, Ionospheric Gravity Anomalies.
- **Environmental Early Warning System**: Subtly vibrating ground, dark clouds, sky beams, and environmental sound cues before major disasters strike.
- **3D Shelter Protection Evaluator**: Real-time scanner checking roof thickness, wall enclosures, depth, and block blast resistance to mitigate disaster damage.
- **Performance Optimized Engine**: Throttled block mutation queue (max 64 edits/tick) preventing server lag spikes.
- **HUD & Status UI**: Top-right overlay tracking active stage, active disasters, incoming warnings, and shelter safety rating.
- **Full In-Game Command Suite**: Commands (`/apocalypse start`, `/apocalypse stage`, `/apocalypse trigger`, `/apocalypse status`, `/apocalypse difficulty`).

#### 🛠️ Dependencies:
- Fabric API (Minecraft 1.21.4)
- Java 21