-
Notifications
You must be signed in to change notification settings - Fork 2
Unity‐chan Costume Tutorial
In this tutorial, we will fit the Unity-Chan! Sunny Side Up model for use on female characters.
No experience with Blender or Unity is required before starting this tutorial.
By the end of the tutorial, this what we will have in-game as a Cobalt mod.
You will need to have these programs installed.
- Blender, for the 3D modeling portion.
- Robust Weight Transfer, a Blender plugin, for the 3D modeling portion.
- Unity, for the building portion.
- [something] for the Material editing portion.
- An Engage female base body.
- The Unity Chan costume files.
- Mod bootstrap files
Open the Engage female base body file by double-clicking on it.
This is what it should look like right after it opens in Blender.

You can orbit the camera by clicking the middle mouse button and moving the mouse.

You can pan the camera by pressing the shift key and then clicking the middle mouse button, and moving the mouse.

You can zoom in and out by scrolling the mouse wheel.

In the upper right corner, you should see a few colored circles. This tool is called the Navigation Gizmo. Click on the colored circles with letters on them, to quickly change viewing angles and snap to side and top views.

Drag-and-drop the unity chan FBX you downloaded onto Blender.
You should see a dialog box that looks like this. Leave everything set at their defaults. Click Import FBX.
You will notice that Unity chan shows up right on top of the base body. Additionally, a few items are highlighted in the side panel in bright orange. These are the objects that we just imported.

This are a bit messy, so we will start by hiding the Engage base body. Move your mouse over the eye icon next to the base body in the side panel.
Shift-click the button to hide it and everything underneath it.

You will notice that only Unity chan is left in the viewport. If this is not the case, make sure you shift-clicked the eye next to uBody_Base0AF_c000, and not the camera.

Click on the little arrow next to Character1_Reference
![]()
You should see something like this in the side panel.

There are a lot of objects here, but we will be working with the Shirt first.
Shift-click on the eye for Character1_Reference to hide everything underneath it, then click the eye for just the Shirt to unhide it.

Now scroll down in the side panel to the bottom, and click the eye next to uBody_Base0AF_c000_Skin.
Your viewport should look like this now, with only uBody_Base0AF_c000_Skin and Shirt showing.

The Shirt isn't a great fit right now. It's a floating over the base body, and is a bit big.
Move your mouse over to the Navigation Gizmo the click the green circle until you're looking at the model straight on. It should show -Y.

Now, select the Shirt by left clicking on it in the viewport. Notice that is it highlighted in orange, and the object saying Shirt is also highlighted in the side panel.
In Blender, we can move objects by pressing the G key, and then moving the mouse. To remember this, we can think of G as standing for Grab.
Now, press the G key. Notice that the orange highlight is now white. Move your mouse down a bit, so the shirt on the body.

You might find that it's tricky to move things in a straight line, so press Z key while the object is still being moved. You will see a blue line like this.

If you move the mouse now, the movement will be locked to the Z axis (up and down). This is called Axis Locking. This allows us to move the shirt while keeping it centered. The same feature is available with the X and Y keys for the corresponding axes.
When you get the shirt fitting over her shoulders, click the mouse button to confirm the move. Notice that the highlight is orange again.
If you don't like where you put the shirt, you can use control Z to undo, or G to move it again.
The scene should look something like this now.

Let's check how well the costume is fitting now. Use the Navigation Gizmo and the middle mouse button to check out our work.
While the Shirt is in a better position, it is a bit too big right now.

In Blender, we can scale objects by pressing the S key, and then moving the mouse. To remember this, we can think of S as standing for Scale.
With the shirt still selected, press the S key and move your mouse.

