Optional Dependencieshttps://umod.org/plugins/server-rewards
https://umod.org/plugins/economics
Create and customize unlimited tiers of helicopters with advanced configurations. Enhance your server now with brutal and unique helicopters and let your players live the true experience of the event.

A great addition to both PVE and PVP servers.


Looking for help or got a mod idea? Join my Discord and share your thoughts with me.

Join the Dana Discord Server!​

Check out the Dana community on Discord - hang out with 305 other members and enjoy free voice and text chat.
discord.gg

---

Demo​

---

​

Permissions​

• customhelicoptertiers.call.<Tier> - Allows using the heli.call chat commands for a specific helicopter
• customhelicoptertiers.call.all - Allows using the heli.call chat commands for all helicopters
• customhelicoptertiers.limits.<Name> - Assigns a set of command limits.
• customhelicoptertiers.admin - Allows using the admin commands

---

Chat Commands​

• heli.help - Prints all commands and their usage
• heli.call <Tier> - Spawns the helicopter from a random location
• heli.call <Tier> here - Calls the helicopter to your location
• heli.kill <Tier> - Kills the helicopter
• heli.kill all - Kills all active helicopters on the map
• heli.loot set <Tier> - Sets the loot table of the helicopter
• heli.spawn set <Spawn Point Name> <Position> - Sets a custom spawn point based on the coordinates
• heli.spawn set <Spawn Point Name> here - Sets a custom spawn point at your location
• heli.spawn delete <Spawn Point Name> - Deletes a custom spawn point
• heli.spawn show - Shows all created custom spawn points
• heli.delete <Tier> - Deletes a helicopter
• heli.add <Tier> - Adds a helicopter
• heli.list - Lists all created helicopters

---

Console Commands​

• heli.call <Tier> - Spawns the helicopter from a random location
• heli.call <Tier> <Steam ID> - Calls the helicopter to the player's location
• heli.kill <Tier> - Kills the helicopter
• heli.kill all - Kills all active helicopters on the map
• heli.report - Prints a report of the helicopters

---

Global Configuration​

JSON:
"Global Helicopter Config": {
"Turrets Bullet Accuracy": 2,
"Disable Rust Default Helicopter": true,
"Maximum Helicopter Life Time In Minutes": 15.0
},

The above configs can't be set individually for each tier and changing them will affect all of the created helicopters.

---

PVP Configuration​

JSON:
"PVP": {

"Lock To The Invoker": true,

"Team Included On Invoker Lock": false,

"Invoker Has Priority In The Team": true,

"Do Not Allow Others To Trigger The Helicopter Until Reaching The Invoker": false,

"Lock To First Attacker": false

},

Lock To The Invoker​

If enabled, the helicopter will not attack anyone but the player who called it, and it can't be interrupted by other players.
Damage dealt by other players will be nullified as well.

Team Included On Invoker Lock​

Team and clan members of the invoker will be added to the hostility list of the helicopter.

Invoker Has Priority In The Team​

If enabled, the player who called the helicopter will have top priority among his teammates, but if he isn't alive or visible, then it'll target one of his team members.

This option only works if Team Included On Invoker Lock is enabled.

Do Not Allow Others To Trigger The Helicopter Until Reaching The Invoker​

Stops the called helicopter from moving to its destination to the invoker and tries to attack the player who interrupted it instead.

Lock To First Attacker​

This works as a reservation system. The helicopter will be locked to the first player who attacks it

---

PVE Configuration​

JSON:
"PVE": {

"Prevent Damage To Other Players Properties": false

},

Prevent Damage To Other Players Properties​

This works perfectly for PVE servers as it prevents any attempt to raid or destroy structures of other players while attacking the helicopter.

---

Damage Configuration​

JSON:
"Damage": {

"Rockets - Blunt Damage": 175,

"Rockets - Explosion Damage": 100,

"Rockets - Explosion Radius": 6,

"Rockets - Max Launched Rockets": 12,

"Rockets - Time Between Each Rocket In Seconds": 1,

"Turrets - Bullet Damage": 20.0,

"Turrets - Max Bullet Range": 300.0,

"Turrets - Bullet Speed": 250,

"Turrets - Interval Between Bursts In Seconds": 3,

"Turrets - Duration of Burst In Seconds": 3,

"Turrets - Fire Rate In Seconds": 12

},

