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,9 +1,22 @@
1
- import { type ICtx, PathFollow3D } from "@threenative/core";
1
+ import { type ICtx, InstancedBatch, PathFollow3D } from "@threenative/core";
2
2
  import { Area3D, CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
- import { BoxGeometry, Color, Group, Mesh, MeshStandardMaterial, Raycaster, Vector3 } from "three";
3
+ import {
4
+ BoxGeometry,
5
+ CapsuleGeometry,
6
+ Group,
7
+ Mesh,
8
+ MeshStandardMaterial,
9
+ Raycaster,
10
+ SphereGeometry,
11
+ Vector3,
12
+ } from "three";
13
+
14
+ /** Reused by the grandstand crowd placement; a fresh axis per seat is pure garbage. */
15
+ const UP = new Vector3(0, 1, 0);
4
16
  import { Boost } from "../kart/boost.js";
5
17
  import { createMaterials } from "../render/materials.js";
6
18
  import { palette } from "../render/palette.js";
19
+ import { grandstand, hoardingGeometry, treeGeometry, tyreStackGeometry } from "../render/shapes.js";
7
20
  import type { GameState } from "../state.js";
8
21
  import { Checkline } from "./Checkline.js";
9
22
  import type { IRayHit, IntersectRay } from "./TrackSector.js";
@@ -54,24 +67,48 @@ function roadSegment(
54
67
  return road;
55
68
  }
56
69
 
70
+ /**
71
+ * One kerb stone, recorded into a shared batch rather than drawn on its own.
72
+ *
73
+ * Every kerb is the same box at a different length and angle, so a unit box scaled per placement
74
+ * draws exactly what a per-segment `BoxGeometry` drew — as one draw for the whole track instead of
75
+ * two per sector. Change `materials.curb` and every kerb changes with it; the batch picks nothing.
76
+ */
57
77
  function addCurb(
58
- ctx: TrackCtx,
78
+ curbs: InstancedBatch,
79
+ alternate: InstancedBatch,
59
80
  a: Vector3,
60
81
  b: Vector3,
61
82
  side: number,
62
- materials: ReturnType<typeof createMaterials>,
63
83
  ): void {
64
84
  const direction = b.clone().sub(a).setY(0).normalize();
65
85
  const normal = new Vector3(-direction.z, 0, direction.x).multiplyScalar(
66
86
  side * (TRACK_WIDTH / 2 + 0.28),
67
87
  );
68
- const midpoint = a.clone().lerp(b, 0.5).add(normal);
69
- const length = a.distanceTo(b);
70
- const curb = new Mesh(new BoxGeometry(length, 0.18, 0.42), materials.curb);
71
- curb.position.set(midpoint.x, 0.08, midpoint.z);
72
- curb.rotation.y = Math.atan2(direction.z, direction.x);
73
- curb.castShadow = true;
74
- ctx.add(curb);
88
+ // Both ends are pulled in by half the track width plus the kerb's own offset. Run to the raw
89
+ // route point and the kerbs of two sectors cross at right angles inside the corner; the overlap
90
+ // shows as a bitten-out notch in the middle of the stripe pattern. The square corner blocks that
91
+ // `buildTrack` places take over from here.
92
+ const inset = TRACK_WIDTH / 2 + 0.28;
93
+ const from = a.clone().addScaledVector(direction, inset);
94
+ const length = Math.max(a.distanceTo(b) - inset * 2, 0.6);
95
+ // Kerbing is **striped**, and the stripes are what make a corner readable at speed. One long
96
+ // cream box per sector is what shipped, and the first frame showed a plain white line: correct
97
+ // geometry, no information. Two batches alternating along the sector cost one extra draw for the
98
+ // whole circuit.
99
+ const blocks = Math.max(2, Math.round(length / 1.3));
100
+ const step = length / blocks;
101
+ for (let index = 0; index < blocks; index += 1) {
102
+ const centre = from
103
+ .clone()
104
+ .addScaledVector(direction, step * (index + 0.5))
105
+ .add(normal);
106
+ (index % 2 === 0 ? curbs : alternate).place({
107
+ position: [centre.x, 0.08, centre.z],
108
+ rotation: [0, Math.atan2(direction.z, direction.x), 0],
109
+ scale: [step * 0.98, 0.18, 0.5],
110
+ });
111
+ }
75
112
  }
76
113
 
77
114
  function gate(
@@ -87,15 +124,21 @@ function gate(
87
124
  metalness: 0.2,
88
125
  roughness: 0.45,
89
126
  });
90
- const post = new Mesh(new BoxGeometry(0.24, 2.5, 0.24), material);
127
+ const post = new Mesh(new BoxGeometry(0.28, 3.4, 0.28), material);
91
128
  const otherPost = post.clone();
92
- const top = new Mesh(new BoxGeometry(width, 0.24, 0.24), material);
93
- post.position.set(-width / 2, 1.25, 0);
94
- otherPost.position.set(width / 2, 1.25, 0);
95
- top.position.y = 2.45;
96
- group.add(post, otherPost, top);
129
+ const top = new Mesh(new BoxGeometry(width + 1.2, 0.34, 0.34), material);
130
+ const banner = new Mesh(new BoxGeometry(width + 0.6, 0.7, 0.08), material);
131
+ post.position.set(-(width / 2 + 0.5), 1.7, 0);
132
+ otherPost.position.set(width / 2 + 0.5, 1.7, 0);
133
+ top.position.y = 3.55;
134
+ banner.position.y = 3.0;
135
+ for (const mesh of [post, otherPost, top, banner]) mesh.castShadow = true;
136
+ group.add(post, otherPost, top, banner);
97
137
  group.position.set(at.x, 0, at.z);
98
- if (Math.abs(forward.z) > Math.abs(forward.x)) group.rotation.y = Math.PI / 2;
138
+ // A gate spans the road, so it is rotated when the road runs along **X**, not along Z. The
139
+ // condition used to be the other way round, which laid both gantries down the racing line: from
140
+ // the chase camera the finish gantry read as a stray yellow post and a bar going nowhere.
141
+ if (Math.abs(forward.x) > Math.abs(forward.z)) group.rotation.y = Math.PI / 2;
99
142
  ctx.add(group);
100
143
  const area = new Area3D({
101
144
  collisionMask: 1,
@@ -116,9 +159,23 @@ function boostPad(
116
159
  at: Vector3,
117
160
  materials: ReturnType<typeof createMaterials>,
118
161
  ): { area: Area3D; boost: Boost } {
119
- const pad = new Mesh(new BoxGeometry(3.2, 0.08, TRACK_WIDTH - 0.6), materials.boost);
162
+ // Chevrons, not a slab. A flat yellow rectangle across the road reads as a painting mistake;
163
+ // arrows read as "drive here and go faster" without a word of UI.
164
+ const pad = new Group();
165
+ const base = new Mesh(new BoxGeometry(3.2, 0.04, TRACK_WIDTH - 0.6), materials.carbon);
166
+ base.position.y = 0.005;
167
+ base.receiveShadow = true;
168
+ pad.add(base);
169
+ for (let index = 0; index < 3; index += 1) {
170
+ for (const side of [-1, 1]) {
171
+ const arm = new Mesh(new BoxGeometry(1.5, 0.05, 0.42), materials.boost);
172
+ arm.position.set(-1.0 + index * 1.0, 0.03, side * 0.9);
173
+ arm.rotation.y = side * 0.62;
174
+ arm.receiveShadow = true;
175
+ pad.add(arm);
176
+ }
177
+ }
120
178
  pad.position.set(at.x, 0.12, at.z);
121
- pad.receiveShadow = true;
122
179
  ctx.add(pad);
123
180
  const boost = new Boost();
124
181
  const area = new Area3D({
@@ -200,30 +257,225 @@ export function buildTrack(ctx: TrackCtx): ITrackBuild {
200
257
  type: "fixed",
201
258
  });
202
259
 
260
+ // Every kerb is the same box at a different length and angle, so they are gathered into one
261
+ // batch and drawn once instead of twice per sector. The count is not known before the route has
262
+ // been walked, which is exactly what `InstancedBatch` is for — `new InstancedMesh` would need it
263
+ // up front.
264
+ const curbs = new InstancedBatch({
265
+ geometry: new BoxGeometry(1, 1, 1),
266
+ material: materials.curb,
267
+ });
268
+ const curbsAlt = new InstancedBatch({
269
+ geometry: new BoxGeometry(1, 1, 1),
270
+ material: materials.kerbAlt,
271
+ });
272
+
203
273
  const roadMeshes: Mesh[] = [];
204
274
  for (let index = 0; index < ROUTE_POINTS.length; index += 1) {
205
275
  const a = ROUTE_POINTS[index];
206
276
  const b = ROUTE_POINTS[(index + 1) % ROUTE_POINTS.length];
207
277
  if (a === undefined || b === undefined) continue;
208
278
  roadMeshes.push(roadSegment(ctx, a, b, materials));
209
- addCurb(ctx, a, b, 1, materials);
210
- addCurb(ctx, a, b, -1, materials);
279
+ addCurb(curbs, curbsAlt, a, b, 1);
280
+ addCurb(curbs, curbsAlt, a, b, -1);
281
+ }
282
+ // A square of tarmac at every route point. Two straight sectors meeting at a right angle leave
283
+ // the corner itself unpaved, and the frame showed grass biting into the racing line exactly
284
+ // where the driver is turning.
285
+ for (const point of ROUTE_POINTS) {
286
+ const patch = new Mesh(new BoxGeometry(TRACK_WIDTH, 0.28, TRACK_WIDTH), materials.road);
287
+ patch.position.set(point.x, -0.14, point.z);
288
+ patch.receiveShadow = true;
289
+ ctx.add(patch);
290
+ new RigidBody3D({
291
+ collisionLayer: 2,
292
+ collisionMask: 1,
293
+ object: patch,
294
+ physics: ctx.physics,
295
+ shape: CollisionShape3D.box(TRACK_WIDTH, 0.28, TRACK_WIDTH),
296
+ type: "fixed",
297
+ });
298
+ roadMeshes.push(patch);
299
+ }
300
+
301
+ // The outside corner of the kerbing, filling the right angle the two inset runs leave open.
302
+ for (const point of ROUTE_POINTS) {
303
+ for (const [dx, dz] of [
304
+ [1, 1],
305
+ [1, -1],
306
+ [-1, 1],
307
+ [-1, -1],
308
+ ] as const) {
309
+ curbs.place({
310
+ position: [
311
+ point.x + dx * (TRACK_WIDTH / 2 + 0.28),
312
+ 0.08,
313
+ point.z + dz * (TRACK_WIDTH / 2 + 0.28),
314
+ ],
315
+ rotation: [0, 0, 0],
316
+ scale: [0.5, 0.18, 0.5],
317
+ });
318
+ }
211
319
  }
212
320
 
321
+ const curbMesh = curbs.build({ castShadow: true, name: "track-curbs" });
322
+ if (curbMesh !== undefined) ctx.add(curbMesh);
323
+ const curbAltMesh = curbsAlt.build({ castShadow: true, name: "track-curbs-alt" });
324
+ if (curbAltMesh !== undefined) ctx.add(curbAltMesh);
325
+
213
326
  const gates = [
214
327
  gate(ctx, "mid", new Vector3(18, 0, 0), new Vector3(0, 0, 1), TRACK_WIDTH),
215
328
  gate(ctx, "finish", new Vector3(10, 0, -18), new Vector3(1, 0, 0), TRACK_WIDTH),
216
329
  ];
217
330
  const pad = boostPad(ctx, new Vector3(14, 0, -18), materials);
218
- for (const [index, point] of ROUTE_POINTS.entries()) {
219
- const marker = new Mesh(
220
- new BoxGeometry(0.2, 1.2, 0.2),
221
- new MeshStandardMaterial({
222
- color: new Color(index % 2 === 0 ? palette.accent : palette.skyLow),
223
- }),
224
- );
225
- marker.position.set(point.x, 0.6, point.z);
226
- ctx.add(marker);
227
- }
331
+ dressCircuit(ctx, materials);
228
332
  return { boost: pad.boost, boostArea: pad.area, gates, roadMeshes, route: RACING_LINE };
229
333
  }
334
+
335
+ /**
336
+ * Everything beside the road.
337
+ *
338
+ * This used to be five thin coloured posts at the route corners, and the first frame showed why
339
+ * that is not enough: past the kerbs the world was one unbroken green plane to the horizon, so a
340
+ * corner arrived with nothing to judge it against and the circuit had no sense of place. Stands,
341
+ * trees, tyre walls and hoardings cost one function and give the driver landmarks.
342
+ *
343
+ * Delete a line here and that piece of furniture is gone; nothing else depends on it.
344
+ */
345
+ function dressCircuit(ctx: TrackCtx, materials: ReturnType<typeof createMaterials>): void {
346
+ // Grass run-off inside the kerbs, a shade drier than the outfield, so the two read as two
347
+ // surfaces rather than one flat colour.
348
+ const apron = new Mesh(new BoxGeometry(52, 0.16, 52), materials.runoff);
349
+ apron.position.y = -0.5;
350
+ apron.receiveShadow = true;
351
+ ctx.add(apron);
352
+
353
+ // Grandstands, set back past the hoardings. Placed nearer the road they climbed into the chase
354
+ // camera and hid the corner the driver was aiming at.
355
+ const crowd = new InstancedBatch({
356
+ geometry: new CapsuleGeometry(0.16, 0.24, 1, 4),
357
+ material: materials.crowd,
358
+ });
359
+ for (const [x, z, turn, seats] of [
360
+ [2, -34, 0, materials.kerbAlt],
361
+ [-2, 34, Math.PI, materials.hoardingBoard],
362
+ ] as const) {
363
+ const stand = grandstand(materials.structure, seats);
364
+ stand.group.position.set(x, 0, z);
365
+ stand.group.rotation.y = turn;
366
+ ctx.add(stand.group);
367
+ for (const [seatX, seatY, seatZ] of stand.crowd) {
368
+ const turned = new Vector3(seatX, seatY, seatZ).applyAxisAngle(UP, turn);
369
+ crowd.place({ position: [x + turned.x, turned.y, z + turned.z], scale: [1, 1, 1] });
370
+ }
371
+ }
372
+ const crowdMesh = crowd.build({ castShadow: true, name: "grandstand-crowd" });
373
+ if (crowdMesh !== undefined) ctx.add(crowdMesh);
374
+
375
+ // Tyre walls on the outside of all four corners, five stacks to an arc.
376
+ const tyres = new InstancedBatch({
377
+ geometry: tyreStackGeometry(3),
378
+ material: materials.tire,
379
+ });
380
+ for (const [cornerX, cornerZ] of [
381
+ [24.5, -24.5],
382
+ [24.5, 24.5],
383
+ [-24.5, 24.5],
384
+ [-24.5, -24.5],
385
+ ] as const) {
386
+ const radius = Math.hypot(cornerX, cornerZ);
387
+ for (let index = 0; index < 5; index += 1) {
388
+ const angle = Math.atan2(cornerZ, cornerX) + (index - 2) * 0.09;
389
+ tyres.place({
390
+ position: [Math.cos(angle) * radius, 0, Math.sin(angle) * radius],
391
+ rotation: [0, angle, 0],
392
+ scale: [1, 1, 1],
393
+ });
394
+ }
395
+ }
396
+ const tyreMesh = tyres.build({ castShadow: true, name: "tyre-walls" });
397
+ if (tyreMesh !== undefined) ctx.add(tyreMesh);
398
+
399
+ // Sponsor hoardings around all four straights, turned to **face** the road. Left unrotated they
400
+ // presented their broad faces down the racing line, which from the chase camera looked like
401
+ // blue plates hanging in the air.
402
+ const board = hoardingGeometry(5);
403
+ const frames = new InstancedBatch({ geometry: board.frame, material: materials.structure });
404
+ const boardsA = new InstancedBatch({ geometry: board.board, material: materials.hoardingBoard });
405
+ const boardsB = new InstancedBatch({ geometry: board.board, material: materials.kerbAlt });
406
+ const OUTSIDE = 22.8;
407
+ for (let index = 0; index < 7; index += 1) {
408
+ const along = -18 + index * 6;
409
+ for (const side of [-1, 1] as const) {
410
+ for (const [position, turn, batch] of [
411
+ [
412
+ [along, 0, side * OUTSIDE] as const,
413
+ side < 0 ? Math.PI / 2 : -Math.PI / 2,
414
+ side < 0 ? boardsA : boardsB,
415
+ ],
416
+ [[side * OUTSIDE, 0, along] as const, side < 0 ? Math.PI : 0, side < 0 ? boardsB : boardsA],
417
+ ] as const) {
418
+ const placement = {
419
+ position: [position[0], position[1], position[2]] as [number, number, number],
420
+ rotation: [0, turn, 0] as [number, number, number],
421
+ scale: [1, 1, 1] as [number, number, number],
422
+ };
423
+ frames.place(placement);
424
+ batch.place(placement);
425
+ }
426
+ }
427
+ }
428
+ for (const [batch, name] of [
429
+ [frames, "hoarding-frames"],
430
+ [boardsA, "hoarding-boards-a"],
431
+ [boardsB, "hoarding-boards-b"],
432
+ ] as const) {
433
+ const mesh = batch.build({ castShadow: true, name });
434
+ if (mesh !== undefined) ctx.add(mesh);
435
+ }
436
+
437
+ // A treeline outside the circuit. Deterministic placement — a seeded jitter, not Math.random —
438
+ // so two captures of the same build frame the same world.
439
+ const pine = treeGeometry();
440
+ const trunks = new InstancedBatch({ geometry: pine.trunk, material: materials.trunk });
441
+ const canopies = new InstancedBatch({ geometry: pine.canopy, material: materials.canopy });
442
+ let seed = 6132;
443
+ const jitter = (): number => {
444
+ seed = (seed * 1103515245 + 12345) & 0x7fffffff;
445
+ return seed / 0x7fffffff;
446
+ };
447
+ for (let index = 0; index < 44; index += 1) {
448
+ const angle = (index / 44) * Math.PI * 2 + jitter() * 0.1;
449
+ const distance = 42 + jitter() * 22;
450
+ const scale = 1.4 + jitter() * 1.5;
451
+ const placement = {
452
+ position: [Math.cos(angle) * distance, 0, Math.sin(angle) * distance] as [
453
+ number,
454
+ number,
455
+ number,
456
+ ],
457
+ rotation: [0, jitter() * Math.PI, 0] as [number, number, number],
458
+ scale: [scale, scale, scale] as [number, number, number],
459
+ };
460
+ trunks.place(placement);
461
+ canopies.place(placement);
462
+ }
463
+ for (const [batch, name] of [
464
+ [trunks, "treeline-trunks"],
465
+ [canopies, "treeline-canopies"],
466
+ ] as const) {
467
+ const mesh = batch.build({ castShadow: true, name });
468
+ if (mesh !== undefined) ctx.add(mesh);
469
+ }
470
+
471
+ // Distant hills: three low domes past the treeline to give the horizon a shape.
472
+ for (const [x, z, radius] of [
473
+ [-70, -110, 46],
474
+ [90, -120, 58],
475
+ [130, 60, 40],
476
+ ] as const) {
477
+ const hill = new Mesh(new SphereGeometry(radius, 12, 6), materials.distant);
478
+ hill.position.set(x, -radius * 0.72, z);
479
+ ctx.add(hill);
480
+ }
481
+ }
@@ -1,4 +1,4 @@
1
- import type { PathFollow3D } from "@threenative/core";
1
+ import type { IPathFollow3DProjection, PathFollow3D } from "@threenative/core";
2
2
  import { Vector3 } from "three";
3
3
  import { type IRescueTarget, rescueToLastValid } from "./rescue.js";
4
4
 
@@ -33,6 +33,15 @@ export class TrackSector {
33
33
  readonly #intersectRay: IntersectRay;
34
34
  readonly #rescueDelay: number;
35
35
  readonly #rayHeight: number;
36
+ readonly #origin = new Vector3();
37
+ readonly #direction = new Vector3(0, -1, 0);
38
+ readonly #projection: IPathFollow3DProjection = {
39
+ distanceFromStart: 0,
40
+ lateralDistance: 0,
41
+ point: new Vector3(),
42
+ segment: 0,
43
+ tangent: new Vector3(0, 0, 1),
44
+ };
36
45
 
37
46
  constructor(options: ITrackSectorOptions) {
38
47
  this.#route = options.route;
@@ -45,13 +54,14 @@ export class TrackSector {
45
54
  update(position: Vector3, heading: Vector3, dt: number): boolean {
46
55
  if (!Number.isFinite(dt) || dt < 0)
47
56
  throw new Error("TrackSector.update requires a finite non-negative dt.");
48
- const origin = position.clone().add(new Vector3(0, this.#rayHeight, 0));
49
- const hit = this.#intersectRay(origin, new Vector3(0, -1, 0), this.#rayHeight + 2);
57
+ const origin = this.#origin.copy(position);
58
+ origin.y += this.#rayHeight;
59
+ const hit = this.#intersectRay(origin, this.#direction, this.#rayHeight + 2);
50
60
  const onRoad = hit !== undefined && hit.distance >= 0 && hit.distance <= this.#rayHeight + 2;
51
61
  if (onRoad) {
52
62
  this.lastOnRoadPosition.copy(position);
53
63
  this.lastOnRoadHeading.copy(heading).setY(0).normalize();
54
- this.currentSector = this.#route.project(position).segment;
64
+ this.currentSector = this.#route.project(position, this.#projection).segment;
55
65
  this.#hasOnRoadSample = true;
56
66
  this.#offRoadTime = 0;
57
67
  return true;
@@ -2,15 +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
16
  <main className="relative h-screen w-screen overflow-hidden bg-ink">
11
17
  <GameCanvas className="absolute inset-0" game={game} />
12
- <Hud game={game} />
13
- <Menu />
18
+ <GameUi />
14
19
  <DebugOverlay />
15
20
  </main>
16
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,14 +1,15 @@
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
  function clock(seconds: number): string {
7
5
  return `${String(Math.floor(seconds / 60)).padStart(2, "0")}:${String(Math.floor(seconds % 60)).padStart(2, "0")}.${String(Math.floor((seconds % 1) * 10))}`;
8
6
  }
9
7
 
10
- export function Hud({ game }: { game: IGame<GameState, IPhysicsContext> }) {
11
- const state = useGameState(game, (value) => value);
8
+ export function Hud() {
9
+ const state = useUiState<GameState>();
10
+ // Nothing to draw until the game publishes its first snapshot, a few milliseconds in.
11
+ // Rendering zeroes instead would put wrong numbers on screen and then correct them.
12
+ if (state === undefined) return null;
12
13
  const statusClass =
13
14
  state.raceStatus === "WON"
14
15
  ? "text-win"
@@ -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 />);
@@ -1,29 +1,49 @@
1
1
  import type { IThreeNativeConfig } from "@threenative/core";
2
2
 
3
- export default {
3
+ const config: IThreeNativeConfig = {
4
4
  app: {
5
5
  id: "com.threenative.__PROJECT_ID__",
6
6
  name: "__PROJECT_NAME__",
7
7
  version: "1.0.0",
8
8
  build: 1,
9
+ icon: "public/icon.png",
10
+ icons: { web: { favicon: "public/favicon.svg" } },
9
11
  },
10
12
  display: {
11
13
  orientation: "landscape",
12
14
  fullscreen: true,
13
15
  keepScreenOn: true,
16
+ maxFps: 60,
14
17
  },
15
18
  window: {
16
19
  title: "__PROJECT_NAME__",
17
20
  width: 1280,
18
21
  height: 720,
22
+ maximized: false,
19
23
  resizable: true,
20
24
  },
21
- loading: {
22
- backdropColor: "#07111d",
23
- trackColor: "#16324a",
24
- progressColor: "#ffcf4a",
25
- showProgressBar: true,
25
+ bootSplash: {
26
+ backgroundColor: "#07111d",
26
27
  },
27
28
  nativeEntry: "src/game.ts",
28
- renderer: { preferWebGPU: true },
29
- } satisfies IThreeNativeConfig;
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;
@@ -1,5 +1,38 @@
1
1
  import tailwindcss from "@tailwindcss/vite";
2
+ import { watchAssets } from "@threenative/assets";
2
3
  import react from "@vitejs/plugin-react";
4
+ import { createEngineFreshnessPlugin, createWebBrandPlugin } from "create-threenative";
3
5
  import { defineConfig } from "vite";
6
+ import type { Plugin } from "vite";
7
+ import config from "./threenative.config.js";
4
8
 
5
- export default defineConfig({ plugins: [react(), tailwindcss()] });
9
+ /**
10
+ * Recompiles assets/ into public/ while the dev server runs, so editing a texture does not
11
+ * need a rebuild. Serve-only by declaration: builds compile through `threenative build`.
12
+ */
13
+ function assetsWatchPlugin(): Plugin {
14
+ return {
15
+ name: "threenative-assets-watch",
16
+ apply: "serve",
17
+ configureServer(server) {
18
+ const handle = watchAssets({ config: config.assets, cwd: server.config.root });
19
+ server.httpServer?.once("close", () => handle.close());
20
+ },
21
+ };
22
+ }
23
+
24
+ export default defineConfig({
25
+ plugins: [
26
+ createEngineFreshnessPlugin(),
27
+ createWebBrandPlugin(),
28
+ react(),
29
+ tailwindcss(),
30
+ assetsWatchPlugin(),
31
+ ],
32
+ server: {
33
+ watch: {
34
+ ignored: ["**/artifacts/**", "**/screenshots/**", "**/playtests/**"],
35
+ usePolling: true,
36
+ },
37
+ },
38
+ });
@@ -0,0 +1,19 @@
1
+ [mcp_servers.threenative-assets]
2
+ command = "node"
3
+ args = ["./node_modules/@threenative/core/mcp/assets.mjs"]
4
+
5
+ [mcp_servers.threenative-assets.env]
6
+ ASSET_DOWNLOAD_DIR = "./public/assets"
7
+ AUDIO_DOWNLOAD_DIR = "./public/audio"
8
+
9
+ [mcp_servers.threenative-sculpt]
10
+ command = "node"
11
+ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
12
+
13
+ [mcp_servers.threenative-engine]
14
+ command = "node"
15
+ args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
16
+
17
+ [mcp_servers.threenative-blender]
18
+ command = "node"
19
+ args = ["./node_modules/@threenative/core/mcp/blender.mjs"]
@@ -0,0 +1,32 @@
1
+ {
2
+ "mcpServers": {
3
+ "threenative-assets": {
4
+ "command": "node",
5
+ "args": [
6
+ "./node_modules/@threenative/core/mcp/assets.mjs"
7
+ ],
8
+ "env": {
9
+ "ASSET_DOWNLOAD_DIR": "./public/assets",
10
+ "AUDIO_DOWNLOAD_DIR": "./public/audio"
11
+ }
12
+ },
13
+ "threenative-sculpt": {
14
+ "command": "node",
15
+ "args": [
16
+ "./node_modules/@threenative/core/mcp/sculpt.mjs"
17
+ ]
18
+ },
19
+ "threenative-engine": {
20
+ "command": "node",
21
+ "args": [
22
+ "./node_modules/@threenative/core/mcp/engine.mjs"
23
+ ]
24
+ },
25
+ "threenative-blender": {
26
+ "command": "node",
27
+ "args": [
28
+ "./node_modules/@threenative/core/mcp/blender.mjs"
29
+ ]
30
+ }
31
+ }
32
+ }