npm - incanto - Versions diffs - 0.64.1 → 0.66.0 - Mend

incanto 0.64.1 → 0.66.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (59) hide show

package/dist/2d.d.ts +38 -3
package/dist/2d.js +3 -3
package/dist/3d.d.ts +130 -3
package/dist/3d.js +5 -5
package/dist/{audio-player-D5GJgb_x.d.ts → audio-player-_UAcHxnC.d.ts} +1 -1
package/dist/{behavior-DsgayMsH.d.ts → behavior-BXNLfIJk.d.ts} +128 -0
package/dist/{create-game-B746rYbr.js → create-game-DYJCIzO0.js} +67 -6
package/dist/{create-game-B1KM6dA6.js → create-game-Dd7H4bJV.js} +6 -6
package/dist/debug.d.ts +1 -1
package/dist/{duplicate-BOOKmkQ7.js → duplicate-CqSAtdrh.js} +1 -1
package/dist/{environment-presets-D2vzw583.js → environment-presets-BlPsEmq6.js} +70 -6
package/dist/{gameplay-CLgFdkh5.js → gameplay-D1RADWu3.js} +374 -18
package/dist/gameplay.d.ts +94 -3
package/dist/gameplay.js +2 -2
package/dist/index.d.ts +4 -4
package/dist/index.js +5 -5
package/dist/{loader-DolLJWJn.d.ts → loader-Cga7FVP4.d.ts} +1 -1
package/dist/{loader-zDynoew_.js → loader-lQDCwNag.js} +59 -3
package/dist/net.d.ts +2 -2
package/dist/net.js +1 -1
package/dist/{physics-2d-BPJcJRRP.js → physics-2d-Cji5A6sX.js} +32 -4
package/dist/{physics-3d-BOO58xzw.js → physics-3d-BkHjwJgI.js} +49 -5
package/dist/{quiet-rapier-BAJ4K94N.js → quiet-rapier-C6fW4zcW.js} +14 -1
package/dist/react.d.ts +1 -1
package/dist/react.js +1 -1
package/dist/{register-Btm7_Emq.js → register-BmuqYTiY.js} +44 -1
package/dist/{register-dGsbnJ87.js → register-D0CxCveZ.js} +38 -4
package/dist/{replay-C5x2vPF5.d.ts → replay-BHoB6fCU.d.ts} +1 -1
package/dist/{replay-DKRmiVjk.js → replay-IsZbNu6d.js} +2 -2
package/dist/{split-screen-Dx0LvzqS.js → split-screen-D_i7GRcY.js} +2 -2
package/dist/{split-screen-D7OopelJ.d.ts → split-screen-eJUFjhi1.d.ts} +2 -2
package/dist/{src-CNS2xQB1.js → src-BTLbXFPZ.js} +1 -1
package/dist/{teardown-BwhkcNt8.js → teardown-byR9USax.js} +1 -1
package/dist/{test-Ccob3X5i.js → test-DgrD0jHD.js} +13 -13
package/dist/test.d.ts +4 -4
package/dist/test.js +2 -2
package/dist/vite.js +2 -2
package/editor/assets/{agent8-Di-UEn5O.js → agent8-9N-Pd_YS.js} +1 -1
package/editor/assets/{debug-DWztJ5_y.js → debug-CkbJICYp.js} +1 -1
package/editor/assets/{index-fct4H89G.js → index-CeDhIPTC.js} +53 -53
package/editor/index.html +1 -1
package/package.json +1 -1
package/schemas/scene.schema.json +19 -0
package/skills/incanto-3d-character.md +11 -1
package/skills/incanto-behaviors-and-scripts.md +21 -0
package/skills/incanto-gameplay-behaviors.md +177 -9
package/skills/incanto-node-reference.md +59 -1
package/skills/incanto-physics-and-input.md +84 -1
package/skills/incanto-web-integration.md +24 -3
package/templates-app/beacon-isle-3d/package.json +1 -1
package/templates-app/platformer-2d/package.json +1 -1
package/templates-app/star-survivor/package.json +1 -1
package/templates-app/tps-3d/package.json +1 -1
package/templates-app/village-quest-3d/package.json +1 -1
package/templates-app/beacon-isle-3d/coverage.json +0 -9
package/templates-app/platformer-2d/coverage.json +0 -5
package/templates-app/star-survivor/coverage.json +0 -5
package/templates-app/tps-3d/coverage.json +0 -5
package/templates-app/village-quest-3d/coverage.json +0 -9

