create-threenative 0.2.1 → 0.2.3

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 (343) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +10 -2
  3. package/agent-docs/asset-mcp-loop.md +33 -0
  4. package/agent-docs/ctx-surface.md +69 -0
  5. package/agent-docs/engine-capabilities.md +4 -0
  6. package/agent-docs/framework-blocks-you.md +60 -0
  7. package/agent-docs/look-at-it-and-budget-the-look.md +27 -0
  8. package/agent-docs/performance-default.md +42 -0
  9. package/agent-docs/pixel-budget.md +20 -0
  10. package/agent-docs/playtest-fail-closed.md +23 -0
  11. package/agent-docs/references/assertion-reference.md +652 -0
  12. package/agent-docs/references/capability-reference.md +3279 -0
  13. package/agent-docs/references/capture-the-frame.md +53 -0
  14. package/agent-docs/references/ctx-cookbook.md +51 -0
  15. package/agent-docs/references/debug-surface.md +63 -0
  16. package/agent-docs/references/finding-assets.md +147 -0
  17. package/agent-docs/references/gameplay-recipes.md +54 -0
  18. package/agent-docs/references/menu-screens.md +69 -0
  19. package/agent-docs/references/mobile-memory-budget.md +87 -0
  20. package/agent-docs/references/sculpt-from-a-reference.md +39 -0
  21. package/agent-docs/references/visual-baseline.md +133 -0
  22. package/agent-docs/references/webview-ui.md +113 -0
  23. package/agent-docs/sculpt-loop.md +16 -0
  24. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  25. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  26. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  27. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  28. package/agent-files/.threenative/agents/builder.md +32 -0
  29. package/agent-files/.threenative/agents/verifier.md +31 -0
  30. package/agent-files/AGENT-ROLES.md +26 -0
  31. package/capabilities.json +3542 -0
  32. package/dist/index.d.ts +191 -3
  33. package/dist/index.js +1707 -73
  34. package/dist/threenative.d.ts +9 -2
  35. package/dist/threenative.js +1825 -148
  36. package/package.json +30 -6
  37. package/template-assets/loading.ts +315 -0
  38. package/template-assets/patches/three@0.185.1.patch +287 -0
  39. package/templates/action-rpg/.codex/config.toml +15 -0
  40. package/templates/action-rpg/.mcp.json +6 -2
  41. package/templates/action-rpg/AGENTS.md +370 -6
  42. package/templates/action-rpg/CLAUDE.md +370 -6
  43. package/templates/action-rpg/index.html +0 -1
  44. package/templates/action-rpg/package.json +15 -11
  45. package/templates/action-rpg/playtests/combat.playtest.json +23 -9
  46. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  47. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  48. package/templates/action-rpg/playtests/performance.playtest.json +22 -0
  49. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  50. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  51. package/templates/action-rpg/public/icon.png +0 -0
  52. package/templates/action-rpg/src/entities/Enemy.ts +14 -4
  53. package/templates/action-rpg/src/game.ts +21 -0
  54. package/templates/action-rpg/src/render/lighting.ts +6 -1
  55. package/templates/action-rpg/src/render/loading.ts +267 -42
  56. package/templates/action-rpg/src/render/postprocessing.ts +68 -15
  57. package/templates/action-rpg/src/render/worldEnvironment.ts +583 -0
  58. package/templates/action-rpg/src/scenes/Play.ts +49 -19
  59. package/templates/action-rpg/src/state.ts +4 -0
  60. package/templates/action-rpg/src/style.css +45 -1
  61. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  62. package/templates/action-rpg/src/ui/App.tsx +9 -8
  63. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  64. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  65. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  66. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  67. package/templates/action-rpg/src/ui/main.tsx +14 -0
  68. package/templates/action-rpg/threenative.config.ts +21 -8
  69. package/templates/action-rpg/vite.config.ts +32 -2
  70. package/templates/defense/.codex/config.toml +15 -0
  71. package/templates/defense/.mcp.json +6 -2
  72. package/templates/defense/AGENTS.md +371 -8
  73. package/templates/defense/CLAUDE.md +371 -8
  74. package/templates/defense/README.md +2 -1
  75. package/templates/defense/index.html +0 -1
  76. package/templates/defense/package.json +16 -12
  77. package/templates/defense/playtests/leak.playtest.json +9 -4
  78. package/templates/defense/playtests/performance.playtest.json +22 -0
  79. package/templates/defense/playtests/placement.playtest.json +5 -5
  80. package/templates/defense/playtests/pointer-placement.playtest.json +89 -0
  81. package/templates/defense/playtests/scan.playtest.json +3 -3
  82. package/templates/defense/playtests/survive.playtest.json +11 -6
  83. package/templates/defense/public/icon.png +0 -0
  84. package/templates/defense/src/attackers/Attacker.ts +28 -12
  85. package/templates/defense/src/game.ts +24 -2
  86. package/templates/defense/src/render/lighting.ts +6 -1
  87. package/templates/defense/src/render/loading.ts +263 -37
  88. package/templates/defense/src/render/postprocessing.ts +70 -13
  89. package/templates/defense/src/render/shapes.ts +38 -0
  90. package/templates/defense/src/render/worldEnvironment.ts +583 -0
  91. package/templates/defense/src/scenes/Defense.ts +109 -50
  92. package/templates/defense/src/state.ts +6 -0
  93. package/templates/defense/src/style.css +45 -1
  94. package/templates/defense/src/ui/App.tsx +9 -4
  95. package/templates/defense/src/ui/GameUi.tsx +20 -0
  96. package/templates/defense/src/ui/Hud.tsx +6 -5
  97. package/templates/defense/src/ui/main.tsx +14 -0
  98. package/templates/defense/threenative.config.ts +21 -8
  99. package/templates/defense/vite.config.ts +34 -1
  100. package/templates/minimal/.codex/config.toml +15 -0
  101. package/templates/minimal/.mcp.json +6 -2
  102. package/templates/minimal/AGENTS.md +360 -255
  103. package/templates/minimal/CLAUDE.md +360 -255
  104. package/templates/minimal/index.html +0 -1
  105. package/templates/minimal/package.json +14 -11
  106. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  107. package/templates/minimal/playtests/play.playtest.json +17 -5
  108. package/templates/minimal/public/icon.png +0 -0
  109. package/templates/minimal/src/game.ts +1 -0
  110. package/templates/minimal/src/render/camera.ts +1 -1
  111. package/templates/minimal/src/render/hud.ts +24 -8
  112. package/templates/minimal/src/render/lighting.ts +23 -2
  113. package/templates/minimal/src/render/loading.ts +23 -103
  114. package/templates/minimal/src/render/postprocessing.ts +92 -14
  115. package/templates/minimal/src/render/sky.ts +37 -32
  116. package/templates/minimal/src/render/worldEnvironment.ts +583 -0
  117. package/templates/minimal/src/scenes/Play.ts +91 -13
  118. package/templates/minimal/src/state.ts +8 -1
  119. package/templates/minimal/threenative.config.ts +15 -10
  120. package/templates/minimal/vite.config.ts +28 -1
  121. package/templates/platformer/.codex/config.toml +15 -0
  122. package/templates/platformer/.mcp.json +6 -2
  123. package/templates/platformer/AGENTS.md +385 -130
  124. package/templates/platformer/CLAUDE.md +385 -130
  125. package/templates/platformer/index.html +0 -1
  126. package/templates/platformer/package.json +17 -14
  127. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  128. package/templates/platformer/playtests/branding.playtest.json +29 -0
  129. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  130. package/templates/platformer/playtests/collect.playtest.json +1 -1
  131. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  132. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  133. package/templates/platformer/playtests/damage.playtest.json +4 -1
  134. package/templates/platformer/playtests/dash.playtest.json +2 -2
  135. package/templates/platformer/playtests/jump.playtest.json +2 -3
  136. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  137. package/templates/platformer/playtests/oneway.playtest.json +1 -1
  138. package/templates/platformer/playtests/performance.playtest.json +6 -5
  139. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  140. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  141. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  142. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +13 -4
  143. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  144. package/templates/platformer/playtests/touch-controls-web.playtest.json +46 -0
  145. package/templates/platformer/public/icon.png +0 -0
  146. package/templates/platformer/src/entities/Character.ts +16 -10
  147. package/templates/platformer/src/entities/Patrol.ts +5 -0
  148. package/templates/platformer/src/game.ts +24 -1
  149. package/templates/platformer/src/render/lighting.ts +6 -1
  150. package/templates/platformer/src/render/loading.ts +270 -61
  151. package/templates/platformer/src/render/postprocessing.ts +68 -15
  152. package/templates/platformer/src/render/touch-controls.ts +54 -36
  153. package/templates/platformer/src/render/worldEnvironment.ts +583 -0
  154. package/templates/platformer/src/scenes/Level.ts +47 -22
  155. package/templates/platformer/src/state.ts +4 -0
  156. package/templates/platformer/src/style.css +45 -1
  157. package/templates/platformer/src/ui/App.tsx +9 -4
  158. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  159. package/templates/platformer/src/ui/Hud.tsx +6 -5
  160. package/templates/platformer/src/ui/main.tsx +14 -0
  161. package/templates/platformer/threenative.config.ts +20 -10
  162. package/templates/platformer/vite.config.ts +34 -1
  163. package/templates/racing/.codex/config.toml +15 -0
  164. package/templates/racing/.mcp.json +6 -2
  165. package/templates/racing/AGENTS.md +370 -6
  166. package/templates/racing/CLAUDE.md +370 -6
  167. package/templates/racing/index.html +0 -1
  168. package/templates/racing/package.json +16 -12
  169. package/templates/racing/playtests/boost.playtest.json +5 -5
  170. package/templates/racing/playtests/outcome.playtest.json +14 -4
  171. package/templates/racing/playtests/performance.playtest.json +22 -0
  172. package/templates/racing/playtests/ranking.playtest.json +2 -2
  173. package/templates/racing/playtests/rescue.playtest.json +12 -6
  174. package/templates/racing/playtests/reverse.playtest.json +3 -3
  175. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  176. package/templates/racing/public/icon.png +0 -0
  177. package/templates/racing/src/game.ts +24 -1
  178. package/templates/racing/src/render/camera.ts +10 -6
  179. package/templates/racing/src/render/lighting.ts +6 -1
  180. package/templates/racing/src/render/loading.ts +291 -34
  181. package/templates/racing/src/render/postprocessing.ts +70 -13
  182. package/templates/racing/src/render/worldEnvironment.ts +583 -0
  183. package/templates/racing/src/scenes/Race.ts +68 -36
  184. package/templates/racing/src/state.ts +4 -0
  185. package/templates/racing/src/style.css +45 -1
  186. package/templates/racing/src/track/Lap.ts +20 -9
  187. package/templates/racing/src/track/Ranking.ts +53 -14
  188. package/templates/racing/src/track/Track.ts +29 -16
  189. package/templates/racing/src/track/TrackSector.ts +14 -4
  190. package/templates/racing/src/ui/App.tsx +9 -4
  191. package/templates/racing/src/ui/GameUi.tsx +20 -0
  192. package/templates/racing/src/ui/Hud.tsx +6 -5
  193. package/templates/racing/src/ui/main.tsx +14 -0
  194. package/templates/racing/threenative.config.ts +21 -8
  195. package/templates/racing/vite.config.ts +34 -1
  196. package/templates/sailing/.codex/config.toml +15 -0
  197. package/templates/sailing/.mcp.json +20 -0
  198. package/templates/sailing/AGENTS.md +388 -0
  199. package/templates/sailing/CLAUDE.md +390 -0
  200. package/templates/sailing/README.md +25 -0
  201. package/templates/sailing/index.html +12 -0
  202. package/templates/sailing/kit.json +7 -0
  203. package/templates/sailing/native-playtests/survives.playtest.json +21 -0
  204. package/templates/sailing/package.json +52 -0
  205. package/templates/sailing/playtests/fail.playtest.json +24 -0
  206. package/templates/sailing/playtests/performance.playtest.json +21 -0
  207. package/templates/sailing/playtests/survives.playtest.json +38 -0
  208. package/templates/sailing/playtests/win.playtest.json +31 -0
  209. package/templates/sailing/public/favicon.svg +5 -0
  210. package/templates/sailing/public/icon.png +0 -0
  211. package/templates/sailing/src/entities/Ship.ts +96 -0
  212. package/templates/sailing/src/game.ts +40 -0
  213. package/templates/sailing/src/main.ts +15 -0
  214. package/templates/sailing/src/render/camera.ts +21 -0
  215. package/templates/sailing/src/render/lighting.ts +36 -0
  216. package/templates/sailing/src/render/loading.ts +315 -0
  217. package/templates/sailing/src/render/materials.ts +28 -0
  218. package/templates/sailing/src/render/palette.ts +24 -0
  219. package/templates/sailing/src/render/postprocessing.ts +33 -0
  220. package/templates/sailing/src/render/props.ts +52 -0
  221. package/templates/sailing/src/render/sky.ts +32 -0
  222. package/templates/sailing/src/render/water-material.ts +14 -0
  223. package/templates/sailing/src/render/water-shaders.ts +12 -0
  224. package/templates/sailing/src/render/wave-nodes.ts +10 -0
  225. package/templates/sailing/src/render/worldEnvironment.ts +590 -0
  226. package/templates/sailing/src/scenes/Boot.ts +12 -0
  227. package/templates/sailing/src/scenes/Sailing.ts +106 -0
  228. package/templates/sailing/src/state.ts +10 -0
  229. package/templates/sailing/src/style.css +61 -0
  230. package/templates/sailing/src/ui/App.tsx +15 -0
  231. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  232. package/templates/sailing/src/ui/Hud.tsx +55 -0
  233. package/templates/sailing/src/ui/Menu.tsx +30 -0
  234. package/templates/sailing/src/ui/main.tsx +7 -0
  235. package/templates/sailing/tailwind.config.ts +2 -0
  236. package/templates/sailing/threenative.config.ts +34 -0
  237. package/templates/sailing/tsconfig.json +17 -0
  238. package/templates/sailing/vite.config.ts +34 -0
  239. package/templates/shooter/.codex/config.toml +15 -0
  240. package/templates/shooter/.mcp.json +6 -2
  241. package/templates/shooter/AGENTS.md +373 -7
  242. package/templates/shooter/CLAUDE.md +373 -7
  243. package/templates/shooter/index.html +0 -1
  244. package/templates/shooter/package.json +16 -11
  245. package/templates/shooter/playtests/fail.playtest.json +5 -4
  246. package/templates/shooter/playtests/input-control.playtest.json +131 -0
  247. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  248. package/templates/shooter/playtests/performance.playtest.json +22 -0
  249. package/templates/shooter/playtests/shooter.playtest.json +22 -18
  250. package/templates/shooter/playtests/survives.playtest.json +1 -1
  251. package/templates/shooter/public/favicon.svg +1 -1
  252. package/templates/shooter/public/icon.png +0 -0
  253. package/templates/shooter/src/game.ts +24 -1
  254. package/templates/shooter/src/main.ts +3 -13
  255. package/templates/shooter/src/render/camera.ts +62 -12
  256. package/templates/shooter/src/render/lighting.ts +6 -1
  257. package/templates/shooter/src/render/loading.ts +262 -33
  258. package/templates/shooter/src/render/palette.ts +1 -1
  259. package/templates/shooter/src/render/postprocessing.ts +68 -16
  260. package/templates/shooter/src/render/shapes.ts +178 -0
  261. package/templates/shooter/src/render/ui.css +34 -1
  262. package/templates/shooter/src/render/worldEnvironment.ts +583 -0
  263. package/templates/shooter/src/scenes/Play.ts +246 -73
  264. package/templates/shooter/src/state.ts +13 -0
  265. package/templates/shooter/src/style.css +26 -0
  266. package/templates/shooter/src/ui/App.tsx +10 -12
  267. package/templates/shooter/src/ui/GameUi.tsx +20 -0
  268. package/templates/shooter/src/ui/Hud.tsx +8 -10
  269. package/templates/shooter/src/ui/Menu.tsx +24 -9
  270. package/templates/shooter/src/ui/main.tsx +15 -0
  271. package/templates/shooter/src/weapons/Projectile.ts +21 -10
  272. package/templates/shooter/threenative.config.ts +21 -8
  273. package/templates/shooter/vite.config.ts +32 -2
  274. package/templates/starter/.codex/config.toml +15 -0
  275. package/templates/starter/.mcp.json +6 -2
  276. package/templates/starter/AGENTS.md +429 -326
  277. package/templates/starter/CLAUDE.md +429 -326
  278. package/templates/starter/assets/pickup.wav +0 -0
  279. package/templates/starter/gitignore +4 -0
  280. package/templates/starter/index.html +0 -1
  281. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  282. package/templates/starter/native-playtests/render-chain.playtest.json +12 -0
  283. package/templates/starter/package.json +16 -12
  284. package/templates/starter/playtests/assets.playtest.json +65 -0
  285. package/templates/starter/playtests/buffer.playtest.json +59 -9
  286. package/templates/starter/playtests/cloth.playtest.json +113 -0
  287. package/templates/starter/playtests/coyote.playtest.json +60 -8
  288. package/templates/starter/playtests/forward.playtest.json +29 -4
  289. package/templates/starter/playtests/gameover.playtest.json +66 -0
  290. package/templates/starter/playtests/goal.playtest.json +67 -0
  291. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  292. package/templates/starter/playtests/look.playtest.json +34 -6
  293. package/templates/starter/playtests/models-baseline.png +0 -0
  294. package/templates/starter/playtests/models.playtest.json +74 -0
  295. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  296. package/templates/starter/playtests/odometer.playtest.json +54 -0
  297. package/templates/starter/playtests/pause.playtest.json +27 -4
  298. package/templates/starter/playtests/play.playtest.json +43 -7
  299. package/templates/starter/playtests/respawn.playtest.json +46 -6
  300. package/templates/starter/playtests/restart.playtest.json +65 -10
  301. package/templates/starter/playtests/seed.playtest.json +44 -8
  302. package/templates/starter/playtests/survives.playtest.json +27 -4
  303. package/templates/starter/playtests/textures-baseline.png +0 -0
  304. package/templates/starter/playtests/textures.playtest.json +74 -0
  305. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  306. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  307. package/templates/starter/public/icon.png +0 -0
  308. package/templates/starter/src/entities/Goal.ts +122 -0
  309. package/templates/starter/src/entities/Player.ts +40 -2
  310. package/templates/starter/src/game.ts +25 -0
  311. package/templates/starter/src/render/camera.ts +31 -5
  312. package/templates/starter/src/render/easing.ts +5 -0
  313. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  314. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  315. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  316. package/templates/starter/src/render/lighting.ts +6 -1
  317. package/templates/starter/src/render/loading.ts +315 -0
  318. package/templates/starter/src/render/materials.ts +17 -1
  319. package/templates/starter/src/render/pennant.ts +54 -0
  320. package/templates/starter/src/render/postprocessing.ts +46 -15
  321. package/templates/starter/src/render/scenery.ts +83 -0
  322. package/templates/starter/src/render/shapes.ts +9 -21
  323. package/templates/starter/src/render/worldEnvironment.ts +583 -0
  324. package/templates/starter/src/scenes/Play.ts +146 -36
  325. package/templates/starter/src/state.ts +12 -0
  326. package/templates/starter/src/style.css +45 -1
  327. package/templates/starter/src/ui/App.tsx +9 -6
  328. package/templates/starter/src/ui/GameUi.tsx +20 -0
  329. package/templates/starter/src/ui/Hud.tsx +52 -29
  330. package/templates/starter/src/ui/Menu.tsx +25 -23
  331. package/templates/starter/src/ui/main.tsx +14 -0
  332. package/templates/starter/threenative.config.ts +27 -9
  333. package/templates/starter/tools/look.mjs +109 -0
  334. package/templates/starter/vite.config.ts +32 -2
  335. package/templates/minimal/assets/.gitkeep +0 -0
  336. package/templates/minimal/public/.gitkeep +0 -0
  337. package/templates/platformer/assets/.gitkeep +0 -0
  338. package/templates/platformer/public/.gitkeep +0 -0
  339. package/templates/starter/assets/.gitkeep +0 -0
  340. package/templates/starter/public/.gitkeep +0 -0
  341. package/templates/starter/public/pickup.ogg +0 -0
  342. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  343. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -2,17 +2,53 @@
