Vehicle Fleet

# VEHICLE FLEET - TACTICAL TRANSPORTS & NAVAL FLEET
**Minecraft 1.20.1 • Forge 47.4.10+ • GeckoLib 4**

---

### [PROJECT SUMMARY / SHORT DESCRIPTION] (Max 255 chars)
Walkable military vehicles with realistic physics: tactical haulers, helicopters, a strategic airlifter, patrol ships, an LPD, and a submarine. Walk on moving decks, place blocks on sailing ships, multi-crew seating, and Titan/Exoframe cargo support!

---

### [ABOUT THE MOD]
Vehicle Fleet introduces a studio-grade roster of drivable military vehicles, heavy tactical aircraft, and naval warships into Minecraft 1.20.1 Forge. Designed with high-fidelity 3D micro-geometry, authentic military soundscapes, and advanced physics, every vehicle features fully walkable moving collision decks, fully modeled interior cabins, interactive multi-crew seating, functional cargo doors/ramps, and nighttime cockpit illumination.

Whether you are conducting low-level troop drops from a UH-60 Black Hawk, airlifting heavy armored payloads in a C-17 Globemaster III, patrolling coastal waters in a guided-missile corvette, or building customized forward operating bases directly onto the deck of a moving tramp freighter, Vehicle Fleet delivers an unmatched tactical vehicle experience.

---

### [VEHICLE ROSTER (14 VEHICLES)]

#### 1. Ground Transport & Haulers
* **Heavy Tactical Technical 4x4 (`technical_4x4`):**
  - Fast, agile tactical all-terrain transport.
  - Crew: 2 (Driver, Front Passenger) + Open cargo bed.
  - Feature: Functional folding tailgate, rear bed cargo tie-down.

* **Humvee M1165 ECV Transport (`humvee_m1165`):**
  - Expanded capacity tactical troop and logistics carrier.
  - Crew: 4 (Driver, Front Passenger, 2 Rear Passengers).
  - Feature: Reinforced cab doors, rear enclosed trunk, full dashboard instrumentation.

* **Heavy 6x6 Off-Road Hauler (`ural_6x6`):**
  - High-payload military cargo transport with all-wheel drive.
  - Crew: 3 (Driver, Passenger, Center Crew).
  - Feature: Massive diamond-plate cargo bed with walkable drop-down tailgate.

* **Heavy 6x6 Armored Recovery Vehicle (`recovery_6x6`):**
  - Battlefield repair and recovery wrecker truck.
  - Crew: 2 (Driver, Co-Driver).
  - Feature: Fully articulated hydraulic recovery crane, outriggers, and tool storage.

---

#### 2. Rotary-Wing Aircraft (Helicopters)
* **UH-60 Black Hawk Tactical Utility Helicopter (`uh60_blackhawk`):**
  - Premier multi-role airborne assault and utility helicopter.
  - Crew: 6 (Pilot, Copilot, 4 Cabin Troop Benches).
  - Feature: Sliding cabin troop doors, spinning tail rotor, realistic cyclic bank dynamics.

* **Mil Mi-17 Hip Heavy Tactical Transport (`mi17_hip`):**
  - Rugged medium-lift transport helicopter.
  - Crew: 14 (Pilot, Copilot, 12 Cabin Troops).
  - Feature: Iconic greenhouse cockpit canopy with dual cyclic flight controls, opening rear clamshell cargo doors, and deployable ventral underslung cargo sling rig.

* **Mil Mi-26 Halo Super-Heavy Transport (`mi26_halo`):**
  - The world's largest production heavy-lift transport helicopter.
  - Crew: 3 (Pilot, Copilot, Flight Engineer) + Massive interior cargo hold.
  - Feature: 8-bladed main rotor with blade-droop physics, opening rear cargo ramp.

---

#### 3. Strategic Fixed-Wing Aircraft
* **C-17 Globemaster III Strategic Airlifter (`c17_airlifter`):**
  - Heavy long-range strategic military air transport.
  - Crew: 27 (Pilot, Copilot, Loadmaster, 24 Jump Seats).
  - Feature: Full two-deck walkable interior (Upper Flight Deck & Crew Rest Station, Lower Massive Walkable Cargo Bay), motorized rear cargo ramp with ground-reach lip, aerodynamic banking and flight physics.

---

#### 4. Naval Fleet & Warships
* **Coaster Tramp Freighter (`coaster_freighter`):**
  - 40-meter civilian cargo and expedition motor ship.
  - Crew: 4 (Helm, Bridge Crew).
  - Feature: Deep well deck, forward derrick cargo crane, multi-tier stern bridge superstructure with wheelhouse and 360-degree bridge wings.
  - SPECIAL: Full on-deck block building support! Place and destroy vanilla blocks, chests, furnaces, or banners directly on deck while sailing!

* **Fast Attack Craft Missile/Gun Patrol Boat (`fac_patrol`):**
  - High-speed littoral combat and interceptor craft.
  - Crew: 2 (Helm, Co-Helm).
  - Feature: High-speed planning hull, outward bank turning dynamics, dual weapon mount stations.

