Heli Winch

Heli Winch is our most advanced resource, porting the Coastal Callout winching functionality to FiveM!

Installation

Heli Winch is installed like any other resource. See our Installing Resourcespage for help here. However, it does require configuration before you are able to use it.

Configuration

Heli Winch comes setup by default to work with the Coastal Callouts vehicles. Get the FiveM Package here

https://www.lcpdfr.com/files/file/25465-coastal-callouts/

Head over to the config.lua file to get started!

To get you up and running right away, we need to look at the Config.AllowedVehicles section

You will see a list of vehicles already configured to use Heli Winch.

Using Coastal Callouts Helicopters

If you are using a vehicle from the Coastal Callouts pack, then it will have the required bone to attach to. In this case, we can use one of the entries that has a BoneName field. Simply copy and paste one of them that looks similar to this:

{["SpawnCode"] = "SPAWNCODE", ["BoneName"] = "rope_attach_a", ["OpenDoorWhenWinchCreated"] = true, ["OpenDoorIndex"] = 3, ```lua
["WinchSideRight"] = true, ["HookExtra"] = -1
```},

Paste the entry below the previous one, making sure it is before the closing } bracket underneath all the Config.AllowedVehicles entries.

Edit the spawncode field to be the spawncode that you are looking for, and it should work fine.

If the helicopter has an extra that can be toggled to remove the hook from the top of the winch, then replace -1 with the number of the extra in the HookExtra entry. This will remove and add the hook when the winch is created and removed. If the helicopter does not have one of these extras, then leave it as -1.

Using Other Helicopters

Using non Coastal Callouts Helicopters are a little more complicated. You will need to find the coordinates that the winch will need to start from.

Here is an example field for the Config.AllowedVehicles section:

{["SpawnCode"] = "buzzard", ["Coordinates"] = vector3(0.0, 0.0, -1.0), ["OpenDoorWhenWinchCreated"] = true, ["OpenDoorIndex"] = 3, ```lua
["WinchSideRight"] = true, ["HookExtra"] = -1},

The above example does not have the correct coordinates for the buzzard.

Finding these coordinates is trial and error. You need to edit the field after ["Coordinates"]= where it says vector3(0.0, 0.0, 0.0)

A vector3 is a short way of storing an X, a Y, and a Z coordinate. So a vector3 looks like this:

vector3(x coordinate, y coordinate, z coordinate)

The values in a vector3 need to be float values (end with a decimal point, for example 0.0, 2.5, 1.7)

Here is what the coordinate directions are:

x = left/right  
y = forward/backward  
z = up/down

Using this information, you should be able to set up Heli Winch for a helicopter without a rope_attach bone.

If your helicopter has the winch on its left side, then set WinchSideRight to false, and this will orient the hook and anything attached to it correctly.