Spawn Heli

Allow the player to spawn a helicopter (e.g., /mymini, /myheli, /myattack):

spawnheli.all.spawn

spawnheli.minicopter.spawn

spawnheli.scraptransport.spawn

spawnheli.attackhelicopter.spawn

Allow the player to fetch their existing helicopter (e.g,. /fmini, /fheli, /fattack):

spawnheli.all.fetch

spawnheli.minicopter.fetch

spawnheli.scraptransport.fetch

spawnheli.attackhelicopter.fetch

Note: The fetch permissions are required to make the spawn command fetch the player's existing helicopter when using the "Auto fetch": true configuration option.

Allow the player to despawn their existing helicopter (e.g., /nomini, /noheli, /noattack):

spawnheli.all.despawn

spawnheli.minicopter.despawn

spawnheli.scraptransport.despawn

spawnheli.attackhelicopter.despawn

Allow the player's helicopter to function without fuel:

spawnheli.all.unlimitedfuel

spawnheli.minicopter.unlimitedfuel

spawnheli.scraptransport.unlimitedfuel

spawnheli.attackhelicopter.unlimitedfuel

Disable decay damage to the player's helicopter:

spawnheli.all.nodecay

spawnheli.minicopter.nodecay

spawnheli.scraptransport.nodecay

spawnheli.attackhelicopter.nodecay

Allow the player to spawn their helicopter as often as they would like:

spawnheli.all.nocooldown

spawnheli.minicopter.nocooldown

spawnheli.scraptransport.nocooldown

spawnheli.attackhelicopter.nocooldown

Caution: Allowing helicopters to be respawned too frequently could be abused by players to reduce server performance. Alternatively, you can rely on the default cooldown configuration option, and/or grant non-zero cooldowns using permissions (see below).

Allow the player to auto mount their helicopter when spawning or fetching it (requires feature to be enabled in the config, and permissions are only necessary if configured to require permission):

spawnheli.all.automount

spawnheli.minicopter.automount

spawnheli.scraptransport.automount

spawnheli.attackhelicopter.automount

Allow the player's helicopter to takeoff instantly, bypassing engine startup time (requires feature to be enabled in the config, and permissions are only necessary if configured to require permission):

spawnheli.all.instanttakeoff

spawnheli.minicopter.instanttakeoff

spawnheli.scraptransport.instanttakeoff

spawnheli.attackhelicopter.instanttakeoff

The following permissions come with the plugin's default configuration. Each one determines how much fuel the helicopter spawns with.

Minicopters:

100 fuel.

500 fuel.

1000 fuel.

Scrap Transport Helicopters:

100 fuel.

500 fuel.

1000 fuel.

Attack Helicopters:

100 fuel.

500 fuel.

1000 fuel.

Additional permissions may be defined by adding them to Fuel profiles requiring permission per vehicle type in the configuration.

Note: If a player is granted multiple fuel permissions for a given helicopter type, the last one will apply, according to the profile order in the configuration.

Caution: Allowing helicopters to spawn with fuel could be abused to generate lots of fuel if the player is granted a low spawn cooldown. As an alternative to spawning helicopters with fuel, consider granting the spawnheli.minicopter.unlimitedfuel permission.

The following permissions come with the plugin's default configuration. Each one determines how often players can spawn helicopters.

1 hour.

10 minutes.

10 seconds.

1 hour.

10 minutes.

10 seconds.

1 hour.

10 minutes.

10 seconds.

Additional permissions may be defined by adding them to Spawn Cooldowns -> Cooldown profiles requiring permission per vehicle type in the configuration.

Note: If a player is granted multiple spawn cooldown permissions for a given helicopter type, the last one will apply, according to the profile order in the configuration.

Caution: Allowing helicopters to be respawned too frequently could be abused by players to reduce server performance. Instead of allowing helicopters to be spawned frequently, consider granting the fetch permission, setting a reasonable fetch cooldown, enabling "Auto fetch": true, and enabling "Repair on fetch": true.

The following permissions come with the plugin's default configuration. Each one determines how often players can fetch their existing helicopters.

1 hour.

10 minutes.

10 seconds.

1 hour.

10 minutes.

10 seconds.

1 hour.

10 minutes.

The following commands will spawn your helicopter. If Auto fetch is enabled for that helicopter type, these commands will fetch your existing helicopter if you have one.

Spawn your Minicopter.

Spawn your Scrap Transport Helicopter.

Spawn your Attack Helicopter.

The following commands will fetch your existing helicopter.

Fetch your Minicopter.

Fetch your Scrap Transport Helicopter.

Fetch your Attack Helicopter.

The following commands will despawn your existing helicopter.

Despawn your Minicopter.

Despawn your Scrap Transport Helicopter.

Despawn your Attack Helicopter.

The spawn/fetch/despawn commands can be changed in the configuration. Additionally, you can define multiple commands to perform the same function in case players are accustomed to different commands from other servers.

