| name | spiral-walk |
| description | Walks an inward spiral toward the center, via a sequence of root waypoints with a shrinking radius. Use when a command mentions spiral walk, walk in a spiral, spiral inward, or wind inward in a coil. |
| category | locomotion |
| disable-model-invocation | true |
| subskills | ["walk","turn-and-face"] |
spiral-walk
A coiling path that spirals from the outside inward toward the center.
Composes: walk + turn-and-face
How
- Use a
sequence with loop:false. Frame root is ABSOLUTE; compute the travel axis from state.position+state.faceDeg (0=+Z, 90=+X). The example assumes origin facing +Z.
- Waypoints orbit with a steadily shrinking radius toward the center;
faceDeg stays tangent.
durationMs ~5500.
Example
- "walk in a spiral" ->
{"durationMs":5500,"say":"Spiraling inward.","sequence":{"loop":false,"frames":[{"t":0,"root":{"x":2.5,"z":0,"faceDeg":-90}},{"t":0.3,"root":{"x":0,"z":2,"faceDeg":180}},{"t":0.55,"root":{"x":-1.5,"z":0,"faceDeg":90}},{"t":0.8,"root":{"x":0,"z":-1,"faceDeg":0}},{"t":1,"root":{"x":0.5,"z":0,"faceDeg":-90}}]}}
Limits & posture
Keep ≥1 foot grounded except at a jump's airborne apex; stay inside human joint ranges and keep weight over the support — see balance-and-posture.
