setCaptive

1.00

LALocalGEGlobal

Hover & click on the images for description

Description

Description:

Mark a unit as captive. If unit is a vehicle, commander is marked. A captive is neutral to everyone (belong to civilian side), and will not trigger "detected by" conditions for its original side.

Using a number (instead of a boolean) for the status has no further effect on the engine's behavior, but can be used by captiveNum to keep track of the captivity status at a finer resolution (e.g. handcuffed, grouped, etc.). The numbered status syntax was introduced in Arma 2.

Groups:

Uncategorised

Syntax

Syntax:

unitName setCaptive status

Parameters:

unitName: Object

status: Boolean - true means captive

Return Value:

Nothing

Alternative Syntax

Syntax:

unitName setCaptive status

Parameters:

unitName: Object

status: Number - 0 or non zero. A non zero value means captive

Return Value:

Nothing

Examples

Example 1:

_soldier1 setCaptive true;

Example 2:

_soldier1 setCaptive 1;

Additional Information

See also:

captivecaptiveNum

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Notes

Posted on August 4, 2006 - 23:49

hoz

This function does not remove unit's weapons. If you make a unit captive, that unit will still fire on the enemy, but the enemy will not fire back.

Posted on January 1, 2011 - 13:11

Talkingtoaj

If you change a unit from captive to no longer captive (for example, to "reveal" an undercover unit), enemy units that already have prior knowledge of the unit as a captive will only partially engage, making it very easy for the undercover unit. This seems to be a bug. However other enemy unit the unit later encounters will engage freely with full force.

Bottom Section

Posted on November 19, 2017 - 10:58 (UTC)

Lou Montana

Talkingtoaj note doesn't apply to Arma 3 anymore (earlier than 1.76)
A captive unit will immediately be shot (after a normal "human" reaction time from the AI)