create-threenative 0.2.3 → 0.2.5

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 (447) hide show
  1. package/README.md +53 -2
  2. package/agent-docs/references/assertion-reference.md +173 -6
  3. package/agent-docs/references/capability-reference.md +1303 -99
  4. package/agent-docs/references/capture-the-frame.md +7 -0
  5. package/agent-docs/references/creating-creatures.md +215 -0
  6. package/agent-docs/references/ctx-cookbook.md +69 -0
  7. package/agent-docs/references/debug-surface.md +8 -3
  8. package/agent-docs/references/dream-loop.md +150 -0
  9. package/agent-docs/references/finding-assets.md +70 -2
  10. package/agent-docs/references/sculpt-from-a-reference.md +3 -2
  11. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  12. package/agent-docs/references/visual-baseline.md +41 -0
  13. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  14. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  15. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  16. package/agent-files/.agents/skills/threenative-builder/SKILL.md +1 -1
  17. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  18. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  19. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  20. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  21. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  22. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +1 -1
  23. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  24. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  25. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  26. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  27. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  28. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  29. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  30. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  31. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  32. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  33. package/agent-files/scripts/reference.mjs +705 -0
  34. package/agent-files/scripts/visual-loop.mjs +382 -0
  35. package/capabilities.json +1881 -131
  36. package/dist/index.d.ts +39 -6
  37. package/dist/index.js +297 -32
  38. package/dist/threenative.js +822 -105
  39. package/package.json +30 -5
  40. package/template-assets/loading.ts +12 -2
  41. package/template-assets/patches/three@0.185.1.patch +249 -14
  42. package/template-assets/worldEnvironment.ts +758 -0
  43. package/templates/action-rpg/.codex/config.toml +4 -0
  44. package/templates/action-rpg/.cursor/mcp.json +32 -0
  45. package/templates/action-rpg/.gemini/settings.json +32 -0
  46. package/templates/action-rpg/.mcp.json +15 -3
  47. package/templates/action-rpg/.vscode/mcp.json +36 -0
  48. package/templates/action-rpg/.zed/settings.json +36 -0
  49. package/templates/action-rpg/AGENTS.md +69 -378
  50. package/templates/action-rpg/CLAUDE.md +69 -378
  51. package/templates/action-rpg/opencode.json +41 -0
  52. package/templates/action-rpg/package.json +7 -7
  53. package/templates/action-rpg/playtests/combat.playtest.json +9 -0
  54. package/templates/action-rpg/playtests/performance.playtest.json +24 -7
  55. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  56. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  57. package/templates/action-rpg/src/conventions.ts +35 -0
  58. package/templates/action-rpg/src/entities/Enemy.ts +2 -3
  59. package/templates/action-rpg/src/entities/Player.ts +20 -3
  60. package/templates/action-rpg/src/render/camera.ts +7 -2
  61. package/templates/action-rpg/src/render/lighting.ts +5 -3
  62. package/templates/action-rpg/src/render/loading.ts +12 -2
  63. package/templates/action-rpg/src/render/materials.ts +11 -0
  64. package/templates/action-rpg/src/render/palette.ts +10 -3
  65. package/templates/action-rpg/src/render/postprocessing.ts +21 -58
  66. package/templates/action-rpg/src/render/quality.ts +170 -0
  67. package/templates/action-rpg/src/render/shapes.ts +185 -26
  68. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  69. package/templates/action-rpg/src/render/vfx.ts +257 -0
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +208 -33
  71. package/templates/action-rpg/src/scenes/Play.ts +43 -6
  72. package/templates/action-rpg/src/style.css +20 -0
  73. package/templates/action-rpg/threenative.config.ts +7 -0
  74. package/templates/defense/.codex/config.toml +4 -0
  75. package/templates/defense/.cursor/mcp.json +32 -0
  76. package/templates/defense/.gemini/settings.json +32 -0
  77. package/templates/defense/.mcp.json +15 -3
  78. package/templates/defense/.vscode/mcp.json +36 -0
  79. package/templates/defense/.zed/settings.json +36 -0
  80. package/templates/defense/AGENTS.md +62 -385
  81. package/templates/defense/CLAUDE.md +62 -385
  82. package/templates/defense/opencode.json +41 -0
  83. package/templates/defense/package.json +7 -7
  84. package/templates/defense/playtests/performance.playtest.json +24 -7
  85. package/templates/defense/playtests/pointer-placement.playtest.json +87 -20
  86. package/templates/defense/playtests/scan.playtest.json +1 -1
  87. package/templates/defense/playtests/survive.playtest.json +14 -0
  88. package/templates/defense/src/attackers/Attacker.ts +4 -4
  89. package/templates/defense/src/board/Route.ts +22 -8
  90. package/templates/defense/src/conventions.ts +18 -0
  91. package/templates/defense/src/entities/Player.ts +11 -3
  92. package/templates/defense/src/game.ts +2 -3
  93. package/templates/defense/src/physics.ts +9 -39
  94. package/templates/defense/src/placement/Buildable.ts +4 -4
  95. package/templates/defense/src/render/camera.ts +9 -3
  96. package/templates/defense/src/render/loading.ts +12 -2
  97. package/templates/defense/src/render/materials.ts +9 -0
  98. package/templates/defense/src/render/palette.ts +12 -5
  99. package/templates/defense/src/render/postprocessing.ts +21 -58
  100. package/templates/defense/src/render/quality.ts +170 -0
  101. package/templates/defense/src/render/shapes.ts +142 -23
  102. package/templates/defense/src/render/sky.ts +2 -2
  103. package/templates/defense/src/render/worldEnvironment.ts +208 -33
  104. package/templates/defense/src/scenes/Boot.ts +2 -2
  105. package/templates/defense/src/scenes/Defense.ts +13 -6
  106. package/templates/defense/src/style.css +20 -0
  107. package/templates/defense/src/towers/Tower.ts +11 -12
  108. package/templates/defense/src/towers/targeting.ts +1 -1
  109. package/templates/defense/src/ui/App.tsx +2 -2
  110. package/templates/defense/threenative.config.ts +7 -0
  111. package/templates/minimal/.codex/config.toml +4 -0
  112. package/templates/minimal/.cursor/mcp.json +32 -0
  113. package/templates/minimal/.gemini/settings.json +32 -0
  114. package/templates/minimal/.mcp.json +15 -3
  115. package/templates/minimal/.vscode/mcp.json +36 -0
  116. package/templates/minimal/.zed/settings.json +36 -0
  117. package/templates/minimal/AGENTS.md +76 -485
  118. package/templates/minimal/CLAUDE.md +76 -485
  119. package/templates/minimal/opencode.json +41 -0
  120. package/templates/minimal/package.json +6 -6
  121. package/templates/minimal/playtests/play.playtest.json +2 -1
  122. package/templates/minimal/playtests/survives.playtest.json +48 -4
  123. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  124. package/templates/minimal/src/conventions.ts +18 -0
  125. package/templates/minimal/src/entities/Player.ts +39 -6
  126. package/templates/minimal/src/main.ts +14 -4
  127. package/templates/minimal/src/render/materials.ts +7 -0
  128. package/templates/minimal/src/render/palette.ts +3 -3
  129. package/templates/minimal/src/render/postprocessing.ts +17 -56
  130. package/templates/minimal/src/render/quality.ts +162 -0
  131. package/templates/minimal/src/render/sky.ts +23 -9
  132. package/templates/minimal/src/render/touch-controls.ts +165 -0
  133. package/templates/minimal/src/render/worldEnvironment.ts +208 -33
  134. package/templates/minimal/src/scenes/Play.ts +47 -11
  135. package/templates/minimal/src/style.css +20 -0
  136. package/templates/minimal/threenative.config.ts +7 -0
  137. package/templates/platformer/.codex/config.toml +4 -0
  138. package/templates/platformer/.cursor/mcp.json +32 -0
  139. package/templates/platformer/.gemini/settings.json +32 -0
  140. package/templates/platformer/.mcp.json +15 -3
  141. package/templates/platformer/.vscode/mcp.json +36 -0
  142. package/templates/platformer/.zed/settings.json +36 -0
  143. package/templates/platformer/AGENTS.md +70 -430
  144. package/templates/platformer/CLAUDE.md +70 -430
  145. package/templates/platformer/opencode.json +41 -0
  146. package/templates/platformer/package.json +7 -7
  147. package/templates/platformer/playtests/oneway.playtest.json +29 -2
  148. package/templates/platformer/playtests/performance.playtest.json +2 -1
  149. package/templates/platformer/playtests/survives.playtest.json +31 -0
  150. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +3 -0
  151. package/templates/platformer/playtests/touch-controls-web.playtest.json +15 -4
  152. package/templates/platformer/src/conventions.ts +18 -0
  153. package/templates/platformer/src/entities/Character.ts +63 -1
  154. package/templates/platformer/src/game.ts +3 -1
  155. package/templates/platformer/src/level/Platform.ts +13 -1
  156. package/templates/platformer/src/render/lighting.ts +7 -4
  157. package/templates/platformer/src/render/loading.ts +12 -2
  158. package/templates/platformer/src/render/palette.ts +4 -1
  159. package/templates/platformer/src/render/postprocessing.ts +32 -57
  160. package/templates/platformer/src/render/quality.ts +170 -0
  161. package/templates/platformer/src/render/worldEnvironment.ts +208 -33
  162. package/templates/platformer/src/scenes/Level.ts +52 -12
  163. package/templates/platformer/src/style.css +20 -0
  164. package/templates/platformer/threenative.config.ts +7 -0
  165. package/templates/puzzle/.codex/config.toml +19 -0
  166. package/templates/puzzle/.cursor/mcp.json +32 -0
  167. package/templates/puzzle/.gemini/settings.json +32 -0
  168. package/templates/puzzle/.mcp.json +32 -0
  169. package/templates/puzzle/.vscode/mcp.json +36 -0
  170. package/templates/puzzle/.zed/settings.json +36 -0
  171. package/templates/puzzle/AGENTS.md +96 -0
  172. package/templates/puzzle/CLAUDE.md +98 -0
  173. package/templates/puzzle/README.md +43 -0
  174. package/templates/puzzle/index.html +12 -0
  175. package/templates/puzzle/kit.json +7 -0
  176. package/templates/puzzle/opencode.json +41 -0
  177. package/templates/puzzle/package.json +50 -0
  178. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  179. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  180. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  181. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  182. package/templates/puzzle/public/favicon.svg +5 -0
  183. package/templates/puzzle/src/conventions.ts +25 -0
  184. package/templates/puzzle/src/entities/Ball.ts +70 -0
  185. package/templates/puzzle/src/entities/Crate.ts +76 -0
  186. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  187. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  188. package/templates/puzzle/src/game.ts +48 -0
  189. package/templates/puzzle/src/main.ts +15 -0
  190. package/templates/puzzle/src/physics.ts +19 -0
  191. package/templates/puzzle/src/render/camera.ts +37 -0
  192. package/templates/puzzle/src/render/lighting.ts +55 -0
  193. package/templates/puzzle/src/render/loading.ts +325 -0
  194. package/templates/puzzle/src/render/materials.ts +28 -0
  195. package/templates/puzzle/src/render/palette.ts +31 -0
  196. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  197. package/templates/puzzle/src/render/quality.ts +170 -0
  198. package/templates/puzzle/src/render/shapes.ts +134 -0
  199. package/templates/puzzle/src/render/sky.ts +16 -0
  200. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  201. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  202. package/templates/puzzle/src/room.ts +83 -0
  203. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  204. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  205. package/templates/puzzle/src/state.ts +30 -0
  206. package/templates/puzzle/src/style.css +96 -0
  207. package/templates/puzzle/src/ui/App.tsx +22 -0
  208. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  209. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  210. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  211. package/templates/puzzle/src/ui/main.tsx +14 -0
  212. package/templates/puzzle/tailwind.config.ts +1 -0
  213. package/templates/puzzle/threenative.config.ts +49 -0
  214. package/templates/puzzle/tsconfig.json +17 -0
  215. package/templates/puzzle/vite.config.ts +38 -0
  216. package/templates/racing/.codex/config.toml +4 -0
  217. package/templates/racing/.cursor/mcp.json +32 -0
  218. package/templates/racing/.gemini/settings.json +32 -0
  219. package/templates/racing/.mcp.json +15 -3
  220. package/templates/racing/.vscode/mcp.json +36 -0
  221. package/templates/racing/.zed/settings.json +36 -0
  222. package/templates/racing/AGENTS.md +63 -379
  223. package/templates/racing/CLAUDE.md +63 -379
  224. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  225. package/templates/racing/opencode.json +41 -0
  226. package/templates/racing/package.json +8 -7
  227. package/templates/racing/playtests/performance.playtest.json +24 -7
  228. package/templates/racing/playtests/survives.playtest.json +36 -4
  229. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  230. package/templates/racing/src/conventions.ts +6 -0
  231. package/templates/racing/src/entities/RacingCar.ts +16 -4
  232. package/templates/racing/src/entities/Rival.ts +5 -2
  233. package/templates/racing/src/render/camera.ts +7 -4
  234. package/templates/racing/src/render/lighting.ts +22 -13
  235. package/templates/racing/src/render/loading.ts +12 -2
  236. package/templates/racing/src/render/materials.ts +54 -4
  237. package/templates/racing/src/render/palette.ts +23 -6
  238. package/templates/racing/src/render/postprocessing.ts +21 -58
  239. package/templates/racing/src/render/quality.ts +170 -0
  240. package/templates/racing/src/render/shapes.ts +537 -26
  241. package/templates/racing/src/render/sky.ts +5 -2
  242. package/templates/racing/src/render/touch-controls.ts +185 -0
  243. package/templates/racing/src/render/worldEnvironment.ts +208 -33
  244. package/templates/racing/src/scenes/Race.ts +17 -2
  245. package/templates/racing/src/style.css +20 -0
  246. package/templates/racing/src/track/Track.ts +270 -31
  247. package/templates/racing/threenative.config.ts +7 -0
  248. package/templates/runner/.codex/config.toml +19 -0
  249. package/templates/runner/.cursor/mcp.json +32 -0
  250. package/templates/runner/.gemini/settings.json +32 -0
  251. package/templates/runner/.mcp.json +32 -0
  252. package/templates/runner/.vscode/mcp.json +36 -0
  253. package/templates/runner/.zed/settings.json +36 -0
  254. package/templates/runner/AGENTS.md +96 -0
  255. package/templates/runner/CLAUDE.md +98 -0
  256. package/templates/runner/README.md +43 -0
  257. package/templates/runner/index.html +12 -0
  258. package/templates/runner/kit.json +7 -0
  259. package/templates/runner/opencode.json +41 -0
  260. package/templates/runner/package.json +50 -0
  261. package/templates/runner/playtests/performance.playtest.json +23 -0
  262. package/templates/runner/playtests/streams.playtest.json +38 -0
  263. package/templates/runner/playtests/survives.playtest.json +51 -0
  264. package/templates/runner/public/favicon.svg +5 -0
  265. package/templates/runner/src/conventions.ts +24 -0
  266. package/templates/runner/src/entities/Runner.ts +135 -0
  267. package/templates/runner/src/game.ts +50 -0
  268. package/templates/runner/src/main.ts +15 -0
  269. package/templates/runner/src/physics.ts +13 -0
  270. package/templates/runner/src/render/camera.ts +39 -0
  271. package/templates/runner/src/render/dust.ts +131 -0
  272. package/templates/runner/src/render/lighting.ts +57 -0
  273. package/templates/runner/src/render/loading.ts +325 -0
  274. package/templates/runner/src/render/materials.ts +27 -0
  275. package/templates/runner/src/render/palette.ts +30 -0
  276. package/templates/runner/src/render/postprocessing.ts +34 -0
  277. package/templates/runner/src/render/quality.ts +170 -0
  278. package/templates/runner/src/render/shapes.ts +68 -0
  279. package/templates/runner/src/render/sky.ts +51 -0
  280. package/templates/runner/src/render/touch-controls.ts +185 -0
  281. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  282. package/templates/runner/src/scenes/Boot.ts +12 -0
  283. package/templates/runner/src/scenes/Run.ts +142 -0
  284. package/templates/runner/src/state.ts +29 -0
  285. package/templates/runner/src/style.css +96 -0
  286. package/templates/runner/src/track.ts +176 -0
  287. package/templates/runner/src/ui/App.tsx +22 -0
  288. package/templates/runner/src/ui/GameUi.tsx +20 -0
  289. package/templates/runner/src/ui/Hud.tsx +55 -0
  290. package/templates/runner/src/ui/Menu.tsx +7 -0
  291. package/templates/runner/src/ui/main.tsx +14 -0
  292. package/templates/runner/tailwind.config.ts +1 -0
  293. package/templates/runner/threenative.config.ts +49 -0
  294. package/templates/runner/tsconfig.json +17 -0
  295. package/templates/runner/vite.config.ts +38 -0
  296. package/templates/sailing/.codex/config.toml +4 -0
  297. package/templates/sailing/.cursor/mcp.json +32 -0
  298. package/templates/sailing/.gemini/settings.json +32 -0
  299. package/templates/sailing/.mcp.json +15 -3
  300. package/templates/sailing/.vscode/mcp.json +36 -0
  301. package/templates/sailing/.zed/settings.json +36 -0
  302. package/templates/sailing/AGENTS.md +62 -355
  303. package/templates/sailing/CLAUDE.md +62 -355
  304. package/templates/sailing/README.md +12 -9
  305. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  306. package/templates/sailing/native-playtests/survives.playtest.json +20 -3
  307. package/templates/sailing/opencode.json +41 -0
  308. package/templates/sailing/package.json +8 -8
  309. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  310. package/templates/sailing/playtests/float.playtest.json +59 -0
  311. package/templates/sailing/playtests/performance.playtest.json +21 -6
  312. package/templates/sailing/playtests/survives.playtest.json +8 -0
  313. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  314. package/templates/sailing/src/conventions.ts +8 -0
  315. package/templates/sailing/src/entities/Ship.ts +150 -13
  316. package/templates/sailing/src/render/camera.ts +15 -8
  317. package/templates/sailing/src/render/lighting.ts +10 -5
  318. package/templates/sailing/src/render/loading.ts +12 -2
  319. package/templates/sailing/src/render/materials.ts +24 -8
  320. package/templates/sailing/src/render/ocean.ts +179 -0
  321. package/templates/sailing/src/render/palette.ts +14 -21
  322. package/templates/sailing/src/render/postprocessing.ts +23 -22
  323. package/templates/sailing/src/render/props.ts +584 -34
  324. package/templates/sailing/src/render/quality.ts +140 -0
  325. package/templates/sailing/src/render/sky.ts +8 -3
  326. package/templates/sailing/src/render/touch-controls.ts +142 -0
  327. package/templates/sailing/src/render/worldEnvironment.ts +206 -38
  328. package/templates/sailing/src/scenes/Sailing.ts +43 -16
  329. package/templates/sailing/src/style.css +20 -0
  330. package/templates/sailing/threenative.config.ts +7 -1
  331. package/templates/shooter/.codex/config.toml +4 -0
  332. package/templates/shooter/.cursor/mcp.json +32 -0
  333. package/templates/shooter/.gemini/settings.json +32 -0
  334. package/templates/shooter/.mcp.json +15 -3
  335. package/templates/shooter/.vscode/mcp.json +36 -0
  336. package/templates/shooter/.zed/settings.json +36 -0
  337. package/templates/shooter/AGENTS.md +76 -415
  338. package/templates/shooter/CLAUDE.md +76 -415
  339. package/templates/shooter/kit.json +2 -2
  340. package/templates/shooter/opencode.json +41 -0
  341. package/templates/shooter/package.json +7 -7
  342. package/templates/shooter/playtests/combat.playtest.json +48 -0
  343. package/templates/shooter/playtests/input-control.playtest.json +165 -35
  344. package/templates/shooter/playtests/per-item.playtest.json +3 -3
  345. package/templates/shooter/playtests/performance.playtest.json +24 -7
  346. package/templates/shooter/playtests/shooter.playtest.json +13 -7
  347. package/templates/shooter/playtests/survives.playtest.json +27 -0
  348. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  349. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  350. package/templates/shooter/src/combat/damage.ts +1 -2
  351. package/templates/shooter/src/conventions.ts +51 -0
  352. package/templates/shooter/src/entities/Player.ts +235 -18
  353. package/templates/shooter/src/entities/Target.ts +2 -2
  354. package/templates/shooter/src/game.ts +13 -4
  355. package/templates/shooter/src/render/camera.ts +49 -39
  356. package/templates/shooter/src/render/decals.ts +211 -0
  357. package/templates/shooter/src/render/lighting.ts +7 -3
  358. package/templates/shooter/src/render/loading.ts +12 -2
  359. package/templates/shooter/src/render/materials.ts +56 -3
  360. package/templates/shooter/src/render/palette.ts +6 -3
  361. package/templates/shooter/src/render/postprocessing.ts +21 -58
  362. package/templates/shooter/src/render/quality.ts +170 -0
  363. package/templates/shooter/src/render/scale.ts +22 -0
  364. package/templates/shooter/src/render/shapes.ts +343 -62
  365. package/templates/shooter/src/render/sky.ts +5 -1
  366. package/templates/shooter/src/render/touch-controls.ts +305 -0
  367. package/templates/shooter/src/render/ui.css +85 -0
  368. package/templates/shooter/src/render/ui.ts +19 -3
  369. package/templates/shooter/src/render/vfx.ts +215 -0
  370. package/templates/shooter/src/render/worldEnvironment.ts +208 -33
  371. package/templates/shooter/src/scenes/Play.ts +171 -56
  372. package/templates/shooter/src/state.ts +5 -0
  373. package/templates/shooter/src/style.css +20 -0
  374. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  375. package/templates/shooter/src/ui/GameUi.tsx +2 -0
  376. package/templates/shooter/src/ui/Hud.tsx +7 -1
  377. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  378. package/templates/shooter/src/weapons/Projectile.ts +8 -3
  379. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  380. package/templates/shooter/threenative.config.ts +7 -0
  381. package/templates/starter/.codex/config.toml +4 -0
  382. package/templates/starter/.cursor/mcp.json +32 -0
  383. package/templates/starter/.gemini/settings.json +32 -0
  384. package/templates/starter/.mcp.json +15 -3
  385. package/templates/starter/.vscode/mcp.json +36 -0
  386. package/templates/starter/.zed/settings.json +36 -0
  387. package/templates/starter/AGENTS.md +70 -527
  388. package/templates/starter/CLAUDE.md +70 -527
  389. package/templates/starter/native-playtests/render-chain.playtest.json +73 -4
  390. package/templates/starter/opencode.json +41 -0
  391. package/templates/starter/package.json +7 -7
  392. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  393. package/templates/starter/playtests/look.playtest.json +110 -6
  394. package/templates/starter/playtests/play.playtest.json +3 -2
  395. package/templates/starter/playtests/survives.playtest.json +21 -0
  396. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  397. package/templates/starter/src/conventions.ts +18 -0
  398. package/templates/starter/src/entities/Goal.ts +18 -3
  399. package/templates/starter/src/entities/Player.ts +72 -9
  400. package/templates/starter/src/game.ts +2 -0
  401. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  402. package/templates/starter/src/render/camera.ts +1 -1
  403. package/templates/starter/src/render/coast.ts +199 -0
  404. package/templates/starter/src/render/hero.ts +88 -0
  405. package/templates/starter/src/render/implicitSurface.ts +199 -0
  406. package/templates/starter/src/render/kuwahara.ts +174 -0
  407. package/templates/starter/src/render/lighting.ts +4 -4
  408. package/templates/starter/src/render/loading.ts +12 -2
  409. package/templates/starter/src/render/materials.ts +25 -6
  410. package/templates/starter/src/render/outline.ts +141 -0
  411. package/templates/starter/src/render/painterly.ts +86 -0
  412. package/templates/starter/src/render/palette.ts +15 -6
  413. package/templates/starter/src/render/postprocessing.ts +87 -36
  414. package/templates/starter/src/render/quality.ts +185 -0
  415. package/templates/starter/src/render/rockRidge.ts +198 -0
  416. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  417. package/templates/starter/src/render/scenery.ts +16 -59
  418. package/templates/starter/src/render/textureLifetime.ts +53 -0
  419. package/templates/starter/src/render/touch-controls.ts +165 -0
  420. package/templates/starter/src/render/water.ts +38 -0
  421. package/templates/starter/src/render/watercolor.ts +85 -0
  422. package/templates/starter/src/render/worldEnvironment.ts +208 -33
  423. package/templates/starter/src/scenes/Play.ts +103 -16
  424. package/templates/starter/src/style.css +27 -7
  425. package/templates/starter/threenative.config.ts +7 -7
  426. package/agent-docs/asset-mcp-loop.md +0 -33
  427. package/agent-docs/ctx-surface.md +0 -69
  428. package/agent-docs/engine-capabilities.md +0 -4
  429. package/agent-docs/framework-blocks-you.md +0 -60
  430. package/agent-docs/look-at-it-and-budget-the-look.md +0 -27
  431. package/agent-docs/performance-default.md +0 -42
  432. package/agent-docs/pixel-budget.md +0 -20
  433. package/agent-docs/playtest-fail-closed.md +0 -23
  434. package/agent-docs/sculpt-loop.md +0 -16
  435. package/templates/action-rpg/src/physics.ts +0 -40
  436. package/templates/defense/public/icon.png +0 -0
  437. package/templates/minimal/public/icon.png +0 -0
  438. package/templates/platformer/public/icon.png +0 -0
  439. package/templates/racing/public/icon.png +0 -0
  440. package/templates/sailing/public/icon.png +0 -0
  441. package/templates/sailing/src/render/water-material.ts +0 -14
  442. package/templates/sailing/src/render/water-shaders.ts +0 -12
  443. package/templates/sailing/src/render/wave-nodes.ts +0 -10
  444. package/templates/shooter/public/icon.png +0 -0
  445. package/templates/shooter/src/physics.ts +0 -49
  446. package/templates/starter/public/icon.png +0 -0
  447. /package/{templates/action-rpg/public → template-assets}/icon.png +0 -0
