Fitted Mesh

Get the demo T-Shirt

In the video i used a very simple T-shirt model. This model is actually a cut-out of the Second Life upper body mesh.

Download from here:

Simple_Clothes – Blend file


This demo_model provided by Machinimatrix is a derivative from the Secondlife character, so the license of the Secondlife character applies. You have the permission to upload this model and any derivatives to SL.

Tip: You can quickly create this on your own by

  • Freeze the upper body of the Avastar base mesh
  • Remove the arms
  • Inflate the mesh a tiny bit (use ALT S)
  • Adjust the collar and shoulder parts to your likes

About this Document...


  • Convert a classic rig to a Fitted mesh rig
  • Use the smooth by weight tool
  • Edit the Fitted Mesh weights
  • Advanced: Basic Theory of Fitted mes

 The Video

  • Begin with a prepared classic rigged Shirt
  • Bind the mesh
  • Use Fitting Sliders in Object mode
  • Use fitting sliders in Edit mode
  • Use Smooth by Weight in edit mode

Meshes have one nasty problem: They can not be fully adjusted to the user’s shape. When you weight only to the classic deforming bones (mBones) then actually only a few of the Appearance sliders (the bone length changing sliders) can be used.

However, you can weight a mesh to another subset of the SL Avatar skeleton, namely the Collision Volume Bones. Meshes with weights on the Collision Volume Bones are also named Fitted Mesh

What does Avastar provide?

Avastar basically supports the creation of animatable Models (Avatars&attachments) and the creation of animations. Therefore the tool adds various functions and user interface elements to Blender.

The full functionality of Avastar can be a bit overwhelming on first sight. You should be prepared to spend some time and patience to get it all working nicely for your projects.

What does this Document provide?

We want to take the skirt from the preceding Create an Attachment guide and convert it into a fitted mesh skirt. We will mostly use the Fitted Mesh tools provided by Avastar 1.6.

However we also provide a lot of tool independent information as well. So this text may be interesting for you even when you do not use Avastar or Blender

We expect that you have basic knowledge about Blender.

The goal

Begin with a classic rigged Mesh
and sequentially convert it into a Fitted mesh
while retaining the original weighting

Some Gotchas

Fitted Mesh is nothing special

The concepts of fitted mesh are nothing unique to Second Life. In fact Fitted Mesh is absolutely standard Skeletal Animation. The problem with Fitted Mesh is only its name (honestly).

Fitted Mesh does not Fit everywhere…

Some people believe that fitted mesh allows your mesh avatars to be adjusted perfectly to the SL system Avatar. But this is entirely not true. Fitted mesh does not fit exactly to anything, and especially fitted mesh does not fit to the system Avatar at all. In fact Fitted Mesh is based on Skeletal Animation, while the SL Avatar shapes are mostly based on Morph Shapes.

The 2 concepts (Skeletal Animation and Morph shapes) are not comparable and thus they do not (actually they can not) create the same results. If you are lucky you can manage to create something that creates similar results, but never a perfect match for all Appearance Slider values!

No weights, no Fit!

The Avastar Tools for Fitted Mesh only work when your mesh is already weighted! The tools need existing weight maps on which they can operate. In general we recommend that the meshes are already weighted reasonably well for the classic bone set.

Side note: Actually you can start with no weights at all, but then the Fitting panel does no longer work smooth and easy. I will explain the issue in more detail further down.

Fitted mesh & Shades of Grey

Some people believe strongly that Fitted Mesh only uses the cBones (Collision Volume Bones), while Classic Mesh is a synonym for only weighting to the mBones (Deforming Bones). But this is not entirely true. Fitted Mesh weighting allows you to mix cBones and mBones. In fact our tools does just that to achieve better results.

Working with Fitted Mesh is no cakewalk

Should you expect that Avastar will give you the ability to create perfect rigged and fitted Mesh, then i can tell you 2 things:

  1. Yes you are right
  2. No, you won’t get there in one afternoon!

Honestly, Avastar only helps you to get better results with less work, but you still must know what you do. Please take your time, experiment a lot (even more than a lot), and learn 3D modelling and animation from the basics. All of this is not a cakewalk! But it becomes a lot of fun when you accept that it also is a lot of work:


The Conceptual Model of Fitted Mesh

