Tes3Mod:Position

The UESPWiki – Your source for The Elder Scrolls since 1995

Position
PositionCell

		Position,     X, Y, Z, ZRot
		PositionCell, X, Y, Z, ZRot, "CellID"

       Where:	X,Y,Z     = Exterior/interior location to move to the object to (float).
		ZRot	  = World Z-axis orientation of the object (degrees, 0=North, 180=South, float) 
		CellID	  = Interior cell name
			
	Type:	Movement

     Returns:	none

     Example:	Player->Position, -1005, 165018, 100	
		"Salyni Nelvayn"->PositionCell, 106, 1241, -105, "Assurdirapal, Shrine"
		PositionCell, 8090, 698, -500, 270, "Vivec, St. Olms Haunted Manor"

     Scripts:	CharGen
		gardingScript

Sets the position of the calling object to the given exterior (Position) or interior (PositionCell) location. If you try to teleport to an unsafe place (clipping with an object or out in the void), you will instead be placed at the next safe location. Some people have noticed bugs using the Position function (NPCs disappearing) and reccommend using the PositionCell function instead, which can be outside if an exterior cell name is given.

Note that the ZRot parameter does not appear to work when PositionCell is used on NPCs. It seems to work fine on the player and other objects though. Also, if you PositionCell something you have never met into your current cell then its local script will not start running (until you leave the area and return anyways).

A common application of this function is to create a teleportation item (though, since variables are not accepted, you can only teleport to set locations), for example:

Begin TestTeleport_Script
	short button
	short messageOn
	short reset
	short OnPcEquip

	if ( OnPCEquip == 0 )
		set reset to 0
	endif

	if ( reset == 1 )
		return
	endif

	if ( OnPCEquip == 1 )
		if ( reset == 0 )
			Set OnPCEquip to 0
			MessageBox "Use the Mazedband to teleport where?" "Vivec" "Mournhold" "Sotha Sil" "Nowhere"
			set messageOn to 1
		endif
	endif

	if ( messageOn == 1 )
		set button to GetButtonPressed

		if ( button >= 0 )
			set messageOn to 0
		endif

			; Vivec
		if ( button == 0 )
			playsound "conjuration hit"
			Player->PositionCell 12, 219, -501, 0 "Vivec, High Fane"
			set reset to 1		

			; Mournhold
		elseif ( button == 1 )
			playsound "conjuration hit"
			Player->PositionCell 0, -478, -645, 0 "Mournhold Temple: High Chapel"
			set reset to 1		

			; Sotha sil
		elseif ( button == 2 )
			playsound "conjuration hit"
			Player->PositionCell 3976, 4179, 12310, 0 "Sotha Sil, Dome of Sotha Sil"
			set reset to 1
			return

			; Nothing
		elseif ( button == 3 )
			set reset to 1
			return

		endif

	endif

End

You should not use either function from dialogue results as it can cause the game to crash. Instead, create a script to peform the teleporting and use a StartScript to start it from the dialogue result.

See Also: PlaceItem, PlaceItemCell