---
name: "ropeUnwind"
type: command
status: ok
groups: ["Ropes and Sling Loading"]
arma3_since: "1.34"
locality: {"argument": "local", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/ropeUnwind
revid: 363666
updated: 2024-04-14T18:49:41Z
---

# ropeUnwind

*Command · Ropes and Sling Loading · Arma 3 v1.34*

Locality: arguments **local** · effect **global**

## Description

Increases or decreases the rope length by the given amount. Use relative parameter for changing rope length +/- from current length.

> [!NOTE]
> Rope length can be in range 0.5..100 metres.

## Syntax

```sqf
ropeUnwind [rope, speed, length, relative]
```

**Parameters:**

- `rope`: [Object](../topics/Object.md) - rope object
- `speed`: [Number](../topics/Number.md) - animation speed in m/s with which to lengthen or shorten the rope, in range 0.01..20
- `length`: [Number](../topics/Number.md) - the amount of length change in meters, in range: 0.1..100
- `relative`: [Boolean](../topics/Boolean.md) - (Optional) [true](../commands/true.md) will add or subtract given length from current rope length, [false](../commands/false.md) will resize the rope to the given length

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
ropeUnwind [ropes heli1 select 0, 3, 10]; // set rope length to 10m at 3m/s
```

### Example 2

```sqf
ropeUnwind [ropes heli1 select 0, 3, -5, true]; // decrease rope length by 5m at 3m/s
```

## See also

[ropes](../commands/ropes.md) · [canSlingLoad](../commands/canSlingLoad.md) · [enableRopeAttach](../commands/enableRopeAttach.md) · [getSlingLoad](../commands/getSlingLoad.md) · [ropeAttachedObjects](../commands/ropeAttachedObjects.md) · [ropeAttachTo](../commands/ropeAttachTo.md) · [ropeDestroy](../commands/ropeDestroy.md) · [ropeLength](../commands/ropeLength.md) · [ropeUnwound](../commands/ropeUnwound.md) · [ropeAttachedTo](../commands/ropeAttachedTo.md) · [ropeCreate](../commands/ropeCreate.md) · [ropeDetach](../commands/ropeDetach.md) · [ropeAttachEnabled](../commands/ropeAttachEnabled.md) · [ropeCut](../commands/ropeCut.md) · [ropeEndPosition](../commands/ropeEndPosition.md) · [setSlingLoad](../commands/setSlingLoad.md) · [slingLoadAssistantShown](../commands/slingLoadAssistantShown.md)

## Community notes

**Tajin** — 2014-11-08

Unwinding speed is not linear but instead automatically accelerates at the beginning and slows down at the end.

The speed also only seems to have no effect when pulling the rope in. (unless the end of the rope is not attached to anything)

High unwinding speeds (over ~250) can cause your cargo to get stuck in midair.

<sub>Source: [BI Community Wiki — ropeUnwind](https://community.bistudio.com/wiki/ropeUnwind) (revision 363666).</sub>