npm / @pixiv/three-vrm

@pixiv/three-vrm

What changed in @pixiv/three-vrm 2 to 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-12.

5 breaking1 new APIs and options3 behavior and defaults5 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@pixiv/three-vrm 313 changes

MToon now respects rimLightingMixFactor; models with a non-default value may show visual differences.
3.5.0release notes
Adds a WebGPU-compatible MToon material via the NodeMaterial system; select it with the materialType option of MToonMaterialLoaderPlugin. Requires Three.js r167 or later.
3.0.0release notes
The default is now false. Set plugin.metaPlugin.needThumbnailImage to true if you use meta.thumbnailImage.
3.0.0release notes
TypeScript 3.9 or earlier is no longer supported; users must update TypeScript.
3.0.0release notes

Warns when a VRM0 morph bind target mesh is not found.
3.5.4release notes
removeUnnecessaryVertices now supports interleaved buffers.
3.5.0release notes
This field might contain materials other than MToonMaterial, namely MToonNodeMaterial.
3.0.0release notes

Handles negative node indices (-1) in VRM0.0 humanoid bones.
3.5.4release notes
Texture assignment error handling was improved in the MToon loader.
3.5.3release notes
Error handling was improved for VRM0 import.
3.5.3release notes
Error handling was improved for VRMSpringBoneLoaderPlugin.
3.5.3release notes
MToon shadow casting with SpotLight was fixed.
3.4.5release notes