alive: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Arma[ _]3(\|.*)]]" to "{{GameCategory|arma3|Scripting Commands}}")
No edit summary
 
(30 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| ofp |Game name=
|game1= ofp
|version1= 1.00


|1.00|Game version=
|game2= ofpe
|version2= 1.00


|arg= global |Multiplayer Arguments=
|game3= arma1
|version3= 1.00


|gr1= Object Manipulation |GROUP1=
|game4= arma2
____________________________________________________________________________________________
|version4= 1.00


| Check if given vehicle/person/building is alive (i.e. not dead or destroyed).
|game5= arma2oa
{{Informative | {{Inline code|[[alive]] [[objNull]] {{cc|returns [[false]]}}}}}}|DESCRIPTION=
|version5= 1.50
____________________________________________________________________________________________


| [[alive]] object |SYNTAX=
|game6= tkoh
|version6= 1.00


|p1= object: [[Object]] to test |PARAMETER1=
|game7= arma3
|version7= 0.50


| [[Boolean]] - [[true]] if alive, [[false]] if dead/completely destroyed |RETURNVALUE=
|arg= global
____________________________________________________________________________________________
 
|x1= SQS: <code>?!([[alive]] [[player]]) : [[exit]]</code> |EXAMPLE1=


|x2= SQF: <code>[[if]] (![[alive]] [[player]]) [[exitWith]] {};</code> |EXAMPLE2=
|gr1= Object Manipulation
____________________________________________________________________________________________


| [[setDamage]], [[damage]] |SEEALSO=
|descr= Check if given vehicle/person/building is alive (i.e. not dead or destroyed).
 
|s1= [[alive]] object
 
|p1= object: [[Object]]
 
|r1= [[Boolean]] - [[true]] if alive, [[false]] if dead/destroyed
 
|x1= SQS:
<sqs>? not alive player : exit</sqs>
 
|x2= SQF:
<sqf>if (!alive player) exitWith {};</sqf>
 
|x3= <sqf>alive objNull; // returns false</sqf>
 
|seealso= [[setDamage]] [[damage]] [[waterDamaged]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Pierre MGI
<dd class="notedate">Posted on October 19, 2015 - 23:48 (UTC)</dd>
|timestamp= 20151019234800
<dt class="note">[[User:Pierre MGI|Pierre MGI]]</dt>
|text= Alive or not could be the question! in multi-player, missions come with respawn module(s). When a player is dead shot, <sqf inline>alive player</sqf> will return false, then almost immediately true if the "revive" respawn template is enabled, then could turn to false again if time for assistance is elapsed or if the player activates the respawn menu before; and finally true after player respawns.
<dd class="note">
Just be aware that in that case (respawn + revive enabled), the status of the player is toggling: true &rarr; false &rarr; true &rarr; false &rarr; true. Then, alive status while player is waiting for being rescued could lead to some script errors as player is supposed to be alive but is in limbo and the dead entity "player" gets passed to server.
Alive or not could be the question! in multi-player, missions come with respawn module(s). When a player is dead shot, (alive player) will return false, then almost immediately true if the "revive" respawn template is enabled, then could turn on false if time for assistance is elapsed or if the player activates the respawn menu before; and finally true after player respawns. Just be aware that in that case (respawn + revive enabled), the status of the player is toggling: true false true false true. Then, alive status while player is waiting for being rescued could lead to some error scripts as player is supposed to be alive but in limbo and the dead entity "player" passed to server.
}}
</dd>
</dl>
 
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[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}}
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 16:50, 12 February 2023

Hover & click on the images for description

Description

Description:
Check if given vehicle/person/building is alive (i.e. not dead or destroyed).
Groups:
Object Manipulation

Syntax

Syntax:
alive object
Parameters:
object: Object
Return Value:
Boolean - true if alive, false if dead/destroyed

Examples

Example 1:
SQS:
? not alive player : exit
Example 2:
SQF:
if (!alive player) exitWith {};
Example 3:
alive objNull; // returns false

Additional Information

See also:
setDamage damage waterDamaged

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
Pierre MGI - c
Posted on Oct 19, 2015 - 23:48 (UTC)
Alive or not could be the question! in multi-player, missions come with respawn module(s). When a player is dead shot, alive player will return false, then almost immediately true if the "revive" respawn template is enabled, then could turn to false again if time for assistance is elapsed or if the player activates the respawn menu before; and finally true after player respawns. Just be aware that in that case (respawn + revive enabled), the status of the player is toggling: true → false → true → false → true. Then, alive status while player is waiting for being rescued could lead to some script errors as player is supposed to be alive but is in limbo and the dead entity "player" gets passed to server.