@@ -0,0 +1,12 @@
1
+ import { Scene } from "@threenative/core";
2
+ import type { RunnerPhysics } from "../physics.js";
3
+ import type { GameState } from "../state.js";
4
+ import { type GameCtx, Run } from "./Run.js";
5
+
6
+ export class Boot extends Scene<GameState, RunnerPhysics> {
7
+ static override readonly initialState = Run.initialState;
8
+
9
+ override enter(ctx: GameCtx): void {
10
+ void ctx.goto("run");
11
+ }
12
+ }
@@ -0,0 +1,142 @@
1
+ import {
2
+ CameraShake,
3
+ GPUParticles3D,
4
+ type ICtx,
5
+ Scene,
6
+ type SceneFrame,
7
+ afterPhysics,
8
+ isMobile,
9
+ isTouchscreenAvailable,
10
+ } from "@threenative/core";
11
+ import { type PerspectiveCamera, Vector3 } from "three";
12
+ import { Runner } from "../entities/Runner.js";
13
+ import type { RunnerPhysics } from "../physics.js";
14
+ import { chaseRunner, setupCamera } from "../render/camera.js";
15
+ import { createDustTrail } from "../render/dust.js";
16
+ import { setupLighting } from "../render/lighting.js";
17
+ import { createLoadingScreen } from "../render/loading.js";
18
+ import { setupPost } from "../render/postprocessing.js";
19
+ import { setupSky } from "../render/sky.js";
20
+ import { TouchControls } from "../render/touch-controls.js";
21
+ import { type GameState, INITIAL_STATE } from "../state.js";
22
+ import { CHUNK_LENGTH, LANE_X, Track } from "../track.js";
23
+
24
+ export type GameCtx = ICtx<GameState, RunnerPhysics>;
25
+
26
+ const START_SPEED = 11;
27
+ const TOP_SPEED = 26;
28
+ /** Metres per second gained per second run. Reach top speed at about a minute. */
29
+ const ACCELERATION = 0.25;
30
+
31
+ export class Run extends Scene<GameState, RunnerPhysics> {
32
+ static override readonly initialState = INITIAL_STATE;
33
+
34
+ override enter(ctx: GameCtx): SceneFrame<GameState, RunnerPhysics> {
35
+ setupSky(ctx.scene);
36
+ const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
37
+ // isMobile() arrives as an argument because src/render/ imports no framework package: the
38
+ // platform decision is made here, in portable game code.
39
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, { godraysLight: sun, mobile: isMobile() });
40
+ const camera = ctx.camera as PerspectiveCamera;
41
+ setupCamera(camera);
42
+ ctx.add(camera);
43
+ const loading = createLoadingScreen(ctx);
44
+
45
+ const showTouchControls = isMobile() && isTouchscreenAvailable();
46
+ const touchControls = showTouchControls
47
+ ? ctx.entities.add("touch-controls", new TouchControls(camera))
48
+ : undefined;
49
+
50
+ // `ctx.random` is the seeded source `defineGame({ seed })` installed, so the same seed builds
51
+ // the same track — which is what makes a runner's scenario reproducible at all.
52
+ const chunkContext = {
53
+ add: (object: Parameters<typeof ctx.add>[0]) => ctx.add(object),
54
+ physics: ctx.physics,
55
+ random: () => ctx.random(),
56
+ };
57
+ const track = new Track(chunkContext);
58
+ const runner = new Runner(ctx);
59
+ ctx.entities.add("player", runner);
60
+
61
+ const dust = ctx.add(new GPUParticles3D(createDustTrail()));
62
+ const shake = new CameraShake({
63
+ amplitude: new Vector3(0.16, 0.1, 0),
64
+ curve: (radians) => Math.sin(radians) * Math.sin(radians * 0.37),
65
+ decay: 6.5,
66
+ frequency: 17,
67
+ rotationAmplitude: new Vector3(0, 0, 0.02),
68
+ });
69
+
70
+ let distance = 0;
71
+ let speed = START_SPEED;
72
+ let status = INITIAL_STATE.status;
73
+ let nearMisses = 0;
74
+ const scored = new Set<string>();
75
+
76
+ // The camera reads the runner after the step, so a lane change and its shake land in the same
77
+ // frame. Reading it in the frame function is one step of lag at 26 m/s, which is 0.4 m.
78
+ afterPhysics(ctx, (dt) => {
79
+ const offset = shake.update(dt);
80
+ chaseRunner(camera, runner.mesh.position, dt, offset.position);
81
+ dust.position.set(runner.mesh.position.x, 0.15, runner.mesh.position.z + 0.6);
82
+ });
83
+
84
+ return (frameCtx, dt) => {
85
+ loading.update();
86
+ if (frameCtx.input.justPressed("restart")) {
87
+ frameCtx.state.set(INITIAL_STATE);
88
+ frameCtx.state.flush();
89
+ void frameCtx.goto("run");
90
+ return;
91
+ }
92
+
93
+ const touch = touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size);
94
+ if (status === "RUNNING") {
95
+ speed = Math.min(TOP_SPEED, speed + ACCELERATION * dt);
96
+ distance += speed * dt;
97
+ runner.update(frameCtx, dt, distance, touch);
98
+ track.advance(chunkContext, distance);
99
+ if (runner.crashed) {
100
+ status = "CRASHED";
101
+ shake.trigger();
102
+ } else {
103
+ // A near miss is an obstacle this chunk passed beside rather than through. Counting it
104
+ // once per obstacle is what stops a single block shaking the camera for a whole second.
105
+ for (const chunk of track.chunks) {
106
+ const passed = distance - chunk.start;
107
+ if (passed < 0 || passed > CHUNK_LENGTH) continue;
108
+ for (const lane of LANE_X) {
109
+ const key = `${chunk.start}:${lane}`;
110
+ if (scored.has(key) || !runner.isNearMiss(lane)) continue;
111
+ scored.add(key);
112
+ runner.recordNearMiss();
113
+ nearMisses = runner.nearMisses;
114
+ shake.trigger();
115
+ }
116
+ }
117
+ }
118
+ }
119
+ dust.visible = status === "RUNNING";
120
+
121
+ const previous = frameCtx.state.getState();
122
+ const next: GameState = {
123
+ chunks: track.built,
124
+ distance,
125
+ lane: runner.lane,
126
+ nearMisses,
127
+ paused: previous.paused,
128
+ speed,
129
+ status,
130
+ uiReady: previous.uiReady,
131
+ };
132
+ if (
133
+ next.chunks !== previous.chunks ||
134
+ next.lane !== previous.lane ||
135
+ next.nearMisses !== previous.nearMisses ||
136
+ next.status !== previous.status ||
137
+ Math.floor(next.distance) !== Math.floor(previous.distance)
138
+ )
139
+ frameCtx.state.set(next);
140
+ };
141
+ }
142
+ }
@@ -0,0 +1,29 @@
1
+ export type RunStatus = "RUNNING" | "CRASHED";
2
+
3
+ export type GameState = {
4
+ /** Set from the UI's pause and resume intents, and read back by the menu. */
5
+ paused: boolean;
6
+ /** True once the UI layer has rendered and published its interactive rectangles. */
7
+ uiReady: boolean;
8
+ /** Metres travelled down the track. The score. */
9
+ distance: number;
10
+ /** Chunks built so far. Proof the track is streaming rather than one long mesh. */
11
+ chunks: number;
12
+ /** Obstacles cleared by less than a lane width. Each one shakes the camera. */
13
+ nearMisses: number;
14
+ /** Which of the three lanes the runner is in: 0, 1, 2. */
15
+ lane: number;
16
+ speed: number;
17
+ status: RunStatus;
18
+ };
19
+
20
+ export const INITIAL_STATE: GameState = {
21
+ paused: false,
22
+ uiReady: false,
23
+ distance: 0,
24
+ chunks: 0,
25
+ nearMisses: 0,
26
+ lane: 1,
27
+ speed: 0,
28
+ status: "RUNNING",
29
+ };
@@ -0,0 +1,96 @@
1
+ @import "tailwindcss";
2
+
3
+ @source "../index.html";
4
+ @source "./";
5
+
6
+ @theme {
7
+ --color-ink: #07131d;
8
+ --color-panel: #0d2430;
9
+ --color-line: #1d4a58;
10
+ --color-lume: #f5c451;
11
+ --color-win: #79e0b2;
12
+ --color-danger: #ff7182;
13
+ --color-text: #c1dce2;
14
+ --color-muted: #6c9aa5;
15
+ --font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
16
+ }
17
+
18
+ html,
19
+ body,
20
+ #root {
21
+ width: 100%;
22
+ height: 100%;
23
+ margin: 0;
24
+ overflow: hidden;
25
+ }
26
+
27
+ body {
28
+ color: var(--color-text);
29
+ font-family: var(--font-mono);
30
+ -webkit-font-smoothing: antialiased;
31
+ }
32
+
33
+ /*
34
+ * The page's backdrop belongs to the web document's own mount point, never to `body`.
35
+ * `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
36
+ * transparent web view loads over the game: a `body` background there paints an opaque sheet over
37
+ * the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
38
+ * in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
39
+ */
40
+
41
+ #root {
42
+ background: var(--color-ink);
43
+ }
44
+
45
+ /* Boot failures are a page state, so the generated game owns their presentation. */
46
+ [data-threenative-canvas-error="true"] {
47
+ position: fixed;
48
+ inset: 0;
49
+ z-index: 1000;
50
+ display: grid;
51
+ place-items: center;
52
+ box-sizing: border-box;
53
+ padding: clamp(1.5rem, 8vw, 6rem);
54
+ overflow: auto;
55
+ background: #fff7ed;
56
+ color: var(--color-ink);
57
+ font-family: inherit;
58
+ font-size: clamp(1rem, 2vw, 1.5rem);
59
+ line-height: 1.5;
60
+ text-align: center;
61
+ white-space: pre-wrap;
62
+ overflow-wrap: anywhere;
63
+ }
64
+
65
+ /* The debug surface is framework plumbing; its default presentation is yours to change. */
66
+ [data-threenative-debug-overlay="true"] {
67
+ position: fixed;
68
+ top: 1rem;
69
+ right: 1rem;
70
+ z-index: 50;
71
+ max-width: 24rem;
72
+ padding: 0.75rem;
73
+ pointer-events: none;
74
+ background: rgb(2 6 23 / 90%);
75
+ box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
76
+ color: #cffafe;
77
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
78
+ font-size: 12px;
79
+ line-height: 1.5;
80
+ }
81
+
82
+ [data-threenative-debug-overlay="true"] table {
83
+ width: 100%;
84
+ table-layout: fixed;
85
+ }
86
+
87
+ [data-threenative-debug-overlay="true"] th,
88
+ [data-threenative-debug-overlay="true"] td {
89
+ padding-right: 1rem;
90
+ text-align: left;
91
+ }
92
+
93
+ [data-threenative-debug-overlay="true"] td:last-child {
94
+ overflow-wrap: anywhere;
95
+ word-break: break-all;
96
+ }
@@ -0,0 +1,176 @@
1
+ import { InstancedBatch } from "@threenative/core";
2
+ import { CollisionShape3D, RigidBody3D } from "@threenative/physics";
3
+ import {
4
+ type BufferGeometry,
5
+ Group,
6
+ Matrix4,
7
+ type MeshStandardMaterial,
8
+ type Object3D,
9
+ } from "three";
10
+ import { OBSTACLE_LAYER, type RunnerPhysics } from "./physics.js";
11
+ import {
12
+ LANE_WIDTH,
13
+ OBSTACLE_SIZE,
14
+ obstacleShape,
15
+ trackRails,
16
+ trackSlab,
17
+ } from "./render/shapes.js";
18
+
19
+ export const CHUNK_LENGTH = 24;
20
+ /** How many chunks exist at once. The track is infinite; this many meshes are not. */
21
+ export const RESIDENT_CHUNKS = 6;
22
+ /** Slots per chunk. Fixed, because an `InstancedMesh` cannot grow after it is built. */
23
+ export const MAX_OBSTACLES = 4;
24
+ export const LANE_X = [-LANE_WIDTH, 0, LANE_WIDTH] as const;
25
+ /** No obstacles this close to the start, so the first seconds teach the controls. */
26
+ const GRACE_METRES = 34;
27
+ /** Where an unused slot goes: far under the floor, scaled to nothing. */
28
+ const PARKED = new Matrix4().makeScale(0, 0, 0).setPosition(0, -1000, 0);
29
+
30
+ export interface IChunkContext {
31
+ readonly physics: RunnerPhysics;
32
+ add(object: Object3D): Object3D;
33
+ random(): number;
34
+ }
35
+
36
+ /**
37
+ * One recycled slice of track.
38
+ *
39
+ * The road, the rails, the obstacle geometry and the obstacle material are built once and then
40
+ * moved. `InstancedBatch` places `MAX_OBSTACLES` slots at construction and `build()` hands back
41
+ * the `InstancedMesh`; a recycle rewrites that mesh's matrices and parks the slots it does not
42
+ * need. An earlier version built a fresh batch per recycle and only `remove()`d the old mesh,
43
+ * which in Three.js frees no GPU memory at all — every obstacle-bearing recycle leaked a
44
+ * geometry, a material and an instance buffer, forever, on exactly the ten-minute run the
45
+ * comment used to boast about.
46
+ *
47
+ * **The obstacle bodies are the exception, and are not recycled.** `RigidBody3D` has no
48
+ * reposition API for a fixed body, so each recycle disposes the chunk's bodies and creates new
49
+ * ones. They are disposed, so nothing leaks — but the claim is "the render side allocates
50
+ * nothing", not "nothing allocates".
51
+ */
52
+ export class Chunk {
53
+ readonly group = new Group();
54
+ readonly #bodies: RigidBody3D[] = [];
55
+ readonly #obstacles: ReturnType<InstancedBatch["build"]>;
56
+ readonly #matrix = new Matrix4();
57
+ #start = 0;
58
+
59
+ constructor(
60
+ ctx: IChunkContext,
61
+ index: number,
62
+ geometry: BufferGeometry,
63
+ material: MeshStandardMaterial,
64
+ ) {
65
+ this.group.name = `chunk-${index}`;
66
+ this.group.add(trackSlab(CHUNK_LENGTH), trackRails(CHUNK_LENGTH));
67
+ const batch = new InstancedBatch({ geometry, material });
68
+ for (let slot = 0; slot < MAX_OBSTACLES; slot += 1) batch.place({ position: [0, -1000, 0] });
69
+ this.#obstacles = batch.build({ castShadow: true, name: "obstacles", parent: this.group });
70
+ ctx.add(this.group);
71
+ }
72
+
73
+ get start(): number {
74
+ return this.#start;
75
+ }
76
+
77
+ /** Places the chunk at `start` metres and rewrites its obstacles for that stretch of track. */
78
+ build(ctx: IChunkContext, start: number): void {
79
+ this.#start = start;
80
+ this.group.position.z = -(start + CHUNK_LENGTH / 2);
81
+ for (const body of this.#bodies) body.dispose();
82
+ this.#bodies.length = 0;
83
+
84
+ let placed = 0;
85
+ if (start >= GRACE_METRES) {
86
+ for (let slot = 0; slot < MAX_OBSTACLES; slot += 1) {
87
+ // Never all three lanes: a run that cannot be survived is a bug, not a difficulty curve.
88
+ const blocked = Math.floor(ctx.random() * 3);
89
+ if (ctx.random() < 0.35) continue;
90
+ const laneX = LANE_X[blocked] ?? 0;
91
+ const localZ = (slot + 0.5) * (CHUNK_LENGTH / MAX_OBSTACLES) - CHUNK_LENGTH / 2;
92
+ this.#obstacles?.setMatrixAt(
93
+ placed,
94
+ this.#matrix.identity().setPosition(laneX, OBSTACLE_SIZE.height / 2, localZ),
95
+ );
96
+ placed += 1;
97
+ this.#bodies.push(
98
+ new RigidBody3D({
99
+ collisionLayer: OBSTACLE_LAYER,
100
+ collisionMask: 0,
101
+ entity: `obstacle.${this.group.name}.${slot}`,
102
+ physics: ctx.physics,
103
+ position: {
104
+ x: laneX,
105
+ y: OBSTACLE_SIZE.height / 2,
106
+ z: this.group.position.z + localZ,
107
+ },
108
+ shape: CollisionShape3D.box(
109
+ OBSTACLE_SIZE.width,
110
+ OBSTACLE_SIZE.height,
111
+ OBSTACLE_SIZE.depth,
112
+ ),
113
+ type: "fixed",
114
+ }),
115
+ );
116
+ }
117
+ }
118
+ for (let slot = placed; slot < MAX_OBSTACLES; slot += 1) {
119
+ this.#obstacles?.setMatrixAt(slot, PARKED);
120
+ }
121
+ if (this.#obstacles !== undefined) this.#obstacles.instanceMatrix.needsUpdate = true;
122
+ }
123
+
124
+ dispose(): void {
125
+ for (const body of this.#bodies) body.dispose();
126
+ this.#bodies.length = 0;
127
+ this.group.removeFromParent();
128
+ }
129
+ }
130
+
131
+ /**
132
+ * The track, as a ring of chunks.
133
+ *
134
+ * `advance` moves the chunk that has fallen behind the runner to the front of the queue and
135
+ * rewrites it. The obstacle geometry and material are created here, once, and shared by every
136
+ * chunk: they are the same box and the same surface every time, and building them per chunk was
137
+ * both an allocation and — with no `dispose` — a leak.
138
+ */
139
+ export class Track {
140
+ readonly chunks: Chunk[] = [];
141
+ readonly #geometry: BufferGeometry;
142
+ readonly #material: MeshStandardMaterial;
143
+ #built = 0;
144
+
145
+ constructor(ctx: IChunkContext) {
146
+ const shape = obstacleShape();
147
+ this.#geometry = shape.geometry;
148
+ this.#material = shape.material;
149
+ for (let index = 0; index < RESIDENT_CHUNKS; index += 1) {
150
+ const chunk = new Chunk(ctx, index, this.#geometry, this.#material);
151
+ chunk.build(ctx, index * CHUNK_LENGTH);
152
+ this.chunks.push(chunk);
153
+ this.#built += 1;
154
+ }
155
+ }
156
+
157
+ get built(): number {
158
+ return this.#built;
159
+ }
160
+
161
+ advance(ctx: IChunkContext, distance: number): void {
162
+ for (const chunk of this.chunks) {
163
+ if (chunk.start + CHUNK_LENGTH > distance - CHUNK_LENGTH) continue;
164
+ const furthest = Math.max(...this.chunks.map((other) => other.start));
165
+ chunk.build(ctx, furthest + CHUNK_LENGTH);
166
+ this.#built += 1;
167
+ }
168
+ }
169
+
170
+ dispose(): void {
171
+ for (const chunk of this.chunks) chunk.dispose();
172
+ this.chunks.length = 0;
173
+ this.#geometry.dispose();
174
+ this.#material.dispose();
175
+ }
176
+ }
@@ -0,0 +1,22 @@
1
+ import type { IGame } from "@threenative/core";
2
+ import { DebugOverlay, GameCanvas } from "@threenative/ui";
3
+ import type { RunnerPhysics } from "../physics.js";
4
+ import type { GameState } from "../state.js";
5
+ import { GameUi } from "./GameUi.js";
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
+ */
14
+ export function App({ game }: { game: IGame<GameState, RunnerPhysics> }) {
15
+ return (
16
+ <main className="relative h-screen w-screen overflow-hidden bg-ink">
17
+ <GameCanvas className="absolute inset-0" game={game} />
18
+ <GameUi />
19
+ <DebugOverlay />
20
+ </main>
21
+ );
22
+ }
@@ -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
+ }
@@ -0,0 +1,55 @@
1
+ import { useUiState } from "@threenative/ui";
2
+ import type { GameState } from "../state.js";
3
+
4
+ export function Hud() {
5
+ const state = useUiState<GameState>();
6
+ // Nothing to draw until the game publishes its first snapshot, a few milliseconds in.
7
+ // Rendering zeroes instead would put wrong numbers on screen and then correct them.
8
+ if (state === undefined) return null;
9
+ const crashed = state.status === "CRASHED";
10
+ return (
11
+ <div className="pointer-events-none absolute inset-0 p-6 text-[11px] uppercase tracking-[0.16em] text-text">
12
+ <div className="flex items-start justify-between">
13
+ <div>
14
+ <div className="text-[10px] text-muted">distance</div>
15
+ <div className="mt-1 text-[34px] leading-none text-white" id="distance">
16
+ {Math.floor(state.distance)}
17
+ <span className="ml-1 text-[14px] text-muted">m</span>
18
+ </div>
19
+ </div>
20
+ <div className="text-right">
21
+ <div className="text-[10px] text-muted">near misses</div>
22
+ <div className="mt-1 text-[22px] text-white" id="near-misses">
23
+ {state.nearMisses}
24
+ </div>
25
+ </div>
26
+ </div>
27
+ <div className="absolute bottom-6 left-6 flex items-end gap-8">
28
+ <div>
29
+ <div className="text-[10px] text-muted">speed</div>
30
+ <div className="mt-1 text-[18px] leading-none text-white" id="speed">
31
+ {state.speed.toFixed(1)} m/s
32
+ </div>
33
+ </div>
34
+ <div>
35
+ <div className="text-[10px] text-muted">chunks built</div>
36
+ <div className="mt-1 text-[18px] leading-none text-white" id="chunks">
37
+ {state.chunks}
38
+ </div>
39
+ </div>
40
+ <div className="text-[10px] leading-relaxed text-muted">
41
+ <div>a / d change lane · space jump</div>
42
+ <div>the track never ends</div>
43
+ </div>
44
+ </div>
45
+ {crashed && (
46
+ <div className="absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 border border-danger/70 bg-danger/10 px-8 py-5 text-center">
47
+ <div className="text-[28px] tracking-[0.28em] text-danger">CRASHED</div>
48
+ <div className="mt-2 text-[10px] text-muted">
49
+ {Math.floor(state.distance)} m · press R to run again
50
+ </div>
51
+ </div>
52
+ )}
53
+ </div>
54
+ );
55
+ }
@@ -0,0 +1,7 @@
1
+ export function Menu() {
2
+ return (
3
+ <div className="pointer-events-none absolute bottom-6 right-6 border border-line bg-panel/80 px-4 py-3 text-[10px] uppercase tracking-[0.12em] text-muted">
4
+ lane buttons or thumbstick · flick up to jump · R restart
5
+ </div>
6
+ );
7
+ }
@@ -0,0 +1,14 @@
1
+ import { createRoot } from "react-dom/client";
2
+ import { GameUi } from "./GameUi.js";
3
+ import "../style.css";
4
+
5
+ /**
6
+ * The UI entry the native web view loads.
7
+ *
8
+ * It mounts the UI and nothing else — no scene, no simulation, no renderer. The game runs beside
9
+ * it in the native runtime and reaches it only through published state and intents, which is why
10
+ * this file imports no game code at all.
11
+ */
12
+ const root = document.getElementById("tn-ui");
13
+ if (root === null) throw new Error("Missing #tn-ui element.");
14
+ createRoot(root).render(<GameUi />);
@@ -0,0 +1 @@
1
+ export default {};
@@ -0,0 +1,49 @@
1
+ import type { IThreeNativeConfig } from "@threenative/core";
2
+
3
+ const config: IThreeNativeConfig = {
4
+ app: {
5
+ id: "com.threenative.__PROJECT_ID__",
6
+ name: "__PROJECT_NAME__",
7
+ version: "1.0.0",
8
+ build: 1,
9
+ icon: "public/icon.png",
10
+ icons: { web: { favicon: "public/favicon.svg" } },
11
+ },
12
+ display: {
13
+ orientation: "landscape",
14
+ fullscreen: true,
15
+ keepScreenOn: true,
16
+ maxFps: 60,
17
+ },
18
+ window: {
19
+ title: "__PROJECT_NAME__",
20
+ width: 1280,
21
+ height: 720,
22
+ maximized: false,
23
+ resizable: true,
24
+ },
25
+ bootSplash: {
26
+ backgroundColor: "#07131d",
27
+ },
28
+ nativeEntry: "src/game.ts",
29
+ renderer: {
30
+ preferWebGPU: true, // Use WebGPU when the host exposes it.
31
+ // The engine holds the `display.maxFps` budget by scaling the 3D drawing buffer, and reports
32
+ // the scale it settled on in every `TN_FRAME_BUDGET` window. Replace with a number in (0, 1]
33
+ // to pin it — the loop stops and the reporting does not. CSS, UI and camera framing never move.
34
+ resolutionScale: "auto",
35
+ // Multisampling resolves triangle edges. A cutout silhouette — foliage, a fence, hair — is
36
+ // carved inside the triangle by an alpha test, so it resolves through the coverage mask or
37
+ // not at all, which is what this spends the samples above on. It costs no target and no
38
+ // extra pass; set it false for a deliberately hard-edged look. `TN_ALPHA_ANTIALIASING`
39
+ // reports what it did, and says so when a single-sampled surface leaves it nothing to do.
40
+ alphaAntialiasing: true,
41
+ },
42
+ // One UI on every target: src/ui/ renders through the platform's own browser-class renderer,
43
+ // so the same React, Tailwind, CSS and SVG run on web, desktop, Android and iOS alike.
44
+ // Switch to "native" for a UI drawn as part of the rendered frame, with no web view and no
45
+ // extra process — and own the appearance difference that comes with it.
46
+ ui: { renderer: "web" },
47
+ };
48
+
49
+ export default config;
@@ -0,0 +1,17 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "lib": ["ES2022", "DOM", "DOM.Iterable"],
5
+ "module": "ESNext",
6
+ "moduleResolution": "bundler",
7
+ "jsx": "react-jsx",
8
+ "types": ["vite/client"],
9
+ "strict": true,
10
+ "noUncheckedIndexedAccess": true,
11
+ "noEmit": true,
12
+ "skipLibCheck": true,
13
+ "verbatimModuleSyntax": true,
14
+ "isolatedModules": true
15
+ },
16
+ "include": ["src/**/*.ts", "src/**/*.tsx", "*.ts"]
17
+ }