2
2
  "name": "seed",
3
3
  "target": "web",
4
4
  "schemaVersion": 1,
5
- "viewport": { "width": 1280, "height": 720 },
6
- "warmupFrames": 10,
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
9
+ "warmupFrames": 0,
7
10
  "subject": "player",
8
- "artifacts": { "runtimeTrace": true },
9
- "steps": [{ "kind": "wait", "label": "seeded-level", "waitTicks": 60, "release": true }],
11
+ "artifacts": {
12
+ "runtimeTrace": true,
13
+ "screenshots": false
14
+ },
15
+ "steps": [
16
+ {
17
+ "kind": "wait",
18
+ "label": "play-scene-loads",
19
+ "waitTicks": 240,
20
+ "release": true
21
+ },
22
+ {
23
+ "kind": "wait",
24
+ "label": "seeded-level",
25
+ "waitTicks": 60,
26
+ "release": true
27
+ }
28
+ ],
10
29
  "assert": {
11
- "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
30
+ "diagnostics": {
31
+ "noConsoleErrors": true,
32
+ "runtimeReady": true
33
+ },
12
34
  "resources": [
13
- { "id": "GameState", "path": "levelX", "allowTrivial": true, "equals": -0.6056551518850029 }
35
+ {
36
+ "allowTrivial": "The seed lands 0.25s after the level builds, so whether the runner samples the -99 sentinel before or after it is a race with boot time: firstTick was 6 locally and 47 in CI run 33350164891, and only the slow sample reported TN_PLAYTEST_ASSERTION_TRIVIAL. The range is the real assertion and both sentinels fall outside it: -99 means the level never built, 2 means the seeded draw did not advance ctx.random.",
37
+ "gte": -1,
38
+ "id": "state",
39
+ "lte": 1,
40
+ "path": "levelX"
41
+ }
14
42
  ],
15
- "world": { "seed": 90210 },
16
- "visibility": [{ "entity": "player", "minProjectedPixels": 1 }]
43
+ "world": {
44
+ "seed": 90210
45
+ },
46
+ "visibility": [
47
+ {
48
+ "allowTrivial": "The starter scene begins with the player visible and in frame; this held visibility row accompanies the seed assertion.",
49
+ "entity": "player",
50
+ "minProjectedPixels": 1
51
+ }
52
+ ]
17
53
  }
