create-threenative 0.2.10 → 0.2.13

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 (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +227 -34
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +15 -10
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +14 -9
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +15 -10
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +15 -10
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +15 -10
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +72 -1
  420. package/templates/racing/src/scenes/Race.ts +9 -7
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +14 -9
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +14 -9
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +15 -10
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +15 -10
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +15 -10
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +15 -10
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +15 -10
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +14 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +27 -14
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +15 -10
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -0,0 +1,266 @@
1
+ // Generated for you. This is ordinary Three.js TSL — edit or delete it freely.
2
+ //
3
+ // The race's feedback: dust off the tyres, drift sparks that change colour as the mini-turbo
4
+ // charges (white, yellow, orange, as MK64's do), and stars when a kart is hit or takes an item
5
+ // box. Five pooled emitters cover every effect. The boost flame is a mesh on the kart
6
+ // (`kart.ts`): a puff stays where it was born, so a flame of particles laid a dotted row of
7
+ // lights down the road behind every boost.
8
+ // `GPUParticles3D` (built in `scenes/Race.ts`) owns the slots, the dispatch, the birth stamps and
9
+ // the culling. Every look choice is this file's: life, drag, gravity, size, colour, blend and
10
+ // sprite mask. A burst passes its shape as the request's `direction`: x is the outward speed,
11
+ // y the upward speed, and z the radius it starts in.
12
+ import {
13
+ Fn,
14
+ If,
15
+ abs,
16
+ cos,
17
+ exp,
18
+ float,
19
+ hash,
20
+ instanceIndex,
21
+ mix,
22
+ sin,
23
+ smoothstep,
24
+ step,
25
+ time,
26
+ uint,
27
+ uv,
28
+ varying,
29
+ vec3,
30
+ vec4,
31
+ } from "three/tsl";
32
+ import {
33
+ AdditiveBlending,
34
+ type ComputeNode,
35
+ type Node,
36
+ NormalBlending,
37
+ SpriteNodeMaterial,
38
+ type StorageBufferNode,
39
+ type UniformNode,
40
+ type Vector3,
41
+ } from "three/webgpu";
42
+
43
+ export interface IEffectBuffers {
44
+ readonly positions: StorageBufferNode<"vec3">;
45
+ readonly velocities: StorageBufferNode<"vec3">;
46
+ readonly births: StorageBufferNode<"float">;
47
+ }
48
+
49
+ export interface IEffectRequest {
50
+ readonly first: UniformNode<"uint", number>;
51
+ readonly count: UniformNode<"uint", number>;
52
+ readonly origin: UniformNode<"vec3", Vector3>;
53
+ readonly direction: UniformNode<"vec3", Vector3>;
54
+ readonly seed: UniformNode<"float", number>;
55
+ }
56
+
57
+ export interface IEffectOptions {
58
+ readonly amount: number;
59
+ readonly lifetime: number;
60
+ readonly material: SpriteNodeMaterial;
61
+ readonly spawn: (buffers: IEffectBuffers, request: IEffectRequest) => ComputeNode;
62
+ readonly process: (
63
+ buffers: IEffectBuffers,
64
+ runtime: { readonly time: Node<"float">; readonly delta: Node<"float"> },
65
+ ) => ComputeNode;
66
+ }
67
+
68
+ interface IRecipe {
69
+ readonly amount: number;
70
+ /** Seconds a particle lives. */
71
+ readonly life: number;
72
+ /** Fraction of speed lost per second, as an exponential rate. */
73
+ readonly drag: number;
74
+ /** Metres per second squared on y: negative falls, positive rises like warm dust. */
75
+ readonly gravity: number;
76
+ /** Sprite size in metres at birth and at death. */
77
+ readonly size: readonly [number, number];
78
+ /** Linear colour at birth and at death. */
79
+ readonly colour: readonly [readonly [number, number, number], readonly [number, number, number]];
80
+ readonly opacity: number;
81
+ readonly additive: boolean;
82
+ readonly mask: "puff" | "star";
83
+ }
84
+
85
+ const TAU = Math.PI * 2;
86
+
87
+ /** A soft round puff, or a four-point star with a soft core: no texture, no download. */
88
+ function sprite(mask: IRecipe["mask"]) {
89
+ const point = uv().sub(0.5);
90
+ const round = float(1).sub(smoothstep(0.05, 0.5, point.length()));
91
+ if (mask === "puff") return round.mul(round);
92
+ const ray = float(1)
93
+ .sub(smoothstep(0.02, 0.07, abs(point.x)))
94
+ .max(float(1).sub(smoothstep(0.02, 0.07, abs(point.y))))
95
+ .mul(float(1).sub(smoothstep(0.1, 0.5, point.length())));
96
+ return round.mul(round).max(ray);
97
+ }
98
+
99
+ function emitter(recipe: IRecipe): IEffectOptions {
100
+ const material = new SpriteNodeMaterial({
101
+ blending: recipe.additive ? AdditiveBlending : NormalBlending,
102
+ depthWrite: false,
103
+ transparent: true,
104
+ });
105
+ // The quad's empty corners write nothing to the depth and normal buffers, so AO skips them.
106
+ material.alphaTest = 0.02;
107
+ const [birth, death] = recipe.colour;
108
+ // The material reads the birth stamp the engine writes, so it binds once the buffer exists.
109
+ const bind = (born: Node<"float">): void => {
110
+ const age = time.sub(born);
111
+ const alive = varying(step(0, age).mul(step(age, recipe.life)));
112
+ const phase = varying(age.div(recipe.life).clamp(0, 1));
113
+ const jitter = hash(instanceIndex.add(7)).mul(0.6).add(0.7);
114
+ material.scaleNode = mix(float(recipe.size[0]), float(recipe.size[1]), phase)
115
+ .mul(jitter)
116
+ .mul(alive);
117
+ material.colorNode = vec4(
118
+ mix(vec3(...birth), vec3(...death), phase),
119
+ sprite(recipe.mask)
120
+ .mul(float(1).sub(smoothstep(0.55, 1, phase)))
121
+ .mul(recipe.opacity)
122
+ .mul(alive),
123
+ );
124
+ };
125
+ const spawn = (
126
+ { positions, velocities, births }: IEffectBuffers,
127
+ request: IEffectRequest,
128
+ ): ComputeNode => {
129
+ bind(births.toAttribute());
130
+ return Fn(() => {
131
+ If(instanceIndex.lessThan(request.count), () => {
132
+ const slot = request.first.add(instanceIndex).mod(uint(recipe.amount));
133
+ const key = instanceIndex.add(request.seed.mul(977).toUint());
134
+ const r = (salt: number) => hash(key.add(salt));
135
+ const angle = r(1).mul(TAU);
136
+ const radius = r(2).sqrt().mul(request.direction.z);
137
+ const out = request.direction.x.mul(r(3).mul(0.6).add(0.5));
138
+ positions
139
+ .element(slot)
140
+ .assign(
141
+ request.origin.add(
142
+ vec3(cos(angle).mul(radius), r(4).mul(0.12), sin(angle).mul(radius)),
143
+ ),
144
+ );
145
+ velocities
146
+ .element(slot)
147
+ .assign(
148
+ vec3(
149
+ cos(angle).mul(out),
150
+ request.direction.y.mul(r(5).mul(0.8).add(0.6)),
151
+ sin(angle).mul(out),
152
+ ),
153
+ );
154
+ });
155
+ })().compute(recipe.amount);
156
+ };
157
+ const process = (
158
+ { positions, velocities, births }: IEffectBuffers,
159
+ runtime: { readonly time: Node<"float">; readonly delta: Node<"float"> },
160
+ ): ComputeNode =>
161
+ Fn(() => {
162
+ const age = runtime.time.sub(births.element(instanceIndex));
163
+ If(age.greaterThanEqual(0).and(age.lessThan(recipe.life)), () => {
164
+ const velocity = velocities
165
+ .element(instanceIndex)
166
+ .mul(exp(float(-recipe.drag).mul(runtime.delta)))
167
+ .add(vec3(0, recipe.gravity, 0).mul(runtime.delta));
168
+ velocities.element(instanceIndex).assign(velocity);
169
+ positions.element(instanceIndex).addAssign(velocity.mul(runtime.delta));
170
+ });
171
+ })().compute(recipe.amount);
172
+ return { amount: recipe.amount, lifetime: recipe.life, material, process, spawn };
173
+ }
174
+
175
+ /** Pale grey-tan dust that billows and drifts up: tyre dust off-road, drift smoke, landings. */
176
+ export function dustEffect(): IEffectOptions {
177
+ return emitter({
178
+ additive: false,
179
+ amount: 1024,
180
+ colour: [
181
+ [0.7, 0.64, 0.52],
182
+ [0.9, 0.89, 0.86],
183
+ ],
184
+ drag: 3.5,
185
+ gravity: 0.9,
186
+ life: 0.8,
187
+ mask: "puff",
188
+ opacity: 0.5,
189
+ size: [0.45, 1.3],
190
+ });
191
+ }
192
+
193
+ /**
194
+ * One drift-spark colour: additive stars thrown off the rear wheels, falling fast. The colours run
195
+ * well above 1 because auto exposure meters a sunlit course: at 1.5 they vanish against the road.
196
+ * Keep one channel low: overlapping additive stars sum, and a near-white birth colour reads white.
197
+ */
198
+ function spark(birth: readonly [number, number, number], death: readonly [number, number, number]) {
199
+ return emitter({
200
+ additive: true,
201
+ amount: 512,
202
+ colour: [birth, death],
203
+ drag: 2.5,
204
+ gravity: -9,
205
+ life: 0.35,
206
+ mask: "star",
207
+ opacity: 1,
208
+ size: [0.55, 0.14],
209
+ });
210
+ }
211
+
212
+ /** Stage 1: the slide is charging. White-blue, like MK64's first spark. */
213
+ export const sparkWhiteEffect = (): IEffectOptions => spark([1.2, 1.8, 4], [0.5, 1, 3]);
214
+ /** Stage 2: a release now fires the mini-turbo. Yellow. */
215
+ export const sparkYellowEffect = (): IEffectOptions => spark([3, 2, 0.15], [2.2, 1.1, 0.03]);
216
+ /** Stage 3: the top of the charge. Orange-red. */
217
+ export const sparkOrangeEffect = (): IEffectOptions => spark([3.2, 0.9, 0.08], [2.2, 0.25, 0.02]);
218
+
219
+ /** Gold-white stars that pop out and fall: item boxes, hits, the finish line. */
220
+ export function sparkleEffect(): IEffectOptions {
221
+ return emitter({
222
+ additive: true,
223
+ amount: 512,
224
+ colour: [
225
+ [1.6, 1.45, 1.0],
226
+ [1.2, 0.55, 0.08],
227
+ ],
228
+ drag: 2.2,
229
+ gravity: -5,
230
+ life: 0.9,
231
+ mask: "star",
232
+ opacity: 0.9,
233
+ size: [0.4, 0.1],
234
+ });
235
+ }
236
+
237
+ /** The five emitters `scenes/Race.ts` builds, by the name a burst picks one with. */
238
+ export const EFFECTS = {
239
+ dust: dustEffect,
240
+ sparkOrange: sparkOrangeEffect,
241
+ sparkWhite: sparkWhiteEffect,
242
+ sparkYellow: sparkYellowEffect,
243
+ sparkle: sparkleEffect,
244
+ } as const;
245
+
246
+ /**
247
+ * Every burst the game fires, by name: its emitter, how many particles and the request's
248
+ * `direction` (outward speed, upward speed, start radius). Tune the feel here, not in `scenes/Race.ts`.
249
+ */
250
+ export const BURSTS = {
251
+ /** Off-road: a puff from each rear tyre, scaled by speed in `Race.ts`. */
252
+ grass: { emitter: "dust", count: 2, shape: [0.8, 1.2, 0.25] },
253
+ drift: { emitter: "dust", count: 1, shape: [0.6, 0.8, 0.2] },
254
+ landing: { emitter: "dust", count: 14, shape: [3, 0.5, 0.6] },
255
+ wall: { emitter: "sparkle", count: 10, shape: [3.5, 2, 0.2] },
256
+ // Drift sparks, one emitter per stage colour.
257
+ spark1: { emitter: "sparkWhite", count: 3, shape: [2.2, 2.6, 0.15] },
258
+ spark2: { emitter: "sparkYellow", count: 3, shape: [2.6, 3, 0.15] },
259
+ spark3: { emitter: "sparkOrange", count: 4, shape: [3, 3.4, 0.15] },
260
+ box: { emitter: "sparkle", count: 26, shape: [4, 4.5, 0.5] },
261
+ hit: { emitter: "sparkle", count: 30, shape: [4.5, 5, 0.4] },
262
+ splash: { emitter: "dust", count: 10, shape: [2.5, 3, 0.4] },
263
+ } as const satisfies Record<
264
+ string,
265
+ { emitter: keyof typeof EFFECTS; count: number; shape: readonly [number, number, number] }
266
+ >;
@@ -0,0 +1,163 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // The items: a burr, an acorn, and the rows of rainbow item boxes. The boxes are two
5
+ // instanced meshes, a see-through rainbow cube round a glowing core, so every box is two draw
6
+ // calls in all. A taken box shrinks to nothing and grows back when `Race.ts` says it has respawned.
7
+ import {
8
+ BoxGeometry,
9
+ BufferAttribute,
10
+ Color,
11
+ ConeGeometry,
12
+ CylinderGeometry,
13
+ type Group,
14
+ IcosahedronGeometry,
15
+ InstancedMesh,
16
+ Matrix4,
17
+ Mesh,
18
+ Object3D,
19
+ OctahedronGeometry,
20
+ Quaternion,
21
+ SphereGeometry,
22
+ Vector3,
23
+ } from "three";
24
+ import type { ICourse } from "../track/Course.js";
25
+ import { at, lit, merge, paint } from "./materials.js";
26
+ import { C } from "./palette.js";
27
+
28
+ /** Spike directions: the twelve corners of an icosahedron, so the spikes stand evenly. */
29
+ const SPIKES = new IcosahedronGeometry(1, 0).getAttribute("position");
30
+ const spikeAxes = Array.from({ length: SPIKES.count }, (_, i) =>
31
+ new Vector3().fromBufferAttribute(SPIKES, i).normalize(),
32
+ ).filter((axis, i, all) => all.findIndex((other) => other.distanceTo(axis) < 1e-3) === i);
33
+
34
+ /**
35
+ * A burr dropped on the road: a round seed head bristling with pale hooked spikes, the size of a
36
+ * football so it reads from the chase camera. Shared by every burr.
37
+ */
38
+ const BURR = merge([
39
+ paint(new IcosahedronGeometry(0.24, 1), C.burr, at(0, 0.34, 0), 0.35),
40
+ ...spikeAxes.map((axis) =>
41
+ paint(
42
+ new ConeGeometry(0.06, 0.22, 5),
43
+ C.burrTip,
44
+ new Matrix4().compose(
45
+ axis
46
+ .clone()
47
+ .multiplyScalar(0.3)
48
+ .add(new Vector3(0, 0.34, 0)),
49
+ new Quaternion().setFromUnitVectors(new Vector3(0, 1, 0), axis),
50
+ new Vector3(1, 1, 1),
51
+ ),
52
+ ),
53
+ ),
54
+ ]);
55
+
56
+ /**
57
+ * An acorn rolled up the road: a tan nut under a dark scaly cap with a stub of stalk, upright and
58
+ * spinning as it runs. Shared by every acorn.
59
+ */
60
+ const ACORN = merge([
61
+ paint(new SphereGeometry(0.28, 14, 10), C.acorn, at(0, 0.36, 0, 0, 0, 0, 1, 1.25, 1), 0.3),
62
+ paint(
63
+ new SphereGeometry(0.31, 14, 6, 0, Math.PI * 2, 0, Math.PI / 2),
64
+ C.acornCap,
65
+ at(0, 0.52, 0, 0, 0, 0, 1, 0.7, 1),
66
+ 0.4,
67
+ ),
68
+ paint(new CylinderGeometry(0.04, 0.05, 0.16, 6), C.acornCap, at(0, 0.78, 0, 0, 0, 0.3)),
69
+ ]);
70
+
71
+ export function burrMesh(): Mesh {
72
+ const mesh = new Mesh(BURR, lit({ roughness: 0.8 }));
73
+ mesh.castShadow = true;
74
+ return mesh;
75
+ }
76
+
77
+ export function acornMesh(): Mesh {
78
+ const mesh = new Mesh(ACORN, lit({ roughness: 0.55 }));
79
+ mesh.castShadow = true;
80
+ return mesh;
81
+ }
82
+
83
+ /** The rows of item boxes on the course. */
84
+ export class ItemBoxes {
85
+ /** World position of each box, row by row, four abreast. */
86
+ readonly spots: { x: number; y: number; z: number }[] = [];
87
+ readonly #cubes: InstancedMesh;
88
+ readonly #cores: InstancedMesh;
89
+ readonly #scale: number[] = [];
90
+ readonly #dummy = new Object3D();
91
+
92
+ constructor(course: ICourse, group: Group, lanes: readonly number[] = [-4.5, -1.5, 1.5, 4.5]) {
93
+ // Each face of the cube one of three colours, so it reads as a rainbow while it turns.
94
+ const cube = new BoxGeometry(1.15, 1.15, 1.15).toNonIndexed();
95
+ const faces = [C.boxA, C.boxB, C.boxC, C.boxA, C.boxB, C.boxC];
96
+ const colours = new Float32Array(cube.getAttribute("position").count * 3);
97
+ const tint = new Color();
98
+ for (let v = 0; v < colours.length / 3; v += 1) {
99
+ tint.set(faces[Math.floor(v / 6)] ?? C.white);
100
+ colours.set([tint.r, tint.g, tint.b], v * 3);
101
+ }
102
+ cube.setAttribute("color", new BufferAttribute(colours, 3));
103
+ for (const row of course.boxes) {
104
+ for (const lateral of lanes) {
105
+ const p = { x: 0, y: 0, z: 0 };
106
+ course.pointAt(row, lateral, p);
107
+ p.y += 1.1;
108
+ this.spots.push(p);
109
+ this.#scale.push(1);
110
+ }
111
+ }
112
+ this.#cubes = new InstancedMesh(
113
+ cube,
114
+ lit({
115
+ emissive: 0xffffff,
116
+ emissiveIntensity: 0.12,
117
+ opacity: 0.62,
118
+ roughness: 0.2,
119
+ transparent: true,
120
+ }),
121
+ this.spots.length,
122
+ );
123
+ this.#cores = new InstancedMesh(
124
+ paint(new OctahedronGeometry(0.34, 0), C.white),
125
+ lit({ emissive: C.boxC, emissiveIntensity: 1.4, roughness: 0.3 }),
126
+ this.spots.length,
127
+ );
128
+ this.#cubes.name = "item-boxes";
129
+ this.#cores.name = "item-box-cores";
130
+ this.#cubes.castShadow = true;
131
+ group.add(this.#cubes, this.#cores);
132
+ this.update(0, () => true);
133
+ }
134
+
135
+ /**
136
+ * Spins and bobs the boxes; a box that is not `ready` shrinks away, then grows back. A box within
137
+ * 6.5 m of `eye` (the camera) shrinks too, gone by 3.5 m, so the chase camera never flies through one.
138
+ */
139
+ update(
140
+ time: number,
141
+ ready: (box: number) => boolean,
142
+ dt = 1,
143
+ eye?: { x: number; y: number; z: number },
144
+ ): void {
145
+ const d = this.#dummy;
146
+ this.spots.forEach((spot, i) => {
147
+ const target = ready(i) ? 1 : 0;
148
+ const scale = (this.#scale[i] ?? 0) + (target - (this.#scale[i] ?? 0)) * Math.min(1, dt * 8);
149
+ this.#scale[i] = scale;
150
+ const near = eye ? Math.hypot(spot.x - eye.x, spot.y - eye.y, spot.z - eye.z) : 9;
151
+ d.position.set(spot.x, spot.y + Math.sin(time * 2.2 + i) * 0.12, spot.z);
152
+ d.rotation.set(0.5, time * 1.6 + i * 0.7, 0.6);
153
+ d.scale.setScalar(Math.max(1e-3, scale * Math.min(1, Math.max(0, (near - 3.5) / 3))));
154
+ d.updateMatrix();
155
+ this.#cubes.setMatrixAt(i, d.matrix);
156
+ d.rotation.set(0, -time * 2.4, 0);
157
+ d.updateMatrix();
158
+ this.#cores.setMatrixAt(i, d.matrix);
159
+ });
160
+ this.#cubes.instanceMatrix.needsUpdate = true;
161
+ this.#cores.instanceMatrix.needsUpdate = true;
162
+ }
163
+ }
@@ -0,0 +1,256 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // A kart and its driver from primitives: the chassis, side pods, seat, engine and twin exhausts,
5
+ // a rear wing, and a driver in a round helmet, merged into one vertex-coloured mesh; the wheels
6
+ // are three more (the rear axle turns as one, each front wheel steers). Eight original liveries.
7
+ // `KartModel.update` follows a `Kart` from `entities/Kart.ts`: it pitches with the road, leans
8
+ // out of a drift, spins on a burr and flips on an acorn. Forward is −z, the origin is the ground.
9
+ import {
10
+ AdditiveBlending,
11
+ Box3,
12
+ BoxGeometry,
13
+ CapsuleGeometry,
14
+ Color,
15
+ ConeGeometry,
16
+ CylinderGeometry,
17
+ Group,
18
+ Mesh,
19
+ MeshBasicMaterial,
20
+ SphereGeometry,
21
+ TorusGeometry,
22
+ } from "three";
23
+ import type { Kart } from "../entities/Kart.js";
24
+ import { at, lit, merge, paint } from "./materials.js";
25
+ import { C } from "./palette.js";
26
+
27
+ export interface ILivery {
28
+ readonly name: string;
29
+ readonly body: number;
30
+ readonly trim: number;
31
+ readonly helmet: number;
32
+ readonly suit: number;
33
+ }
34
+
35
+ /** The field's eight liveries; the player drives the first. All original, none borrowed. */
36
+ export const LIVERIES: readonly ILivery[] = [
37
+ { body: 0xe8452c, helmet: 0xffffff, name: "Ember", suit: 0xe8452c, trim: 0xffd23a },
38
+ { body: 0x2f6fe0, helmet: 0xf2c232, name: "Tide", suit: 0x1d3f8a, trim: 0xffffff },
39
+ { body: 0x3fae46, helmet: 0xffffff, name: "Fern", suit: 0x2a6e2e, trim: 0xf2c232 },
40
+ { body: 0xf2c232, helmet: 0x2f6fe0, name: "Sunny", suit: 0xe8862c, trim: 0x1a1410 },
41
+ { body: 0x8a4fd0, helmet: 0xf06fa8, name: "Plum", suit: 0x4e2a80, trim: 0xffffff },
42
+ { body: 0xf06fa8, helmet: 0xffffff, name: "Rose", suit: 0xb83a72, trim: 0x8a4fd0 },
43
+ { body: 0x22b6b0, helmet: 0xe8452c, name: "Reef", suit: 0x13706c, trim: 0xffffff },
44
+ { body: 0xe9edf2, helmet: 0x1a1410, name: "Frost", suit: 0x5a6878, trim: 0x2f6fe0 },
45
+ ];
46
+
47
+ /**
48
+ * The drift-charge glow per stage: blue, yellow, orange. Above 1 so it glows on a metered sunny
49
+ * course, with one channel kept low so the filmic curve keeps the hue instead of turning it white.
50
+ */
51
+ const SPARK_GLOW = [
52
+ [0.6, 1.1, 2.6],
53
+ [2.4, 1.7, 0.1],
54
+ [2.6, 0.32, 0.02],
55
+ ] as const;
56
+ const WHEEL = { front: 0.27, rear: 0.31, track: 0.62, frontZ: -0.62, rearZ: 0.58 } as const;
57
+
58
+ function wheel(radius: number, width: number) {
59
+ const turn = (x: number) => at(x, 0, 0, 0, 0, Math.PI / 2);
60
+ return [
61
+ paint(new CylinderGeometry(radius, radius, width, 14), C.tyre, turn(0)),
62
+ paint(new CylinderGeometry(radius * 0.55, radius * 0.55, width + 0.02, 10), C.hub, turn(0)),
63
+ ];
64
+ }
65
+
66
+ // Built once and shared by every kart, so the eight karts upload one copy of each part.
67
+ const REAR_AXLE = merge([
68
+ ...wheel(WHEEL.rear, 0.32).map((g) => g.translate(-WHEEL.track - 0.04, 0, 0)),
69
+ ...wheel(WHEEL.rear, 0.32).map((g) => g.translate(WHEEL.track + 0.04, 0, 0)),
70
+ paint(new CylinderGeometry(0.04, 0.04, 1.3, 6), C.metal, at(0, 0, 0, 0, 0, Math.PI / 2)),
71
+ ]);
72
+ const FRONT_WHEEL = merge(wheel(WHEEL.front, 0.26));
73
+ const cone = (x: number) =>
74
+ new ConeGeometry(0.11, 0.6, 8).rotateX(Math.PI / 2).translate(x, 0, 0.3);
75
+ const FLAME = merge([cone(-0.17), cone(0.17)]);
76
+ const FLAME_MATERIAL = new MeshBasicMaterial({
77
+ blending: AdditiveBlending,
78
+ color: new Color(7, 3.2, 0.7),
79
+ depthWrite: false,
80
+ transparent: true,
81
+ });
82
+ const STAR = merge([
83
+ new SphereGeometry(0.09, 8, 6),
84
+ ...[0, 1, 2, 3].map((r) => new BoxGeometry(0.62, 0.05, 0.05).rotateZ((r * Math.PI) / 4)),
85
+ ]);
86
+ /** One glow material per drift stage, swapped onto the stars instead of recoloured per kart. */
87
+ const GLOW_MATERIALS = SPARK_GLOW.map(
88
+ ([r, g, b]) => new MeshBasicMaterial({ color: new Color(r, g, b) }),
89
+ );
90
+
91
+ function bodyGeometry(livery: ILivery) {
92
+ const { body, trim, helmet, suit } = livery;
93
+ return merge([
94
+ // Chassis: a low floor pan, the nose and its bumper, two side pods.
95
+ paint(new BoxGeometry(1.0, 0.12, 1.55), body, at(0, 0.22, 0.02), 0.3),
96
+ paint(new BoxGeometry(0.82, 0.24, 0.55), body, at(0, 0.32, -0.66, -0.25), 0.25),
97
+ paint(new BoxGeometry(1.28, 0.12, 0.16), trim, at(0, 0.24, -1.0)),
98
+ paint(new BoxGeometry(0.42, 0.06, 0.03), C.white, at(0, 0.36, -1.09)),
99
+ paint(new BoxGeometry(0.26, 0.26, 0.95), body, at(-0.56, 0.3, 0.05), 0.3),
100
+ paint(new BoxGeometry(0.26, 0.26, 0.95), body, at(0.56, 0.3, 0.05), 0.3),
101
+ paint(new BoxGeometry(0.27, 0.06, 0.96), trim, at(-0.56, 0.45, 0.05)),
102
+ paint(new BoxGeometry(0.27, 0.06, 0.96), trim, at(0.56, 0.45, 0.05)),
103
+ // Seat, engine, twin exhausts and a rear wing on two struts.
104
+ paint(new BoxGeometry(0.56, 0.12, 0.42), C.seat, at(0, 0.36, 0.22)),
105
+ paint(new BoxGeometry(0.56, 0.5, 0.12), C.seat, at(0, 0.6, 0.42, 0.2)),
106
+ paint(new BoxGeometry(0.6, 0.34, 0.36), C.metal, at(0, 0.45, 0.68), 0.35),
107
+ paint(
108
+ new CylinderGeometry(0.07, 0.08, 0.34, 8),
109
+ C.exhaust,
110
+ at(-0.17, 0.56, 0.92, Math.PI / 2 - 0.3),
111
+ ),
112
+ paint(
113
+ new CylinderGeometry(0.07, 0.08, 0.34, 8),
114
+ C.exhaust,
115
+ at(0.17, 0.56, 0.92, Math.PI / 2 - 0.3),
116
+ ),
117
+ paint(new BoxGeometry(0.05, 0.36, 0.08), C.metal, at(-0.3, 0.7, 0.86)),
118
+ paint(new BoxGeometry(0.05, 0.36, 0.08), C.metal, at(0.3, 0.7, 0.86)),
119
+ paint(new BoxGeometry(1.12, 0.06, 0.3), body, at(0, 0.9, 0.9, 0.12)),
120
+ paint(new BoxGeometry(0.06, 0.2, 0.32), trim, at(-0.56, 0.85, 0.9)),
121
+ paint(new BoxGeometry(0.06, 0.2, 0.32), trim, at(0.56, 0.85, 0.9)),
122
+ // Steering column and wheel.
123
+ paint(new CylinderGeometry(0.03, 0.03, 0.42, 6), C.ink, at(0, 0.56, -0.32, -0.9)),
124
+ paint(new TorusGeometry(0.16, 0.035, 6, 16), C.ink, at(0, 0.72, -0.18, -0.5)),
125
+ // The driver: torso, arms to the wheel, gloves, helmet and visor.
126
+ paint(new CapsuleGeometry(0.2, 0.26, 4, 10), suit, at(0, 0.78, 0.18), 0.3),
127
+ paint(new CapsuleGeometry(0.065, 0.32, 3, 8), suit, at(-0.22, 0.78, -0.02, -1.05, 0, 0.25)),
128
+ paint(new CapsuleGeometry(0.065, 0.32, 3, 8), suit, at(0.22, 0.78, -0.02, -1.05, 0, -0.25)),
129
+ paint(new SphereGeometry(0.075, 8, 6), C.glove, at(-0.15, 0.73, -0.2)),
130
+ paint(new SphereGeometry(0.075, 8, 6), C.glove, at(0.15, 0.73, -0.2)),
131
+ paint(new SphereGeometry(0.25, 16, 12), helmet, at(0, 1.2, 0.16), 0.35),
132
+ paint(new BoxGeometry(0.06, 0.06, 0.5), trim, at(0, 1.44, 0.16, 0, 0, 0)),
133
+ paint(new SphereGeometry(0.17, 12, 8), C.visor, at(0, 1.19, -0.02, 0, 0, 0, 1.1, 0.62, 0.62)),
134
+ ]);
135
+ }
136
+
137
+ export class KartModel {
138
+ readonly root = new Group();
139
+ /** The kart's own box in the root's frame, measured once here while the root is still identity. */
140
+ readonly bounds = new Box3();
141
+ readonly #rear: Mesh;
142
+ readonly #fronts: readonly Group[];
143
+ readonly #frontWheels: readonly Mesh[];
144
+ readonly #flame: Mesh;
145
+ readonly #glows: readonly Mesh[];
146
+ /** The chassis and wheels' reach from the root origin: half the body's length and its top. */
147
+ readonly #halfLength: number;
148
+ readonly #top: number;
149
+ #roll = 0;
150
+ /** The road's pitch, kept apart from the tumble's flip so the flip never feeds back into it. */
151
+ #pitch = 0;
152
+ #spin = 0;
153
+
154
+ constructor(readonly livery: ILivery) {
155
+ this.root.name = `kart-${livery.name.toLowerCase()}`;
156
+ this.root.rotation.order = "YXZ";
157
+ const material = lit({ roughness: 0.5 });
158
+ const body = new Mesh(bodyGeometry(livery), material);
159
+ this.#rear = new Mesh(REAR_AXLE, material);
160
+ this.#rear.position.set(0, WHEEL.rear, WHEEL.rearZ);
161
+ const fronts: Group[] = [];
162
+ const frontWheels: Mesh[] = [];
163
+ for (const side of [-1, 1]) {
164
+ const pivot = new Group();
165
+ pivot.position.set(side * WHEEL.track, WHEEL.front, WHEEL.frontZ);
166
+ const spinner = new Mesh(FRONT_WHEEL, material);
167
+ pivot.add(spinner);
168
+ fronts.push(pivot);
169
+ frontWheels.push(spinner);
170
+ }
171
+ this.#fronts = fronts;
172
+ this.#frontWheels = frontWheels;
173
+ this.root.add(body, this.#rear, ...fronts);
174
+ this.root.traverse((object) => {
175
+ object.castShadow = true;
176
+ object.receiveShadow = true;
177
+ });
178
+ // The boost flame rides on the exhausts. Particles alone are left behind at racing speed and
179
+ // the temporal anti-aliasing smears them out, so the flame the player sees is a mesh. Its
180
+ // colour runs above 1 for the same reason the sparks do: auto exposure meters a sunny course.
181
+ this.#flame = new Mesh(FLAME, FLAME_MATERIAL);
182
+ this.#flame.position.set(0, 0.62, 1.02);
183
+ this.#flame.visible = false;
184
+ this.root.add(this.#flame);
185
+ // The spark charge glows on each rear tyre in the stage's colour, for the same reason: the
186
+ // thrown sparks fall behind and smear, so the colour the player reads rides on the kart.
187
+ // Opaque, not additive: added onto a sunlit road every colour sums toward white.
188
+ this.#glows = [-1, 1].map((side) => {
189
+ const glow = new Mesh(STAR, GLOW_MATERIALS[0]);
190
+ glow.position.set(side * (WHEEL.track + 0.1), 0.16, WHEEL.rearZ + 0.34);
191
+ glow.visible = false;
192
+ this.root.add(glow);
193
+ return glow;
194
+ });
195
+ // The tumble's lift is measured from the kart itself, not the hidden flame and glows.
196
+ const bounds = this.bounds;
197
+ bounds.setFromObject(body);
198
+ bounds.expandByObject(this.#rear);
199
+ for (const pivot of fronts) bounds.expandByObject(pivot);
200
+ this.#halfLength = Math.max(-bounds.min.z, bounds.max.z);
201
+ this.#top = bounds.max.y;
202
+ }
203
+
204
+ /** Follows the kart: place, heading, the road's pitch, a lean out of a drift, the hits. */
205
+ update(kart: Kart, steer: number, dt: number): void {
206
+ const course = kart.course;
207
+ const root = this.root;
208
+ root.position.set(kart.x, kart.y, kart.z);
209
+ // Pitch: the road's slope along the kart's own heading.
210
+ const trackYaw = Math.atan2(-(course.tx[kart.index] ?? 0), -(course.tz[kart.index] ?? 0));
211
+ const along = Math.cos(kart.yaw - trackYaw);
212
+ const pitch = kart.airborne
213
+ ? this.#pitch * 0.96
214
+ : Math.atan(course.slopeAt(kart.index, kart.x, kart.z) * along);
215
+ this.#pitch = pitch;
216
+ // A drift leans the kart out of the turn and swings its nose 17° further in, so the slide reads
217
+ // from the chase camera, which follows the travel and not the nose.
218
+ const lean = kart.drifting ? kart.driftSide * 0.1 : steer * 0.05 * Math.min(1, kart.speed / 10);
219
+ this.#roll += (lean - this.#roll) * Math.min(1, dt * 10);
220
+ const flip =
221
+ kart.tumbleTicks > 0 ? (1 - kart.tumbleTicks / kart.feel.tumbleTicks) * Math.PI * 2 : 0;
222
+ root.rotation.set(pitch + flip, kart.yaw + kart.spinAngle - kart.driftSide * 0.3, this.#roll);
223
+ // The root's origin is the road contact, so a flip about it swings half the kart under the
224
+ // road. Lift the root by how far the rotated body would dip, so the tumble stays on the road.
225
+ const angle = pitch + flip;
226
+ if (flip !== 0)
227
+ root.position.y +=
228
+ this.#halfLength * Math.abs(Math.sin(angle)) + Math.max(0, -this.#top * Math.cos(angle));
229
+ const boosting = kart.boostTicks > 0 || kart.miniTurboTicks > 0;
230
+ this.#flame.visible = boosting;
231
+ if (boosting) this.#flame.scale.set(1, 1, 0.75 + Math.abs(Math.sin(this.#spin * 7)) * 0.5);
232
+ const charge = kart.drifting && kart.grounded ? kart.driftStage : 0;
233
+ const tint = GLOW_MATERIALS[charge - 1];
234
+ for (const [g, glow] of this.#glows.entries()) {
235
+ glow.visible = tint !== undefined;
236
+ if (tint !== undefined) glow.material = tint;
237
+ glow.rotation.z = this.#spin * (g === 0 ? 0.9 : -0.9);
238
+ glow.scale.setScalar(0.8 + Math.abs(Math.sin(this.#spin * 5 + g)) * 0.4 + charge * 0.1);
239
+ }
240
+ this.#spin += (kart.speed * dt) / WHEEL.rear;
241
+ this.#rear.rotation.x = -this.#spin;
242
+ for (const pivot of this.#fronts) pivot.rotation.y = -steer * 0.45;
243
+ for (const spinner of this.#frontWheels)
244
+ spinner.rotation.x = -this.#spin * (WHEEL.rear / WHEEL.front);
245
+ }
246
+
247
+ /** The two rear tyres' contact points in world space, for sparks, dust and skid marks. */
248
+ rearWheel(side: -1 | 1, out: { x: number; y: number; z: number }): void {
249
+ const yaw = this.root.rotation.y;
250
+ const lx = side * (WHEEL.track + 0.04);
251
+ const lz = WHEEL.rearZ + 0.1;
252
+ out.x = this.root.position.x + Math.cos(yaw) * lx + Math.sin(yaw) * lz;
253
+ out.y = this.root.position.y + 0.06;
254
+ out.z = this.root.position.z - Math.sin(yaw) * lx + Math.cos(yaw) * lz;
255
+ }
256
+ }