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
@@ -1,73 +1,183 @@
1
- import { AudioBus, type ICtx, Scene, type SceneFrame } from "@threenative/core";
1
+ import {
2
+ AudioBus,
3
+ type ICtx,
4
+ Scene,
5
+ type SceneFrame,
6
+ WaveField,
7
+ createRandom,
8
+ isMobile,
9
+ isTouchscreenAvailable,
10
+ } from "@threenative/core";
2
11
  import { Area3D, CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
- import { DoubleSide, Group, Mesh, MeshBasicMaterial, type PerspectiveCamera, Vector3 } from "three";
12
+ import { BufferAttribute, Group, Mesh, NearestFilter, type PerspectiveCamera } from "three";
13
+ import config from "../../threenative.config.js";
4
14
  import { Crate } from "../entities/Crate.js";
15
+ import { Goal, ISLAND } from "../entities/Goal.js";
5
16
  import { Player } from "../entities/Player.js";
6
17
  import { createSpringArm } from "../render/camera.js";
18
+ import { createCoastalScene } from "../render/coast.js";
19
+ import { pickupRiseEase } from "../render/easing.js";
7
20
  import { setupLighting } from "../render/lighting.js";
8
- import { createMaterials } from "../render/materials.js";
21
+ import { createLoadingScreen } from "../render/loading.js";
22
+ import { createMaterials, createPennantMaterial } from "../render/materials.js";
23
+ import { COAST_DOMAIN_WARP, COAST_WAVES } from "../render/palette.js";
9
24
  import { setupPost } from "../render/postprocessing.js";
10
- import { ball, block, makeRandom, roundedBox, sculpture, spike, tube } from "../render/shapes.js";
25
+ import { createScenery } from "../render/scenery.js";
26
+ import { ball, block, roundedBox, spike, tube } from "../render/shapes.js";
11
27
  import { setupSky } from "../render/sky.js";
28
+ import { TouchControls } from "../render/touch-controls.js";
12
29
  import type { GameState } from "../state.js";
13
30
 
14
31
  export type GameCtx = ICtx<GameState, IPhysicsContext>;
15
32
 
16
33
  const KILL_PLANE = -4;
34
+ const STARTING_LIVES = 3;
35
+ const FLOOR_SURFACE_Y = 0;
36
+ const FLOOR_BOUNDS = { maxX: 5, minX: -5, maxZ: 2, minZ: -2 } as const;
17
37
 
18
38
  export class Play extends Scene<GameState, IPhysicsContext> {
19
- #assetProof: Group | undefined;
39
+ #assetProof: Mesh | undefined;
40
+ #materials: ReturnType<typeof createMaterials> | undefined;
41
+ #player: Player | undefined;
42
+ #scenery: ReturnType<typeof createScenery> | undefined;
20
43
 
21
44
  static override readonly initialState: GameState = {
22
45
  coyoteJumps: 0,
23
46
  entityCount: 0,
47
+ flagDisplacement: 0,
48
+ flagGusts: 0,
49
+ flagReadbacks: 0,
50
+ flagSteps: 0,
24
51
  jumps: 0,
25
52
  levelX: -99,
53
+ lives: STARTING_LIVES,
54
+ odometer: 0,
55
+ paused: false,
26
56
  peakRise: 0,
27
57
  playerX: -2,
28
58
  respawns: 0,
29
59
  score: 0,
60
+ status: "playing",
61
+ uiReady: false,
30
62
  };
31
63
 
32
64
  override async load(ctx: GameCtx): Promise<void> {
65
+ const materials = createMaterials();
66
+ this.#materials = materials;
67
+ const state = ctx.state.getState();
68
+ this.#player = ctx.entities.add(
69
+ "player",
70
+ new Player(
71
+ ctx,
72
+ { accent: materials.heroAccent, body: materials.player, dark: materials.heroDark },
73
+ {
74
+ x: Number.isFinite(state.playerX) ? state.playerX : Play.initialState.playerX,
75
+ y: 0.5,
76
+ z: 0,
77
+ },
78
+ ),
79
+ );
33
80
  const [texture, model] = await Promise.all([
34
81
  ctx.assets.texture("native-proof.png"),
35
82
  ctx.assets.model<{ scene: Group }>("native-proof.glb"),
36
83
  ]);
84
+ // A 16-pixel check filtered smoothly is a grey smear at flag size; nearest keeps the
85
+ // squares square, which is the whole reason the finish flag is legible from the ledge.
86
+ texture.magFilter = NearestFilter;
87
+ let pennant: Mesh | undefined;
37
88
  model.scene.traverse((object) => {
38
89
  if (object instanceof Mesh) {
39
- object.material = new MeshBasicMaterial({ map: texture, side: DoubleSide });
90
+ if (pennant !== undefined) throw new Error("Starter proof glTF must contain one mesh.");
91
+ object.material = createPennantMaterial(texture);
92
+ // The packaged proof carries positions and indices only. Without UVs the sampler
93
+ // reads one corner texel for every fragment and the flag renders as flat white —
94
+ // a loaded texture that proves nothing you can see. Plane-project the triangle.
95
+ // Compiled models may be quantized (KHR_mesh_quantization): the attribute then holds
96
+ // normalized integers, so measure each axis range from the array itself instead of
97
+ // assuming float32 metres — the affine projection is identical either way.
98
+ const position = object.geometry.getAttribute("position");
99
+ let minX = Number.POSITIVE_INFINITY;
100
+ let minY = Number.POSITIVE_INFINITY;
101
+ let maxX = Number.NEGATIVE_INFINITY;
102
+ let maxY = Number.NEGATIVE_INFINITY;
103
+ for (let index = 0; index < position.count; index += 1) {
104
+ minX = Math.min(minX, position.getX(index));
105
+ maxX = Math.max(maxX, position.getX(index));
106
+ minY = Math.min(minY, position.getY(index));
107
+ maxY = Math.max(maxY, position.getY(index));
108
+ }
109
+ const spanX = Math.max(maxX - minX, Number.EPSILON);
110
+ const spanY = Math.max(maxY - minY, Number.EPSILON);
111
+ const uv = new Float32Array(position.count * 2);
112
+ for (let index = 0; index < position.count; index += 1) {
113
+ uv[index * 2] = (position.getX(index) - minX) / spanX;
114
+ uv[index * 2 + 1] = (position.getY(index) - minY) / spanY;
115
+ }
116
+ object.geometry.setAttribute("uv", new BufferAttribute(uv, 2));
117
+ pennant = object;
40
118
  }
41
119
  });
120
+ if (pennant === undefined) throw new Error("Starter proof glTF did not contain a mesh.");
42
121
  model.scene.name = "native-proof-assets";
43
- this.#assetProof = model.scene;
122
+ this.#assetProof = pennant;
44
123
  console.info("TN_NATIVE_STARTER_ASSETS_LOADED:texture,glb");
45
124
  }
46
125
 
47
126
  override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
48
- if (this.#assetProof === undefined) throw new Error("Starter proof assets did not load.");
49
- this.#assetProof.position.set(0, 1.7, -1.5);
50
- ctx.add(this.#assetProof);
127
+ if (
128
+ this.#assetProof === undefined ||
129
+ this.#materials === undefined ||
130
+ this.#player === undefined
131
+ )
132
+ throw new Error("Starter scene did not finish loading.");
133
+ const materials = this.#materials;
134
+ const player = this.#player;
51
135
  const audio = ctx.entities.add("audio", new AudioBus({ camera: ctx.camera }));
52
- const pickupAudio = ctx.assets.audio("pickup.ogg");
136
+ const pickupAudio = ctx.assets.audio("pickup.wav");
53
137
  void pickupAudio.catch(() => undefined);
54
138
  setupSky(ctx.scene);
55
- setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
56
- setupPost(ctx.renderer, ctx.scene, ctx.camera);
139
+ const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
140
+ // isMobile() arrives as an argument because src/render/ imports no framework package:
141
+ // the platform decision is made here, in portable game code, exactly like createRandom.
142
+ this.#post = ctx.entities.add(
143
+ "quality",
144
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, {
145
+ godraysLight: sun,
146
+ mobile: isMobile(),
147
+ targetFps: config.display?.maxFps ?? 60,
148
+ ready: () => ctx.startup.phase === "ready",
149
+ }),
150
+ );
151
+ const loading = createLoadingScreen(ctx);
57
152
  ctx.add(ctx.camera);
58
- const springArm = createSpringArm(ctx.camera as PerspectiveCamera, {
59
- lookAhead: new Vector3(0, 0.9, -0.4),
60
- });
153
+ const waves = new WaveField({ waves: COAST_WAVES, domainWarp: COAST_DOMAIN_WARP });
154
+ ctx.add(createCoastalScene(materials, waves, createRandom(31_415_926)));
155
+ const showTouchControls = isMobile() && isTouchscreenAvailable();
156
+ const touchControls = showTouchControls
157
+ ? ctx.entities.add("touch-controls", new TouchControls(ctx.camera as PerspectiveCamera))
158
+ : undefined;
159
+ // Offset, lead and damping all live in render/camera.ts — framing is a look decision.
160
+ const springArm = createSpringArm(ctx.camera as PerspectiveCamera);
61
161
 
62
- const materials = createMaterials();
63
- const sculptureMesh = sculpture(materials.crate);
64
- sculptureMesh.name = "sculpture";
65
- sculptureMesh.position.set(-2, 2.6, -1.5);
66
- ctx.add(sculptureMesh);
162
+ const scenery = createScenery(materials.rock, materials.ridge, createRandom(20_260_821));
163
+ let refinementStarted = false;
164
+ this.#scenery = scenery;
165
+ ctx.add(scenery.object);
166
+ ctx.entities.add("scenery.ridge", scenery);
167
+ // Two sentinels, both read by seed.playtest as an out-of-range value rather than as a
168
+ // transition: state.levelX starts at -99, so a level that never builds stays out of range,
169
+ // and seededLevelX becomes 2 if this draw did not advance ctx.random — which is what happens
170
+ // if someone swaps it for Math.random. Neither depends on WHEN the runner samples.
171
+ const randomStateBeforeLevel = ctx.random.state;
67
172
  const levelX = ctx.random.range(-1, 1);
68
- const pickupX = 1.2 + makeRandom(Math.round((levelX + 1) * 1000))() * 0.8;
69
- const floorMesh = new Mesh(roundedBox(10, 0.2, 4, 0.08), materials.floor);
173
+ const seededLevelX = ctx.random.state === randomStateBeforeLevel ? 2 : levelX;
174
+ const pickupX = 1.2 + createRandom(Math.round((levelX + 1) * 1000))() * 0.8;
175
+ const floorMesh = new Mesh(roundedBox(10, 0.2, 4.2, 0.1), materials.floor);
70
176
  floorMesh.position.y = -0.1;
177
+ // The collision slab remains the authoritative support surface, while the coastal renderer
178
+ // supplies the oval beach and grass top. Showing both makes a rectangular floating raft under
179
+ // the island, which is a visual artefact rather than a useful part of the scene.
180
+ floorMesh.visible = false;
71
181
  floorMesh.receiveShadow = true;
72
182
  ctx.add(floorMesh);
73
183
  new RigidBody3D({
@@ -78,11 +188,6 @@ export class Play extends Scene<GameState, IPhysicsContext> {
78
188
  });
79
189
  new Crate(ctx, levelX, 4, -1.5, materials.crate);
80
190
  const state = ctx.state.getState();
81
- const player = new Player(ctx, materials.player, {
82
- x: Number.isFinite(state.playerX) ? state.playerX : Play.initialState.playerX,
83
- y: 0.5,
84
- z: 0,
85
- });
86
191
  const pickupBase = block(0.42, 0.14, 0.42, materials.player);
87
192
  const pickupStem = tube(0.08, 0.08, 0.3, materials.player);
88
193
  const pickupOrb = ball(0.16, materials.player);
@@ -97,11 +202,40 @@ export class Play extends Scene<GameState, IPhysicsContext> {
97
202
  pickupVisual.castShadow = true;
98
203
  ctx.add(pickupVisual);
99
204
  ctx.entities.add("pickup", pickupVisual);
100
- void ctx.tween(pickupVisual.position, { y: 0.65 }, 0.4);
205
+ void ctx.tween(pickupVisual.position, { y: 0.65 }, 0.4, { ease: pickupRiseEase });
101
206
  springArm.snap(player.mesh.position);
102
- ctx.state.set({ levelX });
103
- ctx.entities.add("player", player);
104
- ctx.state.set({ entityCount: Object.keys(ctx.entities.snapshot()).length });
207
+ // The packaged proof asset earns its place here: it is the pennant on the finish flag,
208
+ // not a debug object parked over the level. The texture and the glTF still load in
209
+ // `load()` above, which is what the native asset gate greps for.
210
+ const goal = ctx.entities.add("goal", new Goal(ctx, materials, this.#assetProof));
211
+ const supportSurfaceY = (position: { readonly x: number; readonly z: number }):
212
+ | number
213
+ | undefined => {
214
+ if (
215
+ position.x >= FLOOR_BOUNDS.minX &&
216
+ position.x <= FLOOR_BOUNDS.maxX &&
217
+ position.z >= FLOOR_BOUNDS.minZ &&
218
+ position.z <= FLOOR_BOUNDS.maxZ
219
+ )
220
+ return FLOOR_SURFACE_Y;
221
+ if (
222
+ position.x >= ISLAND.x - ISLAND.width / 2 &&
223
+ position.x <= ISLAND.x + ISLAND.width / 2 &&
224
+ position.z >= ISLAND.z - ISLAND.depth / 2 &&
225
+ position.z <= ISLAND.z + ISLAND.depth / 2
226
+ )
227
+ return ISLAND.top;
228
+ return undefined;
229
+ };
230
+ // The area says the character is over the island; the run is only won once it is also
231
+ // standing on it. Ending on the overlap alone freezes the character in mid-air at the
232
+ // lip of the island, half a metre short of a landing, which is what it looks like.
233
+ let overGoal = false;
234
+ goal.area.on("bodyEntered", (body) => {
235
+ if (body === player.body) overGoal = true;
236
+ });
237
+ let entityCount = 4;
238
+ ctx.state.set({ entityCount });
105
239
  const pickup = new Area3D({
106
240
  physics: ctx.physics,
107
241
  position: { x: pickupX, y: 0.5, z: 0 },
@@ -111,13 +245,14 @@ export class Play extends Scene<GameState, IPhysicsContext> {
111
245
  if (body !== player.body) return;
112
246
  ctx.state.set((state) => ({ score: state.score + 1 }));
113
247
  ctx.entities.remove("pickup");
114
- ctx.state.set({
115
- entityCount: Object.keys(ctx.entities.snapshot()).length,
116
- });
248
+ entityCount -= 1;
249
+ ctx.state.set({ entityCount });
117
250
  pickup.monitoring = false;
118
251
  pickupVisual.visible = false;
119
252
  ctx.after(3, () => {
120
253
  ctx.entities.add("pickup", pickupVisual);
254
+ entityCount += 1;
255
+ ctx.state.set({ entityCount });
121
256
  pickupVisual.visible = true;
122
257
  pickup.monitoring = true;
123
258
  });
@@ -125,11 +260,23 @@ export class Play extends Scene<GameState, IPhysicsContext> {
125
260
  });
126
261
  if (state.score > 0) {
127
262
  ctx.entities.remove("pickup");
263
+ entityCount -= 1;
264
+ ctx.state.set({ entityCount });
128
265
  pickup.monitoring = false;
129
266
  pickupVisual.visible = false;
130
267
  }
131
268
 
269
+ // Set with the level, not 0.25 s later. The delay existed so the playtest could observe the
270
+ // -99 -> seeded transition, which made the assertion a race against boot time: it was sampled
271
+ // at tick 6 on a workstation and tick 47 in CI, and only the slow sample missed the change.
272
+ ctx.state.set({ levelX: seededLevelX });
273
+ const frameState: Partial<GameState> = {};
274
+ let elapsed = 0;
275
+ // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: starter frame coordinates existing gameplay state transitions.
132
276
  return (frameCtx, dt) => {
277
+ loading.update();
278
+ elapsed += dt;
279
+ waves.setTime(elapsed);
133
280
  // Restart resets the store before clearing entities and scheduled callbacks.
134
281
  if (frameCtx.input.justPressed("restart")) {
135
282
  frameCtx.state.set(Play.initialState);
@@ -137,25 +284,75 @@ export class Play extends Scene<GameState, IPhysicsContext> {
137
284
  void frameCtx.goto("play");
138
285
  return;
139
286
  }
140
- player.update(frameCtx, dt);
287
+ const previous = frameCtx.state.getState();
288
+ // A finished run stops simulating the character and keeps drawing the world behind
289
+ // the banner. R, or the restart button, rebuilds the scene from `initialState`.
290
+ if (previous.status !== "playing") return;
291
+ if (frameCtx.input.justPressed("flagGust")) {
292
+ goal.pennant.wind.set(0, 0.4, 4.5);
293
+ frameCtx.state.set((state) => ({ flagGusts: state.flagGusts + 1 }));
294
+ }
295
+ const touch = touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size);
296
+ const move = frameCtx.input.vector("move");
297
+ if (
298
+ !refinementStarted &&
299
+ (move.x !== 0 || move.y !== 0 || (touch?.move.x ?? 0) !== 0 || (touch?.move.y ?? 0) !== 0)
300
+ ) {
301
+ scenery.rebuild();
302
+ refinementStarted = true;
303
+ }
304
+ player.update(frameCtx, dt, supportSurfaceY, touch);
141
305
  let respawned = false;
306
+ let lives = previous.lives;
142
307
  if (player.mesh.position.y < KILL_PLANE) {
308
+ lives -= 1;
143
309
  player.respawn();
144
310
  springArm.snap(player.mesh.position);
145
311
  respawned = true;
146
312
  }
313
+ springArm.dolly(frameCtx.input.axis("zoom"), dt);
147
314
  springArm.follow(player.mesh.position, dt);
148
- const debug = player.debug();
149
- const previous = frameCtx.state.getState();
150
- frameCtx.state.set({
151
- coyoteJumps: debug.coyoteJumps,
152
- jumps: debug.jumps,
153
- peakRise: Math.max(previous.peakRise, player.mesh.position.y - 0.5),
154
- playerX: player.mesh.position.x,
155
- respawns: previous.respawns + (respawned ? 1 : 0),
156
- entityCount: Object.keys(frameCtx.entities.snapshot()).length,
157
- });
315
+ // `status` is written only on the frame that ends the run, and never in the bulk
316
+ // write below, which would stamp this frame's stale copy back over it.
317
+ if (lives <= 0) frameCtx.state.set({ status: "lost" });
318
+ else if (overGoal && player.grounded) {
319
+ frameCtx.state.set({ status: "won" });
320
+ frameCtx.state.flush();
321
+ }
322
+ frameState.coyoteJumps = player.coyoteJumps;
323
+ frameState.flagDisplacement = Math.max(previous.flagDisplacement, goal.flagDisplacement());
324
+ frameState.flagReadbacks = goal.readbackLands();
325
+ frameState.flagSteps = goal.pennant.steps;
326
+ frameState.jumps = player.jumps;
327
+ frameState.lives = lives;
328
+ frameState.odometer = player.odometer;
329
+ frameState.peakRise = Math.max(previous.peakRise, player.mesh.position.y - 0.5);
330
+ frameState.playerX = player.mesh.position.x;
331
+ frameState.respawns = previous.respawns + (respawned ? 1 : 0);
332
+ const current = frameCtx.state.getState();
333
+ const changed =
334
+ frameState.coyoteJumps !== current.coyoteJumps ||
335
+ frameState.flagDisplacement !== current.flagDisplacement ||
336
+ frameState.flagReadbacks !== current.flagReadbacks ||
337
+ frameState.flagSteps !== current.flagSteps ||
338
+ frameState.jumps !== current.jumps ||
339
+ frameState.lives !== current.lives ||
340
+ frameState.odometer !== current.odometer ||
341
+ frameState.peakRise !== current.peakRise ||
342
+ frameState.playerX !== current.playerX ||
343
+ frameState.respawns !== current.respawns;
344
+ if (changed) frameCtx.state.set(frameState);
158
345
  if (respawned) frameCtx.state.flush();
159
346
  };
160
347
  }
348
+
349
+ #post: ReturnType<typeof setupPost> | undefined;
350
+
351
+ override exit(ctx: GameCtx): void {
352
+ this.#post?.dispose();
353
+ this.#post = undefined;
354
+ this.#scenery?.dispose();
355
+ this.#scenery = undefined;
356
+ super.exit(ctx);
357
+ }
161
358
  }
@@ -1,10 +1,22 @@
1
1
  export type GameState = {
2
2
  coyoteJumps: number;
3
3
  entityCount: number;
4
+ flagDisplacement: number;
5
+ flagGusts: number;
6
+ flagReadbacks: number;
7
+ flagSteps: number;
4
8
  jumps: number;
5
9
  levelX: number;
10
+ lives: number;
11
+ odometer: number;
12
+ /** Set from the UI's pause and resume intents, and read back by the menu. */
13
+ paused: boolean;
14
+ /** True once the UI layer has rendered and published its interactive rectangles. */
15
+ uiReady: boolean;
6
16
  peakRise: number;
7
17
  playerX: number;
8
18
  respawns: number;
9
19
  score: number;
20
+ /** The run: "playing" until the flag is reached ("won") or the last life is gone ("lost"). */
21
+ status: "lost" | "playing" | "won";
10
22
  };
@@ -17,13 +17,13 @@
17
17
  * Tailwind's defaults. Nothing in @threenative/* reads this.
18
18
  */
19
19
  @theme {
20
- --color-ink: #04080d;
21
- --color-panel: #0d1c26;
22
- --color-line: #14313f;
23
- --color-lume: #6fe8ff;
24
- --color-warn: #ffd27a;
25
- --color-text: #a8ccd8;
26
- --color-dim: #4e7686;
20
+ --color-ink: #17384a;
21
+ --color-panel: #24566a;
22
+ --color-line: #55929a;
23
+ --color-lume: #c2f2d6;
24
+ --color-warn: #ffdda1;
25
+ --color-text: #eff6dc;
26
+ --color-dim: #b1d2c7;
27
27
 
28
28
  --font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
29
29
  }
@@ -38,8 +38,72 @@ body,
38
38
  }
39
39
 
40
40
  body {
41
- background: var(--color-ink);
42
41
  color: var(--color-text);
43
42
  font-family: var(--font-mono);
44
43
  -webkit-font-smoothing: antialiased;
45
44
  }
45
+
46
+ /*
47
+ * The page's backdrop belongs to the web document's own mount point, never to `body`.
48
+ * `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
49
+ * transparent web view loads over the game: a `body` background there paints an opaque sheet over
50
+ * the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
51
+ * in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
52
+ */
53
+
54
+ #root {
55
+ background: var(--color-ink);
56
+ }
57
+
58
+ /* Boot failures are a page state, so the generated game owns their presentation. */
59
+ [data-threenative-canvas-error="true"] {
60
+ position: fixed;
61
+ inset: 0;
62
+ z-index: 1000;
63
+ display: grid;
64
+ place-items: center;
65
+ box-sizing: border-box;
66
+ padding: clamp(1.5rem, 8vw, 6rem);
67
+ overflow: auto;
68
+ background: #fff7ed;
69
+ color: var(--color-ink);
70
+ font-family: inherit;
71
+ font-size: clamp(1rem, 2vw, 1.5rem);
72
+ line-height: 1.5;
73
+ text-align: center;
74
+ white-space: pre-wrap;
75
+ overflow-wrap: anywhere;
76
+ }
77
+
78
+ /* The debug surface is framework plumbing; its default presentation is yours to change. */
79
+ [data-threenative-debug-overlay="true"] {
80
+ position: fixed;
81
+ top: 1rem;
82
+ right: 1rem;
83
+ z-index: 50;
84
+ max-width: 24rem;
85
+ padding: 0.75rem;
86
+ pointer-events: none;
87
+ background: rgb(2 6 23 / 90%);
88
+ box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
89
+ color: #cffafe;
90
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
91
+ font-size: 12px;
92
+ line-height: 1.5;
93
+ }
94
+
95
+ [data-threenative-debug-overlay="true"] table {
96
+ width: 100%;
97
+ table-layout: fixed;
98
+ }
99
+
100
+ [data-threenative-debug-overlay="true"] th,
101
+ [data-threenative-debug-overlay="true"] td {
102
+ padding-right: 1rem;
103
+ text-align: left;
104
+ }
105
+
106
+ [data-threenative-debug-overlay="true"] td:last-child {
107
+ overflow-wrap: anywhere;
108
+ word-break: break-all;
109
+ }
@@ -2,17 +2,20 @@ import type { IGame } from "@threenative/core";
2
2
  import type { IPhysicsContext } from "@threenative/physics";
3
3
  import { DebugOverlay, GameCanvas } from "@threenative/ui";
4
4
  import type { GameState } from "../state.js";
5
- import { Hud } from "./Hud.js";
6
- import { Menu } from "./Menu.js";
5
+ import { GameUi } from "./GameUi.js";
7
6
 
7
+ /**
8
+ * The web target's page: the canvas, then the same UI every other target renders.
9
+ *
10
+ * `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first.
11
+ * The UI itself comes from `GameUi`, unchanged — this file exists only because the web build also
12
+ * has to put a canvas on the page.
13
+ */
8
14
  export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
9
15
  return (
10
- // GameCanvas hosts the renderer; everything after it in this list paints on
11
- // top. Keep the canvas first.
12
16
  <main className="relative h-screen w-screen overflow-hidden bg-ink">
13
17
  <GameCanvas className="absolute inset-0" game={game} />
14
- <Hud game={game} />
15
- <Menu game={game} />
18
+ <GameUi />
16
19
  <DebugOverlay />
17
20
  </main>
18
21
  );
@@ -0,0 +1,20 @@
1
+ import { UiLayer } from "@threenative/ui";
2
+ import { Hud } from "./Hud.js";
3
+ import { Menu } from "./Menu.js";
4
+
5
+ /**
6
+ * Everything the player sees that is not the scene.
7
+ *
8
+ * One component, mounted twice by two entries that differ only in what else is on the page:
9
+ * `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
10
+ * page the native web view loads. Keeping both entries pointed at this file is what makes "the
11
+ * same UI on every target" a fact rather than an intention.
12
+ */
13
+ export function GameUi() {
14
+ return (
15
+ <UiLayer>
16
+ <Hud />
17
+ <Menu />
18
+ </UiLayer>
19
+ );
20
+ }
@@ -1,37 +1,60 @@
1
- import type { IGame } from "@threenative/core";
2
- import type { IPhysicsContext } from "@threenative/physics";
3
- import { useGameState } from "@threenative/ui";
1
+ import { useUiState } from "@threenative/ui";
4
2
  import type { GameState } from "../state.js";
5
3
 
6
4
  /**
7
- * A labelled readout and a meter, built from the palette in style.css. Copy the
8
- * pattern for hull, ammo, timers — whatever this game needs.
5
+ * The HUD. Plain Tailwind, plain SVG, plain DOM — and the same file on every target.
6
+ *
7
+ * There is no second renderer to keep in step: on web this mounts beside the canvas, and on a
8
+ * phone or a desktop the same bundle renders in the platform's own web view over the game surface.
9
+ * Style it however you like; nothing here is a vocabulary the framework has to understand.
10
+ *
11
+ * `useUiState` reads the game's *published* state, which moves at about 10 Hz rather than at the
12
+ * frame rate, and is undefined until the game publishes its first snapshot.
9
13
  */
10
- function Meter({ label, value }: { label: string; value: number }) {
11
- return (
12
- <div className="mt-3 w-24">
13
- <div className="flex justify-between gap-2 text-[10px] uppercase tracking-[0.14em] text-dim">
14
- <span>{label}</span>
15
- <b className="font-normal tabular-nums text-text">{Math.round(value)}</b>
16
- </div>
17
- <div className="relative mt-1 h-1 overflow-hidden border border-line bg-panel">
18
- <i
19
- className="absolute inset-y-0 left-0 bg-lume"
20
- style={{ width: `${Math.max(0, Math.min(100, value))}%` }}
21
- />
22
- </div>
23
- </div>
24
- );
25
- }
14
+ export function Hud() {
15
+ const state = useUiState<GameState>();
16
+ // Nothing to draw until the game publishes its first snapshot, a few milliseconds in. Rendering
17
+ // zeroes instead would put a wrong score on screen and then correct it.
18
+ if (state === undefined) return null;
19
+ const position = Math.max(0, Math.min(100, Math.abs(state.playerX) * 10));
20
+ const won = state.status === "won";
26
21
 
27
- export function Hud({ game }: { game: IGame<GameState, IPhysicsContext> }) {
28
- const score = useGameState(game, (state) => state.score);
29
- const playerX = useGameState(game, (state) => state.playerX);
30
22
  return (
31
- <div className="pointer-events-none absolute left-6 top-6 w-32">
32
- <div className="text-[10px] uppercase tracking-[0.14em] text-dim">score</div>
33
- <div className="text-4xl leading-none tabular-nums text-lume">{score}</div>
34
- <Meter label="position" value={Math.abs(playerX) * 10} />
35
- </div>
23
+ <>
24
+ <div className="pointer-events-none absolute left-6 top-6 w-32">
25
+ <div className="text-[10px] uppercase tracking-[0.14em] text-dim">score</div>
26
+ <div className="text-4xl leading-none tabular-nums text-lume">{state.score}</div>
27
+ <div className="mt-3 flex items-center gap-2 text-[10px] uppercase tracking-[0.14em] text-dim">
28
+ lives
29
+ {[0, 1, 2].map((slot) => (
30
+ <i
31
+ className={`h-2 w-2 border border-line ${slot < state.lives ? "bg-lume" : "bg-panel"}`}
32
+ key={slot}
33
+ />
34
+ ))}
35
+ </div>
36
+ <div className="mt-3 w-24">
37
+ <div className="flex justify-between gap-2 text-[10px] uppercase tracking-[0.14em] text-dim">
38
+ <span>position</span>
39
+ <b className="font-normal tabular-nums text-text">{Math.round(position)}</b>
40
+ </div>
41
+ <div className="relative mt-1 h-1 overflow-hidden border border-line bg-panel">
42
+ <i className="absolute inset-y-0 left-0 bg-lume" style={{ width: `${position}%` }} />
43
+ </div>
44
+ </div>
45
+ </div>
46
+ {state.status === "playing" ? null : (
47
+ <div className="pointer-events-none absolute inset-x-0 top-1/3 flex flex-col items-center gap-2">
48
+ <output
49
+ className={`text-5xl uppercase tracking-[0.2em] ${won ? "text-lume" : "text-text"}`}
50
+ >
51
+ {won ? "flag reached" : "out of lives"}
52
+ </output>
53
+ <div className="text-[11px] uppercase tracking-[0.14em] text-dim">
54
+ press r to run it again
55
+ </div>
56
+ </div>
57
+ )}
58
+ </>
36
59
  );
37
60
  }