package/editor/index.html CHANGED Viewed

@@ -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-fct4H89G.js"></script>
+    <script type="module" crossorigin src="./assets/index-CeDhIPTC.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/GameServer-C56iOUgF.js">
   </head>
   <body>

package/package.json CHANGED Viewed

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

package/schemas/scene.schema.json CHANGED Viewed

@@ -2350,6 +2350,10 @@
               "type": "number",
               "default": 0.01
             },
+            "stepHeight": {
+              "type": "number",
+              "default": 0.35
+            },
             "mouseLook": {
               "type": "boolean",
               "default": true
@@ -3423,6 +3427,9 @@
             "damping": {
               "type": "number",
               "default": 5
+            },
+            "collide": {
+              "default": null
             }
           },
           "additionalProperties": false
@@ -3577,6 +3584,9 @@
             "damping": {
               "type": "number",
               "default": 5
+            },
+            "collide": {
+              "default": null
             }
           },
           "additionalProperties": false
@@ -5670,6 +5680,15 @@
               "minItems": 3,
               "maxItems": 3,
               "default": [0, 0, 0]
+            },
+            "angularVelocity": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "minItems": 3,
+              "maxItems": 3,
+              "default": [0, 0, 0]
             }
           },
           "additionalProperties": false

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

@@ -269,7 +269,17 @@ target being "where I'm walking." There is ONE facing formula; only the directio
   its FACE, not its back. (Headless, no three.js: with the yaw you set, the model's
   forward is `(sin(yaw), cos(yaw))`; dot it with the desired unit dir — `< 0` = wrong way.)
-**NON-player models (enemies/NPCs) face + animate via the SAME rules, by hand.**
+**NON-player models (enemies/NPCs) face by the SAME rule — but do not hand-write
+it if a built-in is moving them.** `Patrol` and `Chase` take `facePath` (+
+`turnSpeed`), which applies exactly the formula above to the skin you name:
+```jsonc
+{ "name": "Hunt", "type": "Node3D",
+  "script": { "name": "Chase",
+    "props": { "target": "/root/Player", "moveParent": true, "facePath": "../Skin" } } }
+```
+Only a model driven by YOUR OWN behavior needs the formula written out.
 `CharacterController3D` automates this for the player; a custom-driven model does it
 itself — face with the formula above, and drive `skin.animation` from your AI state (see
 incanto-gameplay-behaviors.md "Driving a model's animation from a custom AI"). Ground a

package/skills/incanto-behaviors-and-scripts.md CHANGED Viewed

