移動

移動ツールはアクティブキャラクターのテレポートまたはトゥイーントランスフォームを行います。

すべての移動ツールはアクティブキャラクターを対象にします。複数のキャラクターを操作する場合は、先に select_character を使用してください。

`move_character`

アクティブキャラクターをビューポート位置に瞬時にテレポートさせます。(0, 0) はプライマリモニターの左上隅です。

パラメータ	型	デフォルト	説明
`x`	`number`	必須	ビューポート X 座標（ピクセル）
`y`	`number`	必須	ビューポート Y 座標（ピクセル）

`tween_position`

アクティブキャラクターの位置をワールド空間のターゲットまでスムーズにアニメーションします。

パラメータ	型	デフォルト	説明
`targetX`	`number`	必須	ターゲット X 座標（ワールド空間）
`targetY`	`number`	必須	ターゲット Y 座標（ワールド空間）
`targetZ`	`number`	必須	ターゲット Z 座標（ワールド空間）
`durationMs`	`number`	必須	アニメーション時間（ミリ秒）
`easing`	`string`	`"linear"`	イージング関数（イージング関数を参照）
`wait`	`boolean`	`false`	アニメーション完了を待ってから返す

`tween_rotation`

アクティブキャラクターの回転をターゲットクォータニオンまでスムーズにアニメーションします。

パラメータ	型	デフォルト	説明
`targetX`	`number`	必須	ターゲットクォータニオン X
`targetY`	`number`	必須	ターゲットクォータニオン Y
`targetZ`	`number`	必須	ターゲットクォータニオン Z
`targetW`	`number`	必須	ターゲットクォータニオン W
`durationMs`	`number`	必須	アニメーション時間（ミリ秒）
`easing`	`string`	`"linear"`	イージング関数（イージング関数を参照）
`wait`	`boolean`	`false`	アニメーション完了を待ってから返す

例 -- 1秒で Y 軸 180 度回転：

{
  "targetX": 0,
  "targetY": 1,
  "targetZ": 0,
  "targetW": 0,
  "durationMs": 1000,
  "easing": "cubicInOut"
}

`spin_character`

アクティブキャラクターをワールド空間の軸を中心に指定した角度だけ回転させます。フル回転（360度以上）に対応しています。回転は加算的で、キャラクターの現在の向きを保持します。フル回転が必要な場合は tween_rotation の代わりにこちらを使用してください。

パラメータ	型	デフォルト	説明
`axis`	`string`	必須	回転軸: `"x"`、`"y"`、または `"z"`（ワールド空間）
`angleDegrees`	`number`	必須	回転角度（度数、360、720 なども可能）
`durationMs`	`number`	必須	アニメーション時間（ミリ秒）
`easing`	`string`	`"linear"`	イージング関数（イージング関数を参照）
`wait`	`boolean`	`false`	アニメーション完了を待ってから返す

例 -- 3秒で Y 軸 360 度フル回転：

{
  "axis": "y",
  "angleDegrees": 360,
  "durationMs": 3000
}

`tween_scale`

アクティブキャラクターのスケールをスムーズにアニメーションします。各軸で 1.0 が通常サイズです。

パラメータ	型	デフォルト	説明
`targetX`	`number >= 0`	必須	ターゲット X スケール係数
`targetY`	`number >= 0`	必須	ターゲット Y スケール係数
`targetZ`	`number >= 0`	必須	ターゲット Z スケール係数
`durationMs`	`number`	必須	アニメーション時間（ミリ秒）
`easing`	`string`	`"linear"`	イージング関数（イージング関数を参照）
`wait`	`boolean`	`false`	アニメーション完了を待ってから返す

イージング関数

すべてのトゥイーンツール（tween_position、tween_rotation、tween_scale、spin_character）は同じイージング値を受け付けます：

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

move_character​

tween_position​

tween_rotation​

spin_character​

tween_scale​

イージング関数​