incanto 0.9.0 → 0.11.0

package/dist/2d.js

@@ -1,5 +1,5 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-C7Zsqbko.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-CdWhP6ve.js";
 import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-BD6zgrv_.js";
 import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-DweTURFt.js";
 //#region src/2d/library-sprite.ts

package/dist/3d.d.ts

@@ -311,6 +311,20 @@ declare class Physics3D {
     normal: [number, number, number];
     node: PhysicsBody3D | null;
   } | null;
+  /**
+  * Sweep a sphere of `radius` from `origin` along `dir` — a THICK ray. The
+  * spring-arm camera probe uses this instead of `castRay`: a thin ray that
+  * skims 10 cm over a wall reports "clear" while the camera's near plane
+  * still clips the wall; the ball's radius covers that band. Same filters
+  * as `castRay` (sensors never hit; `staticOnly` ignores dynamic/kinematic).
+  * Returns the travel distance of the sphere CENTER, or null when clear.
+  */
+  castSphere(origin: [number, number, number], dir: [number, number, number], radius: number, maxLen: number, exclude?: PhysicsBody3D, opts?: {
+    staticOnly?: boolean;
+  }): {
+    distance: number;
+    node: PhysicsBody3D | null;
+  } | null;
 }
 //#endregion
 //#region src/3d/create-game.d.ts
@@ -637,6 +651,35 @@ declare class Billboard3D extends Node3D {
   _onRender3D(ctx: RenderContext3D): void;
 }
 //#endregion
+//#region src/3d/nodes/bone-attachment-3d.d.ts
+/**
+* Rides a skeleton bone of an animated model — swords in hands, hats on
+* heads, particles on wingtips. Children inherit the bone's live animated
+* transform; the node's own position/rotation/scale become a BONE-SPACE
+* offset on top.
+*
+*   { "name": "SwordMount", "type": "BoneAttachment3D",
+*     "props": { "target": "../Skin", "bone": "RightHand" },
+*     "children": [ ...blade mesh, trail... ] }
+*
+* `bone` lookup is forgiving: "RightHand" also matches the Mixamo spellings
+* (mixamorigRightHand / mixamorig:RightHand). Purely visual: it follows the
+* RENDERED skeleton, so headless (no renderer) the node stays where its
+* props put it — keep gameplay checks range-based, not bone-based.
+*/
+declare class BoneAttachment3D extends Node3D {
+  static override readonly typeName: string;
+  static override readonly props: PropSchema;
+  target: string;
+  bone: string;
+  private boneObj;
+  private lookedUpFor;
+  /** Test hook: the resolved bone (null until found on a rendered frame). */
+  get attachedBone(): Object3D | null;
+  _onRender3D(_ctx: RenderContext3D): void;
+  override free(): void;
+}
+//#endregion
 //#region src/3d/nodes/camera-3d.d.ts
 /**
 * A perspective camera. Mark exactly one camera `current: true`; with none
@@ -1278,6 +1321,15 @@ declare class ModelInstance3D extends Node3D {
   */
   poseNode(name: string, rotation: [number, number, number]): void;
   protected override _createObject3D(): Object3D;
+  /**
+  * Find a skeleton bone (or any named object) inside the mounted model —
+  * the hook BoneAttachment3D rides. Forgiving lookup: exact name, then the
+  * Mixamo spellings (`mixamorigRightHand` / `mixamorig:RightHand`), then a
+  * case-insensitive suffix match. Null until the model is mounted.
+  */
+  findBone(name: string): Object3D | null;
+  /** Names of all bones in the mounted model (debug / editor pickers). */
+  boneNames(): string[];
   /** Embedded clip names + the scene's animation `$key`s (editor dropdown). */
   availableAnimations(): string[];
   /** Called by the 3D sync pass with the renderer's asset store. */
@@ -2155,4 +2207,4 @@ interface WalkState {
   ignoreStatic: boolean;
 }
 //#endregion
