incanto 0.13.0 → 0.14.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-DSq0gdhE.js"></script>
+    <script type="module" crossorigin src="./assets/index-7qOYg7t8.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.13.0",
+  "version": "0.14.0",
   "description": "Vibe-coding-first web game engine SDK — JSON-driven scenes on three.js",
   "keywords": [
     "game-engine",

package/schemas/scene.schema.json

@@ -2371,8 +2371,7 @@
               "default": 0.5
             },
             "drape": {
-              "type": "boolean",
-              "default": false
+              "default": null
             },
             "terrain": {
               "type": "string",
@@ -2559,8 +2558,7 @@
               "default": 1
             },
             "drape": {
-              "type": "boolean",
-              "default": false
+              "default": null
             },
             "terrain": {
               "type": "string",
@@ -5656,8 +5654,7 @@
               "default": true
             },
             "drape": {
-              "type": "boolean",
-              "default": false
+              "default": null
             },
             "terrain": {
               "type": "string",

package/skills/incanto-environment.md

@@ -358,14 +358,13 @@ tops radially away with a smooth falloff as a character wades through.
 | `coverage` | `0.85` | mesh: carpet fill in (0, 1] — below 1 noise carves dirt patches (load-time check) |
 | `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` | `false` | **drape each blade onto a Terrain3D's surface** so a field follows rolling ground instead of floating on a flat plane — one big field covers a whole terrain |
-| `terrain` | `""` | drape target node path; empty = **auto-find the first Terrain3D** in the tree (the zero-config default when `drape` is on) |
+| `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) |
+| `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?** Set `drape: true` and the field's blades root on the
-> ground per-instance (it samples the Terrain3D's `heightAt`). Without draping a
-> Foliage3D/Flowers3D is a FLAT carpet at the node's Y, so on hills it
-> floats/sinks — either drape it, or place small patches at flat spots (the
-> generators still do the latter for backward-compatible output).
+> **Rolling terrain just works.** Since 0.14 draping is on by default: with a
+> Terrain3D in the scene the blades root on the ground per-instance, no wiring.
+> Only set `drape: false` if you WANT a flat carpet at the node's Y (e.g. grass
+> on a flat MeshInstance3D platform above the terrain).
 
 ## Flowers3D
 
@@ -415,8 +414,8 @@ billboard confetti. Deterministic from the `seed` PROP.
 | `height` | `0.45` | plant height, meters (±25% per-plant jitter) |
 | `clustering` | `0.6` | 0 uniform … 1 tight Voronoi patches (load-time check) |
 | `sway` | `0.5` | head-bob wind strength; 0 disables |
-| `drape` | `false` | drape each plant onto a Terrain3D's surface (rolling terrain) — see the Foliage3D drape note above |
-| `terrain` | `""` | drape target node path; empty = auto-find the first Terrain3D |
+| `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 |
+| `terrain` | `""` | drape target node path; empty = auto-find the first Terrain3D (a wrong path fails at load) |
 
 ## Tree3D
 Procedural trees grown by the ported ez-tree generator (MIT, Dan Greenheck;
@@ -484,8 +483,8 @@ Every instance in a grove also gets a deterministic per-instance color jitter (
 | `leafFadeStart` | `0` | **leaf LOD** — leaf cards begin collapsing toward their branch at this camera distance (m). `0`/`0` disables (full leaves at any range) |
 | `leafFadeEnd` | `0` | leaf LOD — cards fully collapsed (zero overdraw) by here; tune ≈ the scene `fog.far` so the thinning hides in fog (load-time check: `> leafFadeStart`) |
 | `leafShadows` | `true` | `false` keeps trunk/branch shadows but drops the expensive alpha-cutout LEAF shadow pass — big FPS in dense forests |
-| `drape` | `false` | **drape a scattered grove onto a Terrain3D**: each instance roots at the ground height under it instead of the node's single Y, so a `count > 1` patch on rolling/carved terrain never floats or buries |
-| `terrain` | `""` | drape target node path; empty = auto-find the first Terrain3D (the zero-config default when `drape` is on) |
+| `drape` | `null` | AUTO by default: each scattered instance roots at the ground height under it (instead of the node's single Y) whenever the scene has a Terrain3D — a `count > 1` grove on rolling/carved terrain never floats or buries. `true` forces, `false` opts out |
+| `terrain` | `""` | drape target node path; empty = auto-find the first Terrain3D (a wrong path fails at load) |
 
 > **Tree LOD / forest FPS.** Leaf overdraw + the leaf shadow pass dominate a
 > dense-forest frame (~90% in profiling). For big groves set `leafFadeStart`/
@@ -493,11 +492,11 @@ Every instance in a grove also gets a deterministic per-instance color jitter (
 > leaf cards (branch silhouette stays), and `leafShadows: false` to drop the leaf
 > shadow pass. Both default off → existing scenes are unchanged.
 
-> **Floating trees?** A scattered grove (`count > 1`) places every instance at
-> the node's single Y, so on rolling or basin-carved terrain the far instances
-> float or sink. Set `drape: true` (auto-finds the Terrain3D) so each instance
-> roots on the ground under it. The drape is a pure heightAt lookup — no rng
-> draw, so the seed/grove layout is byte-identical, only the Y shifts.
+> **Floating trees?** Since 0.14 groves drape automatically whenever the scene
+> has a Terrain3D — each instance roots on the ground under it. The drape is a
+> pure heightAt lookup — no rng draw, so the seed/grove layout is
+> byte-identical, only the Y shifts. `drape: false` restores the flat
+> single-Y placement.
 
 ## Terrain3D
 Procedural heightfield terrain with biome texture splatting (in `incanto/3d`,

package/skills/incanto-node-reference.md

@@ -330,7 +330,7 @@ Signals: `movementStateChanged(state)`
 | `height` | `0.45` | number |
 | `clustering` | `0.6` | number |
 | `sway` | `0.5` | number |
-| `drape` | `false` | boolean |
+| `drape` | `null` | null |
 | `terrain` | `""` | string |
 
 ## `Foliage3D` — `incanto/3d`
@@ -362,7 +362,7 @@ Signals: `movementStateChanged(state)`
 | `coverage` | `0.85` | number |
 | `flowers` | `0` | number |
 | `seed` | `1` | number |
-| `drape` | `false` | boolean |
+| `drape` | `null` | null |
 | `terrain` | `""` | string |
 
 ## `HudLayer` — `incanto`
@@ -836,7 +836,7 @@ Signals: `timeout`
 | `leafFadeStart` | `0` | number |
 | `leafFadeEnd` | `0` | number |
 | `leafShadows` | `true` | boolean |
-| `drape` | `false` | boolean |
+| `drape` | `null` | null |
 | `terrain` | `""` | string |
 
 ## `UILayer` — `incanto/2d`

package/templates-app/beacon-isle-3d/generate-world.ts

@@ -101,7 +101,6 @@ for (let i = 0; i < 400 && grassPlaced < 14; i++) {
       position: [round2(x), round2(y), round2(z)],
       area: [34, 34],
       density: 10,
-      terrain: '../../Ground/Surface',
     },
   });
 }
@@ -119,7 +118,6 @@ for (let i = 0; i < 300 && flowersPlaced < 9; i++) {
       position: [round2(x), round2(y), round2(z)],
       area: [12, 12],
       seed: Math.floor(rand() * 1e9),
-      terrain: '../../Ground/Surface',
     },
   });
 }

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

package/templates-app/beacon-isle-3d/src/game.scene.json

@@ -1131,8 +1131,7 @@
               "style": "mesh",
               "position": [83.83, 13.64, 53.8],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1143,8 +1142,7 @@
               "style": "mesh",
               "position": [48.69, 13.7, 42.89],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1155,8 +1153,7 @@
               "style": "mesh",
               "position": [-37.46, 18.04, 29.71],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1167,8 +1164,7 @@
               "style": "mesh",
               "position": [57.21, 16.3, 86.45],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1179,8 +1175,7 @@
               "style": "mesh",
               "position": [-67.62, 16.83, -54.03],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1191,8 +1186,7 @@
               "style": "mesh",
               "position": [0.75, 16.94, 89.68],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1203,8 +1197,7 @@
               "style": "mesh",
               "position": [85.64, 12.48, -28.21],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1215,8 +1208,7 @@
               "style": "mesh",
               "position": [58.99, 12.3, -5.25],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1227,8 +1219,7 @@
               "style": "mesh",
               "position": [75.79, 11.98, -31.54],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1239,8 +1230,7 @@
               "style": "mesh",
               "position": [28.8, 16.05, 70.6],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1251,8 +1241,7 @@
               "style": "mesh",
               "position": [-74.91, 19.52, -21.04],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1263,8 +1252,7 @@
               "style": "mesh",
               "position": [5.38, 16.51, 37.28],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1275,8 +1263,7 @@
               "style": "mesh",
               "position": [-9.71, 15.43, -10.63],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1287,8 +1274,7 @@
               "style": "mesh",
               "position": [-61.97, 20.04, 41.88],
               "area": [34, 34],
-              "density": 10,
-              "terrain": "../../Ground/Surface"
+              "density": 10
             }
           },
           {
@@ -1297,8 +1283,7 @@
             "props": {
               "position": [33.23, 14.62, 36.95],
               "area": [12, 12],
-              "seed": 357653252,
-              "terrain": "../../Ground/Surface"
+              "seed": 357653252
             }
           },
           {
@@ -1307,8 +1292,7 @@
             "props": {
               "position": [-82.3, 19.31, -38.23],
               "area": [12, 12],
-              "seed": 398696966,
-              "terrain": "../../Ground/Surface"
+              "seed": 398696966
             }
           },
           {
@@ -1317,8 +1301,7 @@
             "props": {
               "position": [-33.36, 18.6, 50.95],
               "area": [12, 12],
-              "seed": 400708434,
-              "terrain": "../../Ground/Surface"
+              "seed": 400708434
             }
           },
           {
@@ -1327,8 +1310,7 @@
             "props": {
               "position": [-9.78, 17.14, 45.89],
               "area": [12, 12],
-              "seed": 575315232,
-              "terrain": "../../Ground/Surface"
+              "seed": 575315232
             }
           },
           {
@@ -1337,8 +1319,7 @@
             "props": {
               "position": [55.02, 13.26, 39.6],
               "area": [12, 12],
-              "seed": 73428741,
-              "terrain": "../../Ground/Surface"
+              "seed": 73428741
             }
           },
           {
@@ -1347,8 +1328,7 @@
             "props": {
               "position": [-49.05, 16.91, -30.14],
               "area": [12, 12],
-              "seed": 258165764,
-              "terrain": "../../Ground/Surface"
+              "seed": 258165764
             }
           },
           {
@@ -1357,8 +1337,7 @@
             "props": {
               "position": [17.86, 16.44, 76.99],
               "area": [12, 12],
-              "seed": 22178236,
-              "terrain": "../../Ground/Surface"
+              "seed": 22178236
             }
           },
           {
@@ -1367,8 +1346,7 @@
             "props": {
               "position": [-5.95, 13.7, -35.97],
               "area": [12, 12],
-              "seed": 359604670,
-              "terrain": "../../Ground/Surface"
+              "seed": 359604670
             }
           },
           {
@@ -1377,8 +1355,7 @@
             "props": {
               "position": [-51.11, 18.29, -4.34],
               "area": [12, 12],
-              "seed": 723951523,
-              "terrain": "../../Ground/Surface"
+              "seed": 723951523
             }
           },
           {

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