🌀 Animation

animate applies animation data to .mcsb models.

The result is a .glb file with applied animation clips.

Find related assets

Animation and model can be located in different directories.

Paths below are relative to stalcraft/modassets/assets.

Operation	Animation files	Target models	Mappings
Arms	highpoly/animations	weapons/models highpoly/character_hands.mcsb	Arms Mappings
Face	highpoly/lipsync stalkerplayer/head_animations	stalkerplayer/heads stalkerplayer/arkit	Face Mappings
Body	highpoly/character customnpcs customitems	Mapped .mcsb files	Body Mappings

Arms

arms applies first-person weapon, item, and hands animations from .mcvd clips to .mcsb models.

Model and animation bones are matched by name.

Weapon animations use a weapon model and the shared hands model highpoly/character_hands.mcsb. Some animations use hands only.

For example

scfile animate arms "wpn_fp_akm.mcvd" "akm.mcsb" "hands.mcsb"
scfile animate arms "wpn_fp_akm.mcvd" "akm.mcsb"
scfile animate arms "wpn_fp_walkcycles.mcvd" "hands.mcsb"

Face

face applies facial .mcvd clips to a head .mcsb model.

Models are matched by morph channel names.

For example

scfile animate face "shaman.mcvd" "unique_shaman.mcsb"

Body

body applies skeletal .mcal clips to body .mcsb model.

Models are matched by bone index.

--raw keeps technical and duplicate clips.

Note

MCAL support remains experimental. The format and practical workflows are not yet fully understood. Report any problem or idea for improvement in Issues.

For example

scfile animate body "pack.mcal" "origin.mcsb"
scfile animate body "pack.mcal" "origin.mcsb" --raw