create-threenative 0.2.10 → 0.2.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +227 -34
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +15 -10
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +14 -9
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +15 -10
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +15 -10
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +15 -10
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +72 -1
  420. package/templates/racing/src/scenes/Race.ts +9 -7
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +14 -9
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +14 -9
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +15 -10
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +15 -10
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +15 -10
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +15 -10
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +15 -10
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +14 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +27 -14
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +15 -10
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -1,3 +1,4 @@
1
+ import type { ChainStage } from "@threenative/core";
1
2
  // Generated for you: ordinary Three.js; ThreeNative does not read this file.
2
3
  //
3
4
  // The last two stages of this game's frame: a colour grade, and the film grain over it. Both are
@@ -28,7 +29,6 @@ import { lut3D } from "three/addons/tsl/display/Lut3DNode.js";
28
29
  import { float, renderOutput, texture3D, time, uv } from "three/tsl";
29
30
  import type { Node } from "three/webgpu";
30
31
  import type { QualityTier } from "./quality.js";
31
- import type { ChainStage } from "./worldEnvironment.js";
32
32
 
33
33
  /**
34
34
  * What `TN_RENDER_CHAIN` prints when a stage is refused. Never blank, and never the same answer
@@ -1,10 +1,33 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
3
  //
4
- // One sun. The sky image in `sky.ts` is the fill light — its environment reaches every face the
5
- // sun misses — so there is no hemisphere or ambient light stacked on top to flatten the frame.
4
+ // One sun. The sky in `sky.ts` is the fill light — its environment reaches every face the sun
5
+ // misses — so there is no hemisphere or ambient light stacked on top to flatten the frame.
6
6
  import { Color, DirectionalLight, PCFSoftShadowMap, type Scene, Vector3 } from "three";
7
- import { SUN_DIRECTION } from "./sky.js";
7
+ import { ARENA, GROUND_Y } from "./arena.js";
8
+ import {
9
+ SUN_ILLUMINANCE,
10
+ SUN_KELVIN,
11
+ sunLight,
12
+ sunLightTransmittance,
13
+ temperatureColour,
14
+ } from "./atmosphere.js";
15
+ import { SKY_OPTIONS, SUN_DIRECTION } from "./sky.js";
16
+
17
+ /** The sun as Unreal's default level has it: 6 lux at 6500 K, tinted by the air it crosses. */
18
+ function atmosphereSun(): DirectionalLight {
19
+ const tint = temperatureColour(SUN_KELVIN);
20
+ const through = sunLightTransmittance(Math.asin(Math.min(1, Math.max(-1, SUN_DIRECTION.y))));
21
+ const colour = new Color().setRGB(
22
+ tint[0] * through[0],
23
+ tint[1] * through[1],
24
+ tint[2] * through[2],
25
+ );
26
+ const key = new DirectionalLight(colour, SUN_ILLUMINANCE);
27
+ // `gpuSky.ts` re-tints it when the sun moves.
28
+ sunLight.current = key;
29
+ return key;
30
+ }
8
31
 
9
32
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
10
33
 
