dayz-realistic-animation-director
Skill25 starsChanged yesterdayMITView on GitHub
Dirige de principio a fin la creación, corrección, pulido, exportación, integración y verificación de animaciones realistas para DayZ. Úsala cuando el resultado deba sentirse físicamente creíble en jugador, manos y armas, recargas, unstuck/unjam, locomoción, criaturas, ocupantes de vehículos, mecanismos, props o simulaciones; especialmente ante clipping, dedos cruzados, articulaciones sobreextendidas, contacto falso, objetos que no siguen la mano, stutter, loops defectuosos o discrepancias Blender-vs-in-game. Orquesta `blender-animation` para autoría y `dayz-animation-pipeline` para contratos del motor; no sustituye consultas puramente técnicas sobre config, ASI, skeletons o exportación.
In this repository47 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- 3d-generation-harnessSkill
- ai-3d-to-dayzSkill
- ardy-motion-generationSkill
- blender-animationSkill
- blender-assemblySkill
- blender-visual-reviewSkill
- dayz-3d-viewerSkill
- dayz-ai-patternsSkill
- dayz-animation-pipelineSkill
- dayz-aviationSkill
- dayz-basebuildingSkill
- dayz-charactersSkill
- dayz-clothingSkill
- dayz-doorsSkill
- dayz-environment-hazardsSkill
- dayz-feature-specSkill
- dayz-mcp-verifySkill
- dayz-mod-devSkill
- dayz-model-pipelineSkill
- dayz-mod-workflowSkill
- dayz-motorbikesSkill
- dayz-p3d-auditSkill
- dayz-p3d-inspectorSkill
- dayz-particlesSkill
- dayz-pbo-buildSkill
- dayz-pbo-reverse-engineeringSkill
- dayz-persistenceSkill
- dayz-physics-engineSkill
- dayz-preflightSkill
- dayz-proxy-alignSkill
- dayz-sound-systemSkill
- dayz-test-ingameSkill
- dayz-texture-pipelineSkill
- dayz-ui-developmentSkill
- dayz-undergroundSkill
- dayz-vehiclesSkill
- dayz-weaponsSkill
- enforce-script-referenceSkill
- mixamo-retargetSkill
- rigorous-data-auditSkill
- rip-vehicle-importSkill
- systematic-debuggingSkill
- task-observerSkill
- uv-clean-atlasSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
25 rules. About 0 are common, 20 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈20
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
Before acting, read authority-and-routing.md.
- Very specific: line 19
If the request is strictly technical —for example, choosing an AnimationSource, registering an .anm, or explaining an ASI state— let …
- Very specific: line 46
Always work from a versioned copy.
- Distinctive: line 47
If fixing a defect, first reproduce failure with current scene and preserve that RED evidence.
- Distinctive: line 48
Read project contract (current CLAUDE.md, product spec, plan, and handoff) when existing.
- Very specific: line 52
Ask dayz-animation-pipeline for applicable route and record:
- Distinctive: line 60
Do not hardcode 291 frames, 30 FPS, or SR2M notetracks for other animations.
- Distinctive: line 64
Read motion-quality-contract.md and create a per-task contract declaring only applicable modules:
- Distinctive: line 87
Do not advance to spline if a key pose already clips, is overextended, or misses target.
- Distinctive: line 92
Use timing, spacing, arcs, anticipation, overlap, moving holds, and settle according to physical intent.
- Distinctive: line 99
Run sampler and validator when Blender is available:
- Distinctive: line 116
look for clipping between keyframes, not only on key frames.
- Distinctive: line 117
check start/end against actual runtime entry pose.
- Very specific: line 123
Verify artifact actually deployed, not only source.
- Distinctive: line 124
Do not declare that Workbench, DayZATool, Blender MCP, or DayZ executed if no evidence of that execution exists in the session.
- Distinctive: line 130
Test stances, cameras, and states that might alter IK or blending.
- Distinctive: line 132
If in-game contradicts Blender, in-game rules and the case becomes a regression.
- Very specific: line 133
If environment does not allow testing, terminate in MANUAL_REQUIRED, not PASS.
- Distinctive: line 142
Always report which gates were executed, what evidence exists, what was omitted, and why.
- Distinctive: line 146
When a new defect appears:
- Distinctive: line 149
write a minimal fixture that fails for that reason.
- Distinctive: line 153
only then modify production animation.
- Distinctive: line 155
Run reusable suite with:
- Distinctive: line 223
Stop progression and request missing decision or evidence when:
- Distinctive: line 225
no input/output reference exists and a choice would alter choreography.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
DayZ Realistic Animation Director
Produce a credible animation and close its integration with honest evidence. This skill directs the work; Blender and DayZ skills retain technical authority.
Authority boundary
Before acting, read authority-and-routing.md.
- Invoke
blender-animationbefore operating on Actions, rigs, constraints, curves, renders, or export from Blender. - Invoke
dayz-animation-pipelinebefore deciding format, skeleton, export mask, FPS/frame budget, notetracks, anim graph/ASI, compile, wiring, or DayZ integration. - Invoke additional domain skill indicated in authority-and-routing.md for characters, creatures, vehicles, P3D, retargeting, or in-game test; then apply checks from domain-gates.md.
- In case of conflict, specialized authority wins. Record divergence and stop affected gate; do not invent a third rule.
If the request is strictly technical —for example, choosing an AnimationSource, registering an .anm, or explaining an ASI state— let dayz-animation-pipeline be the primary skill. Use this skill when authoring, evaluating, or improving motion.
Domain routing
| Animation | Skills added to director |
| Player, hands, custom human or infected | dayz-characters; for creatures verify first their actual bind/skeleton (in 1.30: no fixed index in skeletons.anim.xml, 250-bone limit removed) |
| Weapon, reload, unjam, or P3D mechanism | dayz-weapons if entity contract changes + relevant P3D/model skill (in 1.30: new bone remaps and dedicated ASI profiles) |
| Occupant, entry, or vehicle controls | dayz-vehicles (in 1.30: quad bikes + motorbikes MOTO1/MOTO2, 2-bone IK on handlebar) |
| Mocap/external donor | applicable retargeting skill; never without source→target map |
| Runtime test | active dayz-test-ingame/dayz-mcp-verify, with lease and lifecycle (in 1.30: Workbench Enfusion 2021 Live Editing) |
blender-animation and dayz-animation-pipeline remain mandatory for authoring and integration respectively; skills in the table do not replace them.
Three checks that never substitute for each other
- Full chain: measuring knuckles and tips does not validate intermediate phalanges. Sample all relevant segments and joints.
- Positive contact: "no penetration" does not mean "gripping". Require a contact pair, target surface/landmark, and distance band.
- Relative locking: sharing keyframes or a scalar curve does not prove two elements move together. Measure
T_actor^-1 * T_targetthroughout the entire grip window.
A reproducible visual failure from user or in-game invalidates any offline PASS. Convert it into a fixture before authoring again.
Mandatory gated workflow
0. Preserve and observe
- Inspect scene, Actions, current frame, selection, constraints, and windows before mutating.
- Always work from a versioned copy; do not overwrite source
.blend. - If fixing a defect, first reproduce failure with current scene and preserve that RED evidence.
- Read project contract (current
CLAUDE.md, product spec, plan, and handoff) when existing.
1. Capture the DayZ technical contract
Ask dayz-animation-pipeline for applicable route and record:
- animation type and authoritative skeleton/rig;
- FPS, duration or frame budget, and loop rules;
- notetracks/events and runtime states;
- included/excluded bones and complete mobile objects/selections;
- artifacts for export, compile, wiring, build, and in-game test.
Do not hardcode 291 frames, 30 FPS, or SR2M notetracks for other animations. Each task obtains its active contract.
2. Define acceptance before posing
Read motion-quality-contract.md and create a per-task contract declaring only applicable modules:
- key poses and beats;
- joints/chains and calibrated limits;
- contacts, surfaces, and
contact_on..releasewindows; - prohibited collision pairs and permitted contacts;
- objects that must preserve relative transformation;
- intentional impact, snap, or sliding exceptions;
- actual entry/exit pose and in-game states to test.
Tolerances must come from reference, geometry, or an explicit decision. Never adjust threshold to make current candidate pass.
Every contract declares exactly contract_mode: "diagnostic" or contract_mode: "production"; missing or unknown values are errors. A contract capable of granting OFFLINE_PASS uses production. Each check declares provenance (source_kind, source, verified_date, method) and any segment_clearance check requires shared geometric provenance for capsule radii. A diagnostic contract may reproduce a failure, but eligible_for_offline_pass will always be false.
For a continuous window of contact, collision, locking, order, joint range, or continuity use consecutive frame_range with step: 1; production requires it. A sparse list of golden poses does not prove what happens between them.
3. Blocking
With blender-animation, author only golden poses: start, anticipation, contact, maximum effort, release, recovery, and end.
- Render each pose in on-axis view and at least one oblique view.
- Validate anatomy, silhouette, contact, and collision before interpolating.
- For hands, read biomechanics-and-contact.md and evaluate all five fingers, wrist, forearm, elbow, shoulder, and clavicle when part of the gesture.
- Do not advance to spline if a key pose already clips, is overextended, or misses target.
4. Motion and effort
- Apply blocking → spline → polish via
blender-animation. - Use timing, spacing, arcs, anticipation, overlap, moving holds, and settle according to physical intent.
- Validate position, rotation, velocity, acceleration, and jerk on relevant elements.
- Distinguish an intentional snap/impact via a declared window; outside of it, a spike is stutter.
- In mechanisms, move full hierarchy or functional selection, not only visual piece seen from a camera.
5. Offline audit
Run sampler and validator when Blender is available:
& $env:BLENDER_EXE --background '<scene.blend>' --python '<skill>\scripts\sample_blender_motion.py' -- --contract '<contract.json>' --output '<report.json>'
python '<skill>\scripts\validate_motion_contract.py' --report '<report.json>' --contract '<contract.json>' --output '<audit.json>'Interpret validator exit codes:
0: all required checks pass;1: valid input, one or more required checks fail;2: invalid contract, sample, or execution; no quality verdict.
In addition to JSON:
- review full video at real speed;
- review multi-angle renders of contact, extremes, transitions, and recovery;
- look for clipping between keyframes, not only on key frames;
- check start/end against actual runtime entry pose.
6. Exporta e integra
- Hand off Blender export to
blender-animationfollowing its active contract. - Hand off artifact to
dayz-animation-pipelinefor compile, ASI/config, build, and deploy. - Verify artifact actually deployed, not only source. In DayZ 1.30, animation graphs are structured into modular Enfusion Config
.agffiles indexed fromAnimSrcGraph.agr, and.asifiles useAnimSetInstanceSource. - Do not declare that Workbench, DayZATool, Blender MCP, or DayZ executed if no evidence of that execution exists in the session.
7. Gate in-game
Lee evidence-and-integration.md.
- Test stances, cameras, and states that might alter IK or blending. In 1.30, Workbench Animation Editor allows Live Editing on active clients for interactive visual debugging of transitions and graphs.
- Review RPT and compare timing, contact, clipping, and mechanical states against contract.
- If in-game contradicts Blender, in-game rules and the case becomes a regression.
- If environment does not allow testing, terminate in
MANUAL_REQUIRED, not PASS.
Output states
FAIL: at least one mandatory gate fails.OFFLINE_PASS: contract, scene, audit, renders, and offline artifact approved; game test pending.MANUAL_REQUIRED: next gate requires an action or tool that is unavailable.IN_GAME_PASS: deployed build and DayZ behavior are verified with evidence.
Always report which gates were executed, what evidence exists, what was omitted, and why.
Regression policy
When a new defect appears:
- freeze failed scene as read-only input;
- write a minimal fixture that fails for that reason;
- demonstrate RED;
- implement or tighten the check;
- demonstrate GREEN with a corrected sample to avoid a tautological test;
- only then modify production animation.
Run reusable suite with:
python '<skill>\scripts\run_regression_tests.py'To include the real SR2M fixture, define SR2M_V44_BLEND and add --real-fixtures. If variable is missing, correct result is SKIP_REAL_FIXTURE, not PASS.
DayZ 1.30
What changes in 1.30 for realistic animation direction
- Motorbike rider integration [EXACT]:
- Dedicated animation instances:
MOTO1 = 10(Jawa 50cc) andMOTO2 = 11(Jawa Bitrak tricycle) inexp\scripts\scripts\4_World\Entities\Vehicles\VehicleAnimInstances.c:13-14. - Third-person vehicle camera with elastic lag:
DAYZCAMERA_3RD_VEHICLE_MOTORBIKE = 32inexp\scripts\scripts\4_World\Entities\ManBase\DayZPlayer\DayZPlayerCameras.c:20. - Handlebar grip with continuous two-bone IK solvers (
AnimSrcNodeIK2andAnimSrcNodeIK2TargetinVehicles.agf) modulated by physical lean and roll variables (VehicleSteering,VehicleThrottle,VehicleSuspension). - Unified transition query via
HumanCommandVehicle.IsTransitioning()(exp\scripts\scripts\3_Game\human.c:735-738).
- Dedicated animation instances:
- Surrender refactoring [EXACT]:
- (Up to 1.29: surrendering physically created invisible
SurrenderDummyItemin hands; since 1.30: surrendering no longer putsSurrenderDummyItemin the hands (the class remains, marked obsolete,surrenderdummyitem.c:1-2, and only the obsoleteCheckEmoteLockedStatereads it,EmoteManager.c:1211-1214) and is natively governed viaPlayerBase.SetSurrenderState(bool)andMan.IsSurrendered()[exp\scripts\scripts\3_Game\Entities\Man.c:67,exp\scripts\scripts\4_World\Classes\EmoteManager.c:314, 1248-1250]).
- (Up to 1.29: surrendering physically created invisible
- Dynamic instance control and in-hands decoupling [EXACT]:
- Direct transition between animation instances at runtime with
Human.SetAnimationInstanceByName(string animationInstanceName, float blendingTime)(exp\scripts\scripts\3_Game\human.c:1384), backed by"Empty"profile registered inplayer_main.asi(DayZPlayerCfgBase.c:1548). - Decoupling of in-hands item swapping:
HumanItemAccessor.OnItemInHandsChanged(bool pInstant, bool pChangeAnimationInstance)(exp\scripts\scripts\3_Game\humanitems.c:112).
- Direct transition between animation instances at runtime with
- Per-stance camera rotation and speed limits [EXACT]:
HumanInputControllerexposesSetErectSpeedLimit,SetCrouchSpeedLimit,SetProneSpeedLimit, andDisableErectCameratHorizontalRotation[sic], etc. (exp\scripts\scripts\3_Game\human.c:230-243).
- Catalog of 11 new Full-Body actions [EXACT]:
CMD_ACTIONFB_COMBINATIONLOCK = 256toCMD_ACTIONFB_WETCLOTHWELL = 266(exp\scripts\scripts\3_Game\dayzplayer.c:889-899), including combination lock, mortar, brick stacking, and rope ladder.
- Skeleton de-indexing and creature kinematics [EXACT]:
- Removal of 250-bone limit; global indices resolved at runtime by name hash. In
skeletons.anim.xmlonlyEntityPositionretainsindex="0" movement="true" lod="0"(work\changelog-1.30-exp-modding.md:31,exp\anims_cfg\DZ\anims\cfg\skeletons.anim.xml:39, 986-988). - Procedural rotation in quadrupeds for terrain alignment:
AnimSrcNodeProcTransform AlignToTerrain_RotwithSlopeAngleX * 0.0174532925...(exp\animals\DZ\animals\animations\!graph_files\wolf\wolf_maingraph.agf:5-18). - New mental state for infected:
MINDSTATE_COWER(exp\scripts\scripts\3_Game\Entities\DayZInfected.c:18).
- Removal of 250-bone limit; global indices resolved at runtime by name hash. In
- Integration tools and physics in Workbench [EXACT]:
- Workbench Animation Editor updated to Enfusion 2021 with Live Editing of graphs on running clients (
work\changelog-1.30-exp-modding.md:48, 62). - Workbench Ragdoll Editor to configure and edit
.ragdollfiles (work\changelog-1.30-exp-modding.md:47). - Native separation between animated death and ragdoll in scripts:
PhysicsSetSimpleDeath(bool)vsPhysicsSetRagdoll(bool)(exp\scripts\scripts\3_Game\human.c:1448-1452).
- Workbench Animation Editor updated to Enfusion 2021 with Live Editing of graphs on running clients (
What breaks in 1.29 contracts and assets and how to migrate
| Broken element | Cause in 1.30 | Required action |
Monolithic proprietary .agr graphs | Format replaced by modular Enfusion Config .agf text files (Locomotion.agf, Vehicles.agf, etc.) [EXACT: player_main.agr:1587] | Re-export workspaces from Workbench Animation Editor 2021 or reconstruct modifications in text across corresponding .agf modules. |
.ast templates with anonymous groups | Removed support for $groupType { #ngroupnames 0 ... } [EXACT: changelog:42] | Assign each group an explicit Name attribute (Name "Default", Name ".unnamed"). |
.asi files with $animsetinstance syntax | Migrated to AnimSetInstanceSource class [EXACT: anims_cfg.diff:624] | Convert #template/#parent/$animations directives to Enfusion Config structure. |
Buffer Save / Buffer Use nodes | Eradicated completely from animation engine [EXACT: changelog:41] | Replace buffer logic with control variables in ControlTemplate AnimSrcGCT or direct state machine connections. |
SurrenderDummyItem dependency | Dummy no longer created in hands [EXACT: 1.29 EmoteManager.c:309 created it; since 1.30 only the obsolete check at EmoteManager.c:1214 reads it] | Replace item-in-hands checks with calls to PlayerBase.SetSurrenderState(bool) and IsSurrendered(). |
Fixed indices in skeletons.anim.xml | Manual indices ignored except on EntityPosition [EXACT: changelog:43] | Remove index attributes from XML; ensure exact name match with .xob model. |
Migration checklist for animation director
- Weapon mappings: Verify whether weapon or interactive prop uses new remaps (
LugerBoneRemap,LeeEnfieldBoneRemap) or dedicated.asi(bandage.asi,hayhook.asi, etc.). - Vehicle occupants: On motorcycles, audit relative locking of both hands to handlebars (
AnimSrcNodeIK2) and feet to footrests across all phases ofHumanCommandVehicle.IsTransitioning(). - Surrender: Confirm no offline check or fixture assumes a virtual item in hands during surrender state.
- Creature terrain: Check that animal paw contacts include procedural angular offset of
AnimSrcNodeProcTransformagainst slopes (SlopeAngleX). - Templates and Instances: Audit that delivery
.astfiles declareNameon all groups and.asifiles useAnimSetInstanceSourceclass. - Live validation: Leverage Workbench Enfusion 2021 Live Editing to verify continuous blend parameters on active client before final packaging.
Resource index
- authority-and-routing.md — authority, precedence, and skill selection.
- motion-quality-contract.md — sample/contract format and catalog of checks.
- biomechanics-and-contact.md — anatomy, contact, self-collision, and synchronization.
- domain-gates.md — checks by animation domain.
- evidence-and-integration.md — offline evidence, export, deploy, and in-game.
scripts/sample_blender_motion.py— Blender → neutral JSON report.scripts/validate_motion_contract.py— report + contract → deterministic audit.scripts/run_regression_tests.py— synthetic and optional real fixtures.
Stop conditions
Stop progression and request missing decision or evidence when:
- no input/output reference exists and a choice would alter choreography;
- current pipeline and a reference disagree on skeleton, export mask, or runtime state;
- full mechanical part cannot be identified;
- a tolerance can only be chosen by looking at candidate intended to pass;
- offline gate passes but visual or in-game review fails;
- integration test requires an unavailable tool or permission.
Building, testing and publishing the mod
When this work has to end in a mod that builds, loads and ships (config.cpp/CfgMods, requiredAddons, the PBO and its signature, a boot on a local server, the Workshop), follow the loop and the rules every mod task needs in dayz-mod-dev, the Pack's entry point for mod development.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

