The timeline under the model plays its animations, and the two rows under it edit the clip that is playing. Pose mode turns bones on the model itself, and the dope sheet shows and edits every key.
To bring in an animation from a file, see Importing animations.
The timeline
- The animation list picks an animation, by the name the client gives it. Idle, walk and run come first where the game names them.
- Play and pause, or press Space.
- Step one frame back or forward with the buttons, or the Left and Right arrow keys.
- Drag the timeline to scrub through the animation. Ticks under it mark each frame.
- Loop repeats the animation, or stops it on its last frame.
- The speed list runs from 0.1x to 2x. It only changes how fast Studio plays the clip; use the edit row's speed to change the clip itself.
The line beside the timeline shows the time and the frame you are on, and the line under it the animation's file.
Models without animation
Some creatures have no animations, and some items do. The timeline says so when a model has none.
Editing a clip
The edit rows work on the clip that is playing. Nothing is written until you save, and the model plays the edit exactly as it will be written.
| control | does |
|---|---|
| In, Out (or I, O) | set the start and end of the part to keep, at the playhead |
| the speed list | play the clip from 0.25x to 4x as fast |
| Key rate | frames a second in the saved clip, from 10 to 60 |
| undo, redo | step back and forward through your edits |
| Reset | back to the whole clip at its own speed, with no edits |
| Reverse | play the edit backwards; press it again to turn it back |
| Splice | add another clip of this body |
| Make loop | blend the end of the clip into its start, so it loops without a pop |
| Bone, Key | turn one bone at the playhead |
| Keys | move or remove the bone keys you have added |
| Export glTF | write the model with the edited clip to a .glb |
| Save clip, Save as new | write the edited clip in the game's own format |
Beside the In and Out buttons is the kept range in seconds, and after the speed and rate the length and frame count the edit comes to. That line changes color once the clip differs from the game's.
When the model view is narrow, the buttons wrap onto a second row and whatever still does not fit moves into the ⋯ menu at the end.
Trimming and retiming
Play or scrub to where the kept part should start and press In (or I), then to where it should end and press Out (or O). The yellow markers can also be dragged. The speed and the key rate together set how many frames the edit has; the length is rounded to whole frames.
The timeline while you edit
Once a clip is edited, the timeline spans the edited clip: dragging it shows the edited frames, Left and Right step through them, and the readout shows the edited time and frame. A thin strip under it spans the original clip, with the In and Out markers and a dot at the original frame playing. Drag a marker there to move it.
Reverse and splice
Reverse turns everything edited so far around, spliced clips and keys included.
Splice lists the body's clips, the one playing included. Choose one to add it after the kept range. In the same menu:
- Insert at the playhead puts it at the playhead instead of the end.
- Blend 0.15s at each seam eases from one clip into the next, so the join does not snap.
A clip from a body with a different skeleton is refused.
Layering a clip over part of the body
Layer plays another clip on some bones only, over this clip's own motion: an attack's arms over a walk's legs, or a wave over an idle. Pick the bone the layer starts from in the timeline's Bone list, such as a spine or upper-arm bone, put the playhead where it should begin, and choose the clip from Layer. That bone and everything below it take the other clip's motion from the playhead for that clip's length, while the rest of the body keeps its own. Fade 0.2s in and out eases the layer in and out instead of cutting to it.
The same menu lists each layer with its clip and times, to remove it. Layers are saved in the game's own clip format, like every other edit, and keys you add afterwards go on top of them. A creature that animates without a skeleton takes no layer.
Changing many clips at once
Batch clips, on the model's Animation tab, changes every clip that matches a pattern in one go: type WALK*, or words such as idle stand, or leave it empty for every clip. Choose a speed, a loop blend and whether to reverse them, then Preview to see each clip's length before and after, and Write to save them all into the project in the game's own format. Each clip keeps its own edits, with the batch's change on top. Switch on Save as new clips beside them and give a name ending, such as _FAST, to keep the originals and add new clips. World of Kung Fu creature clips are saved one at a time.
Making a clip loop
A walk or an idle that does not end where it starts jumps every time it repeats. Beside Make loop is the clip's seam: how far the body moves between its last frame and its first, beyond an ordinary frame's movement, as a share of the model's size, and the bone that moves the most. Green is under 1%, yellow under 5%.
Choose Make loop and how long the blend should be, from 0.1 to 1 second. Over that last stretch the clip eases into its first frame, keys included, and the button then shows the blend. Choose No loop blend in the same menu to take it off. A spliced or reversed clip loops as it now plays.
The blend brings the whole body back, the root included. If the seam says travels, the clip moves the model forward as it plays, and a loop blend pulls it back to where it started; leave such a clip unblended unless the game expects it in place.
Bone keys
Pick a bone from the Bone list, put the playhead where the turn should peak, and choose a turn of 15 degrees either way about X, Y or Z from the Key menu. The turn eases in and out over a quarter of a second. Keys on the same bone at the same moment add up, so choose a turn twice for 30 degrees.
Keys lists every key you have added, with its bone, time and angles: move one to the playhead, or remove it.
An AI assistant connected to Studio can key any angle and a move as well as a turn; see Working with an AI assistant.
Undo and history
Undo and redo keep the last 50 steps of each clip. The history is kept in the project between sessions, so a clip you were editing yesterday opens with its edits and its undo list. Saving over the clip's own file clears its history.
Pose mode
Pose mode keys a bone by dragging it on the model.
- Choose the bone button on the timeline's transport row, or press P. The skeleton is drawn over the model: the picked bone in yellow, bones with keys in orange.
- Click a bone to pick it. The timeline's Bone list follows, and picking a bone there picks it on the model.
- Put the playhead on the frame the pose belongs to, and drag the gizmo at the bone's joint.
| key | does |
|---|---|
| P | pose mode on or off |
| E | the turn gizmo (the default) |
| W | the move gizmo |
| I | IK: drag a hand or foot and the limb follows |
| Ctrl while dragging | turn in 15° steps |
| Shift while dragging | finer movement |
| Esc during a drag | cancel the drag |
Each drag writes one key at the playhead's frame, as one undo step. Where the bone already has a key on that frame, the drag adds to it. The gizmo follows the bone's own axes; Pose gizmo in world axes, in the dope sheet's Keys menu, lines it up with the world instead.
- A key turns or moves a bone. Scaling is refused, because none of the games' clip files Studio writes takes a scale key.
- On Gate to Heavens only the root bone takes a move.
- Studio measures how the bone turns at the start of each drag, which takes a moment on a long clip.
- Every refusal the Key menu gives also applies here, and is shown as a message.
Reaching with IK
With IK on (press I in pose mode, or the link button beside the pose button), pick a hand or a foot and drag it to where it should be. The arm or leg follows: the shoulder and elbow, or hip and knee, turn so the hand or foot reaches the point, and the elbow or knee keeps bending the way it already did. Past the limb's reach, it straightens toward the point.
The drag keys both parent bones at the playhead's frame, as one undo step. The hand or foot keeps its own key, so it turns with the forearm or shin; turn it afterwards with E if it should point somewhere else. IK only turns bones, so it works on Gate to Heavens limbs too.
To stop a foot sliding, pick it, put the playhead where it lands and choose Hold … in place for N frames (IK) from the dope sheet's Keys menu. Studio keys the leg on each of those frames so the foot stays exactly where it was, as one undo step, and the leg eases back into the clip's own motion afterwards. It takes a moment on a long hold.
The pose library
The Pose library, at the top of the model's Animation tab, keeps poses to reuse. Type a name and choose Save pose to keep the pose at the playhead. Later, on any frame of any clip, and on any model with the same skeleton, choose Apply beside a saved pose to key every bone that differs from it, as one undo step. Mirrored applies it with left and right swapped, so a pose keyed on the right hand works for the left. Switch on Apply to the picked bone and below only to apply just a hand, an arm or a leg.
Each line says how many of the pose's bones this skeleton has. A pose keeps the body's shape, not where it stands: the clip still decides where the model is and which way it faces. Poses are kept on this PC, per game.
Onion skin
The eye button beside the pose button shows ghosts of the frames around the playhead while the clip is paused: the frames before it in blue and the frames after it in orange, fainter the further away they are. Each ghost shows where the body will be, with its skeleton on top, so you can see the arc a pose is part of as you key it.
Right-click the eye button to choose 1 to 4 ghosts each side, and how many frames apart they are. When the transport loops, the ghosts wrap round the ends of the clip. On a very detailed model only the ghost skeletons are drawn. The onion skin hides while the clip plays and while you edit the model's mesh, and creatures that animate without a skeleton have none.
The dope sheet
The chevron button on the transport row opens the dope sheet under the timeline. Studio remembers whether it is open.
- The ruler is in seconds of the edited clip; drag it to scrub.
- The marker lane shows the clip's event markers (below).
- A row per bone that has keys, plus the picked bone, with a diamond for each key.
- The curve of the picked bone's turn over the clip, in degrees about X (red), Y (green) and Z (blue). It is for reading only.
- The key panel edits the first picked key by number: its turn in degrees, its move, its fade and its curve. A number takes effect on Enter or when you leave the field.
Picking and moving keys
| control | does |
|---|---|
| click a key | pick it, its bone and its time |
| Ctrl + click, Shift + click | add a key to the picked ones |
| drag picked keys | move them, by whole frames |
| drag on empty space | pick the keys in a box |
| Delete | delete the picked keys |
| Ctrl + C | copy the picked keys |
| Ctrl + V | paste them at the playhead |
| Ctrl + Shift + V | paste them mirrored, left for right, at the playhead |
| Ctrl + Z, Ctrl + Y | undo and redo, while the pointer is over the sheet |
A key moved or pasted onto another key of the same bone replaces it.
The Keys menu
Right-click the sheet, or choose Keys at its top left, for:
- Copy keys, Paste at the playhead, Paste mirrored at the playhead and Delete keys.
- Mirror onto the twin bones: copies each picked key from a left bone to its right twin, or the other way, at the same time. A centre bone mirrors onto itself. A side bone whose twin is not in the skeleton is refused.
- Curve: how the bone moves from this key to its next one. Smooth (the default), Linear, Ease in, Ease out or Hold.
- Fade: how long the bone eases in before its first key and out after its last, from 0 to 0.5 seconds. Fade 0s holds the pose out to the edge of the clip.
- Flip the whole clip into a new clip, over itself, or to glTF (below).
- Pose gizmo in world axes.
- Graph editor: swaps the bone rows for a large graph of the picked bone's keys (below).
The graph editor
The graph editor draws the picked bone's motion over the clip as three lines, one each for X (red), Y (green) and Z (blue), with every key as a point on each line. Choose Turn or Move beside the graph to see the turns in degrees or the moves, and switch off an axis to hide it.
- Drag a key's point up or down to change that value. Hold Ctrl to step by 5 degrees (or half a unit for moves), or Shift for fine changes.
- Drag it sideways to move the key in time, by whole frames.
- Double-click an empty part of the graph to add a key there.
The model shows the change while you drag, and each drag is one undo step. The key panel on the right still edits the picked key by number.
Event markers
- Gate to Heavens clips carry two event markers:
eop, where the playable part of the animation ends, andeoa, where the animation ends. Drag one along the marker lane to move it; Save clip writes it. - World of Kung Fu creatures show their timed events, such as the moment an attack lands. They are for reading only, and Save clip moves them with your edit.
- RF Online clips carry no markers.
What each game supports
| model | trim, retime, reverse, splice, loop | bone keys and pose mode | save in the game's format |
|---|---|---|---|
| RF Online characters and creatures | yes | yes, with the limits below | yes |
| Gate to Heavens characters and creatures | yes | turns; a move only on the root bone | yes |
| World of Kung Fu characters | yes | turns and moves | yes |
| World of Kung Fu creatures and NPCs | yes | no | Save clip only |
When a clip cannot be saved in the game's format, the edit row says why, and Export glTF still writes the edit. An item without a skeleton has no clip.
RF Online limits
- A clip can be at most about 13.6 seconds long. An edit that would run longer is refused, unless the original clip was already longer.
- Keying a bone the clip has no track for adds one to the clip. A bone the clip marks as held still is refused, because the game draws it still whatever the keys say.
- Both rules hold for every RF Online version Studio supports except 1.0.5, on the client builds Studio was measured against. On 1.0.5, or a client Studio only recognizes as close to a version, a key on a bone with no track is refused and the refusal says "this client".
- A few bones whose rest pose is skewed refuse a turn the clip does not already key.
- Studio's preview still moves some bones a clip marks as held still, and a splice can copy such a bone's motion into a track the game does play. Check an RF edit in the game before you rely on it.
Gate to Heavens limits
Turning a bone swings every bone below it, as the game does. A bone with no keys in the clip, or one with such a bone below it, cannot be keyed. Where a skeleton repeats a bone's name, a key turns every bone of that name.
World of Kung Fu creatures
A creature's or NPC's animations are stored inside its mesh file, as whole frames of the mesh rather than bones. Trimming, retiming, reversing, looping and splicing another of its own clips all work, and Save clip writes the edit back into that file, moving the creature's timed events with it.
- There are no bones, so a creature takes no bone keys and no pose.
- There is no Save as new: the game asks for a creature's clips by name, so a copy under another name would never play.
- A few files hold the same animation more than once. Where the copy Studio shows is not the one the game plays, the timeline says so and refuses the edit.
- No edited creature clip has been played in the World of Kung Fu client yet. Check one in the game before you rely on it.
Saving and exporting
- Save clip writes the edited clip over the game's file, in the project's client files. The model rebuilds from it, and Install puts it in the game. See Projects and Install.
- Save as new writes it beside the original under a new name, the original's with
_EDIT1(then_EDIT2and so on) added. RF creatures list a clip under a new name straight away. Anywhere else the game finds clips through its own tables, so a new name is a file for you to wire up. - Export glTF writes the model with the edited clip to a
.glbin the capture folder. See Screenshots, GIFs and glTF export. - Flip the whole clip, in the dope sheet's Keys menu, mirrors the edited clip left for right, every side bone taking its twin's motion. Into a new clip writes it in the game's own format beside the original, named with
_FLIP1(then_FLIP2and so on) added; over itself replaces the clip's file (choose it a second time to confirm) and drops its edit history; to glTF writes a.glbin the capture folder. A flipped Gate to Heavens clip does not keep editedeop/eoamarkers.
To change a clip in Blender instead, see Editing in Blender.
To check a saved clip against the game's, use Compare with the original.
Animation and the other tabs
Effects attached to a model, and a spell you are playing, pause and step with the animation, so a paused frame is a paused frame everywhere. An Animation GIF on the Capture tab records the animation once through; see Screenshots, GIFs and glTF export.