incanto 0.14.0 → 0.16.0

package/templates-app/village-quest-3d/package.json

@@ -13,7 +13,7 @@
     "@dimforge/rapier2d-compat": "0.19.3",
     "@dimforge/rapier3d-compat": "0.19.3",
     "@pixiv/three-vrm": "^3.5.3",
-    "incanto": "^0.14.0",
+    "incanto": "^0.16.0",
     "three": "^0.184.0"
   },
   "devDependencies": {

package/templates-app/village-quest-3d/src/behaviors.ts

@@ -25,7 +25,7 @@ import type {
 } from 'incanto';
 import { Behavior, findPath, gridFromRows } from 'incanto';
 import { mergeSolidRects, parseCells } from 'incanto/2d';
-import type { CharacterController3D, Node3D, Trail3D } from 'incanto/3d';
+import type { Camera3D, CharacterController3D, Node3D, Trail3D } from 'incanto/3d';
 import { MeshInstance3D, Particles3D, StaticBody3D } from 'incanto/3d';
 import { goToScene } from 'incanto/gameplay';
 import groveJsonRaw from './grove.scene.json';
@@ -79,8 +79,53 @@ function windFor(state: string): { pitch: number; volume: number } {
   }
 }
 
-/** Wind ambience + sprint dash trail — shared per-frame polish. */
-function ambientUpdate(engine: Engine | null | undefined, root: Node, wind: Voice | null): void {
+/** Sprint feel — see sprintFeel(): FOV kick + per-stride dust. */
+const FOV_BASE = 60;
+const FOV_SPRINT = 66.5;
+const STRIDE_SECONDS = 0.22;
+
+/**
+ * One kicked-up dirt puff, world-anchored at the foot spot (one-shot,
+ * self-removing). Non-additive expanding dust — it reads as path dirt
+ * leaving the ground, then thins out.
+ */
+function spawnFootDust(root: Node, at: [number, number, number], scale = 1): void {
+  const puff = new Particles3D('FootDust');
+  puff.position = [at[0], at[1], at[2]];
+  puff.rate = 0;
+  puff.burst = Math.round(4 * scale);
+  puff.blend = 'normal';
+  puff.lifetime = [0.3, 0.5];
+  puff.speed = [8, 34];
+  puff.directionDeg = -90; // up out of the ground…
+  puff.spreadDeg = 75;
+  puff.gravity = [0, 30]; // …then settle back down
+  puff.drag = 2.5;
+  puff.sizeStart = 11 * scale;
+  puff.sizeEnd = 30 * scale; // dust EXPANDS as it dissipates
+  puff.colorStart = '#d3bd97'; // the packed path dirt, sunlit
+  puff.colorEnd = '#a08c6e';
+  puff.alphaStart = 0.24;
+  puff.alphaEnd = 0;
+  puff.maxParticles = 24;
+  puff.on('finished', () => puff.free());
+  root.addChild(puff);
+}
+
+/** Module-scope sprint-feel state (both directors share ambientUpdate). */
+const sprint = { strideClock: 0, wasAirborne: false, fov: FOV_BASE };
+
+/**
+ * Wind ambience + sprint FEEL — speed you can see instead of a ribbon glued
+ * to the hips: a soft camera FOV kick at full sprint, kicked-up dirt at the
+ * feet each stride, and a bigger thump-puff on landing.
+ */
+function ambientUpdate(
+  engine: Engine | null | undefined,
+  root: Node,
+  wind: Voice | null,
+  dt: number,
+): void {
   const controller = root.getNode('Player/Controller') as CharacterController3D | null;
   if (!controller) return;
   const state = controller.state;
@@ -88,8 +133,29 @@ function ambientUpdate(engine: Engine | null | undefined, root: Node, wind: Voic
     const w = windFor(state);
     wind.set({ pitch: w.pitch, volume: w.volume });
   }
-  const dash = root.getNode('Player/DashTrail') as Trail3D | null;
-  if (dash) dash.emitting = state === 'fastRun';
+  const camera = root.getNodeOrNull('Camera') as Camera3D | null;
+  if (camera) {
+    sprint.fov +=
+      (((state === 'fastRun' ? FOV_SPRINT : FOV_BASE) as number) - sprint.fov) *
+      Math.min(1, dt * 6);
+    camera.fov = sprint.fov;
+  }
+  const player = root.getNodeOrNull('Player') as (Node3D & Positioned) | null;
+  if (!player) return;
+  const [px, py, pz] = player.position;
+  const feet: [number, number, number] = [px ?? 0, (py ?? 0) - 0.62, pz ?? 0];
+  const airborne = state === 'airborne';
+  if (sprint.wasAirborne && !airborne) spawnFootDust(root, feet, 1.7); // landing thump
+  sprint.wasAirborne = airborne;
+  if (state === 'fastRun') {
+    sprint.strideClock -= dt;
+    if (sprint.strideClock <= 0) {
+      sprint.strideClock = STRIDE_SECONDS;
+      spawnFootDust(root, feet);
+    }
+  } else {
+    sprint.strideClock = 0;
+  }
 }
 
 // ---- VillageDirector --------------------------------------------------------------
@@ -123,9 +189,9 @@ export class VillageDirector extends Behavior {
     this.wind?.stop();
   }
 
-  override update(): void {
+  override update(dt: number): void {
     const engine = this.node.tree?.engine;
-    ambientUpdate(engine, this.node, this.wind);
+    ambientUpdate(engine, this.node, this.wind, dt);
     // E advances an open dialogue (same key as "talk" — no extra binding)
     if (engine && this.dialogue.active && engine.input.justPressed('interact')) {
       this.dialogue.advance();
@@ -275,7 +341,7 @@ export class GroveDirector extends Behavior {
 
   override update(dt: number): void {
     const engine = this.node.tree?.engine;
-    ambientUpdate(engine, this.node, this.wind);
+    ambientUpdate(engine, this.node, this.wind, dt);
     this.faceWolvesForward();
     this.huntOrPatrol(dt);
     this.syncHpBar();

package/templates-app/village-quest-3d/src/grove.scene.json

@@ -705,18 +705,6 @@
               }
             ]
           },
-          {
-            "name": "DashTrail",
-            "type": "Trail3D",
-            "props": {
-              "width": 0.5,
-              "color": "#ffffff",
-              "opacity": 0.3,
-              "seconds": 0.45,
-              "emitting": false,
-              "position": [0, -0.4, 0]
-            }
-          },
           {
             "name": "SwingSfx",
             "type": "AudioPlayer",
@@ -798,7 +786,7 @@
             "type": "UiText",
             "uid": "n_gq_hint",
             "props": {
-              "text": "click/F strike \u00b7 Shift sprint \u00b7 portal returns home",
+              "text": "click/F strike · Shift sprint · portal returns home",
               "size": 12,
               "color": "#cccccc",
               "anchor": "bottomRight",