@threenative/core 0.3.0 → 0.3.2

package/mcp/servers.mjs

@@ -24,6 +24,13 @@ export const MCP_SERVERS = Object.freeze({
     command: "node",
     args: Object.freeze(["./node_modules/@threenative/core/mcp/engine.mjs"]),
   }),
+  // Drives an installed Blender headlessly so a downloaded .fbx becomes a GLB. It ships no
+  // Blender and probes for one only when a tool is called, so a project that never converts a
+  // model pays nothing for having this server wired.
+  "threenative-blender": Object.freeze({
+    command: "node",
+    args: Object.freeze(["./node_modules/@threenative/core/mcp/blender.mjs"]),
+  }),
 });
 
 /** The external package each shim launches. Core installs asset and sculpt transitively and bundles
@@ -31,15 +38,66 @@ export const MCP_SERVERS = Object.freeze({
  * separately. The pinned engine version remains an emergency fallback for a legacy development
  * checkout whose bundle has not been built. */
 export const MCP_PACKAGES = Object.freeze({
-  assets: Object.freeze({ name: "threenative-asset-mcp", version: "0.6.0" }),
-  sculpt: Object.freeze({ name: "threenative-sculpt-mcp", version: "0.1.0" }),
-  engine: Object.freeze({ name: "threenative-engine-mcp", version: "0.2.0" }),
+  assets: Object.freeze({ name: "threenative-asset-mcp", version: "0.8.0" }),
+  sculpt: Object.freeze({ name: "threenative-sculpt-mcp", version: "0.1.1" }),
+  engine: Object.freeze({ name: "threenative-engine-mcp", version: "0.2.2" }),
+  blender: Object.freeze({ name: "threenative-blender-mcp", version: "0.1.2" }),
+});
+
+/** How one host spells a stdio MCP server. Hosts agree on what to run and disagree on where to
+ * write it down, so the servers are declared once above and translated here. `key` is the property
+ * the host reads its server table from; `entry` is one server in that host's own shape. */
+const SERVER_FORMATS = Object.freeze({
+  // Claude Code (`.mcp.json`), Cursor and the Gemini CLI all read this one.
+  mcpServers: Object.freeze({
+    key: "mcpServers",
+    entry: (server) => ({
+      command: server.command,
+      args: [...server.args],
+      ...(server.env === undefined ? {} : { env: { ...server.env } }),
+    }),
+  }),
+  // VS Code names the table `servers` and requires an explicit transport per server.
+  vscode: Object.freeze({
+    key: "servers",
+    entry: (server) => ({
+      type: "stdio",
+      command: server.command,
+      args: [...server.args],
+      ...(server.env === undefined ? {} : { env: { ...server.env } }),
+    }),
+  }),
+  // opencode folds the command and its arguments into one array and spells the environment
+  // `environment`. A server it does not mark enabled is written down and never started.
+  opencode: Object.freeze({
+    key: "mcp",
+    entry: (server) => ({
+      type: "local",
+      command: [server.command, ...server.args],
+      enabled: true,
+      ...(server.env === undefined ? {} : { environment: { ...server.env } }),
+    }),
+  }),
+  // Zed calls them context servers and needs `source: "custom"` to accept a command of our own.
+  zed: Object.freeze({
+    key: "context_servers",
+    entry: (server) => ({
+      source: "custom",
+      command: server.command,
+      args: [...server.args],
+      ...(server.env === undefined ? {} : { env: { ...server.env } }),
+    }),
+  }),
 });
 