-export { Area3D, AssetStore3D, Billboard3D, type BillboardGroupMode, Camera3D, CharacterBody3D, CharacterController3D, type CreateGame3DOptions, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, type Environment3DConfig, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, type FlowerVariety, Flowers3D, type FogEnvironment, Foliage3D, type FoliageKind, type FoliageStyle, type Game3D, type Heightmap, type HeightmapOptions, Joint3D, type JointType3D, LoftMesh3D, type LoftSection, MeshInstance3D, type MeshKind, type MeshMaterialProps, type ModelEntry, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, type Physics3DOptions, PhysicsBody3D, QUARTER_PITCH, type RenderContext3D, type RenderHook3D, Renderer3D, type Renderer3DOptions, type RigView, RigidBody3D, type Ripple, type ShadowsEnvironment, type SkyEnvironment, StaticBody3D, type SunConsumer3D, type SyncOptions, type SyncResult, TERRAIN_THEMES, Terrain3D, type TerrainLayer, type TerrainTheme, Trail3D, Tree3D, type TreeTier, type TreeType, VOXEL_PALETTE, type VoxelBlock, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, cameraRelative, createGame3D, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };
+export { Area3D, AssetStore3D, Billboard3D, type BillboardGroupMode, BoneAttachment3D, Camera3D, CharacterBody3D, CharacterController3D, type CreateGame3DOptions, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, type Environment3DConfig, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, type FlowerVariety, Flowers3D, type FogEnvironment, Foliage3D, type FoliageKind, type FoliageStyle, type Game3D, type Heightmap, type HeightmapOptions, Joint3D, type JointType3D, LoftMesh3D, type LoftSection, MeshInstance3D, type MeshKind, type MeshMaterialProps, type ModelEntry, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, type Physics3DOptions, PhysicsBody3D, QUARTER_PITCH, type RenderContext3D, type RenderHook3D, Renderer3D, type Renderer3DOptions, type RigView, RigidBody3D, type Ripple, type ShadowsEnvironment, type SkyEnvironment, StaticBody3D, type SunConsumer3D, type SyncOptions, type SyncResult, TERRAIN_THEMES, Terrain3D, type TerrainLayer, type TerrainTheme, Trail3D, Tree3D, type TreeTier, type TreeType, VOXEL_PALETTE, type VoxelBlock, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, cameraRelative, createGame3D, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };

package/dist/3d.js