This is a brief description of the concept that we used to implement support for Fitted Mesh (The Fitting Panel).

mBone – CollisionVolume pairs

We have pairs of (mBone, CollisionVolume) like for example (mPelvis,Pelvis), (mTorso,Torso) etc.
For those bones the sum of the weights in both weightmaps define how the bone pair influences the mesh during rotation and translation. While the weight on the Collision volume alone define the influence of the appearance sliders (scaling).

So you can distribute your weighting between the mBone and its paired collision volume without changing how the mesh behaves during animation. While the more weight you put on the Collision Volume the more influence you give to the appearance sliders.

Note: By distribute your weighting i mean that for each vertex the sum of the weights on the mbone and its paired Collision Volume does not change.

Physics Bones

We have a special set of Collision Volumes added for physics purposes (PEC, HANDLE, BACK, BUTT) Those Collision volumes are also parented to mBones but here the relationship between animation and appearance sliders is a bit more complicated. I believe the pairing for mPelvis, mTorso and mChest is like this:

  • (mPelvis, Pelvis + BUTT)
  • (mChest, Chest + LEFT_PEC + RIGHT_PEC + UPPER_BACK)

So you can distribute your weighting between those mBones and any or all of their related Collision Volume Bones without changing how the mesh behaves during animation. While again the more weight you put on the Collision Volume the more influence you give to the appearance sliders.

In practice

You just take your weight paint brushes and paint until your mesh behaves about right. This works for the simple bone/volume bone pairs (see above) without issues for large portions of your meshes. You only get trouble near the bone joints where you need to take special care about how to distribute the weights among the related bones.

The 4 weights per vert limitation

However when you add weights to the physics bones, then you can very easily get above the limits of Second life which say :

no more than 4 weights per vertex

This limitation gives you headache when you use all fitted mesh bones on your mesh.

The working Model

We will use a very simple skirt for this tutorial. (The video above uses a different mesh) This skirt is already weighted to the classic mBones and it contains a simple walk animation for scrubbing the timeline.

Download from here:

Simple_Clothes – Blend file


The above demo_model provided by Machinimatrix is licensed under a Creative Commons Attribution 4.0 International License.

For Second Life Users: We explicitly grant the permission to upload derived material to SL.


The skirt is available in animated_skirt.blend.

Starting from Classic Mesh

We use the very simple skirt model from the Create an attachment tutorial to demonstrate the basics of fitted Mesh. This skirt is already weighted to the classic mBones and it is rigged to a default Avastar character. We also added a simple walk animation (which was made with the Sparkles Add-on ). So the blend file is “ready for take off” provided you have Avastar 2 installed.

We will convert this mesh into a fitted Mesh. We have to take special care of the weights here as explained below

Content of the Blend file

  • A default female Avastar character
  • A Weighted Skirt (See Create an Attachment)
  • A Walk Animation for Testing
  • Body textures (starlight from Elloh Elliot)
  • Body Materials
  • A very simple light setup
We highly recommend that you first work your way through the Create an Attachment reference guide before you step further.

The Fitted Mesh Workspace

Your very first task is to setup your workspace so that it works best with the Fitted Mesh tools:

Preparing the Workspace


The rigging Panel

  • Select the Skirt inWeight Paint mode.
  • Open the Avastar Tab in the Tool Shelf.
  • In the Rig Display Panel select the Pose Preset.
  • Enable X-Ray.
  • Optionally disable Limits and Shapes
  • Optionally set the Rig display type to Stick.
  • Enable the visibility only for the Deform Bones.
  • And set the Display filter to “Map”.

Note: This is just my setup. You are free to use your own setup of course. But when you step through this document for the first time, then we strongly recommend to use the settings as indicated above.

(Optional) Configure the Deform Bones

By default only the 26 SL Base Bones of Avastar’s 136 Bones are enabled to use weight maps. All other bones are simply ignored by the Mesh attachments! However Fitted mesh also uses the Collision Volume Bones for deforming. Avastar normally ensures automatically that the Collision Volume Bones are enabled as Deform Bones when needed.

In case of trouble: If the collision volume bones are not enabled as deform bones for any reason, you can enforce this setting in the Rig Config Panel and there in the Deform Bone settings section at the bottom. You click on the Enable button for the Volume Bones (see image)

