Arma3_Exile/AdvancedSlingLoading
1
0
Fork 0
mirror of https://github.com/sethduda/AdvancedSlingLoading.git synced 2024-08-30 17:32:12 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
sethduda 2016-04-12 23:29:41 -04:00
parent 60b440d34b
commit eaa4481f1e
1 changed files with 87 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

106
README.md
View File

@ -1,42 +1,110 @@
# Advanced Sling Loading
![alt tag](http://s28.postimg.org/xrh1wzd6l/Capture.png)
SP & MP Compatible. Full replacement for in-game sling loading.
SP & MP Compatible. Full replacement for in-game sling loading. Supports Exile.
**Features:**
Ropes can no longer attach automatically! You need to either get out of your helicopter or have someone on the ground pick up your cargo ropes and attach them to an object.
- Ropes can no longer attach automatically! You need to either get out of your helicopter or have someone on the ground pick up your cargo ropes and attach them to an object.
- Once cargo ropes are deployed, any player can go to the end of the rope and pick it up.
- Once the ropes are picked up by a player, they can be attached to pretty much every object in the game.
- Players can drop ropes if they're carrying them
- Players on the ground can detached ropes from an object
- Huron, Mohawk & Taru can lift heavy vehicles
All players on board a helicopter are given a "ropes" action. This lets any player deploy, extend, shorten or release cargo ropes.
**Installation:**
Once cargo ropes are deployed, any player can go to the end of the rope and pick it up.
1. Subscrive via steam: http://steamcommunity.com/sharedfiles/filedetails/?id=615007497 or dowload latest release from https://github.com/sethduda/AdvancedSlingLoading/releases
2. If installing this on a server, add the addon to the -serverMod command line option
Once the ropes are picked up by a player, they can be attached to pretty much every object in the game.
**Default Sling Loading Rules:**
Players can drop ropes if they're carrying them
- Helicopters can sling load all objects
- You can't sling load locked vehicles (see settings below)
- You can't sling load in an exile safe zone (see settings below)
Players on the ground can detached ropes from an object
**Notes for Mission Makers:**
**Usage:**
You can customize which classes of objects can "deploy" cargo ropes by overriding the ASL_SUPPORTED_VEHICLES_OVERRIDE variable in an init.sqf file.
Addon:
```ASL_SUPPORTED_VEHICLES_OVERRIDE = [ "Air" ]; ```
Install via steam (http://steamcommunity.com/sharedfiles/filedetails/?id=615007497). Will apply ropes action to all missions.
If using on a MP server, only the server needs to have it installed.
This will only allow objects of class Air deploy cargo ropes.
Script:
You can customize what can and can't be sling loaded by defining the ASL_SLING_RULES_OVERRIDE variable in the init.sqf file.
Put https://github.com/sethduda/AdvancedSlingLoading/blob/master/addons/SA_AdvancedSlingLoading/functions/fn_advancedSlingLoadingInit.sqf in your mission directory.
```ASL_SLING_RULES_OVERRIDE =
[ ["Air", "CAN_SLING", "Ship"],
["Air", "CANT_SLING", "Air"]
]; ```
Add **[] execVM "fn_advancedSlingLoadingInit.sqf";** to your init.sqf file.
In this example, all objects of class Air can sling load Ships but not Air.
That's all!
You can allow sling loading of locked vehicles by defining ASL_LOCKED_VEHICLES_ENABLED in your init.sqf file. It defaults to false.
<strong>Video:</strong>
```ASL_LOCKED_VEHICLES_ENABLED = true; ```
[![View Video](http://img.youtube.com/vi/x1zL-ningQU/0.jpg)](http://www.youtube.com/watch?v=x1zL-ningQU)
You can allow sling loading in an Exile safe zone by defining ASL_EXILE_SAFEZONE_ENABLED in your init.sqf file. It default to false.
```ASL_EXILE_SAFEZONE_ENABLED = true; ```
**Not working on your server?**
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.
**FAQ**
*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 towing 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):
!="ASL_Ropes" !="ASL_Ropes_Vehicle" !="ASL_Ropes_Pick_Up_Helper"
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 tow actions appear when looking at a vehicle, 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 ASL_Extend_Ropes { allowedTargets=0; };
class ASL_Shorten_Ropes { allowedTargets=0; };
class ASL_Release_Cargo { allowedTargets=0; };
class ASL_Retract_Ropes { allowedTargets=0; };
class ASL_Deploy_Ropes { allowedTargets=0; };
class ASL_Put_Away_Ropes { allowedTargets=0; };
class ASL_Attach_Ropes { allowedTargets=0; };
class ASL_Drop_Ropes { allowedTargets=0; };
class ASL_Hint { allowedTargets=1; };
class ASL_Hide_Object_Global { allowedTargets=2; };
};
};
```
**Issues & Feature Requests**
https://github.com/sethduda/AdvancedSlingLoading/issues
If anyone wants to help fix any of these, please let me know. You can fork the repo and create a pull request.
**Special Thanks for Testing & Support:**
- Stay Alive Tactical Team (http://sa.clanservers.com)
---