Heli Control allows tweaking various settings of helicopters on the server.
Please keep in mind everything in the config has been set to the exact default settings Rust uses without the plugin. Installing this plugin will not change any helicopter behavior by default.
-1 values generally indicate untouched values (leaves it to Rust to handle)
Damage - Global damage multiplier (default 1.0, unchanged) - This scales the amount of damage the Helicopter takes from any and all sources.
Gibs - Health of gibs (default 500) - The health that the helicopter "gibs" (harvest-able parts that appear after heli is destroyed) have.
Gibs - Time until gibs can be harvested in seconds (default 480) - The amount of time required until the gibs/helicopter debris can be hit and properly harvested/extracted.
Health - Base Helicopter health (default 10000) - The base Helicopter health (not the rotors!)
Health - Main rotor health (default 750) - The health of the 'main' (top/big) rotor.
Health - Tail rotor health (default 375) - The health of the tail rotor.
Loot - Max Crates to drop (default 4) - The amount of crates to drop when the Helicopter is destroyed.
Loot - Time before unlocking crates (default -1) - The time until the helicopter's loot crates can be looted.
Loot - Use custom spawns (default false) - If set to true, this will use the custom spawns as defined by HeliControl's loot data file.
Misc - Helicopter can shoot while dying (default true) - If set to false, the Helicopter will no longer be able to shoot it's turret while it's crashing to the ground.
Misc - Helicopter speed (default 25) - Controls helicopter speed, higher = faster.
Misc - Helicopter startup length in seconds (default 0) - If Helicopter startup speed is not the same as Helicopter speed, this is how long it will remain in the 'startup' speed.
Misc - Helicopter startup speed (default 25) - The speed of the Helicopter while it's in it's startup time (read above setting).
Misc - Maximum helicopter life time in minutes (default 15) - How long until the Helicopter will leave/despawn.
Misc - Prevent crates from spawning when forcefully killing helicopter (default true) - If set to false, /killheli will still let the helicopter drop it's loot crates.
Misc - Water required to extinguish napalm flames (default 10000) - The amount of water required to extinguish the flames from the Helicopter.
Rockets - Blunt damage to deal (default 175) - The amount of damage a single rocket should do with the 'Blunt' damage type.
Rockets - Explosion damage to deal (default 100) - The amount of damage a single rocket should do with the 'Explosion' damage type.
Rockets - Explosion radius (default 6) - The radius of the explosion from a single Helicopter rocket.
Rockets - Max helicopter rockets (default 12) - How many rockets the Helicopter should shoot when strafing (set to 0 to disable!).
Rockets - Time between each rocket in seconds (default 0.2) - How long to wait before firing another rocket during a strafe.
Spawning - Automatically call helicopter between min seconds (default 0) - The minimum amount of time between spawning a Helicopter.
Spawning - Automatically call helicopter between max seconds (default 0) - The maximum amount of time between spawning a Helicopter.
Spawning - Automatically call CH47 between min seconds (default 0) - The minimum amount of time between spawning a CH47.
Spawning - Automatically call CH47 between max seconds (default 0) - The maximum amount of time between spawning a CH47.
Spawning - Use static spawning (default false) - Uses a constant timer, which means it will immediately begin ticking down upon spawning of a Helicopter rather than it's death (old style of spawning).
Spawning - Automatically call helicopter if one is already flying (default false) - If set to true, the plugin will still spawn Helicopters after the elapsed spawn timer if one is already flying.
Spawning - Automatically call CH47 if one is already flying (default false) - If set to true, the plugin will still spawn CH47s after the elapsed spawn timer if one is already flying.
Spawning - Disable helicopter (default false) - If set to true, the Helicopter will never spawn.
Spawning - Disable helicopter gibs (default false) - If set to true, the Helicopter will not have gibs/debris when it dies.
Spawning - Disable helicopter napalm (default false) - If set to true, the Helicopter will not have napalm.
Spawning - Disable Rust's default spawns (default false) - If set to true, Rust will not natively spawn any helicopters and it will be up to HeliControl and other plugins to spawn helicopters.
Spawning - Max active helicopters (default -1, no limit) - The maximum amount of Helicopters that can be flying at any time from any source.
Spawning - Use custom helicopter spawns (default false) - If set to true, the helicopter will automatically spawn at any custom spawn points that have been created for it.
Turrets - Helicopter bullet accuracy (default 2) - Controls the accuracy of the machine guns on the helicopter. (higher = less accurate (I think))
Turrets - Helicopter bullet damage (default 20) - How much damage a single bullet from the helicopter machine guns should deal.
Turrets - Max range (default 300) - The maximum range the turret can shoot.
Turrets - Time between turret bursts in seconds (default 3) - Time to wait before doing another 'burst' of machine gun fire.
Turrets - Turret burst length in seconds (default 3) - How long the turret 'burst' should last.
Turrets - Turret fire rate in seconds (default 0.125) - How fast the turret should shoot.
The config options under "Cooldowns" and "Limits" in the Config are added as permissions. For example: helicontrol.limit.1, will grant them the first limit permission, with the specified amount of times they are allowed to use it per day, as per the config. Same goes for Cooldown.
When the permission is added to the group or player, they will be able to call it whenever the cooldown elapses, provided they have not hit their limit. The limit resets as soon as the time switches over to the next day. A limit does NOT need to be specified, nor does a cooldown. If you set a limit without a cooldown, they can call it as often as they want. If you set a cooldown without a limit, they can call it much as they want.
By default, players with the cooldown or limit permissions can only call a Helicopter in general, and not to a specific target. To let them call it to themselves, use permission: helicontrol.callheliself - To let them call it to a target, use helicontrol.callhelitargetDo not use helicontrol.callheli unless you want them to be able to call it as much as they want, and wherever.
Players can only call a Helicopter using the chat command, the console command requires the "helicontrol.callheli" or "helicontrol.admin" permission.
It is worth noting that by default, HeliControl should not change any of the Helicopter's behavior, and will only add chat/console commands.
There is no weight system as of yet, so if you want one lootbox to be rarer, add more of the others, by copying and pasting. Duplicates are definitely okay.
Here's an example loot file that you can modify, thanks to Resistance:
HeliControlData (click this)
Default HeliControlData.json - located in /oxide/data/HeliControlData.json:
Use to validate your JSON after editing it!
Default HeliControl weapons data file (oxide\data\HeliControlWeapons.json):
Chat & Console Commands
All commands will work in both chat and console/RCon- /callheli
- /callch47
- /killheli
- /killheli forced
- /killch47
- /killch47 forced
- /killgibs
- /killnapalm
- /strafe - Tells the heli to strafe player's position.
- /helidest - Tells the heli to start flying to this player's position.
- /helispawn - Add a spawn point for the Helicopter to use, if the config allows it.
- /updatehelis - Update all helicopters according to the current plugin configuration. You will still need to reload the plugin after making any changes into the config, then you can run this command.
- /tpheli - Teleport to the ground below the active helicopter, use argument "ch47" to teleport to a CH47. (/tpheli ch47)
- /unlockcrates - Unlock all currently locked helicopter crates. Use argument "ch47" to unlock all locked CH47 (hackable) crates. (/unlockcrates ch47)
- /strafe - Tell the helicopter to strafe (rocket attack) the specified target's position
Console Commands
- callheli pos - Allows you to call a helicopter to a specific position using X, Y and Z coordinates.
Configuration
The settings and options can be configured in the HeliControl file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.Please keep in mind everything in the config has been set to the exact default settings Rust uses without the plugin. Installing this plugin will not change any helicopter behavior by default.
-1 values generally indicate untouched values (leaves it to Rust to handle)
Damage - Global damage multiplier (default 1.0, unchanged) - This scales the amount of damage the Helicopter takes from any and all sources.
Gibs - Health of gibs (default 500) - The health that the helicopter "gibs" (harvest-able parts that appear after heli is destroyed) have.
Gibs - Time until gibs can be harvested in seconds (default 480) - The amount of time required until the gibs/helicopter debris can be hit and properly harvested/extracted.
Health - Base Helicopter health (default 10000) - The base Helicopter health (not the rotors!)
Health - Main rotor health (default 750) - The health of the 'main' (top/big) rotor.
Health - Tail rotor health (default 375) - The health of the tail rotor.
Loot - Max Crates to drop (default 4) - The amount of crates to drop when the Helicopter is destroyed.
Loot - Time before unlocking crates (default -1) - The time until the helicopter's loot crates can be looted.
Loot - Use custom spawns (default false) - If set to true, this will use the custom spawns as defined by HeliControl's loot data file.
Misc - Helicopter can shoot while dying (default true) - If set to false, the Helicopter will no longer be able to shoot it's turret while it's crashing to the ground.
Misc - Helicopter speed (default 25) - Controls helicopter speed, higher = faster.
Misc - Helicopter startup length in seconds (default 0) - If Helicopter startup speed is not the same as Helicopter speed, this is how long it will remain in the 'startup' speed.
Misc - Helicopter startup speed (default 25) - The speed of the Helicopter while it's in it's startup time (read above setting).
Misc - Maximum helicopter life time in minutes (default 15) - How long until the Helicopter will leave/despawn.
Misc - Prevent crates from spawning when forcefully killing helicopter (default true) - If set to false, /killheli will still let the helicopter drop it's loot crates.
Misc - Water required to extinguish napalm flames (default 10000) - The amount of water required to extinguish the flames from the Helicopter.
Rockets - Blunt damage to deal (default 175) - The amount of damage a single rocket should do with the 'Blunt' damage type.
Rockets - Explosion damage to deal (default 100) - The amount of damage a single rocket should do with the 'Explosion' damage type.
Rockets - Explosion radius (default 6) - The radius of the explosion from a single Helicopter rocket.
Rockets - Max helicopter rockets (default 12) - How many rockets the Helicopter should shoot when strafing (set to 0 to disable!).
Rockets - Time between each rocket in seconds (default 0.2) - How long to wait before firing another rocket during a strafe.
Spawning - Automatically call helicopter between min seconds (default 0) - The minimum amount of time between spawning a Helicopter.
Spawning - Automatically call helicopter between max seconds (default 0) - The maximum amount of time between spawning a Helicopter.
Spawning - Automatically call CH47 between min seconds (default 0) - The minimum amount of time between spawning a CH47.
Spawning - Automatically call CH47 between max seconds (default 0) - The maximum amount of time between spawning a CH47.
Spawning - Use static spawning (default false) - Uses a constant timer, which means it will immediately begin ticking down upon spawning of a Helicopter rather than it's death (old style of spawning).
Spawning - Automatically call helicopter if one is already flying (default false) - If set to true, the plugin will still spawn Helicopters after the elapsed spawn timer if one is already flying.
Spawning - Automatically call CH47 if one is already flying (default false) - If set to true, the plugin will still spawn CH47s after the elapsed spawn timer if one is already flying.
Spawning - Disable helicopter (default false) - If set to true, the Helicopter will never spawn.
Spawning - Disable helicopter gibs (default false) - If set to true, the Helicopter will not have gibs/debris when it dies.
Spawning - Disable helicopter napalm (default false) - If set to true, the Helicopter will not have napalm.
Spawning - Disable Rust's default spawns (default false) - If set to true, Rust will not natively spawn any helicopters and it will be up to HeliControl and other plugins to spawn helicopters.
Spawning - Max active helicopters (default -1, no limit) - The maximum amount of Helicopters that can be flying at any time from any source.
Spawning - Use custom helicopter spawns (default false) - If set to true, the helicopter will automatically spawn at any custom spawn points that have been created for it.
Turrets - Helicopter bullet accuracy (default 2) - Controls the accuracy of the machine guns on the helicopter. (higher = less accurate (I think))
Turrets - Helicopter bullet damage (default 20) - How much damage a single bullet from the helicopter machine guns should deal.
Turrets - Max range (default 300) - The maximum range the turret can shoot.
Turrets - Time between turret bursts in seconds (default 3) - Time to wait before doing another 'burst' of machine gun fire.
Turrets - Turret burst length in seconds (default 3) - How long the turret 'burst' should last.
Turrets - Turret fire rate in seconds (default 0.125) - How fast the turret should shoot.
Permissions
This plugin uses the permission system. To assign a permission, use oxide.grant <user or group> <name or steam id> <permission>. To remove a permission, use oxide.revoke <user or group> <name or steam id> <permission>.- helicontrol.callheli - Allows player unlimited access to /callheli command (read below section for limited callheli permissions)
- helicontrol.killheli - Allows player access /killheli command
- helicontrol.killgibs - Allows player access to /killgibs command
- helicontrol.killnapalm - Allows player access to /killnapalm command
- helicontrol.helispawn - Allows player access to /helispawn command
- helicontrol.strafe - Allows player access to /strafe command
- helicontrol.update - Allows player access to /updatehelis command
- helicontrol.destination - Allows player access to /helidest command
- helicontrol.admin - Allows player permission to everything and overrides cooldowns/limits on callheli
- helicontrol.dropcrates - Whoever has this permission, when they call a heli, that heli will spawn crates on death. Using helicontrol.adminwill grant this permission.
- helicontrol.ignorelimits - Grants player unlimited uses of /callheli. Using helicontrol.adminwill grant this permission.
- helicontrol.ignorecooldowns - Grants player access to /callheli without needing to wait for any cooldown. Using helicontrol.adminwill grant this permission.
- helicontrol.callmultiple - Grants player access to call in multiple helicopters (more than 1 at a time). Without this, they'll have to wait for the airspace to be clear before they can call a helicopter. Using helicontrol.adminwill grant this permission.
- helicontrol.callmultiplech47 - Grants player access to call in multiple CH47 helicopters (more than 1 at a time). Without this, they'll have to wait for the airspace to be clear before they can call a helicopter. Using helicontrol.adminwill grant this permission.
The config options under "Cooldowns" and "Limits" in the Config are added as permissions. For example: helicontrol.limit.1, will grant them the first limit permission, with the specified amount of times they are allowed to use it per day, as per the config. Same goes for Cooldown.
When the permission is added to the group or player, they will be able to call it whenever the cooldown elapses, provided they have not hit their limit. The limit resets as soon as the time switches over to the next day. A limit does NOT need to be specified, nor does a cooldown. If you set a limit without a cooldown, they can call it as often as they want. If you set a cooldown without a limit, they can call it much as they want.
By default, players with the cooldown or limit permissions can only call a Helicopter in general, and not to a specific target. To let them call it to themselves, use permission: helicontrol.callheliself - To let them call it to a target, use helicontrol.callhelitargetDo not use helicontrol.callheli unless you want them to be able to call it as much as they want, and wherever.
Players can only call a Helicopter using the chat command, the console command requires the "helicontrol.callheli" or "helicontrol.admin" permission.
It is worth noting that by default, HeliControl should not change any of the Helicopter's behavior, and will only add chat/console commands.
Default Configuration
Spawn System:There is no weight system as of yet, so if you want one lootbox to be rarer, add more of the others, by copying and pasting. Duplicates are definitely okay.
Here's an example loot file that you can modify, thanks to Resistance:
HeliControlData (click this)
Default HeliControlData.json - located in /oxide/data/HeliControlData.json:
Use to validate your JSON after editing it!
Default HeliControl weapons data file (oxide\data\HeliControlWeapons.json):
