create-threenative 0.2.9 → 0.2.12

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 +229 -36
  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 +17 -11
  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 +16 -10
  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 +17 -11
  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 +17 -11
  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 +17 -11
  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 +76 -5
  420. package/templates/racing/src/scenes/Race.ts +53 -42
  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 +16 -10
  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 +16 -10
  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 +17 -11
  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 +17 -11
  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 +17 -11
  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 +17 -11
  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 +17 -11
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +56 -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 +53 -34
  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 +17 -11
  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,20 @@
1
+ // Generated for you. The starter kits share this meter; `pnpm stamp:template-render` copies it into
2
+ // each kit that ships it. Override it for one game in `exposure.ts`, not here.
3
+ //
4
+ // Core's meter is stock Unreal 5.8.3, exposure compensation +1 EV (key 0.36,
5
+ // r.DefaultFeature.AutoExposure.Bias 1.0, UE 5.8.3: Engine/Source/Runtime/Engine/Private/SceneView.cpp:196-199).
6
+ // The kits use 0 EV (key 0.18) instead. Their bright stylised scenes read pastel and veiled at
7
+ // +1 EV. At 0 EV a fresh Opus judge read IMPROVEMENT on 9 of 9 kits (PRD-747, 2026-10-26).
8
+ // The range keeps Unreal's -10..+20 EV100 window around the new key.
9
+ import {
10
+ type IExposureSettings,
11
+ exposureSettings as coreExposureSettings,
12
+ } from "@threenative/core";
13
+
14
+ const KEY = 0.18;
15
+ export const kitExposureSettings: Readonly<IExposureSettings> = {
16
+ ...coreExposureSettings,
17
+ key: KEY,
18
+ minStops: Math.log2(KEY) - 20,
19
+ maxStops: Math.log2(KEY) + 10,
20
+ };
@@ -1,10 +1,32 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
3
  //
4
- // One sun. The sky image in `sky.ts` is the fill light — its environment reaches every face the
4
+ // One sun. The sky in `sky.ts` is the fill light — its environment reaches every face the
5
5
  // sun misses — so there is no hemisphere or ambient light stacked on top to flatten the frame.
6
6
  import { Color, DirectionalLight, PCFSoftShadowMap, type Scene, Vector3 } from "three";
7
- import { SUN_DIRECTION } from "./sky.js";
7
+ import {
8
+ SUN_ILLUMINANCE,
9
+ SUN_KELVIN,
10
+ sunLight,
11
+ sunLightTransmittance,
12
+ temperatureColour,
13
+ } from "./atmosphere.js";
14
+ import { SKY_OPTIONS, SUN_DIRECTION } from "./sky.js";
15
+
16
+ /** The sun as Unreal's default level has it: 6 lux at 6500 K, tinted by the air it crosses. */
17
+ function atmosphereSun(): DirectionalLight {
18
+ const tint = temperatureColour(SUN_KELVIN);
19
+ const through = sunLightTransmittance(Math.asin(Math.min(1, Math.max(-1, SUN_DIRECTION.y))));
20
+ const colour = new Color().setRGB(
21
+ tint[0] * through[0],
22
+ tint[1] * through[1],
23
+ tint[2] * through[2],
24
+ );
25
+ const key = new DirectionalLight(colour, SUN_ILLUMINANCE);
26
+ // `gpuSky.ts` re-tints it when the sun moves.
27
+ sunLight.current = key;
28
+ return key;
29
+ }
8
30
 
9
31
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
10
32
 