@@ -84,6 +84,27 @@ under an existing name (re-registering a different class without it → `DUPLICA
   with `new Engine({ seed: 42 })` a run replays identically (scripted verification).
 - `this.log` — the engine log channel (`debug/info/warn/error(...parts)`; debug overlay
   and headless harnesses tail it via `entries()` / the live `added` signal)
+- `this.physics` — the physics world, for the queries AI asks:
+  `castRay(origin, dir, maxLen, exclude?)` for line of sight, `castSphere(...)`
+  (3D) for a probe that must not skim past a wall. `null` in a game with no
+  physics. Pass `this.node` as `exclude` when casting from your own body.
+  See `incanto-physics-and-input.md`.
+- `this.enabled` — whether this behavior's `update`/`fixedUpdate` run, with
+  `enable()` / `disable()` to flip it. Every behavior has it, it is authorable
+  as a `script` prop, and because they are METHODS a connection can call them:
+  ```jsonc
+  { "signal": "spotted", "from": "Eyes", "to": "Hunt", "handler": "enable" }
+  ```
+  That is what makes an enemy STATE MACHINE expressible in JSON — a node carries
+  one behavior, so each state gets a child node and only one of them ticks. Full
+  recipe: "An enemy that changes its mind" in `incanto-gameplay-behaviors.md`.
+  Asleep is not detached: props, accumulated state, signal connections and
+  `serialize()` all survive; only the per-frame hooks pause. The lifecycle hooks
+  are never gated, so a behavior authored `enabled: false` is fully initialized
+  and simply idle.
 ## Runtime API (the imperative half)

package/skills/incanto-gameplay-behaviors.md CHANGED Viewed

@@ -382,6 +382,9 @@ author markers). Emits `reachedPoint(index)` on arrival.
 | `loop` | `true` | wrap to the first point after the last (loop mode) |
 | `mode` | `"loop"` | `'loop'` wraps · `'pingpong'` reverses at the ends |
 | `pauseAt` | `0` | seconds to wait at each reached point |
+| `moveParent` | `false` | move the PARENT node instead of this one |
+| `facePath` | `""` | node path to TURN toward the direction of travel (e.g. `"../Skin"`) |
+| `turnSpeed` | `100` | turn rate rad/s; 100 is an instant snap |
 Signals: `reachedPoint(index)`
@@ -390,6 +393,12 @@ Signals: `reachedPoint(index)`
   "script": { "name": "Patrol", "props": { "points": [[100, 0], [300, 0]], "speed": 80, "mode": "pingpong" } } }
 ```
+`moveParent` is the same prop `Chase` has, and it exists for the same reason: a
+node carries ONE behavior, so a guard that must patrol AND hold `Health` on its
+body puts `Patrol` on a CHILD. Without it a patrolling body had to carry
+`Patrol` itself and could hold nothing else — a patrolling enemy you could not
+hurt.
 ## Chase
 Homing enemy AI: each frame moves toward `target.position` at `speed`, stopping
@@ -403,6 +412,8 @@ within `stopRange` (melee reach). `reachedTarget` fires once on entering range
 | `stopRange` | `0` | stop (and emit reachedTarget) within this distance |
 | `loseRange` | `0` | give up beyond this distance (0 = never lose) |
 | `moveParent` | `false` | move the PARENT node instead of this one |
+| `facePath` | `""` | node path to TURN toward the direction of travel (e.g. `"../Skin"`) |
+| `turnSpeed` | `100` | turn rate rad/s; 100 is an instant snap |
 Signals: `reachedTarget` · `lostTarget`
@@ -420,6 +431,25 @@ whole entity toward the target. (Distance is measured from the moved parent.)
   "script": { "name": "Chase", "props": { "target": "/root/Player", "speed": 120, "stopRange": 20 } } }
 ```
+**`facePath` — an NPC that does not run backwards.** `CharacterController3D`
+turns the PLAYER's skin toward its travel; for an NPC nothing did, so every 3D
+game hand-wrote the same `yaw = atan2(dx, dz)` — against a formula
+`incanto-3d-character.md` simultaneously teaches and calls "the #1 recurring
+bug", because the wrong version shows you the enemy's BACK while it charges at
+you. Point `facePath` at the skin and the engine writes the right one:
+```jsonc
+{ "name": "Hunt", "type": "Node3D",
+  "script": { "name": "Chase",
+    "props": { "target": "/root/Player", "moveParent": true, "facePath": "../Skin" } } }
+```
+It is opt-in (empty default turns nothing), it is the exact math and the exact
+`turnSpeed` units the controller uses, and `bunx incanto-feel` verifies it:
+`facing: /Guard/Skin faces its travel (dot 1.00)`. In 2D it writes the scalar
+`rotation` (`atan2(dy, dx)`) — right for top-down, so a PLATFORMER that faces
+with `flipX` should leave `facePath` empty.
 **A character body chases through the level, not through walls.** When the node
 being moved is a `CharacterBody2D`/`3D`, `Chase` (and `Patrol`) move it with
 `moveAndSlide()`, so it collides and slides like any character. A plain
@@ -431,6 +461,114 @@ geometry it used to walk through. When enemies must find their way around a
 level, that is what `buildTerrainNav` + `findPath` + `PathFollow` are for (see
 `incanto-building-3d-games.md`).
+## An enemy that changes its mind (`enabled`)
+An enemy that patrols until it spots you and then chases is the most ordinary AI
+there is, and it used to be inexpressible: a node carries ONE behavior, and
+nothing could stop one. `ZombieAI` exists because of that — it is `Wander` and
+`Chase` FUSED into a single class, which solves exactly one pair and no others.
+**Every behavior has `enabled`** (default `true`), plus `enable()` and
+`disable()` methods. They are methods, so a CONNECTION can call them — which is
+the whole point. Give the guard one child per state, sleep the ones that are not
+running, and the state machine is scene JSON:
+```jsonc
+{ "name": "Guard", "type": "CharacterBody3D", "groups": ["enemy"],
+  "script": { "name": "Health", "props": { "max": 40 } },
+  "children": [
+    { "name": "Skin", "type": "ModelInstance3D", "props": { "model": "$guard" } },
+    { "name": "Walk", "type": "Node3D",
+      "script": { "name": "Patrol",
+        "props": { "points": ["%PostA", "%PostB"], "speed": 2,
+                   "moveParent": true, "facePath": "../Skin" } } },
+    { "name": "Hunt", "type": "Node3D",
+      "script": { "name": "Chase",
+        "props": { "target": "/root/Player", "speed": 5, "stopRange": 1.4,
+                   "moveParent": true, "facePath": "../Skin", "enabled": false } } }
+] }
+```
+```jsonc
+"connections": [
+  { "signal": "spotted",    "from": "Guard/Eyes", "to": "Guard/Walk", "handler": "disable" },
+  { "signal": "spotted",    "from": "Guard/Eyes", "to": "Guard/Hunt", "handler": "enable"  },
+  { "signal": "lostTarget", "from": "Guard/Hunt", "to": "Guard/Hunt", "handler": "disable" },
+  { "signal": "lostTarget", "from": "Guard/Hunt", "to": "Guard/Walk", "handler": "enable"  }
+]
+```
+That is a two-state guard, with health, that walks a route, turns to face where
+it is going, gives up when you break away, and goes back to its patrol — in
+zero TypeScript.
+**Asleep is not detached.** A disabled behavior keeps its props and everything
+it had accumulated, stays reachable as `node.behavior`, keeps its signal
+connections, and still saves through `serialize()`. Only `update`/`fixedUpdate`
+pause. The lifecycle hooks are never gated: they are structural, they fire once,
+and a behavior that skipped its own `onReady` would wake up uninitialized —
+so a behavior authored `enabled: false` is fully set up and simply idle.
+**OFF is explicit.** The tick is gated on `enabled !== false`, so a hand-attached
+object that never heard of the prop still runs. A behavior silently not running
+is a far worse failure than one running when it was meant to sleep.
+From TypeScript it is the same switch: `this.getNode('../Hunt').behavior.enable()`.
+## FaceTarget
+Turn toward the nearest thing in a group and say when you are pointed at it —
+turrets, sentry guns, security cameras, an NPC that watches you walk past.
+`Chase` finds the nearest target and turns toward it, and then MOVES, which is
+the one thing a turret must not do; `Patrol`/`Chase`'s `facePath` only turns as
+a side effect of locomotion, so a stationary node could not use it. A tower
+defense built before this hand-wrote acquisition and the aim gate.
+| Prop | Default | Meaning |
+|---|---|---|
+| `targetGroup` | `""` | group to acquire from — nearest live member wins (required) |
+| `range` | `0` | only acquire within this distance (0 = anywhere) |
+| `facePath` | `""` | node to TURN (usually a skin); empty turns its own node |
+| `turnSpeed` | `6` | turn rate rad/s; 100 is an instant snap |
+| `aimTolerance` | `6` | degrees of slop that still counts as pointed at it |
+Signals: `acquired(node)` · `lostTarget` · **`aimed`** · `lostAim`
+```jsonc
+{ "name": "Turret", "type": "Node3D",
+  "script": { "name": "FaceTarget",
+    "props": { "targetGroup": "enemy", "range": 12, "facePath": "../Barrel" } } }
+```
+**`aimed` is the useful one.** "Only fire while actually pointed at it" becomes a
+wire instead of an angle comparison every caller repeats and one caller forgets.
+`onTarget` and `target` are readable from TypeScript for the rest.
+## Currency
+Money you can spend. `ScoreKeeper` is a SCORE — it counts up, it has no spend,
+no affordability question, and its counter already drives the win condition, so
+every shop, build mode, upgrade tree and economy game wrote its own wallet.
+| Prop | Default | Meaning |
+|---|---|---|
+| `amount` | `0` | what you start with |
+| `max` | `0` | ceiling (0 = none) |
+Signals: `changed(amount)` · `earned(gain)` · `spent(cost)` · **`refused(cost)`**
+Methods: `spend(cost) -> boolean` · `earn(gain)` · `canAfford(cost)` · `setAmount(n)`
+```ts
+if (!wallet.spend(TOWER_COST)) return;   // `refused` already fired for the HUD
+placeTower(pad);
+```
+`spend` returns whether it went through and emits `refused` when it did not, so
+"you cannot afford that" is one wire to a banner. It saves through `serialize()`
+like `Health` and `ScoreKeeper`.
 ## Wander
 Seeded random roaming inside a circle around the spawn point — idle critters,
@@ -452,9 +590,13 @@ run (replayable, test-stable).
 The staple monster AI in ONE behavior: SHAMBLE around on its own, then LOCK ON and
 CHARGE `aggroTarget` (the player) once it wanders within `aggroRange` — giving up
-again past `deAggroRange` (hysteresis, no boundary flicker). Use this instead of
-`Wander`+`Chase` (a node carries ONE behavior, so they can't co-exist) whenever you
-want enemies that idle/roam until the player gets close, then rush in.
+again past `deAggroRange` (hysteresis, no boundary flicker). Use this whenever you want enemies that idle/roam until the player gets close,
+then rush in — it is one behavior, so it needs no wiring at all.
+For any OTHER pair (patrol-then-chase, guard-then-flee, the state machine your
+game actually wants), compose them yourself with `enabled` — see
+"An enemy that changes its mind" below. This behavior is the fused
+`Wander`+`Chase` from when that was the only way.
 | Prop | Default | Meaning |
 |---|---|---|
@@ -679,8 +821,35 @@ Signals: `waveStarted(index)` · `waveCleared(index)` · `allCleared`
 ## Projectile
 Straight-line, constant-velocity motion — bullets, arrows, thrown rocks. Pure
-MOVEMENT by design: **compose** it with `DamageOnContact` (deal damage), `Lifetime`
-(auto-despawn) and an Area collider on the SAME node — don't conflate them.
+MOVEMENT by design: **compose** it with `DamageOnContact` (deal damage) and
+`Lifetime` (auto-despawn) — don't conflate them. A node carries ONE script, so
+those go on CHILD nodes and each one sets **`freeParent: true`** so it frees the
+BULLET rather than itself. Copy this:
+```jsonc
+{ "name": "Bullet", "type": "Node3D",
+  "script": { "name": "Projectile", "props": { "speed": 30 } },
+  "children": [
+    { "name": "Hit", "type": "Area3D",
+      "props": { "collider": { "shape": "sphere", "radius": 0.2 } },
+      "script": { "name": "DamageOnContact",
+        "props": { "amount": 10, "targetGroup": "enemy",
+                   "destroySelf": true, "freeParent": true } } },
+    { "name": "Life", "type": "Node3D",
+      "script": { "name": "Lifetime", "props": { "seconds": 2, "freeParent": true } } }
+] }
+```
+**Without `freeParent` the bullet never dies.** Both behaviors used to free only
+their own node, so the hitbox and the timer removed THEMSELVES and the bullet
+flew on forever — one leaked node per shot, damaging exactly once, with no error.
+Measured on a tower defense built from the published package:
+```
+t=0.58 bullet z=2.92  | Dmg child: alive | Life child: gone  | foe hp: 100
+t=1.18 bullet z=5.92  | Dmg child: gone  | Life child: gone  | foe hp: 90
+t=2.88 bullet z=14.42 | (both gone)      | foe hp: 90   <- still flying
+```
 `direction` is a vector OR `'forward'` (from the node `rotation`); it's a
 union-typed prop so its default is `null` (= `'forward'`).
@@ -703,10 +872,9 @@ as a gun that simply never hits anything.) In 2D `rotation` is a scalar and
 { "name": "Bullet", "type": "Area2D", "props": { "rotation": 0 },
   "script": { "name": "Projectile", "props": { "speed": 600, "direction": "forward" } } }
 ```
