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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
docs(avatars): mark three-vrm live, add VRM/VRoid canonicalize regression test, changelog entry
nirholasb9a939fed153
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 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-11diff --git a/data/changelog.json b/data/changelog.jsonindex 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.mdindex 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 andEach 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 pagediff --git a/public/changelog-recent.json b/public/changelog-recent.jsonindex 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.jsonindex 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.xmlindex 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 <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.</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.jsonindex 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.jsindex 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.jsindex 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', () => {