---
name: "setGusts"
type: command
status: ok
groups: ["Environment"]
arma3_since: "0.50"
locality: {"argument": null, "effect": "local", "server_exec": false}
source: https://community.bistudio.com/wiki/setGusts
revid: 376959
updated: 2026-01-01T05:50:49Z
---

# setGusts

*Command · Environment · Arma 3 v0.50*

Locality: effect **local**

## Description

Changes the gusts value smoothly during the given time (in seconds). A time of zero means there will be an immediate change.

## Syntax

```sqf
time setGusts value
```

**Parameters:**

- `time`: [Number](../topics/Number.md)
- `value`: [Number](../topics/Number.md) in range 0..1

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

## Examples

### Example 1

```sqf
60 setGusts 0.75;
```

## See also

[gusts](../commands/gusts.md) · [wind](../commands/wind.md) · [setWind](../commands/setWind.md)

## Community notes

**Sa-Matra** — 2022-07-06

Unlike most of weather commands, this one does not set gusts instantly but on next frame (in 2 frames in practice), so running it multiple times will overwrite each other. [setRainbow](../commands/setRainbow.md) has same behavior. In order to set gusts to some value and then have it change to another over time, you need to first do `0 setGusts 0` and then `100 setGusts 1` after 2 frames. Example:

```sqf
// Initial gusts you want
0 setGusts 0;

// A thread to wait for 2 frames
(diag_frameNo + 2) spawn {
    waitUntil {
        // Code in braces is not executed until wanted frame is reached because of lazy evaluation
        diag_frameNo >= _this && {
            100 setGusts 1;
            true; // positive condition result to end waitUntil and spawned thread
        };
    };
};
```

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