Caveat: There is no visual feedback for what happens. This is a known issue on our list of improvements.


Configure the Appearance Panel

Open the Appearance Panel in the Tool Shelf and select the Fitted Section (see image). Now you can see all Appearance Sliders (13 in total) which are used by the Fitted Mesh System. Please keep the Appearance Panel open as we will use it frequently from now on.

Tip: Please save your Blend file after you finished the preparations and keep this file as reference. Then you can always step back to a clean setup should you ever have messed up the weight maps of your meshes.
Should you ever need to open a ticket, then we probably will ask you to also send us this initial setup blend file.
And now it is time to fasten your seat Belts and open the Fitting Panel…

The Fitting Panel

The Fitting panel contains all the tools that we have created to support Fitted mesh in Avastar 2. The video aside gives you a brief overview.

However i recommend that you also take a look at the following chapter about the Basics of Fitted mesh. This will certainly help you to understand how the tools operate, and how to use them efficiently.

Basics of Fitted Mesh

The fitting Sliders

In the previous chapter we have introduced the Fitting Bones (bone pairs of one classic mBone and a corresponding cBone). In the fitting panel you find the corresponding tools for modifying the Fitting Bones. Especially you find the list of Fitting Bones in the Slider section at the bottom of the panel (see image)

Hint: The Fitting Panel is best used together with the Appearance panel. You should have both panels open and visible in the Tool Shelf.

The Fitting Panel details

Bone Fitting Strength

At the top of the Slider section you find 3 filter buttons for restricting the Display to:

  • The Selected Fitting Bones
  • The Weighted Fitting Bones
  • All Fitting Bones

The List of Fitting Bones

The settings controls which of the Fitting Bone sliders are shown in the slider list below the 3 filter buttons (see image). By default we display only the weighted Fitting Bones to avoid clutter on the display.

Distributing weights

The Fitting Sliders are used to move weight between the mBones and their corresponding cBones. Following rules apply for each slider:

  • Slider value 0.0: only mBone weighted
  • Slider value 1.0: only cBone weighted
  • Any value in between: the weights are distributed between the mBbone and the cBone

Attention: In any case for each vertex the sum of the weights on the cBone and the mBone is kept unchanged. This actually implies that if a vertex is not weighted to a Fitting Bone, then moving the Fitting Slider will not generate any weight! However you can add weight to any vertex manually (by using the weight editor or a brush) and as soon as you do that, the added weight can also be distributed with the Fitting Sliders.

Fitting Bones in the 3D View

A Fitting Bone is always a pair of bones consisting of:

  • an mBone (Classic SL Bone)
  • a cBone (Collision Volume)

Remind that mBones are shown in Blue, while cBones are shown in orange.


A Fitting Bone is Selected when either its mBone or its cBone is selected.

A Fitting Bone is Weighted when either its mBone or its cBone is weighted.


The Fitting Bones in the 3D View

Note: If both bones of a Fitting Bone are weighted, then you see them both in the 3D View. Please refer to the Preparation section above to see how to customize the Bone Display.

Working with The Fitting Sliders

In the Fitting Slider section you see 4 Sliders associated to 4 bone pairs:

Collision Volume

SL Base Bone


The Fitting Sliders for the Skirt

However when you look at the 3D View then you see only the blue mBones are currently displayed. This is because all Fitting Bone slider values are initially set to 0.0

Thus only the mBones are weighted, thus the mesh contains weight maps only for the classic mBones.


Initially only the mBones are visible

You can verify this by opening the Mesh Data Properties Window and inspect the Vertex Groups. And indeed we can see the 4 Vertex Groups for the 4 classic mBones.

The Vertex Groups associated to the Mesh

Interactive Fitting

Please step to the top of the Fitting Panel now make sure the option Apply Immediately is enabled. This ensures that our next changes become fully interactive.

Now lets move the Pelvis Fitting Slider a bit to the right. You see the orange PELVIS Bone appears in the 3D View as well.

And also a new Vertex Group for the PELVIS bone has been automatically created in the Data Properties window.

Tip: If you can not see the Collision Volumes appearing when you move the fitting sliders, then please check further up in the chapter Configure the Deform Bones that the Collision Volume Bones are enabled as Deform Bones.