18
54
  }
@@ -2,12 +2,32 @@
2
2
  "name": "survives",
3
3
  "target": "web",
4
4
  "schemaVersion": 1,
5
- "viewport": { "width": 1280, "height": 720 },
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
6
9
  "warmupFrames": 10,
7
10
  "subject": "player",
8
11
  "steps": [
9
- { "kind": "input", "label": "move", "press": "ArrowUp", "holdTicks": 60, "release": true },
10
- { "kind": "wait", "label": "settle", "waitTicks": 10, "release": true }
12
+ {
13
+ "kind": "wait",
14
+ "label": "play-scene-loads",
15
+ "waitTicks": 240,
16
+ "release": true
17
+ },
18
+ {
19
+ "kind": "input",
20
+ "label": "move",
21
+ "press": "ArrowUp",
22
+ "holdTicks": 60,
23
+ "release": true
24
+ },
25
+ {
26
+ "kind": "wait",
27
+ "label": "settle",
28
+ "waitTicks": 10,
29
+ "release": true
30
+ }
11
31
  ],
12
32
  "assert": {
13
33
  "diagnostics": {
@@ -16,7 +36,10 @@
16
36
  "noRuntimeDiagnostics": true,
17
37
  "runtimeReady": true
18
38
  },
19
- "movement": { "entity": "player", "minDistance": 0.5 },
39
+ "movement": {
40
+ "entity": "player",
41
+ "minDistance": 0.5
42
+ },
20
43
  "visual": [
21
44
  {
22
45
  "region": {
@@ -0,0 +1,74 @@
1
+ {
2
+ "name": "starter-textures",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
9
+ "warmupFrames": 10,
10
+ "subject": "player",
11
+ "steps": [
12
+ {
13
+ "kind": "wait",
14
+ "label": "play-scene-loads",
15
+ "waitTicks": 600,
16
+ "release": true
17
+ },
18
+ {
19
+ "kind": "input",
20
+ "label": "run-toward-the-flag",
21
+ "press": "ArrowRight",
22
+ "holdTicks": 205,
23
+ "release": false
24
+ },
25
+ {
26
+ "kind": "input",
27
+ "label": "jump-the-gap",
28
+ "press": "Space",
29
+ "holdTicks": 2,
30
+ "release": true
31
+ },
32
+ {
33
+ "kind": "wait",
34
+ "label": "land-beside-the-pennant",
35
+ "waitTicks": 120,
36
+ "release": true
37
+ }
38
+ ],
39
+ "assert": {
40
+ "diagnostics": {
41
+ "noConsoleErrors": true,
42
+ "noNetworkErrors": true,
43
+ "runtimeReady": true
44
+ },
45
+ "movement": {
46
+ "entity": "player",
47
+ "minDistance": 0.5
48
+ },
49
+ "resources": [
50
+ {
51
+ "id": "state",
52
+ "path": "status",
53
+ "equals": "won",
54
+ "changed": true
55
+ }
56
+ ],
57
+ "visibility": [
58
+ {
59
+ "allowTrivial": "The pennant is authored in frame from the first tick so the player can see where to jump; this row proves the KTX2-compressed texture still draws when the run reaches it.",
60
+ "entity": "goal",
61
+ "minProjectedPixels": 20
62
+ }
63
+ ],
64
+ "visual": [
65
+ {
66
+ "frameDiff": {
67
+ "maxChangedPixelRatio": 1,
68
+ "minChangedPixelRatio": 0.01,
69
+ "baselineImage": "playtests/textures-baseline.png"
70
+ }
71
+ }
72
+ ]
73
+ }
74
+ }
@@ -0,0 +1,86 @@
1
+ {
2
+ "acceptanceId": "camera-intent",
3
+ "name": "starter-zoom-pinch",
4
+ "target": "web",
5
+ "schemaVersion": 1,
6
+ "viewport": {
7
+ "width": 1280,
8
+ "height": 720
9
+ },
10
+ "warmupFrames": 30,
11
+ "subject": "player",
12
+ "artifacts": {
13
+ "screenshots": "before-after"
14
+ },
15
+ "steps": [
16
+ {
17
+ "kind": "wait",
18
+ "label": "play-scene-loads",
19
+ "waitTicks": 240,
20
+ "release": true
21
+ },
22
+ {
23
+ "kind": "input",
24
+ "label": "pinch-start",
25
+ "pointers": [
26
+ {
27
+ "id": 7,
28
+ "x": 0.35,
29
+ "y": 0.5
30
+ },
31
+ {
32
+ "id": 3,
33
+ "x": 0.65,
34
+ "y": 0.5
35
+ }
36
+ ],
37
+ "waitTicks": 1,
38
+ "release": false
39
+ },
40
+ {
41
+ "kind": "input",
42
+ "label": "pinch-apart",
43
+ "pointers": [
44
+ {
45
+ "id": 7,
46
+ "x": 0.1,
47
+ "y": 0.5
48
+ },
49
+ {
50
+ "id": 3,
51
+ "x": 0.9,
52
+ "y": 0.5
53
+ }
54
+ ],
55
+ "waitTicks": 30,
56
+ "release": true
57
+ }
58
+ ],
59
+ "assert": {
60
+ "diagnostics": {
61
+ "noConsoleErrors": true,
62
+ "noNetworkErrors": true,
63
+ "runtimeReady": true
64
+ },
65
+ "camera": {
66
+ "entity": "camera.main",
67
+ "follows": "player",
68
+ "targetInViewport": true,
69
+ "within": 9.2
70
+ },
71
+ "visibility": [
72
+ {
73
+ "allowTrivial": "The starter scene begins with the player visible and in frame; this held visibility row accompanies the pinch distance assertion.",
74
+ "entity": "player",
75
+ "minProjectedPixels": 20
76
+ }
77
+ ],
78
+ "visual": [
79
+ {
80
+ "frameDiff": {
81
+ "minChangedPixelRatio": 0.01
82
+ }
83
+ }
84
+ ]
85
+ }
86
+ }
@@ -0,0 +1,59 @@
1
+ {
2
+ "acceptanceId": "camera-intent",
3
+ "name": "starter-zoom-wheel",
4
+ "target": "web",
5
+ "schemaVersion": 1,
6
+ "viewport": {
7
+ "width": 1280,
8
+ "height": 720
9
+ },
10
+ "warmupFrames": 30,
11
+ "subject": "player",
12
+ "artifacts": {
13
+ "screenshots": "before-after"
14
+ },
15
+ "steps": [
16
+ {
17
+ "kind": "wait",
18
+ "label": "play-scene-loads",
19
+ "waitTicks": 240,
20
+ "release": true
21
+ },
22
+ {
23
+ "kind": "input",
24
+ "label": "zoom-wheel",
25
+ "wheel": {
26
+ "deltaY": -500
27
+ },
28
+ "waitTicks": 30,
29
+ "release": true
30
+ }
31
+ ],
32
+ "assert": {
33
+ "diagnostics": {
34
+ "noConsoleErrors": true,
35
+ "noNetworkErrors": true,
36
+ "runtimeReady": true
37
+ },
38
+ "camera": {
39
+ "entity": "camera.main",
40
+ "follows": "player",
41
+ "targetInViewport": true,
42
+ "within": 9.2
43
+ },
44
+ "visibility": [
45
+ {
46
+ "allowTrivial": "The starter scene begins with the player visible and in frame; this held visibility row accompanies the zoom distance assertion.",
47
+ "entity": "player",
48
+ "minProjectedPixels": 20
49
+ }
50
+ ],
51
+ "visual": [
52
+ {
53
+ "frameDiff": {
54
+ "minChangedPixelRatio": 0.01
55
+ }
56
+ }
57
+ ]
58
+ }
59
+ }
Binary file
@@ -0,0 +1,122 @@
1
+ import { type ICtx, SoftBody3D } from "@threenative/core";
2
+ import { Area3D, CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
+ import { type BufferGeometry, type Material, Matrix4, Mesh } from "three";
4
+ import { tessellatePennant } from "../render/pennant.js";
5
+ import { block, tube } from "../render/shapes.js";
6
+ import type { GameState } from "../state.js";
7
+
8
+ /**
9
+ * The far side of the gap: a fixed island, a flagpole, and the pennant the packaged glTF
10
+ * proof asset is cut from. Landing anywhere on it ends the run.
11
+ *
12
+ * The island top sits below the ledge on purpose. A same-height landing has to be jumped
13
+ * within a couple of frames of the edge; dropping 0.4 m widens that window to about half
14
+ * a second, which is what makes coyote time feel generous instead of decorative.
15
+ */
16
+ const ISLAND = { depth: 2.6, height: 0.4, top: -0.4, width: 3, x: 7.9, z: 0 } as const;
17
+ const POLE = { height: 2.4, radius: 0.05, x: 8.4, z: -0.5 } as const;
18
+ const PENNANT_SCALE = 0.55;
19
+
20
+ export interface IGoalMaterials {
21
+ /** The island itself: the same ground the ledge is made of, across the gap. */
22
+ readonly floor: Material;
23
+ /** The pole. The accent role, and the only warm thing on the far side. */
24
+ readonly goal: Material;
25
+ }
26
+
27
+ export class Goal {
28
+ /** The whole marker, so a playtest `visibility` row can ask whether it is on screen. */
29
+ readonly mesh: SoftBody3D;
30
+ readonly pennant: SoftBody3D;
31
+ readonly area: Area3D;
32
+ readonly #body: RigidBody3D;
33
+
34
+ constructor(ctx: ICtx<GameState, IPhysicsContext>, materials: IGoalMaterials, pennant: Mesh) {
35
+ // Children carry world coordinates and the group stays at the origin: a physics body
36
+ // reads its object's own transform, and a nested offset would silently desync them.
37
+ const island = block(ISLAND.width, ISLAND.height, ISLAND.depth, materials.floor, {
38
+ radius: 0.16,
39
+ });
40
+ island.position.set(ISLAND.x, ISLAND.top - ISLAND.height / 2, ISLAND.z);
41
+ const pole = tube(POLE.radius, POLE.radius, POLE.height, materials.goal);
42
+ pole.position.set(POLE.x, ISLAND.top + POLE.height / 2, POLE.z);
43
+ // The proof triangle points +x once it is turned on its side, which is a pennant. Its
44
+ // hoist edge lands on the pole; the rest of it flies clear.
45
+ const transform = new Matrix4()
46
+ .makeRotationZ(-Math.PI / 2)
47
+ .premultiply(new Matrix4().makeScale(PENNANT_SCALE, PENNANT_SCALE, PENNANT_SCALE))
48
+ .premultiply(
49
+ new Matrix4().makeTranslation(
50
+ POLE.x + 0.6 * PENNANT_SCALE,
51
+ ISLAND.top + POLE.height - 0.5,
52
+ POLE.z + POLE.radius,
53
+ ),
54
+ );
55
+ const geometry = tessellatePennant(pennant.geometry).applyMatrix4(transform);
56
+ this.pennant = new SoftBody3D(new Mesh(geometry, pennant.material), {
57
+ damping: 1.8,
58
+ gravity: [0, 0, 0],
59
+ pinned: pinnedHoist(geometry),
60
+ readbackEveryFrames: 2,
61
+ stiffness: 36,
62
+ wind: [0, 0, 0],
63
+ });
64
+ this.pennant.name = "finish-flag-cloth";
65
+ this.mesh = this.pennant;
66
+ this.mesh.add(island, pole);
67
+ ctx.add(this.mesh);
68
+
69
+ this.#body = new RigidBody3D({
70
+ object: island,
71
+ physics: ctx.physics,
72
+ shape: CollisionShape3D.fromMesh(island),
73
+ type: "fixed",
74
+ });
75
+ // Tall enough to catch a landing, shallow enough that a body still falling past the
76
+ // island's flank in the gap is metres below it and never trips the finish.
77
+ this.area = new Area3D({
78
+ physics: ctx.physics,
79
+ position: { x: ISLAND.x, y: ISLAND.top + 0.8, z: ISLAND.z },
80
+ shape: CollisionShape3D.box(ISLAND.width, 1.6, ISLAND.depth),
81
+ });
82
+ }
83
+
84
+ /** Maximum local-Z movement from the authored plane in the latest throttled GPU sample. */
85
+ flagDisplacement(): number {
86
+ const sample = this.pennant.sample;
87
+ if (sample === undefined) return 0;
88
+ let maximum = 0;
89
+ for (let index = 2; index < sample.data.length; index += 3) {
90
+ const z = sample.data[index];
91
+ if (!Number.isFinite(z)) throw new Error(`Starter flag readback was non-finite at ${index}.`);
92
+ maximum = Math.max(maximum, Math.abs((z as number) - (POLE.z + POLE.radius)));
93
+ }
94
+ return maximum;
95
+ }
96
+
97
+ readbackLands(): number {
98
+ const stats = this.pennant.debug().readbackStats;
99
+ if (typeof stats !== "object" || stats === null || !("lands" in stats)) return 0;
100
+ const lands = (stats as { lands?: unknown }).lands;
101
+ return typeof lands === "number" ? lands : 0;
102
+ }
103
+
104
+ dispose(): void {
105
+ this.area.dispose();
106
+ this.#body.dispose();
107
+ this.mesh.removeFromParent();
108
+ }
109
+ }
110
+
111
+ function pinnedHoist(geometry: BufferGeometry): number[] {
112
+ const positions = geometry.getAttribute("position");
113
+ if (positions === undefined) throw new Error("Starter flag geometry has no positions.");
114
+ let minimum = Number.POSITIVE_INFINITY;
115
+ for (let index = 0; index < positions.count; index += 1)
116
+ minimum = Math.min(minimum, positions.getX(index));
117
+ const pinned: number[] = [];
118
+ for (let index = 0; index < positions.count; index += 1)
119
+ if (Math.abs(positions.getX(index) - minimum) < 1e-6) pinned.push(index);
120
+ if (pinned.length === 0) throw new Error("Starter flag geometry has no hoist vertices.");
121
+ return pinned;
122
+ }
@@ -1,12 +1,18 @@
1
1
  import type { ICtx } from "@threenative/core";
2
2
  import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
- import { type Material, Mesh } from "three";
3
+ import { type Material, Mesh, Vector3 } from "three";
4
4
  import { roundedBox } from "../render/shapes.js";
5
5
  import type { GameState } from "../state.js";
6
6
 
7
7
  type GameCtx = ICtx<GameState, IPhysicsContext>;
8
8
 
9
9
  // Tune these two timers for jump feel; they forgive a late or early button press.
10
+ // 0.12s is 7.2 ticks at the 1/60 step, and `playtests/coyote.playtest.json` is written against
11
+ // that: 3 ticks walking off the ledge, 5 more airborne, then the jump — the jump lands about 5
12
+ // ticks after the player actually leaves the ground, inside the window. Change this and those two
13
+ // step lengths move with it. Tightening the airborne hold does NOT make the scenario safer: with
14
+ // 2 the player has not left the ledge yet, and the jump is counted as an ordinary one
15
+ // (`jumps: 1, coyoteJumps: 0`), which is what it measured when I tried.
10
16
  const COYOTE_TIME = 0.12;
11
17
  const JUMP_BUFFER = 0.14;
12
18
  const JUMP_SPEED = 5;
@@ -20,6 +26,9 @@ export class Player {
20
26
  #jumpBuffer = 0;
21
27
  #jumps = 0;
22
28
  #coyoteJumps = 0;
29
+ #odometer = 0;
30
+ #previousPosition = new Vector3();
31
+ #hasPreviousPosition = false;
23
32
 
24
33
  constructor(
25
34
  ctx: GameCtx,
@@ -39,6 +48,9 @@ export class Player {
39
48
  }
40
49
 
41
50
  update(ctx: GameCtx, dt: number): void {
51
+ if (this.#hasPreviousPosition) {
52
+ this.#odometer += this.mesh.position.distanceTo(this.#previousPosition);
53
+ }
42
54
  const grounded = this.body.grounded;
43
55
  this.#coyoteTime = Math.max(0, this.#coyoteTime - dt);
44
56
  this.#jumpBuffer = Math.max(0, this.#jumpBuffer - dt);
@@ -54,7 +66,9 @@ export class Player {
54
66
  const move = ctx.input.vector("move");
55
67
  this.body.velocity.x = move.x * MOVE_SPEED;
56
68
  this.body.velocity.z = -move.y * MOVE_SPEED;
69
+ this.#previousPosition.copy(this.mesh.position);
57
70
  this.body.moveAndSlide(dt);
71
+ this.#hasPreviousPosition = true;
58
72
  if (this.body.grounded) this.#coyoteTime = COYOTE_TIME;
59
73
  }
60
74
 
@@ -62,17 +76,41 @@ export class Player {
62
76
  this.body.teleport(SPAWN);
63
77
  this.#coyoteTime = 0;
64
78
  this.#jumpBuffer = 0;
79
+ this.#hasPreviousPosition = false;
65
80
  }
66
81
 
67
- debug(): { coyoteJumps: number; grounded: boolean; jumps: number; position: number[] } {
82
+ debug(): {
83
+ coyoteJumps: number;
84
+ grounded: boolean;
85
+ jumps: number;
86
+ odometer: number;
87
+ position: number[];
88
+ } {
68
89
  return {
69
90
  coyoteJumps: this.#coyoteJumps,
70
91
  grounded: this.body.grounded,
71
92
  jumps: this.#jumps,
93
+ odometer: this.#odometer,
72
94
  position: this.mesh.position.toArray(),
73
95
  };
74
96
  }
75
97
 
98
+ get coyoteJumps(): number {
99
+ return this.#coyoteJumps;
100
+ }
101
+
102
+ get grounded(): boolean {
103
+ return this.body.grounded;
104
+ }
105
+
106
+ get jumps(): number {
107
+ return this.#jumps;
108
+ }
109
+
110
+ get odometer(): number {
111
+ return this.#odometer;
112
+ }
113
+
76
114
  dispose(): void {
77
115
  this.body.dispose();
78
116
  this.mesh.removeFromParent();
@@ -18,9 +18,14 @@ const game = defineGame<GameState, IPhysicsContext>({
18
18
  up: ["ArrowUp", "KeyW"],
19
19
  },
20
20
  jump: { buttons: [0], keys: ["Space"] },
21
+ flagGust: { keys: ["KeyG"] },
21
22
  restart: { keys: ["KeyR"] },
23
+ // Wheel, pinch and the right stick share one portable camera intent. Negative DOM deltaY
24
+ // (toward-user) is positive scroll intent on browser and native; the scene owns the framing.
25
+ zoom: { gamepadAxes: [3], pinch: true, scroll: true },
22
26
  },
23
27
  plugins: [rapier(), replay(), playtest()],
28
+ display: config.display,
24
29
  render: config.renderer,
25
30
  scenes: { play: Play },
26
31
  seed: 90210,
@@ -28,3 +33,23 @@ const game = defineGame<GameState, IPhysicsContext>({
28
33
  });
29
34
 
30
35
  export default game;
36
+
37
+ /**
38
+ * What the UI can ask the game to do.
39
+ *
40
+ * Intents are one-way and named by the game: the UI sends `restart`, `pause` or `resume` and the
41
+ * game decides what each means. Nothing comes back this way — the UI reads the game's published
42
+ * state instead, which keeps one source of truth on the side that owns the simulation.
43
+ */
44
+ game.ui.onIntent((intent) => {
45
+ if (intent === "restart") void game.goto("play");
46
+ if (intent === "pause") game.pause();
47
+ if (intent === "resume") game.resume();
48
+ game.state.set({
49
+ // `game.ui.connected` is true only once the UI announced itself, which is what tells an
50
+ // overlay that never came up apart from a game whose HUD is simply empty.
51
+ uiReady: game.ui.connected,
52
+ ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
53
+ });
54
+ game.state.flush();
55
+ });
@@ -18,6 +18,12 @@ export interface ISpringArmOptions {
18
18
  readonly lookAhead?: Vector3;
19
19
  /** Seconds for the arm to close most of the distance. Higher trails more. */
20
20
  readonly damping?: number;
21
+ /** Closest target-relative distance allowed by the game's framing. */
22
+ readonly minDistance?: number;
23
+ /** Farthest target-relative distance allowed by the game's framing. */
24
+ readonly maxDistance?: number;
25
+ /** Target-relative distance units moved by one full zoom axis unit per second. */
26
+ readonly dollySpeed?: number;
21
27
  }
22
28
 
23
29
  export interface ISpringArm {
@@ -25,6 +31,8 @@ export interface ISpringArm {
25
31
  readonly follow: (target: Vector3, dt: number) => void;
26
32
  /** Jump the camera to its resting pose — use on spawn and respawn. */
27
33
  readonly snap: (target: Vector3) => void;
34
+ /** Move toward or away from the target; positive intent moves the camera closer. */
35
+ readonly dolly: (amount: number, dt: number) => void;
28
36
  }
29
37
 
30
38
  export function createSpringArm(
@@ -33,25 +41,43 @@ export function createSpringArm(
33
41
  ): ISpringArm {
34
42
  // Keep the starter's target-relative distance below the 9.5-unit look budget
35
43
  // so the player and nearby route stay readable after the camera settles.
36
- const offset = options.offset ?? new Vec3(0, 4.2, 8.45);
37
- const lookAhead = options.lookAhead ?? new Vec3(0, 1, 0);
44
+ const offset = (options.offset ?? new Vec3(-1, 4.2, 8.2)).clone();
45
+ // Lead the route rather than centring the character. The level runs left to right, so
46
+ // aiming ahead of the player puts the gap and the flag in frame from the first tick
47
+ // instead of leaving half the picture empty behind them.
48
+ const lookAhead = options.lookAhead ?? new Vec3(2.1, 0.9, -0.4);
38
49
  const damping = options.damping ?? 0.18;
50
+ const startingDistance = offset.length();
51
+ const offsetDirection =
52
+ startingDistance > 0 ? offset.clone().multiplyScalar(1 / startingDistance) : new Vec3(0, 0, 1);
53
+ const minDistance = Math.max(0.1, options.minDistance ?? startingDistance * 0.55);
54
+ const maxDistance = Math.max(minDistance, options.maxDistance ?? startingDistance * 1.35);
55
+ const dollySpeed = Math.max(0, options.dollySpeed ?? 10);
56
+ let distance = Math.min(Math.max(startingDistance, minDistance), maxDistance);
39
57
 
40
58
  const desired = new Vec3();
41
59
  const aim = new Vec3();
60
+ const currentOffset = new Vec3();
61
+
62
+ const dolly = (amount: number, dt: number): void => {
63
+ if (!Number.isFinite(amount) || !Number.isFinite(dt) || dt <= 0) return;
64
+ distance = Math.min(maxDistance, Math.max(minDistance, distance - amount * dollySpeed * dt));
65
+ };
66
+
67
+ const targetOffset = (): Vector3 => currentOffset.copy(offsetDirection).multiplyScalar(distance);
42
68
 
43
69
  const snap = (target: Vector3): void => {
44
- camera.position.copy(target).add(offset);
70
+ camera.position.copy(target).add(targetOffset());
45
71
  camera.lookAt(aim.copy(target).add(lookAhead));
46
72
  };
47
73
 
48
74
  const follow = (target: Vector3, dt: number): void => {
49
- desired.copy(target).add(offset);
75
+ desired.copy(target).add(targetOffset());
50
76
  // 1 - e^(-dt/damping): the frame-rate-independent form of a lerp. At 30fps
51
77
  // and 120fps the camera ends up in the same place after the same second.
52
78
  camera.position.lerp(desired, 1 - Math.exp(-dt / damping));
53
79
  camera.lookAt(aim.copy(target).add(lookAhead));
54
80
  };
55
81
 
56
- return { follow, snap };
82
+ return { dolly, follow, snap };
57
83
  }
@@ -0,0 +1,5 @@
1
+ // Generated for you. This is ordinary game-owned source — edit or delete it freely.
2
+ // Curves decide the feel of a motion, so they live beside the rest of the starter's look.
3
+
4
+ /** Raise the pickup quickly, then settle it gently onto its hover height. */
5
+ export const pickupRiseEase = (t: number): number => 1 - (1 - t) ** 3;