incanto 0.69.0 → 0.71.0

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

@@ -11,24 +11,14 @@
       "turbidity": 3.2,
       "rayleigh": 2
     },
-    "fog": {
-      "near": 40,
-      "far": 180
-    },
-    "shadows": {
-      "mapSize": 2048
-    },
+    "fog": { "near": 40, "far": 180 },
+    "shadows": { "mapSize": 2048 },
     "exposure": 1.05,
-    "ambient": {
-      "color": "#bcd0f0",
-      "intensity": 0.28
-    },
+    "ambient": { "color": "#bcd0f0", "intensity": 0.28 },
     "iblIntensity": 0.8,
     "background": "#243047"
   },
-  "physics": {
-    "gravity": [0, -9.81, 0]
-  },
+  "physics": { "gravity": [0, -9.81, 0] },
   "input": {
     "move": {
       "type": "vector2",
@@ -39,30 +29,12 @@
         "right": ["KeyD", "ArrowRight"]
       }
     },
-    "jump": {
-      "type": "button",
-      "keys": ["Space"]
-    },
-    "sprint": {
-      "type": "button",
-      "keys": ["ShiftLeft", "ShiftRight"]
-    },
-    "fire": {
-      "type": "button",
-      "keys": ["Mouse0", "KeyF"]
-    },
-    "reload": {
-      "type": "button",
-      "keys": ["KeyR"]
-    },
-    "pause": {
-      "type": "button",
-      "keys": ["Escape"]
-    },
-    "restart": {
-      "type": "button",
-      "keys": ["KeyR"]
-    }
+    "jump": { "type": "button", "keys": ["Space"] },
+    "sprint": { "type": "button", "keys": ["ShiftLeft", "ShiftRight"] },
+    "fire": { "type": "button", "keys": ["Mouse0", "KeyF"] },
+    "reload": { "type": "button", "keys": ["KeyR"] },
+    "pause": { "type": "button", "keys": ["Escape"] },
+    "restart": { "type": "button", "keys": ["Enter"] }
   },
   "assets": {
     "characters/base": {
@@ -93,22 +65,12 @@
   "root": {
     "name": "Game",
     "type": "Node",
-    "script": {
-      "name": "ScoreKeeper",
-      "props": {
-        "lives": 3
-      }
-    },
+    "script": { "name": "ScoreKeeper", "props": { "lives": 3 } },
     "children": [
       {
         "name": "Flow",
         "type": "Node",
-        "script": {
-          "name": "GameFlow",
-          "props": {
-            "pausePanelPath": "%PauseMenu"
-          }
-        },
+        "script": { "name": "GameFlow", "props": { "pausePanelPath": "%PauseMenu" } },
         "uid": "n_ofc39vdgsw837grt"
       },
       {
@@ -119,10 +81,7 @@
             "name": "Floor",
             "type": "StaticBody3D",
             "props": {
-              "collider": {
-                "shape": "box",
-                "size": [48, 0.1, 48]
-              },
+              "collider": { "shape": "box", "size": [48, 0.1, 48] },
               "position": [0, -0.05, 0]
             },
             "children": [
@@ -132,10 +91,7 @@
                 "props": {
                   "mesh": "box",
                   "size": [48, 0.1, 48],
-                  "material": {
-                    "color": "#3a4253",
-                    "roughness": 1
-                  },
+                  "material": { "color": "#3a4253", "roughness": 1 },
                   "receiveShadow": true
                 }
               }
@@ -145,10 +101,7 @@
             "name": "Wall1",
             "type": "StaticBody3D",
             "props": {
-              "collider": {
-                "shape": "box",
-                "size": [49, 3, 0.5]
-              },
+              "collider": { "shape": "box", "size": [49, 3, 0.5] },
               "position": [0, 1.5, -24.25]
             },
             "children": [
@@ -158,10 +111,7 @@
                 "props": {
                   "mesh": "box",
                   "size": [49, 3, 0.5],
-                  "material": {
-                    "color": "#4a5468",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#4a5468", "roughness": 0.9 },
                   "receiveShadow": true
                 }
               }
@@ -171,10 +121,7 @@
             "name": "Wall2",
             "type": "StaticBody3D",
             "props": {
-              "collider": {
-                "shape": "box",
-                "size": [49, 3, 0.5]
-              },
+              "collider": { "shape": "box", "size": [49, 3, 0.5] },
               "position": [0, 1.5, 24.25]
             },
             "children": [
@@ -184,10 +131,7 @@
                 "props": {
                   "mesh": "box",
                   "size": [49, 3, 0.5],
-                  "material": {
-                    "color": "#4a5468",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#4a5468", "roughness": 0.9 },
                   "receiveShadow": true
                 }
               }
@@ -197,10 +141,7 @@
             "name": "Wall3",
             "type": "StaticBody3D",
             "props": {
-              "collider": {
-                "shape": "box",
-                "size": [0.5, 3, 48]
-              },
+              "collider": { "shape": "box", "size": [0.5, 3, 48] },
               "position": [-24.25, 1.5, 0]
             },
             "children": [
@@ -210,10 +151,7 @@
                 "props": {
                   "mesh": "box",
                   "size": [0.5, 3, 48],
-                  "material": {
-                    "color": "#4a5468",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#4a5468", "roughness": 0.9 },
                   "receiveShadow": true
                 }
               }
@@ -223,10 +161,7 @@
             "name": "Wall4",
             "type": "StaticBody3D",
             "props": {
-              "collider": {
-                "shape": "box",
-                "size": [0.5, 3, 48]
-              },
+              "collider": { "shape": "box", "size": [0.5, 3, 48] },
               "position": [24.25, 1.5, 0]
             },
             "children": [
@@ -236,10 +171,7 @@
                 "props": {
                   "mesh": "box",
                   "size": [0.5, 3, 48],
-                  "material": {
-                    "color": "#4a5468",
-                    "roughness": 0.9
-                  },
+                  "material": { "color": "#4a5468", "roughness": 0.9 },
                   "receiveShadow": true
                 }
               }
@@ -249,10 +181,7 @@
             "name": "Cover1",
             "type": "StaticBody3D",
             "props": {
-              "collider": {
-                "shape": "box",
-                "size": [2, 1.2, 2]
-              },
+              "collider": { "shape": "box", "size": [2, 1.2, 2] },
               "position": [-8, 0.6, -8]
             },
             "children": [
@@ -262,11 +191,7 @@
                 "props": {
                   "mesh": "box",
                   "size": [2, 1.2, 2],
-                  "material": {
-                    "color": "#5b6678",
-                    "roughness": 0.85,
-                    "metalness": 0.1
-                  },
+                  "material": { "color": "#5b6678", "roughness": 0.85, "metalness": 0.1 },
                   "castShadow": true,
                   "receiveShadow": true
                 }
@@ -277,10 +202,7 @@
             "name": "Cover2",
             "type": "StaticBody3D",
             "props": {
-              "collider": {
-                "shape": "box",
-                "size": [2, 1.2, 2]
-              },
+              "collider": { "shape": "box", "size": [2, 1.2, 2] },
               "position": [8, 0.6, -8]
             },
             "children": [
@@ -290,11 +212,7 @@
                 "props": {
                   "mesh": "box",
                   "size": [2, 1.2, 2],
-                  "material": {
-                    "color": "#5b6678",
-                    "roughness": 0.85,
-                    "metalness": 0.1
-                  },
+                  "material": { "color": "#5b6678", "roughness": 0.85, "metalness": 0.1 },
                   "castShadow": true,
                   "receiveShadow": true
                 }
@@ -305,10 +223,7 @@
             "name": "Pillar1",
             "type": "StaticBody3D",
             "props": {
-              "collider": {
-                "shape": "box",
-                "size": [1.1, 4, 1.1]
-              },
+              "collider": { "shape": "box", "size": [1.1, 4, 1.1] },
               "position": [-14, 2, 6]
             },
             "children": [
@@ -318,10 +233,7 @@
                 "props": {
                   "mesh": "box",
                   "size": [1.1, 4, 1.1],
-                  "material": {
-                    "color": "#454f61",
-                    "roughness": 0.95
-                  },
+                  "material": { "color": "#454f61", "roughness": 0.95 },
                   "castShadow": true
                 }
               }
@@ -331,10 +243,7 @@
             "name": "Pillar2",
             "type": "StaticBody3D",
             "props": {
-              "collider": {
-                "shape": "box",
-                "size": [1.1, 4, 1.1]
-              },
+              "collider": { "shape": "box", "size": [1.1, 4, 1.1] },
               "position": [14, 2, 6]
             },
             "children": [
@@ -344,10 +253,7 @@
                 "props": {
                   "mesh": "box",
                   "size": [1.1, 4, 1.1],
-                  "material": {
-                    "color": "#454f61",
-                    "roughness": 0.95
-                  },
+                  "material": { "color": "#454f61", "roughness": 0.95 },
                   "castShadow": true
                 }
               }
@@ -357,10 +263,7 @@
             "name": "Ramp",
             "type": "StaticBody3D",
             "props": {
-              "collider": {
-                "shape": "box",
-                "size": [5, 0.6, 3]
-              },
+              "collider": { "shape": "box", "size": [5, 0.6, 3] },
               "position": [0, 0.3, -14]
             },
             "children": [
@@ -370,10 +273,7 @@
                 "props": {
                   "mesh": "box",
                   "size": [5, 0.6, 3],
-                  "material": {
-                    "color": "#5b6678",
-                    "roughness": 0.85
-                  },
+                  "material": { "color": "#5b6678", "roughness": 0.85 },
                   "castShadow": true,
                   "receiveShadow": true
                 }
@@ -394,11 +294,7 @@
           {
             "name": "FillLight",
             "type": "DirectionalLight3D",
-            "props": {
-              "position": [-38, 36, -28],
-              "intensity": 0.4,
-              "color": "#b9d4ff"
-            }
+            "props": { "position": [-38, 36, -28], "intensity": 0.4, "color": "#b9d4ff" }
           }
         ]
       },
@@ -410,19 +306,9 @@
           "position": [0, 1.4, 18],
           "fixedRotation": true,
           "friction": 0,
-          "collider": {
-            "shape": "capsule",
-            "radius": 0.34,
-            "height": 1
-          }
-        },
-        "script": {
-          "name": "Health",
-          "props": {
-            "max": 100,
-            "invulnerableFor": 0.6
-          }
+          "collider": { "shape": "capsule", "radius": 0.34, "height": 1 }
         },
+        "script": { "name": "Health", "props": { "max": 100, "invulnerableFor": 0.6 } },
         "children": [
           {
             "name": "Controller",
@@ -434,11 +320,11 @@
               "maxSpeed": 4.2,
               "sprintMultiplier": 1.7,
               "pitchMin": -0.5,
-              "pitchMax": 1.1
-            },
-            "script": {
-              "name": "Shoot"
+              "pitchMax": 1.1,
+              "coyoteSeconds": 0.12,
+              "jumpBufferSeconds": 0.15
             },
+            "script": { "name": "Shoot" },
             "uid": "n_ltyrn17s5l9tizgp"
           },
           {
@@ -455,9 +341,7 @@
           {
             "name": "Muzzle",
             "type": "Node3D",
-            "props": {
-              "position": [0, 0.4, 0.4]
-            },
+            "props": { "position": [0, 0.4, 0.4] },
             "children": [
               {
                 "name": "ShotSfx",
@@ -484,20 +368,12 @@
               {
                 "name": "EmptySfx",
                 "type": "AudioPlayer",
-                "props": {
-                  "preset": "blip",
-                  "volume": 0.4,
-                  "pitch": 0.7
-                }
+                "props": { "preset": "blip", "volume": 0.4, "pitch": 0.7 }
               },
               {
                 "name": "Flash",
                 "type": "OmniLight3D",
-                "props": {
-                  "color": "#ffd27f",
-                  "intensity": 0,
-                  "range": 7
-                }
+                "props": { "color": "#ffd27f", "intensity": 0, "range": 7 }
               }
             ]
           }
@@ -507,49 +383,20 @@
       {
         "name": "Camera",
         "type": "Camera3D",
-        "props": {
-          "position": [0, 2.6, 23],
-          "fov": 70,
-          "current": true,
-          "far": 400
-        }
-      },
-      {
-        "name": "HurtSfx",
-        "type": "AudioPlayer",
-        "props": {
-          "preset": "hurt",
-          "volume": 0.6
-        }
+        "props": { "position": [0, 2.6, 23], "fov": 70, "current": true, "far": 400 }
       },
+      { "name": "HurtSfx", "type": "AudioPlayer", "props": { "preset": "hurt", "volume": 0.6 } },
       {
         "name": "Spawner",
         "type": "Node3D",
-        "props": {
-          "position": [0, 0, 0]
-        },
+        "props": { "position": [0, 0, 0] },
         "script": {
           "name": "WaveSpawner",
           "props": {
             "waves": [
-              {
-                "prefab": "EnemyTemplate",
-                "count": 4,
-                "interval": 1.1,
-                "delayBefore": 2
-              },
-              {
-                "prefab": "EnemyTemplate",
-                "count": 6,
-                "interval": 0.9,
-                "delayBefore": 3
-              },
-              {
-                "prefab": "EnemyTemplate",
-                "count": 8,
-                "interval": 0.7,
-                "delayBefore": 3
-              }
+              { "prefab": "EnemyTemplate", "count": 4, "interval": 1.1, "delayBefore": 2 },
+              { "prefab": "EnemyTemplate", "count": 6, "interval": 0.9, "delayBefore": 3 },
+              { "prefab": "EnemyTemplate", "count": 8, "interval": 0.7, "delayBefore": 3 }
             ]
           }
         },
@@ -561,19 +408,9 @@
             "props": {
               "position": [0, 0.95, -20],
               "visible": false,
-              "collider": {
-                "shape": "capsule",
-                "radius": 0.4,
-                "height": 1.1
-              }
-            },
-            "script": {
-              "name": "Health",
-              "props": {
-                "max": 30,
-                "freeOnDeath": true
-              }
+              "collider": { "shape": "capsule", "radius": 0.4, "height": 1.1 }
             },
+            "script": { "name": "Health", "props": { "max": 30, "freeOnDeath": true } },
             "children": [
               {
                 "name": "Skin",
@@ -597,11 +434,7 @@
                   "mesh": "sphere",
                   "size": [0.12, 0.12, 0.12],
                   "position": [0, 0.55, 0.32],
-                  "material": {
-                    "color": "#ffec5c",
-                    "emissive": "#ffd000",
-                    "emissiveIntensity": 2
-                  }
+                  "material": { "color": "#ffec5c", "emissive": "#ffd000", "emissiveIntensity": 2 }
                 }
               },
               {
@@ -621,12 +454,7 @@
               {
                 "name": "Hit",
                 "type": "Area3D",
-                "props": {
-                  "collider": {
-                    "shape": "sphere",
-                    "radius": 1.5
-                  }
-                },
+                "props": { "collider": { "shape": "sphere", "radius": 1.5 } },
                 "script": {
                   "name": "DamageOnContact",
                   "props": {
@@ -674,9 +502,7 @@
       {
         "name": "Hud",
         "type": "Node",
-        "script": {
-          "name": "HudUpdater"
-        },
+        "script": { "name": "HudUpdater" },
         "uid": "n_ihn045f8ag1zraa2"
       },
       {
@@ -686,30 +512,27 @@
           {
             "name": "PauseMenu",
             "type": "UiPanel",
-            "props": {
-              "anchor": "center",
-              "layout": "column",
-              "gap": 10,
-              "padding": 18
-            },
+            "props": { "anchor": "center", "layout": "column", "gap": 10, "padding": 18 },
             "children": [
               {
                 "name": "PausedTitle",
                 "type": "UiText",
-                "props": {
-                  "text": "Paused",
-                  "size": 24
-                }
+                "props": { "text": "Paused", "size": 24 }
               },
               {
                 "name": "ResumeHint",
                 "type": "UiText",
                 "props": {
-                  "text": "Esc to resume · R to restart",
+                  "text": "Esc to resume · Enter to restart",
                   "size": 13,
                   "color": "#c9d2dd"
                 }
-              }
+              },
+              { "name": "Volume", "type": "UiVolumeSlider", "uid": "n_5p4124fbnjxx8s0c" },
+              { "name": "Mute", "type": "UiMuteToggle", "uid": "n_e1lyn3mvsy3vj2qr" },
+              { "name": "Quality", "type": "UiQualitySelect", "uid": "n_35r1h71i75yft3ex" },
+              { "name": "RenderScale", "type": "UiRenderScaleSelect", "uid": "n_emg840df89fqsriw" },
+              { "name": "FrameCap", "type": "UiFrameCapSelect", "uid": "n_mgqwgghn0bx900ip" }
             ]
           }
         ]
@@ -718,29 +541,9 @@
     "uid": "n_h46qaejxdqadqc1c"
   },
   "connections": [
-    {
-      "signal": "died",
-      "from": "Player",
-      "to": "/root",
-      "handler": "loseLife"
-    },
-    {
-      "signal": "lifeLost",
-      "from": "/root",
-      "to": "Player",
-      "handler": "reviveFull"
-    },
-    {
-      "signal": "damaged",
-      "from": "Player",
-      "to": "HurtSfx",
-      "handler": "play"
-    },
-    {
-      "signal": "allCleared",
-      "from": "Spawner",
-      "to": "Hud",
-      "handler": "onAllCleared"
-    }
+    { "signal": "died", "from": "Player", "to": "/root", "handler": "loseLife" },
+    { "signal": "lifeLost", "from": "/root", "to": "Player", "handler": "reviveFull" },
+    { "signal": "damaged", "from": "Player", "to": "HurtSfx", "handler": "play" },
+    { "signal": "allCleared", "from": "Spawner", "to": "Hud", "handler": "onAllCleared" }
   ]
 }

package/templates-app/tps-3d/src/main.ts

@@ -1,7 +1,8 @@
 /**
  * Vanguard — a 3D THIRD-PERSON shooter built on Incanto. Move with WASD, look
  * with the mouse (click locks the pointer), Shift to sprint, Space to jump,
- * left-click / F to fire your hitscan rifle, R to reload. The camera rides over
+ * left-click / F to fire your hitscan rifle, R to reload, Enter to restart once
+ * the mission ends. The camera rides over
  * your soldier's shoulder (CharacterController3D `view: 'free'`); the crosshair
  * is where you shoot. Clear three waves of chasing enemies to SECURE THE AREA;
  * let them drain your HP to 0 and the MISSION FAILS.
@@ -35,8 +36,18 @@ const canvas = document.querySelector('canvas') as HTMLCanvasElement;
 // createGame3D boots everything: register (gameplay behaviors auto-registered) →
 // load → physics (auto; the scene has bodies) → keyboard + pointer-lock look →
 // renderer → start. We pass the two custom behaviors.
+/** Dev-only surfaces: the ☰ debug overlay, and the editor behind it. */
+const DEBUG = import.meta.env.VITE_INCANTO_DEBUG === '1';
+
 const game = await createGame3D({
-  debug: import.meta.env.VITE_INCANTO_DEBUG === '1',
+  debug: DEBUG,
+  // The editor's 📚 buttons, served by `incantoLibrary()` in vite.config.ts.
+  // BOTH halves are the opt-in, and this half was missing from every shipped
+  // template: the plugin alone left a vite config whose own comment promised
+  // "the agent8 asset catalog behind the 📚 buttons" and no button anywhere.
+  // Gated on the same flag, because `editor` DEFAULTS to `debug` and an object
+  // here would turn the editor on in a production build.
+  editor: DEBUG && { library: true },
   canvas,
   scene: sceneJson,
   behaviors: { Shoot, HudUpdater },

package/templates-app/tps-3d/tsconfig.json

@@ -9,5 +9,5 @@
     "resolveJsonModule": true,
     "types": ["vite/client", "node"]
   },
-  "include": ["src", "verify.ts"]
+  "include": ["src", "verify.ts", "vite.config.ts"]
 }