Default configuration:

{ "Admin debug bounds": false, "Limit players to one helicopter type at a time": false, "Try to auto despawn other helicopter types": false, "Minicopter": { "Spawn commands": [ "mymini" ], "Fetch commands": [ "fmini" ], "Despawn commands": [ "nomini" ], "Can despawn while occupied": false, "Can fetch while occupied": false, "Can spawn while building blocked": false, "Can fetch while building blocked": false, "Auto fetch": false, "Repair on fetch": false, "Max spawn distance": 5.0, "Max fetch distance": -1.0, "Max despawn distance": -1.0, "Fixed spawn distance": { "Enabled": true, "Distance from player": 3.0, "Helicopter rotation angle": 90.0 }, "Auto mount": { "Enabled": false, "Require permission": false }, "Instant takeoff": { "Enabled": false, "Require permission": false }, "Only owner and team can mount": false, "Spawn health": 750.0, "Destroy on disconnect": false, "Fuel": { "Default fuel amount": 0, "Fuel profiles requiring permission": [ { "Fuel amount": 100, "Permission suffix": "100" }, { "Fuel amount": 500, "Permission suffix": "500" }, { "Fuel amount": 1000, "Permission suffix": "1000" } ] }, "Spawn cooldowns": { "Default cooldown (seconds)": 3600.0, "Cooldown profiles requiring permission": [ { "Cooldown (seconds)": 3600.0, "Permission suffix": "1hr" }, { "Cooldown (seconds)": 600.0, "Permission suffix": "10m" }, { "Cooldown (seconds)": 10.0, "Permission suffix": "10s" } ] }, "Fetch cooldowns": { "Default cooldown (seconds)": 10.0, "Cooldown profiles requiring permission": [ { "Cooldown (seconds)": 3600.0, "Permission suffix": "1hr" }, { "Cooldown (seconds)": 600.0, "Permission suffix": "10m" }, { "Cooldown (seconds)": 10.0, "Permission suffix": "10s" } ] } }, "ScrapTransportHelicopter": { "Spawn commands": [ "myheli" ], "Fetch commands": [ "fheli" ], "Despawn commands": [ "noheli" ], "Can despawn while occupied": false, "Can fetch while occupied": false, "Can spawn while building blocked": false, "Can fetch while building blocked": false, "Auto fetch": false, "Repair on fetch": false, "Max spawn distance": 5.0, "Max fetch distance": -1.0, "Max despawn distance": -1.0, "Fixed spawn distance": { "Enabled": true, "Distance from player": 3.0, "Helicopter rotation angle": 90.0 }, "Auto mount": { "Enabled": false, "Require permission": false }, "Instant takeoff": { "Enabled": false, "Require permission": false }, "Only owner and team can mount": false, "Spawn health": 1000.0, "Destroy on disconnect": false, "Fuel": { "Default fuel amount": 0, "Fuel profiles requiring permission": [ { "Fuel amount": 100, "Permission suffix": "100" }, { "Fuel amount": 500, "Permission suffix": "500" }, { "Fuel amount": 1000, "Permission suffix": "1000" } ] }, "Spawn cooldowns": { "Default cooldown (seconds)": 3600.0, "Cooldown profiles requiring permission": [ { "Cooldown (seconds)": 3600.0, "Permission suffix": "1hr" }, { "Cooldown (seconds)": 600.0, "Permission suffix": "10m" }, { "Cooldown (seconds)": 10.0, "Permission suffix": "10s" } ] }, "Fetch cooldowns": { "Default cooldown (seconds)": 10.0, "Cooldown profiles requiring permission": [ { "Cooldown (seconds)": 3600.0, "Permission suffix": "1hr" }, { "Cooldown (seconds)": 600.0, "Permission suffix": "10m" }, { "Cooldown (seconds)": 10.0, "Permission suffix": "10s" } ] } }, "AttackHelicopter": { "Spawn commands": [ "myattack" ], "Fetch commands": [ "fattack" ], "Despawn commands": [ "noattack" ], "Can despawn while occupied": false, "Can fetch while occupied": false, "Can spawn while building blocked": false, "Can fetch while building blocked": false, "Auto fetch": false, "Repair on fetch": false, "Max spawn distance": 5.0, "Max fetch distance": -1.0, "Max despawn distance": -1.0, "Fixed spawn distance": { "Enabled": true, "Distance from player": 3.0, "Helicopter rotation angle": 90.0 }, "Auto mount": { "Enabled": false, "Require permission": false }, "Instant takeoff": { "Enabled": false, "Require permission": false }, "Only owner and team can mount": false, "Spawn health": 850.0, "Destroy on disconnect": false, "Fuel": { "Default fuel amount": 0, "Fuel profiles requiring permission": [ { "Fuel amount": 100, "Permission suffix": "100" }, { "Fuel amount": 500, "Permission suffix": "500" }, { "Fuel amount": 1000, "Permission suffix": "1000" } ] }, "Spawn cooldowns": { "Default cooldown (seconds)": 3600.0, "Cooldown profiles requiring permission": [ { "Cooldown (seconds)": 3600.0, "Permission suffix": "1hr" }, { "Cooldown (seconds)": 600.0, "Permission suffix": "10m" }, { "Cooldown (seconds)": 10.0, "Permission suffix": "10s" } ] }, "Fetch cooldowns": { "Default cooldown (seconds)": 10.0, "Cooldown profiles requiring permission": [ { "Cooldown (seconds)": 3600.0, "Permission suffix": "1hr" }, { "Cooldown (seconds)": 600.0, "Permission suffix": "10m" }, { "Cooldown (seconds)": 10.0, "Permission suffix": "10s" } ] } } }

