create-threenative 0.2.2 → 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
@@ -17,7 +17,12 @@
17
17
  { "entity": "chaser", "component": "steeringFinished", "equals": true },
18
18
  { "entity": "chaser.avoidance", "component": "steeringFinished", "equals": true },
19
19
  { "entity": "chaser.avoidance", "component": "routeComplete", "equals": true },
20
- { "entity": "chaser.avoidance", "component": "separation", "gte": 0.56, "allowTrivial": true }
20
+ {
21
+ "entity": "chaser.avoidance",
22
+ "component": "separation",
23
+ "gte": 0.56,
24
+ "allowTrivial": "The avoidance fixture starts outside the minimum separation; this row records that authored held spacing while steering completion proves the run."
25
+ }
21
26
  ]
22
27
  }
23
28
  }
@@ -0,0 +1,29 @@
1
+ {
2
+ "name": "platformer-branding-handoff",
3
+ "schemaVersion": 1,
4
+ "target": "web",
5
+ "viewport": { "width": 1280, "height": 720 },
6
+ "warmupFrames": 4,
7
+ "subject": "player",
8
+ "steps": [
9
+ { "kind": "wait", "label": "painted-playable-frame", "waitTicks": 12, "release": true }
10
+ ],
11
+ "assert": {
12
+ "diagnostics": {
13
+ "noConsoleErrors": true,
14
+ "noNetworkErrors": true,
15
+ "runtimeReady": true
16
+ },
17
+ "visual": [
18
+ {
19
+ "region": {
20
+ "x": 0,
21
+ "y": 0,
22
+ "width": 1280,
23
+ "height": 720,
24
+ "minNonblankPixelRatio": 0.01
25
+ }
26
+ }
27
+ ]
28
+ }
29
+ }
@@ -12,6 +12,6 @@
12
12
  ],
13
13
  "assert": {
14
14
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
15
- "resources": [{ "id": "GameState", "path": "jumps", "gte": 1, "changed": true }]
15
+ "resources": [{ "id": "state", "path": "jumps", "gte": 1, "changed": true }]
16
16
  }
17
17
  }
@@ -39,7 +39,7 @@
39
39
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
40
40
  "resources": [
41
41
  {
42
- "id": "GameState",
42
+ "id": "state",
43
43
  "path": "coins",
44
44
  "gte": 3,
45
45
  "changed": true,
@@ -22,14 +22,14 @@
22
22
  "movement": { "entity": "player", "minAxisDelta": { "axis": "+y", "min": 1.5 } },
23
23
  "resources": [
24
24
  {
25
- "id": "GameState",
25
+ "id": "state",
26
26
  "path": "coins",
27
27
  "atSteps": [
28
28
  { "label": "debris-filtered", "equals": 0 },
29
29
  { "label": "player-pickup", "equals": 1 }
30
30
  ]
31
31
  },
32
- { "id": "GameState", "path": "peakRise", "gte": 1.5, "changed": true }
32
+ { "id": "state", "path": "peakRise", "gte": 1.5, "changed": true }
33
33
  ],
34
34
  "signals": [{ "name": "collected", "entity": "player", "minCount": 1 }]
35
35
  }
@@ -2,20 +2,54 @@
2
2
  "name": "platformer-coyote",
3
3
  "schemaVersion": 1,
4
4
  "target": "web",
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", "press": "ArrowRight", "holdTicks": 92, "release": true },
10
- { "kind": "wait", "waitTicks": 8, "release": true },
11
- { "kind": "input", "press": "Space", "holdTicks": 2, "release": true },
12
- { "kind": "wait", "waitTicks": 20, "release": true }
12
+ {
13
+ "kind": "input",
14
+ "press": "ArrowRight",
15
+ "holdTicks": 92,
16
+ "release": true
17
+ },
18
+ {
19
+ "kind": "wait",
20
+ "waitTicks": 4,
21
+ "release": true
22
+ },
23
+ {
24
+ "kind": "input",
25
+ "press": "Space",
26
+ "holdTicks": 2,
27
+ "release": true
28
+ },
29
+ {
30
+ "kind": "wait",
31
+ "waitTicks": 20,
32
+ "release": true
33
+ }
13
34
  ],