Rockets Blunt Damage​

Modifies the blunt damage caused by a single rocket.

Rockets Explosion Damage​

Modifies the explosion damage caused by a single rocket.

Rockets Explosion Radius​

Modifies the radius of an explosion caused by a single rocket.

Rockets Max Launched Rockets​

Sets the maximum rockets launched per attack.

Rockets Time Between Each Rocket In Seconds​

Adjusts the launch time between each rocket.

Turrets Bullet Damage​

Adjusts the damage a single bullet from helicopter machine guns can deal (Default 20)

Turrets Max Bullet Range​

Adjusts the maximum range of the machine guns (Default 300)

Turrets Bullet Accuracy​

Adjusts the accuracy of the machine guns (Default 2)

Turrets Bullet Speed​

Adjusts the travel speed of the bullet (Default 250)

Turrets Interval Between Bursts In Seconds​

Adjusts the cooldown between each burst of machine guns (Default 3)

Turrets Duration of Burst In Seconds​

Adjusts the fire duration of the machine guns (Default 3)

Turrets Fire Rate In Seconds​

Adjusts the fire speed of the machine guns (Default 0.125)

---

Health Configuration​

JSON:
"Health": {

"Body": 10000.0,

"Main Rotor": 750.0,

"Tail Rotor": 375.0

},

Body​

The base health of the helicopter (Default 10000)

Main Rotor​

The health of the top rotor (Default 750)

Tail Rotor​

The health of the tail rotor (Default 375)

---

Speed Configuration​

JSON:
"Speed": {

"Maximum Helicopter Speed": 25.0,

"Helicopter Startup Length In Seconds": 0.0,

"Initial Helicopter Startup Speed": 25.0

},

Maximum Helicopter Speed​

The maximum flight speed of the helicopter (Default 25)

Helicopter Startup Length In Seconds​

The time needed for the helicopter to change its initial speed to the maximum speed (Default 0)

Initial Helicopter Startup Speed​

The initial speed of the helicopter before reaching that maximum speed (Default 25)

---

Chat Broadcast Configuration​

JSON:
"Chat Broadcast": {

"Manual Spawn": false,

"Custom Spawn": false,

"Random Spawn": false

},

Manual Spawn​

Broadcasts a message in chat when the helicopter is spawned by using the heli.call command.

Custom Spawn​

Broadcasts a message in chat when the helicopter is spawned by the server from one of the predefined custom spawn points.

Random Spawn​

Broadcasts a message in chat when the helicopter is spawned by the server from any location randomly.

---

Loot Configuration​

JSON:
"Loot": {

"Gibs - Health": 500.0,

"Gibs - Harvest Cooldown In Seconds": 480.0,

"Crates - Amount": 4,

"Crates - Prevent Drop When Force Kill": true,

"Crates - Unlock Cooldown In Minutes": 15.0,

"Crates - Vanilla Maximum Slots": 2,

"Crates - Vanilla Minimum Slots": 1,

"Loot - Lock To Invoker": false,

"Loot - Include Team": true,

"Loot - Admin Bypass Crates Cooldown": true,

"Custom Loot Table - Enabled": false,

"Custom Loot Table": []

}

Gibs Health​

The health of the harvestable fallen parts of the helicopter after it gets destroyed (Default 500)

Gibs Harvest Cooldown In Seconds​

The wait time required before the debris can be harvested (Default 480)

Crates Amount​

The number of dropped crates after the helicopter gets destroyed (Default 4)

Crates Prevent Drop When Force Kill​

If enabled, the helicopter will not drop any loot crates if it gets destroyed using the heli.kill command.

Crates Unlock Cooldown In Minutes​

The wait time required before the crates can be accessed and looted.

Set to -1 for no cooldown.

Crates Vanilla Slots​

Determines the minimum and maximum available slots in a single loot crate.

