---
name: "reveal"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": "local", "server_exec": false}
source: https://community.bistudio.com/wiki/reveal
revid: 369307
updated: 2024-09-03T18:42:54Z
---

# reveal

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

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

## Description

Reveals a target to a [group](../commands/group.md). If *toWhom* is a unit, unit's group is considered. If *toWhom* is a vehicle, vehicle commander's group is considered.  The [knowledge value](../commands/knowsAbout.md) will be set to the highest level any unit of the revealing side has about the revealed target. If the revealing side has *no* knowledge about the revealed target, the value will be set to 1.

> [!NOTE]
> The knowledge level can only be increased by this command, not decreased. Use [forgetTarget](../commands/forgetTarget.md) first if you need to decrease value.

## Syntax

### Syntax 1

```sqf
toWhom reveal target
```

**Parameters:**

- `toWhom`: [Object](../topics/Object.md) or [Group](../topics/Group.md) - which receives revealing information
- `target`: [Object](../topics/Object.md) - which is revealed

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

### Syntax 2

*since arma2oa 1.60*

```sqf
toWhom reveal [target, accuracy]
```

**Parameters:**

- `toWhom`: [Object](../topics/Object.md) or [Group](../topics/Group.md) - which receives revealing information
- `target`: [Object](../topics/Object.md) - which is revealed
- `accuracy`: [Number](../topics/Number.md) - knowledge value, clamped to 0..4 range

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

## Examples

### Example 1

```sqf
_soldierOne reveal _soldierTwo; // soldierOne knowsAbout information about soldierTwo is updated
```

### Example 2

```sqf
player reveal cursorObject; // player knowsAbout information about object under cursor is updated
```

### Example 3

```sqf
_soldierOne reveal [_soldierTwo, 1.5];
```

## Multiplayer

[targetKnowledge](../commands/targetKnowledge.md) and [knowsAbout](../commands/knowsAbout.md) information only get updated on the PC where this command was executed.

## See also

[nearTargets](../commands/nearTargets.md) · [knowsAbout](../commands/knowsAbout.md) · [forgetTarget](../commands/forgetTarget.md) · [ignoreTarget](../commands/ignoreTarget.md)

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