Classify the layer
- OAR condition and folder selection;
- animation file and annotation/event data;
- behavior graph source patch;
- Nemesis or Pandora generator input/output;
- BFCO or other combat-framework contract;
- native event hook or Papyrus listener;
- missing animation asset referenced by a behavior graph.
Missing HKX law
A missing .hkx and a missing/generated behavior entry are different failures.
For every missing animation path:
- normalize the relative path beneath
meshes; - identify the actor/creature behavior graph that references it;
- locate the owning mod through loose-file conflict data, archive inventories, and source manifests;
- check exact case and path;
- determine whether the file is:
- a shipped source asset;
- a generated behavior output;
- an optional patch asset;
- a stale reference to a removed animation;
- fix the owning source or dependency, then regenerate only when the generator actually owns the missing output.
An A-pose suppressor reports or mitigates the symptom. It cannot create a missing animation.
Custom creature paths such as Actors\<Creature>\Animations\... normally
require the creature mod's own movement set or a compatible creature behavior
patch. Nemesis/Pandora should not be prescribed as a universal cure because
they cannot invent absent custom assets.
Workflow
- Record exact framework and generator versions.
- Inspect source behavior/mod files, not only generated output.
- Resolve animation event names from source or known working files.
- Map conflicts by graph, node, annotation, condition priority, and output owner.
- Make one source-level change, regenerate, and compare outputs.
- Keep generated outputs in their own versioned mod.
- Test first/third person, sex variants, weapon classes, NPC/player paths, creatures, interruptions, paired animations, and relevant transitions.
- Route crashes to
skyrim-crash-diagnostics.
Validation
Run:
scripts\audit_missing_animations.py --log <APoseFix-log> --root <deployed-mod-root>
The script checks loose files and optional supplied archive-inventory text. It does not parse BSA archives and must label archive coverage accordingly.