-> Compose: add `DamageOnContact` and `Lifetime` to make it actually hurt and
-> despawn. One node carries one script, so attach `Projectile` here and wire the
-> others onto sibling/child Area nodes (or use a Spawner that clones a fully-built
-> bullet template).
+> Compose: add `DamageOnContact` and `Lifetime` on CHILD nodes, both with
+> `freeParent: true`, as shown above — or use a Spawner that clones a
+> fully-built bullet template.
 ---

package/skills/incanto-node-reference.md CHANGED Viewed

@@ -290,6 +290,7 @@ Signals: `movementStateChanged(state)`
 | `airControl` | `0.2` | number |
 | `fallGravity` | `2.5` | number |
 | `floatHeight` | `0.01` | number |
+| `stepHeight` | `0.35` | number |
 | `mouseLook` | `true` | boolean |
 | `zoomMin` | `0` | number |
 | `zoomMax` | `0` | number |
@@ -446,6 +447,7 @@ Signals: `movementStateChanged(state)`
 | `length` | `0` | number |
 | `stiffness` | `50` | number |
 | `damping` | `5` | number |
+| `collide` | `null` | null |
 ## `Joint3D` — `incanto/3d`
@@ -466,6 +468,7 @@ Signals: `movementStateChanged(state)`
 | `length` | `0` | number |
 | `stiffness` | `50` | number |
 | `damping` | `5` | number |
