MinicopterCombat

v2.6.0 Oxide Rust

MinicopterCombat turns the standard Rust minicopter into a configurable combat aircraft with pilot-controlled miniguns, missiles, lock-on dogfighting, bombs, rocket boost, reload systems, and an in-flight HUD. Server owners can tune damage, ranges, ammo limits, cooldowns, effects, and permissions to match anything from casual PvE events to high-risk PvP air combat.

Free Rust plugin

Download the plugin source directly, review the configuration example, then install it in your Oxide/uMod plugins folder.

Free Download

6 views

4 downloads

Features

Pilot-controlled frontal minigun with configurable damage, bullet velocity, gravity, aimcone, fire rate, range, falloff, magazine size, reload time, and optional tracer/impact effects.
Side-mounted missile system with configurable missile speed, cooldown, side offsets, reload cooldown, reload sounds, and per-reload missile capacity.
Optional lock-on and homing missile combat with tunable lock time, lock range, cone angle, target warnings, and aircraft-vs-aircraft engagement behavior.
Bomb drop system controlled from the minicopter with configurable bomb capacity, reload time, cooldown, blast radius, damage, drop offsets, prefab, and explosion effects.
Rocket boost system with configurable thrust multiplier, boost fuel duration, recharge time, activation effects, loop effects, and crash explosion behavior.
In-flight HUD that shows weapon ammo, reload states, missile count, bomb count, boost readiness, and lock-on status while piloting a minicopter.
Permission-gated access through minicoptercombat.use, with a config switch to make the plugin open to all players if preferred.
Performance-conscious runtime tracking for active pilots, active minicopters, pending bullets, homing missiles, reload timers, and HUD timers.

Installation

Download MinicopterCombat.cs.
Upload it to oxide/plugins/ on your Rust server.
Let Oxide compile the plugin and generate the configuration file.
Edit oxide/config/MinicopterCombat.json to match your server balance.
Reload the plugin with oxide.reload MinicopterCombat.
If RequirePermission is enabled, grant minicoptercombat.use to the target players or groups.

Configuration

The plugin generates a full configuration file on first load. The most important controls are grouped around permissions, minigun behavior, missile behavior, lock-on, rocket boost, bombs, HUD, and manual reload timing.

{
  "RequirePermission": true,
  "MinigunDamage": 20.0,
  "MinigunRange": 400.0,
  "MinigunBulletVelocity": 500.0,
  "MinigunRoundsPerSecond": 10.0,
  "MinigunMagazineSize": 100,
  "MinigunReloadTime": 30.0,
  "ExplosiveBulletsEnabled": true,
  "ExplosiveBulletChance": 0.01,
  "MissileCooldown": 1.5,
  "MissileSpeed": 100.0,
  "MaxMissilesPerReload": 6,
  "MissileReloadCooldown": 30.0,
  "EnableLockOn": true,
  "LockOnTime": 0.35,
  "LockOnMaxRange": 400.0,
  "LockOnMaxAngle": 10.0,
  "EnableRocketBoost": true,
  "BoostThrustMultiplier": 1.5,
  "BoostFuelDuration": 1.0,
  "BoostRechargeTime": 15.0,
  "EnableBombs": true,
  "MaxBombsPerReload": 4,
  "BombReloadTime": 20.0,
  "BombDamage": 150.0,
  "BombRadius": 6.0,
  "ManualReloadCooldown": 45.0,
  "EnableHUD": true,
  "DebugMode": false
}

For PvP servers, start conservative with lower damage, longer reload timers, and limited explosive bullet chance. For PvE event servers, increase missile and bomb capacity while keeping reload timers long enough to prevent constant spam.

Permissions

Permission	Description
minicoptercombat.use	Allows a player to use the minicopter weapons, lock-on, bombs, boost, HUD, and reload systems when RequirePermission is enabled.

MinicopterCombat