@@ -16,8 +38,8 @@ export function setupLighting(
16
38
  renderer.shadowMap.enabled = true;
17
39
  renderer.shadowMap.type = PCFSoftShadowMap;
18
40
 
19
- // Warm white, matched by eye to the photographed midday sun against its own sky.
20
- const key = new DirectionalLight(0xfff1e0, 4.5);
41
+ // The photo sky keeps the warm white matched by eye to its photographed midday sun.
42
+ const key = SKY_OPTIONS.sky === "photo" ? new DirectionalLight(0xfff1e0, 4.5) : atmosphereSun();
21
43
  key.position.copy(SUN_DIRECTION).multiplyScalar(40);
22
44
  key.castShadow = true;
23
45
  // One map fitted to the whole circuit rather than a cascade that follows the car: the racing line
@@ -1,15 +1,6 @@
1
1
  // Generated for you. Scene-owned material assignments; no engine appearance hooks.
2
- import {
3
- type Camera,
4
- type DirectionalLight,
5
- Material,
6
- Mesh,
7
- MeshStandardMaterial,
8
- type Object3D,
9
- type Scene,
10
- type Texture,
11
- } from "three";
12
- import { type IBacklightControls, backlightMaterial } from "./backlightMaterial.js";
2
+ import type { Camera, DirectionalLight, Object3D, Scene, Texture } from "three";
3
+ import type { IBacklightControls } from "./backlightMaterial.js";
13
4
  import {
14
5
  type IEnvironmentMeasurement,
15
6
  measureEnvironment,
@@ -65,7 +65,8 @@ function rgbaTexture(
65
65
  * car lays rubber. The band is the thing that makes a road read as a **racing** surface rather
66
66
  * than a grey plane — it also tells the player where the line is without a single word of UI.
67
67
  */
68
- const asphalt = rgbaTexture(256, (u, v) => {
68
+ // Not applied to the road yet, so it is prefixed rather than deleted: wiring it in changes the look.
69
+ const _asphalt = rgbaTexture(256, (u, v) => {
69
70
  const grain = (noise(Math.floor(u * 256), Math.floor(v * 256), 11) - 0.5) * 26;
70
71
  const rubber = 1 - 0.34 * falloff(u - 0.5, 0.16);
71
72
  const shoulder = 1 + 0.1 * falloff(u - 0.5, 0.42);
@@ -1,8 +1,10 @@
1
+ import type { OutputRenderer } from "@threenative/core";
2
+ import { WorldEnvironment } from "@threenative/core";
1
3
  // Generated for you: ordinary Three.js; ThreeNative does not read this file.
2
4
  //
3
5
  // This file wires two things together and decides nothing itself. `quality.ts`, in this folder,
4
- // owns which stages run at which tier and records what each one measured. `WorldEnvironment`,
5
- // also in this folder, builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
6
+ // owns which stages run at which tier and records what each one measured. `WorldEnvironment` from
7
+ // the core package builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
6
8
  // applied or refused **with a reason**, so a stage that silently no-op'd is never mistaken for
7
9
  // one you turned off.
8
10
  //
@@ -12,8 +14,6 @@
12
14
  // `TN_QUALITY_TIER` names the tier that ran either way.
13
15
  import type { Camera, DirectionalLight, Scene } from "three";
14
16
  import { type QualityTier, qualityPreset, resolveQualityTier } from "./quality.js";
15
- import type { OutputRenderer } from "./worldEnvironment.js";
16
- import { WorldEnvironment } from "./worldEnvironment.js";
17
17
 
18
18
  export function setupPost(
19
19
  renderer: OutputRenderer,
@@ -1,3 +1,4 @@
1
+ import { exposureSettings } from "./exposure.js";
1
2
  // Generated for you: ordinary Three.js; ThreeNative does not read this file. Delete or rewrite
2
3
  // it freely — the tiers below are a starting point, not a framework look.
3
4
  //
@@ -28,7 +29,13 @@
28
29
  // frame at 33 ms p95 and 30 fps, so if you turn a stage on, that scenario is what tells you it was
29
30
  // worth it. Both are one line to turn back on.
30
31
 
31
- import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
32
+ import {
33
+ type IWorldEnvironmentOptions,
34
+ qualityPreset as coreQualityPreset,
35
+ qualityTiers,
36
+ } from "@threenative/core";
37
+ export type { QualityTier } from "@threenative/core";
38
+ import type { QualityTier } from "@threenative/core";
32
39
 
33
40
  /**
34
41
  * The three names this game's look comes in.
@@ -38,122 +45,27 @@ import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
38
45
  * laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
39
46
  * what any of them mean.
40
47
  */
41
- export type QualityTier = "low" | "medium" | "high";
48
+ export const resolveQualityTier = qualityTiers.resolve;
42
49
 
43
- const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
44
-
45
- /**
46
- * Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
47
- * `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
48
- */
49
- function isQualityTier(value: string): value is QualityTier {
50
- return (QUALITY_TIERS as readonly string[]).includes(value);
51
- }
52
-
53
- /**
54
- * Where each GPU family starts, from `ctx.renderer.gpuClass`.
55
- *
56
- * A start, not a ceiling: the measured frame-budget windows move the look from here, and an
57
- * explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
58
- * family rule matched — falls back to the `mobile` flag, exactly as before families existed.
59
- * Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
60
- */
61
- const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
62
- software: "low",
63
- "mobile-low": "low",
64
- "mobile-mid": "low",
65
- "mobile-high": "medium",
66
- integrated: "medium",
67
- discrete: "high",
68
- };
69
-
70
- /**
71
- * Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
72
- *
73
- * Fails closed. An unrecognised tier name throws with the value it was handed rather than
74
- * quietly rendering the default, because a silent fallback here looks exactly like a tier that
75
- * turned out to have no effect.
76
- */
77
- export function resolveQualityTier(
78
- request: {
79
- readonly gpuClass?: string;
80
- readonly mobile?: boolean;
81
- readonly software?: boolean;
82
- readonly tier?: string;
83
- } = {},
84
- ): QualityTier {
85
- const requested = request.tier;
86
- if (requested !== undefined) {
87
- if (!isQualityTier(requested)) {
88
- throw new Error(
89
- `Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
90
- );
91
- }
92
- return requested;
93
- }
94
- // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
95
- // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
96
- // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
97
- // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
98
- // `tier` above still wins over it.
99
- if (request.software === true) return "low";
100
- const family =
101
- request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
102
- if (family !== undefined) return family;
103
- return request.mobile === true ? "low" : "high";
104
- }
105
-
106
- /**
107
- * The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the sun
108
- * disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey walls and
109
- * flattens contrast), and a corner falloff. Antialiasing is on in every tier that installs a chain;
110
- * see `screenSpaceAA` in `worldEnvironment.ts`.
111
- *
112
- * No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
113
- * captured sky (`sky.ts`), and SSR on rough tarmac traced speckle into the road; RCAS then rang the
114
- * smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
115
- */
116
- const shared: IWorldEnvironmentOptions = {
117
- // Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
118
- bloomEnabled: true,
119
- bloomRadius: 0.55,
120
- bloomStrength: 0.26,
121
- bloomThreshold: 1,
122
- autoExposureEnabled: false,
123
- exposure: 0.66,
124
- tonemapMode: "aces",
125
- vignetteAmount: 0.26,
126
- };
127
-
128
- /**
129
- * What a desktop gets: contact occlusion on top — the dark line where a tyre meets the tarmac and a
130
- * wing meets its own shadow, most of what separates "a car on a road" from "a car over a picture".
131
- * Gathered at full resolution and denoised: at half, the upsample left a grain around every wheel.
132
- */
133
- const high: IWorldEnvironmentOptions = {
134
- ...shared,
135
- // GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
136
- gtaoEnabled: true,
137
- gtaoRadius: 0.35,
138
- };
139
-
140
- /** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
141
- const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8, renderChainTier: "medium" };
142
-
143
- /** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
144
- const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
145
-
146
- const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
147
-
148
- /** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
149
50
  export function qualityPreset(tier: string): IWorldEnvironmentOptions {
150
- const preset = QUALITY_PRESETS[tier as QualityTier];
151
- if (preset === undefined) {
152
- throw new Error(
153
- `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
154
- );
155
- }
156
- return preset;
51
+ console.info(
52
+ `TN_RENDER_CHAIN_COST_OVERRIDE ${JSON.stringify({
53
+ reason:
54
+ "Racing: rough-tarmac SSR speckle and RCAS sky bands; PRD-194 performance scenario holds 33 ms p95 and 30 fps; isolated stage costs remain unmeasured",
55
+ finalGatherMethod: "none",
56
+ ssgiEnabled: false,
57
+ ssrEnabled: false,
58
+ sharpenEnabled: false,
59
+ })}`,
60
+ );
61
+ return {
62
+ ...coreQualityPreset(tier),
63
+ exposurePolicy: exposureSettings,
64
+ finalGatherMethod: "none",
65
+ ssgiEnabled: false,
66
+ ssrEnabled: false,
67
+ sharpenEnabled: false,
68
+ };
157
69
  }
158
70
 
159
71
  /** First admitted material lane: high desktop hardware WebGPU in the browser only. */
@@ -1,6 +1,12 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
3
  //
4
+ // The default sky is Unreal 5.8.3's default level: a Sky Atmosphere with its volumetric cloud layer, a
5
+ // sky light that captures it, a sun tinted by the air it crosses, and an exponential height fog that
6
+ // takes its colour from the sky (`atmosphere.ts`, `clouds.ts`, `gpuSky.ts`). Sun, sky and fog read one
7
+ // illuminance, so moving `SUN_DIRECTION` recolours all three together. `SKY_OPTIONS.sky = "photo"`
8
+ // keeps the photograph below; `clouds: false` keeps a clear sky.
9
+ //
4
10
  // The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
5
11
  // by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
6
12
  // The same image is the background, the environment light every surface reflects and is filled by,
@@ -15,6 +21,7 @@ import {
15
21
  type Texture,
16
22
  Vector3,
17
23
  } from "three";
24
+ import { createGpuSky } from "./gpuSky.js";
18
25
  import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
19
26
  import { palette } from "./palette.js";
20
27
 
@@ -45,13 +52,13 @@ function distanceDensity(p: HeightFogParams = HEIGHT_FOG): number {
45
52
  }
46
53
 
47
54
  /**
48
- * Puts the sky on the scene, or a plain gradient if the photograph has not decoded yet.
55
+ * Puts the sky on the scene, or a plain gradient if no photograph is given.
49
56
  *
50
- * The second argument is optional because `Race.load()` does not wait for the JPEG: the scene has
51
- * to enter on the first frame or the playtest bridge describes nothing. Passing `undefined` here is
52
- * the fallback the scene starts in, and calling it again with the texture is the swap.
57
+ * `Race.load()` waits for the JPEG, so the scene enters with the photograph already applied. The
58
+ * fallback stays for a scene that has no sky asset, and a swap after the first frame is not safe on
59
+ * `engine: "threejs"` (see `Race.load`).
53
60
  */
54
- export function setupSky(scene: Scene, sky?: Texture): void {
61
+ function setupPhotoSky(scene: Scene, sky?: Texture): void {
55
62
  if (sky === undefined) {
56
63
  scene.background = new Color(palette.skyHigh);
57
64
  scene.environment = null;
@@ -74,3 +81,67 @@ export function setupSky(scene: Scene, sky?: Texture): void {
74
81
  scene.fog = distanceFog;
75
82
  scene.fogNode = heightFogNode(distanceFog, HEIGHT_FOG, SUN_DIRECTION);
76
83
  }
84
+
85
+ export const SKY_OPTIONS: { sky: "atmosphere" | "photo"; clouds: boolean; ground: boolean } = {
86
+ sky: "atmosphere",
87
+ clouds: true,
88
+ // The sunlit ground below the horizon stands in for Unreal's Lumen floor bounce: it lifts shadow
89
+ // sides and a mirror reflects it. Set false when the game adds its own global illumination.
90
+ ground: true,
91
+ };
92
+
93
+ /**
94
+ * Unreal's default level fog in metres: density and falloff are per 1000 cm (x0.1 per metre), and its
95
+ * line integral carries ln2 against the exact integral `heightFog.ts` evaluates. `fogHeight` sits
96
+ * 68.5 m below the floor, where the default level puts the fog actor. Inscattering is black and the
97
+ * start distance 0, as in Unreal: the colour comes from the sky.
98
+ */
99
+ const ATMOSPHERE_FOG = {
100
+ ...HEIGHT_FOG,
101
+ density: 0.00436 * Math.LN2,
102
+ heightFalloff: 0.02,
103
+ fogHeight: -68.5,
104
+ startDistance: 0,
105
+ };
106
+
107
+ /** White in the 8-bit environment is this much scene radiance (`createGpuSky`). */
108
+ const ENVIRONMENT_RANGE = 4;
109
+
110
+ /**
111
+ * `photo` is only read when `SKY_OPTIONS.sky` is "photo". `fogged` false leaves the sky unfogged;
112
+ * `clouds` false draws the clear atmosphere. A software adapter draws the 64 x 32 bake as the
113
+ * background, with no LUT or cloud passes.
114
+ */
115
+ export function setupSky(
116
+ scene: Scene,
117
+ photo?: Texture,
118
+ software = false,
119
+ fogged = true,
120
+ clouds = SKY_OPTIONS.clouds,
121
+ ): void {
122
+ if (SKY_OPTIONS.sky === "photo") {
123
+ setupPhotoSky(scene, photo);
124
+ return;
125
+ }
126
+ // Height fog only; FogExp2 holds the colour `heightFogNode` reads, at zero density. `createGpuSky`
127
+ // sets that colour from the sky and again whenever the sun moves.
128
+ const fog = new FogExp2(0xffffff, 0);
129
+ scene.fog = fog;
130
+ scene.fogNode = heightFogNode(fog, { ...ATMOSPHERE_FOG }, SUN_DIRECTION);
131
+ const { node, environment } = createGpuSky(
132
+ scene,
133
+ SUN_DIRECTION,
134
+ fogged,
135
+ clouds,
136
+ ATMOSPHERE_FOG,
137
+ SKY_OPTIONS.ground,
138
+ );
139
+ environment.mapping = EquirectangularReflectionMapping;
140
+ environment.colorSpace = SRGBColorSpace;
141
+ scene.background = environment;
142
+ scene.backgroundNode = software ? null : node.backgroundNode;
143
+ scene.backgroundIntensity = software ? ENVIRONMENT_RANGE : 1;
144
+ // Unreal's sky light: the same sky, so the fill on every shaded face is the sky's colour.
145
+ scene.environment = environment;
146
+ scene.environmentIntensity = ENVIRONMENT_RANGE;
147
+ }
@@ -1,5 +1,4 @@
1
1
  import {
2
- type ICtx,
3
2
  Scene,
4
3
  type SceneFrame,
5
4
  afterPhysics,
@@ -24,7 +23,7 @@ import {
24
23
  isWebGLFallbackRenderer,
25
24
  materialLightingEnabled,
26
25
  } from "../render/quality.js";
27
- import { SUN_DIRECTION, setupSky } from "../render/sky.js";
26
+ import { SKY_OPTIONS, SUN_DIRECTION, setupSky } from "../render/sky.js";
28
27
  import { TouchControls } from "../render/touch-controls.js";
29
28
  import { type GameState, type RaceStatus, resolveRaceStatus } from "../state.js";
30
29
  import { Lap } from "../track/Lap.js";
@@ -97,56 +96,67 @@ export class Race extends Scene<GameState, IPhysicsContext> {
97
96
  #sky: Texture | undefined;
98
97
 
99
98
  /**
100
- * The sky photograph, fetched but **not awaited**.
99
+ * The sky photograph, **awaited** before the scene enters.
101
100
  *
102
- * `await`ing it here held the scene's first frame for the length of a texture decode, and the
103
- * playtest bridge describes the scene before the runtime enters it: `survives` failed
104
- * `TN_PLAYTEST_CAPABILITY_MISSING` on `runtime.components` because there was no `player` entity
105
- * yet to describe. The scene now enters on the fallback colour and the photograph is swapped in
106
- * the moment it decodes, which is also what a player sees — a sky that arrives rather than a
107
- * black screen that waits.
101
+ * It used to be fetched without waiting and swapped in when it decoded. On `engine: "threejs"`
102
+ * that swap lands in the middle of a frame (WebGPU rendering yields between its awaits), next to
103
+ * the shadow pass, which clears `scene.background` and puts it back. A swap after the first frame
104
+ * was never drawn: the sky stayed the fallback colour on a fast GPU, and the engine-parity guard
105
+ * scored the template 0.823 against the correct `threenative` frame, passing only when a slow
106
+ * adapter let the photograph land before the first render. Applied before the first frame the
107
+ * same texture draws, and parity scores 0.001.
108
108
  */
109
109
  #post: ReturnType<typeof setupPost> | undefined;
110
110
  #environmentSample: IEnvironmentSample | undefined;
111
111
  #materialLighting: ReturnType<typeof createMaterialLighting> | undefined;
112
112
  #lightingGeneration = 0;
113
113
 
114
- override load(ctx: GameCtx): void {
114
+ override async load(ctx: GameCtx): Promise<void> {
115
115
  const generation = ++this.#lightingGeneration;
116
- void ctx.assets.texture("sky.jpg").then(async (texture) => {
117
- if (generation !== this.#lightingGeneration) return;
118
- this.#sky = texture;
119
- const scene = ctx.scene;
120
- if (scene === undefined) return;
121
- setupSky(scene, texture);
122
- const controller = this.#materialLighting;
123
- const sample = await sampleEnvironment(ctx.renderer.raw, scene, {
124
- web: getPlatform().runtime === "web",
125
- rendererKind: ctx.renderer.kind,
126
- webglFallback: isWebGLFallbackRenderer(ctx.renderer.raw),
127
- mobile: isMobile(),
128
- software: ctx.renderer.softwareAdapter !== undefined,
129
- });
130
- if (generation !== this.#lightingGeneration || ctx.scene !== scene) return;
131
- this.#environmentSample = sample;
132
- // A cached sky may start sampling before enter creates the receiver controller.
133
- // A controller that already existed when sampling began must still be the same one.
134
- const currentController = this.#materialLighting;
135
- if (
136
- currentController !== undefined &&
137
- (controller === undefined || controller === currentController)
138
- )
139
- currentController.setEnvironmentMeasurement(
140
- sample.measurement,
141
- sample.source,
142
- sample.intensity,
143
- sample,
144
- );
116
+ // Only the photo-sky override reads the photograph; the atmosphere sky is computed.
117
+ const texture = SKY_OPTIONS.sky === "photo" ? await ctx.assets.texture("sky.jpg") : undefined;
118
+ if (generation !== this.#lightingGeneration) return;
119
+ this.#sky = texture;
120
+ const scene = ctx.scene;
121
+ if (scene === undefined) return;
122
+ setupSky(scene, texture, ctx.renderer.softwareAdapter !== undefined);
123
+ // The measurement is not awaited: it reads the GPU back and must not hold the first frame.
124
+ void this.#sampleSky(ctx, scene, generation);
125
+ }
126
+
127
+ async #sampleSky(
128
+ ctx: GameCtx,
129
+ scene: NonNullable<GameCtx["scene"]>,
130
+ generation: number,
131
+ ): Promise<void> {
132
+ const controller = this.#materialLighting;
133
+ const sample = await sampleEnvironment(ctx.renderer.raw, scene, {
134
+ web: getPlatform().runtime === "web",
135
+ rendererKind: ctx.renderer.kind,
136
+ webglFallback: isWebGLFallbackRenderer(ctx.renderer.raw),
137
+ mobile: isMobile(),
138
+ software: ctx.renderer.softwareAdapter !== undefined,
145
139
  });
140
+ if (generation !== this.#lightingGeneration || ctx.scene !== scene) return;
141
+ this.#environmentSample = sample;
142
+ // A cached sky may start sampling before enter creates the receiver controller.
143
+ // A controller that already existed when sampling began must still be the same one.
144
+ const currentController = this.#materialLighting;
145
+ if (
146
+ currentController !== undefined &&
147
+ (controller === undefined || controller === currentController)
148
+ )
149
+ currentController.setEnvironmentMeasurement(
150
+ sample.measurement,
151
+ sample.source,
152
+ sample.intensity,
153
+ sample,
154
+ );
146
155
  }
147
156
 
148
157
  override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
149
- if (this.#sky === undefined) setupSky(ctx.scene, undefined);
158
+ if (this.#sky === undefined && SKY_OPTIONS.sky === "photo")
159
+ setupSky(ctx.scene, undefined, ctx.renderer.softwareAdapter !== undefined);
150
160
  const lighting = setupLighting(
151
161
  ctx.scene,
152
162
  ctx.renderer.raw as Parameters<typeof setupLighting>[1],
@@ -257,7 +267,7 @@ export class Race extends Scene<GameState, IPhysicsContext> {
257
267
  touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
258
268
  );
259
269
  rival.update(dt);
260
- sector.update(car.body.position, car.forward, dt, car.speed);
270
+ sector.update(car.body.position, car.forward, dt, car.speed, car.driving);
261
271
  if (sector.rescue(car)) {
262
272
  rescues += 1;
263
273
  rescuePositionError = quantize(
@@ -315,7 +325,8 @@ export class Race extends Scene<GameState, IPhysicsContext> {
315
325
  void frameCtx.goto("race");
316
326
  return;
317
327
  }
318
- elapsed += dt;
328
+ // The race clock stops with the race, so the outcome panel reads the finishing time.
329
+ if (status === "RACING") elapsed += dt;
319
330
  advanceRace(frameCtx, dt);
320
331
  const ranked = rankRace();
321
332
  const player = playerRanking(ranked);
@@ -67,14 +67,17 @@ export class TrackSector {
67
67
  * `speed` is the car's measured speed in m/s. It is what makes a **beached** car recoverable: a
68
68
  * ray-cast chassis that has nosed into a barrier is still standing on the road, so the off-road
69
69
  * ray keeps hitting and a car pinned against a hoarding would sit there for the rest of the race.
70
+ * `driving` says the engine is pushing: only a car that is driven and still not moving is beached.
71
+ * A car the player brought to a stop is parked, and four rescues of a parked car end the race.
70
72
  */
71
- update(position: Vector3, heading: Vector3, dt: number, speed = 0): boolean {
73
+ update(position: Vector3, heading: Vector3, dt: number, speed = 0, driving = true): boolean {
72
74
  if (!Number.isFinite(dt) || dt < 0)
73
75
  throw new Error("TrackSector.update requires a finite non-negative dt.");
74
76
  if (Math.abs(speed) >= this.#stallSpeed) {
75
77
  this.#stalledTime = 0;
76
78
  this.#hasMoved = true;
77
- } else if (this.#hasMoved) this.#stalledTime += dt;
79
+ } else if (!driving) this.#stalledTime = 0;
80
+ else if (this.#hasMoved) this.#stalledTime += dt;
78
81
  const origin = this.#origin.copy(position);
79
82
  origin.y += this.#rayHeight;
80
83
  const hit = this.#intersectRay(origin, this.#direction, this.#rayHeight + 2);
@@ -19,7 +19,7 @@ export function Hud() {
19
19
  return (
20
20
  <div className="pointer-events-none absolute inset-0 p-6 text-[11px] uppercase tracking-[0.16em] text-text">
21
21
  <div className="flex items-start justify-between">
22
- <div>
22
+ <div className="-m-3 bg-panel p-3">
23
23
  <div className="text-[10px] text-muted">circuit / northern loop</div>
24
24
  <div className="mt-2 flex items-baseline gap-5 text-[18px] text-white">
25
25
  <span>
@@ -31,18 +31,18 @@ export function Hud() {
31
31
  </span>
32
32
  </div>
33
33
  </div>
34
- <div className="text-right">
34
+ <div className="-m-3 bg-panel p-3 text-right">
35
35
  <div className="text-[10px] text-muted">position</div>
36
36
  <div className="mt-2 text-[22px] text-white" id="position">
37
37
  P{state.place}
38
38
  </div>
39
39
  </div>
40
40
  </div>
41
- <div className="absolute bottom-6 left-6 flex items-end gap-8">
41
+ <div className="absolute bottom-6 left-6 -m-3 flex items-end gap-8 bg-panel p-3">
42
42
  <div>
43
43
  <div className="text-[10px] text-muted">speed</div>
44
44
  <div className="mt-1 text-[26px] leading-none text-white">
45
- <span id="speed">{Math.round(state.speed * 10)}</span>
45
+ <span id="speed">{Math.round(state.speed * 3.6)}</span>
46
46
  <span className="text-[11px] text-muted"> km/h</span>
47
47
  </div>
48
48
  </div>
@@ -55,15 +55,20 @@ export function Hud() {
55
55
  <div className={state.boostActive ? "text-accent" : "text-muted"}>
56
56
  <div className="text-[10px]">boost</div>
57
57
  <div className="mt-1 text-[18px] leading-none" id="boost">
58
- {state.boostActive ? "ACTIVE" : `${state.boostUses} READY`}
58
+ {state.boostActive ? "ACTIVE" : "READY"}
59
59
  </div>
60
60
  </div>
61
61
  </div>
62
62
  {state.raceStatus !== "RACING" && (
63
63
  <div
64
- className={`absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 border px-8 py-5 text-center ${state.raceStatus === "WON" ? "border-win/70 bg-win/10" : "border-danger/70 bg-danger/10"}`}
64
+ className={`absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 border px-8 py-5 text-center ${state.raceStatus === "WON" ? "border-win/70 bg-panel" : "border-danger/70 bg-panel"}`}
65
65
  >
66
- <div className={`text-[28px] tracking-[0.28em] ${statusClass}`}>{state.raceStatus}</div>
66
+ <div className={`text-[28px] tracking-[0.28em] ${statusClass}`} id="outcome">
67
+ {/* Every lap done behind the rival is a loss, but not a "did not finish": name the place. */}
68
+ {state.raceStatus === "DNF" && state.completedLaps >= state.totalLaps
69
+ ? `P${state.place}`
70
+ : state.raceStatus}
71
+ </div>
67
72
  <div className="mt-2 text-[10px] text-muted">press R to restart</div>
68
73
  </div>
69
74
  )}
@@ -14,6 +14,10 @@ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
14
14
  command = "node"
15
15
  args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
16
16
 
17
- [mcp_servers.threenative-blender]
17
+ [mcp_servers.threenative-animation]
18
18
  command = "node"
19
- args = ["./node_modules/@threenative/core/mcp/blender.mjs"]
19
+ args = ["./node_modules/@threenative/core/mcp/animation.mjs"]
20
+
21
+ [mcp_servers.threenative-devtools]
22
+ command = "node"
23
+ args = ["./node_modules/@threenative/core/mcp/devtools.mjs"]
@@ -22,10 +22,16 @@
22
22
  "./node_modules/@threenative/core/mcp/engine.mjs"
23
23
  ]
24
24
  },
25
- "threenative-blender": {
25
+ "threenative-animation": {
26
26
  "command": "node",
27
27
  "args": [
28
- "./node_modules/@threenative/core/mcp/blender.mjs"
28
+ "./node_modules/@threenative/core/mcp/animation.mjs"
29
+ ]
30
+ },
31
+ "threenative-devtools": {
32
+ "command": "node",
33
+ "args": [
34
+ "./node_modules/@threenative/core/mcp/devtools.mjs"
29
35
  ]
30
36
  }
31
37
  }