setCaptive: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame( +[0-9])?|Game [Vv]ersion( +[0-9])?|Game Version \(number surrounded by NO SPACES\)|Arguments in MP|MP[Aa]rg|Multiplayer Arguments( \("local" or "global"\))?|Effects|Execution|Effects...)
(Add score/rating note)
 
(34 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command
{{RV|type=command


| ofp
|game1= ofp
|version1= 1.00


|1.00
|game2= ofpe
|version2= 1.00
 
|game3= arma1
|version3= 1.00
 
|game4= arma2
|version4= 1.00
 
|game5= arma2oa
|version5= 1.50
 
|game6= tkoh
|version6= 1.00
 
|game7= arma3
|version7= 0.50


|eff= global
|eff= global
Line 13: Line 30:
|gr2= Sides
|gr2= Sides


| Mark a unit as captive. If unit is a vehicle, commander is marked. A captive unit:
|descr= Mark a unit as captive. If unit is a vehicle, commander is marked. A captive unit:
* is seen as belonging to the [[civilian]] [[side]] (will not be fired upon)
* is seen as belonging to the [[civilian]] [[Side]]
* will not be fired upon
* will still shoot at its real side's enemies
* will still shoot at its real side's enemies
* will make its killer earn/lose [[score]]/[[rating]] as usual
* will not get its weapons removed (see [[removeAllWeapons]])
* will not get its weapons removed (see [[removeAllWeapons]])
* will not trigger "detected by" conditions for its original [[side]].
* will not trigger "detected by" conditions for its original [[Side]].
{{Informative | The number used as status can be retrieved by [[captiveNum]] to keep track of the captivity status at a finer resolution (e.g. handcuffed, grouped, etc).}}
{{Feature|informative|The number used as status can be retrieved by [[captiveNum]] to keep track of the captivity status at a finer resolution (e.g. handcuffed, grouped, etc).}}


| unitName [[setCaptive]] status
|s1= unitName [[setCaptive]] status


|p1= unitName: [[Object]]
|p1= unitName: [[Object]]
Line 26: Line 45:
|p2= status: [[Boolean]] - [[true]] means [[captive]]
|p2= status: [[Boolean]] - [[true]] means [[captive]]


| [[Nothing]]
|r1= [[Nothing]]


|s2= unitName [[setCaptive]] statusNumber {{Since|arma2|1.00|y}}
|s2= unitName [[setCaptive]] statusNumber


|p21= unitName: [[Object]] |PARAMETER21=
|s2since= arma2 1.00


|p22= statusNumber:  [[Number]] - zero means non-captive, a non-zero value means [[captive]] |PARAMETER22=
|p21= unitName: [[Object]]
 
|p22= statusNumber:  [[Number]] - zero means non-captive, a non-zero value means [[captive]]; see [[captiveNum]]


|r2= [[Nothing]]
|r2= [[Nothing]]
 
|x1= <code>_soldier1 [[setCaptive]] [[true]];
[[side]] _soldier1; {{cc|returns [[civilian]]}}
[[side]] [[group]] _soldier1; {{cc|returns e.g [[blufor]]}}</code>


|x2= <code>_soldier1 [[setCaptive]] 1;
|x1= <sqf>
[[captive]] _soldier1; {{cc|returns [[true]]}}
_soldier1 setCaptive true;
side _soldier1; // returns civilian
side group _soldier1; // returns e.g blufor
</sqf>
 
|x2= <sqf>
_soldier1 setCaptive 1;
captive _soldier1; // returns true


_soldier1 [[setCaptive]] 42;
_soldier1 setCaptive 42;
[[captive]] _soldier1; {{cc|returns [[true]]}}
captive _soldier1; // returns true


_soldier1 [[setCaptive]] 0;
_soldier1 setCaptive 0;
[[captive]] _soldier1; {{cc|returns [[false]]}}</code>
captive _soldier1; // returns false
</sqf>


| [[captive]], [[captiveNum]]
|seealso= [[captive]] [[captiveNum]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Talkingtoaj
<!-- Note Section BEGIN -->
|timestamp= 20110101131100
 
|text= 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.
<dd class="notedate">Posted on August 4, 2006 - 23:49</dd>
<dt class="note">[[User:Hoz|hoz]]</dt>
<dd class="note"> This function does not remove unit's weapons.<br>
If you make a unit captive, that unit will still fire on the enemy, but the enemy will not fire back.
</dd>
 
<dd class="notedate">Posted on January 1, 2011 - 13:11</dd>
<dt class="note">[[User:Talkingtoaj|Talkingtoaj]]</dt>
<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.


However other enemy unit the unit later encounters will engage freely with full force.
However other enemy unit the unit later encounters will engage freely with full force.
</dd>
}}


<dd class="notedate">Posted on November 19, 2017 - 10:58 (UTC)</dd>
{{Note
<dt class="note">[[User:Lou Montana|Lou Montana]]</dt>
|user= Lou Montana
<dd class="note">
|timestamp= 20171119105800
'''[[User:Talkingtoaj|Talkingtoaj]]'''<nowiki/>'s note does not apply to {{arma3}} anymore (earlier than 1.76)<br>
|text= '''[[User:Talkingtoaj|Talkingtoaj]]'''<nowiki/>'s note does not apply to {{arma3}} anymore (earlier than 1.76)<br>
A captive unit will immediately be shot (after a normal "human" reaction time from the AI)
A captive unit will immediately be shot (after a normal "human" reaction time from the AI)
</dd>
}}


<dd class="notedate">Posted on August 21, 2019 - 18:02 (UTC)</dd>
{{Note
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
|user= DreadedEntity
<dd class="note">
|timestamp= 20220426011528
Units that are setcaptive belong to their original side for the purposes of score and rating.
|text= In '''A3 2.08.149102''', entering an empty vehicle with the same [[side]] as the player as defined in <sqf inline>configFile >> "CfgVehicles" >> _vehicleClassname >> "side"</sqf> will briefly switch the side of the vehicle to the side of the player soldier (specifically, while the get in animation is playing), even if captive. Once exiting the vehicle, it will retain that side until the player enters a new vehicle or, seemingly arbitrarily, moves more than 100 meters away from the vehicle <sqf inline>player distance _vehicle > 100</sqf>. If the player gets within 100 meters of the vehicle without entering a new vehicle, it will again switch to the players side. This is probably a bug, in my opinion
So if an OPFOR unit is setcaptive and is killed by BLUFOR players, their score will be calculated as if they killed an OPFOR, not a civilian.
}}
</dd>
 
<!-- Note Section END -->
</dl>
 
[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Latest revision as of 11:44, 24 March 2023

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
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 unit:
  • is seen as belonging to the civilian Side
  • will not be fired upon
  • will still shoot at its real side's enemies
  • will make its killer earn/lose score/rating as usual
  • will not get its weapons removed (see removeAllWeapons)
  • will not trigger "detected by" conditions for its original Side.
ⓘ
The number used as status can be retrieved by captiveNum to keep track of the captivity status at a finer resolution (e.g. handcuffed, grouped, etc).
Groups:
Object ManipulationSides

Syntax

Syntax:
unitName setCaptive status
Parameters:
unitName: Object
status: Boolean - true means captive
Return Value:
Nothing

Alternative Syntax

Syntax:
unitName setCaptive statusNumber
Parameters:
unitName: Object
statusNumber: Number - zero means non-captive, a non-zero value means captive; see captiveNum
Return Value:
Nothing

Examples

Example 1:
_soldier1 setCaptive true; side _soldier1; // returns civilian side group _soldier1; // returns e.g blufor
Example 2:
_soldier1 setCaptive 1; captive _soldier1; // returns true _soldier1 setCaptive 42; captive _soldier1; // returns true _soldier1 setCaptive 0; captive _soldier1; // returns false

Additional Information

See also:
captive captiveNum

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
Talkingtoaj - c
Posted on Jan 01, 2011 - 13:11 (UTC)
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.
Lou Montana - c
Posted on Nov 19, 2017 - 10:58 (UTC)
Talkingtoaj's note does not 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)
DreadedEntity - c
Posted on Apr 26, 2022 - 01:15 (UTC)
In A3 2.08.149102, entering an empty vehicle with the same side as the player as defined in configFile >> "CfgVehicles" >> _vehicleClassname >> "side" will briefly switch the side of the vehicle to the side of the player soldier (specifically, while the get in animation is playing), even if captive. Once exiting the vehicle, it will retain that side until the player enters a new vehicle or, seemingly arbitrarily, moves more than 100 meters away from the vehicle player distance _vehicle > 100. If the player gets within 100 meters of the vehicle without entering a new vehicle, it will again switch to the players side. This is probably a bug, in my opinion
Retrieved from "https://community.bistudio.com/wiki?title=setCaptive&oldid=338620"