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
• spawnhelitest – Spawn a test helicopter with AI pilot.
• removehelitest – Delete spawned test helicopters.
• visiblehelis – Toggle admin visibility of AI helicopters.
• recordhelipath – Record a custom helicopter patrol path.
See It in Action! Watch the Video
Configuration:
{
"Event settings": {
"Allowed events (1 event - 1 helicopter)": {
"min": 10.0,
"max": 15.0
},
"Event restart delay": {
"min": 30.0,
"max": 60.0
},
"Prevent bot attacks on pilots and passengers?": true,
"Block damage to the helicopter not from players?": true,
"Block damage to driver and companion from not players?": true,
"Clear saved routes after wipe?": true,
"Route recording settings": {
"Enable recorded routes usage?": true,
"Minimum distance between points to record in route (used when recording route)": 50.0,
"Minimum number of points to save (used when recording route)": 5.0
},
"Route generation settings": {
"Enable generated routes to monuments?": true,
"Number of monuments to visit when generating route": 5,
"Monument names for black list (will be excluded when generating route)": [
""
]
},
"Destroy events of this plugin when pause is enabled?": true
},
"Heli settings": [
{
"Helicopter type (Minicopter, TransportHeli)": "Minicopter",
"Max speed": 10.0,
"Height for flying by route": {
"min": 40.0,
"max": 80.0
},
"Damage receive rate": 0.5,
"Pilot name (key) from pilot settings": "Driver",
"Companion name (key) from companion settings": "Companion",
"Fuel settings": {
"Enable automatic fuel refueling?": true,
"Remove fuel when unlocking vehicle?": true,
"Maximum fuel in vehicle": 500
},
"Vehicle headlight settings": {
"Enable vehicle headlights?": false,
"Use headlights only at night?": false
},
"Detonator settings": {
"Add a detonator to the vehicle after the death of the driver (useful to despawn cars)": true,
"After how many seconds detonator will be blow up": 60.0,
"Detonator position offset on the vehicle": {
"x": 0.0,
"y": 0.8,
"z": 0.0
}
},
"Loot container settings": {
"Add loot container to heli?": true,
"Amount of slots": 24,
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"resources"
]
}
},
{
"Helicopter type (Minicopter, TransportHeli)": "TransportHeli",
"Max speed": 10.0,
"Height for flying by route": {
"min": 30.0,
"max": 60.0
},
"Damage receive rate": 0.5,
"Pilot name (key) from pilot settings": "Driver",
"Companion name (key) from companion settings": "Companion",
"Fuel settings": {
"Enable automatic fuel refueling?": true,
"Remove fuel when unlocking vehicle?": true,
"Maximum fuel in vehicle": 500
},
"Vehicle headlight settings": {
"Enable vehicle headlights?": false,
"Use headlights only at night?": false
},
"Detonator settings": {
"Add a detonator to the vehicle after the death of the driver (useful to despawn cars)": true,
"After how many seconds detonator will be blow up": 60.0,
"Detonator position offset on the vehicle": {
"x": 0.0,
"y": 0.8,
"z": 0.0
}
},
"Loot container settings": {
"Add loot container to heli?": true,
"Amount of slots": 24,
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"resources"
]
}
}
],
"Pilots settings": {
"Driver": {
"Bot health": {
"min": 100.0,
"max": 100.0
},
"Prevent attacking players first?": false,
"Spawn bag with items instead of corpse on death?": true,
"Damage receive rate": 0.5,
"Damage rate": 3.0,
"In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,
"Clothes": [
{
"Item shortname": "hazmatsuit_scientist",
"Item skin": 0
}
],
"Weapons": [
{
"Item shortname": "rifle.ak",
"Item skin": 0
}
],
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"resources",
"weapons"
],
"Prefab": "assets/rust.ai/agents/npcplayer/humannpc/scientist/scientistnpc_roamtethered.prefab"
}
},
"Companion settings": {
"Companion": {
"Bot health": {
"min": 100.0,
"max": 100.0
},
"Prevent attacking players first?": true,
"Spawn bag with items instead of corpse on death?": true,
"Damage receive rate": 0.3,
"Damage rate": 2.0,
"In how many seconds remove bots, after destroying the vehicle? (0 - will not remove)": 120.0,
"Clothes": [
{
"Item shortname": "scientistsuit_heavy",
"Item skin": 0
}
],
"Weapons": [
{
"Item shortname": "rifle.ak",
"Item skin": 0
}
],
"Loot set name (key) from loot settings (you can enter many sets for random selection)": [
"weapons"
],
"Prefab": "assets/rust.ai/agents/npcplayer/humannpc/scientist/scientistnpc_roamtethered.prefab"
}
},
"Loot settings": {
"resources": [
{
"Item shortname": "wood",
"Item skin": 0,
"Item name (not necessary)": null,
"Spawn chance": 100.0,
"Item amount": {
"min": 1000.0,
"max": 10000.0
}
},
{
"Item shortname": "stones",
"Item skin": 0,
"Item name (not necessary)": null,
"Spawn chance": 100.0,
"Item amount": {
"min": 5000.0,
"max": 50000.0
}
}
],
"weapons": [
{
"Item shortname": "rifle.ak",
"Item skin": 0,
"Item name (not necessary)": null,
"Spawn chance": 10.0,
"Item amount": {
"min": 1.0,
"max": 1.0
}
}
]
},
"Heli container position settings": {
"TransportHeli": {
"Local position": {
"x": 0.0,
"y": 0.95,
"z": -0.8
},
"Rotation": {
"x": 0.0,
"y": 0.0,
"z": 0.0
}
},
"Minicopter": {
"Local position": {
"x": 0.0,
"y": 0.95,
"z": -0.8
},
"Rotation": {
"x": 0.0,
"y": 0.0,
"z": 0.0
}
}
}
}
