incanto 0.69.0 → 0.71.0

package/skills/incanto-node-reference.md

@@ -1,6 +1,6 @@
 ---
 name: incanto-node-reference
-description: GENERATED complete reference of every Incanto node type — props, defaults, kinds, signals — plus the machine-readable scene JSON Schema. Use when checking exact prop names, defaults, or which node type to use.
+description: GENERATED complete reference of every Incanto node type — props, defaults, kinds, signals, and the METHODS a connection handler can name — plus the machine-readable scene JSON Schema. Use when checking exact prop names, defaults, what you can call on a node, or which node type to use.
 ---
 
 # Node Reference
@@ -9,6 +9,10 @@ description: GENERATED complete reference of every Incanto node type — props,
 > installed engine version. Sibling skills live in `node_modules/incanto/skills/`.
 
 > GENERATED from the engine source by `pnpm generate:reference` — do not edit by hand.
+> **Methods** are what a connection's `handler` can name and what your behaviour can
+> call; a `param?` is optional. **Reads** are read-only accessors — the questions you
+> can ASK a node, which is what a headless harness is usually after. Each entry lists
+> the type's OWN methods and reads — every node also has `Node`'s (see its section).
 > Every node also accepts the structural fields: `name`, `uid`, `groups`, `tags`, `script`,
 > `network`, `children` (see `incanto-scene-json-authoring.md`).
 > Machine contract: `node_modules/incanto/schemas/scene.schema.json` — a JSON Schema for
@@ -38,6 +42,8 @@ description: GENERATED complete reference of every Incanto node type — props,
 
 Signals: `animationFinished(name)`
 
+Methods: `play(name)` · `stop()`
+
 ## `AnimatedSprite3D` — `incanto`
 
 | Prop | Default | Kind |
@@ -49,7 +55,7 @@ Signals: `animationFinished(name)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `texture` | `""` | string |
 | `size` | `[1,1]` | array |
 | `billboard` | `"y"` | one of: `y` `full` `none` |
@@ -69,6 +75,8 @@ Signals: `animationFinished(name)`
 
 Signals: `animationFinished(name)`
 
+Methods: `play(name)` · `stop()` · `free()`
+
 ## `Area2D` — `incanto/2d`
 
 | Prop | Default | Kind |
@@ -85,6 +93,8 @@ Signals: `animationFinished(name)`
 
 Signals: `triggerEnter(other)` · `triggerExit(other)`
 
+Methods: `overlapping(group?)`
+
 ## `Area3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -96,12 +106,14 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `collider` | `{}` | object |
 | `enabled` | `true` | boolean |
 
 Signals: `triggerEnter(other)` · `triggerExit(other)`
 
+Methods: `overlapping(group?)`
+
 ## `AudioPlayer` — `incanto`
 
 | Prop | Default | Kind |
@@ -121,6 +133,10 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 
 Signals: `finished`
 
+Methods: `playAt(when)` · `play()` · `free()` · `stop()` · `retryPending()`
+
+Reads: `playing: boolean`
+
 ## `Billboard3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -132,7 +148,7 @@ Signals: `finished`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `mode` | `"screen"` | one of: `screen` `y` `none` |
 
 ## `BoneAttachment3D` — `incanto/3d`
@@ -146,10 +162,14 @@ Signals: `finished`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
-| `target` | `""` | node path |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
+| `target` | `""` | node path · **required** |
 | `bone` | `""` | string |
 
+Methods: `free()`
+
+Reads: `attachedBone: Object3D | null`
+
 ## `BoneLookAt3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -161,14 +181,16 @@ Signals: `finished`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
-| `target` | `""` | node path |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
+| `target` | `""` | node path · **required** |
 | `bone` | `"Head"` | string |
 | `lookAt` | `""` | node path |
 | `maxAngleDeg` | `75` | number |
 | `weight` | `0.85` | number |
 | `forwardAxis` | `"+z"` | one of: `+x` `-x` `+y` `-y` `+z` `-z` |
 
+Reads: `attachedBone: Object3D | null`
+
 ## `Camera2D` — `incanto/2d`
 
 | Prop | Default | Kind |
