Subscribe to download
Advanced Rappelling

Adds support for helicopter rappelling. SP & MP Compatible.

Completely optional, but if you want to give back for any of my addons, I would greatly appreciate Donations[www.paypal.com]!

https://forums.bistudio.com/topic/192126-advanced-rappelling/




Also check out my Advanced Urban Rappelling, Advanced Sling Loading and Advanced Towing addons for more rope features!


- Rappel up to 6 players or AI from any helicopter at the same time (depending on helicopter size)
- Enhanced rope physics. Takes into account wind speeds (from the rotor and environment) and air resistance. Players will swing around if the helicopter doesn't stay still.
- Players control when and how quickly to descend down the rope using the "move backward" key
- Supports rappelling onto tops of buildings, through trees, etc
- Command AI in your group to rappel from a helicopter. AI will automatically descend the rope once told to rappel


- Get into any helicopter (not as pilot)
- Once more than 5m off the ground, actions become available to rappel either yourself or your AI units
- Once you are rappelling, press the "move backwards" key to descend down the rope (note: AI will auto-descend)


- Subscribe via steam or download latest release from https://github.com/sethduda/AdvancedRappelling/releases
- If installing this on a server, add the addon to the -serverMod command line option. It's only needed on the server side. Clients dont need it.


You can customize which classes of vehicles support rappelling by setting the AR_SUPPORTED_VEHICLES_OVERRIDE variable in an init.sqf file.

AR_SUPPORTED_VEHICLES_OVERRIDE = [ "CUP_CH47F_base", "RHS_CH_47F" ];

The example above will only allow rappelling from vehicles of class CUP_CH47F_base and RHS_CH_47F.

You can disable shooting whlie rappelling by setting the AR_DISABLE_SHOOTING_OVERRIDE varaible in an init.sqf file. Defaults to false (shooting enabled).

AR_DISABLE_SHOOTING_OVERRIDE = true;

You can limit the number of rappell positions (for all helicopters) using the AR_MAX_RAPPEL_POINTS_OVERRIDE variable in an init.sqf file. Defaults to 6. You can set any value from 1 to 6.

AR_MAX_RAPPEL_POINTS_OVERRIDE = 2;

You can define custom rappel points instead of using the default 6 rappel points by using the AP_CUSTOM_RAPPEL_POINTS variable. You can either specify [x,y,z] model positions or memory point names. Define the AP_CUSTOM_RAPPEL_POINTS variable in your init.sqf file. See https://github.com/sethduda/AdvancedRappelling/blob/master/README.md for an example of how to do this.

You can have AI auto-rappel from a helicopter using the following script (all units in the cargo seats will rappel):

[HELI_NAME] call AR_Rappel_All_Cargo

This function will rappel the cargo units at 25m at the heli's current position. If the heli is currently moving, it will stop so units can rappel.

If you want more control, there are addtional parameters you can set:

[HELI_NAME,RAPPEL_HEIGHT,POSITION_ASL] call AR_Rappel_All_Cargo

RAPPEL_HEIGHT: height in meters to rappel
POSITION_ASL: Exact position ASL where you want the units to rappel to. This script will get them within ~1m of that position.


Make sure you have the mod listed in the -mod or -serverMod command line option. Only -serverMod is required for this addon. If still not working, check your server log to make sure the addon is found.


This addon is only required on the server - is it going to slow down my server?

No - while this addon is server-side only, it installs itself on all clients without them downloading the addon. Most of the time, the rappelling code actually runs client-side, even though you installed the addon only on the server. Magic!

Battleye kicks me when I try to do xyz. What do I do?

You need to configure Battleye rules on your server. Below are the files you need to configure:

setvariable.txt

Add the following exclusions to the end of all lines starting with 4, 5, 6, or 7 if they contain "" (meaning applies to all values):

!"AR_"

setvariableval.txt

If you have any lines starting with 4, 5, 6, or 7 and they contain "" (meaning applies to all values) it's not going to work. Either remove the line or explicitly define the values you want to kick. Since the values of the variables above can vary, I don't know of a good way to define an exclusion rule.

Also, it's possible there are other battleye filter files that can cause issues. If you check your battleye logs you can figure out which file is causing a problem.

The rappelling action appears while in a heli, but do nothing when I select them. How do I fix that?

Most likely your server is setup with a white list for remote executions. In order to fix this, you need to modify your mission's description.ext file, adding the following CfgRemoteExec rules. If using InfiStar you should edit your cfgremoteexec.hpp instead of the description.ext file. See https://community.bistudio.com/wiki/Arma_3_Remote_Execution for more details on CfgRemoteExec.

class CfgRemoteExec
{
class Functions
{
class AR_Client_Rappel_From_Heli { allowedTargets=0; };
class AR_Hint { allowedTargets=1; };
class AR_Hide_Object_Global { allowedTargets=2; };
class AR_Enable_Rappelling_Animation { allowedTargets=2; };
class AR_Rappel_From_Heli { allowedTargets=2; };
};
};


Can this be updated to require a "rope" item (e.g. the Exile rope)?

Yes, here's a way to do this. Add this code to your init.sqf file. It overrides the function that checks if rappelling is allowed. Near the end of this code see the line that checks for the Exile_Item_Rope inventory item.

[] spawn {
waitUntil {!isNil "AR_Rappel_From_Heli_Action_Check"};
AR_Rappel_From_Heli_Action_Check = {
params ["_player","_vehicle"];
if!([_vehicle] call AR_Is_Supported_Vehicle) exitWith {false};
if(((getPos _vehicle) select 2) < 5 ) exitWith {false};
if(((getPos _vehicle) select 2) > 150 ) exitWith {false};
if(driver _vehicle == _player && isEngineOn _vehicle) exitWith {false};
if(speed _vehicle > 100) exitWith {false};
if!("Exile_Item_Rope" in magazines _player) exitWith {false};
true;
};
};


https://github.com/sethduda/AdvancedRappelling/issues

If anyone wants to help fix any of these, please let me know. You can fork the repo and create a pull request.


Stay Alive Tactical Team (http://sa.clanservers.com)
Boosh and Beachhead
JezaGooner (for their video on the steam page)


Got Questions? Join my Discord channel:
https://discord.gg/RHkGYCt