# What changed in @pixiv/three-vrm

> 14 changes in @pixiv/three-vrm 2 to 3 from its official release notes, upgrade guides and advisories: 5 breaking, 1 new APIs and options. Each one cited. Sources checked 2026-11-12. HTML: https://unstale.sh/npm/@pixiv/three-vrm/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @pixiv/three-vrm 3

### Breaking changes

- MToon now respects rimLightingMixFactor; models with a non-default value may show visual differences. (3.5.0) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.5.0)
- 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.0) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.0.0)
- The default is now false. Set plugin.metaPlugin.needThumbnailImage to true if you use meta.thumbnailImage. (3.0.0) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.0.0)
- TypeScript 3.9 or earlier is no longer supported; users must update TypeScript. (3.0.0) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.0.0)

### New APIs and options

- Adds resetValues to VRMExpressionManager. (3.0.0) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.0.0)

### Behavior and default changes

- Warns when a VRM0 morph bind target mesh is not found. (3.5.4) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.5.4)
- removeUnnecessaryVertices now supports interleaved buffers. (3.5.0) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.5.0)
- This field might contain materials other than MToonMaterial, namely MToonNodeMaterial. (3.0.0) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.0.0)

### Fixes and other changes

- Handles negative node indices (-1) in VRM0.0 humanoid bones. (3.5.4) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.5.4)
- Texture assignment error handling was improved in the MToon loader. (3.5.3) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.5.3)
- Error handling was improved for VRM0 import. (3.5.3) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.5.3)
- Error handling was improved for VRMSpringBoneLoaderPlugin. (3.5.3) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.5.3)
- MToon shadow casting with SpotLight was fixed. (3.4.5) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v3.4.5)

## @pixiv/three-vrm 2

### Breaking changes

- Support for Three.js r136 and prior is dropped. (2.0.0) — [release notes](https://github.com/pixiv/three-vrm/releases/tag/v2.0.0)