@@ -186,6 +208,10 @@ Signals: `finished`
 | `limits` | `[]` | array |
 | `current` | `false` | boolean |
 
+Methods: `clampedCenter(vw, vh)`
+
+Reads: `effectiveZoom: number`
+
 ## `Camera3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -197,11 +223,12 @@ Signals: `finished`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `fov` | `60` | number |
 | `near` | `0.1` | number |
 | `far` | `1000` | number |
 | `current` | `false` | boolean |
+| `lookAt` | `""` | node path |
 
 ## `CharacterBody2D` — `incanto/2d`
 
@@ -219,9 +246,12 @@ Signals: `finished`
 | `velocity` | `[0,0]` | array |
 | `stickToGround` | `true` | boolean |
 | `slopeLimitDeg` | `45` | number |
+| `stepHeight` | `35` | number |
 
 Signals: `triggerEnter(other)` · `triggerExit(other)`
 
+Methods: `moveAndSlide()` · `isOnWall()` · `wallSide()` · `isOnCeiling()` · `isOnFloor()`
+
 ## `CharacterBody3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -233,7 +263,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `collider` | `{}` | object |
 | `enabled` | `true` | boolean |
 | `velocity` | `[0,0,0]` | array |
@@ -243,6 +273,8 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 
 Signals: `triggerEnter(other)` · `triggerExit(other)`
 
+Methods: `moveAndSlide()` · `isOnWall()` · `wallNormal()` · `isOnCeiling()` · `isOnFloor()`
+
 ## `CharacterController2D` — `incanto/2d`
 
 | Prop | Default | Kind |
@@ -275,7 +307,7 @@ Signals: `movementStateChanged(state)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `view` | `"free"` | one of: `free` `firstPerson` `quarter` `side` |
 | `camDistance` | `4` | number |
 | `eyeHeight` | `0.64` | number |
@@ -325,6 +357,8 @@ Signals: `movementStateChanged(state)`
 | `opacity` | `1` | number |
 | `anchor` | `[0.5,0.5]` | array |
 
+Methods: `free()`
+
 ## `DirectionalLight3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -336,7 +370,7 @@ Signals: `movementStateChanged(state)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `color` | `"#ffffff"` | string |
 | `intensity` | `1` | number |
 | `castShadow` | `false` | boolean |
@@ -355,8 +389,8 @@ Signals: `movementStateChanged(state)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
-| `density` | `"sparse"` | one of: `lush` `sparse` `none` |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
+| `density` | `"sparse"` | one of: `lush` `sparse` `none`, or number |
 | `area` | `[20,20]` | array |
 | `seed` | `1` | number |
 | `varieties` | `[]` | array |
@@ -364,10 +398,12 @@ Signals: `movementStateChanged(state)`
 | `height` | `0.45` | number |
 | `clustering` | `0.6` | number |
 | `sway` | `0.5` | number |
-| `drape` | `null` | null |
+| `drape` | `null` | any JSON — see the skill for the accepted shapes |
 | `avoidWater` | `true` | boolean |
 | `terrain` | `""` | node path |
 
+Methods: `free()`
+
 ## `Foliage3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -379,7 +415,7 @@ Signals: `movementStateChanged(state)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `2` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `kind` | `"grass"` | one of: `grass` `flowers` `reeds` |
 | `style` | `"mesh"` | one of: `blades` `simple` `mesh` `tufts` |
 | `tuftStyle` | `"grass"` | one of: `grass` `fern` |
@@ -398,10 +434,12 @@ Signals: `movementStateChanged(state)`
 | `coverage` | `0.85` | number |
 | `flowers` | `0` | number |
 | `seed` | `1` | number |
-| `drape` | `null` | null |
+| `drape` | `null` | any JSON — see the skill for the accepted shapes |
 | `avoidWater` | `true` | boolean |
 | `terrain` | `""` | node path |
 
+Methods: `free()`
+
 ## `HudLayer` — `incanto`
 
 | Prop | Default | Kind |
