Difference between revisions of "MoveTo"

Revision as of 10:44, 29 November 2006

Syntax:

MoveTo MarkerID, [x, y, z] (optional)

Example:

MoveTo HiddenCaveMarker 
MoveTo player, 512, 0, 0

Moves the object to the specified reference's location. The x, y, z are optional offsets in units from the target reference.

Notes:

If this function is used to move the player, it will also act as a Return function -- no following lines of the script will be processed.

This function works as expected for Actors. For most other object types, like containers and activators, the object's coordinates are updated but its world art is not. Additional scripting may be necessary to ensure the object moves properly:

myObject.disable
myObject.moveTo [location]
myObject.enable
set xp to myObject.getPos x
myObject.setPos x xp

Script functions that make one actor target another (like SayTo or StartCombat) will not work when MoveTo is used on the target in the same frame, even when the target is moved only by a few inches.

@@ Line 13: / Line 13: @@
 *If this function is used to move the player, it will also act as a [[Return]] function -- no following lines of the script will be processed.
-*This function is only reliable for Actors. Using it to move other objects types, especially non-persistent references and inventor items may result in unexpected behavior.
+*This function works as expected for Actors. For most other object types, like containers and activators, the object's coordinates are updated but its world art is not. Additional scripting may be necessary to ensure the object moves properly:
+<pre>myObject.disable
+myObject.moveTo [location]
+myObject.enable
+set xp to myObject.getPos x
+myObject.setPos x xp</pre>
 *Script functions that make one actor target another (like [[SayTo]] or [[StartCombat]]) will not work when MoveTo is used on the target in the same frame, even when the target is moved only by a few inches.