For the technician: The weight values are split up between the PELVIS bone and the mPelvis bone. The Slider sets the fraction of weight that gets transferred from the mBone to the cBone. So when the slider is at 0.0 then the fraction of weight on the cBone becomes 0. While when the slider is set to 1.0 then all weight has been moved over from the mBone to the cBone.

The Fitting Sliders never add extra weight. They only change the weight distribution of their associated mBone/cBone pair!

Side note: When a Fitting slider is set to 0.5 then all weights are equally split up between the mBone and the cBone.

The major Pitfalls

You may have realized that when you play with the Fitting sliders, then only the weight distribution gets changed, but the mesh itself does not change its shape at all. There are 3 reasons why this happens:

  1. your Appearance sliders are all in their default position (this is our issue here). You must move the Appearance Sliders out of their default positions when you want to see the influence of the fitting sliders on the Mesh Shape!
  2. You forgot to enable the Apply Immediately option in the Fitting Panel. Enable this option and try again.
  3. Your mesh is neither weighted to the cBone nor to the mBone of a Fitting Bone. In that case there is no weight to distribute! Hence the Fitting Bone slider has no effect at all.

Fitting the Pelvis

Lets now do some practical work with the dress.

Please open the Appearance Panel (Torso Section) and move the Slider for the Belly Size to 50 (midway). You see on the image how the skirt sinks into the stomach (or how the stomach grows above the skirt).

Now step back into the Fitting Panel and move the Pelvis Fitting Slider gradually towards its maximum value. You see the belly growing with the Fitting Slider changes!


When the slider Value of the Pelvis Fitting Slider is close to 0.85 we see the mesh has changed like in the image aside. This is not perfect, but it is much better than it was before!

Note: You can easily get confused because the Fitting Panel and the Appearance Panel both seem to do something very similar. But always remember:

The Fitting Sliders modify the weight distribution of the mesh
The Appearance Sliders modify the shape values of the Armature



Now also move the Belly Slider from 0.0 up to 1.0:

You will end up with a slightly improved shape as shown in the image aside. However you still see issues on the side and on the back of the skirt where the original Avatar mesh pokes through.

Hint: The mTorso bone disappears as soon as the Belly Slider is set to 1.0


Belly: 1.0 Pelvis: 0.85

Fitting in Edit Mode

Luckily the fitting Sliders also work on vertex selections in Edit mode. All that you need to do is to set your mesh to edit mode. Now you can go ahead and select any subset of verts and then use the fitting sliders to improve the vertex locations of the selected verts. You can even select only one single vertex if you like.


Improved weighting by fitting selected vertices

Resetting the edited Vertex Weights

As soon as you begin using Fitting sliders in Edit mode, you notice that an additional icon appears on the right most column in the Fitting Sliders panel. When you click on this icon, then all weight edits that you have done in edit mode will be reset.

This is handy when you want to restart from a fresh and clean weight distribution


The revert icon on the right most column of Pelvis and Belly indicates edited weights.

Whenever the fitting slider values have been changed in edit mode, and when you switch back to weight paint mode, then moving the sliders may result in a change of the weight distribution of the entire mesh. This is a known inconvenience which we hopefully can resolve soon.

Current Workaround: Either readjust the Fitting slider or do not touch the fitting sliders in Weight paint mode after you have adjusted the weights in edit mode.

Fighting the Poke Through

Some areas of your mesh might suffer from poke through regardless how you distribute the the weights. In these areas your weights are not able to fit your mesh to the underlying Avatar mesh. However you can use a few strategies to master poke through issues.

  • Use an Alpha Mask to hide the underlying Meshes (very recommended where applicable)
  • Manually add weight to your weight maps (not recommended)
  • Edit the Mesh itself to adjust it to the current Shape (good for small fixes)
  • Create additional corrective Shape Keys (good when you intend to create standard sizes)

We will not get deeper into this topic here. We prepare a separate document for this.


I have introduced the principles of fitted mesh and the Avastar Fitted Mesh tools (i.e. the Fitting Panel). I have shown how you can work with the Fitting panel in Weight Paint Mode and in Edit mode.

From here on you can begin to experiment. Please be aware that nothing here is set in stone. Especially our workflow is not the only way how you can do fitted mesh. However i believe this is a good way to get you started.