---
name: set-anima-animations
description: Anima's animations and how to download them. Use when a game needs motion clips for Set's base character (breathing, walking and running, jump, punch, hit reaction, kneel, throw, and the runtime Guard stance, Lunge flight, HYSTERIA! cower and the Loiter's sit, converse and dance), the timing rules of its weapon actions, the schema of a clip's metadata, or wants to know what a downloaded clip contains and what stays in the runtime.
license: "Free to use when obtained from set.world, commercially too (the API, what it returns and the skills). Its models, animations and textures, Anima included, are CC BY 4.0: free to use with attribution to Jimmy Lee (j@internet.dev). The source code of Set is © Jimmy Lee under CC BY-NC 4.0 and its commercial use needs a paid waiver."
metadata:
  version: "0.15.35"
  title: Animations
---

# Animations (AnimaSystem)

Anima has no imported animation files. Every pose comes from one deterministic pose function over its 48-bone rig (`set-world-0-15-35-anima-motion-2`), and every preview, scene actor and downloaded clip samples that same function. Motion is part of Set's own game layer; the API returns no animation.

## Download a clip

Clips are built in the browser at `https://set.world/anima`. Scroll a column into view, set its controls, then choose **Download motion** (or **Download model** in the first two columns).

| Column | File | Clip |
| --- | --- | --- |
| Base avatar, Portrait face | `anima.glb` | Breathing, 4 s loop |
| Walking | `anima-walk.glb` | One stride in place at the chosen walk-to-run blend |
| Jump | `anima-jump.glb` | 4 s jump at the chosen height |
| Attacking | `anima-punch.glb` | The 4 s unarmed punch, whatever the column holds |
| Taking a hit | `anima-hit.glb` | 8 hits at the chosen frequency and direction, then full recovery |
| Kneeling | `anima-kneel.glb` | 4 s kneel, hold and rise |
| Lobbing a WorldSphere | `anima-throw.glb` | 12 s pickup, hold and overhand lob (walking while it holds when Walk while holding is on), with the prop's own track |

Each file is a GLB with the rigged model and one clip sampled at 60 Hz as position and rotation tracks per bone. Clips are CC BY 4.0 like the model and carry the same credit (Jimmy Lee (j@internet.dev); see [Character models](https://set.world/skills/anima-character-models#credit-it)). Download and load it exactly as the model in [Character models](https://set.world/skills/anima-character-models): the button is **Download motion**, and the clip is `asset.animations[0]`.

## The clip's metadata

The root node's `extras.motion` records what was sampled:

```ts
type ClipMotion = {
  kind: 'idle' | 'walk' | 'jump' | 'punch' | 'hit' | 'kneel' | 'throw';   // Guard, Lunge, cower, sit, converse and dance are runtime only
  version: string;                 // "set-world-0-15-35-anima-motion-2"
  gait: number;                    // the walk-to-run blend, 0..1
  inPlace: boolean;                // true for idle, walk, jump and throw
  jumpHeight?: number;             // jump: the slider amount, 0..1
  jumpApex?: number;               // jump: the height in model units
  hitsPerMinute?: number;          // hit
  hitDirection?: string;           // hit: "all", or one side's index "0" to "7" (0 front, 1 front right, 2 right, 3 back right, 4 back, 5 back left, 6 left, 7 front left)
  hits?: number;                   // hit: 8, one per side when the direction is "all"
  completeRecovery?: boolean;      // hit
  worldSphere?: Record<string, unknown>;   // throw: the prop's radius, timing and launch
};
```

```json
{ "kind": "jump", "version": "set-world-0-15-35-anima-motion-2", "gait": 0, "jumpHeight": 0.5, "jumpApex": 1.25, "inPlace": true }
```

A schema for clips in your game:

```ts
type AnimationClipAsset = { key: string; file: string; kind: ClipMotion['kind']; durationSeconds: number; loop: boolean; motionVersion: string };
// { key: 'walk', file: '/assets/anima-walk.glb', kind: 'walk', durationSeconds: 1.16, loop: true, motionVersion: 'set-world-0-15-35-anima-motion-2' }
```

**Not in a clip:** live IK, grip fitting, weapon actions, ragdolls, hit recoil, planted feet (the scenes' knockback stagger and the Guard pose's turning steps), the Guard stance, the Lunge flight, the cower, the sit, the converse, the dance, cloth and motion blending. Those are runtime controllers in `three-isometric-engine/avatar/motion.mjs`.

## The body motions

Every value in this table is printed from the engine. The clip you download carries the version it was sampled from.

| Motion | Rule |
| --- | --- |
| Breathing idle | A 4 s cycle; every action layers on it and returns to it |
| Walk to run | One continuous phase blended by `g` from 0 to 1: stride half-length 0.29 to 0.48, duty 0.64 to 0.42, 0.86 to 1.62 cycles per second. A blend change never resets the stride |
| Jump | Height `0.30 + 1.90 × amount` model units; crouch, push off at 0.67 s, rise gravity 10, fall gravity 14, absorbing landing |
| Punch | 4 s action, impact at 1.32 s; guard, windup, hip and spine drive; one sole stays grounded |
| Hit reaction | Each hit drives recoil, fold, stagger and a step for 2.4 s; hits add up and extend recovery. The clip steps from where the hit lands; in a scene the feet stay planted and step after the push instead ([Scenes](https://set.world/skills/anima-scenes)) |
| Guard | The Guard act's stance: pelvis lowered so the knees bend, forearms crossed in front of the chest with both hands in fists around their items; the feet step as the body turns. With a shield the shield's own shield-bash action is held at its push instead ([Stratagems](https://set.world/skills/anima-stratagems)) |
| Lunge | The Lunge act flies the body on the jump's own arc while a melee action or the punch plays at the act's speed, so the strike lands as the feet do ([Stratagems](https://set.world/skills/anima-stratagems)) |
| Cower | HYSTERIA!'s cower: crouched and bent forward, hands raised to the head, shivering ([Derived combat](https://set.world/skills/anima-derived-combat)) |
| Sit | A Loiter stance, held for as long as it is posed: seated on the ground, the pelvis lowered until the body rests on the floor and set back, the hips tilted back and the spine leaning forward over them, both feet flat ahead with the knees raised, the left drawn in nearer than the right, the arms hanging at the sides as in the idle, a slow sway and the head looking from side to side ([Stratagems](https://set.world/skills/anima-stratagems), Loiter) |
| Converse | A Loiter stance: standing, the weight shifting slowly from one foot to the other with the feet turned a little outward, the head nodding and turning, and both forearms raised before the chest with open hands, palms up, that rise and reach forward in turn as if talking |
| Dance | A Loiter stance on a steady beat: the knees bend and bounce on each beat, the hips sway to one side and the other and turn with the sway, the foot away from the sway lifts and sets down, the chest and head counter the hips, and both hands are raised beside the head and pump up and down in turn |
| Kneel | 4 s, down on the right knee; its held and rising part is the get-up after a fall |
| Landing and get-up | Landing 0.85 s; get-up blends 0.65 s, holds 0.85 s, rises 1.30 s |
| Ragdoll | 16 bodies for death, pickup and tumbles; a living Anima gets up and resumes |

Sit, converse and dance are pose modes of the same pose function, as the Guard stance and the cower are (`pose('sit', time)`, `'converse'`, `'dance'`), each a function of the seconds it has been held layered on the breathing idle; they are not among the downloadable motions. On `/anima-adventure` a hand that holds an item keeps its carry in the sit and the converse, so only an empty hand gestures, and both arms keep the dance with their items gripped ([Scenes](https://set.world/skills/anima-scenes)).

Elbows and knees solve with two-joint IK in stable pole planes; the pelvis drops rather than overextending a leg; every pose starts from rest, so nothing accumulates between cycles.

## Weapon actions

Every held item has one one-handed action, authored over a 4-second cycle (authored time, not wall time). The item's base type decides the action, and the action's delivery decides what it does:

| Delivery | Actions |
| --- | --- |
| melee | `bash`, `slash`, `jab`, `thrust`, `chop`, `shieldBash`, `lash`, `twirl`, `drill` |
| projectile | `aim`, `fire`, `whirl`, `throw`, `return`, `blast`, `conjure`, `gunfire`, `missile`, `hurl`, `skewer` |
| aura | `strum`, `play`, `crossRupture`, `repulse`, `triRupture`, `blow`, `unfurl` |
| wave | `flick`, `pound`, `gaze` |

Which of the 155 mainhands plays which action is one column of the held-item table in [Derived combat](https://set.world/skills/anima-derived-combat).

- **Tempo.** How fast an action plays is owned by [Derived combat](https://set.world/skills/anima-derived-combat).
- **Hands.** One complete action at a time; the left hand mirrors the action against its own anatomy. The previews alternate right and left; in a fight, which hand acts next is a rule of [Derived combat](https://set.world/skills/anima-derived-combat).
- **Kneeling shots.** Arbalest, Crossbow, Ballista, Hand cannon, Rifle and Harpoon kneel on the firing-side knee and shoot level.
- **Steps.** A thrust and the Drill's push step the weapon-side foot forward; a chop steps the other foot forward with bent knees.
- **Windup.** Long tools pull the torso back further, short tools less; the strike pose and contact timing never move.

Weapon actions are not downloadable clips. To see each one: `https://set.world/anima-all-weapons` (every mainhand, Start) and `https://set.world/anima-object-models` (Start attack on the chosen item). Their keyframes are in `three-isometric-engine/weapons/actions.ts`.

## Reference

Clocks, pausing and what interrupts an action in a running scene are in [Scenes](https://set.world/skills/anima-scenes) and [Derived combat](https://set.world/skills/anima-derived-combat). Equations and timings are §15.7 to §15.21 of the reference, and weapon action timing §13.2, §13.22 and §13.69 ([Algorithms](https://set.world/skills/algorithms)). The poses are stylised demonstrations, not a validated combat or locomotion model. Set has not tested the clips in other engines.