@@ -410,6 +448,8 @@ Signals: `movementStateChanged(state)`
 | `visible` | `true` | boolean |
 | `focusNavigation` | `false` | boolean |
 
+Methods: `focusables()` · `focus(widget)`
+
 ## `InstancedMesh3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -421,14 +461,18 @@ Signals: `movementStateChanged(state)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `mesh` | `"box"` | one of: `box` `sphere` `capsule` `plane` `cylinder` `gem` |
 | `size` | `[1,1,1]` | array |
 | `material` | `{}` | object |
 | `transforms` | `[]` | array |
 | `castShadow` | `false` | boolean |
 | `receiveShadow` | `false` | boolean |
-| `collider` | `null` | null |
+| `collider` | `null` | any JSON — see the skill for the accepted shapes |
+
+Methods: `free()`
+
+Reads: `instanceCount: number`
 
 ## `Joint2D` — `incanto/2d`
 
@@ -442,13 +486,13 @@ Signals: `movementStateChanged(state)`
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 | `type` | `"revolute"` | one of: `fixed` `revolute` `rope` `spring` |
-| `target` | `""` | node path |
+| `target` | `""` | node path · **required** |
 | `anchor` | `[0,0]` | array |
 | `targetAnchor` | `[0,0]` | array |
 | `length` | `0` | number |
 | `stiffness` | `50` | number |
 | `damping` | `5` | number |
-| `collide` | `null` | null |
+| `collide` | `null` | any JSON — see the skill for the accepted shapes |
 
 ## `Joint3D` — `incanto/3d`
 
@@ -461,15 +505,15 @@ Signals: `movementStateChanged(state)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `type` | `"spherical"` | one of: `fixed` `spherical` `rope` `spring` |
-| `target` | `""` | node path |
+| `target` | `""` | node path · **required** |
 | `anchor` | `[0,0,0]` | array |
 | `targetAnchor` | `[0,0,0]` | array |
 | `length` | `0` | number |
 | `stiffness` | `50` | number |
 | `damping` | `5` | number |
-| `collide` | `null` | null |
+| `collide` | `null` | any JSON — see the skill for the accepted shapes |
 
 ## `Label` — `incanto/2d`
 
@@ -489,6 +533,8 @@ Signals: `movementStateChanged(state)`
 | `align` | `"left"` | string |
 | `opacity` | `1` | number |
 
+Methods: `free()`
+
 ## `Label3D` — `incanto`
 
 | Prop | Default | Kind |
@@ -500,7 +546,7 @@ Signals: `movementStateChanged(state)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `texture` | `""` | string |
 | `size` | `[1,1]` | array |
 | `billboard` | `"full"` | one of: `y` `full` `none` |
@@ -518,6 +564,8 @@ Signals: `movementStateChanged(state)`
 | `font` | `"sans-serif"` | string |
 | `outline` | `"#000000"` | string |
 
+Methods: `free()`
+
 ## `LoftMesh3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -529,7 +577,7 @@ Signals: `movementStateChanged(state)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `sections` | `[]` | array |
 | `slices` | `24` | number |
 | `smooth` | `4` | number |
@@ -537,6 +585,8 @@ Signals: `movementStateChanged(state)`
 | `castShadow` | `false` | boolean |
 | `receiveShadow` | `false` | boolean |
 
+Methods: `free()`
+
 ## `MeshInstance3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -548,13 +598,15 @@ Signals: `movementStateChanged(state)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `mesh` | `"box"` | one of: `box` `sphere` `capsule` `plane` `cylinder` `gem` |
 | `size` | `[1,1,1]` | array |
 | `material` | `{}` | object |
 | `castShadow` | `false` | boolean |
 | `receiveShadow` | `false` | boolean |
 
+Methods: `free()`
+
 ## `ModelInstance3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -566,7 +618,7 @@ Signals: `movementStateChanged(state)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `model` | `""` | string |
 | `animation` | `""` | string |
 | `targetHeight` | `0` | number |
@@ -584,20 +636,28 @@ Signals: `movementStateChanged(state)`
 
 Signals: `animationFinished(name)`
 
