Description

Introducing Heli Winch by BKing Development; a script that brings you a working winch/hoist for helicopters in FiveM!

Unlike some other such scripts I have seen for FiveM, this one has fully synced rope physics, can be operated while in motion, and uses the realistic props, animations, and scripting logic from Coastal Callouts to enable various modes including direct hook deployment, a coast guard rescue basket, and a stokes litter with rigging for trauma injuries or mountain rescue.

Video Showcase

https://www.youtube.com/watch?v=h9ahDWhaH7M

Update Video:

https://www.youtube.com/watch?v=eEwJX8bI1SI

Trailer:

https://youtu.be/_EYbyic1GIs

Usage

There are multiple commands to this resource, and a few keybinds. All of these are easily configurable using the config.lua file.

There is also a menu that includes all the commands in one place.

These are the default commands and their usages:

- /winchmenu; opens the winch menu.

- /winch; creates a winch in front of you.

- /winchremove; removes the winch you are controlling.

- /winchattach; attaches you to the nearest winch.

- /winchattach true; attaches you to the nearest winch.

- /winchdetach; detaches you from the winch you are attached to.

- /winchdetach true; detaches you from the winch you are attached to, and sits you inside the helicopter, providing you are close enough.

- /winchcontrol [serverid]; transfers control to the player with the specified server id.

- /winchcarry; carries the closest player.

- /winchlitter; spawns litter onto winch.

- /winchbasket; spawns rescue basket onto winch.

- /winchlitterpickup; puts nearest person into litter

- Up arrow; retracts winch.

- Down arrow; extends winch.

The easiest way for you to use this resource is with the helicopters in the Coastal Callouts FiveM Package: https://www.lcpdfr.com/downloads/gta5mods/scripts/25465-coastal-callouts/

They all have the required bone so you don't have the fiddle with coordinates (will be explained in the installation section).

Please note that there are issues syncing to players that join the server after the winch has been created. This is being worked on.

Permissions

This resource includes ACE permission support. This is done by the commands, for example:

add_ace identifier.license:abc12345678910 "command.winch" allow

There is an ACE permission for each command, you can enable these if you wish through the config.lua

Optimisation

0.04ms on resmon with no winches spawned. 0.1ms on resmon for 1 winch spawned.

Installation

Drag and drop the resource into your resources folder, and add HeliWinch to your server.cfg.

IMPORTANT:

You need to configure the winch for each helicopter you wish to use it on. Helicopters from Coastal Callouts all have a bone called "rope_attach_a", which is essentially something in the model that is in the right location for a winch.

If you try this and the winch fails to work, it will provide you with an error message saying that the bone cannot be found. You will need to use coordinates instead. I have included examples of both in the config file so you can see how it should look.

You can also configure all the commands, whether they use ace permissions, the keybinds for the winch, and change the language of all the messages.

Frameworks

This resource is standalone.

Support

Support is provided through our discord, which you can find on our website, or through the FiveM forums.

Feedback

Feedback is always appreciated, as are bug reports, through the FiveM forums or through our Discord.

Credits

With thanks to PNWParksFan for: 

Original Coastal Callouts heli hoist implementation and assistance porting to FiveM 

UI Images 

Converting and configuring props (litter rigging and hoist hook modelled by Lumoize, litter model by SkylineGTRFreak) Coastal Callouts helicopters (models by SkylineGTRFreak) - supported in default config & used for testing and videos; helis not included in download, get the FiveM resource here!