---
name: "addRating"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "0.50"
locality: {"argument": "local", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/addRating
revid: 353042
updated: 2024-03-12T12:07:04Z
---

# addRating

*Command · Object Manipulation · Arma 3 v0.50 · introduced in Operation Flashpoint v1.00*

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

## Description

Add a number to the [rating](../commands/rating.md) of a unit - negative values can be used to reduce the rating.

This command is usually used to reward for completed mission objectives.The rating is given at the end of the mission and is automatically adjusted when killing enemies or friendlies.

When the rating gets below -2000, the unit's side switches to [sideEnemy](../commands/sideEnemy.md) and the unit is attacked by everyone.

> [!NOTE]
> See also ArmA: Armed Assault: Rating Values and [Arma 3: Event Handlers#HandleRating](../topics/Event_Handlers.md#handlerating).

## Syntax

```sqf
unitName addRating rating
```

**Parameters:**

- `unitName`: [Object](../topics/Object.md)
- `rating`: [Number](../topics/Number.md)

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

## Examples

### Example 1

```sqf
player addRating 2000;
```

### Example 2

Set the rating to a specific value:

```sqf
private _wantedRating = 9001;
player addRating (_wantedRating - rating player);
```

## See also

Side Relations · ArmA: Rating Values · [rating](../commands/rating.md) · [rank](../commands/rank.md) · [setUnitRank](../commands/setUnitRank.md) · [sideEnemy](../commands/sideEnemy.md)

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