---
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: 373893
updated: 2025-06-26T11:00:29Z
---

# 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)

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