+Methods: `poseNode(name, rotation)` · `findBone(name)` · `boneNames()` · `availableAnimations()`
+
 ## `NetworkSpawner` — `incanto/net`
 
 | Prop | Default | Kind |
 |---|---|---|
 | `source` | `"users"` | string |
-| `scene` | `""` | string |
+| `scene` | `""` | string · **required** |
 | `interpolate` | `true` | boolean |
 
 Signals: `spawned(node, key)` · `despawned(node, key)`
 
+Methods: `replicatedPosition(node)`
+
 ## `Node` — `incanto`
 
 _No props (structural fields only)._
 
+Methods: `addChild(child)` · `removeChild(child)` · `reparent(newParent)` · `findChild(name, recursive?)` · `getRoot()` · `getNodeByUid(uid)` · `getNodesByName(name)` · `getPath()` · `wiringPath()` · `getNode(path)` · `getNodeOrNull(path)` · `addToGroup(group)` · `removeFromGroup(group)` · `isInGroup(group)` · `declareSignal(name)` · `declaredSignalNames()` · `signal(name)` · `on(signal, fn, opts?)` · `off(signal, fn)` · `listenerCount(signal)` · `emit(signal, ...args)` · `queueFree()` · `free()`
+
+Reads: `uid: string | null` · `name: string` · `parent: Node | null` · `children: readonly Node[]` · `groups: ReadonlySet<string>` · `tree: SceneTree | null` · `isReady: boolean` · `freed: boolean`
+
 ## `Node2D` — `incanto/2d`
 
 | Prop | Default | Kind |
@@ -610,6 +670,10 @@ _No props (structural fields only)._
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
 | `visible` | `true` | boolean |
 
+Methods: `free()`
+
+Reads: `effectiveRenderOrder: number`
+
 ## `Node3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -621,7 +685,11 @@ _No props (structural fields only)._
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
+
+Methods: `applyGroundSnap()` · `free()`
+
+Reads: `effectiveRenderOrder: number`
 
 ## `OmniLight3D` — `incanto/3d`
 
@@ -634,7 +702,7 @@ _No props (structural fields only)._
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `color` | `"#ffffff"` | string |
 | `intensity` | `1` | number |
 | `range` | `0` | number |
@@ -674,6 +742,10 @@ _No props (structural fields only)._
 
 Signals: `finished`
 
+Methods: `particles()` · `free()` · `replay()`
+
+Reads: `aliveCount: number`
+
 ## `Particles3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -685,7 +757,7 @@ Signals: `finished`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"effects"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `preset` | `"custom"` | one of: `custom` `fire` `smoke` `sparks` `fireworks` `explosion` `flash` `lightning` `rain` `snow` `magic` |
 | `emitting` | `true` | boolean |
 | `worldSpace` | `false` | boolean |
@@ -711,12 +783,16 @@ Signals: `finished`
 
 Signals: `finished`
 
+Methods: `particles()` · `replay()` · `free()`
+
+Reads: `aliveCount: number`
+
 ## `Respawn` — `incanto`
 
 | Prop | Default | Kind |
 |---|---|---|
 | `target` | `".."` | node path |
-| `below` | `null` | null |
+| `below` | `null` | any JSON — see the skill for the accepted shapes |
 | `to` | `[]` | array |
 | `resetVelocity` | `true` | boolean |
 
@@ -741,9 +817,14 @@ Signals: `respawned`
 | `friction` | `0.5` | number |
 | `restitution` | `0` | number |
 | `linearVelocity` | `[0,0]` | array |
+| `angularVelocity` | `0` | number |
 
 Signals: `triggerEnter(other)` · `triggerExit(other)`
 
+Methods: `applyImpulse(impulse)`
+
+Reads: `velocity: number[]`
+
 ## `RigidBody3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -755,7 +836,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `collider` | `{}` | object |
 | `enabled` | `true` | boolean |
 | `mass` | `1` | number |
@@ -768,6 +849,10 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 
 Signals: `triggerEnter(other)` · `triggerExit(other)`
 