+| `collide` | `null` | null |
 ## `Label` — `incanto/2d`
@@ -760,6 +763,7 @@ Signals: `triggerEnter(other)` · `triggerExit(other)`
 | `friction` | `0.5` | number |
 | `restitution` | `0` | number |
 | `linearVelocity` | `[0,0,0]` | array |
+| `angularVelocity` | `[0,0,0]` | array |
 Signals: `triggerEnter(other)` · `triggerExit(other)`
@@ -1327,6 +1331,7 @@ wire their signals through scene `connections`. Full guide: `incanto-gameplay-be
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `water` | `""` | node path |
 | `draft` | `0.35` | number |
 | `stiffness` | `3` | number |
@@ -1342,17 +1347,21 @@ Signals: `submerged` · `surfaced`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `falloff` | `0.28` | number |
 ### `Chase`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `target` | `""` | node path |
 | `speed` | `60` | number |
 | `stopRange` | `0` | number |
 | `loseRange` | `0` | number |
 | `moveParent` | `false` | boolean |
+| `facePath` | `""` | node path |
+| `turnSpeed` | `100` | number |
 Signals: `reachedTarget` · `lostTarget`
@@ -1360,9 +1369,9 @@ Signals: `reachedTarget` · `lostTarget`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `button` | `0` | number |
 | `maxDistance` | `0` | number |
-| `enabled` | `true` | boolean |
 Signals: `clicked` · `hovered` · `unhovered`
@@ -1370,19 +1379,32 @@ Signals: `clicked` · `hovered` · `unhovered`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `group` | `"player"` | string |
 Signals: `totalChanged(total)`
+### `Currency`
+| Prop | Default | Kind |
+|---|---|---|
+| `enabled` | `true` | boolean |
+| `amount` | `0` | number |
+| `max` | `0` | number |
+Signals: `changed` · `earned` · `spent` · `refused`
 ### `DamageOnContact`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `amount` | `10` | number |
 | `targetGroup` | `""` | string |
 | `oncePerTarget` | `true` | boolean |
 | `repeatEvery` | `0` | number |
 | `destroySelf` | `false` | boolean |
+| `freeParent` | `false` | boolean |
 Signals: `dealtDamage(amount, target)`
@@ -1390,6 +1412,7 @@ Signals: `dealtDamage(amount, target)`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `daySeconds` | `240` | number |
 | `startHour` | `10` | number |
 | `maxSunElevationDeg` | `55` | number |
@@ -1398,10 +1421,24 @@ Signals: `dealtDamage(amount, target)`
 Signals: `dayPhaseChanged`
+### `FaceTarget`
+| Prop | Default | Kind |
+|---|---|---|
+| `enabled` | `true` | boolean |
+| `targetGroup` | `""` | string |
+| `range` | `0` | number |
+| `facePath` | `""` | node path |
+| `turnSpeed` | `6` | number |
+| `aimTolerance` | `6` | number |
+Signals: `acquired` · `lostTarget` · `aimed` · `lostAim`
 ### `FloatAway`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `rise` | `1` | number |
 | `seconds` | `0.7` | number |
 | `hold` | `0.3` | number |
@@ -1412,6 +1449,7 @@ Signals: `dayPhaseChanged`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `target` | `""` | node path |
 | `offset` | `[]` | array |
 | `smoothing` | `0` | number |
@@ -1421,6 +1459,7 @@ Signals: `dayPhaseChanged`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `restartAction` | `"restart"` | string |
 | `pauseAction` | `"pause"` | string |
 | `freezeOnEnd` | `true` | boolean |
@@ -1433,6 +1472,7 @@ Signals: `flowChanged`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `max` | `100` | number |
 | `regenPerSec` | `0` | number |
 | `invulnerableFor` | `0` | number |
@@ -1444,6 +1484,7 @@ Signals: `damaged(amount, current)` · `healed(amount, current)` · `died` · `r
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `action` | `"interact"` | string |
 | `range` | `2` | number |
 | `actorGroup` | `"player"` | string |
