incanto 0.27.0 → 0.28.0

package/editor/index.html

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Incanto Scene Editor</title>
     <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'><rect width='16' height='16' rx='3' fill='%236ee7dc'/><text x='8' y='12' text-anchor='middle' font-size='11' font-family='monospace' fill='%230e1018'>i</text></svg>" />
-    <script type="module" crossorigin src="./assets/index-BrneVqN0.js"></script>
+    <script type="module" crossorigin src="./assets/index-D6RQgROR.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/GameServer-C56iOUgF.js">
     <link rel="stylesheet" crossorigin href="./assets/index-D8QvwvOm.css">
   </head>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "incanto",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Vibe-coding-first web game engine SDK — JSON-driven scenes on three.js",
   "keywords": [
     "game-engine",

package/schemas/scene.schema.json

@@ -2379,6 +2379,10 @@
             "drape": {
               "default": null
             },
+            "avoidWater": {
+              "type": "boolean",
+              "default": true
+            },
             "terrain": {
               "type": "string",
               "default": ""
@@ -2566,6 +2570,10 @@
             "drape": {
               "default": null
             },
+            "avoidWater": {
+              "type": "boolean",
+              "default": true
+            },
             "terrain": {
               "type": "string",
               "default": ""

package/skills/incanto-environment.md

@@ -359,6 +359,7 @@ tops radially away with a smooth falloff as a character wades through.
 | `flowers` | `0` | DEPRECATED — confetti heads; use a `Flowers3D` node (load-time check 0–0.2) |
 | `seed` | `1` | placement seed — identical field across runs/machines |
 | `drape` | `null` | **AUTO by default**: whenever the scene has a Terrain3D, every blade roots on the ground under it (samples `heightAt`) — omit this prop and rolling terrain just works. `true` forces it (keeps retrying until a terrain appears — streamed worlds), `false` opts out (flat carpet at the node's Y) |
+| `avoidWater` | `true` | blades keep OUT of the water — any instance whose ground sits under a `Water3D` or `River3D` surface is dropped, so a creek that cuts its bed through a meadow gets banks instead of blades waving in the current. `false` plants reeds and paddy fields |
 | `terrain` | `""` | drape target node path; empty = **auto-find the first Terrain3D** in the tree. A non-empty path that is NOT a Terrain3D fails at load — no silent floating |
 
 > **Rolling terrain just works.** Since 0.14 draping is on by default: with a
@@ -415,6 +416,7 @@ billboard confetti. Deterministic from the `seed` PROP.
 | `clustering` | `0.6` | 0 uniform … 1 tight Voronoi patches (load-time check) |
 | `sway` | `0.5` | head-bob wind strength; 0 disables |
 | `drape` | `null` | AUTO by default — plants root on the scene's Terrain3D when one exists; `true` forces, `false` opts out — see the Foliage3D drape note above |
+| `avoidWater` | `true` | plants keep OUT of the water (see the Foliage3D note) — `false` for lilies and marsh planting |
 | `terrain` | `""` | drape target node path; empty = auto-find the first Terrain3D (a wrong path fails at load) |
 
 ## Tree3D
@@ -991,6 +993,10 @@ underneath decides everything else.
   runs faster), which is what puts rapids where a real river has them;
 - **whitewater**: grade × speed makes rapids, the bank shear line makes edge
   froth, a thinning column riffles over rock. Foam then rides downstream.
+- **a dry bank**: `Foliage3D` and `Flowers3D` refuse to plant where a river
+  runs (`avoidWater`, on by default), so a creek cutting its bed through a
+  meadow gets bare wet ground at the edge instead of blades waving in the
+  current;
 - **what stands in the water**: drop boulders in the channel and the current
   answers them — a cushion of white piled on the upstream face, a torn wake
   opening downstream, and the surface sheen bending around the stone. Nothing
@@ -1048,6 +1054,23 @@ should be.
 const path = traceDownhillPath(terrain.heightAt, { x: peakX, z: peakZ, step: 7 });
 ```
 
+**Placing things against a self-carved bed?** Ask the engine what the cut will
+be — never mirror it by hand. `riverCarveChannels` is the same function the node
+runs at load, so a generator that assigns its result to a scratch Terrain3D gets
+the EXACT ground the game will have; a hand-rolled approximation puts the player
+inside a hill.
+
+```ts
+const carved = new Terrain3D('probe');
+Object.assign(carved, terrainProps);
+carved.channels = riverCarveChannels({
+  path, widths, depth,
+  cell: size / resolution,   // the terrain's own grid
+  groundAt: (x, z) => rawTerrain.heightAt(x, z),
+});
+const groundAt = (x: number, z: number) => carved.heightAt(x, z); // place against THIS
+```
+
 
 ### Waterfalls happen — you do not author them
 

package/skills/incanto-node-reference.md

@@ -331,6 +331,7 @@ Signals: `movementStateChanged(state)`
 | `clustering` | `0.6` | number |
 | `sway` | `0.5` | number |
 | `drape` | `null` | null |
+| `avoidWater` | `true` | boolean |
 | `terrain` | `""` | string |
 
 ## `Foliage3D` — `incanto/3d`
@@ -363,6 +364,7 @@ Signals: `movementStateChanged(state)`
 | `flowers` | `0` | number |
 | `seed` | `1` | number |
 | `drape` | `null` | null |
+| `avoidWater` | `true` | boolean |
 | `terrain` | `""` | string |
 
 ## `HudLayer` — `incanto`

package/templates-app/beacon-isle-3d/package.json

@@ -14,7 +14,7 @@
     "@dimforge/rapier2d-compat": "0.19.3",
     "@dimforge/rapier3d-compat": "0.19.3",
     "@pixiv/three-vrm": "^3.5.3",
-    "incanto": "^0.27.0",
+    "incanto": "^0.28.0",
     "three": "^0.184.0"
   },
   "devDependencies": {

package/templates-app/tps-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.27.0",
+    "incanto": "^0.28.0",
     "three": "^0.184.0"
   },
   "devDependencies": {

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.27.0",
+    "incanto": "^0.28.0",
     "three": "^0.184.0"
   },
   "devDependencies": {