@@ -1,5 +1,5 @@
-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-Bydey3CZ.js";
-import { A as RigidBody3D, C as DEFAULT_TERRAIN_TEXTURE_BASE, D as Area3D, E as Joint3D, F as cameraRelative, I as keyboardIntensity, L as movementState, M as Node3D, O as CharacterBody3D, P as QUARTER_PITCH, R as rigPose, S as Terrain3D, T as terrainThemeLayers, _ as resolveFlowerDensity, a as VoxelGrid3D, b as Camera3D, c as Particles3D, d as MeshInstance3D, f as DirectionalLight3D, g as Flowers3D, h as DENSITY_PRESETS, i as VOXEL_PALETTE, j as StaticBody3D, k as PhysicsBody3D, l as ModelInstance3D, m as Foliage3D, n as Water3D, o as Tree3D, p as OmniLight3D, r as WATER_MAX_RIPPLES, s as Trail3D, t as registerNodes3D, u as LoftMesh3D, v as FLOWER_VARIETIES, w as TERRAIN_THEMES, x as Billboard3D, y as CharacterController3D } from "./register-iUPtts7T.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-DZ_4Nfq8.js";
+import { A as PhysicsBody3D, C as Terrain3D, D as Joint3D, E as terrainThemeLayers, F as QUARTER_PITCH, I as cameraRelative, L as keyboardIntensity, M as StaticBody3D, N as Node3D, O as Area3D, R as movementState, S as Billboard3D, T as TERRAIN_THEMES, _ as resolveFlowerDensity, a as VoxelGrid3D, b as Camera3D, c as Particles3D, d as MeshInstance3D, f as DirectionalLight3D, g as Flowers3D, h as DENSITY_PRESETS, i as VOXEL_PALETTE, j as RigidBody3D, k as CharacterBody3D, l as ModelInstance3D, m as Foliage3D, n as Water3D, o as Tree3D, p as OmniLight3D, r as WATER_MAX_RIPPLES, s as Trail3D, t as registerNodes3D, u as LoftMesh3D, v as FLOWER_VARIETIES, w as DEFAULT_TERRAIN_TEXTURE_BASE, x as BoneAttachment3D, y as CharacterController3D, z as rigPose } from "./register-ysLR3WQS.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CroQPEER.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-Clv1uFzk.js";
-export { Area3D, AssetStore3D, Billboard3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, StaticBody3D, TERRAIN_THEMES, Terrain3D, Trail3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, cameraRelative, createGame3D, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-Br97Ans2.js";
+export { Area3D, AssetStore3D, Billboard3D, BoneAttachment3D, Camera3D, CharacterBody3D, CharacterController3D, DEFAULT_TERRAIN_TEXTURE_BASE, DirectionalLight3D, Environment3D, DENSITY_PRESETS as FLOWER_DENSITY_PRESETS, FLOWER_VARIETIES, Flowers3D, Foliage3D, Joint3D, LoftMesh3D, MeshInstance3D, ModelInstance3D, Node3D, OmniLight3D, Particles3D, Physics3D, PhysicsBody3D, QUARTER_PITCH, Renderer3D, RigidBody3D, StaticBody3D, TERRAIN_THEMES, Terrain3D, Trail3D, Tree3D, VOXEL_PALETTE, VoxelGrid3D, WATER_MAX_RIPPLES, Water3D, buildHeightmap, cameraRelative, createGame3D, enablePhysics3D, horizonColorFromSky, keyboardIntensity, movementState, parseEnvironment3D, registerNodes3D, resolveFlowerDensity, rigPose, splatWeights, sunDirectionFromElevationAzimuth, sunDirectionFromSky, syncTree, terrainThemeLayers };

package/dist/{create-game-C7Zsqbko.js → create-game-CdWhP6ve.js}

@@ -3,7 +3,7 @@ import { _ as registerBehavior, n as loadScene, o as computeViewport, s as resol
 import { l as AudioPlayer, u as Engine } from "./register-DJZXxwAn.js";
 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-DPMgZk9W.js";
+import { n as registerGameplayBehaviors } from "./gameplay-Dn3yidJw.js";
 import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-BD6zgrv_.js";
 import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
 import { n as enablePhysics2D } from "./physics-2d-DweTURFt.js";

package/dist/{create-game-Bydey3CZ.js → create-game-DZ_4Nfq8.js}

@@ -3,10 +3,10 @@ import { _ as registerBehavior, n as loadScene } from "./loader-B4OEXDZ8.js";
 import { l as AudioPlayer, u as Engine } from "./register-DJZXxwAn.js";
 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-DPMgZk9W.js";
+import { n as registerGameplayBehaviors } from "./gameplay-Dn3yidJw.js";
 import { t as debugSources } from "./debug-draw-CZmOYjL2.js";
-import { M as Node3D, b as Camera3D, f as DirectionalLight3D, k as PhysicsBody3D, l as ModelInstance3D, t as registerNodes3D } from "./register-iUPtts7T.js";
-import { n as enablePhysics3D } from "./physics-3d-Clv1uFzk.js";
+import { A as PhysicsBody3D, N as Node3D, b as Camera3D, f as DirectionalLight3D, l as ModelInstance3D, t as registerNodes3D } from "./register-ysLR3WQS.js";
+import { n as enablePhysics3D } from "./physics-3d-Br97Ans2.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/{gameplay-DPMgZk9W.js → gameplay-Dn3yidJw.js}

@@ -321,6 +321,9 @@ function onTriggerEnter(behavior, fn) {
 *   and each enemy's contact hitbox `targetGroup:'player'`.
 * - `oncePerTarget` (default) prevents re-hitting the same node (a stationary
 *   hazard would otherwise drain a resting body every frame).
+* - `repeatEvery` (seconds, 0 = off) re-damages targets that STAY overlapped —
+*   lava pools, poison clouds, an enemy standing on you. Contact events fire
+*   only on entry/exit; this is the "and it keeps hurting" knob.
 * - `destroySelf` frees the hazard after a hit (single-use projectiles).
 *
 * SCORING PATTERN (clone-safe): wire the KILLER's `dealtDamage` →
@@ -336,6 +339,8 @@ var DamageOnContact = class extends Behavior {
 		targetGroup: { default: "" },
 		/** Damage each distinct target at most once. */
 		oncePerTarget: { default: true },
+		/** Re-damage targets still overlapping every N seconds (0 = entry only). */
+		repeatEvery: { default: 0 },
 		/** queueFree() this node after the first successful hit. */
 		destroySelf: { default: false }
 	};
@@ -343,13 +348,37 @@ var DamageOnContact = class extends Behavior {
 	amount = 10;
 	targetGroup = "";
 	oncePerTarget = true;
+	repeatEvery = 0;
 	destroySelf = false;
 	hit = /* @__PURE__ */ new WeakSet();
+	/** Targets currently overlapping → seconds until their next repeat tick. */
+	inside = /* @__PURE__ */ new Map();
 	onReady() {
-		onTriggerEnter(this, (other) => this.tryDamage(other));
+		onTriggerEnter(this, (other) => {
+			this.inside.set(other, this.repeatEvery);
+			this.tryDamage(other);
+		});
+		this.node.on("triggerExit", (other) => {
+			this.inside.delete(other);
+		});
+	}
+	update(dt) {
+		if (this.repeatEvery <= 0 || this.inside.size === 0) return;
+		for (const [target, left] of this.inside) {
+			if (!target.tree) {
+				this.inside.delete(target);
+				continue;
+			}
+			const next = left - dt;
+			if (next > 0) this.inside.set(target, next);
+			else {
+				this.inside.set(target, this.repeatEvery);
+				this.tryDamage(target, { repeat: true });
+			}
+		}
 	}
-	tryDamage(other) {
-		if (this.oncePerTarget && this.hit.has(other)) return;
+	tryDamage(other, opts) {
+		if (!opts?.repeat && this.oncePerTarget && this.hit.has(other)) return;
 		const found = findHealth(other);
 		if (!found) return;
 		if (this.targetGroup !== "" && !found.owner.isInGroup(this.targetGroup)) return;

package/dist/gameplay.d.ts

@@ -113,6 +113,9 @@ declare class Health extends Behavior {
 *   and each enemy's contact hitbox `targetGroup:'player'`.
 * - `oncePerTarget` (default) prevents re-hitting the same node (a stationary
 *   hazard would otherwise drain a resting body every frame).
+* - `repeatEvery` (seconds, 0 = off) re-damages targets that STAY overlapped —
+*   lava pools, poison clouds, an enemy standing on you. Contact events fire
+*   only on entry/exit; this is the "and it keeps hurting" knob.
 * - `destroySelf` frees the hazard after a hit (single-use projectiles).
 *
 * SCORING PATTERN (clone-safe): wire the KILLER's `dealtDamage` →
@@ -126,9 +129,13 @@ declare class DamageOnContact extends Behavior {
   amount: number;
   targetGroup: string;
   oncePerTarget: boolean;
+  repeatEvery: number;
   destroySelf: boolean;
   private readonly hit;
+  /** Targets currently overlapping → seconds until their next repeat tick. */
+  private readonly inside;
   override onReady(): void;
+  override update(dt: number): void;
   private tryDamage;
 }
 //#endregion

package/dist/gameplay.js

@@ -1,2 +1,2 @@
-import { C as FollowCamera, D as Chase, E as Collector, S as restartScene, T as Health, _ as hitStop, a as Wander, b as GameFlow, c as Projectile, d as PathFollow, f as Oscillate, g as Cooldown, h as CameraShake, i as WaveSpawner, l as Pickup, m as Lifetime, n as registerGameplayBehaviors, o as Spawner, p as MoveTo, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Patrol, v as screenFlash, w as DamageOnContact, x as goToScene, y as Interactable } from "./gameplay-DPMgZk9W.js";
+import { C as FollowCamera, D as Chase, E as Collector, S as restartScene, T as Health, _ as hitStop, a as Wander, b as GameFlow, c as Projectile, d as PathFollow, f as Oscillate, g as Cooldown, h as CameraShake, i as WaveSpawner, l as Pickup, m as Lifetime, n as registerGameplayBehaviors, o as Spawner, p as MoveTo, r as ZombieAI, s as ScoreKeeper, t as GAMEPLAY_BEHAVIORS, u as Patrol, v as screenFlash, w as DamageOnContact, x as goToScene, y as Interactable } from "./gameplay-Dn3yidJw.js";
 export { CameraShake, Chase, Collector, Cooldown, DamageOnContact, FollowCamera, GAMEPLAY_BEHAVIORS, GameFlow, Health, Interactable, Lifetime, MoveTo, Oscillate, PathFollow, Patrol, Pickup, Projectile, ScoreKeeper, Spawner, Wander, WaveSpawner, ZombieAI, goToScene, hitStop, registerGameplayBehaviors, restartScene, screenFlash };

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.9.0";
+const VERSION = "0.11.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-Clv1uFzk.js → physics-3d-Br97Ans2.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 RigidBody3D, D as Area3D, E as Joint3D, M as Node3D, N as validateCollider3D, O as CharacterBody3D, S as Terrain3D, k as PhysicsBody3D } from "./register-iUPtts7T.js";
+import { A as PhysicsBody3D, C as Terrain3D, D as Joint3D, N as Node3D, O as Area3D, P as validateCollider3D, j as RigidBody3D, k as CharacterBody3D } from "./register-ysLR3WQS.js";
 import { Euler, Quaternion } from "three";
 //#region src/3d/physics/physics-3d.ts
 var physics_3d_exports = /* @__PURE__ */ __exportAll({
@@ -399,6 +399,38 @@ var Physics3D = class {
 			node: this.byColliderHandle.get(hit.collider.handle) ?? null
 		};
 	}
+	/**
+	* Sweep a sphere of `radius` from `origin` along `dir` — a THICK ray. The
+	* spring-arm camera probe uses this instead of `castRay`: a thin ray that
+	* skims 10 cm over a wall reports "clear" while the camera's near plane
+	* still clips the wall; the ball's radius covers that band. Same filters
+	* as `castRay` (sensors never hit; `staticOnly` ignores dynamic/kinematic).
+	* Returns the travel distance of the sphere CENTER, or null when clear.
+	*/
+	castSphere(origin, dir, radius, maxLen, exclude, opts) {
+		const R = this.R;
+		const excludeEntry = exclude ? this.entries.get(exclude) : void 0;
+		const flags = opts?.staticOnly ? R.QueryFilterFlags.EXCLUDE_DYNAMIC | R.QueryFilterFlags.EXCLUDE_KINEMATIC : void 0;
+		const hit = this.world.castShape({
+			x: origin[0],
+			y: origin[1],
+			z: origin[2]
+		}, {
+			x: 0,
+			y: 0,
+			z: 0,
+			w: 1
+		}, {
+			x: dir[0],
+			y: dir[1],
+			z: dir[2]
+		}, new R.Ball(radius), 0, maxLen, true, flags, void 0, excludeEntry?.collider, excludeEntry?.body, (collider) => !collider.isSensor());
+		if (!hit) return null;
+		return {
+			distance: hit.time_of_impact,
+			node: this.byColliderHandle.get(hit.collider.handle) ?? null
+		};
+	}
 };
 const quatScratch = new Quaternion();
 const eulerScratch = new Euler();

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-Bydey3CZ.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-C7Zsqbko.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-DZ_4Nfq8.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-CdWhP6ve.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-iUPtts7T.js → register-ysLR3WQS.js}

@@ -1901,6 +1901,73 @@ var Billboard3D = class extends Node3D {
 	}
 };
 //#endregion
+//#region src/3d/nodes/bone-attachment-3d.ts
+/**
+* Rides a skeleton bone of an animated model — swords in hands, hats on
+* heads, particles on wingtips. Children inherit the bone's live animated
+* transform; the node's own position/rotation/scale become a BONE-SPACE
+* offset on top.
+*
+*   { "name": "SwordMount", "type": "BoneAttachment3D",
+*     "props": { "target": "../Skin", "bone": "RightHand" },
+*     "children": [ ...blade mesh, trail... ] }
+*
+* `bone` lookup is forgiving: "RightHand" also matches the Mixamo spellings
+* (mixamorigRightHand / mixamorig:RightHand). Purely visual: it follows the
+* RENDERED skeleton, so headless (no renderer) the node stays where its
+* props put it — keep gameplay checks range-based, not bone-based.
+*/
+var BoneAttachment3D = class extends Node3D {
+	static typeName = "BoneAttachment3D";
+	static props = {
+		/** Node path to the ModelInstance3D whose skeleton to ride. */
+		target: { default: "" },
+		/** Bone name ("RightHand", "Head", …). Empty = inert. */
+		bone: { default: "" }
+	};
+	target = "";
+	bone = "";
+	boneObj = null;
+	lookedUpFor = "";
+	/** Test hook: the resolved bone (null until found on a rendered frame). */
+	get attachedBone() {
+		return this.boneObj;
+	}
+	_onRender3D(_ctx) {
+		if (this.target === "" || this.bone === "") return;
+		const key = `${this.target} ${this.bone}`;
+		if (this.lookedUpFor !== key || this.boneObj === null || !this.boneObj.parent) {
+			this.lookedUpFor = key;
+			this.boneObj = null;
+			const source = this.getNodeOrNull(this.target);
+			if (source && typeof source.findBone === "function") this.boneObj = source.findBone(this.bone);
+		}
+		const boneObj = this.boneObj;
+		if (!boneObj) return;
+		const obj = this._ensureObject3D();
+		const parent = obj.parent;
+		if (!parent) return;
+		boneObj.updateWorldMatrix(true, false);
+		parent.updateWorldMatrix(true, false);
+		obj.matrixAutoUpdate = false;
+		boneObj.matrixWorld.decompose(bonePosScratch, boneQuatScratch, boneScaleScratch);
+		boneScratch.compose(bonePosScratch, boneQuatScratch, unitScale);
+		obj.updateMatrix();
+		offsetScratch.copy(obj.matrix);
+		obj.matrix.copy(parent.matrixWorld).invert().multiply(boneScratch).multiply(offsetScratch);
+	}
+	free() {
+		this.boneObj = null;
+		super.free();
+	}
+};
+const offsetScratch = new Matrix4();
+const boneScratch = new Matrix4();
+const bonePosScratch = new Vector3();
+const boneQuatScratch = new Quaternion();
+const boneScaleScratch = new Vector3();
+const unitScale = new Vector3(1, 1, 1);
+//#endregion
 //#region src/3d/nodes/camera-3d.ts
 /**
 * A perspective camera. Mark exactly one camera `current: true`; with none
@@ -1950,6 +2017,10 @@ const CAM_COLLISION_MARGIN = .3;
 const CAM_COLLISION_MIN_DIST = .4;
 /** Ground backstop: keep the camera at least this high above whatever is below it. */
 const CAM_GROUND_CLEARANCE = .3;
+/** Spring-arm probe thickness: a THIN ray that skims 10 cm above a wall reports
+*  "clear" while the wall still fills the frame — the sphere's radius covers the
+*  near-plane band around the boom (the Emberwood hedge-maze lesson). */
+const CAM_PROBE_RADIUS = .25;
 const eulerScratch = new Euler();
 const quatScratch = new Quaternion();
 const matrixScratch$3 = new Matrix4();
@@ -2218,7 +2289,7 @@ var CharacterController3D = class extends Node3D {
 		if (this.cameraCollision && this.view !== "firstPerson") {
 			const physics = body._physics3d;
 			if (physics) {
-				target = springArmCamera(eye, target, (o, dr, len) => physics.castRay(o, dr, len, body, { staticOnly: true })?.distance ?? null, CAM_COLLISION_MARGIN, CAM_COLLISION_MIN_DIST);
+				target = springArmCamera(eye, target, (o, dr, len) => physics.castSphere(o, dr, CAM_PROBE_RADIUS, len, body, { staticOnly: true })?.distance ?? null, CAM_COLLISION_MARGIN, CAM_COLLISION_MIN_DIST);
 				target = clampCameraAboveGround(target, (o, len) => physics.castRay(o, [
 					0,
 					-1,
@@ -5622,6 +5693,32 @@ var ModelInstance3D = class extends Node3D {
 	_createObject3D() {
 		return new Group();
 	}
+	/**
+	* Find a skeleton bone (or any named object) inside the mounted model —
+	* the hook BoneAttachment3D rides. Forgiving lookup: exact name, then the
+	* Mixamo spellings (`mixamorigRightHand` / `mixamorig:RightHand`), then a
+	* case-insensitive suffix match. Null until the model is mounted.
+	*/
+	findBone(name) {
+		const root = this.fitGroup;
+		if (!root || name === "") return null;
+		const exact = root.getObjectByName(name) ?? root.getObjectByName(`mixamorig${name}`) ?? root.getObjectByName(`mixamorig:${name}`);
+		if (exact) return exact;
+		const lower = name.toLowerCase();
+		let found = null;
+		root.traverse((obj) => {
+			if (!found && obj.name.toLowerCase().endsWith(lower)) found = obj;
+		});
+		return found;
+	}
+	/** Names of all bones in the mounted model (debug / editor pickers). */
+	boneNames() {
+		const out = [];
+		this.fitGroup?.traverse((obj) => {
+			if (obj.isBone) out.push(obj.name);
+		});
+		return out;
+	}
 	/** Embedded clip names + the scene's animation `$key`s (editor dropdown). */
 	availableAnimations() {
 		const embedded = this.entry?.animations.map((c) => c.name) ?? [];
@@ -11618,6 +11715,7 @@ function registerNodes3D() {
 	registerNode(VoxelGrid3D);
 	registerNode(Joint3D);
 	registerNode(Trail3D);
+	registerNode(BoneAttachment3D);
 	registerNode(Terrain3D);
 	registerNode(Water3D);
 	registerNode(Foliage3D);
@@ -11633,4 +11731,4 @@ function registerNodes3D() {
 	registerNode(CharacterBody3D);
 }
 //#endregion
-export { RigidBody3D as A, DEFAULT_TERRAIN_TEXTURE_BASE as C, Area3D as D, Joint3D as E, cameraRelative as F, keyboardIntensity as I, movementState as L, Node3D as M, validateCollider3D as N, CharacterBody3D as O, QUARTER_PITCH as P, rigPose as R, Terrain3D as S, terrainThemeLayers as T, resolveFlowerDensity as _, VoxelGrid3D as a, Camera3D as b, Particles3D as c, MeshInstance3D as d, DirectionalLight3D as f, Flowers3D as g, DENSITY_PRESETS as h, VOXEL_PALETTE as i, StaticBody3D as j, PhysicsBody3D as k, ModelInstance3D as l, Foliage3D as m, Water3D as n, Tree3D as o, OmniLight3D as p, WATER_MAX_RIPPLES as r, Trail3D as s, registerNodes3D as t, LoftMesh3D as u, FLOWER_VARIETIES as v, TERRAIN_THEMES as w, Billboard3D as x, CharacterController3D as y };
+export { PhysicsBody3D as A, Terrain3D as C, Joint3D as D, terrainThemeLayers as E, QUARTER_PITCH as F, cameraRelative as I, keyboardIntensity as L, StaticBody3D as M, Node3D as N, Area3D as O, validateCollider3D as P, movementState as R, Billboard3D as S, TERRAIN_THEMES as T, resolveFlowerDensity as _, VoxelGrid3D as a, Camera3D as b, Particles3D as c, MeshInstance3D as d, DirectionalLight3D as f, Flowers3D as g, DENSITY_PRESETS as h, VOXEL_PALETTE as i, RigidBody3D as j, CharacterBody3D as k, ModelInstance3D as l, Foliage3D as m, Water3D as n, Tree3D as o, OmniLight3D as p, WATER_MAX_RIPPLES as r, Trail3D as s, registerNodes3D as t, LoftMesh3D as u, FLOWER_VARIETIES as v, DEFAULT_TERRAIN_TEXTURE_BASE as w, BoneAttachment3D as x, CharacterController3D as y, rigPose as z };

package/dist/test.js

@@ -4,9 +4,9 @@ import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as auditScene } from "./audit-C6rMyict.js";
 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-DPMgZk9W.js";
+import { n as registerGameplayBehaviors } from "./gameplay-Dn3yidJw.js";
 import { t as registerNodes2D } from "./register-BD6zgrv_.js";
-import { t as registerNodes3D } from "./register-iUPtts7T.js";
+import { t as registerNodes3D } from "./register-ysLR3WQS.js";
 import { t as registerNodesNet } from "./register-Cwc-yCYx.js";
 //#region src/test/index.ts
 /**
@@ -127,7 +127,7 @@ async function runScript(json, opts) {
 		const { enablePhysics2D } = await import("./physics-2d-DweTURFt.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-Clv1uFzk.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-Br97Ans2.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-DweTURFt.js").then((n) => n.r);
 		await enablePhysics2D(engine);
 	} else if (physics === "3d" || physics === "auto" && scene.dimension === "3d") {
-		const { enablePhysics3D } = await import("./physics-3d-Clv1uFzk.js").then((n) => n.r);
+		const { enablePhysics3D } = await import("./physics-3d-Br97Ans2.js").then((n) => n.r);
 		await enablePhysics3D(engine);
 	}
 	const stepMs = 1e3 / (opts.fixedHz ?? 60);

package/editor/assets/{agent8-B0ZGx-N1.js → agent8-BxNvAcLA.js}

@@ -1 +1 @@
-import{t as e}from"./index-BLzp8moy.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-DMCQXowF.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};