springBones
Since 0.7
Secondary motion for this entity's animated model: chosen bones swing on springs after the animation, with gravity, damping and colliders.
Needs an animator on the same entity. Bones are found by name when the scene loads; one the rig does not have is reported as spring-bone-unknown and its chain is left out. Drag is folded into damping. Known limit: attachments (attach) and sockets follow the animated pose, not the springs. See docs/SPRINGS.md.
Use it in a scene entity's components list as { "type": "springBones", … }. The contract writes the fields flat and refuses unknown keys.
Fields
| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
chains | SpringChain[] | yes | Chains of bones swung by springs: hair, a tail, a cape. A bone is in at most one chain. | ||
colliders | SpringCollider[] | no | Shapes that follow bones and that every chain on this entity stays outside of. |