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,605 @@
1
+ // Generated for you. Plain maths, edit or delete it freely: the cloud layer Unreal's default level draws.
2
+ // Model references (UE 5.8.3): Engine/Content/EngineSky/VolumetricClouds/m_SimpleVolumetricCloud
3
+ // (the default cloud material; its node graph and parameter defaults are read through the editor),
4
+ // Engine/Shaders/Private/VolumetricCloud.usf (dual HG phase, scattering octaves, sky term, shadow
5
+ // march), Engine/Source/Runtime/Engine/Private/Components/VolumetricCloudComponent.cpp (km defaults).
6
+ // Independent CPU implementation. The material samples four Unreal textures that this repository
7
+ // must not carry, so each one is regenerated here from a seeded noise whose per-channel value
8
+ // quantiles and correlation lengths match the Unreal texture (measured, see the spec).
9
+ import {
10
+ BOTTOM_KM,
11
+ CAMERA_KM,
12
+ MIE_ABSORB,
13
+ MIE_SCATTER,
14
+ RAYLEIGH,
15
+ type Rgb,
16
+ transmittanceToTop,
17
+ } from "./atmosphere.js";
18
+
19
+ const PLANET = BOTTOM_KM;
20
+ export const CLOUD_BOTTOM_KM = 5; // VolumetricCloudComponent LayerBottomAltitude in the reference level
21
+ export const CLOUD_TOP_KM = 15; // bottom + LayerHeight 10
22
+ const CAMERA = PLANET + CAMERA_KM;
23
+
24
+ /** m_SimpleVolumetricCloud parameter defaults (the instance overrides only textures). */
25
+ export const CLOUD_MATERIAL = {
26
+ layoutKm: 256, // Layout_CloudGlobalScale: the pattern repeats every 256 km
27
+ density: 0.008, // Cloud_GlobalDensity, extinction per metre
28
+ coverage: -0.2, // Cloud_GlobalCoverage
29
+ noise1Scale: [4.167, 4.444, 9.091], // Noise1_Coordinates, in volume repeats per layout tile
30
+ noise2Scale: [60, 60, 75], // Noise2_Coordinates, the distortion lookup
31
+ noiseBias: [0.5, 0.8], // Noise_Bias R (shape) and G (distortion)
32
+ noiseStrength: [0.8, 0.08], // Noise_Strength R and G
33
+ insideLayer: [0.02, 0.98], // the material returns zero in the outer 2% of the layer
34
+ albedo: 0.98, // Cloud_AlbedoColor
35
+ skyOcclusion: 0.5, // Cloud_AlbedoColor alpha, drives the sky-light term
36
+ phase: { g: 0.8, g2: 0.166667, blend: 0.575 }, // Phase_Controls
37
+ multiScatter: { contribution: 0.666667, occlusion: 0.25, eccentricity: 0.18, octaves: 2 },
38
+ } as const;
39
+ export const CLOUD_MODEL = {
40
+ viewStepMetres: 300,
41
+ minViewSteps: 32,
42
+ maxViewSteps: 192,
43
+ lightSteps: 6,
44
+ // TracingMaxDistance, taken from the layer entry point (TracingMaxDistanceMode 0, the default).
45
+ tracingKm: 200,
46
+ // TracingMaxDistance of the reference actor is 200 km (tools/unreal-reference/template-actors.json).
47
+ horizonFadeStartKm: 150,
48
+ horizonFadeEndKm: 200,
49
+ } as const;
50
+ export const PATTERN_SIZE = 256;
51
+ export const VOLUME_SIZE = 64;
52
+ // Value quantiles (17 points, 0 to 1) of T_CloudPattern R,G,B, of the volume's R and G channels.
53
+ const PATTERN_QUANTILES = [
54
+ [0, 0, 0, 0, 0, 0.012, 0.034, 0.06, 0.092, 0.13, 0.176, 0.234, 0.307, 0.405, 0.541, 0.753, 1],
55
+ [
56
+ 0, 0, 0, 0.001, 0.006, 0.021, 0.048, 0.086, 0.135, 0.193, 0.26, 0.342, 0.44, 0.562, 0.731,
57
+ 0.978, 1,
58
+ ],
59
+ [
60
+ 0, 0, 0, 0.004, 0.018, 0.036, 0.054, 0.072, 0.092, 0.113, 0.138, 0.168, 0.204, 0.248, 0.314,
61
+ 0.435, 1,
62
+ ],
63
+ ] as const;
64
+ const VOLUME_QUANTILES = [
65
+ [
66
+ -0.147, 0.309, 0.365, 0.405, 0.437, 0.464, 0.489, 0.513, 0.536, 0.558, 0.582, 0.606, 0.633,
67
+ 0.665, 0.703, 0.756, 1.071,
68
+ ],
69
+ [
70
+ 0, 0.173, 0.235, 0.282, 0.322, 0.357, 0.39, 0.42, 0.45, 0.481, 0.512, 0.545, 0.581, 0.619,
71
+ 0.666, 0.728, 1.022,
72
+ ],
73
+ ] as const;
74
+ // Cells per repeat of the pattern's base octave: sets each channel's correlation length.
75
+ const PATTERN_CELLS = [6, 15, 30] as const;
76
+ // T_Profile_08 channels as degree-4 polynomials in (altitude in layer, pattern value):
77
+ // exponents [i, j] and coefficients for u^i v^j. Fitted to the texture (rms error 0.006 to 0.012).
78
+ const PROFILE_TERMS: ReadonlyArray<readonly [number, number]> = [
79
+ [0, 0],
80
+ [0, 1],
81
+ [0, 2],
82
+ [0, 3],
83
+ [0, 4],
84
+ [1, 0],
85
+ [1, 1],
86
+ [1, 2],
87
+ [1, 3],
88
+ [2, 0],
89
+ [2, 1],
90
+ [2, 2],
91
+ [3, 0],
92
+ [3, 1],
93
+ [4, 0],
94
+ ];
95
+ const PROFILE_COEFFICIENTS = [
96
+ [
97
+ 0.3741, 0.499, -1.2672, 1.2328, -0.4107, 0.8894, 0.3392, 0.4021, -0.2367, -2.8264, -1.2088,
98
+ 0.4296, 2.6391, 0.5109, -0.8971,
99
+ ],
100
+ [
101
+ 0.2818, 0.049, -0.3788, 0.7721, -0.1495, -0.1268, 1.0841, -1.9311, 0.0666, 2.8644, 0.0744,
102
+ 1.329, -5.4491, -0.7025, 2.7003,
103
+ ],
104
+ [
105
+ 0.049, 0.0514, -0.119, 0.1602, -0.077, 0.7471, 0.0678, -0.1132, 0.0743, -1.4245, -0.0577,
106
+ -0.0141, 2.7099, 0.0675, -1.6358,
107
+ ],
108
+ ] as const;
109
+
110
+ const clamp = (v: number): number => Math.max(0, Math.min(1, v));
111
+ const smooth = (v: number): number => {
112
+ const t = clamp(v);
113
+ return t * t * (3 - 2 * t);
114
+ };
115
+ const mod = (a: number, n: number): number => ((a % n) + n) % n;
116
+
117
+ function rng(seed: number): () => number {
118
+ let state = seed | 0;
119
+ return () => {
120
+ state = (Math.imul(state, 1664525) + 1013904223) | 0;
121
+ return (state >>> 0) / 4294967296;
122
+ };
123
+ }
124
+
125
+ /**
126
+ * One axis of a periodic lattice, per voxel: the two cells it blends (wrapped), and the blend weight of
127
+ * the second (`smooth` of the fraction) with its complement. Computed once per axis position, not once
128
+ * per voxel and neighbour; the expressions are the ones the per-voxel loop used, so every float matches.
129
+ */
130
+ function latticeAxis(cells: number, size: number) {
131
+ const first = new Int32Array(size);
132
+ const second = new Int32Array(size);
133
+ const upper = new Float64Array(size);
134
+ const lower = new Float64Array(size);
135
+ for (let n = 0; n < size; n++) {
136
+ const f = ((n + 0.5) / size) * cells - 0.5;
137
+ const i = Math.floor(f);
138
+ const w = smooth(f - i);
139
+ first[n] = mod(i, cells);
140
+ second[n] = mod(i + 1, cells);
141
+ upper[n] = w;
142
+ lower[n] = 1 - w;
143
+ }
144
+ return { first, second, upper, lower };
145
+ }
146
+
147
+ /** Periodic value noise on a size^dims grid with `cells` lattice cells per axis. */
148
+ function valueNoise(cells: number, size: number, dims: 2 | 3, next: () => number): Float32Array {
149
+ const lattice = Float32Array.from({ length: cells ** dims }, next);
150
+ const out = new Float32Array(size ** dims);
151
+ const depth = dims === 3 ? size : 1;
152
+ const layers = dims === 3 ? 2 : 1;
153
+ const axis = latticeAxis(cells, size);
154
+ // Typed-array reads are in range by construction (every index is below `size`), hence the casts.
155
+ const { first, second, lower, upper } = axis;
156
+ for (let z = 0; z < depth; z++) {
157
+ for (let y = 0; y < size; y++) {
158
+ for (let x = 0; x < size; x++) {
159
+ let sum = 0;
160
+ for (let c = 0; c < layers; c++) {
161
+ const zOffset = dims === 3 ? cells * cells * ((c ? second[z] : first[z]) as number) : 0;
162
+ const wz = dims === 3 ? ((c ? upper[z] : lower[z]) as number) : 1;
163
+ for (let b = 0; b < 2; b++) {
164
+ const yOffset = cells * ((b ? second[y] : first[y]) as number);
165
+ const wy = (b ? upper[y] : lower[y]) as number;
166
+ for (let a = 0; a < 2; a++) {
167
+ const at = ((a ? second[x] : first[x]) as number) + yOffset + zOffset;
168
+ sum += (lattice[at] ?? 0) * ((a ? upper[x] : lower[x]) as number) * wy * wz;
169
+ }
170
+ }
171
+ }
172
+ out[x + size * (y + size * z)] = sum;
173
+ }
174
+ }
175
+ }
176
+ return out;
177
+ }
178
+
179
+ /**
180
+ * Periodic inverted Worley F1: 1 minus the distance to the nearest of one point per cell.
181
+ *
182
+ * The nearest of the 27 surrounding cells' points is a minimum, so it does not depend on the order the
183
+ * cells are visited, and a cell whose nearest possible point (its whole cell box) is already farther
184
+ * than the best so far cannot change it. The cells are visited centre first and the far ones are
185
+ * skipped by that bound; each point's distance is computed with the same expression as before, so the
186
+ * result is bit for bit the full 27-cell scan.
187
+ */
188
+ function worleyInverted(cells: number, size: number, next: () => number): Float32Array {
189
+ const points = Float32Array.from({ length: cells ** 3 * 3 }, next);
190
+ const out = new Float32Array(size ** 3);
191
+ // Per axis position: the sample point, its cell, the wrapped cell and the squared distance from the
192
+ // sample to the nearest edge of the box of each of the three neighbours (-1, 0, +1). A point lies
193
+ // in [0, 1) of its cell, and the margin covers the rounding of the bound itself.
194
+ const p = new Float64Array(size);
195
+ const cell = new Int32Array(size);
196
+ const wrapped = new Int32Array(size * 3);
197
+ const gap = new Float64Array(size * 3);
198
+ const margin = 1e-9;
199
+ for (let n = 0; n < size; n++) {
200
+ p[n] = ((n + 0.5) / size) * cells;
201
+ cell[n] = Math.floor(p[n] as number);
202
+ for (let d = 0; d < 3; d++) {
203
+ const low = (cell[n] as number) + d - 1 - (p[n] as number);
204
+ wrapped[n * 3 + d] = mod((cell[n] as number) + d - 1, cells);
205
+ gap[n * 3 + d] = low > 0 ? low * low : low + 1 < 0 ? (low + 1) ** 2 : 0;
206
+ }
207
+ }
208
+ for (let z = 0; z < size; z++) {
209
+ const pz = p[z] as number;
210
+ const cz = cell[z] as number;
211
+ for (let y = 0; y < size; y++) {
212
+ const py = p[y] as number;
213
+ const cy = cell[y] as number;
214
+ for (let x = 0; x < size; x++) {
215
+ const px = p[x] as number;
216
+ const cx = cell[x] as number;
217
+ let best = 9;
218
+ for (let a = 0; a < 3; a++) {
219
+ const kk = (a + 1) % 3;
220
+ const gz = gap[z * 3 + kk] as number;
221
+ if (gz > best + margin) continue;
222
+ const k = kk - 1;
223
+ const zOffset = cells * cells * (wrapped[z * 3 + kk] as number);
224
+ for (let b = 0; b < 3; b++) {
225
+ const jj = (b + 1) % 3;
226
+ const gyz = gz + (gap[y * 3 + jj] as number);
227
+ if (gyz > best + margin) continue;
228
+ const j = jj - 1;
229
+ const yOffset = cells * (wrapped[y * 3 + jj] as number);
230
+ for (let c = 0; c < 3; c++) {
231
+ const ii = (c + 1) % 3;
232
+ if (gyz + (gap[x * 3 + ii] as number) > best + margin) continue;
233
+ const i = ii - 1;
234
+ const at = 3 * ((wrapped[x * 3 + ii] as number) + yOffset + zOffset);
235
+ const dx = cx + i + (points[at] ?? 0) - px;
236
+ const dy = cy + j + (points[at + 1] ?? 0) - py;
237
+ const dz = cz + k + (points[at + 2] ?? 0) - pz;
238
+ best = Math.min(best, dx * dx + dy * dy + dz * dz);
239
+ }
240
+ }
241
+ }
242
+ out[x + size * (y + size * z)] = 1 - Math.sqrt(best);
243
+ }
244
+ }
245
+ }
246
+ return out;
247
+ }
248
+
249
+ const standardise = (v: Float32Array): Float32Array => {
250
+ let mean = 0;
251
+ for (const x of v) mean += x;
252
+ mean /= v.length;
253
+ let variance = 0;
254
+ for (const x of v) variance += (x - mean) ** 2;
255
+ const scale = 1 / Math.sqrt(variance / v.length || 1);
256
+ return v.map((x) => (x - mean) * scale);
257
+ };
258
+
259
+ /** Replace each value by the quantile-table value at its rank, keeping the noise's spatial order. */
260
+ function matchQuantiles(values: Float32Array, table: readonly number[]): Float32Array {
261
+ const sorted = Float32Array.from(values).sort();
262
+ const last = table.length - 1;
263
+ return values.map((value) => {
264
+ let lo = 0;
265
+ let hi = sorted.length;
266
+ while (lo < hi) {
267
+ const mid = (lo + hi) >> 1;
268
+ if ((sorted[mid] ?? 0) < value) lo = mid + 1;
269
+ else hi = mid;
270
+ }
271
+ const t = (lo / Math.max(1, sorted.length - 1)) * last;
272
+ const i = Math.min(last - 1, Math.floor(t));
273
+ return (table[i] ?? 0) + ((table[i + 1] ?? 0) - (table[i] ?? 0)) * (t - i);
274
+ });
275
+ }
276
+
277
+ export interface ICloudTextures {
278
+ /** RGBA float, PATTERN_SIZE squared, one cloud type per channel (alpha unused). */
279
+ pattern: Float32Array;
280
+ /** RG float, VOLUME_SIZE cubed: R is the distortion noise, G the shape noise. */
281
+ volume: Float32Array;
282
+ }
283
+ const textureCache = new Map<number, ICloudTextures>();
284
+
285
+ export function cloudTextures(seed = 631): ICloudTextures {
286
+ const cached = textureCache.get(seed);
287
+ if (cached) return cached;
288
+ const next = rng(seed);
289
+ const n = PATTERN_SIZE;
290
+ const pattern = new Float32Array(n * n * 4);
291
+ for (let c = 0; c < 3; c++) {
292
+ let field = new Float32Array(n * n);
293
+ for (let o = 0; o < 3; o++) {
294
+ const octave = valueNoise((PATTERN_CELLS[c] ?? 8) * 2 ** o, n, 2, next);
295
+ field = field.map((v, i) => v + (octave[i] ?? 0) * 0.5 ** o);
296
+ }
297
+ const mapped = matchQuantiles(field, PATTERN_QUANTILES[c] ?? []);
298
+ for (let i = 0; i < n * n; i++) pattern[i * 4 + c] = mapped[i] ?? 0;
299
+ }
300
+ const v = VOLUME_SIZE;
301
+ const blend = (
302
+ cells: number,
303
+ noiseCells: number,
304
+ weight: number,
305
+ table: readonly number[],
306
+ ): Float32Array => {
307
+ const worley = standardise(worleyInverted(cells, v, next));
308
+ const smoothNoise = standardise(valueNoise(noiseCells, v, 3, next));
309
+ return matchQuantiles(
310
+ worley.map((x, i) => weight * x + (1 - weight) * (smoothNoise[i] ?? 0)),
311
+ table,
312
+ );
313
+ };
314
+ const shape = blend(6, 3, 0.7, VOLUME_QUANTILES[1]);
315
+ const distortion = blend(3, 8, 0.92, VOLUME_QUANTILES[0]);
316
+ const volume = new Float32Array(v ** 3 * 2);
317
+ for (let i = 0; i < v ** 3; i++) {
318
+ volume[i * 2] = distortion[i] ?? 0;
319
+ volume[i * 2 + 1] = shape[i] ?? 0;
320
+ }
321
+ const textures = { pattern, volume };
322
+ textureCache.set(seed, textures);
323
+ return textures;
324
+ }
325
+
326
+ /** T_Profile_08 stand-in: the three cloud types' vertical profile at altitude fraction u, pattern v. */
327
+ function cloudProfile(type: 0 | 1 | 2, u: number, v: number): number {
328
+ const coefficients = PROFILE_COEFFICIENTS[type];
329
+ const u2 = u * u;
330
+ const u3 = u2 * u;
331
+ const v2 = v * v;
332
+ const v3 = v2 * v;
333
+ const u4 = u3 * u;
334
+ const v4 = v3 * v;
335
+ const us = [1, u, u2, u3, u4];
336
+ const vs = [1, v, v2, v3, v4];
337
+ let sum = 0;
338
+ for (let i = 0; i < PROFILE_TERMS.length; i++) {
339
+ const term = PROFILE_TERMS[i] ?? [0, 0];
340
+ sum += (coefficients[i] ?? 0) * (us[term[0]] ?? 0) * (vs[term[1]] ?? 0);
341
+ }
342
+ return sum;
343
+ }
344
+ /** Profile baked to a 64 x 64 RGBA texture, u along x and the pattern value along y. */
345
+ export function cloudProfileTexture(size = 64): Float32Array {
346
+ const out = new Float32Array(size * size * 4);
347
+ for (let y = 0; y < size; y++)
348
+ for (let x = 0; x < size; x++)
349
+ for (let c = 0; c < 3; c++)
350
+ out[(y * size + x) * 4 + c] = cloudProfile(
351
+ c as 0 | 1 | 2,
352
+ (x + 0.5) / size,
353
+ (y + 0.5) / size,
354
+ );
355
+ return out;
356
+ }
357
+
358
+ // The two samplers run per ray step in the CPU sky bake. The wrapped cell indices and the complementary
359
+ // weights are computed once per call, not once per tap or closure; every product and sum is the one the
360
+ // closure form evaluated, in the same order.
361
+ function samplePattern(pattern: Float32Array, u: number, v: number, c: number): number {
362
+ const n = PATTERN_SIZE;
363
+ const fx = u * n - 0.5;
364
+ const fy = v * n - 0.5;
365
+ const ix = Math.floor(fx);
366
+ const iy = Math.floor(fy);
367
+ const wx = fx - ix;
368
+ const wy = fy - iy;
369
+ const x0 = mod(ix, n);
370
+ const x1 = mod(ix + 1, n);
371
+ const row0 = mod(iy, n) * n;
372
+ const row1 = mod(iy + 1, n) * n;
373
+ const nx = 1 - wx;
374
+ return (
375
+ ((pattern[(row0 + x0) * 4 + c] ?? 0) * nx + (pattern[(row0 + x1) * 4 + c] ?? 0) * wx) *
376
+ (1 - wy) +
377
+ ((pattern[(row1 + x0) * 4 + c] ?? 0) * nx + (pattern[(row1 + x1) * 4 + c] ?? 0) * wx) * wy
378
+ );
379
+ }
380
+
381
+ function sampleVolume(volume: Float32Array, x: number, y: number, z: number, c: number): number {
382
+ const n = VOLUME_SIZE;
383
+ const fx = x * n - 0.5;
384
+ const fy = y * n - 0.5;
385
+ const fz = z * n - 0.5;
386
+ const ix = Math.floor(fx);
387
+ const iy = Math.floor(fy);
388
+ const iz = Math.floor(fz);
389
+ const wx = fx - ix;
390
+ const wy = fy - iy;
391
+ const wz = fz - iz;
392
+ const x0 = mod(ix, n);
393
+ const x1 = mod(ix + 1, n);
394
+ const y0 = n * mod(iy, n);
395
+ const y1 = n * mod(iy + 1, n);
396
+ const z0 = n * n * mod(iz, n);
397
+ const z1 = n * n * mod(iz + 1, n);
398
+ const nx = 1 - wx;
399
+ const ny = 1 - wy;
400
+ const plane0 =
401
+ ((volume[(x0 + y0 + z0) * 2 + c] ?? 0) * nx + (volume[(x1 + y0 + z0) * 2 + c] ?? 0) * wx) * ny +
402
+ ((volume[(x0 + y1 + z0) * 2 + c] ?? 0) * nx + (volume[(x1 + y1 + z0) * 2 + c] ?? 0) * wx) * wy;
403
+ const plane1 =
404
+ ((volume[(x0 + y0 + z1) * 2 + c] ?? 0) * nx + (volume[(x1 + y0 + z1) * 2 + c] ?? 0) * wx) * ny +
405
+ ((volume[(x0 + y1 + z1) * 2 + c] ?? 0) * nx + (volume[(x1 + y1 + z1) * 2 + c] ?? 0) * wx) * wy;
406
+ return plane0 * (1 - wz) + plane1 * wz;
407
+ }
408
+
409
+ /**
410
+ * Extinction per metre at planet-centred (x, y, z) km, y up. The material's graph, with wind at
411
+ * zero and the three cloud types at weight one: coverage pattern times (altitude profile
412
+ * minus one half plus distorted shape noise), times Cloud_GlobalDensity, zero near layer edges.
413
+ */
414
+ function cloudDensityField(seed = 631): (x: number, y: number, z: number) => number {
415
+ const { pattern, volume } = cloudTextures(seed);
416
+ const m = CLOUD_MATERIAL;
417
+ return (x, y, z) => {
418
+ const altitude = Math.hypot(x, y, z) - PLANET;
419
+ if (altitude <= CLOUD_BOTTOM_KM || altitude >= CLOUD_TOP_KM) return 0;
420
+ const h = (altitude - CLOUD_BOTTOM_KM) / (CLOUD_TOP_KM - CLOUD_BOTTOM_KM);
421
+ if (h < m.insideLayer[0] || h > m.insideLayer[1]) return 0;
422
+ const u = x / m.layoutKm;
423
+ const v = z / m.layoutKm;
424
+ const p0 = samplePattern(pattern, u, v, 0);
425
+ const p1 = samplePattern(pattern, u, v, 1);
426
+ const p2 = samplePattern(pattern, u, v, 2);
427
+ const coverage = Math.max(p0, p1, p2);
428
+ if (coverage <= 0) return 0;
429
+ const profile =
430
+ Math.max(cloudProfile(0, h, p0), cloudProfile(1, h, p1), cloudProfile(2, h, p2)) - 0.5;
431
+ const sky: [number, number, number] = [u + 0.5, v + 0.5, (y - PLANET) / m.layoutKm];
432
+ const a = h * 0.95 + 0.05;
433
+ const c = (2 * Math.abs(a - 0.5)) ** 2;
434
+ const warp =
435
+ (sampleVolume(
436
+ volume,
437
+ sky[0] * m.noise2Scale[0],
438
+ sky[1] * m.noise2Scale[1],
439
+ sky[2] * m.noise2Scale[2],
440
+ 0,
441
+ ) -
442
+ m.noiseBias[1]) *
443
+ m.noiseStrength[1];
444
+ const shape = sampleVolume(
445
+ volume,
446
+ sky[0] * m.noise1Scale[0] + a * warp,
447
+ sky[1] * m.noise1Scale[1] + a * warp,
448
+ sky[2] * m.noise1Scale[2] + c * warp,
449
+ 1,
450
+ );
451
+ const noise = (shape - m.noiseBias[0] + m.coverage) * m.noiseStrength[0];
452
+ return clamp(coverage * (profile + noise) * m.density);
453
+ };
454
+ }
455
+
456
+ /** Beer–Lambert transmission for a nonnegative optical depth. */
457
+ const cloudTransmittance = (depth: number): number => Math.exp(-Math.max(0, depth));
458
+ const hg = (cosine: number, g: number): number =>
459
+ (1 - g * g) / (4 * Math.PI * (1 + g * g - 2 * g * cosine) ** 1.5);
460
+ /** The material's dual lobe: HG(g) blended toward HG(g2). */
461
+ const cloudPhase = (cosine: number): number => {
462
+ const p = CLOUD_MATERIAL.phase;
463
+ const forward = hg(cosine, p.g);
464
+ return forward + p.blend * (hg(cosine, p.g2) - forward);
465
+ };
466
+ /** Per scattering octave: scattering and extinction scale, and the lerp toward isotropic phase. */
467
+ export function cloudOctaves(): Array<{ scatter: number; extinction: number; anisotropy: number }> {
468
+ const ms = CLOUD_MATERIAL.multiScatter;
469
+ let s = ms.contribution;
470
+ let e = ms.occlusion;
471
+ let f = ms.eccentricity;
472
+ const out = [{ scatter: 1, extinction: 1, anisotropy: 1 }];
473
+ for (let i = 1; i <= ms.octaves; i++) {
474
+ const last = out[i - 1] ?? { scatter: 1, extinction: 1, anisotropy: 1 };
475
+ out.push({ scatter: last.scatter * s, extinction: last.extinction * e, anisotropy: f });
476
+ s *= s;
477
+ e *= e;
478
+ f *= f;
479
+ }
480
+ return out;
481
+ }
482
+ const sphereExit = (r: number, mu: number, radius: number): number =>
483
+ -r * mu + Math.sqrt(r * r * mu * mu + radius * radius - r * r);
484
+
485
+ /** Composite in place, in bakeSkyRadiance's radiance per unit sun illuminance; no DOM or GPU. */
486
+ export function bakeCloudRadiance(
487
+ radiance: Float32Array,
488
+ sun: { x: number; y: number; z: number },
489
+ width: number,
490
+ height: number,
491
+ seed = 631,
492
+ ): void {
493
+ if (
494
+ !Number.isInteger(width) ||
495
+ !Number.isInteger(height) ||
496
+ width < 1 ||
497
+ height < 1 ||
498
+ radiance.length !== width * height * 3 ||
499
+ !Number.isFinite(seed) ||
500
+ !(Math.abs(Math.hypot(sun.x, sun.y, sun.z) - 1) <= 0.001)
501
+ ) {
502
+ throw new Error(
503
+ "Cloud bake requires matching positive dimensions, a finite seed and a unit sun",
504
+ );
505
+ }
506
+ const density = cloudDensityField(seed);
507
+ const octaves = cloudOctaves();
508
+ const ambient = [0, 0, 0];
509
+ let weights = 0;
510
+ for (let y = 0; y < height / 2; y += 1) {
511
+ const theta = ((y + 0.5) / height) * Math.PI;
512
+ const weight = Math.sin(theta) * Math.max(0, Math.cos(theta));
513
+ for (let x = 0; x < width; x += 1) {
514
+ for (let c = 0; c < 3; c += 1)
515
+ ambient[c] = (ambient[c] ?? 0) + (radiance[(y * width + x) * 3 + c] ?? 0) * weight;
516
+ weights += weight;
517
+ }
518
+ }
519
+ for (let c = 0; c < 3; c += 1) ambient[c] = (ambient[c] ?? 0) / Math.max(weights, 1e-9);
520
+ for (let y = 0; y < height / 2; y += 1) {
521
+ const elevation = Math.PI / 2 - ((y + 0.5) / height) * Math.PI;
522
+ const dy = Math.sin(elevation);
523
+ const horizontal = Math.cos(elevation);
524
+ const entry = sphereExit(CAMERA, dy, PLANET + CLOUD_BOTTOM_KM);
525
+ if (entry > 350) continue;
526
+ const length = Math.min(
527
+ CLOUD_MODEL.tracingKm,
528
+ sphereExit(CAMERA, dy, PLANET + CLOUD_TOP_KM) - entry,
529
+ );
530
+ const steps = Math.min(
531
+ CLOUD_MODEL.maxViewSteps,
532
+ Math.max(CLOUD_MODEL.minViewSteps, Math.ceil((length * 1000) / CLOUD_MODEL.viewStepMetres)),
533
+ );
534
+ const dt = length / steps;
535
+ const fade =
536
+ 1 -
537
+ smooth(
538
+ (entry - CLOUD_MODEL.horizonFadeStartKm) /
539
+ (CLOUD_MODEL.horizonFadeEndKm - CLOUD_MODEL.horizonFadeStartKm),
540
+ );
541
+ // shortcut: integrate the clear-air column to layer entry, not per cloud sample; upgrade for airborne cameras.
542
+ const airDepth = [0, 0, 0];
543
+ for (let i = 0; i < 8; i += 1) {
544
+ const t = (entry * (i + 0.5)) / 8;
545
+ const h = Math.hypot(horizontal * t, CAMERA + dy * t) - PLANET;
546
+ for (let c = 0; c < 3; c += 1)
547
+ airDepth[c] =
548
+ (airDepth[c] ?? 0) +
549
+ (((RAYLEIGH[c as 0 | 1 | 2] ?? 0) * Math.exp(-h / 8) +
550
+ (MIE_SCATTER + MIE_ABSORB) * Math.exp(-h / 1.2)) *
551
+ entry) /
552
+ 8;
553
+ }
554
+ for (let x = 0; x < width; x += 1) {
555
+ const azimuth = ((x + 0.5) / width - 0.5) * 2 * Math.PI;
556
+ const dx = horizontal * Math.cos(azimuth);
557
+ const dz = horizontal * Math.sin(azimuth);
558
+ const phase = cloudPhase(dx * sun.x + dy * sun.y + dz * sun.z);
559
+ let through = 1;
560
+ const light = [0, 0, 0];
561
+ for (let i = 0; i < steps && through > 0.005; i += 1) {
562
+ const t = entry + (i + 0.5) * dt;
563
+ const px = dx * t;
564
+ const py = CAMERA + dy * t;
565
+ const pz = dz * t;
566
+ const extinction = density(px, py, pz) * 1000 * fade; // per km
567
+ if (extinction === 0) continue;
568
+ const r = Math.hypot(px, py, pz);
569
+ const shadowLength = Math.min(
570
+ 15,
571
+ sphereExit(r, (px * sun.x + py * sun.y + pz * sun.z) / r, PLANET + CLOUD_TOP_KM),
572
+ );
573
+ let shadowDepth = 0;
574
+ for (let j = 0; j < CLOUD_MODEL.lightSteps; j += 1) {
575
+ const s = shadowLength * ((j + 0.5) / CLOUD_MODEL.lightSteps) ** 2;
576
+ const ds = (shadowLength * (2 * j + 1)) / CLOUD_MODEL.lightSteps ** 2;
577
+ shadowDepth += density(px + sun.x * s, py + sun.y * s, pz + sun.z * s) * 1000 * ds;
578
+ }
579
+ const stepT = cloudTransmittance(extinction * dt);
580
+ let direct = 0;
581
+ for (const o of octaves)
582
+ direct +=
583
+ o.scatter *
584
+ cloudTransmittance(shadowDepth * o.extinction) *
585
+ (1 / (4 * Math.PI) + (phase - 1 / (4 * Math.PI)) * o.anisotropy);
586
+ // The sun reaches this sample through the air above it, not through the whole atmosphere.
587
+ const sunlight = transmittanceToTop(r, (px * sun.x + py * sun.y + pz * sun.z) / r);
588
+ for (let c = 0; c < 3; c += 1) {
589
+ const source =
590
+ direct * (sunlight[c as 0 | 1 | 2] ?? 0) +
591
+ (ambient[c] ?? 0) * CLOUD_MATERIAL.skyOcclusion;
592
+ light[c] = (light[c] ?? 0) + through * (1 - stepT) * CLOUD_MATERIAL.albedo * source;
593
+ }
594
+ through *= stepT;
595
+ }
596
+ for (let c = 0; c < 3; c += 1) {
597
+ const at = (y * width + x) * 3 + c;
598
+ const sky = radiance[at] ?? 0;
599
+ radiance[at] =
600
+ sky + Math.exp(-(airDepth[c] ?? 0)) * ((light[c] ?? 0) - sky * (1 - through));
601
+ }
602
+ }
603
+ }
604
+ }
605
+ export type { Rgb };
@@ -0,0 +1,50 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // A baked blob under a prop: what makes a crate sit on the floor on every tier. Unreal grounds a
5
+ // contact with ambient occlusion, which is on by default (UE 5.8.3: Engine/Source/Runtime/Engine/
6
+ // Private/SceneView.cpp:168-173, Scene.cpp:567) and off at its Low scalability level
7
+ // (Engine/Config/BaseScalability.ini:568-569); its lights add no contact shadow of their own
8
+ // (ULightComponent::ContactShadowLength = 0, LightComponent.cpp:470). This game's `low` tier
9
+ // (software adapters and phones) draws no screen-space pass either, and at the +1 EV Unreal exposure
10
+ // the floor's highlight shoulder dilutes the sun shadow's edge, so the blob carries the contact.
11
+ //
12
+ // The blob is stacked flat discs, not a gradient texture: a sampled map drew nothing on the owned engine.
13
+ import { CircleGeometry, Group, Mesh, MeshBasicMaterial } from "three";
14
+
15
+ const LAYERS = 24;
16
+
17
+ export interface IContactShadow {
18
+ readonly object: Group;
19
+ /** Scales the blob's darkness: 1 at rest, 0 gone. */
20
+ fade(amount: number): void;
21
+ }
22
+
23
+ /**
24
+ * A soft blob `diameter` metres across, lying in the XZ plane, darkest at the centre where its
25
+ * `strength` (0 to 1) is reached. The caller moves `object` to the floor under its prop. It casts
26
+ * and receives nothing and does not write depth, so it never fights the floor or another blob.
27
+ */
28
+ export function contactShadow(diameter: number, strength = 0.55): IContactShadow {
29
+ const layerAlpha = 1 - (1 - strength) ** (1 / LAYERS);
30
+ const material = new MeshBasicMaterial({
31
+ color: 0x000000,
32
+ depthWrite: false,
33
+ opacity: layerAlpha,
34
+ transparent: true,
35
+ });
36
+ const object = new Group();
37
+ for (let layer = 0; layer < LAYERS; layer += 1) {
38
+ const geometry = new CircleGeometry((diameter / 2) * (1 - layer / LAYERS), 32);
39
+ geometry.rotateX(-Math.PI / 2);
40
+ const disc = new Mesh(geometry, material);
41
+ disc.renderOrder = 1;
42
+ object.add(disc);
43
+ }
44
+ return {
45
+ fade: (amount) => {
46
+ material.opacity = layerAlpha * amount;
47
+ },
48
+ object,
49
+ };
50
+ }