Fitting Designer Clothing to your Avatar

Fitting Marvelous Designer clothing to your avatar

Marvelous Designer is a third-party modeling tool that allows the easy creation of 3D virtual clothing using patterns, like those used in sewing. Sansar integrates some of Marvelous Designer's technology, allowing you to import clothing from Marvelous Designer and use its cloth simulation feature to adjust the fit of your clothing exactly how you want it. Roll up sleeves, smooth out wrinkles, or pop your collar!

Wearing Marvelous Designer clothing

Once you have purchased or uploaded some Marvelous Designer clothing, you can add it to your avatar the same way you would add any other piece of clothing or accessory:

  1. Open the avatar editor by choosing Create > Style my avatar from the main menu.

  2. Select an avatar from the Lookbook, which is a list of your saved avatar looks, and click Customize.

  3. Click the Clothing tab to view your available clothing. Marvelous designer clothing is marked with a Marvelous Designer "M" logo.

  4. Click the thumbnails in the clothing tab to add or remove articles of clothing. Note that there is currently a limit on the number of pieces of clothing you can wear at one time.

Adjusting Marvelous Designer clothing

Once you are wearing some Marvelous Designer clothing, you can adjust it in adjust mode.

While customizing your look, click the triangular Play button next to a clothing item to adjust that item, or click Adjust Clothing to adjust all Marvelous Designer clothing on your avatar.

Once you are in this mode, your avatar enters a "T" pose. You can do the following adjusting actions with any Marvelous Designer clothing:


Grabbing allows you to fit an article of Marvelous Designer clothing better on your avatar. This is especially helpful when you see some patches of the avatar body poking out from the clothing or when you want to move the cloth such as a hood on a hoodie.

Click the clothing with your Left Mouse Button and drag it to re-position any part of an article of Marvelous Designer clothing. In VR, you can grab clothing using the Grip Button. As you pull one section, the rest of the garment shifts accordingly as cloth would.

Pulling zippers

If your clothing has a zipper, you can zip or unzip it by clicking and dragging the zipper tab up/down.

Click the clothing with your Left Mouse Button and drag it to re-position any part along the zipper line. In VR, you can move the zipper using the Grip Button. Note that the zipper does not move in real time. The zipper will unzip or zip after you move the tab to the desired spot.

Pinning clothing

You may pin clothing to your avatar to prevent it from pulling away from the pinned location while you adjust it.

Pin clothing up by pressing the Middle Mouse Button while holding the Left Mouse Button. You may also remove pins individually by clicking the pin locations with the Middle Mouse Button or press W+Left Mouse Button to remove all pins. Pins stay in place permanently until they are removed, even after you finish customizing your avatar. Add or remove pins using A or X on Oculus Rift or the Application Button on Vive. Note that you may only grab with one hand at a time.

Saving and resetting changes

When you are finished adjusting your clothing, click Done Adjusting to finalize your clothing adjustments. If you are not happy with the results, you can also click Reset item to revert the changes back to the state before you made adjustments. These buttons can be found at the bottom center of the screen in adjust mode.

Note that adjusting clothing is not currently possible while visiting a scene; you must make all clothing adjustments while customizing your look in the avatar editor.

Transform Marvelous Designer clothing

At times, you may find that some clothing doesn't fit your avatars well. With Marvelous Designer clothing, you can move or resize the item so that it fits better on your avatar. For example, if you put clothing made for a smaller avatar on a larger avatar, or if you put female clothing on a male avatar, the clothing may clip through the avatar's body or the clothes may not align to the body well.

Sansar supports the following transform actions so you can fit articles of clothing better on an avatar:


You may move the clothing item left, right, up, down, back and front using the Translate tool. To move the item:

  1. On the worn items panel, click the translate button to expose the translation gizmo. This is also the default mode when entering transformation mode.

  2. To move the clothing item, use the red, green, and blue arrows on the gizmo to move the object on the X, Y, and Z axis respectively.


You may rotate the clothing item to the left, right, up, down, back and front using the rotate tool. To rotate the item:

  1. On the worn items panel, click the rotate button to expose the rotation gizmo.

  2. To rotate the clothing item, use the red, green, and blue circles to rotate the selected object around the object's X, Y, and Z axes.


You may resize an item to be larger or smaller using the scale gizmo. To change the size of the item:

  1. On the worn items panel, click the scale button to expose the scale gizmo.

  2. To scale the clothing item, click and drag one of the white boxes to scale the object up or down.

All transformations

If you prefer to have quick access to all three action types at once, you can use the All transformations button to show the translate, rotation and scale action tools in one gizmo.

Saving and resetting changes

Once you are happy with your changes, click Done transforming to save the changes. If you want to discard your changes click Reset item to discard all changes, then click Done transforming. In transformation mode, these buttons are available on the worn items panel to the left.

Some tips on adjusting and transforming

  • You can rotate the avatar around to get better mobility when moving the item.

  • When transforming items with sleeves, it is best to make sure that the clothing item wraps around the avatar's wrists, elbows and shoulders. This helps the item move better as the avatar moves.

  • You do not have to go for a perfect fit when translating. You just have to translate enough to ensure that the clothing is draped on the needed parts of the body, then switch to adjust clothing.

  • When you click Adjust Clothing, the system pre-contours the clothing on your avatar. You can adjust the clothing further by grabbing on the cloth.

Compatibility with rigged mesh clothing

Sansar also supports rigged mesh clothing, which is designed to move with your avatar's skeleton and does not include cloth simulation. Rigged mesh and Marvelous Designer clothing may be worn together, and Marvelous Designer clothing can be worn over rigged mesh clothing, and in most cases the cloth simulation can stretch or drape a Marvelous Designer garment around the rigged mesh clothing.

A note about layering clothing

It is possible for clothing to interpenetrate, or "poke through" other clothing under certain circumstances. Typically, Sansar avoids this issue by hiding any clothing or body parts that are covered by a layer of clothing. However, any layer of clothing that includes transparency prevents the layer underneath from being hidden.

For example, if your avatar wears a shirt with a hole in it, Sansar must also show the avatar's torso behind the shirt and cannot hide the torso as it normally would. During certain animations, this can cause unexpected overlap or interpenetration between the avatar and layered clothing as they move in slightly different ways.

Creating Marvelous Designer clothing

To create MD items of clothing please see the help sections contained within Marvelous Designer info

Have more questions? Join our Discord!

Last updated