Sand Apocalypse (100-Day Desertification & Bosses)

# ⏳ SAND APOCALYPSE
**Can you survive 100 days as the Overworld withers into an endless, scorching desert—or will you forge the Restored Sand Core and reverse the curse?**

**Sand Apocalypse** is a comprehensive survival-progression and boss-adventure mod for Minecraft 1.20.1 (Forge). Over the course of a configurable 100-day countdown, an ancient curse progressively consumes the Overworld. Lush forests wither into coarse dirt, rivers and lakes evaporate into dry sand, blinding sandstorms roll across the horizon, and lethal desert fauna emerge from the dunes.

Every player spawns with the **Chronicle of the Dunes**, an in-game guide book detailing every phase, creature, crafting recipe, and boss mechanic needed to reclaim the world.

—

## 🏜️ The 5 Phases of the Apocalypse
A live HUD tracker displays the current day and apocalypse percentage:
* **Phase I: Whispering Dunes (Day 1–24):** The winds shift. Early desert fauna begin emerging on sandy terrain.
* **Phase II: Withered Horizon (Day 25–49):** Grass, podzol, and foliage begin decaying into coarse dirt and dead bushes. Shimmering **Oases and Mirages** materialize on the horizon.
* **Phase III: Great Aridity (Day 50–74):** Surface water begins evaporating into sand and sandstone. **Desiccator Ghouls** stalk the surface, corrupting the ground beneath their feet into sand.
* **Phase IV: Scorched Earth (Day 75–99):** Intense solar radiation dehydrates exposed surface animals into bone-white **Dried Carcasses** and inflicts golden sandstorm fog.
* **Phase V: Eternal Dune (Day 100+):** Total desertification. Unprotected players suffer from solar drought hunger under the open sky, and blinding sandstorms engulf the Overworld.

—

## 🦂 Custom Desert Fauna & Hazards
* **Desiccator Ghoul:** A moisture-draining undead stalker that heals on hit, inflicts Hunger, turns slain animals into harvestable **Dried Carcasses**, and corrupts solid blocks beneath its feet into sand.
* **Deathstalker Scorpion:** Armored arachnid that leaps at prey and inflicts paralyzing venom. Drops **Scorpion Chitin**.
* **Sidewinder Viper:** Fast, slithering horned serpent whose bites inflict potent Poison II and Nausea. Drops **Viper Scales** and **Viper Fangs**.
* **Azure Scarab:** Leaping jewel beetle that latches directly onto your screen in First-Person view! Swing your weapon (Left-Click) to shake it off, or block it with goggles and shields. Drops **Scarab Carapace**.

## 🥽 Desert Survival Gear & Weapons
Craft specialized survival equipment using monster drops to counter the apocalypse’s environmental hazards:
* **Sandstorm Goggles:** Grants crystal-clear vision through blinding sandstorm fog and prevents Azure Scarabs from latching onto your face.
* **Stillsuit Tunic & Leggings:** Recycles body moisture to grant immunity to Drought Hunger, Scorpion/Viper Poison, Cactus thorns, and Slowness, while granting **Swiftness I** on sand.
* **Dune Sandals:** Grants **Jump Boost I** on sand, reduces fall damage by 50%, and protects against hot floors.
* **Oasis Dew Canteen:** Passively condenses atmospheric moisture over time (or refills in water). Drinking restores hunger, cures poison/weakness, and grants Fire Resistance.
* **Viper Fang Kris:** High-speed envenomed dagger that inflicts Poison II and Weakness.
* **Scarab Aegis Shield:** Grants Resistance I while blocking, reflects 50% of melee damage back at attackers, and blocks face-hugging Scarabs.

—

## 🌴 Random Encounters: True Oases vs. Shimmering Mirages
While trekking across desertified terrain, shimmering sanctuaries will appear on the horizon:
* **50% True Sanctuary Oasis:** Contains permanent, non-evaporating water, palm shade, and a **Supply Chest** stocked with Golden Apples, emeralds, crafting materials, and a Canteen.
* **50% False Mirage:** Dissolves into swirling sand and smoke the moment you step close, ambushing you with Deathstalker Scorpions and Azure Scarabs!

## 🗿 Bosses & World Restoration
To stop the apocalypse, you must challenge two custom-modeled bosses and unlock the **Indestructible Giant Hourglass Monument**:

### 1. The Colossus Sand Golem (Guardian of the Core)
Craft a **Colossus Summon Totem** and right-click on sand to awaken this towering, energized stone colossus (**640 HP**).
* **Earthquake Slams:** Sends shockwaves that shake players’ screens and launch nearby fighters into the air.
* **10% HP Sand-Absorption Phase:** At 10% health, the Golem halts its attacks to absorb nearby sand blocks (+1% HP every 5 seconds) while summoning minions. Slay it before it regenerates back to 25% HP and resumes attacking!
* **Rewards:** Drops **Sand Core Fragments**. Combine 9 fragments to forge the **Restored Sand Core**, which acts as a compass pointing toward the distant Giant Hourglass.

### 2. Apep, The Sovereign Sand Dragon (Ultimate Final Boss)
Bringing the **Restored Sand Core** within 24 blocks of the **Giant Hourglass Monument** awakens **Apep, The Sovereign Sand Dragon (1200 HP)**.
* **Abilities:** Unleashes 16-block **Scorched Sandfire Breath** beams and executes high-speed winged dive-bombs.
* **Endgame Rewards:** Defeating Apep unseals the Hourglass Lodestone and drops the **Heart of Apep** (grants permanent Strength II, Regeneration, and Fire Resistance while in your inventory).
* **Apep’s Sovereign Khopesh:** Forge the Heart of Apep with your Viper Fang Kris to craft the ultimate endgame blade featuring AoE solar-flame melee cleaves and a Right-Click **Scorched Sandfire Breath Beam**!
* **Reversing the Apocalypse:** Right-click the unsealed Lodestone inside the Giant Hourglass with the Restored Sand Core to activate the restoration beacon—counting the apocalypse days backward and restoring sand back into lush grass, water, and saplings!

—

## ⚙️ Commands & Server Configuration
Every mechanic is customizable inside `sand_apocalypse-server.toml` (countdown length, terrain decay speed, mob caps, oasis/mirage rates, hourglass protection, and boss health/damage multipliers).

**Admin & Testing Commands (`/sandapocalypse`):**
* `/sandapocalypse status` — Displays current Apocalypse Day and Phase.
* `/sandapocalypse setday <day>` — Jumps to any day (1–10000) to test phases immediately.
* `/sandapocalypse kit` — Grants all survival gear, boss totems, spawn eggs, and the guide book.
* `/sandapocalypse book` — Grants a copy of the *Chronicle of the Dunes* guide book.
* `/sandapocalypse hourglass` — Spawns the Indestructible Giant Hourglass Monument 18 blocks ahead.
* `/sandapocalypse oasis` / `/sandapocalypse mirage` — Spawns a True Oasis or Mirage ahead.