Guide for using Modular Avatar on Basis projects

요구 사항: Basis

• This page is available in English: English
• このページは日本語でご覧いただけます: 日本語

영어 이외의 언어 번역은 Gemini 3 Flash에서 제공합니다.

Modular Avatar is not officially supported on Basis projects.

This page is an unsanctioned guide to get a working version of Modular Avatar on Basis projects.

위험

You should never install the VRChat SDK in Basis projects. If you do, it will mangle the project settings, and this is not reversible.

This is because the VRChat SDK prepares the Unity project settings specifically so that assets and shaders can be built to work inside the VRChat platform.

Unity 6.5 (version of Basis Framework as of the 26th of August 2026)

As of the 26th of August 2026, the Basis Framework runs in Unity 6.5, but this version of Unity introduces breaking changes.

At this time of writing (26th of August 2026), Modular Avatar and NDMF are not compatible with Unity 6.5.

You may have to install unofficial versions of Modular Avatar and NDMF, as instructed below.

Add this listing to ALCOM:

https://hai-vr.github.io/unofficial-modular-avatar-basis-listing/index.json

(you may audit by inspecting the GitHub repository for that listing)

Then, install these versions in ALCOM:

• NDMF 1.14.6-unofficial.basis.1 (hosted at https://github.com/hai-vr/ndmf/releases)
• Modular Avatar 1.18.3-unofficial.basis.1 (hosted at https://github.com/hai-vr/modular-avatar/releases)

And also, install this:

• Chillaxins 1.2.0 (Download directly here)

It may be possible that newer versions of Modular Avatar and NDMF could work, but you have to verify by yourself as installing in Unity 6.4 or Unity 6.5 is not officially supported by Modular Avatar.

Do not use Modular Avatar Shape Changer

Modular Avatar has a component called Shape Changer.

Basis Framework generates simplified versions of the avatar mesh (LODs), but at this time of writing (26th of August 2026), Modular Avatar is blind to these simplified versions. This may result in the meshes affected by Shape Changer displaying both the simplified versions and the detailed versions simultaneously.

For this reason, you may not be able to use Modular Avatar Shape Changer nor any other similar mesh alteration tools present in Modular Avatar.

Unity 6.4 (old versions of Basis Framework)

If you are on an old version of Basis Framework that is still using Unity 6.4, the following versions were known to work:

• Modular Avatar 1.17.0-beta.0
• NDMF 1.11.0
• Chillaxins 1.2.0 (Download directly here)