Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

docs(avatars): mark three-vrm live, add VRM/VRoid canonicalize regression test, changelog entry

nirholasb9a939fed153
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2e973b604..76f84b285 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr
- **Docs · Engine QA** (`/docs/engine-qa`): A free real-time-engine fitness grade for any 3D model: draw calls, material count, texel density, a per-level LOD triangle budget, and whether the mesh is cheap and closed enough to use as its own physics collider.
- **<agent-3d> gets model-viewer's AR contract: ar-modes, variants, hotspots, and /ar drops the third-party CDN**: <agent-3d> now matches the AR/viewer contract the market expects from model-viewer (Apache-2.0): ar-modes picks which launch paths to try (WebXR, Scene Viewer, Quick Look), ar-placement anchors floor or wall, ios-src supplies a pre-baked USDZ or the element generates a best-effort one on device, variant-name switches a GLB's real KHR_materials_variants materials live, and any element with slot="hotspot" tracks a 3D position and flies the camera to a saved orbit on click. /avatars/:id/ar and /agents/:id/ar (pages/ar.html) now run entirely on <agent-3d ar>; the page no longer loads a third-party viewer from a CDN. (`/avatars`) `[feature]`
- **Engine QA: a free real-time-engine fitness grade, plus real LOD chains**: A new free grade answers the question a game engine's import step asks that neither glTF validation nor simulation readiness does: draw calls, material count, texel density against the mesh's real-world size, a per-level triangle budget for a LOD chain, and whether the mesh is cheap and closed enough to use as its own physics collider. GET/POST /api/3d/engine-qa grades any public GLB (format=stl exports a watertight mesh for printing); the same browser-only checks run with zero network cost in Rig Doctor, and the full grade with a one-click upgrade in the GLB viewer, through a shared <engine-qa> panel component. The underlying LOD builder (packages/glb-tools's buildLodChain, real meshoptimizer decimation tagged with MSFT_lod) is now also available on generation: send { "lods": true } to POST /api/forge and the finished creation gets a combined LOD-chain variant alongside its delivered mesh, the same opt-in, fire-and-forget pattern as the existing web-delivery variant. (`/docs/engine-qa`) `[feature]`
+- **Real VRM avatars: spring bones, expressions, and .vrma clips via @pixiv/three-vrm**: The hand-rolled VRM loader is gone. vrm-boot.js now registers the real VRMLoaderPlugin (@pixiv/three-vrm) on the three.ws GLTFLoader, so VRM 0.x and 1.0 avatars get genuine MToon materials, spring-bone physics, node constraints, look-at, and all 18 expression presets, driven live by vrm.update(delta) in AnimationManager and mapped onto the ARKit-52 face-capture driver. VRMAnimationLoaderPlugin loads .vrma clips into the same retargeting pipeline that drives non-VRM humanoids, so a single clip plays on either. The Ready Player Me import page (/import-rpm) now accepts .vrm files alongside .glb, and a long-standing bug that 400'd every import at the final save step (it sent an invalid source value) is fixed. docs/avatar-engines.md upgrades three-vrm from interop to live. (`/docs/avatar-engines`) `[feature, fix]`
- **Three new engine bridges: Unity, Godot, and Unreal, one prompt to a mesh in your editor**: A shared contract (specs/ENGINE_BRIDGE.md) and three real, independent implementations: a Unity UPM package that imports with glTFast, a Godot addon that imports with Godot's own native GLTFDocument, and an Unreal plugin that imports through Unreal's Interchange glTF pipeline. Each one calls only the public Forge API (POST /api/forge to submit, GET /api/forge?job=<id> to poll, a plain HTTPS GET to download), the same free-first routing and anonymous x-forge-client auth every other Forge caller gets, with the same four import settings (generate_colliders, import_materials, scale, destination) mapped onto each engine's own equivalent. A dropdown and a Generate button in each editor: type a prompt, get a mesh dropped into your scene. (`/docs/engine-bridges`) `[feature, sdk]`
## 2026-10-11
diff --git a/data/changelog.json b/data/changelog.json
index 67f60db0b..461978ce0 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -1,6 +1,16 @@
{
"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security, desktop (desktop entries become the desktop app's release notes). `link` is optional and must be a live three.ws path.",
"entries": [
+ {
+ "date": "2026-10-12",
+ "title": "Real VRM avatars: spring bones, expressions, and .vrma clips via @pixiv/three-vrm",
+ "link": "/docs/avatar-engines",
+ "summary": "The hand-rolled VRM loader is gone. vrm-boot.js now registers the real VRMLoaderPlugin (@pixiv/three-vrm) on the three.ws GLTFLoader, so VRM 0.x and 1.0 avatars get genuine MToon materials, spring-bone physics, node constraints, look-at, and all 18 expression presets, driven live by vrm.update(delta) in AnimationManager and mapped onto the ARKit-52 face-capture driver. VRMAnimationLoaderPlugin loads .vrma clips into the same retargeting pipeline that drives non-VRM humanoids, so a single clip plays on either. The Ready Player Me import page (/import-rpm) now accepts .vrm files alongside .glb, and a long-standing bug that 400'd every import at the final save step (it sent an invalid source value) is fixed. docs/avatar-engines.md upgrades three-vrm from interop to live.",
+ "tags": [
+ "feature",
+ "fix"
+ ]
+ },
{
"date": "2026-10-12",
"title": "<agent-3d> gets model-viewer's AR contract: ar-modes, variants, hotspots, and /ar drops the third-party CDN",
diff --git a/docs/avatar-engines.md b/docs/avatar-engines.md
index 6dc05ab64..5fffea2be 100644
--- a/docs/avatar-engines.md
+++ b/docs/avatar-engines.md
@@ -62,7 +62,7 @@ Mesh and glTF output can be animated by the skinned-mesh pipeline. Gaussian and
Each entry also carries an `integrationNote`, one sentence naming the specific three.ws surface or bone-mapping involved, so `reference` never reads as a shrug.
-The current distribution is 2 `live`, 3 `interop`, 3 `splat`, and 16 `reference`. That last number is the point of the atlas: most of the highest-fidelity work in this field is research code under a non-commercial license, and three.ws deliberately does **not** wire any of it into the paid generation backend. Only commercial-use mesh engines deep-link into the live pipeline. Non-commercial research engines are surfaced with their repository and paper for self-hosted and academic use, and that is the whole extent of the relationship.
+The current distribution is 3 `live`, 2 `interop`, 3 `splat`, and 16 `reference`. That last number is the point of the atlas: most of the highest-fidelity work in this field is research code under a non-commercial license, and three.ws deliberately does **not** wire any of it into the paid generation backend. Only commercial-use mesh engines deep-link into the live pipeline. Non-commercial research engines are surfaced with their repository and paper for self-hosted and academic use, and that is the whole extent of the relationship.
## The registry
@@ -114,7 +114,7 @@ Every field below is reproduced from [`src/avatar-engines-data.js`](../src/avata
| Mixamo | Adobe | 2008 | gltf | Free for use (Adobe terms) | Yes | live | Cloud service |
| Ready Player Me (retired) | Ready Player Me (Netflix) | 2020 | gltf | Commercial SDK (service discontinued) | No | reference | Cloud API (offline) |
| VRM / UniVRM | VRM Consortium · pixiv | 2018 | gltf | MIT | Yes | interop | Client |
-| three-vrm | pixiv | 2020 | gltf | MIT | Yes | interop | Client (Three.js) |
+| three-vrm | pixiv | 2020 | gltf | MIT | Yes | live | Client (Three.js) |
| Avaturn | Avaturn | 2022 | gltf | Commercial SDK | Yes | interop | Cloud API |
## Using the page
diff --git a/public/changelog-recent.json b/public/changelog-recent.json
index 1914fcfc5..165425b1c 100644
--- a/public/changelog-recent.json
+++ b/public/changelog-recent.json
@@ -1,11 +1,11 @@
{
- "generated_at": "2026-10-12T02:18:07.365Z",
+ "generated_at": "2026-10-12T05:36:16.742Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
"url": "https://three.ws"
},
- "total": 4039,
+ "total": 4040,
"complete": false,
"full_feed": "/changelog.json",
"entries": [
@@ -59,6 +59,17 @@
"feature"
]
},
+ {
+ "date": "2026-10-12",
+ "type": "update",
+ "title": "Real VRM avatars: spring bones, expressions, and .vrma clips via @pixiv/three-vrm",
+ "summary": "The hand-rolled VRM loader is gone. vrm-boot.js now registers the real VRMLoaderPlugin (@pixiv/three-vrm) on the three.ws GLTFLoader, so VRM 0.x and 1.0 avatars get genuine MToon materials, spring-bone physics, node constraints, look-at, and all 18 expression presets, driven live by vrm.update(delta) in AnimationManager and mapped onto the ARKit-52 face-capture driver. VRMAnimationLoaderPlugin loads .vrma clips into the same retargeting pipeline that drives non-VRM humanoids, so a single clip plays on either. The Ready Player Me import page (/import-rpm) now accepts .vrm files alongside .glb, and a long-standing bug that 400'd every import at the final save step (it sent an invalid source value) is fixed. docs/avatar-engines.md upgrades three-vrm from interop to live.",
+ "link": "/docs/avatar-engines",
+ "tags": [
+ "feature",
+ "fix"
+ ]
+ },
{
"date": "2026-10-12",
"type": "update",
@@ -1532,16 +1543,6 @@
"tags": [
"launch"
]
- },
- {
- "date": "2026-10-09",
- "type": "launch",
- "title": "Workbench",
- "summary": "A desktop-style image-to-3D workspace in the browser. Drop a photo, run it through a visual workflow of real GPU nodes (background removal, mesh generation, remeshing, auto-rigging, AI material restyle), then smooth, decimate and export GLB, OBJ, STL or PLY. Build and save your own workflows in a node editor. Free, no signup.",
- "link": "/workbench",
- "tags": [
- "launch"
- ]
}
]
}
diff --git a/public/changelog.json b/public/changelog.json
index 84f3e02d7..9ff1d1c62 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-10-12T02:18:07.341Z",
+ "generated_at": "2026-10-12T05:36:16.720Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
@@ -56,6 +56,17 @@
"feature"
]
},
+ {
+ "date": "2026-10-12",
+ "type": "update",
+ "title": "Real VRM avatars: spring bones, expressions, and .vrma clips via @pixiv/three-vrm",
+ "summary": "The hand-rolled VRM loader is gone. vrm-boot.js now registers the real VRMLoaderPlugin (@pixiv/three-vrm) on the three.ws GLTFLoader, so VRM 0.x and 1.0 avatars get genuine MToon materials, spring-bone physics, node constraints, look-at, and all 18 expression presets, driven live by vrm.update(delta) in AnimationManager and mapped onto the ARKit-52 face-capture driver. VRMAnimationLoaderPlugin loads .vrma clips into the same retargeting pipeline that drives non-VRM humanoids, so a single clip plays on either. The Ready Player Me import page (/import-rpm) now accepts .vrm files alongside .glb, and a long-standing bug that 400'd every import at the final save step (it sent an invalid source value) is fixed. docs/avatar-engines.md upgrades three-vrm from interop to live.",
+ "link": "/docs/avatar-engines",
+ "tags": [
+ "feature",
+ "fix"
+ ]
+ },
{
"date": "2026-10-12",
"type": "update",
diff --git a/public/changelog.xml b/public/changelog.xml
index 7be5acefa..433d7f0a5 100644
--- a/public/changelog.xml
+++ b/public/changelog.xml
@@ -46,6 +46,14 @@
<category>feature</category>
<description>A new free grade answers the question a game engine's import step asks that neither glTF validation nor simulation readiness does: draw calls, material count, texel density against the mesh's real-world size, a per-level triangle budget for a LOD chain, and whether the mesh is cheap and closed enough to use as its own physics collider. GET/POST /api/3d/engine-qa grades any public GLB (format=stl exports a watertight mesh for printing); the same browser-only checks run with zero network cost in Rig Doctor, and the full grade with a one-click upgrade in the GLB viewer, through a shared &lt;engine-qa&gt; panel component. The underlying LOD builder (packages/glb-tools's buildLodChain, real meshoptimizer decimation tagged with MSFT_lod) is now also available on generation: send { &quot;lods&quot;: true } to POST /api/forge and the finished creation gets a combined LOD-chain variant alongside its delivered mesh, the same opt-in, fire-and-forget pattern as the existing web-delivery variant.</description>
</item>
+ <item>
+ <title>Real VRM avatars: spring bones, expressions, and .vrma clips via @pixiv/three-vrm</title>
+ <link>https://three.ws/docs/avatar-engines</link>
+ <guid isPermaLink="false">2026-10-12:Real VRM avatars: spring bones, expressions, and .vrma clips via @pixiv/three-vrm</guid>
+ <pubDate>Mon, 12 Oct 2026 12:00:00 GMT</pubDate>
+ <category>feature</category>
+ <description>The hand-rolled VRM loader is gone. vrm-boot.js now registers the real VRMLoaderPlugin (@pixiv/three-vrm) on the three.ws GLTFLoader, so VRM 0.x and 1.0 avatars get genuine MToon materials, spring-bone physics, node constraints, look-at, and all 18 expression presets, driven live by vrm.update(delta) in AnimationManager and mapped onto the ARKit-52 face-capture driver. VRMAnimationLoaderPlugin loads .vrma clips into the same retargeting pipeline that drives non-VRM humanoids, so a single clip plays on either. The Ready Player Me import page (/import-rpm) now accepts .vrm files alongside .glb, and a long-standing bug that 400'd every import at the final save step (it sent an invalid source value) is fixed. docs/avatar-engines.md upgrades three-vrm from interop to live.</description>
+ </item>
<item>
<title>Three new engine bridges: Unity, Godot, and Unreal, one prompt to a mesh in your editor</title>
<link>https://three.ws/docs/engine-bridges</link>
diff --git a/public/features.json b/public/features.json
index 28b0ffc76..54edd6565 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-10-12T02:18:07.327Z",
+ "generated_at": "2026-10-12T05:36:16.707Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",
diff --git a/src/avatar-engines-data.js b/src/avatar-engines-data.js
index dae258a21..da8c013a3 100644
--- a/src/avatar-engines-data.js
+++ b/src/avatar-engines-data.js
@@ -611,8 +611,8 @@ export const ENGINES = Object.freeze([
license: 'MIT',
commercial: true,
compute: 'Client (Three.js)',
- integration: 'interop',
- integrationNote: 'The Three.js VRM loader, same renderer family as the three.ws viewer, so VRM heads/bodies render with no extra runtime.',
+ integration: 'live',
+ integrationNote: 'vrm-boot.js registers the real VRMLoaderPlugin on the three.ws GLTFLoader: VRM 0.x and 1.0 avatars get genuine spring-bone physics, node constraints, look-at, and the 18 expression presets, driven live by vrm.update(delta) in AnimationManager.',
blurb: 'The official Three.js loader for VRM avatars: spring-bone physics, expressions, and look-at, in the browser.',
links: {
repo: 'https://github.com/pixiv/three-vrm',
diff --git a/tests/glb-canonicalize.test.js b/tests/glb-canonicalize.test.js
index 10e8989b0..b982abda1 100644
--- a/tests/glb-canonicalize.test.js
+++ b/tests/glb-canonicalize.test.js
@@ -1421,6 +1421,58 @@ describe('canonicalizeGLBBones (full GLB rewrite)', () => {
const jLen = dv.getUint32(12, true);
expect(20 + jLen).toBe(buffer.byteLength);
});
+
+ // best3d order 075 task 4: the import landing accepts a .vrm export and
+ // repairs its rig through this same function before upload. VRM files are
+ // ordinary GLB containers with a VRoid-style skeleton plus VRM-specific
+ // extension JSON (VRMC_vrm's humanBones point at node *indices*, not
+ // names). canonicalizeGLBBones must rename the joints the Mixamo clip
+ // library needs without touching node order or any extension block, since
+ // a shifted index would break @pixiv/three-vrm's humanoid resolution.
+ it('renames VRoid joints in a VRM 1.0 GLB without disturbing the VRMC_vrm/VRMC_springBone extension blocks', () => {
+ const nodes = [
+ { name: 'J_Bip_C_Hips', children: [1] },
+ { name: 'J_Bip_C_Spine', children: [2] },
+ { name: 'J_Bip_L_UpperArm' },
+ { name: 'J_Sec_Hair1_01' }, // VRM spring-bone joint, not a humanoid bone
+ ];
+ const vrmExtension = {
+ specVersion: '1.0',
+ humanoid: {
+ humanBones: {
+ hips: { node: 0 },
+ spine: { node: 1 },
+ leftUpperArm: { node: 2 },
+ },
+ },
+ };
+ const springBoneExtension = {
+ specVersion: '1.0',
+ colliderGroups: [],
+ springs: [{ name: 'hair', joints: [{ node: 3, stiffness: 0.5, gravityPower: 0.5, gravityDir: [0, -1, 0], dragForce: 0.3, hitRadius: 0.02 }] }],
+ };
+ const ab = buildGLB({
+ nodes,
+ skins: [{ joints: [0, 1, 2, 3] }],
+ extensionsUsed: ['VRMC_vrm', 'VRMC_springBone'],
+ extensions: { VRMC_vrm: vrmExtension, VRMC_springBone: springBoneExtension },
+ });
+
+ const { buffer, renamed } = canonicalizeGLBBones(ab);
+ expect(renamed).toBe(3); // the three humanoid joints; the spring-bone-only node is untouched
+
+ const json = readGLBJson(buffer);
+ expect(json.nodes[0].name).toBe('Hips');
+ expect(json.nodes[1].name).toBe('Spine');
+ expect(json.nodes[2].name).toBe('LeftArm');
+ expect(json.nodes[3].name).toBe('J_Sec_Hair1_01');
+
+ // The VRM extensions reference nodes by index, never by name, so the
+ // rename must leave both blocks byte-for-byte identical.
+ expect(json.extensionsUsed).toEqual(['VRMC_vrm', 'VRMC_springBone']);
+ expect(json.extensions.VRMC_vrm).toEqual(vrmExtension);
+ expect(json.extensions.VRMC_springBone).toEqual(springBoneExtension);
+ });
});
describe('canonicalizeArmatureOrientation', () => {