14
35
  "assert": {
15
- "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
36
+ "diagnostics": {
37
+ "noConsoleErrors": true,
38
+ "runtimeReady": true
39
+ },
16
40
  "resources": [
17
- { "id": "GameState", "path": "jumps", "gte": 1, "changed": true },
18
- { "id": "GameState", "path": "coyoteJumps", "gte": 1, "changed": true }
41
+ {
42
+ "id": "state",
43
+ "path": "jumps",
44
+ "gte": 1,
45
+ "changed": true
46
+ },
47
+ {
48
+ "id": "state",
49
+ "path": "coyoteJumps",
50
+ "gte": 1,
51
+ "changed": true
52
+ }
19
53
  ]
20
54
  }
21
55
  }
@@ -5,6 +5,9 @@
5
5
  "viewport": { "width": 1280, "height": 720 },
6
6
  "warmupFrames": 10,
7
7
  "subject": "player",
8
+ "setup": {
9
+ "place": [{ "entity": "patrol", "at": { "x": 6.5, "y": 0.66, "z": 0 }, "frozen": true }]
10
+ },
8
11
  "steps": [
9
12
  { "kind": "input", "press": "ArrowRight", "holdTicks": 16, "release": true },
10
13
  {
@@ -25,7 +28,7 @@
25
28
  ],
26
29
  "assert": {
27
30
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
28
- "resources": [{ "id": "GameState", "path": "topSpeed", "gte": 1, "changed": true }],
31
+ "resources": [{ "id": "state", "path": "topSpeed", "gte": 1, "changed": true }],
29
32
  "components": [{ "entity": "player", "component": "health", "equals": 2, "changed": true }]
30
33
  }
31
34
  }
@@ -14,8 +14,8 @@
14
14
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
15
15
  "movement": { "entity": "player", "minAxisDelta": { "axis": "+x", "min": 2.5 } },
16
16
  "resources": [
17
- { "id": "GameState", "path": "dashes", "gte": 1, "changed": true },
18
- { "id": "GameState", "path": "topSpeed", "gte": 12, "changed": true }
17
+ { "id": "state", "path": "dashes", "gte": 1, "changed": true },
18
+ { "id": "state", "path": "topSpeed", "gte": 12, "changed": true }
19
19
  ]
20
20
  }
21
21
  }
@@ -11,11 +11,10 @@
11
11
  ],
12
12
  "assert": {
13
13
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
14
- "performance": {},
15
14
  "movement": { "entity": "player", "minAxisDelta": { "axis": "+y", "min": 1.5 } },
16
15
  "resources": [
17
- { "id": "GameState", "path": "jumps", "gte": 1, "changed": true },
18
- { "id": "GameState", "path": "peakRise", "gte": 1.5, "changed": true }
16
+ { "id": "state", "path": "jumps", "gte": 1, "changed": true },
17
+ { "id": "state", "path": "peakRise", "gte": 1.5, "changed": true }
19
18
  ]
20
19
  }
21
20
  }
@@ -0,0 +1,33 @@
1
+ {
2
+ "name": "platformer-touch-controls-native",
3
+ "schemaVersion": 1,
4
+ "target": "web",
5
+ "viewport": { "width": 1280, "height": 720 },
6
+ "warmupFrames": 10,
7
+ "subject": "player",
8
+ "artifacts": { "screenshots": "after" },
9
+ "steps": [
10
+ {
11
+ "label": "movement-anchor",
12
+ "pointers": [{ "id": 7, "x": 0.18, "y": 0.75 }],
13
+ "holdTicks": 2,
14
+ "release": false
15
+ },
16
+ {
17
+ "label": "simultaneous-move-and-jump",
18
+ "pointers": [{ "id": 7, "x": 0.3, "y": 0.75 }, { "id": 3, "x": 0.922, "y": 0.861 }],
19
+ "holdTicks": 45,
20
+ "release": true
21
+ },
22
+ { "label": "released", "kind": "wait", "waitTicks": 10, "release": true }
23
+ ],
24
+ "assert": {
25
+ "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
26
+ "movement": { "entity": "player", "minDistance": 0.5 },
27
+ "resources": [
28
+ { "id": "state", "path": "jumps", "gte": 1, "changed": true },
29
+ { "id": "state", "path": "playerX", "gte": 0.05, "changed": true }
30
+ ],
31
+ "visibility": [{ "entity": "touch-controls", "present": true }]
32
+ }
33
+ }
@@ -12,6 +12,6 @@
12
12
  "assert": {
13
13
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
14
14
  "movement": { "entity": "player", "minAxisDelta": { "axis": "+y", "min": 1.5 } },
15
- "resources": [{ "id": "GameState", "path": "peakRise", "gte": 1.5, "changed": true }]
15
+ "resources": [{ "id": "state", "path": "peakRise", "gte": 1.5, "changed": true }]
16
16
  }
