Heli Control

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.

Giving a player access to call a heli with a cooldown/limit:

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.

{ "Cooldowns": { "Cooldown.0": 86400.0, "Cooldown.1": 86400.0, "Cooldown.2": 86400.0, "Cooldown.3": 86400.0, "Cooldown.4": 86400.0, "Cooldown.5": 86400.0, "Cooldown.6": 86400.0, "Cooldown.7": 86400.0, "Cooldown.8": 86400.0, "Cooldown.9": 86400.0, "cooldown.ch47.0": 86400.0, "cooldown.ch47.1": 86400.0, "cooldown.ch47.2": 86400.0, "cooldown.ch47.3": 86400.0, "cooldown.ch47.4": 86400.0, "cooldown.ch47.5": 86400.0, "cooldown.ch47.6": 86400.0, "cooldown.ch47.7": 86400.0, "cooldown.ch47.8": 86400.0, "cooldown.ch47.9": 86400.0 }, "Damage - Global damage multiplier": 1.0, "Gibs - Health of gibs": 500.0, "Gibs - Time until gibs can be harvested in seconds": 480.0, "Health - Base Helicopter health": 10000.0, "Health - Main rotor health": 750.0, "Health - Tail rotor health": 375.0, "Limits": { "Limit.0": 5, "Limit.1": 5, "Limit.2": 5, "Limit.3": 5, "Limit.4": 5, "Limit.5": 5, "Limit.6": 5, "Limit.7": 5, "Limit.8": 5, "Limit.9": 5, "limit.ch47.0": 5, "limit.ch47.1": 5, "limit.ch47.2": 5, "limit.ch47.3": 5, "limit.ch47.4": 5, "limit.ch47.5": 5, "limit.ch47.6": 5, "limit.ch47.7": 5, "limit.ch47.8": 5, "limit.ch47.9": 5 }, "Loot - Max Crates to drop": 4, "Loot - Time before unlocking CH47 crates": -1.0, "Loot - Time before unlocking crates": -1.0, "Loot - Use Custom loot spawns": false, "Misc - Helicopter can shoot while dying": true, "Misc - Helicopter speed": 25.0, "Misc - Helicopter startup length in seconds": 0.0, "Misc - Helicopter startup speed": 25.0, "Misc - Maximum CH47 life time in minutes": 15, "Misc - Maximum helicopter life time in minutes": 15, "Misc - Prevent crates from spawning when forcefully killing helicopter": true, "Rockets - Blunt damage to deal": 175.0, "Rockets - Explosion damage to deal": 100.0, "Rockets - Explosion radius": 6.0, "Rockets - Max helicopter rockets": 12, "Rockets - Time between each rocket in seconds": 0.2, "Spawning - Automatically call CH47 between max seconds": 0.0, "Spawning - Automatically call CH47 between min seconds": 0.0, "Spawning - Automatically call CH47 if one is already flying": false, "Spawning - Automatically call helicopter between max seconds": 0.0, "Spawning - Automatically call helicopter between min seconds": 0.0, "Spawning - Automatically call helicopter if one is already flying": false, "Spawning - Chinooks to spawn": 1, "Spawning - Disable CH47 default spawns": false, "Spawning - Disable Helicopter": false, "Spawning - Disable helicopter gibs": false, "Spawning - Disable helicopter napalm": false, "Spawning - Disable Rust's default spawns": false, "Spawning - Helicopters to spawn": 1, "Spawning - Max active helicopters": -1, "Spawning - Use custom helicopter spawns": false, "Spawning - Use static spawning": false, "Spawning - Use static spawning for CH47": false, "Turrets - Helicopter bullet accuracy": 2.0, "Turrets - Helicopter bullet damage": 20.0, "Turrets - Helicopter bullet speed": 250, "Turrets - Max range": 300.0, "Turrets - Time between turret bursts in seconds": 3.0, "Turrets - Turret burst length in seconds": 3.0, "Turrets - Turret fire rate in seconds": 0.125 }

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 [COLOR=rgb(255, 77, 77)]/oxide/data/HeliControlData.json[/COLOR]:Use https://www.jsonlint.com/ to validate your JSON after editing it!

{ "HeliInventoryLists": [ { "lootBoxContents": [ { "name": "rifle.ak", "amount": 1, "isBP": false }, { "name": "ammo.rifle.hv", "amount": 128, "isBP": false } ] }, { "lootBoxContents": [ { "name": "rifle.bolt", "amount": 1, "isBP": false }, { "name": "ammo.rifle.hv", "amount": 128, "isBP": false } ] }, { "lootBoxContents": [ { "name": "explosive.timed", "amount": 3, "isBP": false }, { "name": "ammo.rocket.hv", "amount": 3, "isBP": false } ] }, { "lootBoxContents": [ { "name": "lmg.m249", "amount": 1, "isBP": false }, { "name": "ammo.rifle", "amount": 100, "isBP": false } ] } ] }

Default HeliControl weapons data file (oxide\data\HeliControlWeapons.json):

{ "WeaponList": { "Assault Rifle": 1.0, "Bolt Action Rifle": 1.0, "Hunting Bow": 1.0, "Crossbow": 1.0, "M249": 1.0, "Eoka Pistol": 1.0, "Revolver": 1.0, "Semi-Automatic Pistol": 1.0, "Semi-Automatic Rifle": 1.0, "Pump Shotgun": 1.0, "Waterpipe Shotgun": 1.0, "Custom SMG": 1.0, "Thompson": 1.0 } }

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

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.