Animation list — what you can animate

This is the scannable index of every animation state the rig can show, and how an artist hands the engine a clip for each. It answers one question: “what states exist, and what do I author for each?” For the mechanics of authoring a clip (the constructor block, joint masking, overlay stacking, properties), see Animations — this page is the catalogue, that page is the how-to.

Status is honest here, not aspirational

Most states below are not authored. Only four clips are real authored poses (all four self-labelled TEST, not final Blender exports — and only one of the four is actually animated; the rest are static TEST poses), and the base locomotion clips are not shipped at all (they resolve to the empty animation on a release build). The badges reflect that. Read a ❌ Planned as “you author this from nothing,” not “almost done.”

The three ways to provide a clip

Every animable state can be filled one of three ways. The whole catalogue below is just “which of these three applies, and is it done yet.”

• (A) GLOBAL replace — the base biped motion, one FULL_BODY clip for every entity (player + NPC). This is how base locomotion works: bind a LivingMotion (WALK, IDLE, …) to one clip and everyone uses it. Replaces that motion’s whole body.

• (B) Per-item FULL_BODY replace — an item binds a motion to its own whole-body clip via animations.living_motions with mode: "FULL_BODY". When that item is worn, its clip replaces the base motion entirely. No shipped item does this today, and for restraints the recommendation is to avoid it: “bound” = plain base motion + an arm OVERLAY (so the legs keep the real walk cycle), rather than a monolithic per-item bound clip.

• (C) Per-item OVERLAY — an item composes only the joints it declares on top of whatever base motion is playing; the base shows through everywhere else (arms posed, legs still walk). This is mode: "OVERLAY" + a joints[] list. All four shipped authored clips are overlays (armbinder = the 8-joint arm chain, classic_collar = [Head]). The deeper mechanics — joint masking, overlay stacking, the base-layer dependency — are on the FULL_BODY vs OVERLAY section of the Animations page.

Naming

Canonical authoring names use tiedup:<category>.<subject>.<descriptor> with <category> ∈ base | item | reaction | coop, the descriptor being the lower-cased exact LivingMotion/event token, and the role suffix being initiator / target / self (e.g. tiedup:reaction.restrain.initiator). Author against these dotted ids.

Locomotion (base) — GLOBAL replace

The shared base biped motions, used by everyone. One FULL_BODY clip per motion.

Bound entities use these SAME base motions

There are no separate *_BOUND locomotion clips. “Bound” does not switch the base motion — a restrained entity plays the plain WALK / SNEAK / FALL here, and the restraint look comes from a per-item arm OVERLAY composed on top (and, later, a MovementStyle gait overlay on the legs — see the gait section). Author one walk cycle and it serves bound and unbound movers alike.

The whole group is not shipped: on a clean/release build every id resolves to the empty animation (no pose), so there is no base locomotion at all until these are authored. This is the highest-leverage place to start — every entity, bound or not, uses these.

State (canonical id)	When it plays	How to provide	Status
base.locomotion.idle tiedup:context_stand_idle	Standing still & not bound (IDLE) — also the universal fallback every unbound motion slides to	(A) GLOBAL FULL_BODY	⚠️ Placeholder (identity)
base.locomotion.walk tiedup:walk	Moving on ground (WALK) — bound or not; a bound mover plays this base + an arm overlay	(A) GLOBAL FULL_BODY	❌ Not shipped — author it
base.locomotion.run tiedup:run	Sprinting on ground & not bound (RUN)	(A) GLOBAL FULL_BODY	❌ Not shipped
base.locomotion.jump tiedup:jump	On jump (JUMP)	(A) GLOBAL FULL_BODY	❌ Not shipped
base.locomotion.fall tiedup:fall	Airborne, deltaY < 0 (FALL) — bound or not	(A) GLOBAL FULL_BODY	❌ Not shipped
base.locomotion.sneak tiedup:sneak	Moving + sneaking (SNEAK) — bound or not; players only	(A) GLOBAL FULL_BODY	❌ Not shipped
base.locomotion.swim tiedup:swim	In water (SWIM — same clip for bound & unbound; no SWIM_BOUND)	(A) GLOBAL FULL_BODY	❌ Not shipped
base.locomotion.struggle STRUGGLE	Actively struggling — the writhe while the struggle minigame is on. A base motion, not a *_BOUND clip.	(A) GLOBAL FULL_BODY base + (C) per-item arm OVERLAY (armbinder supplies the arm wiggle)	⚠️ Only an arm OVERLAY exists (no full-body base)
base.locomotion.sit tiedup:sit	NPC sitting (SIT) — NPC-only; players use pose_furniture_seat	(A) GLOBAL FULL_BODY	❌ Not shipped
base.locomotion.sleep tiedup:sleep	Plain SLEEP — bound players route to pose_sleep_bound instead	(A) GLOBAL FULL_BODY	❌ Not shipped + inert
base.locomotion.kneel tiedup:kneel	Vanilla EF KNEEL — never selected (bound kneel uses pose_kneel_bound)	(A) GLOBAL FULL_BODY	❌ Not shipped + dead
base.locomotion.landing_recovery tiedup:landing	LANDING_RECOVERY — stock-bound, never selected	(A) GLOBAL FULL_BODY	❌ Not shipped + dead
base.locomotion.float tiedup:float	FLOAT — stock-bound, never selected	(A) GLOBAL FULL_BODY	❌ Not shipped + dead