17
17
  }
@@ -3,16 +3,17 @@
3
3
  "artifacts": { "screenshots": "after" },
4
4
  "assert": {
5
5
  "performance": {
6
- "maxDrawCalls": 180,
6
+ "maxDrawCalls": 200,
7
7
  "maxFrameMsP95": 33,
8
- "maxTriangles": 100000
9
- }
8
+ "maxTriangles": 7700
9
+ },
10
+ "renderChain": { "tier": "high" }
10
11
  },
11
12
  "name": "production-performance",
12
13
  "schemaVersion": 1,
13
14
  "steps": [
14
- { "kind": "input", "press": "ArrowRight", "holdFrames": 60, "release": true },
15
- { "kind": "wait", "waitFrames": 600, "release": true }
15
+ { "kind": "input", "press": "ArrowRight", "holdTicks": 60, "release": true },
16
+ { "kind": "wait", "waitTicks": 600, "release": true }
16
17
  ],
17
18
  "subject": "player",
18
19
  "target": "web",
@@ -24,8 +24,8 @@
24
24
  "reachesPositionWithin": { "position": [14, 0.75, 0], "maxDistance": 2 }
25
25
  },
26
26
  "resources": [
27
- { "id": "GameState", "path": "checkpoint", "equals": 1, "changed": true },
28
- { "id": "GameState", "path": "respawns", "gte": 1, "changed": true }
27
+ { "id": "state", "path": "checkpoint", "equals": 1, "changed": true },
28
+ { "id": "state", "path": "respawns", "gte": 1, "changed": true }
29
29
  ]
30
30
  }
31
31
  }
@@ -5,6 +5,9 @@
5
5
  "viewport": { "width": 1280, "height": 720 },
6
6
  "warmupFrames": 10,
7
7
  "subject": "player",