+Methods: `applyImpulse(impulse)`
+
+Reads: `velocity: number[]`
+
 ## `River3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -779,7 +864,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `path` | `[]` | array |
 | `width` | `6` | number |
 | `widths` | `[]` | array |
@@ -798,6 +883,8 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `flowForce` | `1` | number |
 | `spray` | `1` | number |
 
+Methods: `sampleAt(x, z)` · `fallsAt()` · `free()`
+
 ## `Sprite2D` — `incanto/2d`
 
 | Prop | Default | Kind |
@@ -816,6 +903,8 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `tint` | `"#ffffff"` | string |
 | `opacity` | `1` | number |
 
+Methods: `free()`
+
 ## `Sprite3D` — `incanto`
 
 | Prop | Default | Kind |
@@ -827,7 +916,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `texture` | `""` | string |
 | `size` | `[1,1]` | array |
 | `billboard` | `"y"` | one of: `y` `full` `none` |
@@ -840,6 +929,8 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `castShadow` | `false` | boolean |
 | `shadowMode` | `"silhouette"` | one of: `silhouette` `blob` |
 
+Methods: `free()`
+
 ## `StaticBody2D` — `incanto/2d`
 
 | Prop | Default | Kind |
@@ -867,7 +958,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `collider` | `{}` | object |
 | `enabled` | `true` | boolean |
 
@@ -884,7 +975,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"terrain"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `size` | `[200,200]` | array |
 | `maxHeight` | `28` | number |
 | `seed` | `1` | number |
@@ -893,12 +984,14 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `roughness` | `0.5` | number |
 | `detail` | `4` | number |
 | `flatThreshold` | `0.95` | number |
-| `islandEdge` | `null` | null |
+| `islandEdge` | `null` | any JSON — see the skill for the accepted shapes |
 | `layers` | `[]` | array |
 | `textureBase` | `"https://agent8-games.verse8.io/assets/3D/default/textures/terrain"` | string |
 | `basins` | `[]` | array |
 | `channels` | `[]` | array |
-| `wetline` | `null` | null |
+| `wetline` | `null` | any JSON — see the skill for the accepted shapes |
+
+Methods: `heightAt(x, z)` · `resolvedLayers()` · `free()`
 
 ## `TileMap2D` — `incanto/2d`
 
@@ -916,9 +1009,14 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `columns` | `0` | number |
 | `cells` | `[]` | array |
 | `legend` | `{}` | object |
+| `colors` | `{}` | object |
 | `solid` | `[]` | array |
 | `opacity` | `1` | number |
 
+Methods: `grid()` · `cellAt(worldX, worldY)` · `tileAt(cx, cy)` · `worldAt(cx, cy)` · `setTile(cx, cy, char)` · `free()`
+
+Reads: `renderedTileCount: number`
+
 ## `Timer` — `incanto`
 
 | Prop | Default | Kind |
@@ -929,6 +1027,8 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 
 Signals: `timeout`
 
+Methods: `start(time?)` · `stop()`
+
 ## `Trail3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -940,7 +1040,7 @@ Signals: `timeout`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `width` | `0.3` | number |
 | `color` | `"#ffffff"` | string |
 | `opacity` | `0.8` | number |
@@ -949,6 +1049,10 @@ Signals: `timeout`
 | `additive` | `false` | boolean |
 | `minDistance` | `0.05` | number |
 
+Methods: `free()`
+
+Reads: `pointCount: number`
+
 ## `Tree3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -960,7 +1064,7 @@ Signals: `timeout`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `tier` | `"medium"` | one of: `simple` `medium` `high` |
 | `type` | `"conifer"` | one of: `conifer` `broadleaf` `dead` `bush` |
 | `seed` | `1` | number |
@@ -973,9 +1077,11 @@ Signals: `timeout`
 | `leafFadeStart` | `0` | number |
 | `leafFadeEnd` | `0` | number |
 | `leafShadows` | `true` | boolean |
-| `drape` | `null` | null |
+| `drape` | `null` | any JSON — see the skill for the accepted shapes |
 | `terrain` | `""` | node path |
 
