Move: Difference between revisions

From Virtual Paradise Wiki
Jump to navigation Jump to search
Sleepy E (talk | contribs)
m Added name, global arguments and more examples
Talisan (talk | contribs)
m reset/noreset loop/noloop clarifications
 
(2 intermediate revisions by 2 users not shown)
Line 4: Line 4:


==Usage==
==Usage==
     '''move''' X [Y] [Z] [''noloop OR loop''] [''nosync OR sync''] [''smooth''] [''noreset OR reset''] [ltm] [''wait='']  [''time='']  [''offset='']
     '''move''' X [Y] [Z] [''noloop OR loop''] [''nosync OR sync''] [''smooth''] [''noreset OR reset''] [ltm] [''wait='']  [''time='']  [''offset=''] [''name=''] [''global'']


==Arguments==
==Arguments==
; X Y Z : The X, Y and Z distance in meters that the object will move (and back from). Movement goes along the world axis, unless Ltm is set. Need to specify at minimum X.<br>'''Default:''' Y is 0.0, Z is 0.0  
; X Y Z : The X, Y and Z distance in meters that the object will move (and back from). Movement goes along the world axis, unless Ltm is set. Need to specify at minimum X.<br>'''Default:''' Y is 0.0, Z is 0.0  
; Noloop OR Loop : Continue looping after having moved to (and back) the given distance.<br>'''Default:''' Noloop
; Noloop OR Loop : Controls whether the movement cycle repeats continuously (loop) or runs once (noloop).<br>'''Default:''' Noloop
; Nosync OR Sync : Make the object appear in the same position for all users by synchronizing its movement with the universe time.<br>'''Default:''' Nosync
; Nosync OR Sync : Make the object appear in the same position for all users by synchronizing its movement with the universe time.<br>'''Default:''' Nosync
; Smooth : Smoothly accelerate and decelerate the movement.<br>'''Default:''' Not applied
; Smooth : Smoothly accelerate and decelerate the movement.<br>'''Default:''' Not applied
; Noreset OR Reset : Move back or reset position after completing half a cycle.<br>'''Default:''' Noreset
; Noreset OR Reset : Controls how the object returns to its starting position after moving the target distance: smoothly animates back over time= (noreset) or instantly snaps back (reset).<br>'''Default:''' Noreset
; Ltm : Move along the object axis, not the world axis.<br>'''Default:''' Not applied
; Ltm : Move along the object axis, not the world axis.<br>'''Default:''' Not applied
; Wait : Time in seconds to wait before continuing movement after one half of a cycle.<br>'''Values:''' Decimal numbers greater than 0.0<br>'''Default:''' 0.0
; Wait : Time in seconds to wait before continuing movement after one half of a cycle.<br>'''Values:''' Decimal numbers greater than 0.0<br>'''Default:''' 0.0
Line 18: Line 18:
; Name : The name of the object(s) to initiate the command on (see [[Name]] for more information)<br>'''Default:''' Current object only
; Name : The name of the object(s) to initiate the command on (see [[Name]] for more information)<br>'''Default:''' Current object only
; Global : If set, this will cause a trigger (e.g. activate, adone) to initiate this command for all users have the object in view. Otherwise, the command will be initiated only for the user who activates the trigger<br>'''Default:''' Not set
; Global : If set, this will cause a trigger (e.g. activate, adone) to initiate this command for all users have the object in view. Otherwise, the command will be initiated only for the user who activates the trigger<br>'''Default:''' Not set
=== Option Combinations ===
{| class="wikitable"
! Combination !! Phase 1 (0 to time=) !! Pause !! Phase 2 (Return) !! Pause !! Continuation
|-
| '''noloop noreset''' || Animates A &rarr; B || Waits wait= || Animates B &rarr; A || Waits wait= || Stops at A
|-
| '''noloop reset''' || Animates A &rarr; B || Waits wait= || Snaps instantly to A || &mdash; || Stops at A
|-
| '''loop noreset''' || Animates A &rarr; B || Waits wait= || Animates B &rarr; A || Waits wait= || Repeats continuously
|-
| '''loop reset''' || Animates A &rarr; B || Waits wait= || Snaps instantly to A || &mdash; || Repeats continuously
|}