The moving gaits (walk / run / sneak / swim) bind as speed-synced gaits — their playback tracks the player’s actual movement speed so the feet don’t slide. “FULL_BODY” here means whole-body, not a fixed cadence. See Animating restraints, rule 9.

Two traps in this group

idle is the one seen constantly — it is a placeholder with no visible sway. Replace it with a breathing/sway idle first. Author against context_stand_idle, the id IDLE binds to.

kneel / landing_recovery / float are never selected — no path in the rig ever returns them. A clip you author for them will never play. Don’t author them.

Poses (bound / seated)

Held poses the rig selects for steady states. All FULL_BODY, GLOBAL/shared.

State (canonical id)	When it plays	How to provide	Status
base.bound.pose_kneel_bound	NPC kneeling pose while bound (POSE_KNEEL_BOUND) — NPC-only	(A) GLOBAL/shared FULL_BODY	❌ Not shipped — author it
base.bound.pose_dog	Dog-pose: arms bound with poseType=DOG (POSE_DOG, player + NPC)	(A) GLOBAL/shared FULL_BODY	❌ Not shipped — author it
base.bound.pose_sleep_bound	Asleep while bound (POSE_SLEEP_BOUND)	(A) GLOBAL/shared FULL_BODY	❌ Not shipped — author it
base.bound.pose_furniture_seat	Riding a furniture seat (POSE_FURNITURE_SEAT, player + NPC)	(A) GLOBAL/shared FULL_BODY, or per-seat via the seat JSON’s sit_animation field	❌ Missing (falls back to idle)
base.bound.pose_unconscious	Intended steady-state post-capture (POSE_UNCONSCIOUS)	(A) GLOBAL/shared FULL_BODY if wired	❌ No selection route — needs wiring first

pose_unconscious is not selectable yet

POSE_UNCONSCIOUS is not selectable today — nothing in the rig ever plays it, so a clip you author for it will not show. Do not author yet; this needs engine wiring first.

Per-item overlays (currently shipped)

The only states with real authored clips today. All are (C) per-item OVERLAYs. All four are self-labelled TEST poses — placeholders for a final Blender export, not final art.

State (canonical id)	When it plays	How to provide	Status
item.armbinder.idle tiedup:armbinder_idle	IDLE while armbinder equipped	(C) OVERLAY — ARMS (8 arm-chain joints: Shoulder/Arm/Elbow/Hand L+R)	⚠️ Authored (TEST, static)
item.armbinder.walk tiedup:armbinder_walk	WALK while armbinder equipped — composes over the plain WALK base whether bound or not	(C) OVERLAY — ARMS (8 arm-chain)	⚠️ Authored (TEST, static)
item.armbinder.struggle tiedup:armbinder_struggle	STRUGGLE while armbinder equipped	(C) OVERLAY — ARMS (8 arm-chain)	⚠️ Authored (TEST, the only animated clip)
item.classic_collar.idle tiedup:classic_collar_idle	IDLE while classic_collar equipped	(C) OVERLAY — NECK ([Head], slight tilt)	⚠️ Authored (TEST)

Notes on the shipped overlays

The armbinder binds exactly three motions — IDLE, WALK, STRUGGLE — all ARM overlays, each riding the plain base motion underneath. The armbinder_struggle clip (a 3-keyframe arm wiggle) is the only animated shipped clip; everything else is static. Only classic_collar has a neck overlay — the choke/gps/shock collars have none.

Gameplay reactions

