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
@@ -0,0 +1,135 @@
1
+ import type { ICtx } from "@threenative/core";
2
+ import { Area3D, CollisionShape3D } from "@threenative/physics";
3
+ import { type Group, MathUtils } from "three";
4
+ import { type IRunnerConventions, prepareRunnerConventions } from "../conventions.js";
5
+ import { OBSTACLE_LAYER, type RunnerPhysics } from "../physics.js";
6
+ import { runner as runnerMesh } from "../render/shapes.js";
7
+ import type { ITouchInput } from "../render/touch-controls.js";
8
+ import type { GameState } from "../state.js";
9
+ import { LANE_X } from "../track.js";
10
+
11
+ type GameCtx = ICtx<GameState, RunnerPhysics>;
12
+
13
+ const LANE_BLEND = 12;
14
+ const JUMP_SPEED = 7.2;
15
+ const GRAVITY = -19;
16
+ /** Within this many metres of an obstacle's centre and still alive: a near miss. */
17
+ const NEAR_MISS = 1.5;
18
+
19
+ /**
20
+ * The player.
21
+ *
22
+ * Not a rigid body: a runner's feel is a lane snap and a fixed jump arc, and handing either to a
23
+ * solver makes both worse. What *is* physics is the collision — the runner carries an `Area3D`
24
+ * that scans the obstacle layer, so a hit is an overlap the engine reports rather than a distance
25
+ * check this file would have to keep in sync with the obstacle geometry.
26
+ */
27
+ export class Runner {
28
+ readonly mesh: Group;
29
+ readonly tags = ["player", "runner"];
30
+ readonly hitbox: Area3D;
31
+ #conventions: IRunnerConventions;
32
+ #lane = 1;
33
+ #height = 0;
34
+ #vertical = 0;
35
+ #crashed = false;
36
+ #nearMisses = 0;
37
+
38
+ constructor(ctx: GameCtx) {
39
+ this.mesh = runnerMesh();
40
+ this.mesh.name = "player";
41
+ this.#conventions = prepareRunnerConventions(this.mesh);
42
+ ctx.add(this.mesh);
43
+ this.hitbox = new Area3D({
44
+ collisionLayer: 0,
45
+ collisionMask: OBSTACLE_LAYER,
46
+ entity: "runner-hitbox",
47
+ physics: ctx.physics,
48
+ position: { x: 0, y: 0.7, z: 0 },
49
+ shape: CollisionShape3D.box(0.7, 1.3, 0.7),
50
+ });
51
+ this.hitbox.on("bodyEntered", () => {
52
+ this.#crashed = true;
53
+ });
54
+ }
55
+
56
+ get lane(): number {
57
+ return this.#lane;
58
+ }
59
+
60
+ get crashed(): boolean {
61
+ return this.#crashed;
62
+ }
63
+
64
+ get airborne(): boolean {
65
+ return this.#height > 0.01;
66
+ }
67
+
68
+ get nearMisses(): number {
69
+ return this.#nearMisses;
70
+ }
71
+
72
+ /** Counts one near miss. The scene owns *what* counts as near; this owns the tally. */
73
+ recordNearMiss(): void {
74
+ this.#nearMisses += 1;
75
+ }
76
+
77
+ update(ctx: GameCtx, dt: number, distance: number, touch?: ITouchInput): void {
78
+ if (this.#crashed) return;
79
+ const move = ctx.input.vector("move");
80
+ // The stick is a lane *change*, not an axis: holding right must move one lane, not slide
81
+ // continuously across three. `#steering` is that edge, and it is why a held thumb behaves
82
+ // like a tapped key.
83
+ const steer = move.x + (touch?.move.x ?? 0);
84
+ if (touch?.leftPressed === true) this.#lane -= 1;
85
+ if (touch?.rightPressed === true) this.#lane += 1;
86
+ if (Math.abs(steer) > 0.6 && !this.#steering) {
87
+ this.#lane += steer > 0 ? 1 : -1;
88
+ this.#steering = true;
89
+ }
90
+ if (Math.abs(steer) <= 0.4) this.#steering = false;
91
+ this.#lane = MathUtils.clamp(this.#lane, 0, LANE_X.length - 1);
92
+
93
+ const stickJump = (touch?.move.y ?? 0) > 0.65;
94
+ if ((ctx.input.justPressed("jump") || stickJump) && !this.airborne) this.#vertical = JUMP_SPEED;
95
+ this.#height = Math.max(0, this.#height + this.#vertical * dt);
96
+ this.#vertical = this.#height > 0 ? this.#vertical + GRAVITY * dt : 0;
97
+
98
+ const targetX = LANE_X[this.#lane] ?? 0;
99
+ const blend = Math.min(1, Math.max(0, dt) * LANE_BLEND);
100
+ this.mesh.position.x += (targetX - this.mesh.position.x) * blend;
101
+ this.mesh.position.z = -distance;
102
+ this.mesh.rotation.z = (targetX - this.mesh.position.x) * 0.35;
103
+ this.#conventions.applyGrounding(this.#height, dt);
104
+ this.hitbox.setPosition({
105
+ x: this.mesh.position.x,
106
+ y: this.#height + 0.7,
107
+ z: this.mesh.position.z,
108
+ });
109
+ }
110
+
111
+ /** True when the runner is beside, rather than on top of, an obstacle at `x` on this stretch. */
112
+ isNearMiss(obstacleX: number): boolean {
113
+ const gap = Math.abs(obstacleX - this.mesh.position.x);
114
+ return gap > 0.85 && gap < NEAR_MISS;
115
+ }
116
+
117
+ debug(): Record<string, unknown> {
118
+ return {
119
+ airborne: this.airborne,
120
+ crashed: this.#crashed,
121
+ groundClearance: this.#conventions.groundSnap.clearance,
122
+ lane: this.#lane,
123
+ nearMisses: this.#nearMisses,
124
+ normaliseFactor: this.#conventions.normaliseFactor,
125
+ position: this.mesh.position.toArray(),
126
+ };
127
+ }
128
+
129
+ dispose(): void {
130
+ this.hitbox.dispose();
131
+ this.mesh.removeFromParent();
132
+ }
133
+
134
+ #steering = false;
135
+ }
@@ -0,0 +1,50 @@
1
+ import { defineGame } from "@threenative/core";
2
+ import { playtest } from "@threenative/core/playtest";
3
+ import { rapier } from "@threenative/physics";
4
+ import config from "../threenative.config.js";
5
+ import type { RunnerPhysics } from "./physics.js";
6
+ import { Boot } from "./scenes/Boot.js";
7
+ import { Run } from "./scenes/Run.js";
8
+ import type { GameState } from "./state.js";
9
+
10
+ const game = defineGame<GameState, RunnerPhysics>({
11
+ input: {
12
+ move: {
13
+ down: ["ArrowDown", "KeyS"],
14
+ left: ["ArrowLeft", "KeyA"],
15
+ right: ["ArrowRight", "KeyD"],
16
+ up: ["ArrowUp", "KeyW"],
17
+ },
18
+ jump: { keys: ["Space"] },
19
+ restart: { keys: ["KeyR"] },
20
+ },
21
+ // Gravity is zero on purpose: nothing in this game falls. The jump is an authored arc in
22
+ // `Runner`, and the only physics the runner needs is the overlap query its `Area3D` performs.
23
+ plugins: [rapier({ gravity: { x: 0, y: 0, z: 0 } }), playtest()],
24
+ display: config.display,
25
+ render: config.renderer,
26
+ scenes: { boot: Boot, run: Run },
27
+ // The track is built from `ctx.random`, so this seed is the level. Change it for a new one.
28
+ seed: 77_412,
29
+ start: "boot",
30
+ });
31
+
32
+ export default game;
33
+
34
+ /**
35
+ * What the UI can ask the game to do.
36
+ *
37
+ * Intents are one-way and named by the game: the UI sends `restart`, `pause` or `resume` and the
38
+ * game decides what each means. Nothing comes back this way — the UI reads the game's published
39
+ * state instead, which keeps one source of truth on the side that owns the simulation.
40
+ */
41
+ game.ui.onIntent((intent) => {
42
+ if (intent === "restart") void game.goto("run");
43
+ if (intent === "pause") game.pause();
44
+ if (intent === "resume") game.resume();
45
+ game.state.set({
46
+ uiReady: game.ui.connected,
47
+ ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
48
+ });
49
+ game.state.flush();
50
+ });
@@ -0,0 +1,15 @@
1
+ import { acceptHotUpdate } from "@threenative/core/hot";
2
+ import { createElement } from "react";
3
+ import { createRoot } from "react-dom/client";
4
+ import game from "./game.js";
5
+ import { App } from "./ui/App.js";
6
+ import "./style.css";
7
+
8
+ import.meta.hot?.accept();
9
+ acceptHotUpdate(game, import.meta.hot);
10
+ const root = document.getElementById("root");
11
+ if (root === null) throw new Error("Missing #root element.");
12
+ const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
13
+ const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
14
+ appRoot.__threenativeRoot = reactRoot;
15
+ reactRoot.render(createElement(App, { game }));
@@ -0,0 +1,13 @@
1
+ import type { IPhysicsContext } from "@threenative/physics";
2
+
3
+ /**
4
+ * One bit per thing that can touch another thing.
5
+ *
6
+ * The runner itself is not a body — it is a transform the game moves, carrying an `Area3D` that
7
+ * scans for obstacles. Obstacles are fixed bodies that collide with nothing and are only ever
8
+ * *detected*, which is why they cost a layer and no solver work.
9
+ */
10
+ export const TRACK_LAYER = 1;
11
+ export const OBSTACLE_LAYER = 2;
12
+
13
+ export type RunnerPhysics = IPhysicsContext;
@@ -0,0 +1,39 @@
1
+ import type { PerspectiveCamera, Vector3 } from "three";
2
+
3
+ const HEIGHT = 3;
4
+ const BACK = 6.4;
5
+ const LOOK_AHEAD = 22;
6
+ /** How high up the track the rig aims. Lower means more road and less sky in the frame. */
7
+ const LOOK_HEIGHT = -0.2;
8
+
9
+ export function setupCamera(camera: PerspectiveCamera): void {
10
+ camera.fov = 62;
11
+ camera.near = 0.1;
12
+ camera.far = 220;
13
+ camera.position.set(0, HEIGHT, BACK);
14
+ camera.lookAt(0, LOOK_HEIGHT, -LOOK_AHEAD);
15
+ camera.updateProjectionMatrix();
16
+ }
17
+
18
+ /**
19
+ * A chase rig that leads the runner rather than tracking it exactly.
20
+ *
21
+ * The lateral lag is deliberate: a camera locked to the lane makes a lane change invisible,
22
+ * because the runner never moves on screen. Lagging it is what turns the change into motion.
23
+ *
24
+ * `offset` is the shake, supplied by the scene from `CameraShake.update`. It is added here and
25
+ * nowhere else, so the rig has one place that decides where the camera is.
26
+ */
27
+ export function chaseRunner(
28
+ camera: PerspectiveCamera,
29
+ target: Vector3,
30
+ dt: number,
31
+ offset: { readonly x: number; readonly y: number; readonly z: number },
32
+ ): void {
33
+ const blend = Math.min(1, Math.max(0, dt) * 6);
34
+ camera.position.x += (target.x * 0.55 - camera.position.x) * blend;
35
+ camera.position.y = HEIGHT + offset.y;
36
+ camera.position.z = target.z + BACK;
37
+ camera.position.x += offset.x;
38
+ camera.lookAt(target.x * 0.35, LOOK_HEIGHT, target.z - LOOK_AHEAD);
39
+ }
@@ -0,0 +1,131 @@
1
+ // Generated for you: ordinary Three.js TSL. `GPUParticles3D` owns the pooling, the dispatch and
2
+ // the lifetime; every appearance choice below — the count, the spawn shape, the launch, the
3
+ // colour ramp, the sprite mask — is this file's, and this file is yours.
4
+ import {
5
+ Fn,
6
+ float,
7
+ fract,
8
+ hash,
9
+ instanceIndex,
10
+ mix,
11
+ smoothstep,
12
+ time,
13
+ uv,
14
+ varying,
15
+ vec2,
16
+ vec3,
17
+ vec4,
18
+ } from "three/tsl";
19
+ import {
20
+ AdditiveBlending,
21
+ type ComputeNode,
22
+ SpriteNodeMaterial,
23
+ type StorageBufferNode,
24
+ } from "three/webgpu";
25
+ import { palette } from "./palette.js";
26
+
27
+ export interface IDustBuffers {
28
+ readonly positions: StorageBufferNode<"vec3">;
29
+ readonly velocities: StorageBufferNode<"vec3">;
30
+ }
31
+
32
+ export interface IDustOptions {
33
+ readonly amount: number;
34
+ readonly material: SpriteNodeMaterial;
35
+ readonly start: (buffers: IDustBuffers) => ComputeNode;
36
+ readonly process: (buffers: IDustBuffers) => ComputeNode;
37
+ }
38
+
39
+ const AMOUNT = 220;
40
+ const LIFETIME = 0.9;
41
+ /** Metres per second the trail drifts backwards. It is the track that moves, so this is small. */
42
+ const DRIFT = 2.6;
43
+ const SPREAD = 0.55;
44
+
45
+ function noise(salt: number) {
46
+ return hash(instanceIndex.add(salt));
47
+ }
48
+
49
+ /** Each particle owns a phase offset, so the emitter is continuous rather than a pulsing burst. */
50
+ function phase() {
51
+ return fract(time.div(LIFETIME).add(noise(19)));
52
+ }
53
+
54
+ function spawn() {
55
+ return vec3(
56
+ noise(3).sub(0.5).mul(SPREAD),
57
+ noise(7).mul(0.14),
58
+ noise(11)
59
+ .sub(0.5)
60
+ .mul(SPREAD * 0.5),
61
+ );
62
+ }
63
+
64
+ function launch() {
65
+ return vec3(
66
+ noise(23).sub(0.5).mul(1.1),
67
+ noise(29).mul(1.4).add(0.2),
68
+ noise(31)
69
+ .mul(DRIFT)
70
+ .add(DRIFT * 0.4),
71
+ );
72
+ }
73
+
74
+ /** A soft round puff: no texture, no download, and it fades at both ends of its life. */
75
+ function puff() {
76
+ return float(1).sub(smoothstep(0.06, 0.5, uv().sub(0.5).length()));
77
+ }
78
+
79
+ /**
80
+ * The dust the runner throws up.
81
+ *
82
+ * Two colours: the track's own grey at birth and the warm horizon at death, so the trail reads as
83
+ * lit by the same sky the track is. Change the numbers above and the whole feel changes; change
84
+ * `puff` and the grain does.
85
+ */
86
+ export function createDustTrail(): IDustOptions {
87
+ const material = new SpriteNodeMaterial({
88
+ blending: AdditiveBlending,
89
+ depthWrite: false,
90
+ toneMapped: false,
91
+ transparent: true,
92
+ });
93
+ const life = varying(phase());
94
+ material.scaleNode = vec2(0.42).mul(mix(0.5, 1.5, life));
95
+ const birth = new Array(3)
96
+ .fill(0)
97
+ .map((_, index) => ((palette.rail >> (16 - index * 8)) & 255) / 255);
98
+ const death = new Array(3)
99
+ .fill(0)
100
+ .map((_, index) => ((palette.skyLow >> (16 - index * 8)) & 255) / 255);
101
+ material.colorNode = vec4(
102
+ mix(
103
+ vec3(birth[0] ?? 0, birth[1] ?? 0, birth[2] ?? 0),
104
+ vec3(death[0] ?? 0, death[1] ?? 0, death[2] ?? 0),
105
+ life,
106
+ ),
107
+ puff()
108
+ .mul(float(1).sub(smoothstep(0.55, 1, life)))
109
+ .mul(0.55),
110
+ );
111
+
112
+ const start = ({ positions, velocities }: IDustBuffers): ComputeNode =>
113
+ Fn(() => {
114
+ positions.element(instanceIndex).assign(spawn());
115
+ velocities.element(instanceIndex).assign(launch());
116
+ })().compute(AMOUNT);
117
+
118
+ const process = ({ positions, velocities }: IDustBuffers): ComputeNode =>
119
+ Fn(() => {
120
+ const velocity = launch();
121
+ const elapsed = phase().mul(LIFETIME);
122
+ positions.element(instanceIndex).assign(
123
+ spawn()
124
+ .add(velocity.mul(elapsed))
125
+ .add(vec3(0, -1.6, 0).mul(elapsed.mul(elapsed))),
126
+ );
127
+ velocities.element(instanceIndex).assign(velocity);
128
+ })().compute(AMOUNT);
129
+
130
+ return { amount: AMOUNT, material, process, start };
131
+ }
@@ -0,0 +1,57 @@
1
+ import {
2
+ AmbientLight,
3
+ DirectionalLight,
4
+ HemisphereLight,
5
+ PCFSoftShadowMap,
6
+ type Scene,
7
+ } from "three";
8
+ import { palette } from "./palette.js";
9
+
10
+ type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
11
+
12
+ /**
13
+ * Key, fill, rim, ambient — named, so each one can be changed on its own.
14
+ *
15
+ * A runner is lit from ahead. The key sits low and down-track so it rakes across the obstacles
16
+ * and gives each one a long shadow reaching back toward the player: at speed that shadow arrives
17
+ * before the block does, and it is the only warning the player gets in time to use.
18
+ *
19
+ * Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
20
+ * the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
21
+ * rendering a black pass.
22
+ */
23
+ export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
24
+ renderer.shadowMap.enabled = true;
25
+ renderer.shadowMap.type = PCFSoftShadowMap;
26
+ // The sky half is the *rail* grey, not the horizon orange. Taking the horizon colour flooded
27
+ // the road with it and the track stopped being cool at all.
28
+ scene.add(new HemisphereLight(palette.rail, palette.track, 1.2));
29
+
30
+ const key = new DirectionalLight(0xffcf9e, 3.4);
31
+ key.position.set(3, 9, -22);
32
+ key.castShadow = true;
33
+ key.shadow.mapSize.set(1024, 1024);
34
+ key.shadow.camera.near = 0.5;
35
+ key.shadow.camera.far = 90;
36
+ key.shadow.camera.left = -14;
37
+ key.shadow.camera.right = 14;
38
+ key.shadow.camera.top = 14;
39
+ key.shadow.camera.bottom = -14;
40
+ key.shadow.normalBias = 0.03;
41
+ scene.add(key);
42
+
43
+ // A fill from behind the camera, and it is the light the first two captures were missing. With
44
+ // only a key from down-track, everything the player looks at is backlit: the runner came back a
45
+ // dark silhouette against the obstacle it was about to hit, which is the one comparison the
46
+ // game asks the player to make.
47
+ const fill = new DirectionalLight(0xbfd4ff, 1.5);
48
+ fill.position.set(-2, 7, 16);
49
+ scene.add(fill);
50
+
51
+ const rim = new DirectionalLight(palette.accent, 0.7);
52
+ rim.position.set(-8, 4, 6);
53
+ scene.add(rim);
54
+ scene.add(new AmbientLight(palette.skyHigh, 0.6));
55
+
56
+ return key;
57
+ }