create-threenative 0.2.2 → 0.2.4

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 (588) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +61 -2
  3. package/agent-docs/references/assertion-reference.md +819 -0
  4. package/agent-docs/references/capability-reference.md +4483 -0
  5. package/agent-docs/references/capture-the-frame.md +60 -0
  6. package/agent-docs/references/creating-creatures.md +215 -0
  7. package/agent-docs/references/ctx-cookbook.md +120 -0
  8. package/agent-docs/references/debug-surface.md +68 -0
  9. package/agent-docs/references/dream-loop.md +150 -0
  10. package/agent-docs/references/finding-assets.md +215 -0
  11. package/agent-docs/references/gameplay-recipes.md +54 -0
  12. package/agent-docs/references/menu-screens.md +69 -0
  13. package/agent-docs/references/mobile-memory-budget.md +87 -0
  14. package/agent-docs/references/sculpt-from-a-reference.md +40 -0
  15. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  16. package/agent-docs/references/visual-baseline.md +174 -0
  17. package/agent-docs/references/webview-ui.md +113 -0
  18. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  19. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  20. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  21. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  22. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  23. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  24. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  25. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  26. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  27. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  28. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  29. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  30. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  31. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  32. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  33. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  34. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  35. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  36. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  37. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  38. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  39. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  40. package/agent-files/.threenative/agents/builder.md +32 -0
  41. package/agent-files/.threenative/agents/verifier.md +31 -0
  42. package/agent-files/AGENT-ROLES.md +26 -0
  43. package/agent-files/scripts/reference.mjs +705 -0
  44. package/agent-files/scripts/visual-loop.mjs +382 -0
  45. package/capabilities.json +5292 -0
  46. package/dist/index.d.ts +224 -3
  47. package/dist/index.js +1972 -73
  48. package/dist/threenative.d.ts +9 -2
  49. package/dist/threenative.js +2570 -176
  50. package/package.json +55 -6
  51. package/template-assets/icon.png +0 -0
  52. package/template-assets/loading.ts +325 -0
  53. package/template-assets/patches/three@0.185.1.patch +522 -0
  54. package/template-assets/worldEnvironment.ts +758 -0
  55. package/templates/action-rpg/.codex/config.toml +19 -0
  56. package/templates/action-rpg/.cursor/mcp.json +32 -0
  57. package/templates/action-rpg/.gemini/settings.json +32 -0
  58. package/templates/action-rpg/.mcp.json +18 -2
  59. package/templates/action-rpg/.vscode/mcp.json +36 -0
  60. package/templates/action-rpg/.zed/settings.json +36 -0
  61. package/templates/action-rpg/AGENTS.md +84 -29
  62. package/templates/action-rpg/CLAUDE.md +84 -29
  63. package/templates/action-rpg/index.html +0 -1
  64. package/templates/action-rpg/opencode.json +41 -0
  65. package/templates/action-rpg/package.json +15 -11
  66. package/templates/action-rpg/playtests/combat.playtest.json +32 -9
  67. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  68. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  69. package/templates/action-rpg/playtests/performance.playtest.json +39 -0
  70. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  71. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  72. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  73. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  74. package/templates/action-rpg/src/conventions.ts +35 -0
  75. package/templates/action-rpg/src/entities/Enemy.ts +16 -7
  76. package/templates/action-rpg/src/entities/Player.ts +20 -3
  77. package/templates/action-rpg/src/game.ts +21 -0
  78. package/templates/action-rpg/src/render/camera.ts +7 -2
  79. package/templates/action-rpg/src/render/lighting.ts +11 -4
  80. package/templates/action-rpg/src/render/loading.ts +278 -43
  81. package/templates/action-rpg/src/render/materials.ts +11 -0
  82. package/templates/action-rpg/src/render/palette.ts +10 -3
  83. package/templates/action-rpg/src/render/postprocessing.ts +32 -16
  84. package/templates/action-rpg/src/render/quality.ts +170 -0
  85. package/templates/action-rpg/src/render/shapes.ts +185 -26
  86. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  87. package/templates/action-rpg/src/render/vfx.ts +257 -0
  88. package/templates/action-rpg/src/render/worldEnvironment.ts +758 -0
  89. package/templates/action-rpg/src/scenes/Play.ts +91 -24
  90. package/templates/action-rpg/src/state.ts +4 -0
  91. package/templates/action-rpg/src/style.css +65 -1
  92. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  93. package/templates/action-rpg/src/ui/App.tsx +9 -8
  94. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  95. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  96. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  97. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  98. package/templates/action-rpg/src/ui/main.tsx +14 -0
  99. package/templates/action-rpg/threenative.config.ts +28 -8
  100. package/templates/action-rpg/vite.config.ts +32 -2
  101. package/templates/defense/.codex/config.toml +19 -0
  102. package/templates/defense/.cursor/mcp.json +32 -0
  103. package/templates/defense/.gemini/settings.json +32 -0
  104. package/templates/defense/.mcp.json +18 -2
  105. package/templates/defense/.vscode/mcp.json +36 -0
  106. package/templates/defense/.zed/settings.json +36 -0
  107. package/templates/defense/AGENTS.md +81 -41
  108. package/templates/defense/CLAUDE.md +81 -41
  109. package/templates/defense/README.md +2 -1
  110. package/templates/defense/index.html +0 -1
  111. package/templates/defense/opencode.json +41 -0
  112. package/templates/defense/package.json +16 -12
  113. package/templates/defense/playtests/leak.playtest.json +9 -4
  114. package/templates/defense/playtests/performance.playtest.json +39 -0
  115. package/templates/defense/playtests/placement.playtest.json +5 -5
  116. package/templates/defense/playtests/pointer-placement.playtest.json +156 -0
  117. package/templates/defense/playtests/scan.playtest.json +4 -4
  118. package/templates/defense/playtests/survive.playtest.json +25 -6
  119. package/templates/defense/src/attackers/Attacker.ts +32 -16
  120. package/templates/defense/src/board/Route.ts +22 -8
  121. package/templates/defense/src/conventions.ts +18 -0
  122. package/templates/defense/src/entities/Player.ts +11 -3
  123. package/templates/defense/src/game.ts +25 -4
  124. package/templates/defense/src/physics.ts +9 -39
  125. package/templates/defense/src/placement/Buildable.ts +4 -4
  126. package/templates/defense/src/render/camera.ts +9 -3
  127. package/templates/defense/src/render/lighting.ts +6 -1
  128. package/templates/defense/src/render/loading.ts +274 -38
  129. package/templates/defense/src/render/materials.ts +9 -0
  130. package/templates/defense/src/render/palette.ts +12 -5
  131. package/templates/defense/src/render/postprocessing.ts +32 -12
  132. package/templates/defense/src/render/quality.ts +170 -0
  133. package/templates/defense/src/render/shapes.ts +180 -23
  134. package/templates/defense/src/render/sky.ts +2 -2
  135. package/templates/defense/src/render/worldEnvironment.ts +758 -0
  136. package/templates/defense/src/scenes/Boot.ts +2 -2
  137. package/templates/defense/src/scenes/Defense.ts +122 -56
  138. package/templates/defense/src/state.ts +6 -0
  139. package/templates/defense/src/style.css +65 -1
  140. package/templates/defense/src/towers/Tower.ts +11 -12
  141. package/templates/defense/src/towers/targeting.ts +1 -1
  142. package/templates/defense/src/ui/App.tsx +11 -6
  143. package/templates/defense/src/ui/GameUi.tsx +20 -0
  144. package/templates/defense/src/ui/Hud.tsx +6 -5
  145. package/templates/defense/src/ui/main.tsx +14 -0
  146. package/templates/defense/threenative.config.ts +28 -8
  147. package/templates/defense/vite.config.ts +34 -1
  148. package/templates/minimal/.codex/config.toml +19 -0
  149. package/templates/minimal/.cursor/mcp.json +32 -0
  150. package/templates/minimal/.gemini/settings.json +32 -0
  151. package/templates/minimal/.mcp.json +18 -2
  152. package/templates/minimal/.vscode/mcp.json +36 -0
  153. package/templates/minimal/.zed/settings.json +36 -0
  154. package/templates/minimal/AGENTS.md +78 -382
  155. package/templates/minimal/CLAUDE.md +78 -382
  156. package/templates/minimal/index.html +0 -1
  157. package/templates/minimal/opencode.json +41 -0
  158. package/templates/minimal/package.json +14 -11
  159. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  160. package/templates/minimal/playtests/play.playtest.json +18 -5
  161. package/templates/minimal/playtests/survives.playtest.json +48 -4
  162. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  163. package/templates/minimal/src/conventions.ts +18 -0
  164. package/templates/minimal/src/entities/Player.ts +39 -6
  165. package/templates/minimal/src/game.ts +1 -0
  166. package/templates/minimal/src/main.ts +14 -4
  167. package/templates/minimal/src/render/camera.ts +1 -1
  168. package/templates/minimal/src/render/hud.ts +24 -8
  169. package/templates/minimal/src/render/lighting.ts +23 -2
  170. package/templates/minimal/src/render/loading.ts +23 -103
  171. package/templates/minimal/src/render/materials.ts +7 -0
  172. package/templates/minimal/src/render/palette.ts +3 -3
  173. package/templates/minimal/src/render/postprocessing.ts +55 -16
  174. package/templates/minimal/src/render/quality.ts +162 -0
  175. package/templates/minimal/src/render/sky.ts +51 -32
  176. package/templates/minimal/src/render/touch-controls.ts +165 -0
  177. package/templates/minimal/src/render/worldEnvironment.ts +758 -0
  178. package/templates/minimal/src/scenes/Play.ts +128 -14
  179. package/templates/minimal/src/state.ts +8 -1
  180. package/templates/minimal/src/style.css +20 -0
  181. package/templates/minimal/threenative.config.ts +22 -10
  182. package/templates/minimal/vite.config.ts +28 -1
  183. package/templates/platformer/.codex/config.toml +19 -0
  184. package/templates/platformer/.cursor/mcp.json +32 -0
  185. package/templates/platformer/.gemini/settings.json +32 -0
  186. package/templates/platformer/.mcp.json +18 -2
  187. package/templates/platformer/.vscode/mcp.json +36 -0
  188. package/templates/platformer/.zed/settings.json +36 -0
  189. package/templates/platformer/AGENTS.md +81 -186
  190. package/templates/platformer/CLAUDE.md +81 -186
  191. package/templates/platformer/index.html +0 -1
  192. package/templates/platformer/opencode.json +41 -0
  193. package/templates/platformer/package.json +17 -14
  194. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  195. package/templates/platformer/playtests/branding.playtest.json +29 -0
  196. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  197. package/templates/platformer/playtests/collect.playtest.json +1 -1
  198. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  199. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  200. package/templates/platformer/playtests/damage.playtest.json +4 -1
  201. package/templates/platformer/playtests/dash.playtest.json +2 -2
  202. package/templates/platformer/playtests/jump.playtest.json +2 -3
  203. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  204. package/templates/platformer/playtests/oneway.playtest.json +30 -3
  205. package/templates/platformer/playtests/performance.playtest.json +7 -5
  206. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  207. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  208. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  209. package/templates/platformer/playtests/survives.playtest.json +31 -0
  210. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +16 -4
  211. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  212. package/templates/platformer/playtests/touch-controls-web.playtest.json +57 -0
  213. package/templates/platformer/src/conventions.ts +18 -0
  214. package/templates/platformer/src/entities/Character.ts +79 -11
  215. package/templates/platformer/src/entities/Patrol.ts +5 -0
  216. package/templates/platformer/src/game.ts +27 -2
  217. package/templates/platformer/src/level/Platform.ts +13 -1
  218. package/templates/platformer/src/render/lighting.ts +13 -5
  219. package/templates/platformer/src/render/loading.ts +281 -62
  220. package/templates/platformer/src/render/palette.ts +4 -1
  221. package/templates/platformer/src/render/postprocessing.ts +42 -14
  222. package/templates/platformer/src/render/quality.ts +170 -0
  223. package/templates/platformer/src/render/touch-controls.ts +54 -36
  224. package/templates/platformer/src/render/worldEnvironment.ts +758 -0
  225. package/templates/platformer/src/scenes/Level.ts +97 -32
  226. package/templates/platformer/src/state.ts +4 -0
  227. package/templates/platformer/src/style.css +65 -1
  228. package/templates/platformer/src/ui/App.tsx +9 -4
  229. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  230. package/templates/platformer/src/ui/Hud.tsx +6 -5
  231. package/templates/platformer/src/ui/main.tsx +14 -0
  232. package/templates/platformer/threenative.config.ts +27 -10
  233. package/templates/platformer/vite.config.ts +34 -1
  234. package/templates/puzzle/.codex/config.toml +19 -0
  235. package/templates/puzzle/.cursor/mcp.json +32 -0
  236. package/templates/puzzle/.gemini/settings.json +32 -0
  237. package/templates/puzzle/.mcp.json +32 -0
  238. package/templates/puzzle/.vscode/mcp.json +36 -0
  239. package/templates/puzzle/.zed/settings.json +36 -0
  240. package/templates/puzzle/AGENTS.md +96 -0
  241. package/templates/puzzle/CLAUDE.md +98 -0
  242. package/templates/puzzle/README.md +43 -0
  243. package/templates/puzzle/index.html +12 -0
  244. package/templates/puzzle/kit.json +7 -0
  245. package/templates/puzzle/opencode.json +41 -0
  246. package/templates/puzzle/package.json +50 -0
  247. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  248. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  249. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  250. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  251. package/templates/puzzle/public/favicon.svg +5 -0
  252. package/templates/puzzle/src/conventions.ts +25 -0
  253. package/templates/puzzle/src/entities/Ball.ts +70 -0
  254. package/templates/puzzle/src/entities/Crate.ts +76 -0
  255. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  256. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  257. package/templates/puzzle/src/game.ts +48 -0
  258. package/templates/puzzle/src/main.ts +15 -0
  259. package/templates/puzzle/src/physics.ts +19 -0
  260. package/templates/puzzle/src/render/camera.ts +37 -0
  261. package/templates/puzzle/src/render/lighting.ts +55 -0
  262. package/templates/puzzle/src/render/loading.ts +325 -0
  263. package/templates/puzzle/src/render/materials.ts +28 -0
  264. package/templates/puzzle/src/render/palette.ts +31 -0
  265. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  266. package/templates/puzzle/src/render/quality.ts +170 -0
  267. package/templates/puzzle/src/render/shapes.ts +134 -0
  268. package/templates/puzzle/src/render/sky.ts +16 -0
  269. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  270. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  271. package/templates/puzzle/src/room.ts +83 -0
  272. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  273. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  274. package/templates/puzzle/src/state.ts +30 -0
  275. package/templates/puzzle/src/style.css +96 -0
  276. package/templates/puzzle/src/ui/App.tsx +22 -0
  277. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  278. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  279. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  280. package/templates/puzzle/src/ui/main.tsx +14 -0
  281. package/templates/puzzle/tailwind.config.ts +1 -0
  282. package/templates/puzzle/threenative.config.ts +49 -0
  283. package/templates/puzzle/tsconfig.json +17 -0
  284. package/templates/puzzle/vite.config.ts +38 -0
  285. package/templates/racing/.codex/config.toml +19 -0
  286. package/templates/racing/.cursor/mcp.json +32 -0
  287. package/templates/racing/.gemini/settings.json +32 -0
  288. package/templates/racing/.mcp.json +18 -2
  289. package/templates/racing/.vscode/mcp.json +36 -0
  290. package/templates/racing/.zed/settings.json +36 -0
  291. package/templates/racing/AGENTS.md +84 -36
  292. package/templates/racing/CLAUDE.md +84 -36
  293. package/templates/racing/index.html +0 -1
  294. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  295. package/templates/racing/opencode.json +41 -0
  296. package/templates/racing/package.json +17 -12
  297. package/templates/racing/playtests/boost.playtest.json +5 -5
  298. package/templates/racing/playtests/outcome.playtest.json +14 -4
  299. package/templates/racing/playtests/performance.playtest.json +39 -0
  300. package/templates/racing/playtests/ranking.playtest.json +2 -2
  301. package/templates/racing/playtests/rescue.playtest.json +12 -6
  302. package/templates/racing/playtests/reverse.playtest.json +3 -3
  303. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  304. package/templates/racing/playtests/survives.playtest.json +36 -4
  305. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  306. package/templates/racing/src/conventions.ts +6 -0
  307. package/templates/racing/src/entities/RacingCar.ts +16 -4
  308. package/templates/racing/src/entities/Rival.ts +5 -2
  309. package/templates/racing/src/game.ts +24 -1
  310. package/templates/racing/src/render/camera.ts +15 -8
  311. package/templates/racing/src/render/lighting.ts +28 -14
  312. package/templates/racing/src/render/loading.ts +302 -35
  313. package/templates/racing/src/render/materials.ts +54 -4
  314. package/templates/racing/src/render/palette.ts +23 -6
  315. package/templates/racing/src/render/postprocessing.ts +32 -12
  316. package/templates/racing/src/render/quality.ts +170 -0
  317. package/templates/racing/src/render/shapes.ts +537 -26
  318. package/templates/racing/src/render/sky.ts +5 -2
  319. package/templates/racing/src/render/touch-controls.ts +185 -0
  320. package/templates/racing/src/render/worldEnvironment.ts +758 -0
  321. package/templates/racing/src/scenes/Race.ts +84 -37
  322. package/templates/racing/src/state.ts +4 -0
  323. package/templates/racing/src/style.css +65 -1
  324. package/templates/racing/src/track/Lap.ts +20 -9
  325. package/templates/racing/src/track/Ranking.ts +53 -14
  326. package/templates/racing/src/track/Track.ts +284 -32
  327. package/templates/racing/src/track/TrackSector.ts +14 -4
  328. package/templates/racing/src/ui/App.tsx +9 -4
  329. package/templates/racing/src/ui/GameUi.tsx +20 -0
  330. package/templates/racing/src/ui/Hud.tsx +6 -5
  331. package/templates/racing/src/ui/main.tsx +14 -0
  332. package/templates/racing/threenative.config.ts +28 -8
  333. package/templates/racing/vite.config.ts +34 -1
  334. package/templates/runner/.codex/config.toml +19 -0
  335. package/templates/runner/.cursor/mcp.json +32 -0
  336. package/templates/runner/.gemini/settings.json +32 -0
  337. package/templates/runner/.mcp.json +32 -0
  338. package/templates/runner/.vscode/mcp.json +36 -0
  339. package/templates/runner/.zed/settings.json +36 -0
  340. package/templates/runner/AGENTS.md +96 -0
  341. package/templates/runner/CLAUDE.md +98 -0
  342. package/templates/runner/README.md +43 -0
  343. package/templates/runner/index.html +12 -0
  344. package/templates/runner/kit.json +7 -0
  345. package/templates/runner/opencode.json +41 -0
  346. package/templates/runner/package.json +50 -0
  347. package/templates/runner/playtests/performance.playtest.json +23 -0
  348. package/templates/runner/playtests/streams.playtest.json +38 -0
  349. package/templates/runner/playtests/survives.playtest.json +51 -0
  350. package/templates/runner/public/favicon.svg +5 -0
  351. package/templates/runner/src/conventions.ts +24 -0
  352. package/templates/runner/src/entities/Runner.ts +135 -0
  353. package/templates/runner/src/game.ts +50 -0
  354. package/templates/runner/src/main.ts +15 -0
  355. package/templates/runner/src/physics.ts +13 -0
  356. package/templates/runner/src/render/camera.ts +39 -0
  357. package/templates/runner/src/render/dust.ts +131 -0
  358. package/templates/runner/src/render/lighting.ts +57 -0
  359. package/templates/runner/src/render/loading.ts +325 -0
  360. package/templates/runner/src/render/materials.ts +27 -0
  361. package/templates/runner/src/render/palette.ts +30 -0
  362. package/templates/runner/src/render/postprocessing.ts +34 -0
  363. package/templates/runner/src/render/quality.ts +170 -0
  364. package/templates/runner/src/render/shapes.ts +68 -0
  365. package/templates/runner/src/render/sky.ts +51 -0
  366. package/templates/runner/src/render/touch-controls.ts +185 -0
  367. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  368. package/templates/runner/src/scenes/Boot.ts +12 -0
  369. package/templates/runner/src/scenes/Run.ts +142 -0
  370. package/templates/runner/src/state.ts +29 -0
  371. package/templates/runner/src/style.css +96 -0
  372. package/templates/runner/src/track.ts +176 -0
  373. package/templates/runner/src/ui/App.tsx +22 -0
  374. package/templates/runner/src/ui/GameUi.tsx +20 -0
  375. package/templates/runner/src/ui/Hud.tsx +55 -0
  376. package/templates/runner/src/ui/Menu.tsx +7 -0
  377. package/templates/runner/src/ui/main.tsx +14 -0
  378. package/templates/runner/tailwind.config.ts +1 -0
  379. package/templates/runner/threenative.config.ts +49 -0
  380. package/templates/runner/tsconfig.json +17 -0
  381. package/templates/runner/vite.config.ts +38 -0
  382. package/templates/sailing/.codex/config.toml +19 -0
  383. package/templates/sailing/.cursor/mcp.json +32 -0
  384. package/templates/sailing/.gemini/settings.json +32 -0
  385. package/templates/sailing/.mcp.json +32 -0
  386. package/templates/sailing/.vscode/mcp.json +36 -0
  387. package/templates/sailing/.zed/settings.json +36 -0
  388. package/templates/sailing/AGENTS.md +95 -0
  389. package/templates/sailing/CLAUDE.md +97 -0
  390. package/templates/sailing/README.md +28 -0
  391. package/templates/sailing/index.html +12 -0
  392. package/templates/sailing/kit.json +7 -0
  393. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  394. package/templates/sailing/native-playtests/survives.playtest.json +38 -0
  395. package/templates/sailing/opencode.json +41 -0
  396. package/templates/sailing/package.json +52 -0
  397. package/templates/sailing/playtests/fail.playtest.json +24 -0
  398. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  399. package/templates/sailing/playtests/float.playtest.json +59 -0
  400. package/templates/sailing/playtests/performance.playtest.json +36 -0
  401. package/templates/sailing/playtests/survives.playtest.json +46 -0
  402. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  403. package/templates/sailing/playtests/win.playtest.json +31 -0
  404. package/templates/sailing/public/favicon.svg +5 -0
  405. package/templates/sailing/src/conventions.ts +8 -0
  406. package/templates/sailing/src/entities/Ship.ts +233 -0
  407. package/templates/sailing/src/game.ts +40 -0
  408. package/templates/sailing/src/main.ts +15 -0
  409. package/templates/sailing/src/render/camera.ts +28 -0
  410. package/templates/sailing/src/render/lighting.ts +41 -0
  411. package/templates/sailing/src/render/loading.ts +325 -0
  412. package/templates/sailing/src/render/materials.ts +44 -0
  413. package/templates/sailing/src/render/ocean.ts +179 -0
  414. package/templates/sailing/src/render/palette.ts +17 -0
  415. package/templates/sailing/src/render/postprocessing.ts +34 -0
  416. package/templates/sailing/src/render/props.ts +602 -0
  417. package/templates/sailing/src/render/quality.ts +140 -0
  418. package/templates/sailing/src/render/sky.ts +37 -0
  419. package/templates/sailing/src/render/touch-controls.ts +142 -0
  420. package/templates/sailing/src/render/worldEnvironment.ts +758 -0
  421. package/templates/sailing/src/scenes/Boot.ts +12 -0
  422. package/templates/sailing/src/scenes/Sailing.ts +133 -0
  423. package/templates/sailing/src/state.ts +10 -0
  424. package/templates/sailing/src/style.css +81 -0
  425. package/templates/sailing/src/ui/App.tsx +15 -0
  426. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  427. package/templates/sailing/src/ui/Hud.tsx +55 -0
  428. package/templates/sailing/src/ui/Menu.tsx +30 -0
  429. package/templates/sailing/src/ui/main.tsx +7 -0
  430. package/templates/sailing/tailwind.config.ts +2 -0
  431. package/templates/sailing/threenative.config.ts +40 -0
  432. package/templates/sailing/tsconfig.json +17 -0
  433. package/templates/sailing/vite.config.ts +34 -0
  434. package/templates/shooter/.codex/config.toml +19 -0
  435. package/templates/shooter/.cursor/mcp.json +32 -0
  436. package/templates/shooter/.gemini/settings.json +32 -0
  437. package/templates/shooter/.mcp.json +18 -2
  438. package/templates/shooter/.vscode/mcp.json +36 -0
  439. package/templates/shooter/.zed/settings.json +36 -0
  440. package/templates/shooter/AGENTS.md +81 -54
  441. package/templates/shooter/CLAUDE.md +81 -54
  442. package/templates/shooter/index.html +0 -1
  443. package/templates/shooter/kit.json +2 -2
  444. package/templates/shooter/opencode.json +41 -0
  445. package/templates/shooter/package.json +16 -11
  446. package/templates/shooter/playtests/combat.playtest.json +48 -0
  447. package/templates/shooter/playtests/fail.playtest.json +5 -4
  448. package/templates/shooter/playtests/input-control.playtest.json +261 -0
  449. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  450. package/templates/shooter/playtests/performance.playtest.json +39 -0
  451. package/templates/shooter/playtests/shooter.playtest.json +31 -21
  452. package/templates/shooter/playtests/survives.playtest.json +28 -1
  453. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  454. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  455. package/templates/shooter/public/favicon.svg +1 -1
  456. package/templates/shooter/src/combat/damage.ts +1 -2
  457. package/templates/shooter/src/conventions.ts +51 -0
  458. package/templates/shooter/src/entities/Player.ts +235 -18
  459. package/templates/shooter/src/entities/Target.ts +2 -2
  460. package/templates/shooter/src/game.ts +35 -3
  461. package/templates/shooter/src/main.ts +3 -13
  462. package/templates/shooter/src/render/camera.ts +78 -18
  463. package/templates/shooter/src/render/decals.ts +211 -0
  464. package/templates/shooter/src/render/lighting.ts +13 -4
  465. package/templates/shooter/src/render/loading.ts +274 -35
  466. package/templates/shooter/src/render/materials.ts +56 -3
  467. package/templates/shooter/src/render/palette.ts +6 -3
  468. package/templates/shooter/src/render/postprocessing.ts +32 -17
  469. package/templates/shooter/src/render/quality.ts +170 -0
  470. package/templates/shooter/src/render/scale.ts +22 -0
  471. package/templates/shooter/src/render/shapes.ts +519 -60
  472. package/templates/shooter/src/render/sky.ts +5 -1
  473. package/templates/shooter/src/render/touch-controls.ts +305 -0
  474. package/templates/shooter/src/render/ui.css +119 -1
  475. package/templates/shooter/src/render/ui.ts +19 -3
  476. package/templates/shooter/src/render/vfx.ts +215 -0
  477. package/templates/shooter/src/render/worldEnvironment.ts +758 -0
  478. package/templates/shooter/src/scenes/Play.ts +385 -97
  479. package/templates/shooter/src/state.ts +18 -0
  480. package/templates/shooter/src/style.css +46 -0
  481. package/templates/shooter/src/ui/App.tsx +10 -12
  482. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  483. package/templates/shooter/src/ui/GameUi.tsx +22 -0
  484. package/templates/shooter/src/ui/Hud.tsx +14 -10
  485. package/templates/shooter/src/ui/Menu.tsx +24 -9
  486. package/templates/shooter/src/ui/main.tsx +15 -0
  487. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  488. package/templates/shooter/src/weapons/Projectile.ts +29 -13
  489. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  490. package/templates/shooter/threenative.config.ts +28 -8
  491. package/templates/shooter/vite.config.ts +32 -2
  492. package/templates/starter/.codex/config.toml +19 -0
  493. package/templates/starter/.cursor/mcp.json +32 -0
  494. package/templates/starter/.gemini/settings.json +32 -0
  495. package/templates/starter/.mcp.json +18 -2
  496. package/templates/starter/.vscode/mcp.json +36 -0
  497. package/templates/starter/.zed/settings.json +36 -0
  498. package/templates/starter/AGENTS.md +72 -426
  499. package/templates/starter/CLAUDE.md +72 -426
  500. package/templates/starter/assets/pickup.wav +0 -0
  501. package/templates/starter/gitignore +4 -0
  502. package/templates/starter/index.html +0 -1
  503. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  504. package/templates/starter/native-playtests/render-chain.playtest.json +81 -0
  505. package/templates/starter/opencode.json +41 -0
  506. package/templates/starter/package.json +16 -12
  507. package/templates/starter/playtests/assets.playtest.json +65 -0
  508. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  509. package/templates/starter/playtests/buffer.playtest.json +59 -9
  510. package/templates/starter/playtests/cloth.playtest.json +113 -0
  511. package/templates/starter/playtests/coyote.playtest.json +60 -8
  512. package/templates/starter/playtests/forward.playtest.json +29 -4
  513. package/templates/starter/playtests/gameover.playtest.json +66 -0
  514. package/templates/starter/playtests/goal.playtest.json +67 -0
  515. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  516. package/templates/starter/playtests/look.playtest.json +142 -10
  517. package/templates/starter/playtests/models-baseline.png +0 -0
  518. package/templates/starter/playtests/models.playtest.json +74 -0
  519. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  520. package/templates/starter/playtests/odometer.playtest.json +54 -0
  521. package/templates/starter/playtests/pause.playtest.json +27 -4
  522. package/templates/starter/playtests/play.playtest.json +44 -7
  523. package/templates/starter/playtests/respawn.playtest.json +46 -6
  524. package/templates/starter/playtests/restart.playtest.json +65 -10
  525. package/templates/starter/playtests/seed.playtest.json +44 -8
  526. package/templates/starter/playtests/survives.playtest.json +48 -4
  527. package/templates/starter/playtests/textures-baseline.png +0 -0
  528. package/templates/starter/playtests/textures.playtest.json +74 -0
  529. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  530. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  531. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  532. package/templates/starter/src/conventions.ts +18 -0
  533. package/templates/starter/src/entities/Goal.ts +137 -0
  534. package/templates/starter/src/entities/Player.ts +111 -10
  535. package/templates/starter/src/game.ts +27 -0
  536. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  537. package/templates/starter/src/render/camera.ts +31 -5
  538. package/templates/starter/src/render/coast.ts +199 -0
  539. package/templates/starter/src/render/easing.ts +5 -0
  540. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  541. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  542. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  543. package/templates/starter/src/render/hero.ts +88 -0
  544. package/templates/starter/src/render/implicitSurface.ts +199 -0
  545. package/templates/starter/src/render/kuwahara.ts +174 -0
  546. package/templates/starter/src/render/lighting.ts +10 -5
  547. package/templates/starter/src/render/loading.ts +325 -0
  548. package/templates/starter/src/render/materials.ts +39 -4
  549. package/templates/starter/src/render/outline.ts +141 -0
  550. package/templates/starter/src/render/painterly.ts +86 -0
  551. package/templates/starter/src/render/palette.ts +15 -6
  552. package/templates/starter/src/render/pennant.ts +54 -0
  553. package/templates/starter/src/render/postprocessing.ts +97 -15
  554. package/templates/starter/src/render/quality.ts +185 -0
  555. package/templates/starter/src/render/rockRidge.ts +198 -0
  556. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  557. package/templates/starter/src/render/scenery.ts +40 -0
  558. package/templates/starter/src/render/shapes.ts +9 -21
  559. package/templates/starter/src/render/textureLifetime.ts +53 -0
  560. package/templates/starter/src/render/touch-controls.ts +165 -0
  561. package/templates/starter/src/render/water.ts +38 -0
  562. package/templates/starter/src/render/watercolor.ts +85 -0
  563. package/templates/starter/src/render/worldEnvironment.ts +758 -0
  564. package/templates/starter/src/scenes/Play.ts +243 -46
  565. package/templates/starter/src/state.ts +12 -0
  566. package/templates/starter/src/style.css +72 -8
  567. package/templates/starter/src/ui/App.tsx +9 -6
  568. package/templates/starter/src/ui/GameUi.tsx +20 -0
  569. package/templates/starter/src/ui/Hud.tsx +52 -29
  570. package/templates/starter/src/ui/Menu.tsx +25 -23
  571. package/templates/starter/src/ui/main.tsx +14 -0
  572. package/templates/starter/threenative.config.ts +27 -9
  573. package/templates/starter/tools/look.mjs +109 -0
  574. package/templates/starter/vite.config.ts +32 -2
  575. package/templates/action-rpg/src/physics.ts +0 -40
  576. package/templates/minimal/assets/.gitkeep +0 -0
  577. package/templates/minimal/public/.gitkeep +0 -0
  578. package/templates/minimal/public/icon.png +0 -0
  579. package/templates/platformer/assets/.gitkeep +0 -0
  580. package/templates/platformer/public/.gitkeep +0 -0
  581. package/templates/platformer/public/icon.png +0 -0
  582. package/templates/shooter/src/physics.ts +0 -49
  583. package/templates/starter/assets/.gitkeep +0 -0
  584. package/templates/starter/public/.gitkeep +0 -0
  585. package/templates/starter/public/icon.png +0 -0
  586. package/templates/starter/public/pickup.ogg +0 -0
  587. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  588. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -10,28 +10,28 @@
