About Apache (Advanced Attack Helicopter)
Apache (Attack Heli Rocket Selector + Armored Windows + Player Cooldown)
The Apache plugin turns the Rust attack helicopter into a fully customizable, player-controlled combat platform with advanced weapon systems, smart rocket handling, and experimental features you won’t find anywhere else.
Apache is a lightweight, server-friendly Rust plugin that upgrades the Attack Helicopter rocket pod into a configurable multi-ammo system with clean in-game controls and full balancing options.
Players can cycle rocket types with the USE key (E) while piloting, and the helicopter will fire the selected rocket type as long as ammo is available. When a type runs out, Apache will announce “out of ammo” and automatically switch to the next available enabled type.
Features
Rocket type selector (Pilot only)
- Press E to cycle through enabled rocket types
- Shows chat feedback: selected type, remaining ammo, and cooldown
Gunner support
- The gunner can also fire the rockets
- The gunner can aim the rockets using the built-in helicopter monitor
Supported ammo types
- HV
- Basic
- Incendiary
- MLRS
- SAM
Out-of-ammo intelligence
- Warns at 0 ammo
- Announces what rocket type will be used next
- Automatically switches to the next available enabled type
Per-rocket balancing
- Separate cooldown, launch speed, and up-bias (trajectory lift) for each rocket type
Alternating launch positions
-
Uses Left/Right local offsets (configurable) so you can align firing to your pod locations
Optional armored windows
- Toggle armored window on/off from config
Permission system
- apache.admin → unlimited spawns + admin tools
- apache.player → cooldown-limited spawns
Player spawn cooldown
- Configurable X hours per spawn for players with apache.player
- Stores cooldown data in a data file
Admin reset
- /apache reset wipes cooldown data and starts fresh
Works with /shop plugin
- You can use spawn.apache %steamid%
Default Configuration Behavior (Important)
On first run, Apache auto-generates the config with most rocket types disabled by default.
Enabled by default:
- HV
Disabled by default (must be enabled manually in the JSON if you want them):
- Basic
- MLRS
- SAM
- Incendiary
This is intentional for safety/balance: the server owner enables only the rocket types they want by editing the .json configuration file.
Commands
spawn.apache
- Spawns an Apache for yourself (requires permission).
spawn.apache <steamid|name>
- Spawns an Apache for a target player (admin only).
/apache
- Same behavior as spawn.apache (for players with cooldown).
/apache reset (admin only)
- Wipes stored cooldown data and resets all player spawn timers.
Permissions
- apache.admin
Admin usage: unlimited spawning, spawning for others, and reset command.
- apache.player
Player usage: allows self-spawn with configurable cooldown.
Configuration
Apache generates a JSON config with:
- Enable/disable each rocket type (also blocks inserting disabled ammo into the pod)
- Armored windows on/offLeft & Right launch offsets (local heli space)
- Local offset axis reminder:
X = left(-) / right(+)
Y = up(+)
Z = forward(+)
Per-rocket:
- Cooldown (seconds)
- Launch speed
- Up bias (adds a small upward lift to trajectory)
Notes / Compatibility
Designed to be server-friendly: only affects plugin-spawned helicopters
Works without requiring players to bind keys (uses E / USE)
Your first configs:
{
"EnableArmoredWindows": true,
"PlayerSpawnCooldownHours": 6.0,
"HV": {
"Enabled": true,
"CooldownSeconds": 0.5,
"LaunchSpeed": 65.0,
"UpBias": 0.02
},
"Basic": {
"Enabled": false,
"CooldownSeconds": 1.0,
"LaunchSpeed": 40.0,
"UpBias": 0.02
},
"MLRS": {
"Enabled": false,
"CooldownSeconds": 5.0,
"LaunchSpeed": 70.0,
"UpBias": 0.03
},
"Incendiary": {
"Enabled": false,
"CooldownSeconds": 1.0,
"LaunchSpeed": 40.0,
"UpBias": 0.02
},
"SAM": {
"Enabled": false,
"CooldownSeconds": 0.5,
"LaunchSpeed": 85.0,
"UpBias": 0.02
},
"LeftOffsetLocal": {
"x": -2.0,
"y": -0.5,
"z": 3.0
},
"RightOffsetLocal": {
"x": 2.0,
"y": -0.5,
"z": 3.0
}
}
