---
name: "load"
type: command
status: ok
groups: ["Unit Inventory"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/load
revid: 347534
updated: 2023-09-28T08:15:16Z
---

# load

*Command · Unit Inventory · Arma 3 v0.50*

## Description

Returns the percentage of fullness of a unit's cargo. Output is usually in range 0..1, but can be higher after using certain scripting commands (like [addWeaponWithAttachmentsCargoGlobal](../commands/addWeaponWithAttachmentsCargoGlobal.md)) which ignore load values when adding items.

> [!NOTE]
> See [#Example 2](../commands/load.md#example-2) for load calculation.

## Syntax

```sqf
load unit
```

**Parameters:**

- `unit`: [Object](../topics/Object.md) - (before Arma 3 v2.08 the command did not support containers, ammo boxes, weapon holders, vehicle cargos)

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

## Examples

### Example 1

```sqf
load player;
```

### Example 2

unit load calculation formula:

```sqf
private _unitLoad = loadAbs _unit / getNumber (configFile >> "CfgInventoryGlobalVariable" >> "maxSoldierLoad");
```

## See also

[maxLoad](../commands/maxLoad.md) · [loadAbs](../commands/loadAbs.md) · [loadBackpack](../commands/loadBackpack.md) · [loadUniform](../commands/loadUniform.md) · [loadVest](../commands/loadVest.md) · [getMass](../commands/getMass.md) · [weightRTD](../commands/weightRTD.md) · [getContainerMaxLoad](../commands/getContainerMaxLoad.md)

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