==Example==
==Example==
Line 27: Line 40:


When clicked, move the object 10 meters along its (Ltm) X-axis (3 seconds to complete), wait 1 second, snap back to original position (Reset), do not repeat. This is done for all users who see the object.
When clicked, move the object 10 meters along its (Ltm) X-axis (3 seconds to complete), wait 1 second, snap back to original position (Reset), do not repeat. This is done for all users who see the object.
create move 0 0 10 time=0 wait=9e9
The object instantly moves to the new position and remains there for approximately 285.5 years(9,000,000,000 seconds) before the command repeats.


{{Build}}
{{Build}}
[[Category: Script commands]]
[[Category: Script commands]]

Latest revision as of 23:49, 9 September 2026

Move
Build required N/A
Version required 0.3.19


The move command animates the position of an object.

Usage

   move X [Y] [Z] [noloop OR loop] [nosync OR sync] [smooth] [noreset OR reset] [ltm] [wait=]  [time=]  [offset=] [name=] [global]

Arguments

X Y Z
The X, Y and Z distance in meters that the object will move (and back from). Movement goes along the world axis, unless Ltm is set. Need to specify at minimum X.
Default: Y is 0.0, Z is 0.0
Noloop OR Loop
Controls whether the movement cycle repeats continuously (loop) or runs once (noloop).
Default: Noloop
Nosync OR Sync
Make the object appear in the same position for all users by synchronizing its movement with the universe time.
Default: Nosync
Smooth
Smoothly accelerate and decelerate the movement.
Default: Not applied
Noreset OR Reset
Controls how the object returns to its starting position after moving the target distance: smoothly animates back over time= (noreset) or instantly snaps back (reset).
Default: Noreset
Ltm
Move along the object axis, not the world axis.
Default: Not applied
Wait
Time in seconds to wait before continuing movement after one half of a cycle.
Values: Decimal numbers greater than 0.0
Default: 0.0
Time
Time in seconds for the object to move one half of a full cycle.
Values: Decimal numbers greater than 0.0
Default: 1.0
Offset
Offset in seconds to apply to universe time when synchronizing.
Values: Decimal numbers greater than 0.0
Default: 0.0
Name
The name of the object(s) to initiate the command on (see Name for more information)
Default: Current object only
Global
If set, this will cause a trigger (e.g. activate, adone) to initiate this command for all users have the object in view. Otherwise, the command will be initiated only for the user who activates the trigger
Default: Not set

Option Combinations

Combination Phase 1 (0 to time=) Pause Phase 2 (Return) Pause Continuation
noloop noreset Animates A → B Waits wait= Animates B → A Waits wait= Stops at A
noloop reset Animates A → B Waits wait= Snaps instantly to A Stops at A
loop noreset Animates A → B Waits wait= Animates B → A Waits wait= Repeats continuously
loop reset Animates A → B Waits wait= Snaps instantly to A Repeats continuously

Example

create move 0 10 0 smooth time=5 wait=3 loop

Move the object smoothly 10 meters up (5 seconds to complete), wait 3 seconds, move object smoothly 10 meters down (5 seconds to complete), wait 3 seconds, repeat (Loop).

activate move 10 0 0 ltm time=3 wait=1 reset global

When clicked, move the object 10 meters along its (Ltm) X-axis (3 seconds to complete), wait 1 second, snap back to original position (Reset), do not repeat. This is done for all users who see the object.

create move 0 0 10 time=0 wait=9e9

The object instantly moves to the new position and remains there for approximately 285.5 years(9,000,000,000 seconds) before the command repeats.

Object Scripting

Triggers:

ActivateAdoneBumpBumpendCreate

Commands:

AnimateAnimationAmbientCameraColorDiffuseFrameFramerateGroupLightMoveNameNoiseNormalmapOpacityPathPictureRotateSayShearScaleSignSolidSoundSpecularSpecularmapTeleportTeleportxTeleportxyzTextureUrlVisibleWeb