setPos

obj setPos pos

Operand types:

obj: Object

pos: Array

Type of returned value:

Nothing

Description:

Set object position.
Pos array format is Position.

See also getPos

Examples:

player setPos [ getPos player select 0, (getPos player select 1) + 10]
player setPos [ getPos this select 0, getPos this select 1, (getPos this select 2) +10]
obj1 setpos [ getPos obj1 select 0, getPos obj1 select 1, -5] .........Buries obj1 5 metres below ground level.

Comment applicable to Ver 1.96 and earlier:

Note that:

obj1 setPos [x,y,z]

Will place most objects z metres above ground level (negative numbers for underground).

But if obj1 is a trigger then it will be placed z metres above sea level.

This can be very useful if you want to check a unit's height above sea level but it can be a problem if you want to move a trigger to create an explosion or a sound.

To move a trigger to a location at ground level:

triggername setPos [x,y,0]
triggername setPos [x,y,abs(getPos triggername select 2)]

Note for Armed Assault:

Using setPos for a trigger will work in exactly the same way that setPos works for other objects - namely that setPos [x,y,z] will place the trigger z metres above ground level. See also: setPosASL