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,444 @@
1
+ // Generated for you. Plain maths, edit or delete it freely: the sky the sun lights, in the sun's own units.
2
+ //
3
+ // Unreal's default level draws its sky from the Sky Atmosphere, lights the scene with a Sky Light
4
+ // that captures it, and tints the sun by the air the sun passes through. All three read ONE sun
5
+ // illuminance, so the sun-to-sky ratio is a consequence of the model and not a constant. This file
6
+ // ports that model: single scattering with Rayleigh and Mie phase functions, an ozone absorption
7
+ // layer, a ground bounce, and the isotropic multiple-scattering approximation (Hillaire, "A
8
+ // Scalable and Production Ready Sky and Atmosphere Rendering Technique", EGSR 2020, the paper the
9
+ // Unreal atmosphere implements). Coefficients are Unreal 5.8.3's defaults, read from
10
+ // Engine/Source/Runtime/Engine/Private/Components/SkyAtmosphereComponent.cpp:95-128 and checked
11
+ // against tools/unreal-reference/template-actors.json. The integration structure follows
12
+ // Engine/Shaders/Private/SkyAtmosphere.usf (IntegrateSingleScatteredLuminance and the multiple
13
+ // scattering pass) and the phase functions in ParticipatingMediaCommon.ush.
14
+ //
15
+ // Units: every radiance below is per unit sun illuminance (1.0 outside the atmosphere). Multiply
16
+ // by the sun's illuminance in the scene's light units (lighting.ts) to get scene radiance, so the
17
+ // sun and the sky can never disagree about exposure.
18
+ //
19
+ // Plain numbers and no `three` import: the same code runs under node for the unit check.
20
+ // ponytail: direct numerical integration at load (about a second at 256x128). A transmittance LUT,
21
+ // or core's `SkyCapture` once its sky-view LUT is physical, replaces the inner loops.
22
+
23
+ export type Rgb = readonly [number, number, number];
24
+ type Vec3 = readonly [number, number, number];
25
+
26
+ export const BOTTOM_KM = 6360;
27
+ export const TOP_KM = 6420;
28
+ export const RAYLEIGH: Rgb = [0.005802, 0.013558, 0.0331]; // per km at sea level
29
+ export const MIE_SCATTER = 0.003996;
30
+ export const MIE_ABSORB = 0.000444;
31
+ export const OZONE: Rgb = [0.00065, 0.001881, 0.000085];
32
+ export const MIE_G = 0.8;
33
+ export const GROUND_ALBEDO = 0.4; // 170/255 sRGB, linear
34
+ export const CAMERA_KM = 0.06; // the reference floor sits 60 m above the planet top
35
+ const FOUR_PI = 4 * Math.PI;
36
+
37
+ const rayleighPhase = (c: number): number => (3 / (16 * Math.PI)) * (1 + c * c);
38
+ const hgPhase = (c: number): number =>
39
+ (1 - MIE_G * MIE_G) / (FOUR_PI * (1 + MIE_G * MIE_G - 2 * MIE_G * c) ** 1.5);
40
+
41
+ const dot = (a: Vec3, b: Vec3): number => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
42
+
43
+ interface IMedium {
44
+ ray: Rgb;
45
+ mie: number;
46
+ ext: Rgb;
47
+ }
48
+
49
+ function medium(h: number): IMedium {
50
+ const ray = Math.exp(-h / 8);
51
+ const mie = Math.exp(-h / 1.2);
52
+ const ozone = Math.max(0, Math.min(1, h < 25 ? h / 15 - 2 / 3 : -h / 15 + 8 / 3));
53
+ const e = (i: 0 | 1 | 2): number =>
54
+ RAYLEIGH[i] * ray + (MIE_SCATTER + MIE_ABSORB) * mie + OZONE[i] * ozone;
55
+ return {
56
+ ray: [RAYLEIGH[0] * ray, RAYLEIGH[1] * ray, RAYLEIGH[2] * ray],
57
+ mie: MIE_SCATTER * mie,
58
+ ext: [e(0), e(1), e(2)],
59
+ };
60
+ }
61
+
62
+ /** Distance from a point at radius `r`, heading with cosine `mu` to the local up, to a sphere. */
63
+ function hitSphere(r: number, mu: number, radius: number, far: boolean): number | undefined {
64
+ const b = r * mu;
65
+ const disc = b * b - (r * r - radius * radius);
66
+ if (disc < 0) return undefined;
67
+ const t = far ? -b + Math.sqrt(disc) : -b - Math.sqrt(disc);
68
+ return t >= 0 ? t : undefined;
69
+ }
70
+
71
+ /**
72
+ * Optical depth from a point to the top of the atmosphere; undefined when the planet blocks the way.
73
+ * Unreal stores this in its transmittance LUT, ten samples a ray (r.SkyAtmosphere.TransmittanceLUT.SampleCount).
74
+ */
75
+ function opticalDepthToTop(r: number, mu: number): Rgb | undefined {
76
+ if (mu < 0 && hitSphere(r, mu, BOTTOM_KM, false) !== undefined) return undefined;
77
+ const length = hitSphere(r, mu, TOP_KM, true) ?? 0;
78
+ const sum: [number, number, number] = [0, 0, 0];
79
+ for (const { from, to, at } of linear(10)(length)) {
80
+ const m = medium(Math.max(0, Math.sqrt(r * r + 2 * r * mu * at + at * at) - BOTTOM_KM));
81
+ for (let c = 0; c < 3; c += 1) sum[c] = (sum[c] ?? 0) + m.ext[c as 0 | 1 | 2] * (to - from);
82
+ }
83
+ return sum;
84
+ }
85
+
86
+ /** Fraction of the sun's illuminance that reaches the ground, per channel. */
87
+ export function sunTransmittance(elevationRad: number): Rgb {
88
+ const depth = opticalDepthToTop(BOTTOM_KM + CAMERA_KM, Math.sin(elevationRad));
89
+ if (depth === undefined) return [0, 0, 0];
90
+ return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
91
+ }
92
+
93
+ /**
94
+ * The colour Unreal gives the sun light itself (FAtmosphereSetup::GetTransmittanceAtGroundLevel,
95
+ * Engine/Source/Runtime/Engine/Private/Components/SkyAtmosphere*): a CPU estimate, not the exact
96
+ * integral. It starts 500 m above the planet, sums 15 equal segments by their start point (the
97
+ * rule over-counts the dense low air) and has no minimum elevation (TransmittanceMinLightElevationAngle
98
+ * is -90). The sky itself reads the transmittance LUT (`sunTransmittance`), so the two differ.
99
+ */
100
+ export function sunLightTransmittance(elevationRad: number): Rgb {
101
+ const f = Math.fround;
102
+ const r0 = BOTTOM_KM + 0.5;
103
+ const mu = Math.sin(elevationRad);
104
+ const tMax = hitSphere(r0, mu, TOP_KM, true) ?? 0;
105
+ const depth: [number, number, number] = [0, 0, 0];
106
+ const step = f(1 / 15);
107
+ for (let t = 0; t < 1; t = f(t + step)) {
108
+ const along = tMax * t;
109
+ const h = Math.max(0, Math.sqrt(r0 * r0 + 2 * r0 * mu * along + along * along) - BOTTOM_KM);
110
+ const m = medium(h);
111
+ for (let c = 0; c < 3; c += 1) depth[c] = (depth[c] ?? 0) + m.ext[c as 0 | 1 | 2] * step * tMax;
112
+ }
113
+ return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
114
+ }
115
+
116
+ /** Fraction of the sun's illuminance that reaches radius `r` where the sun's cosine to local up is `mu`. */
117
+ export function transmittanceToTop(r: number, mu: number): Rgb {
118
+ const depth = opticalDepthToTop(r, mu);
119
+ if (depth === undefined) return [0, 0, 0];
120
+ return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
121
+ }
122
+
123
+ type Multi = (heightKm: number, cosSun: number) => Rgb;
124
+
125
+ /** One ray segment: it spans [from, to] in kilometres and its medium is read at `at`. */
126
+ interface ISegment {
127
+ from: number;
128
+ to: number;
129
+ at: number;
130
+ }
131
+ type Sampling = (tMax: number) => ISegment[];
132
+
133
+ /** Unreal's fixed march (the transmittance, multiple-scattering and distant sky light passes): equal segments, read `offset` of the way in. */
134
+ const linear =
135
+ (steps: number, offset = 0.3): Sampling =>
136
+ (tMax) =>
137
+ Array.from({ length: steps }, (_, i) => ({
138
+ from: (tMax * i) / steps,
139
+ to: (tMax * (i + 1)) / steps,
140
+ at: (tMax * (i + offset)) / steps,
141
+ }));
142
+
143
+ /**
144
+ * Unreal's sky-view march (SamplingSetup.VariableSampleCount in SkyAtmosphere.usf): the count grows
145
+ * from `min` to `max` with the distance, the segments grow with the square of it, and the last one
146
+ * runs on to the end of the ray.
147
+ */
148
+ const variable =
149
+ (min: number, max: number, distanceKm: number, offset = 0.3): Sampling =>
150
+ (tMax) => {
151
+ const count = min + (max - min) * Math.min(1, Math.max(0, tMax / distanceKm));
152
+ const whole = Math.floor(count);
153
+ const tMaxWhole = (tMax * whole) / count;
154
+ return Array.from({ length: Math.ceil(count) }, (_, i) => {
155
+ const [u0, u1] = [(i / whole) ** 2, ((i + 1) / whole) ** 2];
156
+ const from = tMaxWhole * u0;
157
+ const to = u1 > 1 ? tMax : tMaxWhole * u1;
158
+ return { from, to, at: from + (to - from) * offset };
159
+ });
160
+ };
161
+
162
+ interface IGather {
163
+ radiance: [number, number, number];
164
+ /** Integral of the scattering coefficient along the ray, attenuated: the transfer factor. */
165
+ transfer: [number, number, number];
166
+ }
167
+
168
+ /**
169
+ * One view ray from (0, r0, 0) along `dir`, the planet at the origin and `sun` a unit vector.
170
+ * `iso` swaps the phase functions for the isotropic one, as the multiple-scattering pass does.
171
+ * `multi` adds the multiple-scattering luminance at each sample.
172
+ */
173
+ function march(
174
+ r0: number,
175
+ dir: Vec3,
176
+ sun: Vec3,
177
+ iso: boolean,
178
+ multi: Multi | undefined,
179
+ ground: boolean,
180
+ sampling: Sampling,
181
+ ): IGather {
182
+ const out: IGather = { radiance: [0, 0, 0], transfer: [0, 0, 0] };
183
+ const mu0 = dir[1];
184
+ const groundT = mu0 < 0 ? hitSphere(r0, mu0, BOTTOM_KM, false) : undefined;
185
+ const tMax = groundT ?? hitSphere(r0, mu0, TOP_KM, true) ?? 0;
186
+ const cosView = dot(dir, sun);
187
+ const phaseRay = iso ? 1 / FOUR_PI : rayleighPhase(cosView);
188
+ const phaseMie = iso ? 1 / FOUR_PI : hgPhase(cosView);
189
+ const through: [number, number, number] = [1, 1, 1];
190
+ const at = (t: number): Vec3 => [dir[0] * t, r0 + dir[1] * t, dir[2] * t];
191
+ for (const { from, to, at: mid } of sampling(tMax)) {
192
+ const dt = to - from;
193
+ const p = at(mid);
194
+ const rr = Math.hypot(p[0], p[1], p[2]);
195
+ const cosSun = dot(p, sun) / rr;
196
+ const m = medium(Math.max(0, rr - BOTTOM_KM));
197
+ const depth = opticalDepthToTop(rr, cosSun);
198
+ const ms = multi?.(Math.max(0, rr - BOTTOM_KM), cosSun);
199
+ for (let c = 0; c < 3; c += 1) {
200
+ const k = c as 0 | 1 | 2;
201
+ const e = m.ext[k];
202
+ const scatter = m.ray[k] + m.mie;
203
+ const stepT = Math.exp(-e * dt);
204
+ let source = 0;
205
+ if (depth !== undefined)
206
+ source += Math.exp(-depth[k]) * (m.ray[k] * phaseRay + m.mie * phaseMie);
207
+ if (ms !== undefined) source += ms[k] * scatter;
208
+ const integral = e > 1e-12 ? (1 - stepT) / e : dt;
209
+ out.radiance[c] = (out.radiance[c] ?? 0) + (through[c] ?? 1) * source * integral;
210
+ out.transfer[c] = (out.transfer[c] ?? 0) + (through[c] ?? 1) * scatter * integral;
211
+ through[c] = (through[c] ?? 1) * stepT;
212
+ }
213
+ }
214
+ // The sky pass draws no ground luminance (Unreal's sky render passes Ground = false), so the nadir
215
+ // is only the in-scatter up to the planet, near black. The multiple-scattering pass does bounce
216
+ // light off the ground (Ground = true), so `iso` keeps it.
217
+ if (ground && groundT !== undefined) {
218
+ const p = at(groundT);
219
+ const rr = Math.hypot(p[0], p[1], p[2]);
220
+ const cosSun = dot(p, sun) / rr;
221
+ const depth = opticalDepthToTop(rr, cosSun);
222
+ if (depth !== undefined && cosSun > 0)
223
+ for (let c = 0; c < 3; c += 1)
224
+ out.radiance[c] =
225
+ (out.radiance[c] ?? 0) +
226
+ (through[c] ?? 1) * Math.exp(-depth[c as 0 | 1 | 2]) * cosSun * (GROUND_ALBEDO / Math.PI);
227
+ }
228
+ return out;
229
+ }
230
+
231
+ /**
232
+ * Multiple-scattering luminance per unit scattering coefficient, by altitude and the cosine
233
+ * between the local up and the sun: Psi = L2 / (1 - f), the isotropic infinite-bounce sum.
234
+ * Unreal gathers L2 and f from two rays only, straight up and straight down (the shipped "cheap"
235
+ * approximation in RenderMultiScatteredLuminanceLutCS); the full sphere gather overestimated the
236
+ * ground bounce against the Unreal frames by up to 1.6x, so this uses the same two rays.
237
+ */
238
+ function multipleScatteringTable(): Multi {
239
+ const nh = 12;
240
+ const nc = 16;
241
+ const dirs: Vec3[] = [
242
+ [0, 1, 0],
243
+ [0, -1, 0],
244
+ ];
245
+ const table: Rgb[] = [];
246
+ for (let ih = 0; ih < nh; ih += 1) {
247
+ const h = ((ih + 0.5) / nh) ** 2 * (TOP_KM - BOTTOM_KM);
248
+ for (let ic = 0; ic < nc; ic += 1) {
249
+ const cosSun = -1 + (2 * (ic + 0.5)) / nc;
250
+ const sun: Vec3 = [Math.sqrt(1 - cosSun * cosSun), cosSun, 0];
251
+ const sum = [0, 0, 0];
252
+ const transfer = [0, 0, 0];
253
+ for (const dir of dirs) {
254
+ const ray = march(BOTTOM_KM + h, dir, sun, true, undefined, true, linear(15));
255
+ for (let c = 0; c < 3; c += 1) {
256
+ sum[c] = (sum[c] ?? 0) + (ray.radiance[c] ?? 0);
257
+ transfer[c] = (transfer[c] ?? 0) + (ray.transfer[c] ?? 0);
258
+ }
259
+ }
260
+ table.push(
261
+ [0, 1, 2].map((c) => {
262
+ const l2 = (sum[c] ?? 0) / dirs.length;
263
+ const f = Math.min(0.99, (transfer[c] ?? 0) / dirs.length);
264
+ return l2 / (1 - f);
265
+ }) as unknown as Rgb,
266
+ );
267
+ }
268
+ }
269
+ return (h, cosSun) => {
270
+ const u = Math.min(
271
+ nh - 1,
272
+ Math.max(0, Math.sqrt(Math.max(0, h) / (TOP_KM - BOTTOM_KM)) * nh - 0.5),
273
+ );
274
+ const v = Math.min(nc - 1, Math.max(0, ((cosSun + 1) / 2) * nc - 0.5));
275
+ const [u0, v0] = [Math.floor(u), Math.floor(v)];
276
+ const [u1, v1] = [Math.min(nh - 1, u0 + 1), Math.min(nc - 1, v0 + 1)];
277
+ const [fu, fv] = [u - u0, v - v0];
278
+ const cell = (i: number, j: number): Rgb => table[i * nc + j] as Rgb;
279
+ return [0, 1, 2].map((c) => {
280
+ const k = c as 0 | 1 | 2;
281
+ const a = cell(u0, v0)[k] * (1 - fv) + cell(u0, v1)[k] * fv;
282
+ const b = cell(u1, v0)[k] * (1 - fv) + cell(u1, v1)[k] * fv;
283
+ return a * (1 - fu) + b * fu;
284
+ }) as unknown as Rgb;
285
+ };
286
+ }
287
+
288
+ /**
289
+ * Unreal's distant sky light: the mean radiance over the whole sphere seen from `altitudeKm`
290
+ * (r.SkyAtmosphere.DistantSkyLightLUT.Altitude, 6 km), isotropic phase, no ground bounce, the
291
+ * multiple-scattering term included (RenderDistantSkyLightLutCS in
292
+ * Engine/Shaders/Private/SkyAtmosphere.usf). Height fog and volumetric clouds both light with it
293
+ * (GetViewDistanceSkyLightColor). Per unit sun illuminance, like `bakeSkyRadiance`.
294
+ */
295
+ const DISTANT_SKY_LIGHT_ALTITUDE_KM = 6;
296
+ /**
297
+ * Unreal's distant sky light shader: one 8 x 8 group, one stratified direction a thread, ten linear
298
+ * samples a ray (RenderDistantSkyLightLutCS). The directions come from a seeded linear congruential
299
+ * stream (0xDE4DC0DE, GUniformSphereSamplesBuffer in SkyAtmosphereRendering.cpp), so the coarse
300
+ * result is one fixed draw, not a mean; the same draw is reproduced here.
301
+ */
302
+ const DISTANT_GROUP = 8;
303
+ function distantDirections(): Vec3[] {
304
+ let seed = 0xde4dc0de;
305
+ const fraction = (): number => {
306
+ seed = (Math.imul(seed, 196314165) + 907633515) >>> 0;
307
+ return (seed >>> 9) / 8388608;
308
+ };
309
+ const dirs: Vec3[] = new Array(DISTANT_GROUP * DISTANT_GROUP);
310
+ for (let i = 0; i < DISTANT_GROUP; i += 1) {
311
+ for (let j = 0; j < DISTANT_GROUP; j += 1) {
312
+ const up = 1 - (2 * (i + fraction())) / DISTANT_GROUP;
313
+ const phi = (2 * Math.PI * (j + fraction())) / DISTANT_GROUP;
314
+ const ring = Math.sqrt(1 - up * up);
315
+ dirs[j * DISTANT_GROUP + i] = [ring * Math.cos(phi), up, ring * Math.sin(phi)];
316
+ }
317
+ }
318
+ return dirs;
319
+ }
320
+ function distantSkyLight(toSun: { x: number; y: number; z: number }): Rgb {
321
+ const sun: Vec3 = [toSun.x, toSun.y, toSun.z];
322
+ const multi = multipleScatteringTable();
323
+ const dirs = distantDirections();
324
+ const sum: [number, number, number] = [0, 0, 0];
325
+ for (const dir of dirs) {
326
+ const ray = march(
327
+ BOTTOM_KM + DISTANT_SKY_LIGHT_ALTITUDE_KM,
328
+ dir,
329
+ sun,
330
+ true,
331
+ multi,
332
+ false,
333
+ linear(10),
334
+ );
335
+ for (let c = 0; c < 3; c += 1) sum[c] = (sum[c] ?? 0) + (ray.radiance[c] ?? 0) / dirs.length;
336
+ }
337
+ return sum;
338
+ }
339
+
340
+ /**
341
+ * The light height fog and clouds take from the sky, per unit sun illuminance: Unreal's distant sky
342
+ * light (GetViewDistanceSkyLightColor). It needs no fit. The 0.76 / 0.871 / 0.941 factors that stood
343
+ * here made up for a finer march than Unreal's own, ten samples a ray from one fixed 8 x 8 draw of
344
+ * directions (`distantSkyLight`); the same march agrees with the Unreal L3 void within 2.4 percent in
345
+ * green and blue at 15 and 60 degrees, and within 0.6 percent in red at 15 degrees. Red stays 10 percent
346
+ * high at 60 degrees, the same excess the clear sky shows at a high sun (open, PRD-633).
347
+ */
348
+ export function viewDistanceSkyLight(toSun: { x: number; y: number; z: number }): Rgb {
349
+ return distantSkyLight(toSun);
350
+ }
351
+
352
+ /**
353
+ * Sky radiance per unit sun illuminance on an equirectangular grid in three's layout: row 0 is the
354
+ * zenith, the middle row the horizon, the last row the nadir, and u = atan2(z, x) / 2pi + 0.5. `sun`
355
+ * is the unit direction toward the sun, y up.
356
+ *
357
+ * Below the horizon it draws the atmosphere's sunlit ground (albedo `GROUND_ALBEDO`, the term
358
+ * Unreal's multiple-scattering pass uses), where Unreal's own sky capture is near black. Unreal's
359
+ * default level fills that half with Lumen: the floor bounces sun into shadow sides and a mirror
360
+ * reflects it. This environment is the only indirect light the templates have, so the ground stands
361
+ * in for that bounce; without it shadow sides read navy and a chrome ball's lower half black (judge,
362
+ * PRD-633). `ground` false draws Unreal's dark nadir, for a game with its own global illumination.
363
+ */
364
+ export function bakeSkyRadiance(
365
+ toSun: { x: number; y: number; z: number },
366
+ width: number,
367
+ height: number,
368
+ ground: boolean,
369
+ ): Float32Array {
370
+ const sun: Vec3 = [toSun.x, toSun.y, toSun.z];
371
+ const multi = multipleScatteringTable();
372
+ const data = new Float32Array(width * height * 3);
373
+ const r0 = BOTTOM_KM + CAMERA_KM;
374
+ for (let y = 0; y < height; y += 1) {
375
+ const elevation = Math.PI / 2 - ((y + 0.5) / height) * Math.PI;
376
+ for (let x = 0; x < width; x += 1) {
377
+ // three's equirectangular lookup: u = atan2(z, x) / 2pi + 0.5.
378
+ const azimuth = ((x + 0.5) / width - 0.5) * 2 * Math.PI;
379
+ const dir: Vec3 = [
380
+ Math.cos(azimuth) * Math.cos(elevation),
381
+ Math.sin(elevation),
382
+ Math.sin(azimuth) * Math.cos(elevation),
383
+ ];
384
+ const ray = march(r0, dir, sun, false, multi, ground, variable(4, 32, 150));
385
+ const o = (y * width + x) * 3;
386
+ data[o] = ray.radiance[0];
387
+ data[o + 1] = ray.radiance[1];
388
+ data[o + 2] = ray.radiance[2];
389
+ }
390
+ }
391
+ return data;
392
+ }
393
+
394
+ /** The default level's sun: 6 lux, 6500 K (tools/unreal-reference/template-actors.json, every sun). */
395
+ const SUN_LUX = 6;
396
+ export const SUN_KELVIN = 6500;
397
+
398
+ /**
399
+ * The sun in three's light units. Unreal renders a lit diffuse surface as albedo x lux x cos(theta);
400
+ * three's Lambert BRDF carries a 1/pi, so the same lux is pi times as large here. Measured on the
401
+ * Unreal L1 cells (no atmosphere, scene-linear EXR): a 0.18 floor under the 60 degree sun reads
402
+ * 0.874 luminance, within 7% of 0.18 x 6 x sin(60 deg) = 0.935 (the residual is checked on the
403
+ * engine's own L1 capture).
404
+ */
405
+ export const SUN_ILLUMINANCE = SUN_LUX * Math.PI;
406
+
407
+ /**
408
+ * Sky radiance relative to the sun, as Unreal renders it. TEMPORARY, measured and not derived: with
409
+ * the sun at 6 lux the model above is 1.3x too bright against the Unreal L2 frames, flat across
410
+ * channels and across the 15 and 4 degree suns (1.30 / 1.30 / 1.35 at 19 degrees elevation), so
411
+ * the sky is scaled by 1/1.3. The lens attenuation constant 0.78 (PostProcessEyeAdaptation.cpp,
412
+ * r.EyeAdaptation.LensAttenuation) has the right size but the path that would apply it to the
413
+ * atmosphere and not to the sun is not found in the source yet.
414
+ */
415
+ export const SKY_TO_SUN = 0.78;
416
+
417
+ /**
418
+ * Colour of a black-body-like light at `kelvin` as linear sRGB with unit luminance: the Planckian
419
+ * locus fit in the CIE 1960 UCS plane (Krystek 1985) that Unreal uses for a light's temperature
420
+ * (Engine/Source/Runtime/Core/Private/Math/Color.cpp, MakeFromColorTemperature), then XYZ to BT.709.
421
+ */
422
+ export function temperatureColour(kelvin: number): Rgb {
423
+ const t = Math.min(15000, Math.max(1000, kelvin));
424
+ const u =
425
+ (0.860117757 + 1.54118254e-4 * t + 1.28641212e-7 * t * t) /
426
+ (1 + 8.42420235e-4 * t + 7.08145163e-7 * t * t);
427
+ const v =
428
+ (0.317398726 + 4.22806245e-5 * t + 4.20481691e-8 * t * t) /
429
+ (1 - 2.89741816e-5 * t + 1.61456053e-7 * t * t);
430
+ const d = 2 * u - 8 * v + 4;
431
+ const x = (3 * u) / d;
432
+ const y = (2 * v) / d;
433
+ const [bx, bz] = [x / y, (1 - x - y) / y];
434
+ return [
435
+ Math.max(0, 3.2404542 * bx - 1.5371385 - 0.4985314 * bz),
436
+ Math.max(0, -0.969266 * bx + 1.8760108 + 0.041556 * bz),
437
+ Math.max(0, 0.0556434 * bx - 0.2040259 + 1.0572252 * bz),
438
+ ];
439
+ }
440
+
441
+ /** The scene's sun light, registered by `setupLighting` so `setupSky` can tint it by the air. */
442
+ export const sunLight: {
443
+ current?: { color: { setRGB(r: number, g: number, b: number): unknown } };
444
+ } = {};
@@ -5,7 +5,6 @@ import {
5
5
  type DirectionalLight,
6
6
  Material,
7
7
  type MeshStandardMaterial,
8
- type Object3D,
9
8
  type Scene,
10
9
  Vector3,
11
10
  } from "three";
