incanto 0.9.0 → 0.11.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-BLzp8moy.js"></script>
+    <script type="module" crossorigin src="./assets/index-DMCQXowF.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.9.0",
+  "version": "0.11.0",
   "description": "Vibe-coding-first web game engine SDK — JSON-driven scenes on three.js",
   "keywords": [
     "game-engine",

package/schemas/scene.schema.json

@@ -190,6 +190,9 @@
         {
           "$ref": "#/$defs/Billboard3D"
         },
+        {
+          "$ref": "#/$defs/BoneAttachment3D"
+        },
         {
           "$ref": "#/$defs/Camera2D"
         },
@@ -1090,6 +1093,109 @@
       },
       "required": ["name", "type"]
     },
+    "BoneAttachment3D": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "uid": {
+          "type": "string"
+        },
+        "type": {
+          "const": "BoneAttachment3D"
+        },
+        "groups": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "tags": {
+          "type": "object"
+        },
+        "props": {
+          "type": "object",
+          "properties": {
+            "position": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "minItems": 3,
+              "maxItems": 3,
+              "default": [0, 0, 0]
+            },
+            "rotation": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "minItems": 3,
+              "maxItems": 3,
+              "default": [0, 0, 0]
+            },
+            "static": {
+              "type": "boolean",
+              "default": false
+            },
+            "scale": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "minItems": 3,
+              "maxItems": 3,
+              "default": [1, 1, 1]
+            },
+            "visible": {
+              "type": "boolean",
+              "default": true
+            },
+            "renderOrder": {
+              "type": "number",
+              "default": 0
+            },
+            "orderGroup": {
+              "type": "string",
+              "enum": ["background", "terrain", "default", "characters", "effects", "overlay"],
+              "default": "default"
+            },
+            "target": {
+              "type": "string",
+              "default": ""
+            },
+            "bone": {
+              "type": "string",
+              "default": ""
+            }
+          },
+          "additionalProperties": false
+        },
+        "script": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "props": {
+              "type": "object"
+            }
+          },
+          "required": ["name"]
+        },
+        "network": {
+          "type": "object"
+        },
+        "children": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/node"
+          }
+        }
+      },
+      "required": ["name", "type"]
+    },
     "Camera2D": {
       "type": "object",
       "properties": {

package/skills/incanto-3d-character.md

@@ -56,9 +56,14 @@ character stays centered even while the camera is catching up or pulled in by a
 collision — no jitter.
 
 **Camera collision (spring arm).** For the orbit views (`free`/`quarter`/`side`)
-the camera won't clip through walls or the ground: each frame it raycasts from
-the eye toward the camera and, if a collider blocks the boom, smoothly pulls the
-camera in front of it (plus a ground backstop so it never drops below the floor).
+the camera won't clip through walls or the ground: each frame it sweeps a small
+SPHERE (not a thin ray — a ray that skims 10 cm over a wall reports "clear"
+while the wall still fills the frame) from the eye toward the camera and, if a
+collider blocks the boom, smoothly pulls the camera in front of it (plus a
+ground backstop so it never drops below the floor).
+Level-design corollary: walls you want the camera to respect must be TALLER
+than the eye line (`player y + eyeHeight`, ~1.9 m for a default rig) — a
+1.8 m hedge is below the boom entirely and the camera will look over it.
 This is on by default (`cameraCollision: true`); set it `false` to get the old raw
 orbit. Only the STATIC/fixed world stops it — give walls/floors/terrain a
 `StaticBody3D` collider (collider-less meshes are invisible to the ray, same as to
@@ -117,6 +122,32 @@ itself never rotates. The skin MOUNTS at 180° (facing away from the default
 camera, original parity) and then faces wherever it moves; `skinYawOffset`
 adds a correction for models whose native forward is not +z.
 
+## Mounting things on bones (`BoneAttachment3D`)
+
+A sword in the hand, a hat on the head, sparks on a wingtip — parent them to a
+`BoneAttachment3D` and they ride the LIVE animated skeleton:
+
+```jsonc
+{ "name": "SwordMount", "type": "BoneAttachment3D",
+  "props": { "target": "../Skin", "bone": "RightHand" },
+  "children": [
+    { "name": "Blade", "type": "MeshInstance3D",
+      "props": { "mesh": "box", "size": [0.04, 0.04, 0.9], "position": [0, 0, 0.45],
+                 "material": { "color": "#d8dde8", "metalness": 0.9, "roughness": 0.25 } } }
+] }
+```
+
+- `target` = node path to the ModelInstance3D; `bone` = bone name. Lookup is
+  forgiving: `"RightHand"` also matches `mixamorigRightHand` /
+  `mixamorig:RightHand` (agent8's base-model is a Mixamo rig — `Head`,
+  `Spine2`, `LeftFoot`, `RightHandIndex1`…).
+- The attachment's own `position`/`rotation` are a BONE-SPACE offset (grip
+  adjustments).
+- Purely VISUAL: it follows the rendered skeleton, so headless the node stays
+  at its prop transform — keep hit checks range-based from the body, never
+  bone-based.
+- `model.boneNames()` lists every bone at runtime when you need to hunt one.
+
 ## Facing a direction in 3D — the +Z-FORWARD rule (read before turning ANY skin)
 
 This trips people up REPEATEDLY, so here is the one rule. agent8's `base-model` (and

package/skills/incanto-node-reference.md

@@ -130,6 +130,20 @@ Signals: `finished`
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `mode` | `"screen"` | one of: `screen` `y` `none` |
 
+## `BoneAttachment3D` — `incanto/3d`
+
+| Prop | Default | Kind |
+|---|---|---|
+| `position` | `[0,0,0]` | array |
+| `rotation` | `[0,0,0]` | array |
+| `static` | `false` | boolean |
+| `scale` | `[1,1,1]` | array |
+| `visible` | `true` | boolean |
+| `renderOrder` | `0` | number |
+| `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
+| `target` | `""` | string |
+| `bone` | `""` | string |
+
 ## `Camera2D` — `incanto/2d`
 
 | Prop | Default | Kind |
@@ -942,6 +956,7 @@ Signals: `totalChanged(total)`
 | `amount` | `10` | number |
 | `targetGroup` | `""` | string |
 | `oncePerTarget` | `true` | boolean |
+| `repeatEvery` | `0` | number |
 | `destroySelf` | `false` | boolean |
 
 Signals: `dealtDamage(amount, target)`

package/skills/incanto-physics-and-input.md

@@ -173,6 +173,14 @@ const hit = physics.castRay(origin, dir, maxLen, excludeBody?, { staticOnly?: tr
 
 Exclude the shooter's own body when casting from inside it.
 
+3D also has a THICK ray — a sphere sweep — for probes where skimming matters
+(the camera boom, ledge feelers):
+
+```ts
+const hit = physics.castSphere(origin, dir, radius, maxLen, excludeBody?, { staticOnly?: true });
+// → { distance, node } | null   (distance = travel of the sphere CENTER)
+```
+
 ## Gamepad
 
 `engine.input.attachGamepad(engine)` polls the first connected pad every