+Methods: `free()`
+
 ## `UILayer` — `incanto/2d`
 
 | Prop | Default | Kind |
@@ -996,6 +1102,10 @@ Signals: `timeout`
 
 Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `bannerShown`
 
+Methods: `show(text, opts?)` · `clear()`
+
+Reads: `showing: string`
+
 ## `UiBar` — `incanto`
 
 | Prop | Default | Kind |
@@ -1017,6 +1127,10 @@ Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `banner
 
 Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped`
 
+Methods: `setValue(value, max?)` · `setMax(max)`
+
+Reads: `ratio: number`
+
 ## `UiButton` — `incanto`
 
 | Prop | Default | Kind |
@@ -1034,6 +1148,8 @@ Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped`
 
 Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `pressed`
 
+Methods: `press()`
+
 ## `UiDialogue` — `incanto`
 
 | Prop | Default | Kind |
@@ -1048,6 +1164,10 @@ Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `presse
 
 Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `lineShown` · `choiceMade` · `dialogueFinished`
 
+Methods: `say(speaker, text, choices?)` · `advance()` · `choose(index)` · `clear()`
+
+Reads: `active: boolean` · `showing: string`
+
 ## `UiFrameCapSelect` — `incanto`
 
 | Prop | Default | Kind |
@@ -1176,6 +1296,8 @@ Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `change
 
 Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `changed`
 
+Methods: `choose(value)`
+
 ## `UiSlider` — `incanto`
 
 | Prop | Default | Kind |
@@ -1195,6 +1317,8 @@ Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `change
 
 Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `changed`
 
+Methods: `choose(value)`
+
 ## `UiText` — `incanto`
 
 | Prop | Default | Kind |
@@ -1212,6 +1336,10 @@ Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `change
 
 Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped`
 
+Methods: `setText(value)`
+
+Reads: `shown: string`
+
 ## `UiToggle` — `incanto`
 
 | Prop | Default | Kind |
@@ -1226,6 +1354,8 @@ Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped`
 
 Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `changed`
 
+Methods: `choose(value)`
+
 ## `UiVolumeSlider` — `incanto`
 
 | Prop | Default | Kind |
@@ -1257,11 +1387,13 @@ Signals: `dragStarted` · `dragCancelled` · `droppedOn` · `dropped` · `change
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `voxels` | `[]` | array |
 
 Signals: `blocksChanged`
 
+Methods: `blockCount()` · `tileAt(x, y, z)` · `setBlocks(blocks)` · `addBlock(b)` · `removeBlockAt(x, y, z)` · `blocks()` · `free()`
+
 ## `Water3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -1273,7 +1405,7 @@ Signals: `blocksChanged`
 | `visible` | `true` | boolean |
 | `renderOrder` | `1` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `size` | `[40,40]` | array |
 | `color` | `"#2a6fbe"` | string |
 | `opacity` | `0.8` | number |
@@ -1287,7 +1419,7 @@ Signals: `blocksChanged`
 | `mirrorInterval` | `33` | number |
 | `swellSteepness` | `0.35` | number |
 | `foam` | `true` | boolean |
-| `reflectivity` | `null` | null |
+| `reflectivity` | `null` | any JSON — see the skill for the accepted shapes |
 | `interaction` | `true` | boolean |
 | `splash` | `true` | boolean |
 | `sunDirection` | `[0.5,0.8,0.3]` | array |
@@ -1296,7 +1428,7 @@ Signals: `blocksChanged`
 | `detailStrength` | `0.26` | number |
 | `absorption` | `0.15` | number |
 | `refraction` | `true` | boolean |
-| `underwater` | `true` | boolean |
+| `underwater` | `true` | boolean, or object |
 | `swell` | `0` | number |
 | `swellDirectionDeg` | `0` | number |
 | `swellWavelength` | `30` | number |
@@ -1307,6 +1439,8 @@ Signals: `blocksChanged`
 
 Signals: `entered(body)` · `exited(body)`
 
+Methods: `underwaterAt(camX, camY, camZ)` · `free()` · `heightAt(x, z)`
+
 ## `WaterCutout3D` — `incanto/3d`
 
 | Prop | Default | Kind |