@@ -75,41 +74,73 @@ export function backlightMaterial(source: MeshStandardMaterial, controls: IBackl
75
74
  return material;
76
75
  }
77
76
 
77
+ interface IRenderFrame {
78
+ readonly renderId?: number;
79
+ readonly frameId?: number;
80
+ readonly camera?: Camera | null;
81
+ }
82
+
78
83
  function createGraph(controls: IBacklightControls) {
79
- const rimGain = uniform(controls.rimGain).onRenderUpdate(() => {
84
+ // One render validates the controls and resolves the key once for all eight uniforms: each read can
85
+ // be a native bridge call, and a render reads the same values throughout.
86
+ let checkedFrame: IRenderFrame | undefined;
87
+ let checkedRender: number | undefined;
88
+ const check = (frame: IRenderFrame) => {
89
+ const render = frame.renderId ?? frame.frameId;
90
+ if (frame === checkedFrame && render === checkedRender) return;
80
91
  validateControls(controls);
92
+ checkedFrame = frame;
93
+ checkedRender = render;
94
+ };
95
+ const keyDirectionValue = new Vector3(0, 1, 0);
96
+ const keyTargetValue = new Vector3();
97
+ let keyFrame: IRenderFrame | undefined;
98
+ let keyRender: number | undefined;
99
+ let keyGainValue = 0;
100
+ const key = (frame: IRenderFrame) => {
101
+ const render = frame.renderId ?? frame.frameId;
102
+ if (frame !== keyFrame || render !== keyRender) {
103
+ keyGainValue = resolveKey(
104
+ controls,
105
+ keyDirectionValue,
106
+ keyTargetValue,
107
+ frame.camera ?? controls.camera,
108
+ );
109
+ keyFrame = frame;
110
+ keyRender = render;
111
+ }
112
+ return keyGainValue;
113
+ };
114
+ const rimGain = uniform(controls.rimGain).onRenderUpdate((frame) => {
115
+ check(frame);
81
116
  return controls.rimGain;
82
117
  });
83
- const fillGain = uniform(0).onRenderUpdate(() => {
84
- validateControls(controls);
118
+ const fillGain = uniform(0).onRenderUpdate((frame) => {
119
+ check(frame);
85
120
  return controls.fillAdmitted ? controls.fillGain : 0;
86
121
  });
87
- const fillColor = uniform(controls.fillColor).onRenderUpdate(() => {
88
- validateControls(controls);
122
+ const fillColor = uniform(controls.fillColor).onRenderUpdate((frame) => {
123
+ check(frame);
89
124
  return controls.fillColor;
90
125
  });
91
- const fillDirection = uniform(controls.fillDirection).onRenderUpdate(() => {
92
- validateControls(controls);
126
+ const fillDirection = uniform(controls.fillDirection).onRenderUpdate((frame) => {
127
+ check(frame);
93
128
  return controls.fillDirection;
94
129
  });
95
- const fillAngularSize = uniform(controls.fillAngularSize).onRenderUpdate(() => {
96
- validateControls(controls);
130
+ const fillAngularSize = uniform(controls.fillAngularSize).onRenderUpdate((frame) => {
131
+ check(frame);
97
132
  return controls.fillAngularSize;
98
133
  });
99
- const keyColor = uniform(controls.key.color).onRenderUpdate(() => {
100
- validateControls(controls);
134
+ const keyColor = uniform(controls.key.color).onRenderUpdate((frame) => {
135
+ check(frame);
101
136
  return controls.key.color;
102
137
  });
103
- const keyDirectionValue = new Vector3(0, 1, 0);
104
- const keyTargetValue = new Vector3();
105
138
  const keyDirection = uniform(keyDirectionValue).onRenderUpdate((frame) => {
106
- resolveKey(controls, keyDirectionValue, keyTargetValue, frame.camera ?? controls.camera);
139
+ key(frame);
107
140
  return keyDirectionValue;
108
141
  });
109
142
  // Removal/visibility/intensity are live. A removed sun cannot leave an invented rim behind.
110
- const keyGain = uniform(0).onRenderUpdate((frame) =>
111
- resolveKey(controls, keyDirectionValue, keyTargetValue, frame.camera ?? controls.camera),
112
- );
143
+ const keyGain = uniform(0).onRenderUpdate((frame) => key(frame));
113
144
  const N = normalView.normalize();
114
145
  const V = positionViewDirection.normalize();
115
146
  const L = cameraViewMatrix.transformDirection(keyDirection);