@@ -16,8 +39,8 @@ export function setupLighting(
16
39
  renderer.shadowMap.enabled = true;
17
40
  renderer.shadowMap.type = PCFSoftShadowMap;
18
41
 
19
- // Warm white, matched by eye to the photographed midday sun against its own sky.
20
- const key = new DirectionalLight(0xfff1e0, 4.5);
42
+ // The photo sky keeps the warm white matched by eye to its photographed midday sun.
43
+ const key = SKY_OPTIONS.sky === "photo" ? new DirectionalLight(0xfff1e0, 4.5) : atmosphereSun();
21
44
  key.position.copy(SUN_DIRECTION).multiplyScalar(30);
22
45
  key.castShadow = true;
23
46
  // One map fitted to the 28 m arena: 4096² is under a centimetre a texel, so every shadow has the
@@ -28,7 +51,12 @@ export function setupLighting(
28
51
  key.shadow.radius = 2;
29
52
  key.shadow.camera.near = 1;
30
53
  key.shadow.camera.far = 80;
31
- const extent = 14;
54
+ // Cover the arena's diagonal in light space, so a wall shadow cannot stop at the map edge.
55
+ const extent = Math.hypot(
56
+ ARENA.halfX + ARENA.thickness / 2,
57
+ ARENA.halfZ + ARENA.thickness / 2,
58
+ Math.max(Math.abs(GROUND_Y), Math.abs(ARENA.wallTop)),
59
+ );
32
60
  key.shadow.camera.left = -extent;
33
61
  key.shadow.camera.right = extent;
34
62
  key.shadow.camera.top = extent;
@@ -1,15 +1,6 @@
1
1
  // Generated for you. Scene-owned material assignments; no engine appearance hooks.
2
- import {
3
- type Camera,
4
- type DirectionalLight,
5
- Material,
6
- Mesh,
7
- MeshStandardMaterial,
8
- type Object3D,
9
- type Scene,
10
- type Texture,
11
- } from "three";
12
- import { type IBacklightControls, backlightMaterial } from "./backlightMaterial.js";
2
+ import type { Camera, DirectionalLight, Object3D, Scene, Texture } from "three";
3
+ import type { IBacklightControls } from "./backlightMaterial.js";
13
4
  import {
14
5
  type IEnvironmentMeasurement,
15
6
  measureEnvironment,
@@ -1,14 +1,12 @@
1
+ import { type OutputRenderer, WorldEnvironment } from "@threenative/core";
1
2
  // Generated for you: ordinary Three.js; ThreeNative does not read this file.
2
3
  //
3
- // This file wires two things together and decides nothing itself. `quality.ts`, in this folder,
4
- // owns which stages run at which tier and records what each one measured. `WorldEnvironment`,
5
- // also in this folder, builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
6
- // applied or refused **with a reason**, so a stage that silently no-op'd is never mistaken for
7
- // one you turned off.
4
+ // This file wires two things together and decides nothing itself. `quality.ts` owns which stages
5
+ // run at which tier and records what each one measured. Core's `WorldEnvironment` builds them and
6
+ // prints `TN_WORLD_ENVIRONMENT`, naming every stage as applied or refused **with a reason**.
8
7
  //
9
- // To make the game cheaper or prettier everywhere, edit `quality.ts`. To force one tier for one
10
- // run — a desktop that is dropping frames, a capture you want to compare — pass it:
11
- // `setupPost(renderer, scene, camera, { tier: "low" })`. Overriding does not silence the report:
8
+ // To make the game cheaper or prettier everywhere, edit `quality.ts`. To force one tier for one run
9
+ // (a slow desktop, a capture to compare), pass `setupPost(renderer, scene, camera, { tier: "low" })`.
12
10
  // `TN_QUALITY_TIER` names the tier that ran either way.
13
11
  import { type Camera, type DirectionalLight, FloatType, type Scene } from "three";
14
12
  import { LUTCubeLoader } from "three/addons/loaders/LUTCubeLoader.js";
@@ -21,8 +19,8 @@ import {
21
19
  import { type IGradeTable, filterableTable, gradeStages } from "./grade.js";
22
20
  import { type QualityTier, gradePreset, qualityPreset } from "./quality.js";
23
21
  import { type TemporalAAProvider, temporalAAStages } from "./temporalAAStage.js";
22
+ import { temporalDetailRequested, temporalDetailStages } from "./temporalDetailStage.js";
24
23
  import type { FogMedium } from "./volumetricFog.js";
25
- import { type OutputRenderer, WorldEnvironment } from "./worldEnvironment.js";
26
24
 
27
25
  interface IPostController {
28
26
  readonly tier: QualityTier;
@@ -72,6 +70,8 @@ export function setupPost(
72
70
  * rather than composed twice. Omit it and the chain starts from the beauty pass unchanged.
73
71
  */
74
72
  fog?: () => FogMedium | undefined;
73
+ /** `new TracedReflections(root)` once static meshes exist: chrome reflects the scene, not only the screen. */
74
+ reflectionTrace?: NonNullable<Parameters<WorldEnvironment["apply"]>[3]>["reflectionTrace"];
75
75
  } = {},
76
76
  ): IPostController {
77
77
  const policy = createAdaptiveQuality(environment, environment);
@@ -83,6 +83,8 @@ export function setupPost(
83
83
  // The opt-in `traa` stage publishes its provider here once the chain has built it, so `debug()`
84
84
  // reports the live reconstruction state and a scene can reset history on a teleport.
85
85
  let temporal: TemporalAAProvider | undefined;
86
+ // The chain's own temporal AA (`temporalAA` in `quality.ts`) reads the engine's live frame, history and jitter.
87
+ let engineTemporal: (() => Record<string, unknown>) | undefined;
86
88
  let observation: Record<string, unknown> = {
87
89
  tier: policy.tier,
88
90
  source: policy.pinned ? "pinned" : "auto",
@@ -94,14 +96,20 @@ export function setupPost(
94
96
  medium = environment.fog?.();
95
97
  const composed = medium;
96
98
  const settings = qualityPreset(policy.tier);
99
+ const detail = temporalDetailRequested(renderer, settings) ? temporalDetailStages() : [];
97
100
  const world = new WorldEnvironment({
98
101
  ...settings,
99
- // Two stages this game owns, not the chain's: `grade.ts` builds them, `WorldEnvironment`
100
- // orders and reports them, and `quality.ts` decides whether each tier runs them. The opt-in
101
- // `traa` stage is offered beside them and runs only when a tier names it.
102
- authoredStageNames: ["grade", "grain"],
102
+ // Game-owned grade/grain and authored TRAA follow quality.ts; WorldEnvironment orders them.
103
+ // Listing traa replaces the chain's temporalAA provider.
104
+ authoredStageNames: [
105
+ "grade",
106
+ "grain",
107
+ ...(settings.authoredStageNames ?? []),
108
+ ...detail.map(({ name }) => name),
109
+ ],
103
110
  authoredStages: (stage) => [
104
111
  ...gradeStages(gradePreset(policy.tier), table),
112
+ ...detail,
105
113
  ...temporalAAStages(stage, {
106
114
  onProvider: (provider) => {
107
115
  temporal = provider;
@@ -111,10 +119,12 @@ export function setupPost(
111
119
  });
112
120
  const applied = world.apply(renderer, scene, camera, {
113
121
  godraysLight: environment.godraysLight,
122
+ reflectionTrace: environment.reflectionTrace,
114
123
  // Ahead of exposure and every stage, which is the only place a participating medium can go.
115
124
  baseColour: composed === undefined ? undefined : (scenePass) => composed.compose(scenePass),
116
125
  });
117
126
  disposeGraph = applied.dispose;
127
+ engineTemporal = applied.temporalReport;
118
128
  observation = { ...observation, stages: applied.stages, dropped: applied.dropped };
119
129
  environment.onTierChanged?.(policy.tier);
120
130
  }
@@ -153,7 +163,10 @@ export function setupPost(
153
163
  get tier(): QualityTier {
154
164
  return policy.tier;
155
165
  },
156
- debug: () => (temporal ? { ...observation, temporal: temporal.report() } : { ...observation }),
166
+ debug: () => {
167
+ const report = temporal ? temporal.report() : engineTemporal?.();
168
+ return report === undefined ? { ...observation } : { ...observation, temporal: report };
169
+ },
157
170
  observe(window: IQualityWindow): void {
158
171
  if (disposed) return;
159
172
  const decision = policy.observe(window);
@@ -1,3 +1,9 @@
1
+ import {
2
+ type IWorldEnvironmentOptions,
3
+ qualityPreset as coreQualityPreset,
4
+ qualityTiers,
5
+ } from "@threenative/core";
6
+ import { exposureSettings } from "./exposure.js";
1
7
  // Generated for you: ordinary Three.js; ThreeNative does not read this file. Delete or rewrite
2
8
  // it freely — the tiers below are a starting point, not a framework look.
3
9
  //
@@ -20,165 +26,30 @@
20
26
  // in `sky.ts`, not in this file.
21
27
  //
22
28
  import type { IGradeSettings } from "./grade.js";
23
- import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
29
+ export type { QualityTier } from "@threenative/core";
30
+ import type { QualityTier } from "@threenative/core";
24
31
 
25
32
  /**
26
33
  * This game's authored looks. GPU family picks the start; measured frame budgets refine it.
27
34
  * Edit these presets to change the look without changing the framework.
28
35
  */
29
- export type QualityTier = "low" | "medium" | "high";
30
-
31
- const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
32
-
33
- /**
34
- * Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
35
- * `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
36
- */
37
- function isQualityTier(value: string): value is QualityTier {
38
- return (QUALITY_TIERS as readonly string[]).includes(value);
39
- }
40
-
41
- /**
42
- * Where each GPU family starts, from `ctx.renderer.gpuClass`.
43
- *
44
- * A start, not a ceiling: the measured frame-budget windows move the look from here, and an
45
- * explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
46
- * family rule matched — falls back to the `mobile` flag, exactly as before families existed.
47
- * Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
48
- */
49
- const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
50
- software: "low",
51
- "mobile-low": "low",
52
- "mobile-mid": "low",
53
- "mobile-high": "medium",
54
- integrated: "medium",
55
- discrete: "high",
56
- };
36
+ export const resolveQualityTier = qualityTiers.resolve;
57
37
 
58
38
  /**
59
- * Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
60
- *
61
- * Fails closed. An unrecognised tier name throws with the value it was handed rather than
62
- * quietly rendering the default, because a silent fallback here looks exactly like a tier that
63
- * turned out to have no effect.
64
- */
65
- export function resolveQualityTier(
66
- request: {
67
- readonly gpuClass?: string;
68
- readonly mobile?: boolean;
69
- readonly software?: boolean;
70
- readonly tier?: string;
71
- } = {},
72
- ): QualityTier {
73
- const requested = request.tier;
74
- if (requested !== undefined) {
75
- if (!isQualityTier(requested)) {
76
- throw new Error(
77
- `Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
78
- );
79
- }
80
- return requested;
81
- }
82
- // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
83
- // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
84
- // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
85
- // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
86
- // `tier` above still wins over it.
87
- if (request.software === true) return "low";
88
- const family =
89
- request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
90
- if (family !== undefined) return family;
91
- return request.mobile === true ? "low" : "high";
92
- }
93
-
94
- /**
95
- * The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the
96
- * sun disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey
97
- * platforms and flattens contrast), a corner falloff, and the shared chain's SMAA. Antialiasing is
98
- * on in every tier that installs a chain; see `screenSpaceAA` in `worldEnvironment.ts`.
99
- *
100
- * No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
101
- * captured sky (`sky.ts`), and SSR on rough floors traced speckle into the grid; RCAS then rang the
102
- * smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
103
- */
104
- const shared: IWorldEnvironmentOptions = {
105
- autoExposureEnabled: false,
106
- // Bloom cost: ~4.6 ms in the reference ablation — the second most expensive stage there.
107
- bloomEnabled: true,
108
- bloomRadius: 0.6,
109
- bloomStrength: 0.22,
110
- bloomThreshold: 1,
111
- exposure: 0.62,
112
- tonemapMode: "aces",
113
- vignetteAmount: 0.22,
114
- };
115
-
116
- /**
117
- * What a desktop gets: contact occlusion on top — the dark line where a foot meets the platform
118
- * and a wall meets the ground, most of what separates "objects in a world" from "objects pasted on
119
- * a background". Gathered at full resolution and denoised: at half, the upsample left a grain
120
- * around every foot.
121
- */
122
- const high: IWorldEnvironmentOptions = {
123
- ...shared,
124
- // GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
125
- gtaoEnabled: true,
126
- gtaoRadius: 0.35,
127
- renderChainTier: "high",
128
- // Temporal AA is opt-in and no shipped tier names it: add `authoredStageNames: ["traa"]` here to
129
- // reconstruct at the display raster, and read `setupPost(...).debug().temporal` for the reset and
130
- // raster state it reports. Its rejection fraction, ghosting and frame-time cost are unqualified.
131
- };
132
-
133
- /**
134
- * The rung in between: the same occlusion at half the directions. Saving unmeasured, and the
135
- * chain's own antialiasing one notch cheaper.
136
- */
137
- // SMAA owns medium edges; another four-sample world resolve adds mobile bandwidth.
138
- const medium: IWorldEnvironmentOptions = {
139
- ...high,
140
- gtaoSamples: 8,
141
- renderChainTier: "medium",
142
- samples: 0,
143
- };
144
-
145
- /** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
146
- const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
147
-
148
- const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
149
-
150
- /**
151
- * This game's colour grade and grain, per tier. The table itself lives in `public/grade.cube` and
152
- * the maths in `grade.ts`; these are the four numbers the look is dialled with.
153
- *
154
- * **The grain default is 1/255, and that is the point.** `film()` scales its noise by
155
- * the pixel's own value, so on mid-grey concrete this moves a channel by well under half an 8-bit
156
- * step — below what the framebuffer can show. It shipped at 0.12, and a blind judge called the
157
- * result "grain clearly visible as speckle over sky and flat walls and behind HUD text". A default
158
- * must never degrade the look, so raise this number when you want the film look: 0.12 is a visible
159
- * grain, 0.3 a heavy one.
160
- *
161
- * A zero refuses its stage rather than running it at zero strength, so `low` — a phone, where a
162
- * moving grain is the first thing to go — reports `grain` as refused with its reason instead of
163
- * reading as applied. The grade survives there: it is one texture fetch and the frame is the
164
- * same frame without it. `high` keeps a non-zero grain on purpose, so `TN_RENDER_CHAIN` can still
165
- * name it as applied there rather than reporting the stage a default deliberately declined to run.
39
+ * This game's colour grade and grain, per tier (`grade.ts`, `public/grade.cube`). **Both are off, as in
40
+ * a fresh Unreal project** (Scene.cpp: neutral grade, `FilmGrainIntensity` 0). A zero refuses its stage
41
+ * and `TN_RENDER_CHAIN` says why. Turn them on with `gradeIntensity: 1` and a `grainIntensity` from
42
+ * 0.0039 (under one 8-bit step on mid grey) to 0.12 (a visible film grain).
166
43
  */
167
44
  const GRADE_PRESETS: Record<QualityTier, IGradeSettings> = {
168
- high: { gradeIntensity: 1, grainAnimated: true, grainIntensity: 0.0039, tier: "high" },
169
- medium: { gradeIntensity: 1, grainAnimated: false, grainIntensity: 0.0039, tier: "medium" },
170
- low: { gradeIntensity: 1, grainAnimated: false, grainIntensity: 0, tier: "low" },
45
+ high: { gradeIntensity: 0, grainAnimated: true, grainIntensity: 0, tier: "high" },
46
+ medium: { gradeIntensity: 0, grainAnimated: false, grainIntensity: 0, tier: "medium" },
47
+ low: { gradeIntensity: 0, grainAnimated: false, grainIntensity: 0, tier: "low" },
171
48
  };
172
49
 
173
50
  /** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
174
51
  export function qualityPreset(tier: string): IWorldEnvironmentOptions {
175
- const preset = QUALITY_PRESETS[tier as QualityTier];
176
- if (preset === undefined) {
177
- throw new Error(
178
- `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
179
- );
180
- }
181
- return preset;
52
+ return { ...coreQualityPreset(tier), exposurePolicy: exposureSettings };
182
53
  }
183
54
 
184
55
  /** The grade and grain a tier runs. Throws on a name that is not a tier, for the same reason. */
@@ -186,7 +57,7 @@ export function gradePreset(tier: string): IGradeSettings {
186
57
  const preset = GRADE_PRESETS[tier as QualityTier];
187
58
  if (preset === undefined) {
188
59
  throw new Error(
189
- `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
60
+ `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${["low", "medium", "high"].join(", ")}.`,
190
61
  );
191
62
  }
192
63
  return preset;
@@ -1,11 +1,15 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
3
  //
4
- // The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
5
- // by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
6
- // The same image is the background, the environment light every surface reflects and is filled by,
7
- // and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
8
- // equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
4
+ // The sky is Unreal 5.8.3's default level: a Sky Atmosphere with its volumetric cloud layer, a sky
5
+ // light that captures it, a sun tinted by the air it crosses, and an exponential height fog that
6
+ // takes its colour from the sky (`atmosphere.ts`, `clouds.ts`, `gpuSky.ts`). Sun, sky and fog read
7
+ // one illuminance, so moving the sun recolours all three together, as in Unreal.
8
+ //
9
+ // Override: `SKY_OPTIONS.sky = "photo"` draws `assets/sky.jpg` instead — Poly Haven's "Kloofendal 48d
10
+ // Partly Cloudy (Pure Sky)" by Greg Zaal and Jarod Guest, CC0
11
+ // (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky) — as background, environment and
12
+ // fog colour, with the sun aimed at its photographed sun. `clouds: false` keeps a clear sky.
9
13
  import {
10
14
  EquirectangularReflectionMapping,
11
15
  FogExp2,
@@ -14,59 +18,105 @@ import {
14
18
  type Texture,
15
19
  Vector3,
16
20
  } from "three";
21
+ import { createGpuSky } from "./gpuSky.js";
17
22
  import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
18
23
  import { palette } from "./palette.js";
19
24
 
25
+ export const SKY_OPTIONS: { sky: "atmosphere" | "photo"; clouds: boolean; ground: boolean } = {
26
+ sky: "atmosphere",
27
+ clouds: true,
28
+ // The sunlit ground below the horizon stands in for Unreal's Lumen floor bounce: it lifts shadow
29
+ // sides and a mirror reflects it. Set false when the game adds its own global illumination.
30
+ ground: true,
31
+ };
32
+
33
+ /** Unit vector toward the sun: 47.9° up. Move it and the sky, the sun colour and the fog follow. */
34
+ export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
35
+
20
36
  /**
21
- * How the JPEG was made from the 4k HDR: linear radiance × 0.4, clipped, sRGB-encoded — so white
22
- * in the file is 2.5 in the sky. Multiplying back restores the HDR brightness of the clouds; the sun
23
- * disk itself is clipped, which is why the sun is a light (`lighting.ts`) and not a texel.
37
+ * Unreal's default level fog in metres: its density and falloff are per 1000 cm (x0.1 per metre), and
38
+ * its line integral carries ln2 against the exact integral `heightFog.ts` evaluates. `fogHeight` sits
39
+ * 68.5 m below the floor, where the default level puts the fog actor. Inscattering is black and the
40
+ * start distance 0, as in Unreal: the colour comes from the sky.
24
41
  */
25
- const SKY_RANGE = 2.5;
42
+ const ATMOSPHERE_FOG: HeightFogParams = {
43
+ ...HEIGHT_FOG,
44
+ density: 0.00436 * Math.LN2,
45
+ heightFalloff: 0.02,
46
+ fogHeight: -68.5,
47
+ startDistance: 0,
48
+ };
26
49
 
27
- /** Unit vector toward the photographed sun: 47.9° up, measured from the source HDR. */
28
- export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
50
+ /** White in the 8-bit environment is this much scene radiance (`createGpuSky`). */
51
+ const ENVIRONMENT_RANGE = 4;
52
+
53
+ /** Photo sky only: how the JPEG was made from the 4k HDR (linear radiance x 0.4, clipped). */
54
+ const PHOTO_RANGE = 2.5;
29
55
 
30
- /** The look this fog replaced: FogExp2 at 0.003, which read as 18% haze at 150 m from 2 m up. */
56
+ /** Photo sky only: FogExp2 at 0.003 read as 18% haze at 150 m from 2 m up. */
31
57
  const EYE_LEVEL = { density: 0.003, distance: 150, cameraHeight: 2 };
32
58
 
33
- /**
34
- * The distance term's density that, with the height term, keeps the old eye-level haze: at
35
- * `EYE_LEVEL.distance` along the horizon from `EYE_LEVEL.cameraHeight` the two together transmit what
36
- * FogExp2 at `EYE_LEVEL.density` did. The distance term is lowered, never removed, so the ground
37
- * still ends in fog at a kilometre.
38
- */
39
- function distanceDensity(p: HeightFogParams = HEIGHT_FOG): number {
59
+ function photoDistanceDensity(p: HeightFogParams): number {
40
60
  const { distance, density, cameraHeight } = EYE_LEVEL;
41
61
  const old = (density * distance) ** 2;
42
62
  const height = heightFogDepth(p, cameraHeight, cameraHeight, distance) * Math.LN2;
43
63
  return Math.sqrt(Math.max(0, old - height)) / distance;
44
64
  }
45
65
 
46
- export function setupSky(scene: Scene, sky: Texture, software = false): void {
47
- sky.mapping = EquirectangularReflectionMapping;
48
- sky.colorSpace = SRGBColorSpace;
49
- scene.background = sky;
50
- scene.backgroundIntensity = SKY_RANGE;
51
- // three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
52
- // It is what makes a standard material read as a material: sky-blue fill on faces the sun
53
- // misses, and a sky to reflect, sharper as roughness drops.
54
- //
55
- // Not on a software adapter. PMREM-filtering a 4096x2048 photo keeps a CPU rasteriser's GPU
56
- // process busy past its watchdog and the next pipeline compiles die with the device (measured on
57
- // four cores: a 28 s hitch and two failed pipelines with it on, 37 pipelines in 11 s with it
58
- // off). That lane is not render evidence, so it gives up the fill light.
66
+ function setupPhotoSky(scene: Scene, photo: Texture, software: boolean): void {
67
+ SUN_DIRECTION.set(0.555, 0.742, 0.38).normalize();
68
+ photo.mapping = EquirectangularReflectionMapping;
69
+ photo.colorSpace = SRGBColorSpace;
70
+ scene.background = photo;
71
+ scene.backgroundIntensity = PHOTO_RANGE;
72
+ // Not on a software adapter: PMREM-filtering a 4096x2048 photo trips a CPU rasteriser's watchdog.
59
73
  if (!software) {
60
- scene.environment = sky;
61
- scene.environmentIntensity = SKY_RANGE;
74
+ scene.environment = photo;
75
+ scene.environmentIntensity = PHOTO_RANGE;
62
76
  }
63
- // Almost nothing inside the arena (1.4% at 30 m), and the ground gone into the horizon by a
64
- // kilometre — so the floor meets the sky instead of ending at a line. The colour is the
65
- // photograph's own horizon, sampled from the same HDR, so the fade lands where the sky is.
66
- // `scene.fog` stays the distance term for anything that reads it; `scene.fogNode` is what three
67
- // applies, and it adds the height term. One owner at a time: `STARTER_MIST` clears both.
68
77
  const params: HeightFogParams = { ...HEIGHT_FOG };
69
- const distanceFog = new FogExp2(palette.skyLow, distanceDensity(params));
78
+ const distanceFog = new FogExp2(palette.skyLow, photoDistanceDensity(params));
70
79
  scene.fog = distanceFog;
71
80
  scene.fogNode = heightFogNode(distanceFog, params, SUN_DIRECTION);
72
81
  }
82
+
83
+ /**
84
+ * `photo` is only read when `SKY_OPTIONS.sky` is "photo". `fogged` false leaves the sky unfogged;
85
+ * `clouds` false draws the clear atmosphere.
86
+ */
87
+ export function setupSky(
88
+ scene: Scene,
89
+ photo?: Texture,
90
+ software = false,
91
+ fogged = true,
92
+ clouds = SKY_OPTIONS.clouds,
93
+ ): void {
94
+ if (SKY_OPTIONS.sky === "photo") {
95
+ if (photo === undefined) throw new Error('SKY_OPTIONS.sky "photo" needs assets/sky.jpg loaded');
96
+ setupPhotoSky(scene, photo, software);
97
+ return;
98
+ }
99
+ // Height fog only; FogExp2 holds the colour `heightFogNode` reads, at zero density. `createGpuSky`
100
+ // sets that colour from the sky and again whenever the sun moves.
101
+ const fog = new FogExp2(0xffffff, 0);
102
+ scene.fog = fog;
103
+ scene.fogNode = heightFogNode(fog, { ...ATMOSPHERE_FOG }, SUN_DIRECTION);
104
+ const { node, environment } = createGpuSky(
105
+ scene,
106
+ SUN_DIRECTION,
107
+ fogged,
108
+ clouds,
109
+ ATMOSPHERE_FOG,
110
+ SKY_OPTIONS.ground,
111
+ );
112
+ environment.mapping = EquirectangularReflectionMapping;
113
+ environment.colorSpace = SRGBColorSpace;
114
+ // The analytic sky with its sun disc; a software adapter draws the 64 x 32 bake instead, with no
115
+ // LUT or cloud passes at all.
116
+ scene.background = environment;
117
+ scene.backgroundNode = software ? null : node.backgroundNode;
118
+ scene.backgroundIntensity = software ? ENVIRONMENT_RANGE : 1;
119
+ // Unreal's sky light: the same sky, so the fill on every shaded face is the sky's colour.
120
+ scene.environment = environment;
121
+ scene.environmentIntensity = ENVIRONMENT_RANGE;
122
+ }
@@ -4,7 +4,7 @@
4
4
  import { Matrix4, type OrthographicCamera, type PerspectiveCamera, Vector2 } from "three";
5
5
  import { traa } from "three/addons/tsl/display/TRAANode.js";
6
6
  import { uniform } from "three/tsl";
7
- import type { Node, PassNode, Renderer, TextureNode } from "three/webgpu";
7
+ import type { Node, PassNode, TextureNode } from "three/webgpu";
8
8
  import { type ITemporalAANode, createTemporalAAFrame } from "./temporalAAFrame.js";
9
9
  import { type PipelineContext, createTemporalAAHooks } from "./temporalAAHooks.js";
10
10
  import { disposeTemporalAAInput } from "./temporalAAInput.js";
@@ -1,3 +1,4 @@
1
+ import type { ChainStage, IWorldEnvironmentStageContext } from "@threenative/core";
1
2
  // Generated user source: this kit's `traa` stage. The chain owns stage order, velocity provisioning
2
3
  // and the applied report; this file owns the effect, the camera it jitters and the history it
3
4
  // disposes. The chain hands the stage the *sampled* velocity texture, while the accessor TRAANode
@@ -6,7 +7,6 @@ import type { OrthographicCamera, PerspectiveCamera } from "three";
6
7
  import type { Node, PassNode, TextureNode } from "three/webgpu";
7
8
  import { createTemporalAA } from "./temporalAA.js";
8
9
  import type { ITemporalRejectionMeasurement } from "./temporalRejectionCounter.js";
9
- import type { ChainStage, IWorldEnvironmentStageContext } from "./worldEnvironment.js";
10
10
 
11
11
  export type TemporalResetReason =
12
12
  | "initial"
@@ -1,7 +1,6 @@
1
1
  import type { OrthographicCamera } from "three";
2
2
  // Experimental finite raw4 estimator. The source pass owns all sample views; this allocates none.
3
3
  import {
4
- Fn,
5
4
  If,
6
5
  float,
7
6
  getViewPosition,