Modular Mech: Tactical Exoskeleton & Industrial Machinery

# ⚙️ Modular Mech: Tactical Exoskeleton & Industrial Machinery


> **"One Chassis. Infinite Deployments."**  
> Transform your Minecraft survival and combat experience with industrial-grade modular mechs, interchangeable climate kits, utilitarian labor tools, and Titanfall-inspired cockpit piloting.

---

## 🌟 Key Features

### 1. 🦾 Universal Core Frame (C.F.I.)
Every mech begins with a standardized, lightweight mechanical skeleton chassis featuring exposed hydraulic actuators, internal wiring, an openable cockpit roll cage, and universal **C.F.I. (Core Frame Interface)** sockets.

### 2. 🌍 5 Climate-Adapted Armor Kits
Snap specialized armor plates onto your core chassis to dominate any biome:
- ❄️ **Arctic Warrior:** Ice-runner skis + sub-zero thermal actuators for high-speed snow mobility.
- 🌿 **Jungle Scout:** Agile bipedal servos + FLIR target sensors and obstacle vine-cutters.
- 🏜️ **Desert Stalker:** Tan heat-composite armor + dual shoulder missile batteries (12 cells) and sand filters.
- 🌊 **Aquatic Diver:** Pressurized deep-sea hull + hydro-vector thrusters and ballast stabilization.
- 🛡️ **Heavy Assault:** Reactive charcoal blast-plating + caterpillar tank treads and twin 30mm autocannons.

### 3. ⛏️ Industrial Workhorse: Beyond Combat
Modular Mech is built for labor, industry, and survival automation:
- **Tungsten Rotary Mining Drill:** 3x3 tunnel excavator with stone grinding SFX and auto-hopper collection.
- **Hydraulic Excavator Scoop:** 3x3 high-speed trench digging in sand, gravel, and dirt.
- **Agricultural Harvester:** Autonomous crop-reaping reel that harvests ripe plants and auto-replants seeds.
- **Magnetic Vacuum Hopper:** Draws all dropped items within a 5.5-meter radius directly into internal cargo.

### 4. 🎒 Modular 54-Slot Cargo Expansion
- **Standard Storage:** 27 built-in internal cargo slots.
- **Expedition Cargo Pods:** Equipping rear pod backpacks unseals an extra 27 slots (total **54 slots**, matching a vanilla Double Chest).
- **Smart Shift+Click Routing:** Fuel (Coal, Charcoal, Coal Blocks) automatically routes straight to the reactor fuel bay.

### 5. 🚀 Gundam-Style Flight & Thruster Vectoring
Equip the **Flight Thrusters Module** to engage vertical takeoffs, aerial hovering, and sustained high-speed vector-thrust flight complete with animated exhaust wings and plasma plume VFX.

### 6. 🖥️ Holographic Cockpit HUD & Diagnostics
Climb into the cockpit for a complete first-person HUD experience:
- Titanfall-inspired holographic vector reticle & digital artificial horizon.
- Real-time digital compass tape and heading readout.
- Live telemetry dashboard monitoring **Hull Integrity**, **Reactor Heat**, **Fuel Reserves**, and **Pilot Vitals**.
- Climate-specific sensor readouts (Sonar depth gauge, FLIR motion counters, ice friction indexes).

---

## 🎮 Controls & Keybindings

| Key | Action |
| :--- | :--- |
| **W / A / S / D** | Locomotion (Walk / Tread Drive / Ski Slide / Swim) |
| **Space** | Jump / Lift Off / Gundam Flight Boost (When Thrusters Equipped) |
| **Left Shift** | Dismount / Egress Cockpit |
| **R** | Open C.F.I. Terminal Inventory & Module Management |
| **F** | Engage Equipped Hand Weapon / Mining Tool / Harvester |
| **G** | Cycle Locomotion Modes / Deploy Recoil Anchors |

---

## 📦 Requirements & Installation

1. Install **Minecraft Forge 1.20.1** (Recommended: `47.3.0` or higher).
2. Install **[GeckoLib 4](https://www.curseforge.com/minecraft/mc-mods/geckolib)** (`4.4.4+`).
3. Place `modular_mech-1.0.0.jar` into your Minecraft `mods/` directory.
4. *(Recommended)* Pair with modern combat mods like **TACZ (Timeless and Classics Zero)** for the ultimate tactical mech warfare experience!