Creating an animation rig in Blender

Introduction

This tutorial shows you how to create the animation rig for Blender (made by geyser), with some improvements.

The purpose of this rig is to give us much better tools to animate, compared to our previous process in Softimage XSI by EdT, which allowed us to animate exclusively with Forward Kinematics. While FK may work for simple, short animations done on characters with a small amount of bones, it does not work well for Oni characters and animations, as it's too labor-intensive and inefficient.

Prerequisite tutorials

I highly recommend watching the tutorials below if you feel you're lacking knowledge in any of these subjects:

General Blender basics:

• Wolf's 45-Minute Crash Course for Blender Virgins

Blender Character Rigging overview showing that you can create a Rigify rig in less than a minute at 5:43, and also rig a character while at it:

• Character Rigging - Blender 2.80 Fundamentals

Basics of using Rigify:

• Rigify Tutorial #08 - Posing the Rigify rig by CGDive

Rigify Bone Groups and Layers:

• Rigify Tutorial 7-1: Rigify Bone Groups and Layers (Overview) by CGDive
• Rigify Tutorial 7-2: Rigify Bone Groups and Layers (Practice) by CGDive
• Rigify Tutorial 7-3: Rigify Bone Groups and Layers (Advanced) by CGDive

Changing Rigify Custom Shapes and Widgets:

• Rigify - Custom Shapes/Widgets by CGDive

