# Chopper Gunner
Bring Apache aerial support to Minecraft. Take the gunner controls yourself, call in an AI escort, or draw a patrol route on a tactical map and let the helicopter defend the area.
Inspired by the Chopper Gunner killstreak from Call of Duty: Modern Warfare, with Minecraft-specific progression, rechargeable countermeasures, and reloading missiles.
## Three ways to deploy
- **Gunner Control:** Operate the helicopter through a remote camera while your character remains on the ground. Move, adjust altitude, aim the 30mm cannon, and launch Hellfire missiles.
- **Escort Support:** Have the Apache follow you and engage threats, including enemies you attack.
- **Area Patrol:** Plan a circular orbit or an A-to-B patrol line using the tablet's terrain map, with panning, zoom, route previews, and radius/distance measurements.
## Earn your air support
Earn a deployment with **10 personal hostile-mob kills**. A green killstreak indicator shows when support is ready; press **K** by default to open the deployment menu. Helicopter kills do not build another streak.
For creative play, the reusable **Tactical Support Tablet** opens the same menu without requiring kills. One active aircraft per player.
## Firepower and countermeasures
- 30mm cannon with visible tracers and animated turret aiming.
- Eight Hellfire missiles per load, with automatic reload after the rack is emptied.
- Rechargeable flares with a 20-second cooldown and 10 seconds of protection against hostile-mob projectiles.
- Escort and patrol automatically deploy flares after surviving projectile hits.
- Ranged hostile mobs can attack the helicopter. Aircraft can take damage, be shot down, and crash.
## Presentation
Detailed Apache and cockpit models, cinematic call-ins, pilot hands with Minecraft-style sleeves and gloves, rotor and weapon audio, thermal vision, target markers, and a dedicated gunner HUD.
Hellfire impacts use a large custom flash, overlapping fireballs, lingering smoke, an expanding ground shockwave, layered audio, and nearby camera shake. Configurable craters use a shared block-removal budget, while damage and knockback happen immediately.
Other players see and hear the aircraft in the world, including its turret movement, weapons, flares, and departure.
## Default controls
| Action | Control |
|---|---|
| Open earned deployment menu | K |
| Move helicopter | WASD |
| Raise/lower altitude | Space / Shift |
| Fire cannon | Left mouse |
| Zoom | Right mouse |
| Launch missile | G |
| Deploy flares | R |
| Toggle thermal vision | N |
| Toggle target markers | B |
| Exit gunner control | X |
Key bindings can be changed in Minecraft's Controls menu. Escape opens the pause menu without ending gunner control; multiplayer servers continue running.
## Requirements and installation
- **Minecraft Java Edition 1.20.1**
- **Forge 47.x**
- **Java 17**
- Install the same mod version on the client and server.
- Remove older Chopper Gunner/Rotor Support JARs before updating.
- No separate resource pack or additional required library mod.
## Configuration and performance
Terrain damage is enabled by default. Configure block damage, crater radius, and the shared block-removal budget in the world's `serverconfig/chopper-gunner-server.toml`. Camera shake and the killstreak indicator can be configured in `config/chopper-gunner-client.toml`.
Particle settings reduce effect density. Large smoke effects and detailed aircraft can be demanding with shaders; performance and thermal appearance vary by shader pack and hardware. Universal shader compatibility is not guaranteed.
## Credits
Developed with AI-assisted coding and tooling through OpenAI Codex, with iterative in-game testing and direction by the project creator.
An unofficial fan project, not affiliated with Mojang, Microsoft, Activision, or Infinity Ward.