motion.get_current
Overview
- Get the motion(s) currently playing on the target Zoi. Returns playing=false if idle, otherwise an array of active montage instances with anim_id, position (seconds), total_length, rate_scale, and group. Only Root component motions are reported (full-body).
Metadata
| Field | Value |
|---|---|
| Display | Get Current Motion |
| Category | motion |
| Access | UserCheat |
| Scope | B2Authority |
| Tags | — |
| Aliases | MotionGetCurrent |
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| entity_id | entityId | no | — | Target entity ID (default: possessed) |
Returns
Returns a JSON object with the following fields:
| Field | Type | Required | Description |
|---|---|---|---|
playing | bool | yes | Whether any motion is currently playing |
motions | array | yes | Active montage instances (empty when idle) |
motions[].anim_id | string | yes | Animation id |
motions[].montage_id | string | yes | Montage row id |
motions[].group | string | yes | Montage group name |
motions[].position | float | yes | Current playback position (seconds) |
motions[].total_length | float | yes | Total montage length (seconds) |
motions[].rate_scale | float | yes | Playback rate scale |
motions[].non_interruptible | bool | yes | Whether the montage is non-interruptible |
Usage
await inzoi.cli.execute('motion.get_current', {
entity_id: 0, // optional
});