10
10
  { "kind": "input", "label": "attack", "press": "KeyF", "holdTicks": 1, "release": true },
11
11
  { "kind": "input", "label": "surge", "press": "KeyE", "holdTicks": 1, "release": true },
12
12
  { "kind": "wait", "label": "surge-active", "waitTicks": 5, "release": true },
13
- { "kind": "wait", "label": "surge-expired", "waitTicks": 90, "release": true }
13
+ { "kind": "wait", "label": "surge-expired", "waitTicks": 65, "release": true }
14
14
  ],
15
15
  "assert": {
16
16
  "diagnostics": { "noConsoleErrors": true, "noNetworkErrors": true, "runtimeReady": true },
17
17
  "resources": [
18
18
  {
19
- "id": "GameState",
19
+ "id": "state",
20
20
  "path": "lineOfSightBlocked",
21
21
  "atSteps": [{ "label": "line-of-sight", "equals": 1 }]
22
22
  },
23
23
  {
24
- "id": "GameState",
24
+ "id": "state",
25
25
  "path": "wallEnemyAggro",
26
26
  "atSteps": [{ "label": "line-of-sight", "equals": 0 }]
27
27
  },
28
28
  {
29
- "id": "GameState",
29
+ "id": "state",
30
30
  "path": "visibleEnemyAggro",
31
31
  "atSteps": [{ "label": "line-of-sight", "equals": 1 }]
32
32
  },
33
33
  {
34
- "id": "GameState",
34
+ "id": "state",
35
35
  "path": "damage",
36
36
  "atSteps": [
37
37
  { "label": "surge-active", "equals": 18 },
@@ -39,7 +39,7 @@
39
39
  ]
40
40
  },
41
41
  {
42
- "id": "GameState",
42
+ "id": "state",
43
43
  "path": "modifierActive",
44
44
  "atSteps": [
45
45
  { "label": "surge-active", "equals": 1 },
@@ -50,12 +50,35 @@
50
50
  "signals": [
51
51
  { "name": "attack", "entity": "player", "minCount": 1 },
52
52
  { "name": "ability", "entity": "player", "minCount": 1 },
53
+ { "name": "vfx-attack", "entity": "player", "minCount": 2 },
54
+ { "name": "vfx-hit", "entity": "player", "minCount": 1 },
55
+ { "name": "vfx-surge", "entity": "player", "minCount": 1, "atStep": "surge" },
53
56
  { "name": "ability-expired", "entity": "player", "minCount": 1, "atStep": "surge-expired" }
54
57
  ],
55
- "components": [{ "entity": "player", "component": "health", "equals": 90, "changed": true }],
58
+ "components": [
59
+ {
60
+ "entity": "player",
61
+ "component": "health",
62
+ "atSteps": [{ "label": "surge-expired", "equals": 95 }]
63
+ }
64
+ ],
56
65
  "visibility": [
57
- { "entity": "player", "minProjectedPixels": 20 },
58
- { "entity": "enemy.visible", "minProjectedPixels": 1 }
66
+ {
67
+ "allowTrivial": "The action RPG scene begins with the player visible and in frame; this held visibility row accompanies the combat assertions.",
68
+ "entity": "player",
69
+ "minProjectedPixels": 20
70
+ },
71
+ {
72
+ "allowTrivial": "The action RPG scene begins with the visible enemy in frame; this held visibility row accompanies the combat assertions.",
73
+ "entity": "enemy.visible",
74
+ "minProjectedPixels": 1
75
+ }
76
+ ],
77
+ "visual": [
78
+ { "frameDiff": { "minChangedPixelRatio": 0.0001 } },
79
+ {
80
+ "region": { "x": 0, "y": 0, "width": 1280, "height": 720, "minNonblankPixelRatio": 0.0001 }
81
+ }
59
82
  ]
60
83
  }
61
84
  }
@@ -12,9 +12,9 @@
12
12
  "assert": {
13
13
  "diagnostics": { "noConsoleErrors": true, "noNetworkErrors": true, "runtimeReady": true },
14
14
  "resources": [
15
- { "id": "GameState", "path": "gameOver", "equals": 1, "changed": true },
16
- { "id": "GameState", "path": "phase", "equals": "lost", "changed": true },
17
- { "id": "GameState", "path": "health", "equals": 0, "changed": true }
15
+ { "id": "state", "path": "gameOver", "equals": 1, "changed": true },
16
+ { "id": "state", "path": "phase", "equals": "lost", "changed": true },
17
+ { "id": "state", "path": "health", "equals": 0, "changed": true }
18
18
  ],
19
19
  "signals": [{ "name": "died", "entity": "player", "minCount": 1, "atStep": "forced-death" }]
20
20
  }
@@ -27,7 +27,7 @@
27
27
  "diagnostics": { "noConsoleErrors": true, "noNetworkErrors": true, "runtimeReady": true },
28
28
  "resources": [
29
29
  {
30
- "id": "GameState",
30
+ "id": "state",
31
31
  "path": "damage",
32
32
  "atSteps": [
33
33
  { "label": "equipped", "equals": 18 },
@@ -36,7 +36,7 @@
36
36
  ]
37
37
  },
38
38
  {
39
- "id": "GameState",
39
+ "id": "state",
40
40
  "path": "equippedItem",
41
41
  "atSteps": [
42
42
  { "label": "equipped", "equals": "ember-blade" },
@@ -46,7 +46,7 @@
46
46
  ]
47
47
  },
48
48
  {
49
- "id": "GameState",
49
+ "id": "state",
50
50
  "path": "inventoryFullRefused",
51
51
  "atSteps": [
52
52
  { "label": "full-refusal", "equals": 1 },
@@ -54,7 +54,7 @@
54
54
  ]
55
55
  },
56
56
  {
57
- "id": "GameState",
57
+ "id": "state",
58
58
  "path": "pendingLootItem",
59
59
  "atSteps": [
60
60
  { "label": "full-refusal", "equals": "ember-blade" },
@@ -62,7 +62,7 @@
62
62
  ]
63
63
  },
64
64
  {
65
- "id": "GameState",
65
+ "id": "state",
66
66
  "path": "pendingLootQuantity",
67
67
  "atSteps": [
68
68
  { "label": "full-refusal", "equals": 1 },
@@ -70,7 +70,7 @@
70
70
  ]
71
71
  },
72
72
  {
73
- "id": "GameState",
73
+ "id": "state",
74
74
  "path": "inventorySlots",
75
75
  "atSteps": [
76
76
  {
@@ -86,14 +86,14 @@
86
86
  }
87
87
  ]
88
88
  },
89
- { "id": "GameState", "path": "dropProof", "equals": 1, "changed": true },
89
+ { "id": "state", "path": "dropProof", "equals": 1, "changed": true },
90
90
  {
91
- "id": "GameState",
91
+ "id": "state",
92
92
  "path": "enemiesDefeated",
93
93
  "atSteps": [{ "label": "seeded-drops", "equals": 1 }]
94
94
  },
95
95
  {
96
- "id": "GameState",
96
+ "id": "state",
97
97
  "path": "lastDrop",
98
98
  "atSteps": [{ "label": "seeded-drops", "equals": "potion x1, potion x1" }]
99
99
  }
@@ -106,6 +106,12 @@
106
106
  { "name": "defeated", "entity": "enemy", "minCount": 1, "atStep": "seeded-drops" },
107
107
  { "name": "seeded", "entity": "loot", "minCount": 1 }
108
108
  ],
109
- "visibility": [{ "entity": "player", "minProjectedPixels": 20 }]
109
+ "visibility": [
110
+ {
111
+ "allowTrivial": "The action RPG scene begins with the player visible and in frame; this held visibility row accompanies the inventory assertion.",
112
+ "entity": "player",
113
+ "minProjectedPixels": 20
114
+ }
115
+ ]
110
116
  }
111
117
  }
