ImprovedAttackHeli expands the functionality of Rust's Attack Helicopter by giving pilots additional controls and capabilities, including boost, hover mode, pilot-controlled turret firing, normal rockets, and MLRS rockets.

Designed for servers that want a more capable and customizable Attack Helicopter experience.

Features

🚀 Rocket Support

Configure the Attack Helicopter to accept additional ammunition types:

* Normal Rockets
* MLRS Rockets
* Configure each rocket type independently.
* MLRS firing requires the appropriate permission.
* Rocket ammunition is automatically detected and displayed when supported.

MLRS rockets are fired with an adjusted projectile position to help prevent the rocket from immediately colliding with the helicopter.

⚡ Boost

Give authorized pilots a temporary speed boost while flying.

* Hold Shift to activate boost.
* Release Shift to return to normal flight.
* Normal players and VIP players can have different boost settings.
* Boost speed and fuel consumption are configurable.

Default settings:

| Setting | Normal | VIP |
| ---------------- | -----: | ---: |
| Speed multiplier | 2x | 4x |
| Fuel multiplier | 2x | 1x |

VIP players can therefore receive a substantially higher boost while actually using less fuel than the standard boost configuration.

🛸 Hover Mode

Authorized pilots can temporarily lock the helicopter's vertical position.

* Press and hold E to activate hover.
* Release E to disable hover.
* The helicopter's vertical movement is frozen while hover is active.
* Hover is automatically disabled when the pilot dismounts.

🔫 Pilot-Controlled Turret

Pilots can operate the Attack Helicopter's turret without switching to the normal gunner view.

* Hold Middle Mouse to fire the turret.
* The turret is automatically aimed forward while firing.
* R can be used to fire/reload the turret functionality.
* The plugin prevents the pilot controls from interfering when the player is already using the gunner view.

Firing the turret also causes the helicopter's mounted players to be marked hostile, matching the game's hostile behavior.

Controls

| Key | Function |
| ---------------- | -------------------- |
| Shift | Activate Boost |
| E | Hold to Hover |
| R | Turret Fire / Reload |
| Middle Mouse | Pilot Turret |

Controls only function when the player has the corresponding permission.

Permissions

| Permission | Description |
| --------------------------- | -------------------------------------------------------- |
| ImprovedAttackHeli.Boost | Allows the player to use helicopter boost |
| ImprovedAttackHeli.Vip | Gives the player VIP boost settings |
| ImprovedAttackHeli.Mlrs | Allows the player to fire MLRS rockets |
| ImprovedAttackHeli.Turret | Allows the player to operate the pilot-controlled turret |
| ImprovedAttackHeli.Hover | Allows the player to use hover mode |

Configuration

The plugin automatically creates and manages its configuration file.

Default configuration:

{
  "Normal Boost Heli Speed Multiplyer": 2.0,
  "Normal Boost Heli Fuel Usage Multiplyer": 2.0,
  "VIP User Boost Speed Multiplyer": 4.0,
  "VIP Boost Heli Fuel Usage Multiplyer": 1.0,
  "Allow Loading Normal Rockets": false,
  "Allow Loading MLRS Rockets (Player still requires Mlrs Perm to fire)": false
}

Configuration Options

Normal Boost Heli Speed Multiplyer

Controls the Attack Helicopter engine thrust multiplier while a normal player is using boost.

Default: 2

Normal Boost Heli Fuel Usage Multiplyer

Controls fuel consumption while a normal player is using boost.

Default: 2

VIP User Boost Speed Multiplyer

Controls the engine thrust multiplier for players with the VIP permission.

Default: 4

VIP Boost Heli Fuel Usage Multiplyer

Controls fuel consumption while a VIP player is using boost.

Default: 1

Allow Loading Normal Rockets

Allows normal rocket ammunition to be loaded into the Attack Helicopter.

Default: false

Allow Loading MLRS Rockets

Allows MLRS rockets to be loaded into the Attack Helicopter.

Players still require:

ImprovedAttackHeli.Mlrs

to fire MLRS rockets.

Default: false

Permission Setup

Give a player normal boost access:

oxide.grant user <player> ImprovedAttackHeli.Boost

Give a player VIP boost settings:

oxide.grant user <player> ImprovedAttackHeli.Vip

Allow MLRS rockets:

oxide.grant user <player> ImprovedAttackHeli.Mlrs

Allow pilot turret control:

oxide.grant user <player> ImprovedAttackHeli.Turret

Allow hover:

oxide.grant user <player> ImprovedAttackHeli.Hover

You can also grant permissions to groups instead of individual players:

oxide.grant group <group> ImprovedAttackHeli.Boost
oxide.grant group <group> ImprovedAttackHeli.Vip
oxide.grant group <group> ImprovedAttackHeli.Mlrs
oxide.grant group <group> ImprovedAttackHeli.Turret
oxide.grant group <group> ImprovedAttackHeli.Hover

Compatibility

ImprovedAttackHeli uses Harmony patches to extend the existing Attack Helicopter functionality rather than replacing the helicopter itself.

The plugin patches the Attack Helicopter's rocket handling and pilot input systems to provide its additional functionality.

Installation

1. Download ImprovedAttackHeli.cs.
2. Place it in your server's:

oxide/plugins/

3. Restart the server or reload the plugin:

oxide.reload ImprovedAttackHeli

4. Configure the generated configuration file if required.
5. Grant the desired permissions to players or groups.

Default Behaviour

By default:

* Boost is permission controlled.
* VIP boost settings are permission controlled.
* Hover is permission controlled.
* Pilot turret control is permission controlled.
* Normal rockets are disabled.
* MLRS rockets are disabled.
* Standard Attack Helicopter flight behaviour remains unchanged unless a player activates one of the plugin's features.

Notes

When the plugin is unloaded, helicopters that are currently boosted are returned to the standard Attack Helicopter engine and fuel settings.

Hover is also cleared when the pilot dismounts, preventing the helicopter from remaining vertically locked after the pilot leaves.