+export const SERVER_FORMAT_NAMES = Object.freeze(Object.keys(SERVER_FORMATS));
+
 /** Adds the ThreeNative servers to an existing config without touching anything else in it, and
  * reports whether the file needs rewriting. Fails closed on a config that is not an object: an
- * unreadable `.mcp.json` is the user's, and overwriting it would lose servers we did not write. */
-export function mergeMcpServers(existing) {
+ * unreadable config is the user's, and overwriting it would lose servers we did not write. */
+export function mergeMcpServers(existing, format = "mcpServers") {
+  const shape = SERVER_FORMATS[format];
+  if (shape === undefined) throw new Error(`Unknown MCP config format '${format}'.`);
   const malformed =
     existing !== undefined &&
     (typeof existing !== "object" || existing === null || Array.isArray(existing));
@@ -47,13 +105,56 @@ export function mergeMcpServers(existing) {
     throw new Error("MCP config root must be an object.");
   }
   const previous = existing ?? {};
-  const servers = { ...(previous.mcpServers ?? {}) };
+  const existingServers = previous[shape.key];
+  if (
+    existingServers !== undefined &&
+    (typeof existingServers !== "object" ||
+      existingServers === null ||
+      Array.isArray(existingServers))
+  ) {
+    throw new Error(`MCP config '${shape.key}' must be an object.`);
+  }
+  const servers = { ...(existingServers ?? {}) };
+  for (const [name, server] of Object.entries(servers)) {
+    if (typeof server !== "object" || server === null || Array.isArray(server)) {
+      throw new Error(`MCP server '${name}' in '${shape.key}' must be an object.`);
+    }
+  }
   let changed = false;
+  const conflicts = [];
   for (const [name, server] of Object.entries(MCP_SERVERS)) {
-    const wanted = JSON.parse(JSON.stringify(server));
-    if (JSON.stringify(servers[name]) === JSON.stringify(wanted)) continue;
+    const wanted = shape.entry(server);
+    if (Object.hasOwn(servers, name)) {
+      if (JSON.stringify(servers[name]) !== JSON.stringify(wanted)) conflicts.push(name);
+      continue;
+    }
     servers[name] = wanted;
     changed = true;
   }
-  return { changed, config: { ...previous, mcpServers: servers } };
+  return { changed, conflicts, config: { ...previous, [shape.key]: servers } };
 }
+
+/** One server as a Codex TOML table. Derived from `MCP_SERVERS` rather than written out beside it:
+ * two hand-maintained lists of the same three servers drift, and the drift is silent until an
+ * agent in Codex quietly has no asset tools. */
+function codexServerBlock(name, server) {
+  const args = server.args.map((argument) => JSON.stringify(argument)).join(", ");
+  const lines = [
+    `[mcp_servers.${name}]`,
+    `command = ${JSON.stringify(server.command)}`,
+    `args = [${args}]`,
+  ];
+  if (server.env !== undefined) {
+    lines.push("", `[mcp_servers.${name}.env]`);
+    for (const [key, value] of Object.entries(server.env)) {
+      lines.push(`${key} = ${JSON.stringify(value)}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+export const CODEX_MCP_SERVERS = Object.freeze(
+  Object.entries(MCP_SERVERS).map(([name, server]) =>
+    Object.freeze({ body: codexServerBlock(name, server), name }),
+  ),
+);

package/package.json

@@ -1,13 +1,36 @@
 {
   "name": "@threenative/core",
-  "version": "0.3.0",
-  "license": "MIT",
+  "version": "0.3.2",
+  "license": "MIT AND GPL-2.0-or-later",
   "description": "The small vanilla Three.js game runtime foundation.",
+  "keywords": [
+    "threenative",
+    "three",
+    "threejs",
+    "webgpu",
+    "game-engine",
+    "game-framework",
+    "gamedev",
+    "typescript"
+  ],
+  "homepage": "https://github.com/ThreeNativeHQ/threenative#readme",
+  "bugs": {
+    "url": "https://github.com/ThreeNativeHQ/threenative/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ThreeNativeHQ/threenative.git",
+    "directory": "packages/core"
+  },
   "type": "module",
   "files": [
     "dist",
+    "LICENSE",
     "mcp",
-    "scripts",
+    "gpl",
+    "scripts/apply-three-patch.mjs",
+    "scripts/ensure-mcp.mjs",
+    "scripts/postinstall.mjs",
     "patches",
     "capabilities.json",
     "README.md"
@@ -40,6 +63,10 @@
       "types": "./dist/world.d.ts",
       "import": "./dist/world.js"
     },
+    "./net": {
+      "types": "./dist/net.d.ts",
+      "import": "./dist/net.js"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -49,7 +76,7 @@
   "dependencies": {
     "three": "0.185.1",
     "three-mesh-bvh": "0.9.14",
-    "threenative-asset-mcp": "0.6.0",
+    "threenative-asset-mcp": "0.8.0",
     "threenative-sculpt-mcp": "0.1.1",
     "zustand": "5.0.14"
   },
@@ -62,11 +89,12 @@
     "react-reconciler": "0.33.0",
     "tsup": "8.5.1",
     "typescript": "5.9.3",
-    "@threenative/playtest": "0.3.0",
-    "threenative-engine-mcp": "0.2.0"
+    "threenative-blender-mcp": "0.1.2",
+    "@threenative/playtest": "0.3.2",
+    "threenative-engine-mcp": "0.2.2"
   },
   "peerDependencies": {
-    "@threenative/playtest": ">=0.3.0 <0.4.0",
+    "@threenative/playtest": ">=0.3.2 <0.4.0",
     "react": ">=19.2.0 <20",
     "react-reconciler": ">=0.33.0 <0.34"
   },
@@ -83,7 +111,7 @@
   },
   "scripts": {
     "postinstall": "node ./scripts/postinstall.mjs",
-    "build": "node scripts/generate-version.mjs && tsup --config tsup.config.ts && node scripts/bundle-engine-mcp.mjs && publint",
+    "build": "node scripts/generate-version.mjs && tsup --config tsup.config.ts && node scripts/bundle-engine-mcp.mjs && node scripts/bundle-blender-mcp.mjs && publint",
     "typecheck": "tsc --noEmit",
     "test": "publint --strict"
   }

package/patches/three@0.185.1.patch

@@ -1,5 +1,5 @@
 diff --git a/build/three.cjs b/build/three.cjs
-index 8939a67d..b0f91724 100644
+index 8939a67dd76325ccd25ee8806fc4d22b1caea88a..b0f917241f1f2cd25baa21dec20edda32176ef6a 100644
 --- a/build/three.cjs
 +++ b/build/three.cjs
 @@ -26116,6 +26116,8 @@ function copyArrayContents( src, target ) {
@@ -12,7 +12,7 @@ index 8939a67d..b0f91724 100644
  	 * Constructs a new batched mesh.
  	 *
 diff --git a/build/three.core.js b/build/three.core.js
-index 0bb9262c..868a634b 100644
+index 0bb9262cd029f411933d077fd44197a51ec5e8e9..868a634b4294be5f32664912a50813d55d6dd6e7 100644
 --- a/build/three.core.js
 +++ b/build/three.core.js
 @@ -26136,6 +26136,8 @@ function copyArrayContents( src, target ) {
@@ -25,7 +25,7 @@ index 0bb9262c..868a634b 100644
  	 * Constructs a new batched mesh.
  	 *
 diff --git a/build/three.webgpu.js b/build/three.webgpu.js
-index 2e490796..325b497a 100644
+index 2e490796d4d4aa9479b04a5c46ddbf31cc05b1a1..d05599255744ccfca19dbfd0433da612583ce6ea 100644
 --- a/build/three.webgpu.js
 +++ b/build/three.webgpu.js
 @@ -18500,7 +18500,8 @@ const instance = /*@__PURE__*/ Fn( ( [ matrices, colors = null ], builder ) => {
@@ -86,7 +86,56 @@ index 2e490796..325b497a 100644
  
  			}
  
-@@ -39725,7 +39742,8 @@ class VelocityNode extends TempNode {
+@@ -29911,6 +29928,18 @@ class RenderObject {
+ 		 */
+ 		this._sourceMaterial = renderer._currentSourceMaterial;
+ 
++		/**
++		 * The version of `_sourceMaterial` this render object was last validated against.
++		 *
++		 * An override material is shared by every object in the pass and is used as a per-object
++		 * scratchpad, so its own `version` moves for reasons that have nothing to do with this
++		 * render object. The source material's version is the signal that does.
++		 *
++		 * @type {number}
++		 * @default 0
++		 */
++		this.sourceVersion = ( this._sourceMaterial === null || this._sourceMaterial === undefined ) ? 0 : this._sourceMaterial.version;
++
+ 		/**
+ 		 * An event listener which is defined by `RenderObjects`. It performs
+ 		 * clean up tasks when `dispose()` on this render object.
+@@ -30707,9 +30736,18 @@ class RenderObjects {
+ 
+ 			}
+ 
+-			if ( renderObject.version !== material.version || renderObject.needsUpdate ) {
++			// When the renderer is drawing through an override material, that material is shared by
++			// the whole pass and mutated per object, so its `version` alone answers the wrong
++			// question. The source material this object actually carries answers the right one.
++
++			const sourceMaterial = this.renderer._currentSourceMaterial;
++			const sourceTracked = sourceMaterial !== null && sourceMaterial !== undefined;
++			const sourceReplaced = sourceTracked && renderObject._sourceMaterial !== sourceMaterial;
++			const sourceChanged = sourceTracked && ( sourceReplaced || renderObject.sourceVersion !== sourceMaterial.version );
+ 
+-				if ( renderObject.initialCacheKey !== renderObject.getCacheKey() ) {
++			if ( renderObject.version !== material.version || sourceChanged || renderObject.needsUpdate ) {
++
++				if ( sourceReplaced || renderObject.initialCacheKey !== renderObject.getCacheKey() ) {
+ 
+ 					renderObject.dispose();
+ 
+@@ -30719,6 +30757,8 @@ class RenderObjects {
+ 
+ 					renderObject.version = material.version;
+ 
++					if ( sourceTracked ) renderObject.sourceVersion = sourceMaterial.version;
++
+ 				}
+ 
+ 			}
+@@ -39725,7 +39765,8 @@ class VelocityNode extends TempNode {
  
  		const previousModelMatrix = getPreviousMatrix( object );
  
@@ -96,7 +145,7 @@ index 2e490796..325b497a 100644
  
  		//
  
-@@ -53841,7 +53859,7 @@ class NodeBuilder {
+@@ -53841,7 +53882,7 @@ class NodeBuilder {
  
  		const mrt = this.renderer.getMRT();
  
@@ -105,7 +154,58 @@ index 2e490796..325b497a 100644
  
  	}
  
-@@ -83814,6 +83832,14 @@ class WebGPUBackend extends Backend {
+@@ -62731,6 +62772,7 @@ class Renderer {
+ 		let materialDisplacementMap;
+ 		let materialDisplacementScale;
+ 		let materialDisplacementBias;
++		let materialAlphaTest;
+ 
+ 		const previousSourceMaterial = this._currentSourceMaterial;
+ 
+@@ -62756,6 +62798,7 @@ class Renderer {
+ 			materialDisplacementMap = overrideMaterial.displacementMap;
+ 			materialDisplacementScale = overrideMaterial.displacementScale;
+ 			materialDisplacementBias = overrideMaterial.displacementBias;
++			materialAlphaTest = overrideMaterial.alphaTest;
+ 
+ 			if ( material.positionNode && material.positionNode.isNode ) {
+ 
+@@ -62763,7 +62806,15 @@ class Renderer {
+ 
+ 			}
+ 
+-			overrideMaterial.alphaTest = material.alphaTest;
++			// `Material.alphaTest`'s setter bumps `version` whenever alpha-test-ness flips, and this
++			// override material is shared by every caster in the pass. A scene that mixes alpha-tested
++			// casters with opaque ones therefore moves that shared version several times per frame,
++			// and every OTHER render object drawn with it then fails the version gate in
++			// `RenderObjects.get` and recomputes a full material cache key that always matches.
++			// Writing the backing field leaves the `alphaTest` getter — and so the cache key — still
++			// reporting this caster's value, while each render object tracks the staleness signal
++			// that belongs to it: its own source material's version.
++			overrideMaterial._alphaTest = material.alphaTest;
+ 			overrideMaterial.alphaMap = material.alphaMap;
+ 			overrideMaterial.displacementMap = material.displacementMap;
+ 			overrideMaterial.displacementScale = material.displacementScale;
+@@ -62825,6 +62876,7 @@ class Renderer {
+ 			scene.overrideMaterial.displacementMap = materialDisplacementMap;
+ 			scene.overrideMaterial.displacementScale = materialDisplacementScale;
+ 			scene.overrideMaterial.displacementBias = materialDisplacementBias;
++			scene.overrideMaterial._alphaTest = materialAlphaTest;
+ 
+ 		}
+ 
+@@ -79586,7 +79638,8 @@ class WGSLNodeBuilder extends NodeBuilder {
+ 
+ 				uniformGPU = buffer;
+ 
+-				uniformNode.name = name ? name : 'NodeBuffer_' + uniformNode.id;
++				// The base builder supplies a unique name within this program. A process-wide
++				// allocation id changes otherwise identical shader source for every buffer.
+ 
+ 			} else {
+ 
+@@ -83814,6 +83867,14 @@ class WebGPUBackend extends Backend {
  		 */
  		this.compatibilityMode = null;
  
@@ -120,7 +220,7 @@ index 2e490796..325b497a 100644
  		/**
  		 * A reference to the device.
  		 *
-@@ -83926,7 +83952,9 @@ class WebGPUBackend extends Backend {
+@@ -83926,7 +83987,9 @@ class WebGPUBackend extends Backend {
  				xrCompatible: renderer.xr.enabled
  			};
  
@@ -132,7 +232,7 @@ index 2e490796..325b497a 100644
  			if ( adapter === null ) {
  
 diff --git a/src/nodes/accessors/Batch.js b/src/nodes/accessors/Batch.js
-index ab62e98d..2cf4bb60 100644
+index ab62e98dadab2539d7e1d663fd42267bbc8ebcaa..2cf4bb6039853d5c922e89041419250b243694ef 100644
 --- a/src/nodes/accessors/Batch.js
 +++ b/src/nodes/accessors/Batch.js
 @@ -1,6 +1,6 @@
@@ -178,7 +278,7 @@ index ab62e98d..2cf4bb60 100644
 -
 -
 diff --git a/src/nodes/accessors/Instance.js b/src/nodes/accessors/Instance.js
-index b89834b9..c7b7bdd7 100644
+index b89834b9166c75fd946ade24db265bf8c367d244..c7b7bdd7a31d852a581d4bc75a1e1afc1d214e5e 100644
 --- a/src/nodes/accessors/Instance.js
 +++ b/src/nodes/accessors/Instance.js
 @@ -220,7 +220,8 @@ export const instance = /*@__PURE__*/ Fn( ( [ matrices, colors = null ], builder
@@ -192,7 +292,7 @@ index b89834b9..c7b7bdd7 100644
  		} );
  
 diff --git a/src/nodes/accessors/Skinning.js b/src/nodes/accessors/Skinning.js
-index 2356aed8..aaeea633 100644
+index 2356aed8656dceb1ea74b73ea2e739371a960484..aaeea633a8ece291be5faf868e312867ddad01b6 100644
 --- a/src/nodes/accessors/Skinning.js
 +++ b/src/nodes/accessors/Skinning.js
 @@ -149,7 +149,8 @@ export const skinning = /*@__PURE__*/ Fn( ( [ skinnedMesh ], builder ) => {
@@ -216,7 +316,7 @@ index 2356aed8..aaeea633 100644
  			}
  
 diff --git a/src/nodes/accessors/VelocityNode.js b/src/nodes/accessors/VelocityNode.js
-index 373548b0..c48002ab 100644
+index 373548b0b587e7da3ef0993bfe316af420e7f66c..c48002abbce20ee8b29908cf314d7b03afe0db03 100644
 --- a/src/nodes/accessors/VelocityNode.js
 +++ b/src/nodes/accessors/VelocityNode.js
 @@ -106,7 +106,8 @@ class VelocityNode extends TempNode {
@@ -230,7 +330,7 @@ index 373548b0..c48002ab 100644
  		//
  
 diff --git a/src/nodes/core/NodeBuilder.js b/src/nodes/core/NodeBuilder.js
-index be00b81e..1990da8f 100644
+index be00b81ef36e1af83b0066603e616f8f1f81a115..1990da8fe8f1f29a7b53030756dfd966d8de3cb6 100644
 --- a/src/nodes/core/NodeBuilder.js
 +++ b/src/nodes/core/NodeBuilder.js
 @@ -3450,7 +3450,7 @@ class NodeBuilder {
@@ -243,7 +343,7 @@ index be00b81e..1990da8f 100644
  	}
  
 diff --git a/src/objects/BatchedMesh.js b/src/objects/BatchedMesh.js
-index 2ef7cb25..35cc0ffe 100644
+index 2ef7cb257438826059eb2408b3756c4891f06a10..35cc0ffe83a69ea9fa5fca6dec2d820ca193f88d 100644
 --- a/src/objects/BatchedMesh.js
 +++ b/src/objects/BatchedMesh.js
 @@ -181,6 +181,8 @@ function copyArrayContents( src, target ) {
@@ -255,8 +355,129 @@ index 2ef7cb25..35cc0ffe 100644
  	/**
  	 * Constructs a new batched mesh.
  	 *
+diff --git a/src/renderers/common/Bindings.js b/src/renderers/common/Bindings.js
+index 5f3d213a016b37db3b2e5d022da3dd0234d86f6d..7a9a168f29773f37ef9a51ef9f07ade9f3ea95ef 100644
+--- a/src/renderers/common/Bindings.js
++++ b/src/renderers/common/Bindings.js
+@@ -206,10 +206,14 @@ class Bindings extends DataMap {
+ 
+ 					} else if ( binding.isSampledTexture ) {
+ 
++						// Async node compilation can yield while a viewport node changes targets.
++						// Refresh its reference before creating the first GPU binding, not after.
++						binding.update();
+ 						this.textures.updateTexture( binding.texture );
+ 
+ 					} else if ( binding.isSampler ) {
+ 
++						binding.update();
+ 						this.textures.updateSampler( binding );
+ 
+ 					} else if ( binding.isStorageBuffer ) {
+diff --git a/src/renderers/common/RenderObject.js b/src/renderers/common/RenderObject.js
+index c900fa4c9654f8cf3512e96de52a2c1c83e189a6..d0a87eabffc8f667ebe9b2f0eccda0ddf3309652 100644
+--- a/src/renderers/common/RenderObject.js
++++ b/src/renderers/common/RenderObject.js
+@@ -299,6 +299,18 @@ class RenderObject {
+ 		 */
+ 		this._sourceMaterial = renderer._currentSourceMaterial;
+ 
++		/**
++		 * The version of `_sourceMaterial` this render object was last validated against.
++		 *
++		 * An override material is shared by every object in the pass and is used as a per-object
++		 * scratchpad, so its own `version` moves for reasons that have nothing to do with this
++		 * render object. The source material's version is the signal that does.
++		 *
++		 * @type {number}
++		 * @default 0
++		 */
++		this.sourceVersion = ( this._sourceMaterial === null || this._sourceMaterial === undefined ) ? 0 : this._sourceMaterial.version;
++
+ 		/**
+ 		 * An event listener which is defined by `RenderObjects`. It performs
+ 		 * clean up tasks when `dispose()` on this render object.
+diff --git a/src/renderers/common/RenderObjects.js b/src/renderers/common/RenderObjects.js
+index 676cc2bd4169427ed420f2467b1e6684bd2aeebc..0fa661db793548254a15ff43f39207abcc43ef49 100644
+--- a/src/renderers/common/RenderObjects.js
++++ b/src/renderers/common/RenderObjects.js
+@@ -124,9 +124,18 @@ class RenderObjects {
+ 
+ 			}
+ 
+-			if ( renderObject.version !== material.version || renderObject.needsUpdate ) {
++			// When the renderer is drawing through an override material, that material is shared by
++			// the whole pass and mutated per object, so its `version` alone answers the wrong
++			// question. The source material this object actually carries answers the right one.
+ 
+-				if ( renderObject.initialCacheKey !== renderObject.getCacheKey() ) {
++			const sourceMaterial = this.renderer._currentSourceMaterial;
++			const sourceTracked = sourceMaterial !== null && sourceMaterial !== undefined;
++			const sourceReplaced = sourceTracked && renderObject._sourceMaterial !== sourceMaterial;
++			const sourceChanged = sourceTracked && ( sourceReplaced || renderObject.sourceVersion !== sourceMaterial.version );
++
++			if ( renderObject.version !== material.version || sourceChanged || renderObject.needsUpdate ) {
++
++				if ( sourceReplaced || renderObject.initialCacheKey !== renderObject.getCacheKey() ) {
+ 
+ 					renderObject.dispose();
+ 
+@@ -136,6 +145,8 @@ class RenderObjects {
+ 
+ 					renderObject.version = material.version;
+ 
++					if ( sourceTracked ) renderObject.sourceVersion = sourceMaterial.version;
++
+ 				}
+ 
+ 			}
+diff --git a/src/renderers/common/Renderer.js b/src/renderers/common/Renderer.js
+index 8dfc2ae055ad7b9d4c00e91f7d52a39e747caebe..e9d27b3ddad3b1f080a717d1f6683b60afd2b259 100644
+--- a/src/renderers/common/Renderer.js
++++ b/src/renderers/common/Renderer.js
+@@ -3550,6 +3550,7 @@ class Renderer {
+ 		let materialDisplacementMap;
+ 		let materialDisplacementScale;
+ 		let materialDisplacementBias;
++		let materialAlphaTest;
+ 
+ 		const previousSourceMaterial = this._currentSourceMaterial;
+ 
+@@ -3575,6 +3576,7 @@ class Renderer {
+ 			materialDisplacementMap = overrideMaterial.displacementMap;
+ 			materialDisplacementScale = overrideMaterial.displacementScale;
+ 			materialDisplacementBias = overrideMaterial.displacementBias;
++			materialAlphaTest = overrideMaterial.alphaTest;
+ 
+ 			if ( material.positionNode && material.positionNode.isNode ) {
+ 
+@@ -3582,7 +3584,15 @@ class Renderer {
+ 
+ 			}
+ 
+-			overrideMaterial.alphaTest = material.alphaTest;
++			// `Material.alphaTest`'s setter bumps `version` whenever alpha-test-ness flips, and this
++			// override material is shared by every caster in the pass. A scene that mixes alpha-tested
++			// casters with opaque ones therefore moves that shared version several times per frame,
++			// and every OTHER render object drawn with it then fails the version gate in
++			// `RenderObjects.get` and recomputes a full material cache key that always matches.
++			// Writing the backing field leaves the `alphaTest` getter — and so the cache key — still
++			// reporting this caster's value, while each render object tracks the staleness signal
++			// that belongs to it: its own source material's version.
++			overrideMaterial._alphaTest = material.alphaTest;
+ 			overrideMaterial.alphaMap = material.alphaMap;
+ 			overrideMaterial.displacementMap = material.displacementMap;
+ 			overrideMaterial.displacementScale = material.displacementScale;
+@@ -3644,6 +3654,7 @@ class Renderer {
+ 			scene.overrideMaterial.displacementMap = materialDisplacementMap;
+ 			scene.overrideMaterial.displacementScale = materialDisplacementScale;
+ 			scene.overrideMaterial.displacementBias = materialDisplacementBias;
++			scene.overrideMaterial._alphaTest = materialAlphaTest;
+ 
+ 		}
+ 
 diff --git a/src/renderers/webgpu/WebGPUBackend.js b/src/renderers/webgpu/WebGPUBackend.js
-index 06e20369..37b5e0be 100644
+index 06e203693ed9b168a2bddf773cd8ce8dc23196e4..37b5e0be09967e8acbd38e570b71eb201fc9bad7 100644
 --- a/src/renderers/webgpu/WebGPUBackend.js
 +++ b/src/renderers/webgpu/WebGPUBackend.js
 @@ -102,6 +102,14 @@ class WebGPUBackend extends Backend {
@@ -285,3 +506,17 @@ index 06e20369..37b5e0be 100644
  
  			if ( adapter === null ) {
  
+diff --git a/src/renderers/webgpu/nodes/WGSLNodeBuilder.js b/src/renderers/webgpu/nodes/WGSLNodeBuilder.js
+index be07536301cd47ef2544e4a54f6abe17407f52af..6144b98ddeb5d53c5cf280bb51401385a4427547 100644
+--- a/src/renderers/webgpu/nodes/WGSLNodeBuilder.js
++++ b/src/renderers/webgpu/nodes/WGSLNodeBuilder.js
+@@ -1323,7 +1323,8 @@ class WGSLNodeBuilder extends NodeBuilder {
+ 
+ 				uniformGPU = buffer;
+ 
+-				uniformNode.name = name ? name : 'NodeBuffer_' + uniformNode.id;
++				// The base builder supplies a unique name within this program. A process-wide
++				// allocation id changes otherwise identical shader source for every buffer.
+ 
+ 			} else {
+ 

package/scripts/ensure-mcp.mjs

@@ -3,31 +3,38 @@ import path from "node:path";
 import { pathToFileURL } from "node:url";
 // Installing ThreeNative wires its MCP servers into the project. An agent authoring a game here
 // should not have to be told the asset, sculpt and capability tools exist, or run a setup command
-// to get them. `.mcp.json` serves compatible hosts; Codex reads project-scoped `.codex/config.toml`.
-// Set THREENATIVE_SKIP_MCP_SETUP=1 to opt out.
-import { ensureCodexMcpConfig, ensureMcpConfig, installTarget } from "../mcp/install.mjs";
+// to get them. Every host that reads a project-scoped MCP config gets one — `MCP_HOSTS` is the
+// list. Set THREENATIVE_SKIP_MCP_SETUP=1 to opt out.
+import { MCP_HOSTS, ensureHostMcpConfigs, installTarget } from "../mcp/install.mjs";
+
+const LABELS = new Map(MCP_HOSTS.map((host) => [host.id, host.label]));
 
 export function runMcpSetup(environment = process.env, cwd = process.cwd()) {
   const skip = environment.THREENATIVE_SKIP_MCP_SETUP;
   if (skip === "1" || skip === "true") return;
-  // Never fail an install over this. A game that cannot write .mcp.json still runs.
+  // Never fail an install over this. A game that cannot write its MCP configs still runs.
   try {
     const target = installTarget(environment, cwd);
     if (target === undefined) return;
-    const outcome = ensureMcpConfig(target);
-    const codexOutcome = ensureCodexMcpConfig(target);
-    if (outcome === "created" || outcome === "updated") {
-      process.stdout.write(`threenative: ${outcome} .mcp.json with the ThreeNative MCP servers\n`);
-    } else if (outcome === "unreadable") {
-      process.stdout.write("threenative: .mcp.json is not valid JSON; left it alone\n");
+    const outcomes = ensureHostMcpConfigs(target);
+    const wired = [...outcomes]
+      .filter(([, outcome]) => outcome === "created" || outcome === "updated")
+      .map(([id]) => LABELS.get(id) ?? id);
+    if (wired.length > 0) {
+      process.stdout.write(
+        `threenative: wired the ThreeNative MCP servers for ${wired.join(", ")}\n`,
+      );
     }
-    if (codexOutcome === "created" || codexOutcome === "updated") {
+    const unreadable = [...outcomes]
+      .filter(([, outcome]) => outcome === "unreadable")
+      .map(([id]) => LABELS.get(id) ?? id);
+    if (unreadable.length > 0) {
       process.stdout.write(
-        `threenative: ${codexOutcome} .codex/config.toml with the ThreeNative MCP servers\n`,
+        `threenative: left ${unreadable.join(", ")} alone; its config is not valid JSON\n`,
       );
     }
   } catch (error) {
-    process.stdout.write(`threenative: could not wire .mcp.json (${error})\n`);
+    process.stdout.write(`threenative: could not wire the MCP configs (${error})\n`);
   }
 }
 

package/scripts/bundle-engine-mcp.mjs

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-import { copyFileSync, existsSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const coreRoot = path.resolve(fileURLToPath(import.meta.url), "..", "..");
-const source = path.resolve(coreRoot, "..", "engine-mcp", "dist", "index.js");
-const target = path.join(coreRoot, "mcp", "engine-server.mjs");
-
-if (!existsSync(source)) {
-  throw new Error(
-    `TN_ENGINE_MCP_BUNDLE: build threenative-engine-mcp before core; missing ${source}`,
-  );
-}
-copyFileSync(source, target);

package/scripts/generate-version.mjs

@@ -1,13 +0,0 @@
-// Single owner of the core version (PRD-181): package.json is the source of truth and
-// src/version.ts is generated from it and checked in. A hand-edited constant goes stale the
-// moment the manifest bumps; the pinning spec turns that red.
-import { readFile, writeFile } from "node:fs/promises";
-
-const manifest = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8"));
-if (typeof manifest.version !== "string" || manifest.version.length === 0) {
-  throw new Error("generate-version: package.json has no version");
-}
-await writeFile(
-  new URL("../src/version.ts", import.meta.url),
-  `// Generated by scripts/generate-version.mjs - do not edit. Source: package.json.\nexport const CORE_VERSION = ${JSON.stringify(manifest.version)};\n`,
-);