@@ -1454,8 +1495,10 @@ Signals: `interacted(actor)`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `seconds` | `1` | number |
 | `startOnSignal` | `false` | boolean |
+| `freeParent` | `false` | boolean |
 Signals: `expired`
@@ -1463,6 +1506,7 @@ Signals: `expired`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `to` | `[]` | array |
 | `duration` | `1` | number |
 | `ease` | `"easeInOut"` | one of: `linear` `easeIn` `easeOut` `easeInOut` |
@@ -1474,6 +1518,7 @@ Signals: `arrived`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `axis` | `"y"` | one of: `x` `y` `z` |
 | `amplitude` | `1` | number |
 | `frequency` | `1` | number |
@@ -1483,6 +1528,7 @@ Signals: `arrived`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `speed` | `120` | number |
 | `loop` | `false` | boolean |
@@ -1492,11 +1538,15 @@ Signals: `waypointReached` · `arrived`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `points` | `[]` | array |
 | `speed` | `60` | number |
 | `loop` | `true` | boolean |
 | `mode` | `"loop"` | one of: `loop` `pingpong` |
 | `pauseAt` | `0` | number |
+| `moveParent` | `false` | boolean |
+| `facePath` | `""` | node path |
+| `turnSpeed` | `100` | number |
 Signals: `reachedPoint(index)`
