incanto 0.13.0 → 0.14.0

package/dist/3d.d.ts

@@ -888,9 +888,13 @@ declare class Flowers3D extends Node3D {
   clustering: number;
   /** Gentle head-bob wind strength — 0 holds still. */
   sway: number;
-  /** Drape each plant onto a Terrain3D's surface so flowers root on the ground
-  * instead of a flat plane (lets ONE bed cover rolling terrain). */
-  drape: boolean;
+  /**
+  * null (the default) is AUTO: whenever the scene has a Terrain3D, instances
+  * root on it — flat ground behaves as before, rolling terrain just works.
+  * true forces it (keeps retrying until a terrain appears), false disables
+  * draping entirely.
+  */
+  drape: boolean | null;
   /** Drape target: a node path to the Terrain3D. Empty = auto-find the first
   * Terrain3D in the tree (the zero-config default when `drape` is on). */
   terrain: string;
@@ -1025,9 +1029,14 @@ declare class Foliage3D extends Node3D implements SunConsumer3D {
   flowers: number;
   /** Placement seed — the field is identical across runs and machines. */
   seed: number;
-  /** Drape each instance onto a Terrain3D's surface so blades root on the
-  * ground instead of a flat plane (lets ONE field cover rolling terrain). */
-  drape: boolean;
+  /**
+  * Drape each instance onto a Terrain3D's surface so blades root on the
+  * ground instead of a flat plane. null (the default) is AUTO: whenever the
+  * scene has a Terrain3D, instances root on it — flat ground behaves as
+  * before, rolling terrain just works. true forces it (keeps retrying until
+  * a terrain appears), false disables draping entirely.
+  */
+  drape: boolean | null;
   /** Drape target: a node path to the Terrain3D. Empty = auto-find the first
   * Terrain3D in the tree (the zero-config default when `drape` is on). */
   terrain: string;
@@ -1061,6 +1070,8 @@ declare class Foliage3D extends Node3D implements SunConsumer3D {
   /** @internal Every InstancedMesh of the field: [quads] or [quads, quads90°]. */
   _fields(): InstancedMesh[];
   override update(dt: number): void;
+  /** Wind time/strength + the ≤4 character-bend slots (no-op before first build). */
+  private writeAnimationUniforms;
   override _syncObject3D(): void;
   /**
   * @internal Environment-sky sun hand-off (see {@link SunConsumer3D}): the
@@ -1821,11 +1832,14 @@ declare class Tree3D extends Node3D {
   /** Let leaves cast shadows. false keeps trunk/branch shadows but drops the
   * expensive alpha-cutout leaf shadow pass (the dappled floor) for big FPS. */
   leafShadows: boolean;
-  /** Drape the grove over a Terrain3D: each scattered instance roots at the
-  * ground height under it (not the node's single Y), so a patch on rolling or
-  * carved terrain never floats/buries. No effect on a count:1 tree placed by
-  * hand unless it sits off the ground. */
-  drape: boolean;
+  /**
+  * Drape the grove over a Terrain3D: each scattered instance roots at the
+  * ground height under it (not the node's single Y), so a patch on rolling
+  * or carved terrain never floats/buries. null (the default) is AUTO:
+  * whenever the scene has a Terrain3D the grove drapes onto it. true forces
+  * it (keeps retrying until a terrain appears), false disables draping.
+  */
+  drape: boolean | null;
   /** Node path to the Terrain3D to drape onto ('' = auto-find the first one). */
   terrain: string;
   /** Resolved drape target + the grove's world position, set per rebuild. */

package/dist/3d.js

@@ -1,8 +1,8 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { a as Environment3D, c as sunDirectionFromElevationAzimuth, i as syncTree, l as sunDirectionFromSky, o as horizonColorFromSky, r as Renderer3D, s as parseEnvironment3D, t as createGame3D, u as AssetStore3D } from "./create-game-J6g4QInv.js";
-import { A as Area3D, B as movementState, C as BoneAttachment3D, D as TERRAIN_THEMES, E as DEFAULT_TERRAIN_TEXTURE_BASE, F as Node3D, L as QUARTER_PITCH, M as PhysicsBody3D, N as RigidBody3D, O as terrainThemeLayers, P as StaticBody3D, R as cameraRelative, S as BoneLookAt3D, T as Terrain3D, V as rigPose, _ as Flowers3D, a as VoxelGrid3D, b as CharacterController3D, c as Particles3D, d as DirectionalLight3D, f as OmniLight3D, g as DENSITY_PRESETS, h as Foliage3D, i as VOXEL_PALETTE, j as CharacterBody3D, k as Joint3D, l as ModelInstance3D, m as MeshInstance3D, n as Water3D, o as Tree3D, p as InstancedMesh3D, r as WATER_MAX_RIPPLES, s as Trail3D, t as registerNodes3D, u as LoftMesh3D, v as resolveFlowerDensity, w as Billboard3D, x as Camera3D, y as FLOWER_VARIETIES, z as keyboardIntensity } from "./register-BFw4c83z.js";
+import { a as Environment3D, c as sunDirectionFromElevationAzimuth, i as syncTree, l as sunDirectionFromSky, o as horizonColorFromSky, r as Renderer3D, s as parseEnvironment3D, t as createGame3D, u as AssetStore3D } from "./create-game-OSntcIiM.js";
+import { A as Area3D, B as movementState, C as BoneAttachment3D, D as TERRAIN_THEMES, E as DEFAULT_TERRAIN_TEXTURE_BASE, F as Node3D, L as QUARTER_PITCH, M as PhysicsBody3D, N as RigidBody3D, O as terrainThemeLayers, P as StaticBody3D, R as cameraRelative, S as BoneLookAt3D, T as Terrain3D, V as rigPose, _ as Flowers3D, a as VoxelGrid3D, b as CharacterController3D, c as Particles3D, d as DirectionalLight3D, f as OmniLight3D, g as DENSITY_PRESETS, h as Foliage3D, i as VOXEL_PALETTE, j as CharacterBody3D, k as Joint3D, l as ModelInstance3D, m as MeshInstance3D, n as Water3D, o as Tree3D, p as InstancedMesh3D, r as WATER_MAX_RIPPLES, s as Trail3D, t as registerNodes3D, u as LoftMesh3D, v as resolveFlowerDensity, w as Billboard3D, x as Camera3D, y as FLOWER_VARIETIES, z as keyboardIntensity } from "./register-C9-16x_t.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CroQPEER.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-DhaAaKJo.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-D_kUdOjr.js";
 //#region src/3d/environment-runtime.ts
 /**
 * Live environment editing — the renderer re-applies `scene.environment`

package/dist/{create-game-J6g4QInv.js → create-game-OSntcIiM.js}

@@ -5,8 +5,8 @@ import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
 import { n as registerGameplayBehaviors } from "./gameplay-sSqrUcnz.js";
 import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
-import { F as Node3D, M as PhysicsBody3D, d as DirectionalLight3D, l as ModelInstance3D, t as registerNodes3D, x as Camera3D } from "./register-BFw4c83z.js";
-import { n as enablePhysics3D } from "./physics-3d-DhaAaKJo.js";
+import { F as Node3D, M as PhysicsBody3D, d as DirectionalLight3D, l as ModelInstance3D, t as registerNodes3D, x as Camera3D } from "./register-C9-16x_t.js";
+import { n as enablePhysics3D } from "./physics-3d-D_kUdOjr.js";
 import { ACESFilmicToneMapping, AmbientLight, Box3, BufferAttribute, BufferGeometry, Color, DepthTexture, EquirectangularReflectionMapping, FloatType, Fog, HalfFloatType, LineBasicMaterial, LineSegments, Matrix4, Mesh, PCFShadowMap, PMREMGenerator, PerspectiveCamera, PlaneGeometry, Quaternion, Raycaster, Scene, ShaderMaterial, Vector2, Vector3, WebGLRenderTarget, WebGLRenderer } from "three";
 import { VRMLoaderPlugin, VRMUtils } from "@pixiv/three-vrm";
 import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";

package/dist/index.js

@@ -295,6 +295,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.13.0";
+const VERSION = "0.14.0";
 //#endregion
 export { AudioBuses, AudioPlayer, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, Scene, SceneTree, SfxEngine, Signal, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiText, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveRendering, resolveViewport, serializeNode, spatialGain, spatialPan, startRecording, synthSfx };

package/dist/{physics-3d-DhaAaKJo.js → physics-3d-D_kUdOjr.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as registerDebugSource } from "./debug-draw-CZmOYjL2.js";
-import { A as Area3D, F as Node3D, I as validateCollider3D, M as PhysicsBody3D, N as RigidBody3D, T as Terrain3D, j as CharacterBody3D, k as Joint3D } from "./register-BFw4c83z.js";
+import { A as Area3D, F as Node3D, I as validateCollider3D, M as PhysicsBody3D, N as RigidBody3D, T as Terrain3D, j as CharacterBody3D, k as Joint3D } from "./register-C9-16x_t.js";
 import { Euler, Quaternion } from "three";
 //#region src/3d/physics/physics-3d.ts
 var physics_3d_exports = /* @__PURE__ */ __exportAll({

package/dist/react.js

@@ -156,7 +156,7 @@ function IncantoCanvas(props) {
 				pointer: latest.pointer,
 				...keyboard !== void 0 ? { keyboard } : {}
 			};
-			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-J6g4QInv.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-Ct86zczq.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-OSntcIiM.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-Ct86zczq.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-BFw4c83z.js → register-C9-16x_t.js}

@@ -3066,7 +3066,7 @@ var Flowers3D = class extends Node3D {
 		height: { default: .45 },
 		clustering: { default: .6 },
 		sway: { default: .5 },
-		drape: { default: false },
+		drape: { default: null },
 		terrain: { default: "" }
 	};
 	/** 'lush' | 'sparse' | 'none' | plants per m² (load-time check + budget). */
@@ -3087,9 +3087,13 @@ var Flowers3D = class extends Node3D {
 	clustering = .6;
 	/** Gentle head-bob wind strength — 0 holds still. */
 	sway = .5;
-	/** Drape each plant onto a Terrain3D's surface so flowers root on the ground
-	* instead of a flat plane (lets ONE bed cover rolling terrain). */
-	drape = false;
+	/**
+	* null (the default) is AUTO: whenever the scene has a Terrain3D, instances
+	* root on it — flat ground behaves as before, rolling terrain just works.
+	* true forces it (keeps retrying until a terrain appears), false disables
+	* draping entirely.
+	*/
+	drape = null;
 	/** Drape target: a node path to the Terrain3D. Empty = auto-find the first
 	* Terrain3D in the tree (the zero-config default when `drape` is on). */
 	terrain = "";
@@ -3119,7 +3123,7 @@ var Flowers3D = class extends Node3D {
 		if (!(f.height > 0)) throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' height must be > 0 meters, got ${f.height}.`, { prop: "height" });
 		if (!(f.clustering >= 0) || !(f.clustering <= 1)) throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' clustering must be in [0, 1] (0 uniform … 1 tight patches), got ${f.clustering}.`, { prop: "clustering" });
 		if (!(f.sway >= 0)) throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' sway must be >= 0, got ${f.sway}.`, { prop: "sway" });
-		if (typeof f.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' drape must be a boolean, got ${JSON.stringify(f.drape)}.`, { prop: "drape" });
+		if (f.drape !== null && typeof f.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' drape must be true, false or null (null = auto: drape whenever the scene has a Terrain3D), got ${JSON.stringify(f.drape)}.`, { prop: "drape" });
 		if (typeof f.terrain !== "string") throw new IncantoError("BAD_FORMAT", `Flowers3D '${node.name}' terrain must be a node-path string (empty = auto-find), got ${JSON.stringify(f.terrain)}.`, { prop: "terrain" });
 	}
 	time = 0;
@@ -3172,7 +3176,7 @@ var Flowers3D = class extends Node3D {
 	/** Resolve the drape target + cache the bed's world position for `bedY`. */
 	resolveDrape() {
 		this.drapeTerrain = null;
-		if (!this.drape) return;
+		if (this.drape === false) return;
 		const terrain = findDrapeTerrain(this, this.terrain);
 		if (terrain) {
 			this.drapeTerrain = terrain;
@@ -4449,7 +4453,7 @@ var Foliage3D = class Foliage3D extends Node3D {
 		coverage: { default: .85 },
 		flowers: { default: 0 },
 		seed: { default: 1 },
-		drape: { default: false },
+		drape: { default: null },
 		terrain: { default: "" },
 		renderOrder: { default: 2 }
 	};
@@ -4508,9 +4512,14 @@ var Foliage3D = class Foliage3D extends Node3D {
 	flowers = 0;
 	/** Placement seed — the field is identical across runs and machines. */
 	seed = 1;
-	/** Drape each instance onto a Terrain3D's surface so blades root on the
-	* ground instead of a flat plane (lets ONE field cover rolling terrain). */
-	drape = false;
+	/**
+	* Drape each instance onto a Terrain3D's surface so blades root on the
+	* ground instead of a flat plane. null (the default) is AUTO: whenever the
+	* scene has a Terrain3D, instances root on it — flat ground behaves as
+	* before, rolling terrain just works. true forces it (keeps retrying until
+	* a terrain appears), false disables draping entirely.
+	*/
+	drape = null;
 	/** Drape target: a node path to the Terrain3D. Empty = auto-find the first
 	* Terrain3D in the tree (the zero-config default when `drape` is on). */
 	terrain = "";
@@ -4544,7 +4553,7 @@ var Foliage3D = class Foliage3D extends Node3D {
 		if (!Array.isArray(sun) || sun.length !== 3 || !sun.every((v) => Number.isFinite(v)) || Math.hypot(sun[0] ?? 0, sun[1] ?? 0, sun[2] ?? 0) === 0) throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' sunDirection must be a non-zero [x, y, z] vector, got ${JSON.stringify(sun)}.`, { prop: "sunDirection" });
 		if (!(f.coverage > 0) || !(f.coverage <= 1)) throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' coverage must be in (0, 1] (carpet fill — 1 is solid, lower carves dirt patches), got ${f.coverage}.`, { prop: "coverage" });
 		if (!(f.flowers >= 0) || !(f.flowers <= .2)) throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' flowers must be in [0, 0.2] (fraction of instances rendered as flower heads — for a whole flower FIELD use kind: 'flowers'), got ${f.flowers}.`, { prop: "flowers" });
-		if (typeof f.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' drape must be a boolean, got ${JSON.stringify(f.drape)}.`, { prop: "drape" });
+		if (f.drape !== null && typeof f.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' drape must be true, false or null (null = auto: drape whenever the scene has a Terrain3D), got ${JSON.stringify(f.drape)}.`, { prop: "drape" });
 		if (typeof f.terrain !== "string") throw new IncantoError("BAD_FORMAT", `Foliage3D '${node.name}' terrain must be a node-path string (empty = auto-find), got ${JSON.stringify(f.terrain)}.`, { prop: "terrain" });
 	}
 	time = 0;
@@ -4590,16 +4599,33 @@ var Foliage3D = class Foliage3D extends Node3D {
 	update(dt) {
 		this.time += dt;
 		this.pickedBenders = this.computeBenders();
+		this.writeAnimationUniforms();
+	}
+	/** Wind time/strength + the ≤4 character-bend slots (no-op before first build). */
+	writeAnimationUniforms() {
+		if (this.isShaderField && this.bladesMaterial) {
+			const u = this.bladesMaterial.uniforms;
+			if (u.time) u.time.value = this.time;
+			if (u.windStrength) u.windStrength.value = this.sway * (this.isMesh ? MESH_SWAY_TO_WIND : SWAY_TO_WIND);
+			const slots = this.benderSlots;
+			if (slots) for (let i = 0; i < 4; i++) {
+				const b = this.pickedBenders[i];
+				if (b) slots[i]?.set(b.x, b.y, b.z, b.radius);
+				else slots[i]?.set(0, 0, 0, 0);
+			}
+		} else if (this.isTufts) {
+			if (this.tuftTime) this.tuftTime.value = this.time;
+			if (this.tuftStrength) this.tuftStrength.value = this.sway * TUFT_SWAY_TO_WIND;
+		}
 	}
 	_syncObject3D() {
 		super._syncObject3D();
 		this.rebuildIfNeeded();
 		const pivot = this.pivot;
+		this.writeAnimationUniforms();
 		if (this.isShaderField) {
 			pivot.matrix.identity();
 			const u = this.bladesMaterial.uniforms;
-			if (u.time) u.time.value = this.time;
-			if (u.windStrength) u.windStrength.value = this.sway * (this.isMesh ? MESH_SWAY_TO_WIND : SWAY_TO_WIND);
 			(u.bottomColor?.value).set(this.colorA);
 			(u.topColor?.value).set(this.colorB);
 			if (this.isMesh) {
@@ -4608,17 +4634,8 @@ var Foliage3D = class Foliage3D extends Node3D {
 				if (u.fadeStart) u.fadeStart.value = this.fadeStart;
 				if (u.fadeEnd) u.fadeEnd.value = this.fadeEnd;
 			}
-			const slots = this.benderSlots;
-			for (let i = 0; i < 4; i++) {
-				const b = this.pickedBenders[i];
-				if (b) slots[i]?.set(b.x, b.y, b.z, b.radius);
-				else slots[i]?.set(0, 0, 0, 0);
-			}
-		} else if (this.isTufts) {
-			pivot.matrix.identity();
-			if (this.tuftTime) this.tuftTime.value = this.time;
-			if (this.tuftStrength) this.tuftStrength.value = this.sway * TUFT_SWAY_TO_WIND;
-		} else if (this.sway > 0) {
+		} else if (this.isTufts) pivot.matrix.identity();
+		else if (this.sway > 0) {
 			const leanX = Math.sin(this.time * 1.7) * SWAY_LEAN * this.sway;
 			const leanZ = Math.sin(this.time * 1.3 + 1.7) * SWAY_LEAN * this.sway * .6;
 			pivot.matrix.makeShear(0, 0, leanX, leanZ, 0, 0);
@@ -4645,7 +4662,7 @@ var Foliage3D = class Foliage3D extends Node3D {
 	computeBenders() {
 		if (!this.interaction || !this.isShaderField) return [];
 		const [fx, fy, fz] = worldXZY(this);
-		if (this.drape && !this.drapeTerrain) this.resolveDrape();
+		if (this.drape === true && !this.drapeTerrain) this.resolveDrape();
 		const terrain = this.drapeTerrain;
 		const candidates = [];
 		for (const b of movingBodiesFor(this)) {
@@ -4706,7 +4723,7 @@ var Foliage3D = class Foliage3D extends Node3D {
 	/** Resolve the drape target + cache the field's world position for `bedY`. */
 	resolveDrape() {
 		this.drapeTerrain = null;
-		if (!this.drape) return;
+		if (this.drape === false) return;
 		const terrain = findDrapeTerrain(this, this.terrain);
 		if (terrain) {
 			this.drapeTerrain = terrain;
@@ -8411,7 +8428,7 @@ var Tree3D = class Tree3D extends Node3D {
 		leafFadeStart: { default: 0 },
 		leafFadeEnd: { default: 0 },
 		leafShadows: { default: true },
-		drape: { default: false },
+		drape: { default: null },
 		terrain: { default: "" }
 	};
 	/** 'simple' (primitive low-poly) | 'medium' (light ez-trees) | 'high' (full). */
@@ -8440,11 +8457,14 @@ var Tree3D = class Tree3D extends Node3D {
 	/** Let leaves cast shadows. false keeps trunk/branch shadows but drops the
 	* expensive alpha-cutout leaf shadow pass (the dappled floor) for big FPS. */
 	leafShadows = true;
-	/** Drape the grove over a Terrain3D: each scattered instance roots at the
-	* ground height under it (not the node's single Y), so a patch on rolling or
-	* carved terrain never floats/buries. No effect on a count:1 tree placed by
-	* hand unless it sits off the ground. */
-	drape = false;
+	/**
+	* Drape the grove over a Terrain3D: each scattered instance roots at the
+	* ground height under it (not the node's single Y), so a patch on rolling
+	* or carved terrain never floats/buries. null (the default) is AUTO:
+	* whenever the scene has a Terrain3D the grove drapes onto it. true forces
+	* it (keeps retrying until a terrain appears), false disables draping.
+	*/
+	drape = null;
 	/** Node path to the Terrain3D to drape onto ('' = auto-find the first one). */
 	terrain = "";
 	/** Resolved drape target + the grove's world position, set per rebuild. */
@@ -8463,7 +8483,7 @@ var Tree3D = class Tree3D extends Node3D {
 		if (!((t.area[0] ?? 0) > 0) || !((t.area[1] ?? 0) > 0)) throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' area must be positive [x, z] meters, got ${JSON.stringify(t.area)}.`, { prop: "area" });
 		if (t.leafFadeEnd !== 0 && !(t.leafFadeEnd > t.leafFadeStart && t.leafFadeStart >= 0)) throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' needs leafFadeEnd > leafFadeStart >= 0 (the leaf LOD window) or 0/0 to disable, got start ${t.leafFadeStart}, end ${t.leafFadeEnd}.`, { prop: "leafFadeStart" });
 		if (typeof t.leafShadows !== "boolean") throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' leafShadows must be a boolean, got ${JSON.stringify(t.leafShadows)}.`, { prop: "leafShadows" });
-		if (typeof t.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' drape must be a boolean, got ${JSON.stringify(t.drape)}.`, { prop: "drape" });
+		if (t.drape !== null && typeof t.drape !== "boolean") throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' drape must be true, false or null (null = auto: drape whenever the scene has a Terrain3D), got ${JSON.stringify(t.drape)}.`, { prop: "drape" });
 		if (typeof t.terrain !== "string") throw new IncantoError("BAD_FORMAT", `Tree3D '${node.name}' terrain must be a node-path string (empty = auto-find), got ${JSON.stringify(t.terrain)}.`, { prop: "terrain" });
 		if (t.tier === "simple") return;
 		const perTree = maxVariantTriangles(t.tier, t.type);
@@ -8540,7 +8560,7 @@ var Tree3D = class Tree3D extends Node3D {
 	/** Resolve the drape target + cache the grove's world position for `bedY`. */
 	resolveDrape() {
 		this.drapeTerrain = null;
-		if (!this.drape) return;
+		if (this.drape === false) return;
 		const terrain = findDrapeTerrain(this, this.terrain);
 		if (terrain) {
 			this.drapeTerrain = terrain;

package/dist/test.js

@@ -6,7 +6,7 @@ import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { i as getNodeSchema, s as mergeStaticProps } from "./registry-BVJ2HbCn.js";
 import { n as registerGameplayBehaviors } from "./gameplay-sSqrUcnz.js";
 import { t as registerNodes2D } from "./register-Djwckzgx.js";
-import { t as registerNodes3D } from "./register-BFw4c83z.js";
+import { t as registerNodes3D } from "./register-C9-16x_t.js";
 import { t as registerNodesNet } from "./register-BFFE1Mh1.js";
 //#region src/test/index.ts
 /**
@@ -127,7 +127,7 @@ async function runScript(json, opts) {
 		const { enablePhysics2D } = await import("./physics-2d-BiIdl51r.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-DhaAaKJo.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-D_kUdOjr.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const failures = [];
@@ -232,7 +232,7 @@ async function createPlaySession(json, opts = {}) {
 		const { enablePhysics2D } = await import("./physics-2d-BiIdl51r.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-DhaAaKJo.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-D_kUdOjr.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/editor/assets/{agent8-BF8Jfbkl.js → agent8-BDC4LhjC.js}

@@ -1 +1 @@
-import{t as e}from"./index-DSq0gdhE.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};
+import{t as e}from"./index-7qOYg7t8.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};