Lock To Invoker​

Only allow the player who called the helicopter to loot the crates.

Include Team​

Allow team and clan members of the invoker to loot the crates.

Admin Bypass Crates Cooldown​

Allows admins to bypass the firelock of loot crates.

---

Creating Custom Loot Table​

JSON:
"Custom Loot Table - Enabled": true,

"Custom Loot Table": [

{

"Item ID": -742865266,

"Item Short Name": "ammo.rocket.basic",

"Skin ID": 0,

"Minimum Amount": 2,

"Maximum Amount": 3,

"Blueprint": false

},

Create a custom loot table by using the command heli.loot set <Tier>.


A crate will spawn in front of you which you can drop the wished items in to create the loot table. Afterwards, the items and their amounts will be saved automatically into the config.

The maximum amount you dropped in the crate will be used as the maximum amount.

If you had already a pre-created loot table, then its items will also appear in the spawned crate, allowing you to modify them easily.



You can create the loot table manually as well by duplicating the items configs.
Short names and IDs of items can be found here

---

Spawn Configuration​

JSON:
"Spawn": {

"Spawn Chance (Default = 100)": 100.0,

"Minimum Spawn Time In Minutes": 60.0,

"Maximum Spawn Time In Minutes": 120.0,

"Randomized Spawn - Enabled (Vanilla)": true,

"Custom Spawn - Enabled": false,

"Custom Spawn - Locations": [

"Airfield"

]

},

Spawn Chance​

The probability of the helicopter to spawn

Spawn Time In Minutes​

The maximum and minimum time for spawning the helicopter.

Randomized Spawn​

If enabled, the helicopter will spawn from any location randomly.

Custom Spawn​

If enabled, the helicopter will spawn from predefined custom spawn locations.
Keep in mind that you can't have both Randomized Spawn and Custom Spawned enabled.


Create custom spawn locations by using the heli.spawn set <Spawn Point Name> <Position> command

• The Position can be replaced either with a coordinate X, Y, Z or with here
• You can get the player coordinate by using the server command server.printpos

Now, and under the Custom Spawn Locations config, add the name of the spawn location you created.



You can add as many custom spawn locations as you want to each tier, and for each time the helicopter spawns, it'll choose one of them randomly.

---

Kill Rewards​

JSON:
"Kill Rewards": {

"Reward Points": 1000,

"Economics": 1000

},

Allow your players to receive Money and Reward Points by taking down the helicopter.
Rewards are given based on the total damage dealt to the helicopter.

---

Kill Statistics​

Statistics are broadcasted in a chat message upon destroying the helicopter, and they include

• Accuracy of hitting the rotors
• Total damage dealt
• Time spent to take down the helicopter

---

Custom Command Limits​

JSON:
"Call Command": {

"Default Cooldown In Minutes": 0.0,

"Default Daily Limit": 0,

"Custom Limits": {

"VIP": {

"Cooldown Minutes": 60.0,

"Daily Limit": 3

}

}

}

Call Command Cooldown In Minutes​

The default time required in order to use the heli.call command again.

Call Command Daily Limit​

The default number of times a player can use the heli.call command per day.

Custom Limits​

Provides dynamic permissions which allow infinite customization for each tier.


To add custom limits assigned to permission, head to the Custom Limits config and create one with the name VIP. Now, replace <Name> in customhelicoptertiers.limits.<Name> permission with VIP.

This will result in customhelicoptertiers.limits.VIP, which when granted will have a cooldown of 60 minutes and 3 limited uses per day



In case a player has 2 permissions with different limits, he'll be automatically using the best available limits from each of them.

---

Monuments Spawn Locations​

JSON:
"Monuments Spawn Locations": {

"Large Fishing Village": {

"Position": {

"x": -454.068848,

"y": 0.0,

"z": -1019.226

}

},

"Fishing Village": {

"Position": {

"x": 612.134949,

"y": 0.0,

"z": 489.8864

}

}

}
Monuments spawn locations of monuments are auto-generated on plugin load and they get added automatically to the Monuments Spawn Locations list.