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(play): document the drivable fleet and tell holders a real car landed

nirholas37bcb9a54e75
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1fc6dc64b..f65e1f1f7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,11 +6,15 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr
## 2026-08-17
+- **Docs · Cars in /play: traffic and the drivable fleet** (`/docs/play-vehicles`): The Trench Car is the default car in every coin world: ambient traffic drives it and it is parked for you to take the wheel. How to drive, how a car is assembled from spec, physics and mesh, how the model is staged, and how to add another.
- **A shared ASL letter link now opens on that letter, not on A**: The manual alphabet at /asl-alphabet was audited end to end in a real browser, and six repairs came out of it. Sharing a letter was the worst of them: a /asl-alphabet?letter=W link built the whole page around the letter A and only corrected itself once the 3D avatar had finished downloading, so anyone on a slow connection read A's description, saw A's key lit and A's look-alike note for the entire wait, on a link that promised W. The page now reads the link before it builds anything, so the right letter is on the card from the first paint and the avatar simply catches up. The Spell anything box had the opposite problem: it reported an empty or unspellable word only in the small caption pinned to the avatar, which on a phone sits a full screen above the box you just typed in, so pressing Spell it with a word full of punctuation looked like a dead button. It now answers in its own line, right under the input, and while the hand is spelling it lays the word out letter by letter and lights each one as the hand reaches it, so a long word can be followed without scrolling back up to the A-to-Z grid. That caption itself was white text on a scrim too faint to read over a pale avatar or in light mode, and is now a proper legible chip. Opening the avatar picker no longer lets a keystroke through to sign a letter behind the dialog. Switching avatars used to leave 'Loading avatar…' on screen forever once the new one had arrived, which also meant screen readers were never told the load had finished. And the Spell panel is no longer stretched to the height of the drill beside it, which left a large empty box on desktop. (`/asl-alphabet`) `[fix, improvement]`
- **Avatar Studio now shows your whole avatar, and its Save button fits on a phone**: The studio camera was framing the base body from the shoulders to the knees: the face you were sculpting and the shoes you were picking were both outside the picture, and the only way to see them was to orbit the camera yourself every time the page loaded. The framing is now solved from the lens rather than guessed at, so a full-body shot really does hold the avatar head to toe, arms included, on any window shape, and the half-body and headshot views stay as tight as their names promise. On a 320px phone the top bar had been running past the edge of the screen and taking the Save avatar button with it, so a look built on a phone could not be saved at all; the bar now fits, with the Back and title labels standing down to make room. The tab strip on that same narrow layout had been hiding its labels without putting anything in their place, leaving six blank buttons, and now shows an icon per tab. The Parametric body badge that read 120+ sliders was white text on a white pill and invisible everywhere. A failed save now says the connection could not be reached and that your look is still there, instead of repeating the browser phrase Failed to fetch, and every accessory search box, every tab and the Back link now carry names a screen reader can read. Opening avatar-studio in local development also serves the same page production does, which it previously did not. (`/avatar-studio`) `[fix, improvement]`
+- **Avatar Studio survives an accessory outage, and tells you when it is putting a hat on**: The studio at /avatar-studio was audited end to end in a real browser: loading the base body, all six tabs, the colour swatches, the sculpt sliders, the motion library, undo and redo, and the loading, empty and error states, at phone, tablet and desktop widths. The worst finding was that a single failed request for the accessory catalogue took the entire studio down. The hats, glasses and earrings lists come from one file, and if that file did not load, the page replaced everything with a Retry screen, throwing away the 3D avatar it had already finished loading. Colours, sculpting, animation and saving need nothing from that catalogue, so they all now keep working, and only the three accessory tabs show a message explaining what is missing, with a Retry button that reloads just the catalogue. The Save, Reset, Randomise and Undo buttons were also on screen but not yet connected until that same request finished, so pressing them early did nothing at all and the tab strip sat empty; they are live from the first paint now. Putting on a hat downloads and fits a 3D model, which takes a few seconds, and until now the studio gave no sign it was working: the tile click looked ignored, and a hat that failed to download failed in complete silence. Every accessory change now shows what it is doing and says so plainly if it could not finish. Randomise no longer lists an accessory you are not actually wearing when its model fails to load. Pressing Undo then Redo quickly could leave the avatar and the list of what it is wearing disagreeing with each other; each step now settles correctly. Spinners also finally stop for people who have asked their device to reduce motion. (`/avatar-studio`) `[fix, improvement]`
- **Blockchain TVL by Chain is readable again, and its numbers can be copied**: The cross-chain leaderboard at /chains was audited end to end in a real browser: the live DeFiLlama board, the sortable columns, the row links out to each chain's page, and the loading, empty and error states, at phone, tablet and desktop widths. The page had briefly stopped working entirely. Its row-click helpers were declared twice in the same file, which is a syntax error, so the script never ran and the table sat on its grey loading bars forever. That is fixed and covered by a browser test so it cannot come back. Two real defects came out of the same pass. Every row navigated on any click, so dragging across a cell to copy a chain's TVL threw the selection away and opened that chain's page instead; a figure or a name can now be selected and copied, while a plain click still opens the chain. And the page wrapped the site navigation in a second page banner, leaving screen readers with two overlapping banner landmarks to pick between. The share bar beside each chain also stopped reading its percentage aloud a second time, since the dominance column right next to it already says it. (`/chains`) `[fix, improvement]`
- **Crypto Categories reads correctly in all 84 languages**: The sector leaderboard at /categories was audited end to end in a real browser: the table, the search box, the sortable columns, the paging, and the loading, empty, error and rate-limited states all behave, at phone, tablet and desktop widths. One real defect turned up, and it only showed outside English. The page's own summary line and the description search engines and link previews read were translated once against an older wording and had kept a dash where the English now uses a colon, so every non-English visitor saw punctuation the platform does not use, in the headline copy and in the shared-link preview. All 83 translated catalogs are corrected, with the full-width colon that Japanese, Korean and Chinese actually want rather than a Latin one. (`/categories`) `[fix]`
+- **Pausing a skill bundle is no longer permanent, and every tooltip fits on a phone**: The bundle builder at /bundles was audited end to end in a real browser: signing in, picking priced skills, the price panel and its backtest, publishing, the published list, and the loading, empty and error states, at phone, tablet and desktop widths. The worst finding was that Deactivate was a one-way door. It hid the bundle from buyers, which is correct, but it also removed it from the only page that could put it back, so a misclick permanently retired a bundle you had just priced. The button is now called Pause, a paused bundle stays on the page dimmed and clearly marked, and a Reactivate button puts it back on sale. Buyers still never see a paused bundle: the public list is unchanged, and paused ones are returned only to a signed-in owner of that agent. The small question-mark tooltips that explain every number on the page were also cut off at the edge of a phone screen, so four of the seven explanations were partly unreadable at 320 pixels wide; they now shift to stay on screen at any width. The sum of the parts and the suggested price were cramped into a broken-looking two-line squeeze on a narrow screen and now stack cleanly. Finally, a pricing error raised by one agent no longer sits on screen after you switch to another agent, where it read as a verdict on an agent it had never looked at. (`/bundles`) `[fix, improvement]`
- **The viewer's backdrop picker stops vanishing while you read it, and sharing no longer posts "Meet Agent"**: Five fixes to the 3D model viewer at /app. Opening the Backdrop picker and taking a few seconds to read the six choices used to make the picker fade out from under the cursor: the viewer hides its controls after five seconds of stillness, and the picker was not on the list of surfaces that keep them awake, so an open picker went invisible and unclickable while still counting as open. It now stays put until you choose a backdrop or close it, and the controls resume fading once it is shut. Typing in the animation search while the clips were still loading stacked a second, contradictory message under the first, so the panel read "Loading clips" and "No clips matching" at the same time, and clearing the box left behind the nonsense line "No clips matching" with nothing in the quotes; the search now stays quiet until there are clips to search. Sharing the viewer to X, Farcaster or Telegram published "Meet Agent", an internal placeholder name, for anyone who had not loaded an agent of their own, and now uses the generic line instead. The page also shipped a sign-in panel and a welcome card that its own stylesheet blanked unconditionally, four links nobody could ever reach, and the preview card shown when the page is shared described the platform instead of the viewer. The avatar gallery behind the Avatar button is now announced to screen readers as a named dialog. (`/app`) `[fix, improvement]`
+- **There is a real car in every coin world now, and you can get in and drive it**: The cars in a coin world used to be boxes: a box on wheels driving the ring road, and a slightly different box parked for you to drive. Both are now the Trench Car, a real community model published to the three.ws avatar gallery, so the car that drives past you on the road is the same car parked at the plaza that you can get into. Walk within a few metres of one, press F (or tap the car on a phone) and drive it with WASD and the on-screen pedals, with a working speedometer, brake lights and a handbrake. Your driver now actually sits in the seat: every car in the world had been placing its driver standing on the roof, and other players saw them there too, because the seat was measured from the wrong point. Drivers are now seated inside the car in a seated pose for themselves and for everyone else in the world. Parked cars had also been sitting with their wheels a few centimetres into the asphalt, and snapping up the moment someone took the wheel; they now rest on their wheels whether or not anyone is driving. The model is optimized on the way in, from 16 MB down to 1.4 MB with a third of the triangles, one download shared by every car on screen, and if it ever fails to load the old box still drives so the delivery jobs keep working. (`/play`) `[feature, improvement, fix]`
- **Wallet Intelligence stops reporting win rates like 570% and 9790%**: The pump.fun track record at /claim-wallet was audited end to end in a real browser, and the headline numbers were wrong. Lifetime win rate, early-entry win rate and dump rate are stored as percentages, but the page multiplied them by a hundred a second time, so a wallet that wins 5.7% of its trades was shown as '570% lifetime' and a 97.9% dump rate read '9790%'. The meters beside them were pinned full for the same reason, and the colour that flags a heavy dumper was triggered by anything above 0.3%. All three now read the real figure. Four other repairs came out of the same pass. A wallet the reputation brain has graded but whose per-coin rows are still indexing used to show an empty ledger captioned 'No coins match these filters', blaming filters that were not the cause; it now explains that the ledger is still filling in. When filters genuinely do hide everything, the table says how many coins were hidden and offers one click to clear them. The ledger header no longer claims 60 coins while showing 52, since dust is hidden by default. A dropped connection used to blank the report and print the browser's raw 'Failed to fetch' beside the search box with no way forward, and now shows a proper panel naming the cause with a Try again button. The Analyze button's 'Analyzing…' label was being overwritten by the translation pass and never appeared. Keyboard and screen-reader users can now sort the ledger and open any coin: the column sorters are real buttons that announce their sort direction, every row carries a real link to that coin's dashboard, the time-window and filter controls report whether they are on, and every control on the page shows a visible focus ring. (`/claim-wallet`) `[fix, improvement]`
## 2026-08-16
diff --git a/STRUCTURE.md b/STRUCTURE.md
index 8e9a9f1d3..23fe430e5 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -90,6 +90,7 @@ bottom.
| `/play` forge-in-world (prompt or photo to a live prop) | Lane client [src/game/forge-prop.js](src/game/forge-prop.js), palette form + `/forge` chat command [src/game/coincommunities-ui.js](src/game/coincommunities-ui.js) (`_buildForgeRow()`, `_submitForge()`), placement handler [src/game/coincommunities.js](src/game/coincommunities.js) (`_forgeProp()`), styles [src/game/coincommunities.css](src/game/coincommunities.css), rendering [src/game/world-objects.js](src/game/world-objects.js) (`registerUploadedProp`), server gate [multiplayer/src/build-limits.js](multiplayer/src/build-limits.js) (`normalizePropAssetUrl`) | In-repo | Describe an item in the build palette's Forge form (or type `/forge a glowing campfire` in world chat, or attach a reference photo) and the free draft forge lane generates a real textured GLB in about half a minute. The finished model is registered as a placeable prop and armed, so the next click drops it into the shared world through the SAME `obj:spawn` channel player uploads use: the URL travels on the object, every connected player renders it, and the room persists it like any other build. No new server surface was needed because the durable forge URL (`S3_PUBLIC_DOMAIN`, an `*.r2.dev` host) already satisfies the world asset allow-list; an off-list host is refused with `obj:reject`/`asset_url`. Generation is one-at-a-time per player, and every failure (rate limit, refused prompt, dead upload, timeout) reports a recovery line in the palette's status strip. Docs: [docs/play-forge-in-world.md](docs/play-forge-in-world.md). Tests: [tests/forge-prop.test.js](tests/forge-prop.test.js) |
| `/play` combat & weapons (server-authoritative, danger zones, wanted, tombstones) | Client: [src/game/combat-system.js](src/game/combat-system.js) `→ /play` (vitals HUD wiring, danger-zone ground, tombstone loot, hit feedback, the `window.twsCombat` bridge into W08's `MobSystem`), HUD [src/game/hud/world-hud.js](src/game/hud/world-hud.js). Server: [multiplayer/src/combat-handlers.js](multiplayer/src/combat-handlers.js) (mob AI, attack/loot intents, death + respawn), pure math [multiplayer/src/combat.js](multiplayer/src/combat.js), weapon/mob/loot tables [multiplayer/src/items.js](multiplayer/src/items.js), zone geometry [multiplayer/src/world-features.js](multiplayer/src/world-features.js), handlers wired in [multiplayer/src/rooms/WalkRoom.js](multiplayer/src/rooms/WalkRoom.js) | In-repo | W07 of the World Online program (program brief retired to git history). Equip a sword/bat/pistol/bow from the hotbar and press `X` (or tap the touch Attack button) to fight; but only inside one of three named danger zones (Southern Wilds, Northern Wilds, Eastern Marches); town stays lawful by construction. PvE mobs chase and swing back through the same server-side damage path a player's attack uses; a kill (mob or PvP) spills a lootable tombstone, PvP raises the attacker's wanted/heat stars (visible on `WorldHud` and a downed peer's nameplate), and death drops carried cash/pack before an automatic respawn in town. |
| `/play` NPCs & world life (traffic, vendors, quest-givers, mobs) | Manager [src/game/npc/world-life.js](src/game/npc/world-life.js), nav graph [src/game/npc/nav-graph.js](src/game/npc/nav-graph.js), ambient crowd/traffic [src/game/npc/ambient-life.js](src/game/npc/ambient-life.js), quest-giver NPCs [src/game/npc/quest-npcs.js](src/game/npc/quest-npcs.js), quest-zone waypoints [src/game/npc/quest-markers.js](src/game/npc/quest-markers.js), Jobs Board UI [src/game/quests-ui.js](src/game/quests-ui.js), W07-gated mobs [src/game/npc/mobs.js](src/game/npc/mobs.js). Server: quest engine [multiplayer/src/quests.js](multiplayer/src/quests.js), quest zones [multiplayer/src/quest-zones.js](multiplayer/src/quest-zones.js), handlers in [multiplayer/src/rooms/WalkRoom.js](multiplayer/src/rooms/WalkRoom.js) | In-repo | W08 of the World Online program (program brief retired to git history). A deterministic nav graph drives client-side ambient pedestrians + ring-road traffic that read identically for every player without a single packet; real gameplay stays server-authoritative. Five quest-giver NPCs (Dockmaster Reyes, Warden Okoro, Cook Mara, Foreman Dell, The Fixer) front the jobs board the quest engine (W05) already ran server-side but no client ever reached; pressing E opens the real board, accepting a job drops a waypoint at its objective (goto zones auto-complete by walking there, interact zones get their own "press E"), and finishing pays real cash server-side. Hostile mobs are live: W07's `CombatSystem` ([src/game/combat-system.js](src/game/combat-system.js)) installs the `window.twsCombat` contract this module's mobs were built against, so `MobSystem` renders real server-authoritative PvE hostiles with zero changes here. Two jobs; `cross-town-delivery` (North↔South) and `east-west-express` (East↔West); are real driving missions: each `goto` leg is flagged `vehicle: true` and only completes off the authoritative vehicle-driver map ([multiplayer/src/vehicles.js](multiplayer/src/vehicles.js)), so walking through a depot never counts, only driving through it does. Depots sit on the avenue vehicle spawns, so a car is always parked at the start. Tests: [tests/quests-vehicle-delivery.test.js](tests/quests-vehicle-delivery.test.js). |
+| `/play` vehicles (the drivable fleet & the Trench Car) | Handling spec + fleet registry [multiplayer/src/vehicles.js](multiplayer/src/vehicles.js), client manager [src/game/vehicles.js](src/game/vehicles.js), meshes [src/game/vehicle-mesh.js](src/game/vehicle-mesh.js), shared GLB loader [src/game/vehicle-model.js](src/game/vehicle-model.js), staged model [public/vehicles/](public/vehicles) (built by [scripts/build-trench-car.mjs](scripts/build-trench-car.mjs), `npm run build:trench-car`), Rapier chassis [src/physics/physics-world.js](src/physics/physics-world.js), server gate + anti-cheat [multiplayer/src/rooms/WalkRoom.js](multiplayer/src/rooms/WalkRoom.js) | In-repo | W02 of the World Online program. Real cars you drive with WASD (touch gets pedals and a wheel), simulated locally on the SAME Rapier world the character controller uses, so a car collides with the town exactly as a walking avatar does, and relayed through a server that validates per-type speed and bounds and owns who may drive what. The world's default car is the **Trench Car**, a community model from the avatar gallery (`trench-car`): ambient traffic drives it ([src/game/npc/ambient-life.js](src/game/npc/ambient-life.js)) and it is parked at both plaza bays and the North Depot, so the car you watch go past is the car you can get into. Model-backed types build a procedural stand-in instantly and swap the GLB body and wheels into the same group and pivots when the download lands, so a car that upgrades mid-drive keeps its physics, camera and driver, and a failed download still leaves a drivable car. One shared template per model; only the brake-light material is per car. Drivers sit in a seated pose that peers see too (server-authored `drive` motion). Docs: [docs/play-vehicles.md](docs/play-vehicles.md). Tests: [tests/vehicles-trench-car.test.js](tests/vehicles-trench-car.test.js), [tests/e2e/play-vehicles.spec.js](tests/e2e/play-vehicles.spec.js), [tests/quests-vehicle-delivery.test.js](tests/quests-vehicle-delivery.test.js); real-Rapier repro `node scripts/verify-w02-physics-core.mjs trench` |
| Frame governor & power saver (`/play`, `/club`, `/walk`) | [src/shared/frame-governor.js](src/shared/frame-governor.js), wired in [src/game/coincommunities.js](src/game/coincommunities.js), [src/club.js](src/club.js), [src/club-entrance.js](src/club-entrance.js), [src/walk.js](src/walk.js); toggle UI in [src/game/coincommunities-ui.js](src/game/coincommunities-ui.js) | Live | Shared frame-rate governor for the heavy 3D surfaces: 60fps while active, 30fps when idle or unfocused, plus a user-facing Power-saver mode (30fps + lighter rendering, "for a cooler, quieter machine") persisted in localStorage `tws-power-saver` and shared across surfaces (`getPowerSaver`/`setPowerSaver`/`onPowerSaverChange`, `trackWindowFocus`). Tests: [tests/frame-governor.test.js](tests/frame-governor.test.js) |
| `/play` safety & lifecycle invariants | Doc [docs/play-hardening.md](docs/play-hardening.md) `→ /docs/play-hardening`. Guards: `cssBgImage()` + `clampParam()` + `isPlausibleMint()` in [src/game/coincommunities-ui.js](src/game/coincommunities-ui.js) / [src/game/coincommunities.js](src/game/coincommunities.js), avatar template cache + `releaseAvatar()` in [src/game/avatar-rig.js](src/game/avatar-rig.js), reconnect pruning (`_markRemotesStale`/`_pruneStaleRemotes`) and `_disposeObject3D()` in [src/game/coincommunities.js](src/game/coincommunities.js). Harnesses: [scripts/play-desktop-audit.mjs](scripts/play-desktop-audit.mjs), [scripts/play-mobile-repro.mjs](scripts/play-mobile-repro.mjs) | Live | The rules that keep the platform's largest interactive surface safe, honest and phone-survivable, each written against a failure that actually shipped: untrusted display names and coin metadata never become markup or CSS (a tombstone owner's name once ran as HTML for everyone who walked past it; a crafted coin `image_uri` could paint a full-screen overlay across the lobby), a malformed `?coin=` is refused instead of building a convincing world nobody else can join, a *valid* `?coin=` that lost the rest of its query (a hand-typed link, a truncated share, an unfurl that kept only the mint) is named from the coin feed by `_fetchCoinIdentity()`/`mergeCoinIdentity()` instead of building a real district under a totem reading "COMMUNITY" with a blank market cap, a reconnect retires the peers who left rather than accumulating frozen ghosts and a tripled headcount, and everything the world loads (crowd/NPC GLBs, the sun's 2048² shadow map, totem, jumbotron, dance floor, district, environment) is genuinely freed on the way out instead of held until the tab is killed. Tests: [tests/play-deeplink-safety.test.js](tests/play-deeplink-safety.test.js), [tests/play-deeplink-identity.test.js](tests/play-deeplink-identity.test.js) |
| Cinematic rendering (shared 3D quality bar) | [src/shared/cinematic-render.js](src/shared/cinematic-render.js) — `applyCinematicDefaults()`, `loadEnvironment()`, `detectQualityTier()`, `updateGroundContactShadow()`; curated HDRIs in [public/hdri/](public/hdri) (CC0, Poly Haven) | Live, wired into every three.js viewer on the platform (`/irl`, talk mode, `/play`, `/club`, `/ar`, `/xr`, `/walk`, `/coin3d`, marketplace lobby, demo pages, the `<agent-3d>`/`<page-agent>` embeds, and more) | One module every WebGLRenderer-based viewer calls into instead of re-deriving ACES tone mapping, sRGB output color space, HDRI image-based lighting, and soft VSM shadows per file. `detectQualityTier()` picks high/medium/mobile from real device signals and caps pixel ratio + disables shadows/HDRI accordingly; `loadEnvironment()` fetches a real photographic HDRI (`studio`/`outdoor`/`sunset`) and falls back to a procedural room environment on mobile tier or fetch failure (including cross-origin embed contexts where the absolute `/hdri/*.hdr` URL can't resolve). `/walk` keeps its own richer per-biome HDR system ([src/walk-environments.js](src/walk-environments.js)); surfaces already running a postprocessing tone-mapping pass (`/oracle-graph`, `/club-entrance`) only take the sRGB/HDRI half to avoid double-applying the curve. |
diff --git a/data/changelog.json b/data/changelog.json
index 8c0591e93..1a9b7e0c9 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -1,6 +1,26 @@
{
"$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. `link` is optional and must be a live three.ws path.",
"entries": [
+ {
+ "date": "2026-08-17",
+ "title": "Pausing a skill bundle is no longer permanent, and every tooltip fits on a phone",
+ "summary": "The bundle builder at /bundles was audited end to end in a real browser: signing in, picking priced skills, the price panel and its backtest, publishing, the published list, and the loading, empty and error states, at phone, tablet and desktop widths. The worst finding was that Deactivate was a one-way door. It hid the bundle from buyers, which is correct, but it also removed it from the only page that could put it back, so a misclick permanently retired a bundle you had just priced. The button is now called Pause, a paused bundle stays on the page dimmed and clearly marked, and a Reactivate button puts it back on sale. Buyers still never see a paused bundle: the public list is unchanged, and paused ones are returned only to a signed-in owner of that agent. The small question-mark tooltips that explain every number on the page were also cut off at the edge of a phone screen, so four of the seven explanations were partly unreadable at 320 pixels wide; they now shift to stay on screen at any width. The sum of the parts and the suggested price were cramped into a broken-looking two-line squeeze on a narrow screen and now stack cleanly. Finally, a pricing error raised by one agent no longer sits on screen after you switch to another agent, where it read as a verdict on an agent it had never looked at.",
+ "tags": [
+ "fix",
+ "improvement"
+ ],
+ "link": "/bundles"
+ },
+ {
+ "date": "2026-08-17",
+ "title": "Avatar Studio survives an accessory outage, and tells you when it is putting a hat on",
+ "summary": "The studio at /avatar-studio was audited end to end in a real browser: loading the base body, all six tabs, the colour swatches, the sculpt sliders, the motion library, undo and redo, and the loading, empty and error states, at phone, tablet and desktop widths. The worst finding was that a single failed request for the accessory catalogue took the entire studio down. The hats, glasses and earrings lists come from one file, and if that file did not load, the page replaced everything with a Retry screen, throwing away the 3D avatar it had already finished loading. Colours, sculpting, animation and saving need nothing from that catalogue, so they all now keep working, and only the three accessory tabs show a message explaining what is missing, with a Retry button that reloads just the catalogue. The Save, Reset, Randomise and Undo buttons were also on screen but not yet connected until that same request finished, so pressing them early did nothing at all and the tab strip sat empty; they are live from the first paint now. Putting on a hat downloads and fits a 3D model, which takes a few seconds, and until now the studio gave no sign it was working: the tile click looked ignored, and a hat that failed to download failed in complete silence. Every accessory change now shows what it is doing and says so plainly if it could not finish. Randomise no longer lists an accessory you are not actually wearing when its model fails to load. Pressing Undo then Redo quickly could leave the avatar and the list of what it is wearing disagreeing with each other; each step now settles correctly. Spinners also finally stop for people who have asked their device to reduce motion.",
+ "tags": [
+ "fix",
+ "improvement"
+ ],
+ "link": "/avatar-studio"
+ },
{
"date": "2026-08-17",
"title": "Blockchain TVL by Chain is readable again, and its numbers can be copied",
@@ -24072,6 +24092,17 @@
"improvement"
],
"link": "/avatar-wallet-chat"
+ },
+ {
+ "date": "2026-08-17",
+ "title": "There is a real car in every coin world now, and you can get in and drive it",
+ "summary": "The cars in a coin world used to be boxes: a box on wheels driving the ring road, and a slightly different box parked for you to drive. Both are now the Trench Car, a real community model published to the three.ws avatar gallery, so the car that drives past you on the road is the same car parked at the plaza that you can get into. Walk within a few metres of one, press F (or tap the car on a phone) and drive it with WASD and the on-screen pedals, with a working speedometer, brake lights and a handbrake. Your driver now actually sits in the seat: every car in the world had been placing its driver standing on the roof, and other players saw them there too, because the seat was measured from the wrong point. Drivers are now seated inside the car in a seated pose for themselves and for everyone else in the world. Parked cars had also been sitting with their wheels a few centimetres into the asphalt, and snapping up the moment someone took the wheel; they now rest on their wheels whether or not anyone is driving. The model is optimized on the way in, from 16 MB down to 1.4 MB with a third of the triangles, one download shared by every car on screen, and if it ever fails to load the old box still drives so the delivery jobs keep working.",
+ "tags": [
+ "feature",
+ "improvement",
+ "fix"
+ ],
+ "link": "/play"
}
]
}
diff --git a/data/pages.json b/data/pages.json
index ce2205e8a..58a39ce7c 100644
--- a/data/pages.json
+++ b/data/pages.json
@@ -2543,6 +2543,14 @@
"changefreq": "monthly",
"added": "2026-08-08"
},
+ {
+ "path": "/docs/play-vehicles",
+ "title": "Docs · Cars in /play: traffic and the drivable fleet",
+ "description": "The Trench Car is the default car in every coin world: ambient traffic drives it and it is parked for you to take the wheel. How to drive, how a car is assembled from spec, physics and mesh, how the model is staged, and how to add another.",
+ "priority": 0.5,
+ "changefreq": "monthly",
+ "added": "2026-08-17"
+ },
{
"path": "/docs/swarms",
"title": "Docs · Trading swarms",
diff --git a/docs/nav.json b/docs/nav.json
index 83a96fa06..0a84932d7 100644
--- a/docs/nav.json
+++ b/docs/nav.json
@@ -482,6 +482,10 @@
"label": "World Lines (proof of presence)",
"path": "world-lines"
},
+ {
+ "label": "Cars in /play (traffic and the drivable fleet)",
+ "path": "play-vehicles"
+ },
{
"label": "Walk Leaderboard",
"path": "walk-leaderboard"
diff --git a/docs/play-vehicles.md b/docs/play-vehicles.md
new file mode 100644
index 000000000..d20e06e95
--- /dev/null
+++ b/docs/play-vehicles.md
@@ -0,0 +1,99 @@
+# Cars in `/play`: the Trench Car, ambient traffic, and the drivable fleet
+
+Every coin world in [`/play`](https://three.ws/play) has cars in it. They are not scenery
+you walk past: the same car that drives by you on the ring road is the car parked at the
+plaza that you can get into and drive across town.
+
+The world's default car is the **Trench Car**, a community model published to the three.ws
+avatar gallery ([avatar `e702d59a-d29f-4f21-af8a-6400dd1a2c6f`](https://three.ws/avatars/e702d59a-d29f-4f21-af8a-6400dd1a2c6f),
+slug `trench-car`). It is what ambient traffic drives, what is parked at the two plaza bays
+and the North Depot, and what an unknown vehicle type falls back to.
+
+## Driving one
+
+1. Walk up to a parked car. Inside 3.4 m a prompt appears over it: **Drive the Trench Car**.
+2. Press `F` to take the wheel. On a touch device, tap the car itself.
+3. `W` / `S` are throttle and brake (brake from a standstill reverses), `A` / `D` steer,
+ `Space` is the handbrake. On touch you get an on-screen pedal and steering cluster
+ instead, and the walking joystick steps aside while you drive.
+4. The speedometer sits bottom-right and reads real km/h off the simulation.
+5. Press `F` again (or tap **Exit**) to step out. You are dropped beside the driver's door.
+
+While you are driving, your avatar sits in the car's seat in a seated pose, and every other
+player in the world sees you sitting in it, because the server carries your position and
+your `drive` motion with the car.
+
+Roll it onto its roof and it rights itself after a couple of seconds. Drive it at a
+pedestrian and they are shoved out of the way rather than driven through.
+
+### Driving jobs
+
+Two of the world's jobs are real driving missions: `cross-town-delivery` (North depot to
+South) and `east-west-express`. Both legs only complete if you arrive **in a car**, checked
+server-side against the authoritative driver map, so walking to a depot never counts. The
+depots sit on the avenue vehicle spawns, so a car is always parked at the start of the run.
+
+## How a car is put together
+
+A car is three things that all have to agree, or it looks wrong or drives wrong:
+
+| Piece | Where it lives | What it owns |
+|---|---|---|
+| Handling spec | [multiplayer/src/vehicles.js](../multiplayer/src/vehicles.js) | Mass, forces, top speed, dimensions, wheel geometry, suspension, seat. Shared by client and server, so "feels fast" and "rejected as cheating" can never drift apart. |
+| Physics chassis | [src/physics/physics-world.js](../src/physics/physics-world.js) | A Rapier raycast vehicle controller built from that spec. |
+| The mesh | [src/game/vehicle-mesh.js](../src/game/vehicle-mesh.js), [src/game/vehicle-model.js](../src/game/vehicle-model.js) | What you look at: either a procedural silhouette or a GLB. |
+
+The mesh group's origin is the **chassis centre**, `+z` is forward, and the four wheels are
+pivot/spinner pairs the vehicle controller writes suspension, steering and roll into every
+frame. A GLB is authored with its contact patch on the road, so it is dropped into chassis
+space by `vehicleRestHeight()`.
+
+Model-backed cars never block the world on a download. `buildVehicleMesh()` returns its
+procedural stand-in immediately and swaps the GLB body and wheels into the *same* group and
+the *same* wheel pivots when the model lands, so a car that upgrades mid-drive keeps its
+physics, its camera and its driver. If the model cannot be fetched at all, the stand-in
+stays and the car is still completely drivable.
+
+One template is downloaded and parsed per model for the whole world. Every car clones it,
+sharing geometry and textures, and clones only its own brake-light material so one car
+braking does not light up the rest.
+
+## Staging the model
+
+The gallery master is a 16 MB studio model: two oversized textures and 263k triangles. That
+is unusable on a page every visitor loads, so it is staged into the repo:
+
+```bash
+npm run build:trench-car # fetch from the avatar API, optimize, write public/vehicles/
+npm run build:trench-car -- --dry # report the sizes, write nothing
+```
+
+[scripts/build-trench-car.mjs](../scripts/build-trench-car.mjs) pulls the master through the
+live avatar API (so a re-upload of the same avatar re-stages cleanly, with no storage URL
+hardcoded anywhere), decimates the geometry to a game budget, caps the body wrap at 2048px
+and the metal-roughness map at 1024px, and writes
+`public/vehicles/trench-car.glb` at about 1.4 MB and 99k triangles.
+
+## Adding another car model
+
+1. Publish or pick a GLB whose wheels are four separate nodes named `wheel…` and whose body
+ sits with its contact patch at `y = 0`, facing `+z`. Stage it into `public/vehicles/`.
+2. Add a type to `VEHICLE_TYPES` with a `model` key, and measure `dims`, `wheel` and
+ `suspension` off the mesh. `dims.h` is road-to-roof, not the body's own bounding box.
+3. Check the clearance rule: the chassis collider's underside sits `1.3 * (h / 2)` below the
+ body origin, so `vehicleRestHeight()` has to clear it. Too little and the hull rests on
+ the road and its own friction pins the car, whatever the engine force says.
+4. Map the model key to its URL in `MODEL_URLS` in
+ [src/game/vehicle-mesh.js](../src/game/vehicle-mesh.js).
+5. Prove it, do not eyeball it:
+ ```bash
+ node scripts/verify-w02-physics-core.mjs <type> # real Rapier: does it accelerate, steer, stop?
+ npx vitest run tests/vehicles-trench-car.test.js # spec vs. the staged asset
+ npx playwright test tests/e2e/play-vehicles.spec.js
+ ```
+
+## Related
+
+- [`/play` NPCs and world life](../src/game/npc/ambient-life.js) drives the ambient lane.
+- [The in-game economy](in-game-economy.md) covers what you earn on those delivery runs.
+- [`/play` safety and lifecycle invariants](play-hardening.md).
diff --git a/package.json b/package.json
index aff933448..d8309cfb4 100644
--- a/package.json
+++ b/package.json
@@ -256,6 +256,7 @@
"build:club-entrance-venue": "node scripts/build-club-entrance-venue.mjs",
"build:club-assets": "(npm run build:club-props & npm run build:club-venue & npm run build:club-hdri & wait)",
"build:walk-environments": "node scripts/build-walk-environments.mjs",
+ "build:trench-car": "node scripts/build-trench-car.mjs",
"build:artifact-viewer": "node scripts/build-artifact-viewer.mjs",
"build:lib": "TARGET=lib vite build",
"build:lib:full": "TARGET=lib LIB_FORMATS=es,umd vite build",
diff --git a/public/changelog.json b/public/changelog.json
index 549d22401..30acd8ade 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,11 +1,21 @@
{
- "generated_at": "2026-08-17T01:16:11.489Z",
+ "generated_at": "2026-08-17T01:33:22.537Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
"url": "https://three.ws"
},
"entries": [
+ {
+ "date": "2026-08-17",
+ "type": "launch",
+ "title": "Docs · Cars in /play: traffic and the drivable fleet",
+ "summary": "The Trench Car is the default car in every coin world: ambient traffic drives it and it is parked for you to take the wheel. How to drive, how a car is assembled from spec, physics and mesh, how the model is staged, and how to add another.",
+ "link": "/docs/play-vehicles",
+ "tags": [
+ "launch"
+ ]
+ },
{
"date": "2026-08-17",
"type": "update",
@@ -28,6 +38,17 @@
"improvement"
]
},
+ {
+ "date": "2026-08-17",
+ "type": "update",
+ "title": "Avatar Studio survives an accessory outage, and tells you when it is putting a hat on",
+ "summary": "The studio at /avatar-studio was audited end to end in a real browser: loading the base body, all six tabs, the colour swatches, the sculpt sliders, the motion library, undo and redo, and the loading, empty and error states, at phone, tablet and desktop widths. The worst finding was that a single failed request for the accessory catalogue took the entire studio down. The hats, glasses and earrings lists come from one file, and if that file did not load, the page replaced everything with a Retry screen, throwing away the 3D avatar it had already finished loading. Colours, sculpting, animation and saving need nothing from that catalogue, so they all now keep working, and only the three accessory tabs show a message explaining what is missing, with a Retry button that reloads just the catalogue. The Save, Reset, Randomise and Undo buttons were also on screen but not yet connected until that same request finished, so pressing them early did nothing at all and the tab strip sat empty; they are live from the first paint now. Putting on a hat downloads and fits a 3D model, which takes a few seconds, and until now the studio gave no sign it was working: the tile click looked ignored, and a hat that failed to download failed in complete silence. Every accessory change now shows what it is doing and says so plainly if it could not finish. Randomise no longer lists an accessory you are not actually wearing when its model fails to load. Pressing Undo then Redo quickly could leave the avatar and the list of what it is wearing disagreeing with each other; each step now settles correctly. Spinners also finally stop for people who have asked their device to reduce motion.",
+ "link": "/avatar-studio",
+ "tags": [
+ "fix",
+ "improvement"
+ ]
+ },
{
"date": "2026-08-17",
"type": "update",
@@ -49,6 +70,17 @@
"fix"
]
},
+ {
+ "date": "2026-08-17",
+ "type": "update",
+ "title": "Pausing a skill bundle is no longer permanent, and every tooltip fits on a phone",
+ "summary": "The bundle builder at /bundles was audited end to end in a real browser: signing in, picking priced skills, the price panel and its backtest, publishing, the published list, and the loading, empty and error states, at phone, tablet and desktop widths. The worst finding was that Deactivate was a one-way door. It hid the bundle from buyers, which is correct, but it also removed it from the only page that could put it back, so a misclick permanently retired a bundle you had just priced. The button is now called Pause, a paused bundle stays on the page dimmed and clearly marked, and a Reactivate button puts it back on sale. Buyers still never see a paused bundle: the public list is unchanged, and paused ones are returned only to a signed-in owner of that agent. The small question-mark tooltips that explain every number on the page were also cut off at the edge of a phone screen, so four of the seven explanations were partly unreadable at 320 pixels wide; they now shift to stay on screen at any width. The sum of the parts and the suggested price were cramped into a broken-looking two-line squeeze on a narrow screen and now stack cleanly. Finally, a pricing error raised by one agent no longer sits on screen after you switch to another agent, where it read as a verdict on an agent it had never looked at.",
+ "link": "/bundles",
+ "tags": [
+ "fix",
+ "improvement"
+ ]
+ },
{
"date": "2026-08-17",
"type": "update",
@@ -60,6 +92,18 @@
"improvement"
]
},
+ {
+ "date": "2026-08-17",
+ "type": "update",
+ "title": "There is a real car in every coin world now, and you can get in and drive it",
+ "summary": "The cars in a coin world used to be boxes: a box on wheels driving the ring road, and a slightly different box parked for you to drive. Both are now the Trench Car, a real community model published to the three.ws avatar gallery, so the car that drives past you on the road is the same car parked at the plaza that you can get into. Walk within a few metres of one, press F (or tap the car on a phone) and drive it with WASD and the on-screen pedals, with a working speedometer, brake lights and a handbrake. Your driver now actually sits in the seat: every car in the world had been placing its driver standing on the roof, and other players saw them there too, because the seat was measured from the wrong point. Drivers are now seated inside the car in a seated pose for themselves and for everyone else in the world. Parked cars had also been sitting with their wheels a few centimetres into the asphalt, and snapping up the moment someone took the wheel; they now rest on their wheels whether or not anyone is driving. The model is optimized on the way in, from 16 MB down to 1.4 MB with a third of the triangles, one download shared by every car on screen, and if it ever fails to load the old box still drives so the delivery jobs keep working.",
+ "link": "/play",
+ "tags": [
+ "feature",
+ "improvement",
+ "fix"
+ ]
+ },
{
"date": "2026-08-17",
"type": "update",
diff --git a/public/changelog.xml b/public/changelog.xml
index 42be23dab..5b4d2f3e7 100644
--- a/public/changelog.xml
+++ b/public/changelog.xml
@@ -6,6 +6,14 @@
<atom:link href="https://three.ws/changelog.xml" rel="self" type="application/rss+xml"/>
<description>What's new on three.ws: features, improvements, and releases, newest first.</description>
<language>en</language>
+ <item>
+ <title>Docs · Cars in /play: traffic and the drivable fleet</title>
+ <link>https://three.ws/docs/play-vehicles</link>
+ <guid isPermaLink="false">2026-08-17:Docs · Cars in /play: traffic and the drivable fleet</guid>
+ <pubDate>Mon, 17 Aug 2026 12:00:00 GMT</pubDate>
+ <category>launch</category>
+ <description>The Trench Car is the default car in every coin world: ambient traffic drives it and it is parked for you to take the wheel. How to drive, how a car is assembled from spec, physics and mesh, how the model is staged, and how to add another.</description>
+ </item>
<item>
<title>A shared ASL letter link now opens on that letter, not on A</title>
<link>https://three.ws/asl-alphabet</link>
@@ -22,6 +30,14 @@
<category>fix</category>
<description>The studio camera was framing the base body from the shoulders to the knees: the face you were sculpting and the shoes you were picking were both outside the picture, and the only way to see them was to orbit the camera yourself every time the page loaded. The framing is now solved from the lens rather than guessed at, so a full-body shot really does hold the avatar head to toe, arms included, on any window shape, and the half-body and headshot views stay as tight as their names promise. On a 320px phone the top bar had been running past the edge of the screen and taking the Save avatar button with it, so a look built on a phone could not be saved at all; the bar now fits, with the Back and title labels standing down to make room. The tab strip on that same narrow layout had been hiding its labels without putting anything in their place, leaving six blank buttons, and now shows an icon per tab. The Parametric body badge that read 120+ sliders was white text on a white pill and invisible everywhere. A failed save now says the connection could not be reached and that your look is still there, instead of repeating the browser phrase Failed to fetch, and every accessory search box, every tab and the Back link now carry names a screen reader can read. Opening avatar-studio in local development also serves the same page production does, which it previously did not.</description>
</item>
+ <item>
+ <title>Avatar Studio survives an accessory outage, and tells you when it is putting a hat on</title>
+ <link>https://three.ws/avatar-studio</link>
+ <guid isPermaLink="false">2026-08-17:Avatar Studio survives an accessory outage, and tells you when it is putting a hat on</guid>
+ <pubDate>Mon, 17 Aug 2026 12:00:00 GMT</pubDate>
+ <category>fix</category>
+ <description>The studio at /avatar-studio was audited end to end in a real browser: loading the base body, all six tabs, the colour swatches, the sculpt sliders, the motion library, undo and redo, and the loading, empty and error states, at phone, tablet and desktop widths. The worst finding was that a single failed request for the accessory catalogue took the entire studio down. The hats, glasses and earrings lists come from one file, and if that file did not load, the page replaced everything with a Retry screen, throwing away the 3D avatar it had already finished loading. Colours, sculpting, animation and saving need nothing from that catalogue, so they all now keep working, and only the three accessory tabs show a message explaining what is missing, with a Retry button that reloads just the catalogue. The Save, Reset, Randomise and Undo buttons were also on screen but not yet connected until that same request finished, so pressing them early did nothing at all and the tab strip sat empty; they are live from the first paint now. Putting on a hat downloads and fits a 3D model, which takes a few seconds, and until now the studio gave no sign it was working: the tile click looked ignored, and a hat that failed to download failed in complete silence. Every accessory change now shows what it is doing and says so plainly if it could not finish. Randomise no longer lists an accessory you are not actually wearing when its model fails to load. Pressing Undo then Redo quickly could leave the avatar and the list of what it is wearing disagreeing with each other; each step now settles correctly. Spinners also finally stop for people who have asked their device to reduce motion.</description>
+ </item>
<item>
<title>Blockchain TVL by Chain is readable again, and its numbers can be copied</title>
<link>https://three.ws/chains</link>
@@ -38,6 +54,14 @@
<category>fix</category>
<description>The sector leaderboard at /categories was audited end to end in a real browser: the table, the search box, the sortable columns, the paging, and the loading, empty, error and rate-limited states all behave, at phone, tablet and desktop widths. One real defect turned up, and it only showed outside English. The page's own summary line and the description search engines and link previews read were translated once against an older wording and had kept a dash where the English now uses a colon, so every non-English visitor saw punctuation the platform does not use, in the headline copy and in the shared-link preview. All 83 translated catalogs are corrected, with the full-width colon that Japanese, Korean and Chinese actually want rather than a Latin one.</description>
</item>
+ <item>
+ <title>Pausing a skill bundle is no longer permanent, and every tooltip fits on a phone</title>
+ <link>https://three.ws/bundles</link>
+ <guid isPermaLink="false">2026-08-17:Pausing a skill bundle is no longer permanent, and every tooltip fits on a phone</guid>
+ <pubDate>Mon, 17 Aug 2026 12:00:00 GMT</pubDate>
+ <category>fix</category>
+ <description>The bundle builder at /bundles was audited end to end in a real browser: signing in, picking priced skills, the price panel and its backtest, publishing, the published list, and the loading, empty and error states, at phone, tablet and desktop widths. The worst finding was that Deactivate was a one-way door. It hid the bundle from buyers, which is correct, but it also removed it from the only page that could put it back, so a misclick permanently retired a bundle you had just priced. The button is now called Pause, a paused bundle stays on the page dimmed and clearly marked, and a Reactivate button puts it back on sale. Buyers still never see a paused bundle: the public list is unchanged, and paused ones are returned only to a signed-in owner of that agent. The small question-mark tooltips that explain every number on the page were also cut off at the edge of a phone screen, so four of the seven explanations were partly unreadable at 320 pixels wide; they now shift to stay on screen at any width. The sum of the parts and the suggested price were cramped into a broken-looking two-line squeeze on a narrow screen and now stack cleanly. Finally, a pricing error raised by one agent no longer sits on screen after you switch to another agent, where it read as a verdict on an agent it had never looked at.</description>
+ </item>
<item>
<title>The viewer's backdrop picker stops vanishing while you read it, and sharing no longer posts &quot;Meet Agent&quot;</title>
<link>https://three.ws/app</link>
@@ -46,6 +70,14 @@
<category>fix</category>
<description>Five fixes to the 3D model viewer at /app. Opening the Backdrop picker and taking a few seconds to read the six choices used to make the picker fade out from under the cursor: the viewer hides its controls after five seconds of stillness, and the picker was not on the list of surfaces that keep them awake, so an open picker went invisible and unclickable while still counting as open. It now stays put until you choose a backdrop or close it, and the controls resume fading once it is shut. Typing in the animation search while the clips were still loading stacked a second, contradictory message under the first, so the panel read &quot;Loading clips&quot; and &quot;No clips matching&quot; at the same time, and clearing the box left behind the nonsense line &quot;No clips matching&quot; with nothing in the quotes; the search now stays quiet until there are clips to search. Sharing the viewer to X, Farcaster or Telegram published &quot;Meet Agent&quot;, an internal placeholder name, for anyone who had not loaded an agent of their own, and now uses the generic line instead. The page also shipped a sign-in panel and a welcome card that its own stylesheet blanked unconditionally, four links nobody could ever reach, and the preview card shown when the page is shared described the platform instead of the viewer. The avatar gallery behind the Avatar button is now announced to screen readers as a named dialog.</description>
</item>
+ <item>
+ <title>There is a real car in every coin world now, and you can get in and drive it</title>
+ <link>https://three.ws/play</link>
+ <guid isPermaLink="false">2026-08-17:There is a real car in every coin world now, and you can get in and drive it</guid>
+ <pubDate>Mon, 17 Aug 2026 12:00:00 GMT</pubDate>
+ <category>feature</category>
+ <description>The cars in a coin world used to be boxes: a box on wheels driving the ring road, and a slightly different box parked for you to drive. Both are now the Trench Car, a real community model published to the three.ws avatar gallery, so the car that drives past you on the road is the same car parked at the plaza that you can get into. Walk within a few metres of one, press F (or tap the car on a phone) and drive it with WASD and the on-screen pedals, with a working speedometer, brake lights and a handbrake. Your driver now actually sits in the seat: every car in the world had been placing its driver standing on the roof, and other players saw them there too, because the seat was measured from the wrong point. Drivers are now seated inside the car in a seated pose for themselves and for everyone else in the world. Parked cars had also been sitting with their wheels a few centimetres into the asphalt, and snapping up the moment someone took the wheel; they now rest on their wheels whether or not anyone is driving. The model is optimized on the way in, from 16 MB down to 1.4 MB with a third of the triangles, one download shared by every car on screen, and if it ever fails to load the old box still drives so the delivery jobs keep working.</description>
+ </item>
<item>
<title>Wallet Intelligence stops reporting win rates like 570% and 9790%</title>
<link>https://three.ws/claim-wallet</link>
diff --git a/public/features.json b/public/features.json
index 4a3b7551b..b9fb8bde4 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-08-17T01:16:11.355Z",
+ "generated_at": "2026-08-17T01:33:22.503Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",
@@ -3117,6 +3117,16 @@
"tags": [],
"showcase": false
},
+ {
+ "path": "/docs/play-vehicles",
+ "title": "Docs · Cars in /play: traffic and the drivable fleet",
+ "description": "The Trench Car is the default car in every coin world: ambient traffic drives it and it is parked for you to take the wheel. How to drive, how a car is assembled from spec, physics and mesh, how the model is staged, and how to add another.",
+ "added": "2026-08-17",
+ "auth": null,
+ "indexable": true,
+ "tags": [],
+ "showcase": false
+ },
{
"path": "/docs/swarms",
"title": "Docs · Trading swarms",
diff --git a/public/llms-full.txt b/public/llms-full.txt
index 939da0bcb..675f670ff 100644
--- a/public/llms-full.txt
+++ b/public/llms-full.txt
@@ -1901,6 +1901,12 @@ URL: https://three.ws/docs/play-forge-in-world
Describe an item in a coin's world, or attach a reference photo, and the free forge lane builds a real 3D model in about half a minute. It is armed for placement and, once placed, appears for everyone connected to that server and persists like any other build.
+### Docs · Cars in /play: traffic and the drivable fleet
+
+URL: https://three.ws/docs/play-vehicles
+
+The Trench Car is the default car in every coin world: ambient traffic drives it and it is parked for you to take the wheel. How to drive, how a car is assembled from spec, physics and mesh, how the model is staged, and how to add another.
+
### Docs · Trading swarms
URL: https://three.ws/docs/swarms
diff --git a/public/llms.txt b/public/llms.txt
index 921b37585..16877cd84 100644
--- a/public/llms.txt
+++ b/public/llms.txt
@@ -351,6 +351,7 @@ Docs, tutorials, and reference.
- [Docs · Live events in the /play world](https://three.ws/docs/play-live-events): How a scheduled event runs inside the $THREE world: one config file drives the countdown chip, the agenda drawer, the go-live moment, and a fireworks show every player sees identically without a single packet. Includes how to schedule, preview, and verify one.
- [Docs · How /play stays safe, honest, and light](https://three.ws/docs/play-hardening): The invariants that keep the Play world safe: untrusted names never become markup, a coin image cannot escape its CSS, a broken world link says so, a reconnect retires the peers who left, and everything the world loads gets freed. Each rule names the failure it prevents.
- [Docs · Forge items into a /play world from a prompt](https://three.ws/docs/play-forge-in-world): Describe an item in a coin's world, or attach a reference photo, and the free forge lane builds a real 3D model in about half a minute. It is armed for placement and, once placed, appears for everyone connected to that server and persists like any other build.
+- [Docs · Cars in /play: traffic and the drivable fleet](https://three.ws/docs/play-vehicles): The Trench Car is the default car in every coin world: ambient traffic drives it and it is parked for you to take the wheel. How to drive, how a car is assembled from spec, physics and mesh, how the model is staged, and how to add another.
- [Docs · Trading swarms](https://three.ws/docs/swarms): How a group of agents pools real SOL into one on-chain Solana treasury and trades it by weighted consensus: reputation-weighted voting, spend-guarded contribute and exit transfers, the shared kill switch, and why no balance is virtual.
- [Docs · Coin Wars](https://three.ws/docs/coin-wars): How community-vs-community battles work on three.ws: the war portal in every coin world, the matchmaking key two communities meet under, the signed pairing the arena trusts, the Elo ladder recomputed from the battle ledger, and the /api/wars endpoint behind all of it.
- [Docs · The in-game economy](https://three.ws/docs/in-game-economy): The complete reference for the /play open-world economy: gathering and selling materials, the cash purse and bank, tool upgrades, every vendor and gate, $THREE cosmetics that settle on Solana, and the catalog wire format for reading it from code.
diff --git a/public/sitemap/index.html b/public/sitemap/index.html
index bcfaf3f57..a13fb2e26 100644
--- a/public/sitemap/index.html
+++ b/public/sitemap/index.html
@@ -83,7 +83,7 @@
<main class="sm-wrap">
<div class="sm-hero">
<h1>Sitemap</h1>
- <p>All 824 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>
+ <p>All 825 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>
<div class="sm-formats">
<a href="/sitemap.xml"><code>sitemap.xml</code> · for search engines</a>
<a href="/llms.txt"><code>llms.txt</code> · for AI agents</a>
@@ -95,7 +95,7 @@
</div>
<div class="sm-filter">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="11" cy="11" r="7"/><path d="m21 21-4.3-4.3"/></svg>
- <input id="sm-filter-input" type="search" placeholder="Filter 824 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />
+ <input id="sm-filter-input" type="search" placeholder="Filter 825 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />
<kbd aria-hidden="true">/</kbd>
</div>
<p class="sm-filter-count" id="sm-filter-count" role="status" aria-live="polite"></p>
@@ -103,6 +103,14 @@
<h2 id="sm-new-title">Newest<a class="sm-new-more" href="/changelog">full changelog &rarr;</a></h2>
<p class="sm-section-desc">The 9 most recently launched pages, straight to the live surface.</p>
<ul class="sm-list">
+ <li>
+ <a href="/docs/play-vehicles">
+ <span class="sm-new-date">Aug 17, 2026</span>
+ <span class="sm-title">Docs · Cars in /play: traffic and the drivable fleet</span>
+ <span class="sm-path">/docs/play-vehicles</span>
+ <span class="sm-desc">The Trench Car is the default car in every coin world: ambient traffic drives it and it is parked for you to take the wheel. How to drive, how a car is assembled from spec, physics and mesh, how the model is staged, and how to add another.</span>
+ </a>
+ </li>
<li>
<a href="/docs/skill-bundles">
<span class="sm-new-date">Aug 16, 2026</span>
@@ -167,14 +175,6 @@
<span class="sm-desc">Sign one permission, then a fixed USDC amount moves every day or week, or gets swapped into a token on a schedule. The lifecycle, the API, what every kind of failed charge does to a schedule, and the operator config settlement needs.</span>
</a>
</li>
- <li>
- <a href="/recurring">
- <span class="sm-new-date">Aug 13, 2026</span>
- <span class="sm-title">Recurring Payments</span>
- <span class="sm-path">/recurring</span>
- <span class="sm-desc">Create, pause, resume and cancel recurring on-chain USDC payments and DCA schedules, see every charge each one has settled, and watch what is being paid into your own agents.</span>
- </a>
- </li>
</ul>
</section>
<nav class="sm-toc" aria-label="Sections">
@@ -2262,7 +2262,7 @@
<section class="sm-section" id="learn">
<header>
- <h2>Learn<span class="sm-count" data-count>366</span></h2>
+ <h2>Learn<span class="sm-count" data-count>367</span></h2>
<p class="sm-section-desc">Docs, tutorials, and reference.</p>
</header>
<ul class="sm-list">
@@ -2392,6 +2392,13 @@
<span class="sm-desc">Describe an item in a coin's world, or attach a reference photo, and the free forge lane builds a real 3D model in about half a minute. It is armed for placement and, once placed, appears for everyone connected to that server and persists like any other build.</span>
</a>
</li>
+ <li>
+ <a href="/docs/play-vehicles">
+ <span class="sm-title">Docs · Cars in /play: traffic and the drivable fleet</span>
+ <span class="sm-path">/docs/play-vehicles</span>
+ <span class="sm-desc">The Trench Car is the default car in every coin world: ambient traffic drives it and it is parked for you to take the wheel. How to drive, how a car is assembled from spec, physics and mesh, how the model is staged, and how to add another.</span>
+ </a>
+ </li>
<li>
<a href="/docs/swarms">
<span class="sm-title">Docs · Trading swarms</span>