pose.set_bone
Overview
- Layers a bone transform override on the body post-process anim instance without replacing the main animation pipeline (preserves body proportions). Specify any of rot_/loc_/scale_*.
Metadata
| Field | Value |
|---|---|
| Display | Set Bone Pose |
| Category | pose |
| Access | ScriptCheat |
| Scope | B1Standalone |
| Tags | Experimental |
| Aliases | — |
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| entity_id | entityId | no | — | Target entity ID (default: possessed) |
| bone | name | yes | — | Bone name to modify (e.g. spine_04) |
| component | name | no | — | Skeletal mesh component name (default: body). Note: Head mesh overrides may be lost on face customization refresh. |
| mode | string | no | replace | Modification mode: replace | additive | ignore (default: replace) |
| rot_pitch | float | no | — | Rotation pitch (deg) |
| rot_yaw | float | no | — | Rotation yaw (deg) |
| rot_roll | float | no | — | Rotation roll (deg) |
| loc_x | float | no | — | Translation X (cm) |
| loc_y | float | no | — | Translation Y (cm) |
| loc_z | float | no | — | Translation Z (cm) |
| scale_x | float | no | — | Scale X (default 1) |
| scale_y | float | no | — | Scale Y (default 1) |
| scale_z | float | no | — | Scale Z (default 1) |
Usage
await inzoi.cli.execute('pose.set_bone', {
entity_id: 0, // optional
bone: '',
component: '', // optional
mode: 'replace', // optional
rot_pitch: 0.0, // optional
rot_yaw: 0.0, // optional
rot_roll: 0.0, // optional
loc_x: 0.0, // optional
loc_y: 0.0, // optional
loc_z: 0.0, // optional
scale_x: 0.0, // optional
scale_y: 0.0, // optional
scale_z: 0.0, // optional
});