diff --git a/docs/docs/tutorials/adv_clothing/base_setup.png b/docs/docs/tutorials/adv_clothing/base_setup.png new file mode 100644 index 00000000..e1376808 Binary files /dev/null and b/docs/docs/tutorials/adv_clothing/base_setup.png differ diff --git a/docs/docs/tutorials/adv_clothing/blendshape_sync_skirt.png b/docs/docs/tutorials/adv_clothing/blendshape_sync_skirt.png new file mode 100644 index 00000000..92089b56 Binary files /dev/null and b/docs/docs/tutorials/adv_clothing/blendshape_sync_skirt.png differ diff --git a/docs/docs/tutorials/adv_clothing/blendshape_sync_tops.png b/docs/docs/tutorials/adv_clothing/blendshape_sync_tops.png new file mode 100644 index 00000000..21d5d314 Binary files /dev/null and b/docs/docs/tutorials/adv_clothing/blendshape_sync_tops.png differ diff --git a/docs/docs/tutorials/adv_clothing/hips_collider.png b/docs/docs/tutorials/adv_clothing/hips_collider.png new file mode 100644 index 00000000..e669a473 Binary files /dev/null and b/docs/docs/tutorials/adv_clothing/hips_collider.png differ diff --git a/docs/docs/tutorials/adv_clothing/index.md b/docs/docs/tutorials/adv_clothing/index.md new file mode 100644 index 00000000..aeb9987d --- /dev/null +++ b/docs/docs/tutorials/adv_clothing/index.md @@ -0,0 +1,43 @@ +--- +sidebar_position: 2 +sidebar_label: Configuring a complex (cloth) outfit +--- + +In some cases the automatic setup is not quite enough to set up a complex outfit. +Let's look at Lachexia's [Dress Lumi](https://lachexia.booth.pm/items/3763311) as an example. + +This tutorial assumes you've already gone through the [simple clothing](../clothing) tutorial, +and will skip over some of the details covered there. + +We start out having dropped the Dress Lumi prefab onto the avatar, and having hidden the parts of the +original avatar's clothing that conflict with the new outfit (namely, Cloth, and setting `bra_off` on `Underwear`). + +![Starting state](initial_state.png) + +As you can see, there's a ton of extra objects in this outfit. The automatic setup described in +the [simple clothing tutorial](../clothing) will create the Merge Armature component for us, but +the rest of the objects require a bit more setup. That being said, that's still the right place to +start: + +![Basic setup menu](base_setup.png) + +Next up, we need to set up bone proxies to get all those collider objects to move along with their +base bones. To start, we'll select all the "Hips_Collider" objects and add an `MA Bone Proxy` to all of +them at once. Under "Target", drag-and-drop the Hips object from the original avatar. + +![Setting up hips colliders](hips_collider.png) + +Note that "Attachment Mode" will automatically update to "As child; keep position" when you do this. + +Go ahead and do the same for the other bones/colliers as well. + +Finally, set up blendshape sync components for Skirt and Tops: + +![Blendshape sync setup for Skirt object](blendshape_sync_skirt.png) +![Blendshape sync setup for Hips object](blendshape_sync_tops.png) + +## Other extensions + +You could fully automate the setup of this outfit, by adding a Merge Animator component which would +set up the base Body blendshapes (torso_thin => 100, elbow_off => 0, bra_off => 100), and disable Cloth. +However, this could interfere with outfit changer configurations, so it's not necessarily recommended. \ No newline at end of file diff --git a/docs/docs/tutorials/adv_clothing/initial_state.png b/docs/docs/tutorials/adv_clothing/initial_state.png new file mode 100644 index 00000000..303bfcfb Binary files /dev/null and b/docs/docs/tutorials/adv_clothing/initial_state.png differ diff --git a/docs/docs/tutorials/index.md b/docs/docs/tutorials/index.md index 1ee027f6..b87686e8 100644 --- a/docs/docs/tutorials/index.md +++ b/docs/docs/tutorials/index.md @@ -7,4 +7,5 @@ sidebar_label: Tutorials Here are some step-by-step guides on how to set up things using Modular Avatar. -* [Configuring a simple outfit](clothing/index.md) - in most cases, you can set up an outfit with just a few clicks. Check out this tutorial for details. \ No newline at end of file +* [Configuring a simple outfit](clothing) - in most cases, you can set up an outfit with just a few clicks. Check out this tutorial for details. +* [Configuring a complex (cloth) outfit](adv_clothing) - this tutorial shows an example of an outfit that requires just a little bit more setup \ No newline at end of file