@@ -1318,7 +1452,7 @@ Signals: `entered(body)` · `exited(body)`
 | `visible` | `true` | boolean |
 | `renderOrder` | `0` | number |
 | `orderGroup` | `"default"` | one of: `background` `terrain` `default` `characters` `effects` `overlay` |
-| `snapToGround` | `null` | null |
+| `snapToGround` | `null` | any JSON — see the skill for the accepted shapes |
 | `size` | `[2,1,1]` | array |
 | `enabled` | `true` | boolean |
 
@@ -1351,12 +1485,14 @@ Signals: `submerged` · `surfaced`
 | `enabled` | `true` | boolean |
 | `falloff` | `0.28` | number |
 
+Methods: `shake(magnitude, seconds?)`
+
 ### `Chase`
 
 | Prop | Default | Kind |
 |---|---|---|
 | `enabled` | `true` | boolean |
-| `target` | `""` | node path |
+| `target` | `""` | node path · **required** |
 | `speed` | `60` | number |
 | `stopRange` | `0` | number |
 | `loseRange` | `0` | number |
@@ -1385,6 +1521,8 @@ Signals: `clicked` · `hovered` · `unhovered`
 
 Signals: `totalChanged(total)`
 
+Methods: `collect(value)` · `announce()`
+
 ### `Currency`
 
 | Prop | Default | Kind |
@@ -1395,6 +1533,8 @@ Signals: `totalChanged(total)`
 
 Signals: `changed` · `earned` · `spent` · `refused`
 
+Methods: `canAfford(cost)` · `spend(cost)` · `earn(gain)` · `setAmount(next)` · `announce()`
+
 ### `DamageOnContact`
 
 | Prop | Default | Kind |
@@ -1427,7 +1567,7 @@ Signals: `dayPhaseChanged`
 | Prop | Default | Kind |
 |---|---|---|
 | `enabled` | `true` | boolean |
-| `targetGroup` | `""` | string |
+| `targetGroup` | `""` | string · **required** |
 | `range` | `0` | number |
 | `facePath` | `""` | node path |
 | `turnSpeed` | `6` | number |
@@ -1451,11 +1591,13 @@ Signals: `acquired` · `lostTarget` · `aimed` · `lostAim`
 | Prop | Default | Kind |
 |---|---|---|
 | `enabled` | `true` | boolean |
-| `target` | `""` | node path |
+| `target` | `""` | node path · **required** |
 | `offset` | `[]` | array |
 | `smoothing` | `0` | number |
 | `deadzone` | `0` | number |
 
+Methods: `shake(magnitude, seconds?)`
+
 ### `GameFlow`
 
 | Prop | Default | Kind |
@@ -1469,6 +1611,8 @@ Signals: `acquired` · `lostTarget` · `aimed` · `lostAim`
 
 Signals: `flowChanged`
 
+Methods: `gameOver(text?, color?)` · `win(text?, color?)` · `pause()` · `resume()` · `restart()` · `goToScene(sceneJson, opts?)`
+
 ### `Health`
 
 | Prop | Default | Kind |
@@ -1478,9 +1622,14 @@ Signals: `flowChanged`
 | `regenPerSec` | `0` | number |
 | `invulnerableFor` | `0` | number |
 | `freeOnDeath` | `false` | boolean |
+| `freeParent` | `false` | boolean |
 
 Signals: `damaged(amount, current)` · `healed(amount, current)` · `died` · `revived` · `healthChanged`
 
+Methods: `damage(n)` · `heal(n)` · `revive(hp?)` · `reviveFull()` · `kill()` · `announce()`
+
+Reads: `isDead: boolean` · `invulnerableRemaining: number`
+
 ### `Interactable`
 
 | Prop | Default | Kind |
@@ -1503,18 +1652,22 @@ Signals: `interacted(actor)`
 
 Signals: `expired`
 
+Methods: `startTimer()`
+
 ### `MoveTo`
 
 | Prop | Default | Kind |
 |---|---|---|
 | `enabled` | `true` | boolean |
