alive: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
No edit summary
 
(72 intermediate revisions by 18 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands]]
{{RV|type=command
[[Category:Scripting Commands OFP 1.97]]
[[Category:Scripting Commands OFP 1.46]]
[[Category:Scripting Commands ArmA]]


back to [[Scripting_Reference#A|COMREF]]
|game1= ofp
|version1= 1.00


|game2= ofpe
|version2= 1.00


<h2 style="color:#000066">'''alive ''obj'''''</h2>
|game3= arma1
|version3= 1.00


|game4= arma2
|version4= 1.00


'''Operand types:'''
|game5= arma2oa
|version5= 1.50


'''obj:''' [[Object]]
|game6= tkoh
|version6= 1.00


'''Type of returned value:'''
|game7= arma3
|version7= 0.50


[[Boolean]]
|arg= global


'''Description:'''
|gr1= Object Manipulation


Check if given person, vehicle or building is not dead / destroyed.
|descr= Check if given vehicle/person/building is alive (i.e. not dead or destroyed).


|s1= [[alive]] object


'''Example:'''
|p1= object: [[Object]]


? ('''alive''' player) : _b = 1
|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]]
}}
 
{{Note
|user= Pierre MGI
|timestamp= 20151019234800
|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.
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.
}}

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.