@@ -0,0 +1,39 @@
1
+ {
2
+ "acceptanceId": "prd-194-performance-action-rpg",
3
+ "artifacts": {
4
+ "screenshots": "after"
5
+ },
6
+ "assert": {
7
+ "performance": {
8
+ "maxDrawCalls": 340,
9
+ "maxFrameMsP95": 33,
10
+ "maxTriangles": 7200,
11
+ "minFps": 30
12
+ },
13
+ "renderChain": {
14
+ "tier": "high"
15
+ }
16
+ },
17
+ "name": "production-performance",
18
+ "schemaVersion": 1,
19
+ "steps": [
20
+ {
21
+ "kind": "input",
22
+ "press": "ArrowRight",
23
+ "holdTicks": 60,
24
+ "release": true
25
+ },
26
+ {
27
+ "kind": "wait",
28
+ "waitTicks": 600,
29
+ "release": true
30
+ }
31
+ ],
32
+ "subject": "player",
33
+ "target": "web",
34
+ "viewport": {
35
+ "height": 1080,
36
+ "width": 1920
37
+ },
38
+ "warmupFrames": 60
39
+ }
@@ -36,30 +36,29 @@
36
36
  "diagnostics": { "noConsoleErrors": true, "noNetworkErrors": true, "runtimeReady": true },
