Arma 3 Scripting

reveal

  • Global argument
  • Local effect
  • Arma 3 v0.50
  • First in Operation Flashpoint v1.00

Command · Markdown · JSON · original wiki page

Description

Reveals a target to a group. If toWhom is a unit, unit's group is considered. If toWhom is a vehicle, vehicle commander's group is considered. The knowledge value 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 first if you need to decrease value.

Syntax

Syntax 1

toWhom reveal target

Parameters:

Returns: Nothing

Syntax 2

since arma2oa 1.60

toWhom reveal [target, accuracy]

Parameters:

Returns: Nothing

Examples

Example 1

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

Example 2

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

Example 3

_soldierOne reveal [_soldierTwo, 1.5];

Multiplayer

targetKnowledge and knowsAbout information only get updated on the PC where this command was executed.

See also

nearTargets · knowsAbout · forgetTarget · ignoreTarget

Community notes

Ceeeb

In OFP v1.96, When a target is revealed to a unit, its knowsAbout rating is set to 1, unless it was already more than 1 in which case reveal does nothing. See knowsAbout for more details about knowsAbout ratings and limitations.

Doolittle

Use reveal to allow client to see a created vehicle faster - the associated menu interaction will become available therefore, like the player has option to get in sooner.

_tank = "M1A1" createVehicle (position player);
player reveal _tank;
// get in user actions become available instantly

.kju

The same idea from Doolittle's note applies to beaming of units. If you setPos an unit or a player, reveal (all) nearby objects and vehicles to make the interaction possible a lot quicker.

.kju

Revealing a targetUnit will also add it to nearTargets database of the given sourceUnit. The quality/detail level of the info depends on the knowsAbout value used with reveal. More detail in the nearTargets page.