Animations
Animations opens the files that decide how a character, an infected or an animal moves: animation graphs, anim sets and clips. You use it to study how the game's own creatures are set up, to edit the graphs and anim sets of your mod, and to play a clip on a skeleton. To browse the game's files you need the DayZ folder set in Settings; to list your own you need a workspace folder (also in Settings).
The page is marked Preview in the rail. Reading works on the game's files: graphs and anim sets open with everything they reference, the validation runs across them, and clips play on a skeleton. Editing graphs and anim sets works and saves with a backup, but files edited here have not been checked in the game: test them in game before you rely on them. Clips can be looked at, not edited.
The screen
- Header: status badges (errors or warnings, modified files, read-only files), Undo, Redo, Reload, Save. The subtitle names the open file and how many files were loaded with it.
- File list (left): the Workspace / Game switch, a folder button to open a file from disk, Rescan, and a search field. Game lists the
.aw,.agr,.asiand.astfiles inside the game's PBOs (the archives the game ships its files in); clips (.anm) are added once you type 3 letters, because there are thousands. Click a row to open it. - Centre, nothing open: what the page opens, with buttons to open an example or a file.
- Centre, graph or anim set open: four tabs.
- Graph: the node canvas of one sheet, with a bar to choose the sheet and add a node or a sheet. Double-click a state machine (a node marked with a square) to see its states and transitions; the bar then adds states and transitions.
- Variables & commands: the variables (name, type, default, min, max) and the commands of the graph, with fields to add one.
- Anim sets: on the left the groups of the template; on the right the slot table of the chosen instance: each slot, the clip assigned to it and its state.
- Problems: what the validation found. Click a line to go to the node, variable or slot.
- Inspector (right, graph or anim set open): the properties of what you selected: name, values, lists, and for a node its inputs with Connect and Disconnect.
- Centre, clip open: a bar with the format, frame rate, frame, bone and event counts, the preview model and a Turn slider; the skeleton preview; the timeline with play, frame stepping, speed and event marks.
- Bones (right, clip open): the bones of the clip with their key counts. Click one to highlight it and show its key tracks under the timeline.
First steps
- Leave the list on Game, type
cowin the search field and clickcow_sample.aw. - The Graph tab opens on the sheet "Master". Drag the background to pan, use the wheel to zoom.
- Click a node: the inspector shows its class and properties. Its inputs are listed at the bottom; click an input's name to jump to that node.
- Choose another sheet in the list above the canvas ("Startled" is the largest).
- Open Variables & commands: three variables and two commands. These are what scripts use to drive the graph.
- Open Problems: the sample has none.
Take the tour (in the app)
Common tasks
Play a clip
- In the Game list, type at least 3 letters of the clip's name (for example
walk_fast) and click an.anmrow. - Press play, or drag the frame slider. The marks under the slider are events; hover one for its name and frame.
- If the skeleton looks wrong, choose the matching model in "Preview on". The page picks the infected for
z_clips, the cow for cow clips and the player otherwise. - Click a bone on the right to see its translation, rotation and scale keys.
Take the clip tour (in the app)
See which clip an action uses
- Open an anim set instance (
.asi) or a workspace that lists one. The page opens on the Anim sets tab. - Type part of a slot or clip name in the filter of the slot table.
- Click the play button at the end of a row to open that clip.
Find broken references in your anim set
- Open your
.asi(or your.aw). - In the slot table, click the filter Clip not found: these slots name an
.anmthat exists neither in your project nor in the game. - Click No clip to see the slots nothing fills. Lines that match no slot of the template are listed under the table.
Edit a graph of your mod
- Open your
.aw,.agror.agffrom the Workspace list or with the folder button. - On the Graph tab, choose a node class, type a unique name and click Node. Drag the new node into place.
- Select the node that should use it, type the new node's name in "Connect a node…" and click Connect.
- Check the Problems tab, then press Ctrl+S.
Work from a game file
- Game files open read-only: you can edit on screen, but Save stays disabled and a red badge names the read-only files.
- Extract the files into your project (the P: drive or a workspace folder) first, for example with the PBO Packer, then open your copies.
Examples
- Cow sample (in the app): Bohemia's sample workspace, five files. One graph file with four sheets, three variables, two commands. Its anim set is nearly empty; look at the infected one for that.
- Infected (in the app): a real setup, seven files: three graph files (locomotion, combat, interaction), seven sheets, eight commands.
- Infected anim set (in the app): the instance
infected_main.asiagainst a template of 321 slots. Try the filters of the slot table. - Cow walk (in the app): a 33-frame clip at 30 fps with
StepandFootDown…events. - Player climb (in the app): a player clip with step, jump and sound events, shown on the player skeleton.
Examples open from the game, read-only.
Concepts
- Anim workspace (.aw): the entry file of a setup. It names the graph, the anim set template, the instances and the preview models. Opening it loads all of them.
- Graph (.agr): the control side: the variables and commands scripts set, the list of graph files, and the anim set template the graph draws from.
- Graph file (.agf): the nodes, grouped in sheets. A node plays a clip slot (Source), mixes its inputs (Blend), chooses between them (Switch, GroupSelect) or holds states and transitions (StateMachine). Links go from a node to its inputs.
- Anim set template (.ast): the list of slots a graph can ask for, as groups × columns × animations. A slot is written
Group.Column.Animation. - Anim set instance (.asi): one line per slot giving the
.anmclip that fills it. An instance can inherit from parent instances: a slot it does not set is taken from them. This is how one graph serves many items or creatures. - Clip (.anm): a binary file with, per bone, translation, rotation and scale keys, plus events (footsteps, sounds) at given frames. The game's clips are in formats ANIMSET4, 5 and 6; the keys of ANIMSET4 clips are not decoded here.
- Event and sync tables (.ae, .asy): text files a graph refers to. The page loads them with the rest but has no dedicated editor for them.
- Resource references: files name each other as
{GUID}path. The page finds the file by its path and ignores the GUID, looking in your project first, then in the game data, then next to the opened file (the path joined to each folder above it), so a mod's own graph and template open together even when the mod folder is not a workspace. - Variables and commands: scripts drive a graph through them: commands are tested with
IsCommand(…)/GetCommandF(…), variables are used by name in conditions, blend weights and VarUpdate nodes. - How the game picks a setup: according to this project's format notes, infected and animal classes name their graph and default instance in an
enfanimsysconfig class (graphName,defaultInstance), and the player's instances per item in hands are registered from script (DayZPlayerTypeRegisterItems).
Reference: the Animation Editor pages of the Bohemia Interactive community wiki (DayZ Workbench).
Pitfalls
- Edits are not game-tested. The page writes only the lines you change and leaves the rest of the file byte for byte, but whether the game accepts an edited graph is for you to check in game.
- Legacy graphs. Files in the older
$AnimGraphsyntax open and save unchanged; the node canvas does not read them and says so. - Game files cannot be saved. Save is disabled while a modified file comes from the game data. Copy the files into your project first.
- Renaming. Renaming a node in the inspector also renames the links to it. Deleting one does not remove the links: they show up in Problems.
- Node names are unique in the whole graph, not per sheet: the Node button stays disabled while the name is taken.
- The clip preview is a line skeleton seen from the side you choose with Turn: no mesh, no blending between clips. A clip previewed on the wrong model looks broken.
- Someone else changed a file. If a file changed on disk after you opened it, Save stops and offers Reload or Save anyway. Every save keeps the previous files in
.beans-anim-backups/next to them. - The Game list is capped at 400 files per type: narrow the search to find a clip.
- Leaving the page keeps the open files, their unsaved edits and their undo history; playback pauses until you come back.
For agents
Tools of dzt that do the same work without the window:
anim_info: inspect an.aw,.agr,.agf,.ast,.asior.anm(file path or game virtual path such asdz\anims\workspaces\…): the files loaded, variables, commands, sheets and nodes, template groups, instance lines; for a clip its format, fps, frames, bones and events.anim_validate: the checks of the Problems tab over a setup and the files it references: dangling node links, transitions to unknown states, Source / GroupSelect names missing from the template, undeclared commands and variables (variables read by transition and state conditions included), duplicate node names, instance lines that match no slot, missing clips and missing referenced files. The same message from several transitions is listed once with its count.vfs_searchwith"ext"set toaw,agr,agf,ast,asioranm: find the game's files;vfs_readreturns the text of the text formats.
Files the page reads and writes:
- Reads the animation files of the workspace folders and of the game's PBOs, plus the files they reference, and the preview models (
.xob) for the skeleton of the clip viewer. - Writes only the modified text files that exist on disk (
.aw,.agr,.agf,.ast,.asi). Before writing, the previous version of each goes to.beans-anim-backups/<time>/next to it. Clips are never written. - The open files are watched: a change made by another program is reloaded (or announced, if you have unsaved edits).
What the page tells the assistant: the open file, the open clip if any, the current tab (graph, variables, sets, problems), whether there are unsaved changes, and the validation problems (errors and warnings). It offers the action "Explain this graph".
Anchors for guided steps: animations-save, animations-browser, animations-source, animations-open, animations-main, animations-tabs, animations-graph-bar, animations-graph, animations-slots, animations-inspector, animations-clip, animations-timeline, animations-bones.
See also
- Models: the skeleton and model.cfg of the model an animation plays on.
- Script Editor: the scripts that set the variables and commands of a graph.
- Config: the config classes that name a graph and an instance.
- PBO Packer: extract game files to work on copies, and pack your mod.
- The Workbench