Skip to content

Commit 351426f

Browse files
authored
Merge pull request #15 from Benjythebee/add/blendshape-trait
add blendshape docs
2 parents aefa6be + 3af47e7 commit 351426f

File tree

1 file changed

+46
-0
lines changed

1 file changed

+46
-0
lines changed

docs/Modders/manifest-files/character-traits.md

+46
Original file line numberDiff line numberDiff line change
@@ -522,6 +522,52 @@ Example:
522522
]
523523
```
524524

525+
**blendshapeTraits *(optional Object[])***: An array of Blendshape Trait definition. Let's you define blendshapes as traits. These blendshapes will be removed at export stage.
526+
Note that we currently treat every blendshape trait (those defined in the manifest) as binary. I.e. they're either on or off.
527+
528+
```json
529+
...
530+
"collection": [
531+
{
532+
"id": "male",
533+
"name": "male",
534+
"directory": "Body/male.vrm",
535+
"thumbnail": "Body/male.png",
536+
"blendshapeTraits":[{ < ---------------
537+
"trait":"nose",
538+
"name":"Nose",
539+
"cameraTarget": {
540+
"distance": 0.75,
541+
"height": 1.5
542+
},
543+
"collection":[{
544+
"id":"Nose_LONG",
545+
"name":"Long Nose"
546+
}]
547+
}]
548+
}
549+
]
550+
```
551+
552+
A BlendshapeTrait Group definition has the following properties:
553+
554+
**trait *(string)***: Group id of the blendshape group.
555+
556+
**name *(string)***: Name of the blendshape group.
557+
558+
**cameraTarget *(optional Object)***: Define distance and height of the blendshape group.
559+
560+
**collection *( Array of Object)***: The Array of Blendshape traits, defined below.
561+
562+
> **id *(string)***: ID of the blendshape, this also has to be the exact blendshape name (case-sensitive)
563+
>
564+
> **name *(string)***: Name of the trait.
565+
>
566+
> **fullThumbnail *(optional string)***: Path to the thumbnail of that blendshape trait.
567+
568+
569+
570+
525571
___
526572

527573
## Texture Collection Section (textureCollections):

0 commit comments

Comments
 (0)