Discrete one-shots fired by a gameplay event and broadcast by id to every viewer and the affected entity. Not a LivingMotion binding — these are ONESHOTs. They are referenced by synced_actions/*.json + action_events.json but ship no asset.

Several events share one clip, so you author it once: reaction.restrain.{initiator,target} covers all four capture flows (capture_grab / enslave / recapture / punish), and reaction.flinch covers both hurt and lockpick.

Reaction clip (canonical id)	Bound to which event(s)	Roles	How to provide	Status
reaction.struggle tiedup:reaction.struggle	STRUGGLE — fired on both the struggle-start edge and the shock-collar interrupt edge	self	ONESHOT (broadcast by id)	❌ Referenced, no asset — author it
reaction.flinch tiedup:reaction.flinch	HURT and LOCKPICK_FAIL — one shared flinch clip	self	ONESHOT	❌ Referenced, no asset — author it
reaction.restrain.initiator tiedup:reaction.restrain.initiator	Shared initiator clip for all four capture flows: CAPTURE_GRAB / ENSLAVE / RECAPTURE / PUNISH	initiator	ONESHOT (coop role)	❌ Referenced, no asset — author it
reaction.restrain.target tiedup:reaction.restrain.target	Shared target clip for the same four flows	target	ONESHOT (coop role)	❌ Referenced, no asset — author it
reaction.leash_yank tiedup:leash_yank	LEASH_YANK — its own distinct reaction	self	ONESHOT	❌ Placeholder — author it

DEATH reaction — placeholder, author it

death ships a self-role def (tiedup:death) that fires on death, but its clip is an unauthored placeholder — author it. (leash_yank is the same shape: the def ships, the clip is a placeholder.)

Coop takedown (waypointed)

The takedown has two waypointed roles, each combining a synced clip with anchored position waypoints (POSITION+CLIP). Respect the waypoint timing in takedown.json when authoring the clips.

State (canonical id)	When it plays	How to provide	Status
coop.takedown.initiator tiedup:takedown_initiator	Takedown action, initiator role	POSITION+CLIP (2 waypoints)	❌ Referenced, no asset — author it
coop.takedown.target tiedup:takedown_target	Takedown action, target role	POSITION+CLIP (3 waypoints, eased pull-in, yaw 180)	❌ Referenced, no asset — author it

Equip one-shots

Fired on on_equip / on_unequip of an item. Full-biped ONESHOTs.

State (canonical id)	When it plays	How to provide	Status
item.armbinder.equip tiedup:armbinder_equip_oneshot	on_equip of armbinder — the only equip one-shot any item declares	ONESHOT (full biped)	⚠️ Placeholder + renders on wrong layer
item.<item>.unequip e.g. item.armbinder.unequip	on_unequip event	ONESHOT (full biped)	❌ Missing — no item declares it
item.<bind>.equip straitjacket, shibari, …	on_equip for restraints other than armbinder	ONESHOT (full biped)	❌ Missing — product decision

armbinder.equip renders on the wrong layer

armbinder.equip currently renders on the wrong layer, so it will look wrong no matter how good the clip is — this needs an engine fix before authoring real art is worthwhile.

on_unequip is supported but no item declares it. Which binds get equip/unequip one-shots is a design choice — likely only ceremonial restraints (armbinder, straitjacket, shibari), not instant-equip gags or blindfolds.

Useful to add (not yet available)

PROPOSED — none of these are SELECTED by the rig today

Everything in this section is a proposal: no row below is a state the rig currently selects + renders. The one partial exception is the gait/movement-style group right below — its gameplay (speed/jump/hitbox) already ships, but its animation route is deferred, so visually it is still a proposal. Each row is tagged pure-clip (an artist can deliver it alone, no engine work) or needs Java wiring (a new motion/route must land first — art is useless until then). These are additive suggestions, not the source-of-truth catalogue above.

Gait / movement-style — a sparse OVERLAY collection (DEFERRED) ❌ Planned

The WADDLE / SHUFFLE / HOP / CRAWL movement styles already affect gameplay (speed modifiers, jump suppression, crawl hitbox) and the active style is synced to every client — but the gait → animation route is deferred. So a waddling/shuffling/hopping bound player currently renders on the plain WALK base + the item’s arm overlay: the gait is felt (slower, no jump) but not yet seen. Authoring gait clips does nothing until the route lands.

The design: a sparse collection + fallback, owning the LEGS

When the gait route is built, a MovementStyle is an optional, sparse collection of clips — not a full per-style motion set. It overrides only the motions where the gait actually differs (mainly the moving gait — WALK); every other motion falls back to the base (idle, fall, swim, the poses) unchanged. This keeps a style cheap to author: a waddle only needs to supply a waddle-walk, nothing else.

It is orthogonal to the item overlay: the gait owns the LEGS, the item owns the ARMS. A bound player walking composes three layers — the plain WALK base, the item’s arm overlay (armbinder arms), and the style’s leg-gait overlay (waddle legs) — each on its own joints. This is why “bound” is just base + arm overlay [+ gait overlay later], never a monolithic per-state bound clip.

Proposed gait clip	What it is	How to provide	Wiring
base.gait.waddle	Side-to-side swaying walk (WADDLE style, severity 1) — overrides only the moving gait	(A) GLOBAL sparse collection, or (C) LEGS OVERLAY over WALK	Needs Java — the deferred style→gait route (reads the already-synced MovementStyle)
base.gait.shuffle	Tiny dragging foot-shuffle (SHUFFLE style; ankle-cuff / chained-feet)	(A) GLOBAL / (C) LEGS OVERLAY	Needs Java — style→gait route; also implies a new ankle-restraint item (no item uses the LEGS region today)
base.gait.hop	Small forward bunny-hops (HOP style, auto-hop replaces jump)	(A) GLOBAL / (C) LEGS OVERLAY	Needs Java — style→gait route, ideally timed to the auto-hop cooldown
base.gait.crawl_move	Moving-on-all-fours crawl (CRAWL style, dogbinder) — distinct from the static POSE_DOG	(A) GLOBAL, or (B) per-item FULL_BODY on dogbinder	Needs Java — a moving-crawl branch (the dog pose currently has no moving variant)

New bondage states (need enum value + selection route + clip)

Proposed state	What it is	How to provide	Wiring
base.bound.pose_hogtie	Prone hogtie idle: face-down, wrists+ankles drawn together, conscious (distinct from sleep_bound / unconscious)	(A) GLOBAL, or (B) per-item FULL_BODY on a hogtie item	Needs Java — a new hogtie pose + a selection route
base.bound.pose_hogtie_struggle	Floor-bound wriggle/thrash while hogtied (on-ground analogue of the standing STRUGGLE)	(A) GLOBAL	Needs Java — depends on the hogtie route + a struggling-while-prone branch
base.bound.pose_suspension_idle	Hanging/suspended idle: arms up or body off the ground, slow sway, feet dangling	(A) GLOBAL pose, likely + (C) per-item OVERLAY for the cuff arm angle	Needs Java — a new suspension pose + a “anchored to a suspension point” detection route
base.bound.pose_suspension_struggle	Swinging/twisting struggle while suspended (pendulum sway, legs kick)	(A) GLOBAL	Needs Java — same suspension route
base.bound.pose_kneel_submission	Player submission kneel (head bowed) — the catalogue’s pose_kneel_bound is NPC-only	(A) GLOBAL (can reuse the NPC pose)	Needs Java — a player selection route for kneel (none returns a kneel for players today)
coop.carry.initiator / coop.carry.target	Over-the-shoulder / fireman’s carry — net-new coop role pair (mirrors coop.takedown)	coop POSITION+CLIP (two synced roles)	Needs Java — a new carry coop action + a sustained ride/attach state (heavier than the instantaneous takedown)

Pure-clip (artist can deliver alone, no engine work)

Proposed state	What it is	How to provide	Wiring
base.bound.bound_idle_fidget	Subtle passive bound idle — weight-shifts, tugging at restraints; replaces dead-still idle so a tied player looks restrained at rest. Not active struggle	(C) per-item IDLE OVERLAY (armbinder already binds IDLE this way) — or (A) global, which would need a minor route tweak	Pure-clip as a per-item overlay; minor Java only if you want it global-conditional
item.<head_item>.head_down_submission	Deeper bowed-head submission OVERLAY ([Head], optionally Chest), reusable across collars/leashes — distinct from the slight classic_collar.idle tilt	(C) per-item OVERLAY (NECK)	Pure-clip — same OVERLAY path classic_collar uses; only needs a trigger if it should be conditional rather than always-on

Reactions / recovery (need a new event or route)

Proposed state	What it is	How to provide	Wiring
reaction.jump_blocked	Short stumble/lurch when a jump-disabled style (SHUFFLE/HOP/CRAWL) eats the jump input	reaction ONESHOT (broadcast by id)	Needs Java — fire a synced reaction when a jump is suppressed
base.bound.landing_recovery_bound	Bound landing recovery — knees-buckle on hitting ground while restrained (complements the airborne FALL)	(A) GLOBAL	Needs Java — a bound-and-just-landed selection branch (LANDING_RECOVERY is never selected today)
reaction.fall_to_knees	Forced drop-to-knees for capture/enslave/punish climaxes — transitions into the kneel/submission pose	reaction ONESHOT	Needs Java — new event; must land in the kneel pose, so depends on the kneel route

Do NOT author (never selected)

These names are never selected by the rig — a clip you author for them will never play. Don’t author them.

• Declared but never selected: KNEEL (bound kneel uses POSE_KNEEL_BOUND on NPCs), SLEEP (asleep players route to POSE_SLEEP_BOUND), LANDING_RECOVERY, FLOAT, POSE_UNCONSCIOUS (see the Poses table above — not selectable yet). (RUN and SIT are not here — both are selected; they are simply not-shipped, like walk/jump.)
• Sentinels (not animations): ALL, INACTION, NONE — internal, never author.
• DEATH (the LivingMotion) is not a selectable motion. The death pose plays via a separate engine path, not as a selected LivingMotion. (Distinct from the death synced-action reaction above, whose clip you do author.)

Source of truth

This page is derived from the animation catalogue and the shipped synced_actions/*.json + action_events.json. When any of these states gets wired or authored, update the status badges here to match.