createGuardedPoint: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " \| *(game[0-9]|version[0-9]|gr[0-9]|serverExec|mp|pr|descr|s[0-9]|p[0-9]{1,3}|r[0-9]|x1?[0-9]|seealso) *= +" to " |$1= ")
m (Text replacement - "(\|[pr][0-9]+ *= *[^-\r\n]+) *- *T([a-z])" to "$1 - t$2")
 
(14 intermediate revisions by the same user not shown)
Line 21: Line 21:
|gr1= Waypoints
|gr1= Waypoints


|descr= Adds a point guarded by the given side (scripted way of adding equivalent of "GUARDED BY" trigger in [[3DEN|Editor]]). A closest AI group in the given side with assigned "GUARD" waypoint will attempt to secure this guard point. The actual guarded position is determined via the following rules:
|descr= Adds a point guarded by the given side (scripted way of adding equivalent of "GUARDED BY" trigger in [[:Category:Eden Editor|Editor]]). A closest AI group in the given side with assigned "GUARD" waypoint will attempt to secure this guard point. The actual guarded position is determined via the following rules:
* Given "position" is always considered. It could be [[Object]], [[Group]], [[Position2D]] or [[Position3D]]. In every case, z coordinate will be ignored and point will be placed on nearest surface.
* Given "position" is always considered. It could be [[Object]], [[Group]], [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]]. In every case, z coordinate will be ignored and point will be placed on nearest surface.
* If "objectMapID" is not negative, the position of the object with the given ID is used (Overrides "position"). -1 to ignore this argument. z of the object position will be intact.
* If "objectMapID" is not negative, the position of the object with the given ID is used (Overrides "position"). -1 to ignore this argument. z of the object position will be intact.
* If the given "vehicle" is valid, the position of the vehicle is extracted and guarded (Overrides both "position" and "objectMapID"). [[objNull]] to ignore. z of the vehicle position will be intact.
* If the given "vehicle" is valid, the position of the vehicle is extracted and guarded (Overrides both "position" and "objectMapID"). [[objNull]] to ignore. z of the vehicle position will be intact.
For use with "GUARD" [[setWaypointType|waypoint]]. How does "GUARD" waypoint work: [[Waypoint:Guard]]
To be used with "GUARD" [[setWaypointType|waypoint]].
{{Feature|informative|To know how does the "GUARD" waypoint work, see [[Waypoint:Guard]].}}


|s1= '''createGuardedPoint''' [side, position, objectMapID, vehicle]
|s1= [[createGuardedPoint]] [side, position, objectMapID, vehicle]


|p1= [side, position, idStatic, vehicle]: [[Array]]
|p1= side: [[Side]] - the side which will be guarding
|p2= side: [[Side]] - The side which will be guarding
|p3= position: [[Position]] - [[Object]], [[Group]], [[Position2D]] or [[Position3D]]
|p4= objectMapID: [[Number]] - static id of map object. -1 to ignore
|p5= vehicle: [[Object]] - vehicle to be used for position. [[objNull]] to ignore


|r1=[[Nothing]]
|p2= position: [[Object]], [[Group]], [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]]


|x1= <code>[[createGuardedPoint]] [<nowiki/>[[east]], [0,0], -1, [[vehicle]] [[player]]];</code>
|p3= objectMapID: [[Number]] - static id of map object. -1 to ignore


|seealso= [[createTrigger]], [[addWaypoint]], [[setWaypointType]]
|p4= vehicle: [[Object]] - vehicle to be used for position. [[objNull]] to ignore
 
|r1= [[Nothing]]
 
|x1= <sqf>createGuardedPoint [east, [0,0], -1, vehicle player];</sqf>
 
|seealso= [[createTrigger]] [[addWaypoint]] [[setWaypointType]]
}}
}}

Latest revision as of 14:45, 8 November 2023

ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Adds a point guarded by the given side (scripted way of adding equivalent of "GUARDED BY" trigger in Editor). A closest AI group in the given side with assigned "GUARD" waypoint will attempt to secure this guard point. The actual guarded position is determined via the following rules:
  • Given "position" is always considered. It could be Object, Group, Position2D or Position3D. In every case, z coordinate will be ignored and point will be placed on nearest surface.
  • If "objectMapID" is not negative, the position of the object with the given ID is used (Overrides "position"). -1 to ignore this argument. z of the object position will be intact.
  • If the given "vehicle" is valid, the position of the vehicle is extracted and guarded (Overrides both "position" and "objectMapID"). objNull to ignore. z of the vehicle position will be intact.
To be used with "GUARD" waypoint.
ⓘ
To know how does the "GUARD" waypoint work, see Waypoint:Guard.
Groups:
Waypoints

Syntax

Syntax:
createGuardedPoint [side, position, objectMapID, vehicle]
Parameters:
side: Side - the side which will be guarding
position: Object, Group, Position2D or Position3D
objectMapID: Number - static id of map object. -1 to ignore
vehicle: Object - vehicle to be used for position. objNull to ignore
Return Value:
Nothing

Examples

Example 1:
createGuardedPoint [east, [0,0], -1, vehicle player];

Additional Information

See also:
createTrigger addWaypoint setWaypointType

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
Retrieved from "https://community.bistudio.com/wiki?title=createGuardedPoint&oldid=348606"