37
37
  "resources": [
38
38
  {
39
- "id": "GameState",
39
+ "id": "state",
40
40
  "path": "saveCount",
41
41
  "atSteps": [{ "label": "checkpoint", "equals": 2 }, { "label": "restored", "equals": 2 }]
42
42
  },
43
43
  {
44
- "id": "GameState",
44
+ "id": "state",
45
45
  "path": "health",
46
- "atSteps": [
47
- { "label": "damage-before-save", "equals": 77 },
48
- { "label": "restored", "equals": 77 }
49
- ]
46
+ "gte": 77,
47
+ "lte": 82,
48
+ "changed": true
50
49
  },
51
50
  {
52
- "id": "GameState",
51
+ "id": "state",
53
52
  "path": "equippedItem",
54
53
  "atSteps": [{ "label": "restored", "equals": "ember-blade" }]
55
54
  },
56
55
  {
57
- "id": "GameState",
56
+ "id": "state",
58
57
  "path": "damage",
59
58
  "atSteps": [{ "label": "checkpoint", "equals": 18 }, { "label": "restored", "equals": 18 }]
60
59
  },
61
60
  {
62
- "id": "GameState",
61
+ "id": "state",
63
62
  "path": "playerX",
64
63
  "atSteps": [
65
64
  { "label": "checkpoint", "equals": -5.44 },
@@ -67,7 +66,7 @@
67
66
  ]
68
67
  },
69
68
  {
70
- "id": "GameState",
69
+ "id": "state",
71
70
  "path": "playerY",
72
71
  "atSteps": [
73
72
  { "label": "checkpoint", "equals": 0.78 },
@@ -75,13 +74,13 @@
75
74
  ]
76
75
  },
77
76
  {
78
- "id": "GameState",
77
+ "id": "state",
79
78
  "path": "playerZ",
80
79
  "atSteps": [{ "label": "checkpoint", "equals": 0 }, { "label": "restored", "equals": 0 }]
81
80
  }
82
81
  ],
