---
name: "setMass"
type: command
status: ok
groups: ["PhysX"]
arma3_since: "1.02"
locality: {"argument": "local", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/setMass
revid: 379467
updated: 2026-10-31T00:10:24Z
---

# setMass

*Command · PhysX · Arma 3 v1.02*

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

## Description

Changes the mass of a PhysX object. When using the alternative syntax the mass change is gradual during the given time. A time of zero means immediate change.

> [!IMPORTANT]
> When main syntax is used on [local](../topics/Multiplayer_Scripting.md#locality) vehicle, the change is global. When alternative syntax is used with time transition on [local](../topics/Multiplayer_Scripting.md#locality) vehicle, the gradual mass change doesn't happen on remote clients, only final mass is applied after the given time. If you need gradual change on remote clients too, [remote execute](../commands/remoteExec.md) [setMass](../commands/setMass.md) globally.

## Syntax

### Syntax 1

```sqf
myObject setMass mass
```

**Parameters:**

- `myObject`: [Object](../topics/Object.md)
- `mass`: [Number](../topics/Number.md)

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

### Syntax 2

```sqf
myObject setMass [mass, time]
```

**Parameters:**

- `myObject`: [Object](../topics/Object.md)
- `mass`: [Number](../topics/Number.md)
- `time`: [Number](../topics/Number.md)

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

## Examples

### Example 1

```sqf
myObject setMass [10, 0.5];
```

### Example 2

```sqf
myObject setMass 10;
```

## See also

[getMass](../commands/getMass.md) · [setCenterOfMass](../commands/setCenterOfMass.md) · [getCenterOfMass](../commands/getCenterOfMass.md)

## Community notes

**ffur2007slx2_5** — 2014-06-20

Arma 3 v1.22 A quick reference:

| category | [setMass](../commands/setMass.md) | [setCenterOfMass](../commands/setCenterOfMass.md) |
|---|---|---|
| unit | The larger the mass is, the easier a unit will physically fatigued | N/A |
| aircraft | The larger the mass is, the more sensitive an aircraft will react to joystick, vice versa (Except when AFM is enabled). | Aircraft slant due to center change accordingly, and the position of the camera view will be altered relatively at the same time. (3rd person view) |
| vehicle | The larger the mass is, the slower a vehicle drives (Ships will sink), vice versa. (Land vehicle performs like a bouncing ball while ships accelerated pretty speedy.) | Vehicle slant due to center change accordingly. |

---

**N3croo** — 2015-03-26

If you intend to use setMass in conjunction with ropeCreate in MP i highly recommend to first ropeCreate then setMass (on clientside).
RopeCreate in MP will set the mass of the attached object to the server value upon execution.

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