Blender custom properties and drivers (drivers in the rig described here are used to set the influence of its controllers' bone constraints through the Pose1 and Pose2 bone locations):

• Custom properties and drivers in blender made easy by Pierrick Picaut

Tracking constraint tutorials

These explain constraints like Damped Track which are used by Rigify – you can skip this if you want, but it might give you a better idea of how Rigify's MCH (Mechanical) layers work, or come in handy in the distant future; other than that, you don't need to know them to animate for Oni:

• Tracking Constraints - Blender 2.80 Fundamentals
• Camera Track To vs Damped Track Constraints | Pros & Cons Explained With Examples | Blender by 5 minutes Blender

Things to know before starting

There are several things worth knowing before you start creating the rig.

Tools and relevant tutorials

Screenshot showing Cmder's capabilities within the context of modding Oni

• Current version of OniSplit. This is the tool needed to import and export assets out of Oni. DO NOT USE OniSplit GUI or Vago for importing Oni assets into Blender - neither of these weren't updated in a long time, and thus they don't support OniSplit's v0.9.99.2 -blender option. You can still use them for other purposes though, such as sounds and converting .oni files to XMLs, etc.
• Cmder (Windows only) - because OniSplit is a command line tool, it is highly recommended to get any upgrade to Windows' Command Prompt. As shown in the screenshot on the right, Cmder allows you to start it from the context menu in any selected folder, and it also remembers your most recently used commands, vastly improving your workflow when you're forced to use any command line tools.
• Rigify - it's a plugin for Blender designed to automate a lot of rigging work. The rig described here is generated using Rigify.
• Oni-Blender tutorial by EdT. Please read this in entirety to know likely-to-happen issues and refer to this as your guide for OniSplit commands relating to Blender.
• Brief overview on creating TRAMs by EdT - while this was written with XSI in mind, this is still relevant as the process for preparing the XML files for Oni is still the same. Also the next post in that thread, called Brief walk through on modifying a TRAM, is an example of that overview put into practice.

Rotation order issue between Oni and Blender

Please refer to THIS.

Broken alpha transparency and textures on animated models

Please refer to THIS.

Importing animations and preparing the Blender scene

The actual tutorial starts here.

For detailed explanation of the required OniSplit commands, please refer to the Oni-Blender Tutorial by EdT listed in the Tools and relevant tutorials.

Expected result by the end of this header

1. Using OniSplit, export any character you want as a DAE (-extract:dae) using -noanim and -blender arguments.
   1. As per EdT's Oni-Blender Tutorial, you should get AnimationDaeWriter: custom axis conversion in OniSplit output if you've used the -blender argument. If you didn't get that on the output, it means something most likely went wrong and you won't be able to import the model into Blender (or you will be able to import it but it will be wrong).
   2. Assuming you wanted a textured model and thus you've exported an ONCC, you should now get a DAE file and an images folder containing the textures for it.
2. Using OniSplit, export any two animations as an XML (-extract:xml) using -noanim (T-Pose), -anim-body (lets you specify the character you want) and -blender arguments.
   1. You should get one DAE and an XML file for each animation, totalling four files.
3. Open up Blender and set your scene's frame rate to 60 FPS. If you don't, the keyframes of the imported animations will get tightened up together, because Blender's default scene framerate is 24 FPS.
4. Import the -noanim model into Blender first (MAKE SURE YOU CHECK THE Import Unit BOX, otherwise you will import the model with arbitrary units which will break everything and will be basically unadjustable later)
5. Import the animations into Blender (ALSO MAKE SURE YOU CHECK THE Import Unit BOX EACH TIME)
6. At this point the -noanim/T-posed model in the scene should have no suffix in its body part names, while the animated models should have .001 and .002 suffixes. This is intended; the T-posed model will serve for building the metarig and editing the rig once it's generated, while the animated models are needed for pose matching purposes, where the suffixes are useful for setting up the bone constraints.
7. Create three new collections in the Outliner, name them T-pose, Pose 1 and Pose 2. These three collections allow you to quickly hide the respective models from the Viewport using the eye icon in the Outliner.
   1. Move the T-Posed model to T-pose, and move .001 and .002 animated models to Pose 1 and Pose 2 collections respectively.
8. If you've imported the textured model, apply textures to the animated models and fix the alpha transparency issue.
9. At this point, your scene should look as shown in the screenshot on the right.
10. You can hide the Pose 1 and Pose 2 collections - they won't be needed until later in the tutorial.

Adjusting T-posed model's Z location

At this moment the T-posed model is sunk to the ground. That's because the pelvis location is set to 0,0,0. All of the animations in Oni have their heights adjusted (through the <Height> tags) so that the pelvis is roughly at Z ~ 0.9, so that the characters appear standing on the floor instead of, again, sinking into it. For this reason, we want to adjust the position of the pelvis so that the feet soles are aligned with the floor.

Expected result by the end of this header

10. Adjust the Z position of the T-posed model's Pelvis in one of the two ways:
1. Simply switch to Front Ortographic view (Num 1) and move the Pelvis along the Z axis so that the feet soles are roughly aligned with the floor. This will work, but if you want 100% accuracy, use the method below.
2. The 3D Cursor method:
   1. Select one of the feet in Object mode.
   2. Switch to Edit mode.
   3. Select one of the lowest-reaching vertices on the foot and Snap Cursor to Active. (Shift + S, 3)
   4. Switch back to object mode.
   5. Select the Pelvis.
   6. Snap Selection to Cursor. (Shift+S, 8)
   7. Set the X and Y locations of the pelvis to 0.
   8. Invert the Z location of the pelvis.
   9. The pelvis should be now at Z ~ 0.9 with feet soles perfectly aligned with the floor.
11. At this point, your scene should look as shown in the screenshot on the right.

Creating the Rigify metarig and adding limb flexion

This part describes how to create a Rigify metarig and how to adjust it so that it matches the T-posed model body parts.

12. Before you proceed to create the rig, you need to add small rotations to the limbs, which will allow Rigify to know in which direction the elbows and knees are going to bend. Otherwise, the rig will not function properly.
1. Add the following Z rotations to the respective body parts in accordance with the list below:

Z rotation	Bones
-5	right_thigh left_thigh
-10	right_calf left_calf right_wrist left_wrist
5	right_biceps left_biceps right_handfist left_handfist right_foot left_foot

13. Enable Rigify in Blender if you haven't already - you can do that by going to Edit / Preferences / Addons and looking it up, as Rigify comes with by Blender by default.
14. Add a Basic Human Metarig to the scene. ( Add Menu / Armature / Basic / Basic Human (Meta-Rig) )
    1. Scale the rig by 10 or so that it's roughly the size of the character.
    2. Apply the scale. ( Object / Apply / Scale )
15. Go to Metarig's Object Data Properties tab and:
    1. Open Viewport Display,
    2. Check "In Front" box to make the metarig easier to select when your Viewport is in Solid or Material Preview shading modes,
    3. Check the Axes box to see the local axes of each bones - this makes their rolls easier to understand.
16. Remove the following bones from the Metarig:

• pelvis.L
• pelvis.R
• breast.L
• breast.R
• spine.005
• spine.006

17. Go to Edit mode, select Bone Properties tab and change the Connected box of the following Metarig's bones accordingly to the below table:

Bone	Connected
spine.003	Disable
spine.004	Enable
shoulder.l	Enable
shoulder.r	Enable

18. The default Rigify bone layer order is highly unergonomic. For this reason, reassign the following bones to bone layers in accordance with the table below. You can reassign bones' bone layers by selecting them and pressing M. Make sure you have enabled User Tooltips in Preferences / Interface - that way when you move your cursor over the layer box, a tooltip will display the layer number.

Bones	Bone layer
spine spine.001 spine.002 spine.003 spine.004 shoulder.l shoulder.r	8
upper_arm.L forearm.L hand.L	0
upper_arm.R forearm.R hand.R	16
thigh.L shin.L foot.L toe.L heel.02.L	4
thigh.R shin.R foot.R toe.R heel.02.R	20

19. Go to Pose mode, select Bone Properties tab and open the Rigify Type box.
20. Set Limb Segments and B-Bone Segments to 1 on the bones listed below. Because Oni uses rigid body parts, Limb Segments and Bendy bones are not needed.

• upper_arm.L
• upper_arm.R
• thigh.L
• thigh.R

20. Disable Assign Tweak Layers checkbox on the bones listed below.

• upper_arm.L
• upper_arm.R
• thigh.L
• thigh.R
• spine

21. Remove rig type on the spine.004 bone.
22. Set rig type on spine.003 bone to spines.super_head.
23. Enable the Connect chain checkbox on the spine.003 bone.
24. Disable the Widget checkbox on shoulder.L and shoulder.R bones.
25. Set pivot_position on the spine bone to 1.
26. Enable the Custom Pivot Control checkbox on the spine bone.
27. Assign Tweak Layer of spine.003 to 9.
28. Assign FK layers for the following bones in accordance with the table below:

Bones	Bone layer
spine spine.003	9
upper_arm.L	1
upper_arm.R	17
thigh.L	5
thigh.R	21

29. Now you need to adjust metarig's bones so that they match up with character body parts. In order to reduce the amount of needed work, switch to Edit Mode and check the X-Axis Mirror either in Options or the Tool tab.
30. Switch to Object mode and using the Snapping Cursor to Active, and Snapping Selection to Cursor in the Snap menu (Shift + S), keep snapping cursor to model's body parts, selecting the Metarig, switching to Edit mode, selecting the appropriate bone and snapping it to 3D Cursor. I believe it is intuitive which bones should be snapped to which body parts, therefore there is no need for a table describing that, with the exception of hints on what should be done about spine.004, hand.L, hand.R, toe.L, toe.R, heel.02.L and heel.02.R.
    1. There is actually nothing you need to do about the heel bones, leave them as they are.
    2. Snap the tails of spine.004, hand.L and hand.R to their heads and move them along the axis they're pointing at, to some whatever point that makes sense to you, e.g. furthest reaching vertex on the hand. No need to be precise here, and thus snapping - just move the tail so that it is roughly where you want it to be.
    3. In order to keep the toe bones aligned and properly positioned, do the following for each toe bone:
       1. Select the foot in object mode,
       2. Snap cursor to the furthest and lowest reaching vertex on the foot,
       3. Copy the X location of that vertex,
       4. Snap the bone to cursor,
       5. Paste the X location to the bone's head,
       6. Snap bone's tail to the head,
       7. Move the head along the Y axis by some amount will make it easy to select but not too big.
31. In edit mode, set the following rolls for the Metarig bones as described below (if you don't, body parts, mainly shoulders, will get badly rotated after constraining them to the rig after its generation):
    1. shoulder.L, 90 degrees,
    2. shoulder.R, -90 degrees,
    3. All other bones, 0 degrees.
32. Now we have to set up how our Rigify rig layers will be named and set up. Go to the Object Data Properties tab, open up Rigify Layer Names, and set the table according to the screenshot below, marked as Point 32.
33. The metarig is now correctly adjusted. Your scene should look as shown in the screenshot below, marked as Point 33.
34. We highly recommend to save your project here and to continue your work in a new file (i.e. save, then save as a new file and continue your work on the new file), so that you can revert to the version you had until now and adjust the Metarig if needed. You can skip this, work on a single file, adjust the metarig, delete your current rig and generate a new one, but it may or may not be less convenient to rename.
35. Generate the rig. Congratulations, you have generated the rig and can move to constraining the character to it. Your scene should look as shown in the screenshot below, marked as Point 35.

Point 32, Rigify layer names for the rig	Point 33, fully adjusted Metarig.	Point 35, generated rig.

Editing the rig

Placeholder for the edit button