๐ English
Overview
An automated Unity Editor tool for setting up Modular Avatarโs Blendshape Sync component across multiple objects simultaneously. This tool simplifies the process of synchronizing blendshapes between a source mesh and multiple target meshes.
Features
- ๐ฏ Automatic Blendshape Detection: Automatically finds common blendshapes between source and target meshes
- ๐ฆ Multi-Target Support: Configure multiple target objects in a single operation
- ๐ฑ๏ธ Drag & Drop Interface: Easy-to-use drag and drop functionality with multi-selection support
- ๐ณ Recursive Child Processing: Optionally include all child objects with SkinnedMeshRenderer components
- ๐ Multi-Language Support: English, Korean, and Japanese UI languages
- ๐๏ธ Real-time Preview: See which blendshapes will be configured before applying
- โฉ๏ธ Undo Support: Full Unity Undo system integration
Requirements
- Unity 2022.3.22f1 or later
- Modular Avatar package installed
- NDMF (Non-Destructive Modular Framework)
Installation
- Download the
BlendshapeSyncAutoSetup.cs file
- Place it in an
Editor folder in your Unity project
- The tool will appear in the menu:
Iyan-Kim > Tools > Modular Avatar Blendshape Sync Auto Setup
How to Use
Basic Usage
-
Open the tool from Iyan-Kim > Tools > Modular Avatar Blendshape Sync Auto Setup
-
Assign a Source Object (the mesh with reference blendshapes)
-
Add
Target Objects
using one of these methods:
- Drag and drop GameObjects into the drop area
- Use the โAdd Target Objectโ button
- Multi-select objects in Hierarchy and drag them together
-
Enable/disable Include Child Objects toggle as needed
-
Review the preview of common blendshapes found
-
Click Setup Blendshape Sync button
-
Done! The Modular Avatar Blendshape Sync component is now configured on all targets
Include Child Objects Feature
- Enabled (Default): Automatically includes all child objects with SkinnedMeshRenderer components
- Disabled: Only adds the explicitly selected objects
Language Selection
Choose your preferred language from the dropdown at the bottom of the window:
- English (Default)
- ํ๊ตญ์ด (Korean)
- ๆฅๆฌ่ช (Japanese)
Tips
- The tool only processes objects with SkinnedMeshRenderer components
- Duplicate objects are automatically filtered out
- You can remove individual targets using the โXโ button
- Use โClear Allโ to remove all targets at once
- The preview shows exactly which blendshapes will be configured for each target
Troubleshooting
- No common blendshapes found: Ensure both source and target meshes have blendshapes with identical names
- Setup button is disabled: Make sure you have selected both a source object and at least one valid target object
- Component not working after setup: Verify that the source object is within the same avatar hierarchy
๐ ํ๊ตญ์ด
๊ฐ์
Modular Avatar์ Blendshape Sync ์ปดํฌ๋ํธ๋ฅผ ์ฌ๋ฌ ์ค๋ธ์ ํธ์ ๋์์ ์ค์ ํ ์ ์๋ Unity ์๋ํฐ ์๋ํ ํด์
๋๋ค. ์์ค ๋ฉ์์ ์ฌ๋ฌ ํ๊ฒ ๋ฉ์ ๊ฐ์ ๋ธ๋ ๋์์ดํ ๋๊ธฐํ ๊ณผ์ ์ ๊ฐ์ํํฉ๋๋ค.
๊ธฐ๋ฅ
- ๐ฏ ์๋ ๋ธ๋ ๋์์ดํ ๊ฐ์ง: ์์ค์ ํ๊ฒ ๋ฉ์ ๊ฐ์ ๊ณตํต ๋ธ๋ ๋์์ดํ๋ฅผ ์๋์ผ๋ก ์ฐพ์ต๋๋ค
- ๐ฆ ๋ค์ค ํ๊ฒ ์ง์: ํ ๋ฒ์ ์์
์ผ๋ก ์ฌ๋ฌ ํ๊ฒ ์ค๋ธ์ ํธ๋ฅผ ์ค์ ํ ์ ์์ต๋๋ค
- ๐ฑ๏ธ ๋๋๊ทธ ์ค ๋๋กญ ์ธํฐํ์ด์ค: ๋ค์ค ์ ํ์ ์ง์ํ๋ ์ฌ์ฉํ๊ธฐ ์ฌ์ด ๋๋๊ทธ ์ค ๋๋กญ ๊ธฐ๋ฅ
- ๐ณ ์ฌ๊ท์ ํ์ ์ฒ๋ฆฌ: SkinnedMeshRenderer ์ปดํฌ๋ํธ๊ฐ ์๋ ๋ชจ๋ ํ์ ์ค๋ธ์ ํธ๋ฅผ ์ ํ์ ์ผ๋ก ํฌํจ
- ๐ ๋ค๊ตญ์ด ์ง์: ์์ด, ํ๊ตญ์ด, ์ผ๋ณธ์ด UI ์ธ์ด ์ง์
- ๐๏ธ ์ค์๊ฐ ๋ฏธ๋ฆฌ๋ณด๊ธฐ: ์ ์ฉ ์ ์ ์ด๋ค ๋ธ๋ ๋์์ดํ๊ฐ ์ค์ ๋ ์ง ํ์ธ ๊ฐ๋ฅ
- โฉ๏ธ Undo ์ง์: Unity Undo ์์คํ
๊ณผ ์์ ํ ํตํฉ
์๊ตฌ ์ฌํญ
- Unity 2022.3.22f1 ์ด์
- Modular Avatar ํจํค์ง ์ค์น ํ์
- NDMF (Non-Destructive Modular Framework)
์ค์น ๋ฐฉ๋ฒ
BlendshapeSyncAutoSetup.cs ํ์ผ์ ๋ค์ด๋ก๋ํฉ๋๋ค
- Unity ํ๋ก์ ํธ์
Editor ํด๋์ ๋ฐฐ์นํฉ๋๋ค
- ๋ฉ๋ด์์ ํด์ ์ฐพ์ ์ ์์ต๋๋ค:
Iyan-Kim > Tools > Modular Avatar Blendshape Sync Auto Setup
์ฌ์ฉ ๋ฐฉ๋ฒ
๊ธฐ๋ณธ ์ฌ์ฉ๋ฒ
-
Iyan-Kim > Tools > Modular Avatar Blendshape Sync Auto Setup์์ ํด์ ์ฝ๋๋ค
-
์์ค ์ค๋ธ์ ํธ๋ฅผ ํ ๋นํฉ๋๋ค (์ฐธ์กฐํ ๋ธ๋ ๋์์ดํ๊ฐ ์๋ ๋ฉ์)
-
๋ค์ ๋ฐฉ๋ฒ ์ค ํ๋๋ก
ํ๊ฒ ์ค๋ธ์ ํธ
๋ฅผ ์ถ๊ฐํฉ๋๋ค:
- ๋๋กญ ์์ญ์ GameObject๋ฅผ ๋๋๊ทธ ์ค ๋๋กญ
- โํ๊ฒ ์ค๋ธ์ ํธ ์ถ๊ฐโ ๋ฒํผ ์ฌ์ฉ
- Hierarchy์์ ์ฌ๋ฌ ์ค๋ธ์ ํธ๋ฅผ ์ ํํ์ฌ ํจ๊ป ๋๋๊ทธ
-
ํ์์ ๋ฐ๋ผ ํ์ ์ค๋ธ์ ํธ ํฌํจ ํ ๊ธ์ ํ์ฑํ/๋นํ์ฑํํฉ๋๋ค
-
๋ฐ๊ฒฌ๋ ๊ณตํต ๋ธ๋ ๋์์ดํ์ ๋ฏธ๋ฆฌ๋ณด๊ธฐ๋ฅผ ํ์ธํฉ๋๋ค
-
๋ธ๋ ๋์์ดํ ์ฑํฌ ์ค์ ๋ฒํผ์ ํด๋ฆญํฉ๋๋ค
-
์๋ฃ! ๋ชจ๋ ํ๊ฒ์ Modular Avatar Blendshape Sync ์ปดํฌ๋ํธ๊ฐ ์ค์ ๋์์ต๋๋ค
ํ์ ์ค๋ธ์ ํธ ํฌํจ ๊ธฐ๋ฅ
- ํ์ฑํ (๊ธฐ๋ณธ๊ฐ): SkinnedMeshRenderer ์ปดํฌ๋ํธ๊ฐ ์๋ ๋ชจ๋ ํ์ ์ค๋ธ์ ํธ๋ฅผ ์๋์ผ๋ก ํฌํจํฉ๋๋ค
- ๋นํ์ฑํ: ๋ช
์์ ์ผ๋ก ์ ํํ ์ค๋ธ์ ํธ๋ง ์ถ๊ฐํฉ๋๋ค
์ธ์ด ์ ํ
์๋์ฐ ํ๋จ์ ๋๋กญ๋ค์ด์์ ์ํ๋ ์ธ์ด๋ฅผ ์ ํํ์ธ์:
- English (๊ธฐ๋ณธ๊ฐ)
- ํ๊ตญ์ด
- ๆฅๆฌ่ช (์ผ๋ณธ์ด)
ํ
- ํด์ SkinnedMeshRenderer ์ปดํฌ๋ํธ๊ฐ ์๋ ์ค๋ธ์ ํธ๋ง ์ฒ๋ฆฌํฉ๋๋ค
- ์ค๋ณต๋ ์ค๋ธ์ ํธ๋ ์๋์ผ๋ก ํํฐ๋ง๋ฉ๋๋ค
- โXโ ๋ฒํผ์ ์ฌ์ฉํ์ฌ ๊ฐ๋ณ ํ๊ฒ์ ์ ๊ฑฐํ ์ ์์ต๋๋ค
- โ์ ์ฒด ์ญ์ โ๋ฅผ ์ฌ์ฉํ์ฌ ๋ชจ๋ ํ๊ฒ์ ํ ๋ฒ์ ์ ๊ฑฐํ ์ ์์ต๋๋ค
- ๋ฏธ๋ฆฌ๋ณด๊ธฐ๋ ๊ฐ ํ๊ฒ์ ๋ํด ์ ํํ ์ด๋ค ๋ธ๋ ๋์์ดํ๊ฐ ์ค์ ๋ ์ง ๋ณด์ฌ์ค๋๋ค
๋ฌธ์ ํด๊ฒฐ
- ๊ณตํต ๋ธ๋ ๋์์ดํ๋ฅผ ์ฐพ์ ์ ์์: ์์ค์ ํ๊ฒ ๋ฉ์ ๋ชจ๋ ๋์ผํ ์ด๋ฆ์ ๋ธ๋ ๋์์ดํ๋ฅผ ๊ฐ์ง๊ณ ์๋์ง ํ์ธํ์ธ์
- ์ค์ ๋ฒํผ์ด ๋นํ์ฑํ๋จ: ์์ค ์ค๋ธ์ ํธ์ ์ต์ ํ๋์ ์ ํจํ ํ๊ฒ ์ค๋ธ์ ํธ๋ฅผ ์ ํํ๋์ง ํ์ธํ์ธ์
- ์ค์ ํ ์ปดํฌ๋ํธ๊ฐ ์๋ํ์ง ์์: ์์ค ์ค๋ธ์ ํธ๊ฐ ๋์ผํ ์๋ฐํ ๊ณ์ธต ๊ตฌ์กฐ ๋ด์ ์๋์ง ํ์ธํ์ธ์
๐ ๆฅๆฌ่ช
ๆฆ่ฆ
Modular Avatar ใฎ Blendshape Sync ใณใณใใผใใณใใ่คๆฐใฎใชใใธใงใฏใใซๅๆใซ่จญๅฎใงใใ Unity ใจใใฃใฟใผ่ชๅๅใใผใซใงใใใฝใผในใกใใทใฅใจ่คๆฐใฎใฟใผใฒใใใกใใทใฅ้ใฎใใฌใณใใทใงใคใๅๆใใญใปในใ็ฐก็ด ๅใใพใใ
ๆฉ่ฝ
- ๐ฏ ่ชๅใใฌใณใใทใงใคใๆคๅบ: ใฝใผในใจใฟใผใฒใใใกใใทใฅ้ใฎๅ
ฑ้ใใฌใณใใทใงใคใใ่ชๅ็ใซๆคๅบ
- ๐ฆ ใใซใใฟใผใฒใใๅฏพๅฟ: 1 ๅใฎๆไฝใง่คๆฐใฎใฟใผใฒใใใชใใธใงใฏใใ่จญๅฎๅฏ่ฝ
- ๐ฑ๏ธ ใใฉใใฐ&ใใญใใใคใณใฟใผใใงใผใน: ่คๆฐ้ธๆๅฏพๅฟใฎไฝฟใใใใใใฉใใฐ&ใใญใใๆฉ่ฝ
- ๐ณ ๅๅธฐ็ใชๅญๅฆ็: SkinnedMeshRenderer ใณใณใใผใใณใใๆใคใในใฆใฎๅญใชใใธใงใฏใใใชใใทใงใณใงๅซใใ
- ๐ ๅค่จ่ชๅฏพๅฟ: ่ฑ่ชใ้ๅฝ่ชใๆฅๆฌ่ชใฎ UI ่จ่ชใตใใผใ
- ๐๏ธ ใชใขใซใฟใคใ ใใฌใใฅใผ: ้ฉ็จๅใซใฉใฎใใฌใณใใทใงใคใใ่จญๅฎใใใใ็ขบ่ชๅฏ่ฝ
- โฉ๏ธ Undo ใตใใผใ: Unity Undo ใทในใใ ใจๅฎๅ
จใซ็ตฑๅ
ๅฟ
่ฆ็ฐๅข
- Unity 2022.3.22f1 ไปฅ้
- Modular Avatar ใใใฑใผใธใฎใคใณในใใผใซใๅฟ
่ฆ
- NDMF (Non-Destructive Modular Framework)
ใคใณในใใผใซๆนๆณ
BlendshapeSyncAutoSetup.csใใกใคใซใใใฆใณใญใผใ
- Unity ใใญใธใงใฏใใฎ
Editorใใฉใซใใซ้
็ฝฎ
- ใกใใฅใผใใใใผใซใ้ใใพใ:
Iyan-Kim > Tools > Modular Avatar Blendshape Sync Auto Setup
ไฝฟ็จๆนๆณ
ๅบๆฌ็ใชไฝฟใๆน
-
Iyan-Kim > Tools > Modular Avatar Blendshape Sync Auto Setupใใใใผใซใ้ใ
-
ใฝใผในใชใใธใงใฏใใๅฒใๅฝใฆ๏ผๅ็
งใใใใฌใณใใทใงใคใใๆใคใกใใทใฅ๏ผ
-
ๆฌกใฎใใใใใฎๆนๆณใง
ใฟใผใฒใใใชใใธใงใฏใ
ใ่ฟฝๅ :
- ใใญใใใจใชใขใซ GameObject ใใใฉใใฐ&ใใญใใ
- โใฟใผใฒใใใ่ฟฝๅ โใใฟใณใไฝฟ็จ
- Hierarchy ใง่คๆฐใฎใชใใธใงใฏใใ้ธๆใใฆไธ็ทใซใใฉใใฐ
-
ๅฟ
่ฆใซๅฟใใฆๅญใชใใธใงใฏใใๅซใใใฐใซใๆๅน/็กๅนๅ
-
ๆคๅบใใใๅ
ฑ้ใใฌใณใใทใงใคใใฎใใฌใใฅใผใ็ขบ่ช
-
ใใฌใณใใทใงใคใๅๆใ่จญๅฎใใฟใณใใฏใชใใฏ
-
ๅฎไบ๏ผใในใฆใฎใฟใผใฒใใใซ Modular Avatar Blendshape Sync ใณใณใใผใใณใใ่จญๅฎใใใพใใ
ๅญใชใใธใงใฏใใๅซใๆฉ่ฝ
- ๆๅน๏ผใใใฉใซใ๏ผ: SkinnedMeshRenderer ใณใณใใผใใณใใๆใคใในใฆใฎๅญใชใใธใงใฏใใ่ชๅ็ใซๅซใใ
- ็กๅน: ๆ็คบ็ใซ้ธๆใใใใชใใธใงใฏใใฎใฟใ่ฟฝๅ
่จ่ช้ธๆ
ใฆใฃใณใใฆไธ้จใฎใใญใใใใฆใณใใๅฅฝใฟใฎ่จ่ชใ้ธๆ:
- English๏ผใใใฉใซใ๏ผ
- ํ๊ตญ์ด๏ผ้ๅฝ่ช๏ผ
- ๆฅๆฌ่ช
ใใณใ
- ใใผใซใฏ SkinnedMeshRenderer ใณใณใใผใใณใใๆใคใชใใธใงใฏใใฎใฟใๅฆ็ใใพใ
- ้่คใใใชใใธใงใฏใใฏ่ชๅ็ใซใใฃใซใฟใชใณใฐใใใพใ
- โXโใใฟใณใงๅๅฅใฎใฟใผใฒใใใๅ้คใงใใพใ
- โใในใฆใฏใชใขโใงๅ
จใฆใฎใฟใผใฒใใใไธๅบฆใซๅ้คใงใใพใ
- ใใฌใใฅใผใฏๅใฟใผใฒใใใซๅฏพใใฆใฉใฎใใฌใณใใทใงใคใใ่จญๅฎใใใใใๆญฃ็ขบใซ่กจ็คบใใพใ
ใใฉใใซใทใฅใผใใฃใณใฐ
- ๅ
ฑ้ใใฌใณใใทใงใคใใ่ฆใคใใใชใ: ใฝใผในใจใฟใผใฒใใใกใใทใฅใฎไธกๆนใๅไธๅใฎใใฌใณใใทใงใคใใๆใฃใฆใใใ็ขบ่ชใใฆใใ ใใ
- ่จญๅฎใใฟใณใ็กๅน: ใฝใผในใชใใธใงใฏใใจๅฐใชใใจใ 1 ใคใฎๆๅนใชใฟใผใฒใใใชใใธใงใฏใใ้ธๆใใใ็ขบ่ชใใฆใใ ใใ
- ่จญๅฎๅพใซใณใณใใผใใณใใๅไฝใใชใ: ใฝใผในใชใใธใงใฏใใๅใใขใใฟใผ้ๅฑคๅ
ใซใใใ็ขบ่ชใใฆใใ ใใ
๐ License
This tool is designed to work with Modular Avatar by bd_ (https://github.com/bdunderscore/modular-avatar)
๐ค Contributing
Issues and pull requests are welcome!
๐ง Support
If you encounter any problems or have questions, please open an issue on the repository.
Created with โค๏ธ for the VRChat and Unity community