About Heli Pilots
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 and Minicopter.
• 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.
• 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
}
}
]
}
}