8
+ "setup": {
9
+ "place": [{ "entity": "patrol", "at": { "x": 6.5, "y": 0.66, "z": 0 }, "frozen": true }]
10
+ },
8
11
  "steps": [
9
12
  { "kind": "input", "press": "ArrowRight", "holdTicks": 16, "release": true },
10
13
  {
@@ -33,9 +36,20 @@
33
36
  "assert": {
34
37
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
35
38
  "resources": [
36
- { "id": "GameState", "path": "hearts", "equals": 2, "changed": true },
37
- { "id": "GameState", "path": "defeated", "equals": 0, "allowTrivial": true }
39
+ { "id": "state", "path": "hearts", "equals": 2, "changed": true },
40
+ {
41
+ "id": "state",
42
+ "path": "defeated",
43
+ "equals": 0,
44
+ "allowTrivial": "The rising stomp must not defeat the enemy; zero defeated is the intentional held invariant before the landing action completes."
45
+ }
38
46
  ],
39
- "tags": [{ "tag": "patrol", "count": 1 }]
47
+ "tags": [
48
+ {
49
+ "tag": "patrol",
50
+ "count": 1,
51
+ "allowTrivial": "The rising stomp intentionally leaves the patrol tag present until the landing action completes; the damage and held defeated assertions prove this intermediate state."
52
+ }
53
+ ]
40
54
  }
41
55
  }
@@ -5,6 +5,9 @@
5
5
  "viewport": { "width": 1280, "height": 720 },
6
6
  "warmupFrames": 10,
7
7
  "subject": "player",
8
+ "setup": {
9
+ "place": [{ "entity": "patrol", "at": { "x": 6.8, "y": 0.66, "z": 0 }, "frozen": true }]
10
+ },
8
11
  "steps": [
9
12
  {
10
13
  "kind": "input",
@@ -25,9 +28,14 @@
25
28
  "assert": {
26
29
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
27
30
  "resources": [
28
- { "id": "GameState", "path": "defeated", "gte": 1, "changed": true },
29
- { "id": "GameState", "path": "jumps", "gte": 1, "changed": true },
30
- { "id": "GameState", "path": "hearts", "equals": 3, "allowTrivial": true }
31
+ { "id": "state", "path": "defeated", "gte": 1, "changed": true },
32
+ { "id": "state", "path": "jumps", "gte": 1, "changed": true },
33
+ {
34
+ "id": "state",
35
+ "path": "hearts",
36
+ "equals": 3,
37
+ "allowTrivial": "A successful stomp should not damage the player; three hearts remains the intentional held invariant while defeat and jump prove the action."
38
+ }
31
39
  ],
32
40
  "tags": [{ "tag": "patrol", "count": 0 }]
33
41
  }
@@ -15,14 +15,23 @@
15
15
  { "kind": "input", "press": "ArrowLeft", "holdTicks": 80, "release": true },
16
16
  { "kind": "wait", "waitTicks": 80, "release": true },
17
17
  { "kind": "input", "press": "ArrowRight", "holdTicks": 80, "release": true },
18
- { "kind": "wait", "label": "fail-settled", "waitTicks": 80, "release": true }
18
+ { "kind": "wait", "waitTicks": 80, "release": true },
19
+ { "kind": "input", "press": "ArrowLeft", "holdTicks": 30, "release": true },
20
+ { "kind": "wait", "waitTicks": 60, "release": true },
21
+ { "kind": "input", "press": "ArrowRight", "holdTicks": 40, "release": true },
22
+ { "kind": "wait", "label": "fail-settled", "waitTicks": 120, "release": true }
19
23
  ],
20
24
  "assert": {
21
25
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
22
26
  "resources": [
23
- { "id": "GameState", "path": "terminal", "equals": 2, "changed": true },
24
- { "id": "GameState", "path": "hearts", "equals": 0, "changed": true },
25
- { "id": "GameState", "path": "respawns", "equals": 0, "allowTrivial": true }
27
+ { "id": "state", "path": "terminal", "equals": 2, "changed": true },
28
+ { "id": "state", "path": "hearts", "equals": 0, "changed": true },
29
+ {
30
+ "id": "state",
31
+ "path": "respawns",
32
+ "equals": 0,
33
+ "allowTrivial": "The terminal fail scenario ends before a respawn; zero respawns is the intentional held invariant for this failure path."
34
+ }
26
35
  ],
27
36
  "signals": [{ "entity": "game", "name": "lost", "minCount": 1 }]
28
37
  }
@@ -39,13 +39,13 @@
39
39
  "assert": {
40
40
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
41
41
  "resources": [
42
- { "id": "GameState", "path": "terminal", "equals": 1, "changed": true },
42
+ { "id": "state", "path": "terminal", "equals": 1, "changed": true },
43
43
  {
44
- "id": "GameState",
44
+ "id": "state",
45
45
  "path": "grounded",
46
46
  "atSteps": [{ "label": "reach-goal", "equals": true }]
47
47
  },
48
- { "id": "GameState", "path": "playerX", "gte": 21.5, "changed": true }
48
+ { "id": "state", "path": "playerX", "gte": 21.5, "changed": true }
49
49
  ],
50
50
  "signals": [{ "entity": "game", "name": "won", "minCount": 1 }]
51
51
  }
@@ -0,0 +1,46 @@
1
+ {
2
+ "name": "platformer-touch-controls-web",
3
+ "schemaVersion": 1,
4
+ "target": "web",
5
+ "viewport": { "width": 1280, "height": 720 },
6
+ "warmupFrames": 10,
7
+ "subject": "player",
8
+ "artifacts": { "screenshots": "after" },
9
+ "steps": [
10
+ {
11
+ "kind": "input",
12
+ "label": "keyboard-movement",
13
+ "press": "ArrowUp",
14
+ "holdTicks": 45,
15
+ "release": true
16
+ },
17
+ { "kind": "wait", "label": "settled", "waitTicks": 10, "release": true }
18
+ ],
19
+ "assert": {
20
+ "diagnostics": {
21
+ "noConsoleErrors": true,
22
+ "noNetworkErrors": true,
23
+ "noRuntimeDiagnostics": true,
24
+ "runtimeReady": true
25
+ },
26
+ "movement": { "entity": "player", "minDistance": 0.5 },
27
+ "visibility": [
28
+ {
29
+ "entity": "touch-controls",
30
+ "present": false,
31
+ "allowTrivial": "Web targets intentionally omit the native touch-controls entity; keyboard movement proves the web path while this absence remains held."
32
+ }
33
+ ],
34
+ "visual": [
35
+ {
36
+ "region": {
37
+ "x": 0,
38
+ "y": 0,
39
+ "width": 1280,
40
+ "height": 720,
41
+ "minNonblankPixelRatio": 0.01
42
+ }
43
+ }
44
+ ]
45
+ }
46
+ }
@@ -10,6 +10,11 @@ export const PLAYER_LAYER = 1;
10
10
  export const PLATFORMER_FEEL = {
11
11
  airAcceleration: 24,
12
12
  blinkRate: 18,
13
+ // 0.12s is 7.2 ticks at the 1/60 step. `playtests/coyote.playtest.json` waits 4 ticks after
14
+ // walking off the ledge before it jumps, which keeps the jump inside this window with margin.
15
+ // It waited 8 — longer than the window — and so asserted that a jump taken after coyote time
16
+ // still counts as one; it passed only when the player left the ledge late. If you change this
17
+ // number, change that wait with it.
13
18
  coyoteTime: 0.12,
14
19
  dashCooldown: 0.55,
15
20
  dashSpeed: 17,
@@ -50,6 +55,7 @@ export class Character {
50
55
  #airJumpUsed = false;
51
56
  #time = 0;
52
57
  #dashDirection = new Vector3(1, 0, 0);
58
+ #wants = new Vector3();
53
59
 
54
60
  constructor(ctx: GameCtx, spawn: Vector3) {
55
61
  this.mesh = new Group();
@@ -81,9 +87,12 @@ export class Character {
81
87
  this.#coyote = Math.max(0, this.#coyote - dt);
82
88
  this.#buffered = Math.max(0, this.#buffered - dt);
83
89
  const move = ctx.input.vector("move");
84
- if (touch !== undefined) move.add(touch.move).clampLength(0, 1);
85
- const wants = new Vector3(move.x, 0, -move.y);
86
- if (wants.lengthSq() > 1) wants.normalize();
90
+ this.#wants.set(move.x, 0, -move.y);
91
+ if (touch !== undefined) {
92
+ this.#wants.x += touch.move.x;
93
+ this.#wants.z -= touch.move.y;
94
+ }
95
+ if (this.#wants.lengthSq() > 1) this.#wants.normalize();
87
96
  if (this.body.grounded) {
88
97
  this.#coyote = PLATFORMER_FEEL.coyoteTime;
89
98
  this.#airJumpUsed = false;
@@ -95,10 +104,10 @@ export class Character {
95
104
  this.#dashCooldown <= 0 &&
96
105
  this.#dashTimer <= 0
97
106
  )
98
- this.#startDash(wants);
107
+ this.#startDash(this.#wants);
99
108
 
100
109
  if (this.#dashTimer > 0) this.#driveDash();
101
- else this.#driveWalk(wants, dt);
110
+ else this.#driveWalk(this.#wants, dt);
102
111
  this.#tryJump();
103
112
  this.body.moveAndSlide(dt);
104
113
  this.#face(dt);
@@ -154,11 +163,8 @@ export class Character {
154
163
  }
155
164
 
156
165
  #startDash(wants: Vector3): void {
157
- this.#dashDirection.copy(
158
- wants.lengthSq() > 0.01
159
- ? wants
160
- : new Vector3(Math.sin(this.#facing), 0, Math.cos(this.#facing)),
161
- );
166
+ if (wants.lengthSq() > 0.01) this.#dashDirection.copy(wants);
167
+ else this.#dashDirection.set(Math.sin(this.#facing), 0, Math.cos(this.#facing));
162
168
  this.#dashTimer = PLATFORMER_FEEL.dashTime;
163
169
  this.#dashCooldown = PLATFORMER_FEEL.dashCooldown;
164
170
  this.dashes += 1;
@@ -6,6 +6,7 @@ import type { GameState } from "../state.js";
6
6
  import type { Character, PLATFORMER_FEEL } from "./Character.js";
7
7
 
8
8
  type GameCtx = ICtx<GameState, IPhysicsContext>;
9
+ const PLAYTEST_FROZEN_MARKER = "__threenativeFrozen";
9
10
 
10
11
  export class Patrol {
11
12
  readonly mesh: Group;
@@ -60,6 +61,10 @@ export class Patrol {
60
61
 
61
62
  update(dt: number): void {
62
63
  if (this.defeated) return;
64
+ if (this.mesh.userData[PLAYTEST_FROZEN_MARKER] === true) {
65
+ this.area.setPosition(this.mesh.position);
66
+ return;
67
+ }
63
68
  const next = this.mesh.position.x + this.#direction * this.#feel.patrolSpeed * dt;
64
69
  if (next >= this.#to.x) {
65
70
  this.mesh.position.x = this.#to.x;
@@ -7,7 +7,7 @@ import { drainPlaytestEvents as events } from "./playtest-events.js";
7
7
  import { Boot } from "./scenes/Boot.js";
8
8
  import { Level } from "./scenes/Level.js";
9
9
  import type { GameState } from "./state.js";
10
- export default defineGame<GameState, IPhysicsContext>({
10
+ const game = defineGame<GameState, IPhysicsContext>({
11
11
  input: {
12
12
  // The four directions of `input.vector("move")`. Declared rather than inherited from the
13
13
  // default binding, so the axis every scene reads is visible where the game is defined.
@@ -21,7 +21,30 @@ export default defineGame<GameState, IPhysicsContext>({
21
21
  jump: { buttons: [0], keys: ["Space"] },
22
22
  },
23
23
  plugins: [rapier({ gravity: { x: 0, y: -26, z: 0 } }), playtest({ events })],
24
+ display: config.display,
24
25
  render: config.renderer,
25
26
  scenes: { boot: Boot, level: Level },
26
27
  start: "boot",
27
28
  });
29
+
30
+ export default game;
31
+
32
+ /**
33
+ * What the UI can ask the game to do.
34
+ *
35
+ * Intents are one-way and named by the game: the UI sends `restart`, `pause` or `resume` and the
36
+ * game decides what each means. Nothing comes back this way — the UI reads the game's published
37
+ * state instead, which keeps one source of truth on the side that owns the simulation.
38
+ */
39
+ game.ui.onIntent((intent) => {
40
+ if (intent === "restart") void game.goto("level");
41
+ if (intent === "pause") game.pause();
42
+ if (intent === "resume") game.resume();
43
+ game.state.set({
44
+ // `game.ui.connected` is true only once the UI announced itself, which is what tells an
45
+ // overlay that never came up apart from a game whose HUD is simply empty.
46
+ uiReady: game.ui.connected,
47
+ ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
48
+ });
49
+ game.state.flush();
50
+ });
@@ -9,7 +9,10 @@ import { palette } from "./palette.js";
9
9
 
10
10
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
11
11
 
12
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
12
+ // Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
13
+ // the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
14
+ // rendering a black pass.
15
+ export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
13
16
  renderer.shadowMap.enabled = true;
14
17
  renderer.shadowMap.type = PCFSoftShadowMap;
15
18
  scene.add(new HemisphereLight(palette.skyHigh, palette.shadow, 1.4));
@@ -35,4 +38,6 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
35
38
  rim.position.set(-5, 4, -7);
36
39
  scene.add(rim);
37
40
  scene.add(new AmbientLight(palette.shadow, 0.24));
41
+
42
+ return key;
38
43
  }