Titan Combat: Frontline Mechs

# ⚡ Titan Combat: Frontline Mechs

Bring heavy mechanized warfare to Minecraft! **Titan Combat** introduces agile, high-impact assault mechs designed for tactical gameplay, orbital atmospheric drops, energy shield protection, and full multiplayer faction combat.

Built from the ground up for **Minecraft Forge 1.20.1**, fully optimized for zero tick lag and seamless dedicated server synchronization.

---

## 🚀 Key Features

* **🛰️ Stratospheric Orbital Drop:** Deploy your mech anywhere under the open sky using the **Titan Drop Beacon**. Watch it burn through the atmosphere and slam into the terrain with a kinetic shockwave that stuns and blasts surrounding enemies!
* **🕹️ Seamless Cockpit Piloting:** Right-click to board the upper chest cockpit. Walk effortlessly over 2-block walls and obstacles with automatic step-height traversal.
* **🛡️ Recharging Energy Shield:** High-tech personal deflector shield absorbs incoming explosions, bullets, and melee attacks before hull integrity is damaged. Regenerates automatically after 5 seconds of peace.
* **💨 Thruster Dash:** High-mobility propulsion thrusters allow swift omni-directional dashes to evade fire or close the gap on enemy fortifications.
* **🎨 Faction Decals & Full Color Customization:** 
  * Choose between 6 pre-set factions using the **Faction Spray Can**.
  * Use **any of the 16 Vanilla Minecraft Dyes** to spray-paint the mech's primary armor plating in real time!
  * Emissive LED glow for cockpit visors and rear thrusters.
* **🚨 Emergency Ejection:** When your mech is in a critical "Doomed" state, hit the emergency eject key (`X`) to launch yourself 30+ blocks skyward into the clouds while your chassis detonates in a nuclear meltdown!
* **🖥️ Futuristic Cockpit HUD:** Real-time first-person heads-up display tracking Hull Integrity, Shield Capacity, Thruster Fuel, and Faction status.

---

## 🎮 Controls & Instructions

| Action | Control | Description |
| :--- | :--- | :--- |
| **Summon Mech** | Right-Click Ground | Plant a **Titan Drop Beacon** with clear sky access. |
| **Board / Mount** | Right-Click Chassis | Enter the armored cockpit. |
| **Thruster Dash** | `SPACEBAR` | Propels the mech in the current movement direction. |
| **Emergency Eject**| `X` (Default) | Launches the pilot high into the sky and initiates self-destruct. |
| **Change Faction** | Right-Click with Spray Can | Cycles faction allegiance and combat camo. |
| **Custom Paint** | Right-Click with any Dye | Instantly coats armor plating in the dye's color. |

---

## 🌐 Multiplayer & Compatibility

* **Zero-Desync Architecture:** Uses native synchronized entity data for smooth, lag-free server performance.
* **Friendly Fire Protection:** Automated targeting and ability damage distinguish allies from hostiles based on assigned Faction ID.
* **Shader & Modpack Ready:** Uses native `EntityModel` rendering — 100% compatible with Embeddium, Oculus, BSL Shaders, Complementary, TACZ guns, and Curios.

---

## 📜 Permissions & License
* **Modpacks:** You are completely free to include **Titan Combat** in any public or private modpack.