The following options are global, not tied to a specific helicopter type.

Admin debug bounds (true or false) -- Determines whether to display visual bounding boxes when an admin attempts to spawn a helicopter. The bounding boxes are only visible to the admin who attempted to spawn the helicopter. This can be useful when debugging "Not enough space" messages.

Limit players to one helicopter type at a time (true or false) -- Determines whether each player must first destroy their other helicopter(s) before they can spawn a new one. For example, while true, a player with a Minicopter will not be able to spawn an Attack Helicopter or Scrap Transport Helicopter until the Minicopter is destroyed.

Try to auto despawn other helicopter types (true or false) -- Determines whether attempting to spawn a helicopter will automatically try to despawn the player's other helicopter(s). For example, while true, when a player with a Minicopter attempts to spawn an Attack Helicopter, their existing Minicopter will be automatically despawned if possible. In some cases, despawning the existing helicopter is not possible (e.g., if that helicopter is occupied, and despawning that helicopter type while occupied is disallowed according to the plugin configuration), in which case the player will simply be informed that they must first destroy their existing helicopter(s).Note: This option only takes effect while Limit players to one helicopter type at a time is also true.

Note: This option only takes effect while Limit players to one helicopter type at a time is also true.

Each vehicle section (Minicopter, ScrapTransportHelicopter, and AttackHelicopter) has the following options.

Determines which commands can be used to spawn the heli.

Determines which commands can be used to fetch the heli.

Determines which commands can be used to despawn the heli.

Can despawn while occupied (true or false) -- Determines whether players can despawn their helicopter while it is occupied. A helicopter is considered occupied if a player is mounted to it, or if passengers are in the transport bay (i.e., for Scrap Transport Helicopters).

Can fetch while occupied (true or false) -- Determines whether players can fetch their helicopter while it is occupied. While true, fetching the heli will automatically dismount all players. Regardless of this setting, players cannot be fetched their helicopter while they are occupying it.

Can spawn while building blocked (true or false) -- Determines whether players can spawn their helicopter while building blocked.

Can fetch while building blocked (true or false) -- Determines whether players can fetch their helicopter while building blocked.

Auto fetch (true or false) -- Determines whether your existing helicopter will be automatically fetched when using the spawn command. This feature only applies to players who have the fetch permission, and it is subject to the player's fetch cooldown.

Repair on fetch (true or false) -- Determines whether to repair the helicopter when fetched. Note: It is advised to set a reasonable fetch cooldown to prevent abuse.

Determines the maximum distance away that players can spawn their helicopter. This only applies while Fixed spawn distance is disabled which is enabled by default.

Determines the maximum distance at which players can be from their helicopter and still be able to fetch it. Set to -1 for unlimited distance.

Determines the maximum distance at which players can be from their helicopter and still be able to despawn it. Set to -1 for unlimited distance.

When enabled, fixed spawn distance causes the helicopter to be spawned and fetched in front of the player at a consistent distance, regardless of where the player is aiming. While disabled, players have to aim at a valid nearby surface in order to spawn the helicopter.Enabled (true or false) -- Determines whether fixed spawn distance is enabled.Distance from player -- Determines how far away from the player the helicopter will be spawned.Helicopter rotation angle -- Determines how the helicopter will be rotated relative to the player when spawned or fetched.

When enabled, spawning or fetching a helicopter will automatically mount the owner player to the pilot seat. Note: Giving a player a helicopter using admin/server commands will skip auto mount.Enabled (true or false) -- Determines whether auto mount is enabled.Require permission (true or false) -- Determines whether players need permission for the auto mount feature.

When enabled, helicopters spawned by this plugin can takeoff instantly, bypassing engine startup time.Enabled (true or false) -- Determines whether instant takeoff is enabled.Require permission (true or false) -- Determines whether the owner of the helicopter needs permission for this feature to work.

Only owner and team can mount (true or false) -- Set to true to only allow the owner and their team members to be able to mount the helicopter.

Destroy on disconnect (true or false) -- Determines whether player helicopters will be despawned when the owner disconnects from the server. Note: If a player is mounted to the helicopter when the owner disconnects, the despawn will be delayed until no more players are mounted to it.