83
82
  "components": [
84
- { "entity": "player", "component": "health", "equals": 77, "changed": true },
83
+ { "entity": "player", "component": "health", "gte": 77, "lte": 82, "changed": true },
85
84
  { "entity": "player", "component": "equippedItem", "equals": "ember-blade", "changed": true },
86
85
  { "entity": "player", "component": "position", "changed": true }
87
86
  ],
@@ -94,6 +93,12 @@
94
93
  "maxDistance": 0.01
95
94
  }
96
95
  },
97
- "visibility": [{ "entity": "player", "minProjectedPixels": 20 }]
96
+ "visibility": [
97
+ {
98
+ "allowTrivial": "The action RPG scene begins with the player visible and in frame; this held visibility row accompanies the progress assertion.",
99
+ "entity": "player",
100
+ "minProjectedPixels": 20
101
+ }
102
+ ]
98
103
  }
99
104
  }
@@ -16,7 +16,34 @@
16
16
  "noRuntimeDiagnostics": true,
17
17
  "runtimeReady": true
18
18
  },
19
+ "components": [
20
+ {
21
+ "allowTrivial": "GroundSnap settles the player before this movement observation; the finite near-zero clearance is the generated call-site proof.",
22
+ "component": "groundClearance",
23
+ "entity": "player",
24
+ "lte": 0.01
25
+ },
26
+ {
27
+ "allowTrivial": "The action RPG blade has an authored non-unit size; this retained factor proves normaliseToMetres ran in the generated player.",
28
+ "component": "normaliseFactor",
29
+ "entity": "player",
30
+ "gte": 1.01
31
+ },
32
+ {
33
+ "allowTrivial": "Weapon attachment is construction-time; the resolved RightHand parent proves attachToBone ran in the generated player.",
34
+ "component": "weaponBone",
35
+ "entity": "player",
36
+ "equals": "RightHand"
37
+ }
38
+ ],
19
39
  "movement": { "entity": "player", "minDistance": 0.5 },