* **Offshore Patrol Vessel / Coast Guard Cutter (`opv_cutter`):**
  - Multi-mission offshore patrol ship.
  - Crew: 3 (Helm, Co-Helm, Captain).
  - Feature: Enclosed navigation bridge, raised foredeck, stern work deck.

* **Stealth Guided Missile Corvette (`corvette_stealth`):**
  - Radar-absorbent tumblehome stealth surface warship.
  - Crew: 3 (Helm, Co-Helm, Captain).
  - Feature: Faceted stealth superstructure, enclosed concealed forward gun mount, aft helicopter pad.

* **Landing Platform Dock Amphibious Assault Ship (`lpd_assault`):**
  - Heavy amphibious warfare naval vessel.
  - Crew: 3 (Helm, Co-Helm, Captain).
  - Feature: Stern floodable well deck for landing craft/vehicles, expansive aft helicopter flight deck, forward bridge tower.

* **Tactical Transport Submarine (`transport_sub`):**
  - Subsurface infiltration and logistics vessel.
  - Crew: 14 (Helm, Co-Helm, Captain, Crew Bunk Compartments).
  - Feature: Fully walkable interior pressure hull with bunk rooms, mess galley, central stair hall, control room, and forward torpedo/stores bay.

---

### [KEY FEATURES]

1. Walkable Moving Decks (Dynamic Deck Colliders):
Unlike standard vehicle mods where standing on a moving vehicle causes players to fall through or jitter off, Vehicle Fleet implements real-time synchronized kinematic deck physics. Walk freely on the cargo deck of a flying C-17, climb the stairs of the submarine while underway, or stroll across the deck of an assault ship without glitching.

2. Build Real Minecraft Blocks on Sailing Ships:
Turn your freighter or warship into a mobile base. Right-click with vanilla building blocks (Stone, Planks, Glass, Slabs, Stairs, Torches, Chests, Furnaces, Banners) directly onto ship decks to build custom cabins, storage setups, or defenses. The blocks stay anchored and sail seamlessly with the ship! Left-click to harvest blocks back into your inventory.

3. True Cockpit & Seat Anchors:
Every single seat is geometrically aligned with 3D interior seats, steering wheels, pedals, and throttles. First-person view places your camera right at true eye level looking through clear glass windshields and instrument panels. Press the seat-switch key to cycle between driver, copilot, and passenger seats.

4. Authentic Vehicle Physics:
- Ground Vehicles: Realistic Ackerman steering, tire rolling animations, body suspension roll on cornering, smooth acceleration and braking curves.
- Helicopters: Collective lift control, cyclic banking (vehicle tilts in direction of travel), tail rotor anti-torque yaw control, rotor startup spool-up, and autorotation descent.
- Aircraft: Runway acceleration, rotation and takeoff, true aerodynamic stall mechanics, banked turns, and smooth rollout landings.
- Ships: Realistic waterline displacement, outward hull lean on high-speed turns, bow wave rise, and engine wake particles.

5. Nighttime Cockpit Lighting (Glowmasks):
Instruments, HUD panels, radar consoles, gauge clusters, and navigation lights glow brightly in the dark via dedicated emissive texture layers, providing an authentic night-operation atmosphere.

6. Optional Mech / Exoframe Cargo Support:
Vehicle Fleet is 100% standalone and requires no other vehicle or combat mod. However, if Titan Combat or Obsolete is installed, vehicles automatically unlock cargo slots to transport kneeling Titans or Exoframes (in the C-17 cargo bay, freighter well deck, truck beds, or underslung below the Mi-17).

---

### [CONTROLS & KEYBINDINGS]

* W / S: Throttle / Accelerate / Forward / Reverse (or Cyclic Pitch for aircraft)
* A / D: Steer Left / Right (or Anti-Torque Yaw for helicopters)
* Spacebar: Collective Up / Climb (Helicopters & Airlifter)
* Left Ctrl / C: Collective Down / Descend
* X: Switch Seats (Cycle through Driver, Copilot, Navigator, Passengers)
* R: Open / Close Doors, Tailgates, Cargo Ramps, and Clamshells
* L: Toggle Vehicle Headlights & Navigation Lights
* H: Honk Horn / Siren
* G: Release / Drop Underslung Sling Cargo
* Left Shift: Dismount (Safely steps out onto deck or ground)

---

### [DEPENDENCIES & COMPATIBILITY]

* Minecraft: 1.20.1
* Mod Loader: Minecraft Forge (Version 47.1.0 or higher recommended, tested on 47.4.10)
* Required Mod: GeckoLib 4 (Version 4.4.4 or higher for 1.20.1)
* Java Version: Java 17 (Temurin 17 / OpenJDK 17)
* Optional Compatible Mods: Titan Combat, Obsolete

---

### [INSTALLATION]
1. Install Minecraft Forge 1.20.1.
2. Download and place `geckolib-forge-1.20.1-4.4.4.jar` (or latest) into your `.minecraft/mods` folder.
3. Download and place `vehiclefleet-0.3.0.jar` into your `.minecraft/mods` folder.
4. Launch the game and enjoy! Vehicles can be spawned via the Vehicle Fleet creative tab or crafted in survival.