setCaptive: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (template:command argument fix)
(24 intermediate revisions by 16 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|SETCAPTIVE]]
{{Command|= Comments
[[Category:Scripting Commands OFP 1.96|SETCAPTIVE]]
____________________________________________________________________________________________
[[Category:Scripting Commands OFP 1.46|SETCAPTIVE]]
 
[[Category:Scripting Commands ArmA|SETCAPTIVE]]
| ofp |= Game name
 
|1.00|= Game version
 
|eff= global|= Effects in MP
|arg= local|= Arguments in MP
____________________________________________________________________________________________
 
| 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]].
 
<br><br>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. |DESCRIPTION=
 
____________________________________________________________________________________________
 
| unitName '''setCaptive''' status |SYNTAX=
 
|p1= unitName: [[Object]] |PARAMETER1=
|p2= status: [[Boolean]]  - [[true]] means [[captive]]|PARAMETER2=


| [[Nothing]] |RETURNVALUE=


<h2 style="color:#000066">'''''person'' setCaptive ''captive'''''</h2>
| s2= unitName '''setCaptive''' status |SYNTAX=


|p21= unitName: [[Object]] |PARAMETER1=
|p22= status:  [[Number]] - 0 or non zero. A non zero value means [[captive]]|PARAMETER2=


'''Operand types:'''
| r2= [[Nothing]] |RETURNVALUE=
____________________________________________________________________________________________
 
|x1= <code>_soldier1 [[setCaptive]] [[true]];</code> |EXAMPLE1=
|x2= <code>_soldier1 [[setCaptive]] 1;</code> |EXAMPLE2=
____________________________________________________________________________________________


'''person:''' [[Object]]
| [[captive]], [[captiveNum]] |SEEALSO=


'''captive:''' [[Boolean]]
}}


'''Type of returned value:'''
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on August 4, 2006 - 23:49
<dt class="note">'''[[User:Hoz|hoz]]'''<dd class="note"> This function does not remove unit's weapons.


[[Nothing]]
If you make a unit captive, that unit will still fire on the enemy, but the enemy will not fire back.
<dd class="notedate">Posted on January 1, 2011 - 13:11
<dt class="note">'''[[User:Talkingtoaj|Talkingtoaj]]'''<dd class="note">
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.


'''Description:'''
However other enemy unit the unit later encounters will engage freely with full force.


Mark unit as captive.<br>
If unit is a vehicle, commander is marked.<br>
A captive is neutral to everyone.<br>
'''Note:''' This function does not remove unit's weapons.<br>
'''Note:''' If you make a unit captive, that unit will still fire on the enemy, but the enemy will not fire back.


<!-- Note Section END -->
</dl>


'''Example:<br>'''
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|SETCAPTIVE]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|SETCAPTIVE]]
[[Category:Scripting Commands OFP 1.46|SETCAPTIVE]]
[[Category:Scripting Commands ArmA|SETCAPTIVE]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]


soldier1 '''setCaptive''' [[true]]
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on November 19, 2017 - 10:58 (UTC)</dd>
<dt class="note">[[User:Lou Montana|Lou Montana]]</dt>
<dd class="note">
'''Talkingtoaj''' note doesn't apply to Arma 3 anymore (earlier than 1.76)<br />
A captive unit will immediately be shot (after a normal "human" reaction time from the AI)
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 15:46, 7 April 2019

Logo A0.png1.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)
Retrieved from "https://community.bistudio.com/wiki?title=setCaptive&oldid=122479"