Editing SetPosition - ObjectReference

[[Category:Scripting]]
[[Category:Papyrus]]
[[Category:Latent Functions]]
'''Member of:''' [[ObjectReference Script]]

Sets the object's current position in the world.

== Syntax ==
<syntaxhighlight lang="papyrus">
Function SetPosition(float afX, float afY, float afZ) native
</syntaxhighlight>

== Parameters ==
*afX: Position along the X axis.
*afY: Position along the Y axis.
*afZ: Position along the Z axis.

== Return Value ==
None.

== Examples ==
<syntaxhighlight lang="papyrus">
; Set the statue to be at the center of the world
StatueProperty.SetPosition(0.0, 0.0, 0.0)
</syntaxhighlight>

== Notes==
* SetPosition() should be avoided for placing other actors in sight of the player, as they will suddenly appear in an unrealistic way. Instead, consider placing them nearby but out of sight, and making them approach the player themselves, using [[PathToReference_-_Actor|PathToReference]] or [[ForceGreet (Procedure)|ForceGreet]].

* All movement functions can cause [[SetMotionType - ObjectReference#Bugs|major issues]] when used on a reference that has had a [[SetMotionType - ObjectReference|motion type override]] applied.

== See Also ==
*[[GetPositionX - ObjectReference]]
*[[GetPositionY - ObjectReference]]
*[[GetPositionZ - ObjectReference]]
*[[PlaceAtMe - ObjectReference]]
*[[MoveTo - ObjectReference]]
*[[MoveToInteractionLocation - ObjectReference]]
*[[MoveToMyEditorLocation - ObjectReference]]
*[[ObjectReference Script]]
*[[PathToReference - Actor]]
*[[Spatial functions and snippets]]
*[[Unit]]