dynamic-unity-avatar-generator

Dynamically generates humanoid UnityEngine.Avatar from skeleton bones at runtime.

How to import by Unity Package Manager

Add following dependencies to your /Packages/manifest.json.

{
    "dependencies": {
        "com.mochineko.dynamic-unity-avatar-generator": "https://github.com/mochi-neko/dynamic-unity-avatar-generator.git?path=/Assets/Mochineko/DynamicUnityAvatarGenerator#0.2.1",
        "com.mochineko.relent": "https://github.com/mochi-neko/Relent.git?path=/Assets/Mochineko/Relent#0.2.0",
        "com.cysharp.unitask": "https://github.com/Cysharp/UniTask.git?path=src/UniTask/Assets/Plugins/UniTask",
        ...
    }
}

Features

Generates UnityEngine.Avatar from humanoid 3D model hierarchy at runtime with specifying skeleton root bone retrieval logic (IRootBoneRetriever), human bone retrieval logic (IHumanBoneRetriever) and other parameters of HumanDescription (HumanDescriptionParameters).

Humanoid UnityEngine.Avatar generator
Root bone retriever (IRootBoneRetriever)
- Regular expression matching
- String comparison rule
- Specifying root bone instance
- Has most children bones
Human bone retriever (IHumanBoneRetriever)
- Regular expression matching
- String comparison rule
Human bone transform map IReadOnlyDictionary<HumanBodyBones, Transform> creator from UnityEngine.Avatar.

How to use

See AvatarGeneratorTest.

Regular expression pattern samples are in RegularExpressionHumanBoneRetrieverTest.

Presets

Provides some presets of IRootBoneRetriever, IHumanBoneRetriever and HumanDescriptionParameters.

Root bone retriever (IRootBoneRetriever)
- Mixamo and Biped preset
Human bone retriever (IHumanBoneRetriever)
- Mixamo and Biped preset
Human description parameters (HumanDescriptionParameters)
- Sample preset

See presets.

Change log

See CHANGELOG.

3rd party notices

See NOTICE.

License

Licensed under the MIT license.