Unity‐chan Spring Bones Tutorial
This tutorial should be followed after the Costume tutorial as it relies on the Unity-chan Blender and Unity projects.
At the end of this tutorial, you will have a tail for the Unity-chan costume that moves around like this.
Required:
Blender Unity
Recall how we had some animations to test the Unity-chan model with in the costume tutorial. Animations like running and attacking are animations driving by keyframes on a timeline.
In the game, there is another type of animation that is physics-based. Things like hair and parts of clothes move and sway in the wind, and also react to character movement. Unlike the running animations for example, there aren't any keyframes associated with these physics. These types of simulations are driven by spring bones.
Spring bones exist as an interaction of two parts - bones like we saw in Blender previously, and a Unity component.
The bones and weight painting define which parts should be influenced by the physics, and the components provide instructions to the game on how they should move.
We'll be starting in Unity first. Using the Dumper (guide to come), dump Merrin's uBody into your project. The full path is:
Data/StreamingAssets/aa/Switch/fe_assets_unit/model/ubody/cav2cf/c452/prefabs/ubody_cav2cf_c452.bundle
Once her model is dumped, you should be able to find it here:
With your Sample Scene open, drag-and-drop Merrin's uBody prefab into the scene like this, then use the eye button to hide any other models in the scene.
Then, press the Play button in the middle of the top bar.
After a bit of loading, the Editor will jump to the Game tab.
Click on the Scene tab again to jump back to looking at Merrin's uBody.
You should see something like this. Notice how the tail is swaying and so is the cravat (or whatever the white ruffled cloth on her chest is called).
merrin.example.mov
Stop the playing by clicking play button again.
Now, open Merrin's uBody prefab by clicking on it in the Hierarchy, the clicking Prefab Open in the Inspector.
You should see a focused view like this now:
The list of items under c_trans are the bones that you saw in the animation section of the costume tutorial.
Find the object called c_mngtal_jnt and click on it. (This object would show up as a bone in Blender.)
Notice how a Spring Job Manager component shows up in the Inspector panel. If you scroll around in it, you can see some settings.
Now try selecting a few of the objects below c_mngtal_jnt one by one.
For example here is c_sprtal1_jnt selected.
and c_sprtal2_jnt selected.
And in the side panel, we see a component called Spring Bone.
It also has a lot settings that you can scroll to check out a bit.
Finally, click on the object named c_sprtal1_piv.
Notice how it has a Spring Bone Pivot component.
The Spring Job Manager and Spring Bone and Pivots work together to describe how the physics should be animated.
We'll be copying over the bones and the physics for the tail onto the Unity-chan costume.
We will export this model for use in Blender so we can borrow the bones.
While still in this focused Prefab mode, right click on the root object (uBody_Cav2CF_c452), and choose Export to FBX...
You should see a window like this pop up.
If you don't see the Apply Sommie's Recommended Defaults button, make sure to install the new version of the FBX exporter by doing (this).
If you see Apply Sommie's Recommended Defaults and it isn't greyed out, click it.
You can leave everything set at the defaults, and click Export. By default, this will export the Merrin uBody straight into the Assets folder.
With the uBody_Cav2CF_c452 still selected, go to UTJ -> Spring Bone Window.
You should see something like this:
Under Dynamics CSV, click the Save button.
You should see a window pop up that looks like this:
Click Mass Save Prefab CSVs. This should open a window in your Unity project.
You can make a New Folder called Merrin Physics, and save inside of there.
On the bottom bar, you should see a message saving that the file was saved.
If you look at the folder, you'll see a few CSV files were created there.
If you open it in a spreadsheet editor, c_mngtal_jnt_Dynamics.csv might look something like this
We will use this later to copy settings onto our Unity-chan tail.
We will now be doing a bone transplant to reuse Merrin's tail bones for the Unity-chan costume.
First, open your Unity-chan Blender project.
In your operating system, locate the Merrin uBody FBX that you exported (uBody_Cav2CF_c452.fbx) in your Unity project, and drag it into Blender.
The default settings are fine.
You'll see something like this with Merrin's uBody right on top of the Unity-chan work we've been doing.
Shift-click on the eye for uBody_Base0AF_c000 to hide it for now.
Then click on one of the Merrin bones,
and enter Edit mode.
Let's find the tail bones for Merrin.
In the sidepanel, type in c_mngtal_jnt to locate that bone. Note that this was the bone the Spring Job Manager component was attached to in Unity. Once you see it, click on it in the sidepanel.
Clear the search. You will momentarily lose sight of the selection.
However, it is actually still selected. With your mouse hovering over the sidepanel, press the . (period) key.
The sidepanel will flip open to your selection. Note how the parent for this bone is c_spine1vol_jnt.
Now, shift-click on the twirly next to c_mngtal_jnt. These bones are the same ones we inspected in Unity earlier.
We need to separate the bones now from Merrin so we can attach them to the Unity-chan costume base body.
With c_mngtal_jnt still selected, go to Select -> Select Similar -> Select Children, and choose this option.
You should see something like this now:
Then, with your mouse hovering over the viewport, press P to Separate them from this armature.
If this succeeded, you will see a message at the bottom of the screen saying Separated bones
Scroll down in the sidepanel to locate the separated bones.
Enter Object Mode and click on uBody_Cav2CF_c452.001.
Then, scroll up in your sidepanel and find uBody_Base0AF_c000. Click on its eye to show it. Then, Ctrl-click on it.
You should see the tail bones in outlined in dark orange, and the uBody_Base0AF_c000 bones outlined in light orange.
Now, with the mouse hovering over the viewport, press Ctrl-J to join the two armatures.
Notice how the little bone count has increased.
uBody_Cav2CF_c452.001 is also gone.
Twirl open the green uBody_Base0AF_c000.
Notice that the c_mngtal_jnt is not in the right place yet.
Click on c_mngtal_jnt, and enter Edit mode. Your sidepanel may lose view of the bone, so hover your mouse over the sidepanel and press the . (period) key to show it again.
Select it, and scroll down to the Relations section in the Bone properties tab.
In the Parent field, enter c_spine1vol_jnt and accept it.
Press . again with your mouse over the side panel to locate where it went. The bone is now where it should be in the hierarchy.
Now, shift-click the eye for Merrin uBody_Cav2CF_c452 to hide all of her for now.
And shift-click the eye for the Unity-chan costume twice to show everything.
You should see something like this now:
Return to Object mode.
Next, find the Tale object in the original Unity-chan object. Click the eye to show it.
Reparent it into costume we've been working on. You can drag-and-drag it over meshGP while holding shift.
Now, go back to Merrin and show Cav2CF_c452_Dress by clicking on its eye.
Now, select Cav2CF_c452_Dress and enter Edit mode.
Hover over part of the tail and press L to select linked. You can use Normal mode.
Separate out the tail with P -> Selection.
Return to Object mode, select Cav2CF_c452_Dress.001 and then hide Cav2CF_c452_Dress.
We will borrow Merin's tail physics for Unity.
Use dumper to dump Merin
Use export FBX to get an FBX of merin.
Import into Blender
Cut off the bones to transfer onto base engage body.
weight transfer the tail
export CSV from merin
import back onto unity chan
test in game
shadowmesh
setting up our own bones for the ribbon pieces
remarks on oBody: spring bones also work on obody.