v1.0.1

v1.0.0...v1.0.1

---

🐛 Bugfixes

56b4617: VRMHumanBoneParentMap, fix parent of shoulders, chest → upperChest

📄 Docs

d66f171: Fix version on migration guide

v1.0.0

v0.6.11...v1.0.0

---

The initial release of v1 of three-vrm.

three-vrm v1 supports VRM1.0, which is a new version of VRM format (the previous version of VRM is also supported, don't worry!). It also adopts the GLTFLoader plugin system which is a relatively new feature of GLTFLoader.

There are a lot of breaking changes! See the migration guide for more info.

---

Wanna see the diff since v1.0.0-beta.19 ?

v1.0.0-beta.19...v1.0.0

---

🚨 BREAKING CHANGES

• #1039: The constructor interface of VRMHumanoid has been changed. The second argument is now optional object instead of a bare boolean

---

💡 Behavior Changes

• #1012: MToon, behavior of outlineLightingMix, Follow the latest spec
• #1049: MToon, default value of matcapFactor is now [0, 0, 0] instead of [1, 1, 1]

🐛 Bugfixes

• #1038: Fix lookAt when head orientation is non-uniform
• #1039: The constructor interface of VRMHumanoid has been changed
• #1042: Fix deprecation warnings of VRMSpringBoneManager
• #1048: Expressions, fix the behavior of isBinary

📄 Docs

• #1029: Add a doc comment to VRMUtils.rotateVRM0
• #1030: Resolve term inconsistencies, "VRM0.X" → "VRM0.0"
• #1032: packages/three-vrm/examples/humanoidAnimation, Support new mixamo motions
• #1034: Fix examples which still uses getBoneNode instead of getNormalizedBoneNode
• #1037, #1044: Add the migration guide

🧹 Chores

• #1033: Install eslint-config-mdcs to make examples Mr.doob's Code Style™-compliant
• #1046: We can now specify rollup serve port using env PORT
• #1047: Release preparation of v1.0.0

v1.0.0-beta.19

v1.0.0-beta.18...v1.0.0-beta.19

---

We now have Migration Guide from v0.6.x !!

https://github.com/pixiv/three-vrm/blob/1.0/docs/migration-guide-1.0.md

---

🚨 BREAKING CHANGES

• #889: The interface of VRMHumanoid has been largely reworked. See the description of the pull request.
• #1031: Constructor of VRM, meta and humanoid are no longer optional.

---

✨ New Features

• #889: Normalized human bones
  • The feature to control human bones with different rest orientations with ease
  • The interface of VRMHumanoid has been largely reworked. See the description of the pull request.
• #889: New exported const VRMHumanBonesList: A list of VRMHumanBoneName, dependency aware
• #889: New exported const VRMHumanBoneParentMap: A map from VRMHumanBoneName to its parent VRMHumanBoneName
• #1020: Support material binds of VRM0.0 blend shape proxies
• #1026: Support the new MaterialColorBind type matcapColor

💡 Behavior Changes

• #889: Rename existing VRMHumanoid methods to distinguish them from their normalized variant
  • Previous names are still accessible but marked as deprecated
• #1031: VRM.meta and VRM.humanoid is no longer optional
  • GLTFLoader with VRMLoaderPlugin used to return an empty VRM even if the loaded glTF does not have VRM extension. Now it does not create a VRM.

🐛 Bugfixes

• #889: VRMHumanoidLoaderPluginOptions was not exported; fixed this

📄 Docs

• #889: New example humanoidAnimation, which loads a mixamo animation and play on the VRM model

📦 Deps

• #1014: Remove quicktype which is no longer used

v1.0.0-beta.18

v1.0.0-beta.17...v1.0.0-beta.18

---

🚨 BREAKING CHANGES

• #1001: Rename thumb bone names according to the VRM1.0 spec
  • leftThumbProximal -> leftThumbMetacarpal
  • leftThumbIntermediate -> leftThumbProximal
  • rightThumbProximal -> rightThumbMetacarpal
  • rightThumbIntermediate -> rightThumbProximal
• #1003: VRMSpringBoneManager, rename several members
  • get springBones -> get joints
  • addSpringBone() -> addJoint()
  • removeSpringBone() -> removeJoint()

---

💡 Behavior Changes

• #996: Giving helperRoot to VRMLoaderPlugin now automatically enables VRMHumanoidHelper
• #1001, #1004: Rename thumb bone names according to the VRM1.0 spec
  • leftThumbProximal -> leftThumbMetacarpal
  • leftThumbIntermediate -> leftThumbProximal
  • rightThumbProximal -> rightThumbMetacarpal
  • rightThumbIntermediate -> rightThumbProximal
• #1003: VRMSpringBoneManager, rename several members
  • get springBones -> get joints
  • addSpringBone() -> addJoint()
  • removeSpringBone() -> removeJoint()

🐛 Bugfixes

• #1002: SpringBone, Fix default value of gravityDir
• #1002: SpringBoneJoint.reset did not respect center space
• #1002: Gravity should be evaluated in world space instead of center space

v1.0.0-beta.17

v1.0.0-beta.16...v1.0.0-beta.17

---

✨ New Features

• #987: Add VRMHumanoidHelper

🐛 Bugfixes

• #995: MToon, Fix v0 compatible render queue parsing

v1.0.0-beta.16

v1.0.0-beta.15...v1.0.0-beta.16

---

💡 Behavior Changes

• #979: MToon now supports .emissiveIntensity
  • This supports KHR_materials_emissive_strength
• #983: SpringBone now supports the deserialization of center
  • See: vrm-c/vrm-specification#374

🐛 Bugfixes

• #983: SpringBone colliders are now evaluated in world space

v1.0.0-beta.15

v1.0.0-beta.14...v1.0.0-beta.15

---

📄 Docs

• #977: Fix aim.html of node_constraint examples

📦 Deps

• #978: Bump Three.js to r140

v1.0.0-beta.14

v1.0.0-beta.13...v1.0.0-beta.14

---

🐛 Bugfixes

• #974: Fix the behavior of springBone

v1.0.0-beta.13

v1.0.0-beta.12...v1.0.0-beta.13

---

🚨 BREAKING CHANGES

• #964: There are a lot of breaking changes around LookAt API
  • VRMLookAt.euler is deprecated. Use yaw and pitch, or getEuler() instead
  • Protected method VRMLookAt._calcEuler() is removed. Use VRMLookAt.lookAt() instead
  • The set value to VRMLookAt is now not applied to its applier immediately
    • VRMLookAt has its internal flag _needsUpdate, and it's applied when we call its update()
  • VRMLookAtApplier.lookAt() is deprecated. Use applyYawPitch() instead
  • VRMLookAtBoneApplier now requires faceFront in order to use with VRM0.0 models
    • It should be handled automatically if you use VRMLookAtLoaderPlugin
• #973: VRMC_node_constraint has been promoted from 1.0-draft to 1.0-beta

👾 Known Issues

• SpringBone behaves wrong
  • #974 should fix this

---

💡 Behavior Changes

• #964: LookAt APIs now mainly use yaw-pitch angles instead of Euler
  • Add an ability to set yaw and pitch manually

    vrm.lookAt.yaw = 30.0 * Math.sin(time)
    vrm.lookAt.pitch = 30.0 * Math.cos(time)

• #964: LookAt APIs now mainly use yaw-pitch angles instead of Euler
• #973: VRMC_node_constraint has been promoted from 1.0-draft to 1.0-beta

🐛 Bugfixes

• #964: VRM0.0 and VRM1.0 now look in the same direction when we manually set yaw and pitch (formerly euler)
• #964: VRMLookAtBoneApplier is now compatible with eye bones witch have non-uniform rest rotations
• #964: VRMLookAtHelper now works properly on VRM0.0

💻 Refactors

• #945: Clean up spring bone codes

v1.0.0-beta.12

v1.0.0-beta.11...v1.0.0-beta.12

---

🚨 BREAKING CHANGES 🚨

• #960: Enums of AimConstraint are based on the new spec

---

💡 Behavior Changes

• #960: Enums of AimConstraint are based on the new spec