40
+ "visibility": [
41
+ {
42
+ "entity": "touch-controls",
43
+ "present": false,
44
+ "allowTrivial": "Desktop keyboard lanes intentionally omit touch controls while movement proves the scene is active."
45
+ }
46
+ ],
20
47
  "visual": [
21
48
  {
22
49
  "region": {
@@ -0,0 +1,42 @@
1
+ {
2
+ "name": "action-rpg-touch-controls",
3
+ "schemaVersion": 1,
4
+ "target": "web",
5
+ "viewport": { "width": 1280, "height": 720 },
6
+ "warmupFrames": 10,
7
+ "subject": "player",
8
+ "steps": [
9
+ {
10
+ "kind": "input",
11
+ "label": "movement-anchor",
12
+ "pointers": [{ "id": 7, "x": 0.18, "y": 0.75 }],
13
+ "holdTicks": 2,
14
+ "release": false
15
+ },
16
+ {
17
+ "kind": "input",
18
+ "label": "move-and-attack",
19
+ "pointers": [{ "id": 7, "x": 0.32, "y": 0.75 }, { "id": 3, "x": 0.927, "y": 0.869 }],
20
+ "holdTicks": 45,
21
+ "release": true
22
+ },
23
+ { "kind": "wait", "label": "settled", "waitTicks": 10, "release": true }
24
+ ],
25
+ "assert": {
26
+ "diagnostics": {
27
+ "noConsoleErrors": true,
28
+ "noNetworkErrors": true,
29
+ "noRuntimeDiagnostics": true,
30
+ "runtimeReady": true
31
+ },
32
+ "movement": { "entity": "player", "minDistance": 0.1 },
33
+ "resources": [{ "id": "state", "path": "playerX", "changed": true }],
34
+ "visibility": [
35
+ {
36
+ "entity": "touch-controls",
37
+ "present": true,
38
+ "allowTrivial": "Touch-primary lanes keep the authored controls visible while state assertions prove they are live."
39
+ }
40
+ ]
41
+ }
42
+ }
@@ -20,11 +20,17 @@
20
20
  "assert": {
21
21
  "diagnostics": { "noConsoleErrors": true, "noNetworkErrors": true, "runtimeReady": true },
22
22
  "resources": [
23
- { "id": "GameState", "path": "gameWon", "equals": 1, "changed": true },
24
- { "id": "GameState", "path": "phase", "equals": "won", "changed": true },
25
- { "id": "GameState", "path": "enemiesDefeated", "gte": 1, "changed": true }
23
+ { "id": "state", "path": "gameWon", "equals": 1, "changed": true },
24
+ { "id": "state", "path": "phase", "equals": "won", "changed": true },
25
+ { "id": "state", "path": "enemiesDefeated", "gte": 1, "changed": true }
26
26
  ],
27
27
  "signals": [{ "name": "defeated", "entity": "boss", "minCount": 1, "atStep": "boss-hit-3" }],
28
- "visibility": [{ "entity": "player", "minProjectedPixels": 20 }]
28
+ "visibility": [
29
+ {
30
+ "allowTrivial": "The action RPG scene begins with the player visible and in frame; this held visibility row accompanies the win assertion.",
31
+ "entity": "player",
32
+ "minProjectedPixels": 20
33
+ }
34
+ ]
29
35
  }
30
36
  }
@@ -0,0 +1,35 @@
1
+ import { GroundSnap, attachToBone, normaliseToMetres, skeletonBones } from "@threenative/core";
2
+ import { Bone, type Group } from "three";
3
+
4
+ export interface IActionRpgConventions {
5
+ readonly applyGrounding: (surfaceY: number, dt: number) => void;
6
+ readonly attachedBone: string;
7
+ readonly boneNames: readonly string[];
8
+ readonly groundSnap: GroundSnap;
9
+ readonly normaliseFactor: number;
10
+ }
11
+
12
+ export function preparePlayerConventions(model: Group): IActionRpgConventions {
13
+ const weapon = model.getObjectByName("held-blade");
14
+ if (weapon === undefined) throw new Error("Action RPG player is missing its held blade.");
15
+
16
+ const normaliseFactor = normaliseToMetres(weapon, { axis: "longest", metres: 0.9 });
17
+ const hand = new Bone();
18
+ hand.name = "RightHand";
19
+ hand.position.copy(weapon.position);
20
+ hand.rotation.copy(weapon.rotation);
21
+ model.add(hand);
22
+ weapon.position.set(0, 0, 0);
23
+ weapon.rotation.set(0, 0, 0);
24
+
25
+ const boneNames = skeletonBones(model);
26
+ attachToBone(model, "RightHand", weapon);
27
+ const groundSnap = new GroundSnap(model);
28
+ return {
29
+ applyGrounding: (surfaceY, dt) => groundSnap.apply(model, surfaceY, dt),
30
+ attachedBone: weapon.parent?.name ?? "",
31
+ boneNames,
32
+ groundSnap,
33
+ normaliseFactor,
34
+ };
35
+ }
@@ -6,7 +6,6 @@ import {
6
6
  type IPhysicsContext,
7
7
  } from "@threenative/physics";
8
8
  import { type Group, Vector3 } from "three";
9
- import { directSpaceState } from "../physics.js";
10
9
  import { type RpgMaterials, createEnemyVisual } from "../render/shapes.js";
11
10
  import type { GameState } from "../state.js";
12
11
  import { HOSTILE_LAYER, PLAYER_LAYER, WORLD_LAYER } from "./Player.js";
@@ -37,6 +36,9 @@ export class Enemy {
37
36
  #onDeath: (enemy: Enemy) => void;
38
37
  #playerBody: IPhysicsBodyHandle;
39
38
  #rangeShape = CollisionShape3D.sphere(4.8);
39
+ #from = new Vector3();
40
+ #to = new Vector3();
41
+ #direction = new Vector3();
40
42
 
41
43
  constructor(
42
44
  ctx: GameCtx,
@@ -65,19 +67,26 @@ export class Enemy {
65
67
 
66
68
  update(ctx: GameCtx, dt: number, playerPosition: Vector3): void {
67
69
  if (!this.alive) return;
68
- const rangeHits = directSpaceState(ctx.physics).intersectShape({
70
+ const rangeHits = ctx.physics.directSpaceState.intersectShape({
69
71
  collisionMask: PLAYER_LAYER,
70
72
  maxResults: 4,
71
73
  position: this.mesh.position,
72
74
  shape: this.#rangeShape,
73
75
  });
74
- const inRange = rangeHits.some((hit) => hit.body.id === this.#playerBody.id);
76
+ let inRange = false;
77
+ for (const hit of rangeHits) {
78
+ if (hit.body.id !== this.#playerBody.id) continue;
79
+ inRange = true;
80
+ break;
81
+ }
75
82
  this.lineOfSight = false;
76
83
  this.lineOfSightBlocked = false;
77
84
  if (inRange) {
78
- const from = this.mesh.position.clone().add(new Vector3(0, this.boss ? 0.9 : 0.5, 0));
79
- const to = playerPosition.clone().add(new Vector3(0, 0.5, 0));
80
- const ray = directSpaceState(ctx.physics).intersectRay({
85
+ const from = this.#from.copy(this.mesh.position);
86
+ from.y += this.boss ? 0.9 : 0.5;
87
+ const to = this.#to.copy(playerPosition);
88
+ to.y += 0.5;
89
+ const ray = ctx.physics.directSpaceState.intersectRay({
81
90
  collisionMask: WORLD_LAYER | PLAYER_LAYER,
82
91
  from,
83
92
  to,
@@ -93,7 +102,7 @@ export class Enemy {
93
102
  return;
94
103
  }
95
104
 
96
- const direction = playerPosition.clone().sub(this.mesh.position).setY(0);
105
+ const direction = this.#direction.copy(playerPosition).sub(this.mesh.position).setY(0);
97
106
  const distance = direction.length();
98
107
  if (distance <= 1.45) {
99
108
  this.state = "attack";
@@ -1,8 +1,10 @@
1
1
  import type { ICtx } from "@threenative/core";
2
2
  import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
- import { type Group, Vector3 } from "three";
3
+ import { Group, Vector3 } from "three";
4
+ import { type IActionRpgConventions, preparePlayerConventions } from "../conventions.js";
4
5
  import { createPlayerVisual } from "../render/shapes.js";
5
6
  import type { RpgMaterials } from "../render/shapes.js";
7
+ import type { ITouchInput } from "../render/touch-controls.js";
6
8
  import type { GameState } from "../state.js";
7
9
 
8
10
  export const WORLD_LAYER = 1;
@@ -15,11 +17,13 @@ export class Player {
15
17
  readonly body: CharacterBody3D;
16
18
  readonly maxHealth = 100;
17
19
  readonly mesh: Group;
20
+ readonly visual: Group;
18
21
  health: number;
19
22
  dead = false;
20
23
  equippedItem = "";
21
24
  #onDamage: (amount: number) => void;
22
25
  #onDeath: () => void;
26
+ #conventions: IActionRpgConventions;
23
27
 
24
28
  constructor(
25
29
  ctx: GameCtx,
@@ -32,8 +36,11 @@ export class Player {
32
36
  this.#onDamage = onDamage;
33
37
  this.#onDeath = onDeath;
34
38
  this.health = Math.max(0, Math.min(this.maxHealth, health));
35
- this.mesh = createPlayerVisual(materials);
39
+ this.mesh = new Group();
40
+ this.visual = createPlayerVisual(materials);
41
+ this.mesh.add(this.visual);
36
42
  this.mesh.position.copy(spawn);
43
+ this.#conventions = preparePlayerConventions(this.visual);
37
44
  ctx.add(this.mesh);
38
45
  this.body = new CharacterBody3D({
39
46
  collisionLayer: PLAYER_LAYER,
@@ -45,11 +52,17 @@ export class Player {
45
52
  });
46
53
  }
47
54
 
48
- update(ctx: GameCtx, dt: number): void {
55
+ update(ctx: GameCtx, dt: number, touch?: ITouchInput): void {
49
56
  if (this.dead) return;
50
57
  const move = ctx.input.vector("move");
58
+ if (touch !== undefined) {
59
+ move.x += touch.move.x;
60
+ move.y += touch.move.y;
61
+ move.clampLength(0, 1);
62
+ }
51
63
  this.body.velocity.set(move.x * 4.8, 0, -move.y * 4.8);
52
64
  this.body.moveAndSlide(dt);
65
+ this.#conventions.applyGrounding(0, dt);
53
66
  }
54
67
 
55
68
  takeDamage(amount: number): void {
@@ -71,8 +84,12 @@ export class Player {
71
84
  return {
72
85
  dead: this.dead,
73
86
  equippedItem: this.equippedItem,
87
+ groundClearance: this.#conventions.groundSnap.clearance,
74
88
  health: this.health,
89
+ normaliseFactor: this.#conventions.normaliseFactor,
75
90
  position: this.mesh.position.toArray(),
91
+ skeletonBones: this.#conventions.boneNames,
92
+ weaponBone: this.#conventions.attachedBone,
76
93
  };
77
94
  }
78
95
 
@@ -31,6 +31,7 @@ const game = defineGame<GameState, IPhysicsContext>({
31
31
  unequip: { keys: ["KeyU"] },
32
32
  },
33
33
  plugins: [rapier({ gravity: { x: 0, y: 0, z: 0 } }), playtest({ events: drainPlaytestEvents })],
34
+ display: config.display,
34
35
  render: config.renderer,
35
36
  scenes: { boot: Boot, play: Play },
36
37
  seed: 93093,
@@ -38,3 +39,23 @@ const game = defineGame<GameState, IPhysicsContext>({
38
39
  });
39
40
 
40
41
  export default game;
42
+
43
+ /**
44
+ * What the UI can ask the game to do.
45
+ *
46
+ * Intents are one-way and named by the game: the UI sends `restart`, `pause` or `resume` and the
47
+ * game decides what each means. Nothing comes back this way — the UI reads the game's published
48
+ * state instead, which keeps one source of truth on the side that owns the simulation.
49
+ */
50
+ game.ui.onIntent((intent) => {
51
+ if (intent === "restart") void game.goto("play");
52
+ if (intent === "pause") game.pause();
53
+ if (intent === "resume") game.resume();
54
+ game.state.set({
55
+ // `game.ui.connected` is true only once the UI announced itself, which is what tells an
56
+ // overlay that never came up apart from a game whose HUD is simply empty.
57
+ uiReady: game.ui.connected,
58
+ ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
59
+ });
60
+ game.state.flush();
61
+ });
@@ -7,8 +7,13 @@ export interface ICameraRig {
7
7
  }
8
8
 
9
9
  export function createDungeonCamera(camera: PerspectiveCamera): ICameraRig {
10
- const offset = new Vec3(0, 8.4, 8.8);
11
- const lookAhead = new Vec3(0, 0.2, -1.2);
10
+ // The rig has to clear the **south wall**, which stands at z = +6 and is now 5.2 m tall with a
11
+ // cap on it. At 6.6/7.4 the eye sat outside that wall and below its top, so the lower half of
12
+ // the frame was the wall's outer face and the room was hidden behind it. From 10.2/9.2 the
13
+ // sightline passes over the cap with room to spare, and the far wall closes the top of the shot
14
+ // instead of the empty sky the old 2.8 m walls left there.
15
+ const offset = new Vec3(0, 10.2, 9.2);
16
+ const lookAhead = new Vec3(0, 0.4, -1.8);
12
17
  const desired = new Vec3();
13
18
  const aim = new Vec3();
14
19
  const pose = (target: Vector3): void => {
@@ -3,11 +3,16 @@ import { palette } from "./palette.js";
3
3
 
4
4
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
5
5
 
6
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
6
+ // Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
7
+ // the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
8
+ // rendering a black pass.
9
+ export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
7
10
  renderer.shadowMap.enabled = true;
8
11
  renderer.shadowMap.type = PCFSoftShadowMap;
9
12
 
10
- const key = new DirectionalLight(palette.accent, 3.2);
13
+ // Warm, but not the accent itself: keyed with the trim colour, the stone, the hero and the loot
14
+ // all took the same gold cast and the dungeon lost every distinction between them.
15
+ const key = new DirectionalLight(0xffe0b0, 2.6);
11
16
  key.name = "key-light";
12
17
  key.position.set(-8, 12, 6);
13
18
  key.castShadow = true;
@@ -22,9 +27,11 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
22
27
  key.shadow.normalBias = 0.04;
23
28
  scene.add(key);
24
29
 
25
- const rim = new DirectionalLight(palette.player, 1.35);
30
+ const rim = new DirectionalLight(palette.player, 0.9);
26
31
  rim.name = "rim-light";
27
32
  rim.position.set(12, 6, -12);
28
33
  scene.add(rim);
29
- scene.add(new AmbientLight(palette.skyHigh, 0.72));
34
+ scene.add(new AmbientLight(0x6a5a48, 1.5));
35
+
36
+ return key;
30
37
  }