Gods Of Olympus:War Of Gods

# ⚡ GODS OF OLYMPUS: WAR OF GODS ⚡
### *A Mythological Action RPG Combat Mod for Minecraft NeoForge 1.21.1*

Step into the realm of ancient mythology and wield godlike powers in Minecraft. **Gods of Olympus** brings the intense hack-and-slash combat of God of War and Greek mythology into Minecraft with custom **3D chained weapons**, **cinematic QTE executions**, **smooth player animations**, **mythical boss mounts**, and **devastating ultimate abilities**.

---

## 🏛️ CHOOSE YOUR DIVINE PATH

Upon entering your world, choose between three legendary mythological figures:

---

### 🔥 1. KRATOS — THE GHOST OF SPARTA (Half-God)
* **🗡️ Dual 3D Blades of Chaos:** Wield custom 3D chained blades with physics-driven flame chains. Perform high-speed multi-stage slash and thrust combos reaching enemies up to 8 blocks away.
* **🎯 [C] Spartan Charge & Impale Execution:** Dash forward, pin your target to the ground, and press `[C]` again during the cinematic execution window to impale their chest for a fatal critical strike.
* **🛡️ [V] Golden Fleece (Altın Post):** Guard with your golden fleece arm to parry incoming attacks. A successful parry instantly triggers a massive fiery counter-punch that sends enemies flying.
* **🌪️ [X] Cyclone of Chaos:** Spin both chained blades in a 360-degree fiery hurricane, shredding through enemy hordes with continuous burn damage.
* **🌧️ [R] Army of Sparta (8-Second Ultimate):** Enter an ironclad Spartan Phalanx stance with rotating phantom shields, calling down an 8-second relentless rain of flaming Spartan spears and arrows that obliterates entire armies.
* **😡 [B] Spartan Rage (Sparta Öfkesi):**
  * Gain **+40 Max HP (60 HP Total)**, **50 Armor**, **20 Toughness**, Knockback Immunity, and custom activation roar.
  * **Fiery Fists:** Bare-fist punches deal **15 Damage**, set enemies ablaze, and heal Kratos with **+2 HP Lifesteal** per hit.
  * **[Z] & [Right-Click] Boulder Rip & Throw:** Rip a massive 3D boulder straight out of the earth, carry it overhead, and hurl it at foes for **30 AoE Damage**.
  * **[X] Earth Slam:** Leap and smash both fists into the ground, rupturing a 10-block path forward that deals **40 Direct Damage** and launches mobs into the sky.

---

### 💀 2. HADES — LORD OF THE UNDERWORLD
* **⛓️ Dual 3D Claws of Hades:** Strike with deadly chained underworld scythes with 8-block range.
* **🩸 Neck-Slit Execution:** Sneak behind or snare an enemy with your claws to trigger a brutal close-range throat-slit execution.
* **👻 Soul Rip:** Rip souls directly out of living mobs with an interactive tap QTE, harvesting up to **200 Underworld Souls** to empower spells.
* **🐕 [G] Rideable 3-Headed Cerberus Boss Mount:**
  * Summon and ride the fearsome **Cerberus** with custom 3D model and animated heads.
  * **[Z] Triple Bite & Claw Slash**
  * **[X] Hellfire Roar & Repulsion**
  * **[C] Lava Ground Stomp**
  * **[V] Screaming Torment Souls**

---

### ⚡ 3. ZEUS — KING OF OLYMPUS
* **🕊️ Divine Flight:** Glide and soar through the skies with dynamic lightning particle trails.
* **⚡ Lightning Bolt Throw:** Cast high-velocity thunderbolts from your hands with explosive precision.
* **⚡ [G] Lightning Flash Teleport:** Instantly blink forward in a burst of blinding thunder.
* **🛡️ [C] Shockwave Landing:** Dive from the sky into the ground creating a devastating seismic impact.
* **🌩️ [R] Wrath of the Storm:** Call down a massive localized thunderstorm that repeatedly smites enemies with divine lightning.

---

## 🎮 CONTROLS & KEYBINDINGS

| Key | Kratos (Normal) | Kratos (Spartan Rage `[B]`) | Hades | Zeus |
| :--- | :--- | :--- | :--- | :--- |
| **`[Z]`** | Equip Blades of Chaos | **Rip 3D Boulder from Earth** | Equip Claws of Hades | Equip Lightning |
| **`Left-Click`** | 2-Stage Blade Combo | **15 Damage Fist (+Lifesteal)** | 8-Block Hook Slash | Lightning Bolt |
| **`Right-Click`** | Chain Grapple / Pull | **Throw 3D Boulder (30 Damage)** | Soul Rip (Tap QTE) | Lightning Barrage |
| **`[X]`** | Cyclone of Chaos | **Earth Slam (40 Damage AoE)** | Underworld Torment | Thunder Smite |
| **`[C]`** | Spartan Charge & Stab QTE | *(Locked)* | Throat-Slit Execution | Shockwave Landing |
| **`[V]`** | Golden Fleece Parry & Punch | *(Locked)* | Soul Explosion | Aegis Shield |
| **`[R]`** | **Army of Sparta (8s Ult)** | *(Locked)* | Soul Wave | Storm Wrath |
| **`[B]`** | **Activate Spartan Rage** | End Spartan Rage | Underworld Domain | Divine Overcharge |
| **`[G]`** | — | — | **Summon / Mount Cerberus** | Lightning Blink |

---

## ⚙️ INSTALLATION & DEPENDENCIES

### 📋 Required Mods:
To run this mod smoothly, you **MUST** install these two library mods in your `mods` folder:
1. **[GeckoLib (NeoForge 1.21.1)](https://www.curseforge.com/minecraft/mc-mods/geckolib)** — For 3D boss and entity models.
2. **[Player Animator (NeoForge 1.21.1)](https://www.curseforge.com/minecraft/mc-mods/playeranimator)** — For smooth 1st & 3rd person combat animations.

### 📥 Step-by-Step Setup:
1. Install **Minecraft NeoForge 1.21.1** (Version `21.1.248` or higher).
2. Place `GodsOfOlympus-1.21.1-1.0.0.jar` into your `.minecraft/mods` folder.
3. Add `GeckoLib` and `Player Animator` to your `mods` folder.
4. Launch the game and conquer Olympus! 🏛️⚡🔥