You will notice that it is getting smaller, but is also moving around in a strange way. That is because the [origin point(https://docs.blender.org/manual/en/latest/scene_layout/object/origin.html) for this object is somewhere down near the ground. The scale command, by default, scales relative to this point.
If you zoom out a bit with the mouse wheel and keep the shirt selected, you will see an orange dot near the feet.

We can move the origin point to a more sensible place.
Making sure that the Shirt is selected, go to the Object menu, choose Set Origin, and then Origin to Geometry.

Notice that the orange dot is now near the center of the shirt.

Now try using the S key again, and scale the shirt to fit better. You can also reposition it with G if you need to.
The shirt should look something like this now. Don't worry if the shirt isn't perfectly covering her torso, because the hoodie we'll work on next covers the rest of the upper body.
We'll come back to finish adjustments to the shirt later.
Use the eye icon and hide the shirt. Then, show the Hoodie and the Zipper.
Note
We won't be using HoodieBack in this tutorial, so make sure not to select it.
The hoodie isn't a great fit right now. It's a floating over the base body.
Select the Hoodie the G key to move the costume into a better place, clicking to confirm.

However, notice that the Zipper didn't move along with the Hoodie, even though it ought to be attached to it. This is because they are two separate objects and not actually related.
Undo the move with control Z.
We can shift click the two objects to move them together at the same time.
Try this now by first clicking on the Zipper in the viewport, and then shift clicking on the Hoodie. They should both be highlighted in orange now.

Now, use the G key to move. The two objects now move together. Remember to use the G key, then the Z key, to keep the hoodie moving only up and down.
You should have something like this now:

Since we will be continuing to work with these two objects, we will join them so that they are one object.
To do that, we select the two items and then join them with control-J.
The order in which we select objects can change the results of certain operations, including join.
To see the difference, we will try joining two ways.
First select the Hoodie in the viewport, then shift click and select the Zipper in the viewport.
Having trouble selecting the zipper with shift-click?
You can also control click (not shift click) on the name of the object in the side panel to select multiple objects. The result will be the same either way.Notice the colors here:
In the viewport, the Hoodie has a darker orange outline, and the zipper has a bright orange outline.
In the sidepanel, the Hoodie is orange, has has a dark blue rectangle, and the Zipper is yellow and highlighted in a light blue color.
If you do not see the items open in the sidepanel, move your mouse over the sidepanel and press the period . key.

Now, go to the Object menu and choose Join.

The objects are joined and only the Zipper object remains.

Now undo the join with control-z.
This time, select the Zipper first, and then select the Hoodie. Notice the colors here, and how they are different from last time. In the viewport, the Zipper is darker orange, and the Hoodie is lighter orange. In the side panel, the Hoodie is the one with the lighter blue rectangle.
Join the objects again, and this time you will be left with the Hoodie.
This experiment shows that the last selected object is the one that's joined to.
We will proceed with this result, as the resulting object being Hoodie makes more sense.
You should end up with something like this.
The next few steps will involve familiarizing ourselves with tools used in mesh editing.
Switch to the front view by clicking on the Navigation Gizmo as we did before.
Notice that while the Hoodie is overall in a good place, the sides are a bit wide compared to the base body.
We will need to edit the shape of the hoodie to better match the base body.
In the upper left corner, there is a dropdown that looks like this and current says Object Mode in it.

This allows us to select different modes for Blender.
Object mode is used to manipulate objects as a whole. We've been using this mode so far.
Edit mode is used to edit the vertices that make up the object.
Make sure that the Hoodie is selected, and click on the mode dropdown, then select Edit mode.

The view will look like this now.
Notice that a grid and a bunch of vertices are now overlaid the hoodie. If it doesn't look like this, switch back to Object mode, double check that you are selecting the Hoodie body before switching to Edit mode.
Select a vertex like this by moving your mouse over it and clicking it. It doesn't need to be this precise one, any in the area will be OK for this part.

The same G key we used to move the hoodie as an object, can be used to move the vertices as well.
Press G to start moving. Try moving your mouse in various directions.
Notice that now the shape of the hoodie changes when you move your mouse.

If you left click, you will place the vertex there. With G, we can adjust the shape of a mesh.
However, there are many vertices and it would take a lot of time to move each one of the individually.
Undo to cancel this change for now.
In the same bar where the mode dropdown was, there is a tool called (Proportional Editing)[https://docs.blender.org/manual/en/latest/editors/3dview/controls/proportional_editing.html].
Click on it. It should turn blue, indicating it is active.
Now, select the a vertex by clicking on it, and move it again with G. Scroll your mouse wheel, and you will see a circle changing sizes. This is the sphere of influence for the proportional edit. Notice that now when you move the mouse, the selected point and its neighbors are moved. Try a few different circle sizes to get a feel for this tool.
Once you find a good placement, click to confirm it.
You may have something like this:

Although we fixed one side of the hoodie, the other side is still sticking out. While we could use the same method we did just above, again, there is a better way.
Undo any changes you've made so far with control-Z.
The Unity-chan costume was created in a way that is symmetrical. We can take advantage of that symmetry while editing.
In the upper right hand corner near the Navigation Gizmo, we can find the mesh symmetry editing options.

Turn on Enable mesh symmetry in the X axis.

Now, we can try to adjust the hoodie again. Click on one on the vertices with proportional editing on, and use the G key.
You will notice that the opposite side moves together now when editing.

We can continue adjusting the hoodie to fit the base body better.
To help maintain the proportions of the Hoodie, you can select multiple vertices at the same time to maintain their shape.
To see what vertex selection tools there are, left click and hold this button in the upper left corner.

Let's choose the Select Circle, and click around the side of the Hoodie to select some vertices in this area.
Now moving them with G, they will stay together and maintain their shape.
Try to get the sides of your hoodie looking something like this, and we will be ready for the next step.
Now, turn on the shirt again. You may notice that it clips out of the hoodie in some places. To edit the mesh for an object, you must first chose Object mode, then click the piece you want, then click edit mode.
Using the techniques we went over above, get the shirt fitting something like this and to your liking. If you want to edit the hoodie, you can switch back to the hoodie to edit that to your liking. If the hoodie is in your way, you can hide it with the eye button temporarily.
At the end, the shirt and the hoodie should look something like this.
By the end of this section, we will be able to play an animation with our costume on the character to check how well it is fitting.
We included some animations to test with in the base body project. For a tutorial on how to dump your own animations, see here.
First, we need to select the bones for body. Then, click the Data button (it looks like a little green person). Then, choose Pose position.
After this, go and choose Action Editor, and in this dropdown, choose (animation name).
Now, by scrubbing the Timeline in the action editor, we can see the character moving.
And, we will see that the costume is not moving with the body, but is just floating in place.
So, although the body moves, the clothing pieces does not.
A few things are needed before clothing pieces will move with the body.
Here's some explanation about what will be happening next, but you can skip ahead if you just want to get things working.
Click on the Skin object, and then the blue wrench. These are the modifiers. Notice that there is a modifier here Armature. It tells the skin object that it should react to the bones in Object if they move.
Now click on the green triangle with squares. These are the vertex groups. Notice that the if you flip open the bones, you will see the same names as list of names in the vertex group. Click on the skin, then switch to Weight Paint mode. You will see the body turns blue. Now, click on [vertex group name]. Notice how those areas light up in a gradient of colors. These are the vertices that will move with that bone.
If you check the weight painting for the Hoodie or Shirt, you will see that it has none.
These two pieces - the modifier, and the weight paint are both required for our costume to move.
Select the Hoodie and go to the modifier tab, and add the modifier. Do the same for the shirt.
We now have the armatures set up.
We will reuse the weights that the body has.
First, we need to set the body back to Rest pose.
Find the SENT tab and click it, then open Robust Weight Transfer.
For the source, choose skin.
Then, select the Hoodie and click Transfer Weights. If this button is grayed out, make sure you are in Object mode, and not edit mode.
Do the same for the shirt.
Now, select the bones again and choose pose mode.
The costume now moves with the body as you scrub through the timeline.
Go to weight paint mode, and notice that the hoodie now has weight painting as well.
Now, let's work on fitting the shorts.
Hide everything except the LowerBody for now.
Notice that the LowerBody itself has skin from the Unity-chan costume itself. Since we have an Engage base skin already, we will cut out the shorts for use in our costume.
Select the LowerBody and choose Edit mode. Alt/option click on this edge which is the visual boundary between the shorts and the leg. This selects the ring that forms the leg hole of the shorts. Use G to check that you've selected this correctly. If your selection doesn't move like this, make sure that you did not deselect it.
To separate the shorts from the leg skin, we can use the Rip tool. With the ring still selected, press V, and then enter to confirm. Using G now, try moving the selected ring. You'll notice that the shorts and the skin are no longer joined.
We need to do this again to the other short leg.
With that done, we will now separate the shorts section into its own object.
Press A twice quickly to deselect everything. Then, hover your mouse over the shorts and press L for the Select Linked tool.
You should see the shorts highlighted and nothing else. If you see the shorts and a leg or two selected, makes sure you've ripped the boundary between the shorts and the leg correctly.
Now, press P, and choose Selection. Notice that we now have a LowerBody and and LowerBody.001 object in the outliner.
Switch to Object mode, and click .001. Double click on it and rename it to Shorts, then press Enter to confirm.
Hide the remaining LowerBody for now, and then using the techniques we discussed above, we will fit the pants so that they look right.
Your window should look something like this now. Notice how no matter how we place the shorts, there will always be some parts that clip into the body, making it hard to select vertices to move them.
We can use the X-Ray tool to help here.
Click the X-Ray tool in the upper (whenever). Notice that we can now see a slightly greyed out outline of the shorts. You will also be able to click through the body to edit the vertices.
For an easier view of what is going on, switch to the Solid shading mode. You can adjust the amount of transparency to your liking here.
Change the color of the shorts here to make things easier to see.
After you get the shorts in a decent position, give it an armature modifier and weight transfer as we did before.
Don't worry too much if the pants look a little weird in the animations - it will be mostly covered by the hoodie anyway.
You should have something that looks like this with the shirt, hoodie, and pants.
We will be preparing our costume to try in the game next.
If you haven't already, set up Unity using the guide described here.
Introduction to the Divine Dragon Build tool. Talk about the setup needed to build a model bundle, assigning materials, addressables
Show the needed item xml line.
Show the relation between the MSBT and the XML fields.
Possibly out of scope, and should be already created for the user. A separate "how to guide" may be more appropriate for multi-creation.
Lythos, the Engage modding Wiki • Resources • Getting Started • Cobalt Wiki * Discord Server
Getting Started
Modding guides
- Game data
- Models and Unity
- Animations
- Audio
-
Maps
- Dumping Vanilla Maps
- Playable Area
- MapSetting
-
Terrain
- Terrainpaint
- Props
- CameraSet
- Exporting
-
LightSet
- Lightmaps & Environmental Lighting
- PostProcessSet
- Post-Battle Exploration
- HubRoot
- HubCollision
Documentation