Want more intense air combat and dynamic patrols on your Rust server?
HeliPilots introduces AI helicopter pilots ready to dominate the skies and attack players from the air. Customize everything - from helicopter type and pilot behavior to flight routes!
Features:
Helicopter Setup
• Supports Scrap Transport Helicopter, Minicopter and Attack Helicopter.
• Customizable AI pilots with adjustable health, clothes, weapons, and combat behaviour.
• Define specific flight behavior, speed, altitude, and route paths — random or pre-defined.
Combat & AI Behavior
• Pilots dynamically engage or avoid player attacks.
• Setup rockets and turret for Attack Helicopter.
• Customize aggression level — determine whether AI attacks immediately or must be provoked.
• Customize damage, accuracy, and targeting behavior.
⚙ Advanced Heli Customization
• Modify flight speed, fuel consumption, durability, and damage rate.
• Customize helicopter loot tables and drop rates.
• Configure crash behavior, detonator and other.
Pilot Customization
• Set health, clothes, weapon loadouts, and equipment.
• Custom damage multipliers.
• Customize pilot loot, including weapons, items and resources.
🛠 Event & Path System
• Record custom flight paths or let the plugin auto-generate patrol routes.
• Control event triggers, spawn rates, patrol frequency, and respawn timers.
🖥 Admin Commands (permission drivercontroller.admin)
• spawnhelitest – Spawn a test helicopter with AI pilot.
• removehelitest – Delete spawned test helicopters.
• visibleheli – Toggle admin visibility of AI helicopters.
• recordhelipath – Record a custom helicopter patrol path.
See It in Action! Watch the Video
After downloading you’ll also get plugin called DriverController. It’s a single plugin to setup presets of bots and loot between all of my plugins.
Configuration:
{
"Event settings": {
"Allowed events (vehicle) count": {
"Min": 3.0,
"Max": 6.0
},
"Event restart delay": {
"Min": 60.0,
"Max": 120.0
},
"Prevent NPC from attacking drivers and companions?": true,
"Block damage to transport from not players?": true,
"Block damage to driver and companion from not players?": true,
"Destroy events of this plugin when pause is enabled?": true,
"Delete the event if ran out of fuel?": true,
"Marker text color": {
"Color (for HEX, put # at the beginning)": "0.4 0.5 0.6 1"
},
"Event name for the marker": "EVENT HELI",
"Route recording settings": {
"Enable recorded routes usage?": true,
"Clear saved routes after wipe?": true,
"Minimum distance between points to record in route (used when recording route)": 40.0,
"Minimum number of points to save (used when recording route)": 30.0,
"Recorder route height": 50.0
},
"Route generation": {
"Enable route generation": true,
"Maximum number of monuments for a flight, when generating a route": 5,
"Names of monuments, prefabs or their part, for the blacklist (will be excluded when generating a route)": [
"Outpost"
]
},
"Controller settings": {
"Controller update timer (0 - 0.2)": 0.0
}
},
"Loot container position settings": {
"Minicopter": {
"Container position offset on the vehicle": {
"x": 0.0,
"y": 0.95,
"z": -0.8
},
"Container rotation offset on the vehicle": {
"x": 0.0,
"y": 0.0,
"z": 0.0
}
},
"TransportHeli": {
"Container position offset on the vehicle": {
"x": 0.0,
"y": 0.95,
"z": -0.8
},
"Container rotation offset on the vehicle": {
"x": 0.0,
"y": 0.0,
"z": 0.0
}
}
},
"Heli settings": [
{
"Activate this event?": true,
"Transport type for event(Minicopter, TransportHeli)": "Minicopter",
"Driver name (key) from driver settings in DriverController plugin": "PilotHeli",
"Companion name (key) from companion settings in DriverController plugin (list to occupy free seats in the vehicle)": [
"Companion1"
],
"Loot container settings": {
"Enable loot in vehicle container?": true,
"Drop the loot when destroying the transport?": false,
"Amount of slots": 1,
"Name of loot set from loot settings in DriverController plugin (list loot sets for random selection)": [
"ResourcesHeli"
]
},
"Сontroller settings": {
"Max speed (km/h)": 40.0,
"Maximum speed when obstacles detected (km/h)": 15.0,
"Height for flying along the route": {
"Min": 30.0,
"Max": 60.0
},
"Chase mode settings": {
"Chase attacking players?": true,
"Max chase distance": 250.0,
"Chase timer": 120.0,
"Maximum speed during chase (km/h)": 60.0,
"Height for flying during chase": {
"Min": 10.0,
"Max": 30.0
}
}
},
"Damage receive rate": 0.5,
"Fuel settings": {
"Enable automatic fuel refueling?": true,
"Remove fuel when unlocking vehicle?": true,
"Maximum fuel in vehicle": 500
},
"Vehicle headlight settings": {
"Enable vehicle headlights?": true,
"Use headlights only at night?": true
},
"Detonator settings": {
"Add C4 to the vehicle after the death of the driver (used to despawn vehicles)": true,
"After how many seconds explosives will be blown up": 60.0,
"Explosives position offset": {
"x": 0.0,
"y": 0.1,
"z": 0.0
}
}
},
{
"Activate this event?": true,
"Transport type for event(Minicopter, TransportHeli)": "TransportHeli",
"Driver name (key) from driver settings in DriverController plugin": "PilotHeli",
"Companion name (key) from companion settings in DriverController plugin (list to occupy free seats in the vehicle)": [
"Companion1"
],
"Loot container settings": {
"Enable loot in vehicle container?": true,
"Drop the loot when destroying the transport?": false,
"Amount of slots": 1,
"Name of loot set from loot settings in DriverController plugin (list loot sets for random selection)": [
"ResourcesHeli"
]
},
"Сontroller settings": {
"Max speed (km/h)": 40.0,
"Maximum speed when obstacles detected (km/h)": 15.0,
"Height for flying along the route": {
"Min": 40.0,
"Max": 70.0
},
"Chase mode settings": {
"Chase attacking players?": true,
"Max chase distance": 250.0,
"Chase timer": 120.0,
"Maximum speed during chase (km/h)": 60.0,
"Height for flying during chase": {
"Min": 5.0,
"Max": 20.0
}
}
},
"Damage receive rate": 0.5,
"Fuel settings": {
"Enable automatic fuel refueling?": true,
"Remove fuel when unlocking vehicle?": true,
"Maximum fuel in vehicle": 500
},
"Vehicle headlight settings": {
"Enable vehicle headlights?": true,
"Use headlights only at night?": true
},
"Detonator settings": {
"Add C4 to the vehicle after the death of the driver (used to despawn vehicles)": true,
"After how many seconds explosives will be blown up": 60.0,
"Explosives position offset": {
"x": 0.0,
"y": 0.8,
"z": 0.0
}
}
}
]
}
DriverController Configuration:
{
"Drivers settings": {
"DriverBike": {
"Bot health": {
"Min": 100.0,
"Max": 150.0
},
"Prevent attacking players first?": true,
"Damage receive rate": 2.0,
"Damage rate": 2.0,
"Spawn bag with items instead of corpse on death?": true,
"In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,
"Clothes": [
{
"Item": {
"Item shortname or ID": "shoes.boots",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
},
{
"Item": {
"Item shortname or ID": "wood.armor.pants",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
},
{
"Item": {
"Item shortname or ID": "pants",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
},
{
"Item": {
"Item shortname or ID": "wood.armor.jacket",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
},
{
"Item": {
"Item shortname or ID": "hoodie",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
},
{
"Item": {
"Item shortname or ID": "riot.helmet",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Weapons": [
{
"Item": {
"Item shortname or ID": "pistol.revolver",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Bot loot": {
"Enable loot after bot's death?": true,
"Amount of slots": 5,
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"ResourcesDriver"
]
}
},
"DriverCar": {
"Bot health": {
"Min": 100.0,
"Max": 150.0
},
"Prevent attacking players first?": true,
"Damage receive rate": 2.0,
"Damage rate": 2.0,
"Spawn bag with items instead of corpse on death?": true,
"In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,
"Clothes": [
{
"Item": {
"Item shortname or ID": "hazmatsuit",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Weapons": [
{
"Item": {
"Item shortname or ID": "rifle.ak",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Bot loot": {
"Enable loot after bot's death?": true,
"Amount of slots": 5,
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"ResourcesDriver"
]
}
},
"DriverBoat": {
"Bot health": {
"Min": 100.0,
"Max": 150.0
},
"Prevent attacking players first?": true,
"Damage receive rate": 2.0,
"Damage rate": 2.0,
"Spawn bag with items instead of corpse on death?": true,
"In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,
"Clothes": [
{
"Item": {
"Item shortname or ID": "hazmatsuit",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Weapons": [
{
"Item": {
"Item shortname or ID": "t1_smg",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Bot loot": {
"Enable loot after bot's death?": true,
"Amount of slots": 5,
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"ResourcesDriver"
]
}
},
"PilotHeli": {
"Bot health": {
"Min": 100.0,
"Max": 150.0
},
"Prevent attacking players first?": true,
"Damage receive rate": 2.0,
"Damage rate": 2.0,
"Spawn bag with items instead of corpse on death?": true,
"In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,
"Clothes": [
{
"Item": {
"Item shortname or ID": "jumpsuit.suit.blue",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Weapons": [
{
"Item": {
"Item shortname or ID": "rifle.ak",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Bot loot": {
"Enable loot after bot's death?": true,
"Amount of slots": 5,
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"ResourcesDriver"
]
}
}
},
"Companion settings": {
"Companion1": {
"Bot health": {
"Min": 100.0,
"Max": 150.0
},
"Prevent attacking players first?": true,
"Damage receive rate": 2.0,
"Damage rate": 2.0,
"Spawn bag with items instead of corpse on death?": true,
"In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,
"Clothes": [
{
"Item": {
"Item shortname or ID": "hazmatsuit_scientist_nvgm",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Weapons": [
{
"Item": {
"Item shortname or ID": "rifle.ak",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Bot loot": {
"Enable loot after bot's death?": true,
"Amount of slots": 5,
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"ResourcesCompanion",
"WeaponsCompanion"
]
}
},
"Companion2": {
"Bot health": {
"Min": 100.0,
"Max": 150.0
},
"Prevent attacking players first?": true,
"Damage receive rate": 2.0,
"Damage rate": 2.0,
"Spawn bag with items instead of corpse on death?": true,
"In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,
"Clothes": [
{
"Item": {
"Item shortname or ID": "hazmatsuit.arcticsuit",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Weapons": [
{
"Item": {
"Item shortname or ID": "rifle.ak",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Bot loot": {
"Enable loot after bot's death?": true,
"Amount of slots": 5,
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"ResourcesCompanion",
"WeaponsCompanion"
]
}
},
"Companion3": {
"Bot health": {
"Min": 100.0,
"Max": 150.0
},
"Prevent attacking players first?": true,
"Damage receive rate": 2.0,
"Damage rate": 2.0,
"Spawn bag with items instead of corpse on death?": true,
"In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,
"Clothes": [
{
"Item": {
"Item shortname or ID": "hazmatsuit.lumberjack",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Weapons": [
{
"Item": {
"Item shortname or ID": "rifle.ak",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Bot loot": {
"Enable loot after bot's death?": true,
"Amount of slots": 5,
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"ResourcesCompanion",
"WeaponsCompanion"
]
}
},
"Companion4": {
"Bot health": {
"Min": 100.0,
"Max": 150.0
},
"Prevent attacking players first?": true,
"Damage receive rate": 2.0,
"Damage rate": 2.0,
"Spawn bag with items instead of corpse on death?": true,
"In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,
"Clothes": [
{
"Item": {
"Item shortname or ID": "hazmatsuit.spacesuit",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Weapons": [
{
"Item": {
"Item shortname or ID": "rifle.ak",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Amount": 1
}
],
"Bot loot": {
"Enable loot after bot's death?": true,
"Amount of slots": 5,
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"ResourcesCompanion",
"WeaponsCompanion"
]
}
}
},
"Loot settings": {
"ResourcesBike": [
{
"Item": {
"Item shortname or ID": "wood",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 5000.0,
"Max": 50000.0
}
},
{
"Item": {
"Item shortname or ID": "stones",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 1000.0,
"Max": 10000.0
}
}
],
"ResourcesCar": [
{
"Item": {
"Item shortname or ID": "wood",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 5000.0,
"Max": 50000.0
}
},
{
"Item": {
"Item shortname or ID": "stones",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 1000.0,
"Max": 10000.0
}
}
],
"ResourcesBoat": [
{
"Item": {
"Item shortname or ID": "wood",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 5000.0,
"Max": 50000.0
}
},
{
"Item": {
"Item shortname or ID": "stones",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 1000.0,
"Max": 10000.0
}
}
],
"ResourcesHeli": [
{
"Item": {
"Item shortname or ID": "wood",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 5000.0,
"Max": 50000.0
}
},
{
"Item": {
"Item shortname or ID": "stones",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 1000.0,
"Max": 10000.0
}
}
],
"ResourcesDriver": [
{
"Item": {
"Item shortname or ID": "wood",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 1000.0,
"Max": 10000.0
}
},
{
"Item": {
"Item shortname or ID": "stones",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 100.0,
"Max": 1000.0
}
}
],
"ResourcesCompanion": [
{
"Item": {
"Item shortname or ID": "wood",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 100.0,
"Max": 1000.0
}
},
{
"Item": {
"Item shortname or ID": "stones",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 100.0,
"Max": 100.0
},
"Amount": {
"Min": 10.0,
"Max": 100.0
}
}
],
"WeaponsCompanion": [
{
"Item": {
"Item shortname or ID": "rifle.ak",
"Item skin": 0
},
"Item custom name (if not needed leave empty)": null,
"Spawn chance (0-100%)": {
"Min": 40.0,
"Max": 80.0
},
"Amount": {
"Min": 1.0,
"Max": 1.0
}
}
]
}
}
