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(campaign): draft the neutral bring-your-avatar landing copy and post set, and log the two owner-gated store and campaign orders

nirholasbf077bdf8c6d
diff --git a/docs/orphaned-avatar-campaign.md b/docs/orphaned-avatar-campaign.md
new file mode 100644
index 000000000..c4efef786
--- /dev/null
+++ b/docs/orphaned-avatar-campaign.md
@@ -0,0 +1,86 @@
+# Bring your avatar: landing copy and post set (draft for owner approval)
+
+Status: draft. Nothing here is published or posted. The owner approves the wording, then posts it. Wording is neutral on purpose: it names no company and makes no comparison, so it stays true whichever avatar service a reader came from.
+
+## Audience
+
+People whose avatar lived in a cross-game avatar service that has since closed its hosted creator and public endpoints. Their exported `.glb` and `.vrm` files still load anywhere, but the apps and embeds that depended on the hosted service are left without a home for them. These readers already own a file. They need a place where that file keeps working and gains a purpose.
+
+## What is true today (the only facts the copy may use)
+
+Every line below is shipped and covered by a test or a live page. Sources: [import page](https://three.ws/import/rpm), `src/game/vrm-loader.js`, `src/game/vrm-expressions.js`, `src/animation-retarget.js`, `src/glb-canonicalize.js`, `tests/vrm-real.test.js`, `tests/import-rpm-source.test.js`, [Avatar engines](./avatar-engines.md), [Embedding](./embedding.md).
+
+| Claim | Ground truth |
+|---|---|
+| Import by URL or by file | `/import/rpm` has a URL tab and a file tab. The server fetches URLs, so cross-origin rules do not block it. |
+| `.glb` and `.vrm` accepted | The file tab accepts both. VRM 0.x and 1.0 load through the real `@pixiv/three-vrm` plugin. |
+| VRM features work | MToon materials, spring-bone physics, node constraints, look-at and the 18 expression presets (`tests/vrm-real.test.js`). |
+| `.vrma` animation clips play | Loaded through `VRMAnimationLoaderPlugin` and retargeted, so one clip plays on a VRM and on a Mixamo-named humanoid. |
+| Voice and face capture drive VRM avatars | Expression presets map onto the ARKit-52 driver (`src/game/vrm-expressions.js`). |
+| Any humanoid rig animates | Bone names from Mixamo, Avaturn, Unreal, VRM/VRoid, Daz, MakeHuman, Blender and simple rigs map to one canonical set, then the idle and walk clip library applies. A rig that cannot be skeleton-driven falls back to the default rig, never a T-pose. |
+| The avatar is yours | It is stored in your account as a `.glb`, ready to become an agent with a wallet, and embeds anywhere with `<agent-3d>`. |
+| Import reliability | A bug that made every import fail at the final save step was fixed with a regression test (`tests/import-rpm-source.test.js`). |
+
+Do not claim: any count of imported avatars, any migration tool for a specific service, partnership or endorsement language, or any statement about another company's business.
+
+## Landing copy
+
+**Headline:** Your avatar file keeps working here.
+
+**Subhead:** Bring the `.glb` or `.vrm` you already have. It loads, moves and talks on three.ws, and you can put it on any website with one tag.
+
+**Primary button:** Import my avatar (links to `/import/rpm`)
+
+**Three points**
+
+1. **Bring it as it is.** Paste the file's URL or upload it. We read VRM 0.x and 1.0 with full support for toon materials, hair and cloth physics and facial expressions.
+2. **It moves right away.** Whatever rig it has, it plays the idle and walk library. VRM animation clips (`.vrma`) play too, and voice or camera capture can drive its face.
+3. **Give it a job.** Turn it into an agent with its own page and Solana wallet, or embed it on your site:
+
+```html
+<script type="module" src="https://three.ws/agent-3d/latest/agent-3d.js"></script>
+<agent-3d src="https://example.com/my-avatar.glb"></agent-3d>
+```
+
+**How to find your file:** if your app loaded the avatar from a link, open the browser's developer tools, switch to the Network tab, filter by `.glb`, and copy the request URL. If you saved the file earlier, use the file tab.
+
+**Footer line:** Free to import. Your file stays yours.
+
+Implementation note: the existing page `pages/import-rpm.html` already is the destination and is marked `noindex`. Publishing this copy as a public page means adding a `data/pages.json` entry, removing `noindex`, and a deploy, which are owner-gated. The wording above is ready to drop into that page.
+
+## Post set (not posted)
+
+Each post links to `https://three.ws/import/rpm`. Add the image from a real import screenshot taken by the owner. Tone: friendly opening, technical detail after.
+
+**Post 1, launch (X)**
+If you have an avatar file sitting on your drive and nowhere to use it, bring it to three.ws. Paste a link or drop a .glb or .vrm and it moves, talks and embeds on any site. Free to import.
+
+**Post 2, VRM depth (X)**
+VRM support on three.ws is the real thing: MToon toon shading, spring-bone hair and cloth, 18 expression presets and .vrma animation clips. Same clip, any humanoid rig. Voice and camera capture drive the face.
+
+**Post 3, one tag (X)**
+Put your avatar on your website with one tag:
+`<agent-3d src="your-avatar.glb"></agent-3d>`
+No account needed to embed. Import yours at three.ws/import/rpm.
+
+**Post 4, make it an agent (X)**
+An avatar is better with a purpose. Import it, give it a personality, and it becomes an agent with a public page and its own Solana wallet. $THREE holders and builders are already doing this.
+
+**Post 5, how-to thread (X, 4 parts)**
+1. Find your avatar's file: open dev tools, Network tab, filter by .glb, copy the URL.
+2. Open three.ws/import/rpm and paste it, or upload the file.
+3. Pick a name. Your avatar is saved to your account.
+4. Embed it, animate it, or turn it into an agent.
+
+**Long-form article outline (blog or community forum)**
+- Friendly opening: what it feels like to own an avatar file and want it to keep working.
+- What import accepts and where the file ends up.
+- VRM in depth: shading, physics, expressions, `.vrma`, one clip across rigs (technical middle).
+- Embedding with `<agent-3d>` and driving moods from page code.
+- Turning an avatar into an agent: page, wallet, skills.
+- Ecosystem and partners: list only partner designations already published in the repo's partner docs, with their exact wording.
+- Technical appendix: bone canonicalization, retargeting, how expressions map to ARKit-52.
+
+## Owner step
+
+Approve this wording and post it. Publishing the public page is the single command-level step: add the `data/pages.json` entry, drop `noindex` from `pages/import-rpm.html`, and deploy. Nothing else is outstanding.
diff --git a/prompts/finish/_context/best3d-PROGRESS.md b/prompts/finish/_context/best3d-PROGRESS.md
index 1bd2df205..cf0fe57e4 100644
--- a/prompts/finish/_context/best3d-PROGRESS.md
+++ b/prompts/finish/_context/best3d-PROGRESS.md
@@ -149,3 +149,11 @@ Append a dated entry per closed order, with commit SHAs.
- 2026-10-23: order 081 (splat parity) re-derived and PARTIALLY closed; the order file stays because only the live TripoSplat GPU step remains. Step 0 found Spark 2.3.1 with the LoD tree (`createLodSplats`, auto above 50k splats), the 25 camera hotspot cap, saved camera views, the camera timeline and in-browser video export already shipped (bd61fbd99, 3bd57493d, b72233fb8). Spark's `paged` option is deliberately not wired: it only streams `-lod-N` chunk files over HTTP and has no path for an in-memory buffer (documented in `src/splat-stage.js`). Gap found by driving the real Splat Viewer in Playwright with a real public .splat capture: video export returned an empty 110-byte WebM because the recorder sampled the canvas on a timer. Fixed (one `requestFrame` per rendered frame, two-frame tail flush, empty-output guard), with `tests/splat-hotspots.test.js` (11 tests: sampler, 25 cap, export flow). Re-run after the fix produced a 6.7 KB WebM that Chromium decodes (650x446). Caveat: the host was at load 60 to 120 on 32 cores with software GL, so only a 3000-splat prefix of the real capture was exported; the full 281k-splat file loaded and hotspots worked but rendered about 1 fps there.
- Verified: `tests/splat-viewer-page.test.js`, `tests/splat-hotspots.test.js`, `tests/api/forge-splat.test.js` pass; `workers/model-triposplat/test_splat_prep.py` 6 passed; `workers/model-triposplat` README, STRUCTURE.md fleet row and changelog entry were already present (fulfils the triposplat README part of order 404); `check:rules` exit 0. `npm run build:pages` currently fails on another agent's changelog entry missing a tag, not this change.
- Still open, owner: deploy the TripoSplat worker, set MODEL_TRIPOSPLAT_URL, run one real image through `/api/forge-splat` (row in production-100-OWNER-ACTIONS.md), then delete the order file.
+
+- 2026-10-24: order 935 (best3d 08: engine-store publishing) built, owner-gated, order left open.
+ - Built: `scripts/package-engine-bridges.mjs` (`npm run package:engine-stores`) validates the Unity, Godot and Unreal bridges (required files, version agreement across engine manifest and listing, Apache-2.0 LICENSE, dash and unfinished-marker scan, listing limits) and writes deterministic zips plus icons and `dist/engine-stores/manifest.json`. Verified: all three PASS; two builds into different directories produced identical SHA-256 (unity `ab261c5b...`, godot `d3dd74d3...`, unreal `1a38a6502...`); `tests/package-engine-bridges.test.js` 8/8. Listing metadata in `docs/engine-store-listings/`, checklist in `docs/engine-store-publishing.md`. Unity package.json and the Unreal `.uplugin` gained documentation links.
+ - Owner action (one): log in to the publisher accounts and submit the three packages by the checklist (Unity Asset Store Tools upload, Godot Asset Library with a release-asset URL, Fab with a per-version Unreal build via `RunUAT BuildPlugin`). Unreal binaries need an Unreal install, absent here.
+ - Commit: `fb749a0a2`. Generated changelog artifacts (`npm run build:pages`) were rebuilt in the worktree but not committed, because they also carry other agents' uncommitted entries.
+- 2026-10-24: order 934 (best3d 07: orphaned-avatar campaign) drafted, owner-gated, order left open.
+ - Built: `docs/orphaned-avatar-campaign.md` holds the neutral landing copy, a five-post set and an article outline, with a claims table grounded in what order 075 shipped (`/import/rpm` URL and file import for `.glb` and `.vrm`, real three-vrm, `.vrma`, universal rig retargeting, the import save-step fix). No company is named; nothing is posted. No new public page was built: `pages/import-rpm.html` already is the destination and the repo pattern would need a `data/pages.json` entry, removing `noindex` and a deploy, all owner-gated. The doc is parked in `scripts/audit-docs.mjs` UNPUBLISHED_DOCS.
+ - Owner action (one): approve the wording, then post it and flip the page public (remove `noindex`, add the `data/pages.json` entry, deploy).
diff --git a/scripts/audit-docs.mjs b/scripts/audit-docs.mjs
index 0676ceebf..f1344c5f5 100644
--- a/scripts/audit-docs.mjs
+++ b/scripts/audit-docs.mjs
@@ -285,6 +285,7 @@ if (!explicitFiles.length) {
// CLAUDE.md requires explicit owner approval before that lands in
// a commit, so registering one is a decision, never a default.
const UNPUBLISHED_DOCS = new Map([
+ ['orphaned-avatar-campaign', 'owner-gated: landing copy and post drafts awaiting owner wording approval before anything is published'],
['x-mention-bot', 'internal: operator runbook for the dry-run X mention bot safety rules, public once the bot goes live'],
['x-mention-image3d', 'internal: operator notes for the dry-run X image-to-3D reply, public once the bot goes live'],
['agora', 'internal: strategy framing, not a reader-facing product doc'],