-| `to` | `[]` | array |
+| `to` | `[]` | array · **required** |
 | `duration` | `1` | number |
 | `ease` | `"easeInOut"` | one of: `linear` `easeIn` `easeOut` `easeInOut` |
 | `startOnSignal` | `false` | boolean |
 
 Signals: `arrived`
 
+Methods: `start()`
+
 ### `Oscillate`
 
 | Prop | Default | Kind |
@@ -1535,12 +1688,16 @@ Signals: `arrived`
 
 Signals: `waypointReached` · `arrived`
 
+Methods: `setPath(waypoints)` · `stop()`
+
+Reads: `moving: boolean`
+
 ### `Patrol`
 
 | Prop | Default | Kind |
 |---|---|---|
 | `enabled` | `true` | boolean |
-| `points` | `[]` | array |
+| `points` | `[]` | array · **required** |
 | `speed` | `60` | number |
 | `loop` | `true` | boolean |
 | `mode` | `"loop"` | one of: `loop` `pingpong` |
@@ -1562,15 +1719,26 @@ Signals: `reachedPoint(index)`
 
 Signals: `collected(value, other)`
 
+### `PrefabShelf`
+
+| Prop | Default | Kind |
+|---|---|---|
+| `enabled` | `true` | boolean |
+| `prefabs` | `""` | string |
+
+Methods: `names()` · `make(name)`
+
 ### `Projectile`
 
 | Prop | Default | Kind |
 |---|---|---|
 | `enabled` | `true` | boolean |
 | `speed` | `300` | number |
-| `direction` | `null` | null |
+| `direction` | `null` | any JSON — see the skill for the accepted shapes |
 | `gravity` | `0` | number |
 
+Methods: `aim(direction?)`
+
 ### `SavePoint`
 
 | Prop | Default | Kind |
@@ -1583,7 +1751,11 @@ Signals: `collected(value, other)`
 | `restoreOnReady` | `false` | boolean |
 | `probeOnReady` | `false` | boolean |
 
-Signals: `saved` · `restored` · `noSave` · `hasSave`
+Signals: `saved` · `saveFailed` · `restored` · `noSave` · `hasSave`
+
+Methods: `probe()` · `slotScene()` · `save()` · `restore()` · `clear()`
+
+Reads: `playtime: number`
 
 ### `ScoreKeeper`
 
@@ -1594,14 +1766,16 @@ Signals: `saved` · `restored` · `noSave` · `hasSave`
 | `lives` | `0` | number |
 | `scoreToWin` | `0` | number |
 
-Signals: `scoreChanged(score)` · `won` · `lost` · `lifeLost(lives)`
+Signals: `scoreChanged(score)` · `won` · `lost` · `lifeLost(lives)` · `livesChanged`
+
+Methods: `addScore(n)` · `setScore(value)` · `loseLife()` · `announce()`
 
 ### `Spawner`
 
 | Prop | Default | Kind |
 |---|---|---|
 | `enabled` | `true` | boolean |
-| `prefab` | `""` | node path |
+| `prefab` | `""` | node path · **required** |
 | `interval` | `1` | number |
 | `max` | `0` | number |
 | `at` | `[]` | array |
@@ -1610,6 +1784,10 @@ Signals: `scoreChanged(score)` · `won` · `lost` · `lifeLost(lives)`
 
 Signals: `spawned(node)` · `finished`
 
+Methods: `start()` · `stop()` · `spawn()`
+
+Reads: `liveCount: number`
+
 ### `Wander`
 
 | Prop | Default | Kind |
@@ -1624,10 +1802,12 @@ Signals: `spawned(node)` · `finished`
 | Prop | Default | Kind |
 |---|---|---|
 | `enabled` | `true` | boolean |
-| `waves` | `[]` | array |
+| `waves` | `[]` | array · **required** |
 | `autoStart` | `true` | boolean |
 
-Signals: `waveStarted(index)` · `waveCleared(index)` · `allCleared`
+Signals: `spawned(node)` · `waveStarted(index)` · `waveCleared(index)` · `allCleared`
+
+Methods: `start()`
 
 ### `ZombieAI`