Movement
Movement tools teleport or tween transforms for the active character.
All movement tools target the active character. Use select_character first when working with multiple characters.
move_character
Teleport the active character to a viewport position instantly. (0, 0) is the top-left corner of the primary monitor.
| Parameter | Type | Default | Description |
|---|---|---|---|
x | number | required | Viewport X coordinate (pixels) |
y | number | required | Viewport Y coordinate (pixels) |
tween_position
Smoothly animate the active character's position to a target in world space.
| Parameter | Type | Default | Description |
|---|---|---|---|
targetX | number | required | Target X coordinate (world space) |
targetY | number | required | Target Y coordinate (world space) |
targetZ | number | required | Target Z coordinate (world space) |
durationMs | number | required | Animation duration in milliseconds |
easing | string | "linear" | Easing function (see Easing Functions) |
wait | boolean | false | Wait for animation to finish before returning |
tween_rotation
Smoothly animate the active character's rotation to a target quaternion.
| Parameter | Type | Default | Description |
|---|---|---|---|
targetX | number | required | Target quaternion X |
targetY | number | required | Target quaternion Y |
targetZ | number | required | Target quaternion Z |
targetW | number | required | Target quaternion W |
durationMs | number | required | Animation duration in milliseconds |
easing | string | "linear" | Easing function (see Easing Functions) |
wait | boolean | false | Wait for animation to finish before returning |
Example — 180° Y-axis rotation over 1 second:
{
"targetX": 0,
"targetY": 1,
"targetZ": 0,
"targetW": 0,
"durationMs": 1000,
"easing": "cubicInOut"
}
tween_scale
Smoothly animate the active character's scale. 1.0 is normal size on each axis.
| Parameter | Type | Default | Description |
|---|---|---|---|
targetX | number ≥ 0 | required | Target X scale factor |
targetY | number ≥ 0 | required | Target Y scale factor |
targetZ | number ≥ 0 | required | Target Z scale factor |
durationMs | number | required | Animation duration in milliseconds |
easing | string | "linear" | Easing function (see Easing Functions) |
wait | boolean | false | Wait for animation to finish before returning |
Easing Functions
All three tween tools (tween_position, tween_rotation, tween_scale) accept the same easing values:
linear, quadraticIn, quadraticOut, quadraticInOut, cubicIn, cubicOut, cubicInOut, quarticIn, quarticOut, quarticInOut, quinticIn, quinticOut, quinticInOut, sineIn, sineOut, sineInOut, circularIn, circularOut, circularInOut, exponentialIn, exponentialOut, exponentialInOut, elasticIn, elasticOut, elasticInOut, backIn, backOut, backInOut, bounceIn, bounceOut, bounceInOut, smoothStepIn, smoothStepOut, smoothStep, smootherStepIn, smootherStepOut, smootherStep