@@ -1504,6 +1554,7 @@ Signals: `reachedPoint(index)`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `value` | `1` | number |
 | `kind` | `"coin"` | string |
 | `collectorGroup` | `"player"` | string |
@@ -1514,6 +1565,7 @@ Signals: `collected(value, other)`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `speed` | `300` | number |
 | `direction` | `null` | null |
 | `gravity` | `0` | number |
@@ -1522,6 +1574,7 @@ Signals: `collected(value, other)`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `game` | `"game"` | string |
 | `slot` | `"1"` | string |
 | `label` | `""` | string |
@@ -1535,6 +1588,7 @@ Signals: `saved` · `restored` · `noSave` · `hasSave`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `score` | `0` | number |
 | `lives` | `0` | number |
 | `scoreToWin` | `0` | number |
@@ -1545,6 +1599,7 @@ Signals: `scoreChanged(score)` · `won` · `lost` · `lifeLost(lives)`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `prefab` | `""` | node path |
 | `interval` | `1` | number |
 | `max` | `0` | number |
@@ -1558,6 +1613,7 @@ Signals: `spawned(node)` · `finished`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `speed` | `40` | number |
 | `radius` | `50` | number |
 | `changeEvery` | `2` | number |
@@ -1566,6 +1622,7 @@ Signals: `spawned(node)` · `finished`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `waves` | `[]` | array |
 | `autoStart` | `true` | boolean |
@@ -1575,6 +1632,7 @@ Signals: `waveStarted(index)` · `waveCleared(index)` · `allCleared`
 | Prop | Default | Kind |
 |---|---|---|
+| `enabled` | `true` | boolean |
 | `aggroTarget` | `""` | node path |
 | `aggroRange` | `12` | number |
 | `deAggroRange` | `0` | number |