create-threenative 0.2.7 → 0.2.9

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 (541) hide show
  1. package/README.md +3 -1
  2. package/agent-docs/references/assertion-reference.md +87 -35
  3. package/agent-docs/references/auto-exposure.md +57 -0
  4. package/agent-docs/references/capability-reference.md +1306 -62
  5. package/agent-docs/references/debug-surface.md +6 -0
  6. package/agent-docs/references/finding-assets.md +46 -10
  7. package/agent-docs/references/performance-basics.md +5 -4
  8. package/agent-docs/references/terrain-authoring.md +140 -0
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +2 -1
  10. package/capabilities.json +1505 -79
  11. package/dist/index.d.ts +28 -3
  12. package/dist/index.js +402 -167
  13. package/dist/threenative.js +989 -237
  14. package/dist/web-engine-buffer-geometry-utils.js +281 -0
  15. package/dist/web-engine-decal-geometry.js +184 -0
  16. package/dist/web-engine-gltf-loader.js +196 -0
  17. package/dist/web-engine-hdr-loader.js +190 -0
  18. package/dist/web-engine-lut-cube-loader.js +122 -0
  19. package/dist/web-engine-mesh-bvh-webgpu.js +29 -0
  20. package/dist/web-engine-mesh-bvh.js +32 -0
  21. package/dist/web-engine-post-effects.js +168 -0
  22. package/dist/web-engine-runtime.js +42506 -0
  23. package/package.json +11 -8
  24. package/template-assets/autoExposure.ts +225 -0
  25. package/template-assets/exposure.ts +111 -0
  26. package/template-assets/exposureGraph.ts +178 -0
  27. package/template-assets/exposureReadback.ts +79 -0
  28. package/template-assets/patches/@tailwindcss__node@4.3.3.patch +22 -0
  29. package/template-assets/patches/three@0.185.1.patch +6594 -700
  30. package/template-assets/patches/vite@8.2.0.patch +422 -0
  31. package/template-assets/worldEnvironment.ts +433 -30
  32. package/templates/action-rpg/AGENTS.md +11 -10
  33. package/templates/action-rpg/CLAUDE.md +11 -10
  34. package/templates/action-rpg/package.json +11 -9
  35. package/templates/action-rpg/playtests/performance.playtest.json +7 -1
  36. package/templates/action-rpg/src/progress.ts +0 -4
  37. package/templates/action-rpg/src/render/autoExposure.ts +225 -0
  38. package/templates/action-rpg/src/render/backlightControls.ts +66 -0
  39. package/templates/action-rpg/src/render/backlightMaterial.ts +147 -0
  40. package/templates/action-rpg/src/render/environmentContribution.ts +188 -0
  41. package/templates/action-rpg/src/render/environmentRadiance.ts +36 -0
  42. package/templates/action-rpg/src/render/environmentSampleCache.ts +43 -0
  43. package/templates/action-rpg/src/render/environmentSampling.ts +193 -0
  44. package/templates/action-rpg/src/render/environmentSnapshot.ts +53 -0
  45. package/templates/action-rpg/src/render/exposure.ts +111 -0
  46. package/templates/action-rpg/src/render/exposureGraph.ts +178 -0
  47. package/templates/action-rpg/src/render/exposureReadback.ts +79 -0
  48. package/templates/action-rpg/src/render/heightFog.ts +118 -0
  49. package/templates/action-rpg/src/render/lighting.ts +26 -1
  50. package/templates/action-rpg/src/render/materialAssignments.ts +160 -0
  51. package/templates/action-rpg/src/render/materialLighting.ts +155 -0
  52. package/templates/action-rpg/src/render/postprocessing.ts +17 -2
  53. package/templates/action-rpg/src/render/quality.ts +61 -2
  54. package/templates/action-rpg/src/render/sky.ts +21 -1
  55. package/templates/action-rpg/src/render/vfx.ts +133 -58
  56. package/templates/action-rpg/src/render/worldEnvironment.ts +433 -30
  57. package/templates/action-rpg/src/scenes/Play.ts +81 -16
  58. package/templates/action-rpg/threenative.config.ts +3 -0
  59. package/templates/action-rpg/vite.config.ts +10 -2
  60. package/templates/minimal/AGENTS.md +9 -10
  61. package/templates/minimal/CLAUDE.md +9 -10
  62. package/templates/minimal/package.json +9 -8
  63. package/templates/minimal/playtests/play.playtest.json +7 -1
  64. package/templates/minimal/playtests/sky.playtest.json +10 -1
  65. package/templates/minimal/src/render/autoExposure.ts +225 -0
  66. package/templates/minimal/src/render/backlightControls.ts +66 -0
  67. package/templates/minimal/src/render/backlightMaterial.ts +147 -0
  68. package/templates/minimal/src/render/environmentContribution.ts +188 -0
  69. package/templates/minimal/src/render/environmentRadiance.ts +36 -0
  70. package/templates/minimal/src/render/environmentSampleCache.ts +43 -0
  71. package/templates/minimal/src/render/environmentSampling.ts +193 -0
  72. package/templates/minimal/src/render/environmentSnapshot.ts +53 -0
  73. package/templates/minimal/src/render/exposure.ts +111 -0
  74. package/templates/minimal/src/render/exposureGraph.ts +178 -0
  75. package/templates/minimal/src/render/exposureReadback.ts +79 -0
  76. package/templates/minimal/src/render/heightFog.ts +118 -0
  77. package/templates/minimal/src/render/lighting.ts +25 -1
  78. package/templates/minimal/src/render/materialAssignments.ts +102 -0
  79. package/templates/minimal/src/render/materialLighting.ts +146 -0
  80. package/templates/minimal/src/render/postprocessing.ts +16 -2
  81. package/templates/minimal/src/render/quality.ts +60 -2
  82. package/templates/minimal/src/render/sky.ts +21 -1
  83. package/templates/minimal/src/render/worldEnvironment.ts +433 -30
  84. package/templates/minimal/src/scenes/Play.ts +50 -1
  85. package/templates/minimal/vite.config.ts +10 -2
  86. package/templates/platformer/AGENTS.md +7 -5
  87. package/templates/platformer/CLAUDE.md +7 -5
  88. package/templates/platformer/package.json +11 -9
  89. package/templates/platformer/playtests/performance.playtest.json +7 -1
  90. package/templates/platformer/src/render/autoExposure.ts +225 -0
  91. package/templates/platformer/src/render/backlightControls.ts +66 -0
  92. package/templates/platformer/src/render/backlightMaterial.ts +147 -0
  93. package/templates/platformer/src/render/environmentContribution.ts +188 -0
  94. package/templates/platformer/src/render/environmentRadiance.ts +36 -0
  95. package/templates/platformer/src/render/environmentSampleCache.ts +43 -0
  96. package/templates/platformer/src/render/environmentSampling.ts +193 -0
  97. package/templates/platformer/src/render/environmentSnapshot.ts +53 -0
  98. package/templates/platformer/src/render/exposure.ts +111 -0
  99. package/templates/platformer/src/render/exposureGraph.ts +178 -0
  100. package/templates/platformer/src/render/exposureReadback.ts +79 -0
  101. package/templates/platformer/src/render/heightFog.ts +118 -0
  102. package/templates/platformer/src/render/lighting.ts +26 -1
  103. package/templates/platformer/src/render/materialAssignments.ts +160 -0
  104. package/templates/platformer/src/render/materialLighting.ts +155 -0
  105. package/templates/platformer/src/render/materials.ts +7 -2
  106. package/templates/platformer/src/render/palette.ts +3 -3
  107. package/templates/platformer/src/render/postprocessing.ts +17 -2
  108. package/templates/platformer/src/render/quality.ts +61 -2
  109. package/templates/platformer/src/render/sky.ts +72 -23
  110. package/templates/platformer/src/render/skyEnvironment.ts +50 -0
  111. package/templates/platformer/src/render/worldEnvironment.ts +433 -30
  112. package/templates/platformer/src/scenes/Play.ts +70 -6
  113. package/templates/platformer/vite.config.ts +10 -2
  114. package/templates/puzzle/AGENTS.md +10 -9
  115. package/templates/puzzle/CLAUDE.md +10 -9
  116. package/templates/puzzle/package.json +11 -9
  117. package/templates/puzzle/playtests/boot-failure.playtest.json +2 -2
  118. package/templates/puzzle/playtests/lit.playtest.json +7 -1
  119. package/templates/puzzle/playtests/performance.playtest.json +7 -1
  120. package/templates/puzzle/src/render/autoExposure.ts +225 -0
  121. package/templates/puzzle/src/render/backlightControls.ts +66 -0
  122. package/templates/puzzle/src/render/backlightMaterial.ts +147 -0
  123. package/templates/puzzle/src/render/environmentContribution.ts +188 -0
  124. package/templates/puzzle/src/render/environmentRadiance.ts +36 -0
  125. package/templates/puzzle/src/render/environmentSampleCache.ts +43 -0
  126. package/templates/puzzle/src/render/environmentSampling.ts +193 -0
  127. package/templates/puzzle/src/render/environmentSnapshot.ts +53 -0
  128. package/templates/puzzle/src/render/exposure.ts +111 -0
  129. package/templates/puzzle/src/render/exposureGraph.ts +178 -0
  130. package/templates/puzzle/src/render/exposureReadback.ts +79 -0
  131. package/templates/puzzle/src/render/heightFog.ts +118 -0
  132. package/templates/puzzle/src/render/lighting.ts +33 -1
  133. package/templates/puzzle/src/render/materialAssignments.ts +160 -0
  134. package/templates/puzzle/src/render/materialLighting.ts +155 -0
  135. package/templates/puzzle/src/render/materials.ts +1 -1
  136. package/templates/puzzle/src/render/postprocessing.ts +8 -2
  137. package/templates/puzzle/src/render/quality.ts +62 -1
  138. package/templates/puzzle/src/render/sky.ts +20 -1
  139. package/templates/puzzle/src/render/worldEnvironment.ts +433 -30
  140. package/templates/puzzle/src/scenes/Play.ts +51 -2
  141. package/templates/puzzle/vite.config.ts +10 -2
  142. package/templates/racing/AGENTS.md +8 -7
  143. package/templates/racing/CLAUDE.md +8 -7
  144. package/templates/racing/package.json +11 -9
  145. package/templates/racing/playtests/performance.playtest.json +7 -1
  146. package/templates/racing/playtests/survives.playtest.json +6 -0
  147. package/templates/racing/src/render/autoExposure.ts +225 -0
  148. package/templates/racing/src/render/backlightControls.ts +66 -0
  149. package/templates/racing/src/render/backlightMaterial.ts +147 -0
  150. package/templates/racing/src/render/environmentContribution.ts +188 -0
  151. package/templates/racing/src/render/environmentRadiance.ts +36 -0
  152. package/templates/racing/src/render/environmentSampleCache.ts +43 -0
  153. package/templates/racing/src/render/environmentSampling.ts +193 -0
  154. package/templates/racing/src/render/environmentSnapshot.ts +53 -0
  155. package/templates/racing/src/render/exposure.ts +111 -0
  156. package/templates/racing/src/render/exposureGraph.ts +178 -0
  157. package/templates/racing/src/render/exposureReadback.ts +79 -0
  158. package/templates/racing/src/render/heightFog.ts +118 -0
  159. package/templates/racing/src/render/lighting.ts +29 -1
  160. package/templates/racing/src/render/materialAssignments.ts +160 -0
  161. package/templates/racing/src/render/materialLighting.ts +155 -0
  162. package/templates/racing/src/render/palette.ts +1 -10
  163. package/templates/racing/src/render/postprocessing.ts +17 -2
  164. package/templates/racing/src/render/quality.ts +61 -2
  165. package/templates/racing/src/render/shapes.ts +0 -25
  166. package/templates/racing/src/render/sky.ts +21 -1
  167. package/templates/racing/src/render/worldEnvironment.ts +433 -30
  168. package/templates/racing/src/scenes/Race.ts +91 -3
  169. package/templates/racing/src/track/circuit.ts +0 -9
  170. package/templates/racing/vite.config.ts +10 -2
  171. package/templates/rain/.codex/config.toml +19 -0
  172. package/templates/rain/.cursor/mcp.json +32 -0
  173. package/templates/rain/.gemini/settings.json +32 -0
  174. package/templates/rain/.mcp.json +32 -0
  175. package/templates/rain/.vscode/mcp.json +36 -0
  176. package/templates/rain/.zed/settings.json +36 -0
  177. package/templates/rain/AGENTS.md +95 -0
  178. package/templates/rain/CLAUDE.md +97 -0
  179. package/templates/rain/assets/rain-loop.wav +0 -0
  180. package/templates/rain/assets/thunder.wav +0 -0
  181. package/templates/rain/assets/wind-loop.wav +0 -0
  182. package/templates/rain/index.html +18 -0
  183. package/templates/rain/kit.json +7 -0
  184. package/templates/rain/native-playtests/boot.playtest.json +23 -0
  185. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  186. package/templates/rain/opencode.json +41 -0
  187. package/templates/rain/package.json +59 -0
  188. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  189. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  190. package/templates/rain/playtests/automation.playtest.json +133 -0
  191. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  192. package/templates/rain/playtests/flash.playtest.json +27 -0
  193. package/templates/rain/playtests/fly.playtest.json +54 -0
  194. package/templates/rain/playtests/lightning.playtest.json +220 -0
  195. package/templates/rain/playtests/loading.playtest.json +57 -0
  196. package/templates/rain/playtests/paused.playtest.json +59 -0
  197. package/templates/rain/playtests/performance.playtest.json +32 -0
  198. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  199. package/templates/rain/playtests/simulation.playtest.json +20 -0
  200. package/templates/rain/playtests/storm.playtest.json +150 -0
  201. package/templates/rain/playtests/survives.playtest.json +58 -0
  202. package/templates/rain/playtests/tiers.playtest.json +194 -0
  203. package/templates/rain/playtests/weather.playtest.json +77 -0
  204. package/templates/rain/public/favicon.svg +5 -0
  205. package/templates/rain/src/audio/storm.ts +314 -0
  206. package/templates/rain/src/game.ts +81 -0
  207. package/templates/rain/src/main.ts +15 -0
  208. package/templates/rain/src/render/autoExposure.ts +225 -0
  209. package/templates/rain/src/render/bloom-shader.ts +65 -0
  210. package/templates/rain/src/render/camera.ts +160 -0
  211. package/templates/rain/src/render/clouds-shader.ts +242 -0
  212. package/templates/rain/src/render/clouds.ts +142 -0
  213. package/templates/rain/src/render/exposure.ts +111 -0
  214. package/templates/rain/src/render/exposureGraph.ts +178 -0
  215. package/templates/rain/src/render/exposureReadback.ts +79 -0
  216. package/templates/rain/src/render/lighting.ts +39 -0
  217. package/templates/rain/src/render/lightning.ts +360 -0
  218. package/templates/rain/src/render/loading.ts +327 -0
  219. package/templates/rain/src/render/materials.ts +19 -0
  220. package/templates/rain/src/render/noise-volume.ts +159 -0
  221. package/templates/rain/src/render/palette.ts +18 -0
  222. package/templates/rain/src/render/post-shader.ts +178 -0
  223. package/templates/rain/src/render/postprocessing.ts +229 -0
  224. package/templates/rain/src/render/quality.ts +161 -0
  225. package/templates/rain/src/render/rain.ts +299 -0
  226. package/templates/rain/src/render/sky.ts +28 -0
  227. package/templates/rain/src/render/world-shader.ts +680 -0
  228. package/templates/rain/src/render/world.ts +146 -0
  229. package/templates/rain/src/render/worldEnvironment.ts +1212 -0
  230. package/templates/rain/src/scenes/Boot.ts +348 -0
  231. package/templates/rain/src/state.ts +261 -0
  232. package/templates/rain/src/style.css +1160 -0
  233. package/templates/rain/src/ui/App.tsx +29 -0
  234. package/templates/rain/src/ui/GameUi.tsx +187 -0
  235. package/templates/rain/src/ui/Hud.tsx +327 -0
  236. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  237. package/templates/rain/src/ui/Menu.tsx +370 -0
  238. package/templates/rain/src/ui/automation.ts +60 -0
  239. package/templates/rain/src/ui/main.tsx +7 -0
  240. package/templates/rain/src/ui/tempest.ts +149 -0
  241. package/templates/rain/tailwind.config.ts +2 -0
  242. package/templates/rain/threenative.config.ts +66 -0
  243. package/templates/rain/tools/generate-shaders.mjs +656 -0
  244. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  245. package/templates/rain/tools/storm-dsp.mjs +177 -0
  246. package/templates/rain/tools/tempest-bloom.frag +10 -0
  247. package/templates/rain/tools/tempest-clouds.frag +86 -0
  248. package/templates/rain/tools/tempest-post.frag +47 -0
  249. package/templates/rain/tools/tempest-world.frag +210 -0
  250. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  251. package/templates/rain/tsconfig.json +17 -0
  252. package/templates/rain/vite.config.ts +45 -0
  253. package/templates/rts/AGENTS.md +10 -11
  254. package/templates/rts/CLAUDE.md +10 -11
  255. package/templates/rts/package.json +10 -8
  256. package/templates/rts/playtests/performance.playtest.json +7 -1
  257. package/templates/rts/playtests/rts-ai-attack.playtest.json +10 -1
  258. package/templates/rts/playtests/rts-attack.playtest.json +10 -1
  259. package/templates/rts/playtests/rts-build.playtest.json +10 -1
  260. package/templates/rts/playtests/rts-orders.playtest.json +7 -1
  261. package/templates/rts/playtests/rts-train.playtest.json +10 -1
  262. package/templates/rts/src/render/army.ts +10 -2
  263. package/templates/rts/src/render/autoExposure.ts +225 -0
  264. package/templates/rts/src/render/backlightControls.ts +66 -0
  265. package/templates/rts/src/render/backlightMaterial.ts +147 -0
  266. package/templates/rts/src/render/environmentContribution.ts +188 -0
  267. package/templates/rts/src/render/environmentRadiance.ts +36 -0
  268. package/templates/rts/src/render/environmentSampleCache.ts +43 -0
  269. package/templates/rts/src/render/environmentSampling.ts +193 -0
  270. package/templates/rts/src/render/environmentSnapshot.ts +53 -0
  271. package/templates/rts/src/render/exposure.ts +111 -0
  272. package/templates/rts/src/render/exposureGraph.ts +178 -0
  273. package/templates/rts/src/render/exposureReadback.ts +79 -0
  274. package/templates/rts/src/render/heightFog.ts +118 -0
  275. package/templates/rts/src/render/lighting.ts +26 -1
  276. package/templates/rts/src/render/materialAssignments.ts +160 -0
  277. package/templates/rts/src/render/materialLighting.ts +155 -0
  278. package/templates/rts/src/render/postprocessing.ts +8 -2
  279. package/templates/rts/src/render/quality.ts +61 -2
  280. package/templates/rts/src/render/sky.ts +21 -1
  281. package/templates/rts/src/render/worldEnvironment.ts +433 -30
  282. package/templates/rts/src/scenes/Play.ts +54 -3
  283. package/templates/rts/src/sim/ai.ts +0 -1
  284. package/templates/rts/src/sim/terrain.ts +0 -4
  285. package/templates/rts/vite.config.ts +10 -2
  286. package/templates/runner/AGENTS.md +10 -8
  287. package/templates/runner/CLAUDE.md +10 -8
  288. package/templates/runner/package.json +11 -9
  289. package/templates/runner/playtests/performance.playtest.json +10 -1
  290. package/templates/runner/src/physics.ts +0 -1
  291. package/templates/runner/src/render/autoExposure.ts +225 -0
  292. package/templates/runner/src/render/backlightControls.ts +66 -0
  293. package/templates/runner/src/render/backlightMaterial.ts +147 -0
  294. package/templates/runner/src/render/environmentContribution.ts +188 -0
  295. package/templates/runner/src/render/environmentRadiance.ts +36 -0
  296. package/templates/runner/src/render/environmentSampleCache.ts +43 -0
  297. package/templates/runner/src/render/environmentSampling.ts +193 -0
  298. package/templates/runner/src/render/environmentSnapshot.ts +53 -0
  299. package/templates/runner/src/render/exposure.ts +111 -0
  300. package/templates/runner/src/render/exposureGraph.ts +178 -0
  301. package/templates/runner/src/render/exposureReadback.ts +79 -0
  302. package/templates/runner/src/render/heightFog.ts +118 -0
  303. package/templates/runner/src/render/lighting.ts +26 -1
  304. package/templates/runner/src/render/materialAssignments.ts +160 -0
  305. package/templates/runner/src/render/materialLighting.ts +155 -0
  306. package/templates/runner/src/render/postprocessing.ts +17 -2
  307. package/templates/runner/src/render/quality.ts +61 -2
  308. package/templates/runner/src/render/sky.ts +21 -1
  309. package/templates/runner/src/render/worldEnvironment.ts +433 -30
  310. package/templates/runner/src/scenes/Run.ts +67 -2
  311. package/templates/runner/threenative.config.ts +3 -0
  312. package/templates/runner/vite.config.ts +10 -2
  313. package/templates/sailing/AGENTS.md +14 -13
  314. package/templates/sailing/CLAUDE.md +14 -13
  315. package/templates/sailing/native-playtests/survives.playtest.json +7 -0
  316. package/templates/sailing/package.json +11 -9
  317. package/templates/sailing/playtests/live/render-motion.playtest.json +30 -0
  318. package/templates/sailing/src/entities/Ship.ts +38 -18
  319. package/templates/sailing/src/render/autoExposure.ts +225 -0
  320. package/templates/sailing/src/render/backlightControls.ts +66 -0
  321. package/templates/sailing/src/render/backlightMaterial.ts +147 -0
  322. package/templates/sailing/src/render/camera.ts +12 -4
  323. package/templates/sailing/src/render/environmentContribution.ts +188 -0
  324. package/templates/sailing/src/render/environmentRadiance.ts +36 -0
  325. package/templates/sailing/src/render/environmentSampleCache.ts +43 -0
  326. package/templates/sailing/src/render/environmentSampling.ts +193 -0
  327. package/templates/sailing/src/render/environmentSetup.ts +24 -0
  328. package/templates/sailing/src/render/environmentSnapshot.ts +53 -0
  329. package/templates/sailing/src/render/exposure.ts +111 -0
  330. package/templates/sailing/src/render/exposureGraph.ts +178 -0
  331. package/templates/sailing/src/render/exposureReadback.ts +79 -0
  332. package/templates/sailing/src/render/heightFog.ts +118 -0
  333. package/templates/sailing/src/render/lighting.ts +26 -1
  334. package/templates/sailing/src/render/materialAssignments.ts +160 -0
  335. package/templates/sailing/src/render/materialLighting.ts +155 -0
  336. package/templates/sailing/src/render/ocean.ts +71 -53
  337. package/templates/sailing/src/render/postprocessing.ts +16 -2
  338. package/templates/sailing/src/render/props.ts +0 -45
  339. package/templates/sailing/src/render/quality.ts +61 -1
  340. package/templates/sailing/src/render/sky.ts +21 -1
  341. package/templates/sailing/src/render/worldEnvironment.ts +433 -30
  342. package/templates/sailing/src/scenes/Boot.ts +12 -1
  343. package/templates/sailing/src/scenes/Sailing.ts +87 -2
  344. package/templates/sailing/src/scenes/ocean-readiness.ts +68 -0
  345. package/templates/sailing/threenative.config.ts +3 -0
  346. package/templates/sailing/vite.config.ts +10 -2
  347. package/templates/shooter/AGENTS.md +8 -6
  348. package/templates/shooter/CLAUDE.md +8 -6
  349. package/templates/shooter/package.json +11 -9
  350. package/templates/shooter/playtests/performance.playtest.json +7 -1
  351. package/templates/shooter/src/entities/Enemy.ts +0 -15
  352. package/templates/shooter/src/entities/Rifle.ts +38 -1
  353. package/templates/shooter/src/render/autoExposure.ts +225 -0
  354. package/templates/shooter/src/render/backlightControls.ts +66 -0
  355. package/templates/shooter/src/render/backlightMaterial.ts +147 -0
  356. package/templates/shooter/src/render/camera.ts +1 -12
  357. package/templates/shooter/src/render/decals.ts +299 -5
  358. package/templates/shooter/src/render/environmentContribution.ts +188 -0
  359. package/templates/shooter/src/render/environmentRadiance.ts +36 -0
  360. package/templates/shooter/src/render/environmentSampleCache.ts +43 -0
  361. package/templates/shooter/src/render/environmentSampling.ts +193 -0
  362. package/templates/shooter/src/render/environmentSnapshot.ts +53 -0
  363. package/templates/shooter/src/render/exposure.ts +111 -0
  364. package/templates/shooter/src/render/exposureGraph.ts +178 -0
  365. package/templates/shooter/src/render/exposureReadback.ts +79 -0
  366. package/templates/shooter/src/render/gunfx.ts +0 -1
  367. package/templates/shooter/src/render/heightFog.ts +118 -0
  368. package/templates/shooter/src/render/lighting.ts +26 -1
  369. package/templates/shooter/src/render/materialAssignments.ts +160 -0
  370. package/templates/shooter/src/render/materialLighting.ts +155 -0
  371. package/templates/shooter/src/render/postprocessing.ts +17 -2
  372. package/templates/shooter/src/render/quality.ts +61 -2
  373. package/templates/shooter/src/render/scale.ts +2 -93
  374. package/templates/shooter/src/render/sky.ts +21 -1
  375. package/templates/shooter/src/render/vehicles.ts +0 -17
  376. package/templates/shooter/src/render/worldEnvironment.ts +433 -30
  377. package/templates/shooter/src/scenes/Play.ts +64 -2
  378. package/templates/shooter/vite.config.ts +10 -2
  379. package/templates/snow/.codex/config.toml +19 -0
  380. package/templates/snow/.cursor/mcp.json +32 -0
  381. package/templates/snow/.gemini/settings.json +32 -0
  382. package/templates/snow/.mcp.json +32 -0
  383. package/templates/snow/.vscode/mcp.json +36 -0
  384. package/templates/snow/.zed/settings.json +36 -0
  385. package/templates/snow/AGENTS.md +90 -0
  386. package/templates/snow/CLAUDE.md +92 -0
  387. package/templates/snow/README.md +26 -0
  388. package/templates/snow/assets/crunch.wav +0 -0
  389. package/templates/snow/assets/wind.wav +0 -0
  390. package/templates/snow/index.html +12 -0
  391. package/templates/snow/kit.json +7 -0
  392. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  393. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  394. package/templates/snow/opencode.json +41 -0
  395. package/templates/snow/package.json +60 -0
  396. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  397. package/templates/snow/playtests/performance.playtest.json +36 -0
  398. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  399. package/templates/snow/playtests/survives.playtest.json +56 -0
  400. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  401. package/templates/snow/playtests/weather.playtest.json +119 -0
  402. package/templates/snow/public/favicon.svg +5 -0
  403. package/templates/snow/src/audio.ts +58 -0
  404. package/templates/snow/src/commands.ts +8 -0
  405. package/templates/snow/src/entities/Explorer.ts +279 -0
  406. package/templates/snow/src/game.ts +69 -0
  407. package/templates/snow/src/main.ts +15 -0
  408. package/templates/snow/src/render/autoExposure.ts +225 -0
  409. package/templates/snow/src/render/backlightControls.ts +66 -0
  410. package/templates/snow/src/render/backlightMaterial.ts +147 -0
  411. package/templates/snow/src/render/bootPrint.ts +50 -0
  412. package/templates/snow/src/render/camera.ts +84 -0
  413. package/templates/snow/src/render/environmentContribution.ts +188 -0
  414. package/templates/snow/src/render/environmentRadiance.ts +36 -0
  415. package/templates/snow/src/render/environmentSampleCache.ts +43 -0
  416. package/templates/snow/src/render/environmentSampling.ts +193 -0
  417. package/templates/snow/src/render/environmentSnapshot.ts +53 -0
  418. package/templates/snow/src/render/explorer.ts +321 -0
  419. package/templates/snow/src/render/exposure.ts +111 -0
  420. package/templates/snow/src/render/exposureGraph.ts +178 -0
  421. package/templates/snow/src/render/exposureReadback.ts +79 -0
  422. package/templates/snow/src/render/heightFog.ts +118 -0
  423. package/templates/snow/src/render/lighting.ts +82 -0
  424. package/templates/snow/src/render/loading.ts +325 -0
  425. package/templates/snow/src/render/materialAssignments.ts +160 -0
  426. package/templates/snow/src/render/materialLighting.ts +155 -0
  427. package/templates/snow/src/render/materials.ts +36 -0
  428. package/templates/snow/src/render/palette.ts +17 -0
  429. package/templates/snow/src/render/postprocessing.ts +58 -0
  430. package/templates/snow/src/render/props.ts +42 -0
  431. package/templates/snow/src/render/quality.ts +193 -0
  432. package/templates/snow/src/render/scenery.ts +244 -0
  433. package/templates/snow/src/render/sky.ts +76 -0
  434. package/templates/snow/src/render/snowSurface.ts +259 -0
  435. package/templates/snow/src/render/touch-controls.ts +143 -0
  436. package/templates/snow/src/render/weather.ts +279 -0
  437. package/templates/snow/src/render/worldEnvironment.ts +1212 -0
  438. package/templates/snow/src/scenes/Boot.ts +12 -0
  439. package/templates/snow/src/scenes/Snow.ts +663 -0
  440. package/templates/snow/src/state.ts +46 -0
  441. package/templates/snow/src/style.css +143 -0
  442. package/templates/snow/src/terrain.ts +64 -0
  443. package/templates/snow/src/ui/App.tsx +15 -0
  444. package/templates/snow/src/ui/Controls.tsx +322 -0
  445. package/templates/snow/src/ui/GameUi.tsx +354 -0
  446. package/templates/snow/src/ui/icons.tsx +54 -0
  447. package/templates/snow/src/ui/main.tsx +7 -0
  448. package/templates/snow/tailwind.config.ts +2 -0
  449. package/templates/snow/threenative.config.ts +54 -0
  450. package/templates/snow/tsconfig.json +17 -0
  451. package/templates/snow/vite.config.ts +45 -0
  452. package/templates/starter/AGENTS.md +11 -16
  453. package/templates/starter/CLAUDE.md +11 -16
  454. package/templates/starter/native-playtests/react-hud.playtest.json +1 -1
  455. package/templates/starter/native-playtests/render-chain.playtest.json +51 -8
  456. package/templates/starter/native-playtests/smooth-motion.playtest.json +64 -0
  457. package/templates/starter/package.json +11 -9
  458. package/templates/starter/playtests/live/smooth-motion.playtest.json +63 -0
  459. package/templates/starter/playtests/movement.playtest.json +192 -0
  460. package/templates/starter/playtests/play.playtest.json +18 -2
  461. package/templates/starter/playtests/production-readiness.playtest.json +1 -1
  462. package/templates/starter/public/grade.cube +735 -0
  463. package/templates/starter/src/entities/Crate.ts +4 -0
  464. package/templates/starter/src/entities/Player.ts +79 -18
  465. package/templates/starter/src/game.ts +1 -0
  466. package/templates/starter/src/render/adaptiveQuality.ts +28 -41
  467. package/templates/starter/src/render/autoExposure.ts +225 -0
  468. package/templates/starter/src/render/backlightControls.ts +66 -0
  469. package/templates/starter/src/render/backlightMaterial.ts +147 -0
  470. package/templates/starter/src/render/environmentContribution.ts +188 -0
  471. package/templates/starter/src/render/environmentRadiance.ts +36 -0
  472. package/templates/starter/src/render/environmentSampleCache.ts +43 -0
  473. package/templates/starter/src/render/environmentSampling.ts +193 -0
  474. package/templates/starter/src/render/environmentSnapshot.ts +53 -0
  475. package/templates/starter/src/render/exposure.ts +111 -0
  476. package/templates/starter/src/render/exposureGraph.ts +178 -0
  477. package/templates/starter/src/render/exposureReadback.ts +79 -0
  478. package/templates/starter/src/render/grade.ts +157 -0
  479. package/templates/starter/src/render/heightFog.ts +118 -0
  480. package/templates/starter/src/render/lighting.ts +26 -1
  481. package/templates/starter/src/render/materialAssignments.ts +160 -0
  482. package/templates/starter/src/render/materialLighting.ts +155 -0
  483. package/templates/starter/src/render/postprocessing.ts +84 -4
  484. package/templates/starter/src/render/quality.ts +80 -8
  485. package/templates/starter/src/render/qualityPolicy.ts +54 -0
  486. package/templates/starter/src/render/rendererGate.ts +36 -0
  487. package/templates/starter/src/render/sky.ts +23 -1
  488. package/templates/starter/src/render/temporalAA.ts +197 -0
  489. package/templates/starter/src/render/temporalAAFrame.ts +179 -0
  490. package/templates/starter/src/render/temporalAAHooks.ts +101 -0
  491. package/templates/starter/src/render/temporalAAInput.ts +56 -0
  492. package/templates/starter/src/render/temporalAAResolve.ts +65 -0
  493. package/templates/starter/src/render/temporalAAStage.ts +76 -0
  494. package/templates/starter/src/render/temporalCurrentArea.ts +31 -0
  495. package/templates/starter/src/render/temporalCurrentFootprint.ts +198 -0
  496. package/templates/starter/src/render/temporalCurrentFootprintMath.ts +41 -0
  497. package/templates/starter/src/render/temporalCurrentProducer.ts +161 -0
  498. package/templates/starter/src/render/temporalCurrentReplay.ts +160 -0
  499. package/templates/starter/src/render/temporalCurrentSelection.ts +89 -0
  500. package/templates/starter/src/render/temporalCurrentVisibility.ts +170 -0
  501. package/templates/starter/src/render/temporalDepthSamples.ts +34 -0
  502. package/templates/starter/src/render/temporalRejectionCounter.ts +179 -0
  503. package/templates/starter/src/render/temporalResolve.ts +139 -0
  504. package/templates/starter/src/render/temporalResolveDepth.ts +193 -0
  505. package/templates/starter/src/render/temporalResolveMath.ts +196 -0
  506. package/templates/starter/src/render/volumetricFog.ts +124 -0
  507. package/templates/starter/src/render/volumetricFogOptions.ts +96 -0
  508. package/templates/starter/src/render/volumetricFogTransport.ts +176 -0
  509. package/templates/starter/src/render/volumetricFogVolume.ts +139 -0
  510. package/templates/starter/src/render/worldEnvironment.ts +433 -30
  511. package/templates/starter/src/scenes/Play.ts +110 -1
  512. package/templates/starter/src/state.ts +1 -0
  513. package/templates/starter/src/ui/Hud.tsx +1 -1
  514. package/templates/starter/src/ui/Menu.tsx +1 -1
  515. package/templates/starter/tools/make-grade-lut.mjs +101 -0
  516. package/templates/starter/vite.config.ts +10 -2
  517. package/templates/tower-defense/AGENTS.md +10 -9
  518. package/templates/tower-defense/CLAUDE.md +10 -9
  519. package/templates/tower-defense/package.json +11 -9
  520. package/templates/tower-defense/playtests/performance.playtest.json +7 -1
  521. package/templates/tower-defense/src/render/autoExposure.ts +225 -0
  522. package/templates/tower-defense/src/render/backlightControls.ts +66 -0
  523. package/templates/tower-defense/src/render/backlightMaterial.ts +147 -0
  524. package/templates/tower-defense/src/render/environmentContribution.ts +188 -0
  525. package/templates/tower-defense/src/render/environmentRadiance.ts +36 -0
  526. package/templates/tower-defense/src/render/environmentSampleCache.ts +43 -0
  527. package/templates/tower-defense/src/render/environmentSampling.ts +193 -0
  528. package/templates/tower-defense/src/render/environmentSnapshot.ts +53 -0
  529. package/templates/tower-defense/src/render/exposure.ts +111 -0
  530. package/templates/tower-defense/src/render/exposureGraph.ts +178 -0
  531. package/templates/tower-defense/src/render/exposureReadback.ts +79 -0
  532. package/templates/tower-defense/src/render/lighting.ts +33 -1
  533. package/templates/tower-defense/src/render/materialAssignments.ts +160 -0
  534. package/templates/tower-defense/src/render/materialLighting.ts +155 -0
  535. package/templates/tower-defense/src/render/postprocessing.ts +8 -2
  536. package/templates/tower-defense/src/render/quality.ts +61 -2
  537. package/templates/tower-defense/src/render/shapes.ts +0 -3
  538. package/templates/tower-defense/src/render/worldEnvironment.ts +433 -30
  539. package/templates/tower-defense/src/scenes/Battle.ts +65 -2
  540. package/templates/tower-defense/vite.config.ts +10 -2
  541. package/templates/minimal/src/scenes/Boot.ts +0 -5
@@ -0,0 +1,225 @@
1
+ // Generated for you: ordinary Three.js GPU metering; exposure.ts owns the game's look.
2
+ import { type RenderTarget, Texture, Vector2 } from "three";
3
+ import { float, ivec2, nodeObject, texture, textureLoad, uniform, vec4 } from "three/tsl";
4
+ import {
5
+ type Node,
6
+ type NodeBuilder,
7
+ type NodeFrame,
8
+ NodeMaterial,
9
+ NodeUpdateType,
10
+ QuadMesh,
11
+ type Renderer,
12
+ RendererUtils,
13
+ TempNode,
14
+ } from "three/webgpu";
15
+ import {
16
+ type IExposureSettings,
17
+ exposureLuminance,
18
+ exposureMeter,
19
+ exposureReductionSizes,
20
+ validateExposureSettings,
21
+ } from "./exposure.js";
22
+
23
+ import {
24
+ type ColourTexture,
25
+ type Decode,
26
+ type Meter,
27
+ adaptExposure,
28
+ exposureBins,
29
+ exposureTarget,
30
+ exposureTiles,
31
+ histogramExposure,
32
+ histogramTiles,
33
+ reduceExposure,
34
+ } from "./exposureGraph.js";
35
+ import { ExposureReadback } from "./exposureReadback.js";
36
+
37
+ /** Scene-referred exposure changes light, never coverage/compositing alpha. */
38
+ export function applyExposure(colour: Node<"vec4">, exposure: Node<"float">): Node<"vec4"> {
39
+ return vec4(colour.rgb.mul(exposure), colour.a);
40
+ }
41
+
42
+ /** Owns scratch targets only. Never draws the world or installs another output transform. */
43
+ export class AutoExposureNode extends TempNode<"float"> {
44
+ static get type(): string {
45
+ return "AutoExposureNode";
46
+ }
47
+ readonly input: ColourTexture;
48
+ readonly settings: Readonly<IExposureSettings>;
49
+ readonly #constant: number;
50
+ readonly #size = new Vector2();
51
+ readonly #sourceSize = uniform(new Vector2(1, 1));
52
+ readonly #reduceSize = uniform(new Vector2(1, 1));
53
+ readonly #blockSize = uniform(new Vector2(1, 1));
54
+ readonly #delta = uniform(0);
55
+ readonly #resetMode = uniform(1); // 0 = history, 1 = seed, 2 = next measured target
56
+ readonly #seed = uniform(0);
57
+ readonly #enabled = uniform(false);
58
+ readonly #quad = new QuadMesh();
59
+ readonly #meterMaterial = new NodeMaterial();
60
+ readonly #reduceMaterial = new NodeMaterial();
61
+ readonly #tilesMaterial = new NodeMaterial();
62
+ readonly #histogramMaterial = new NodeMaterial();
63
+ readonly #adaptMaterial = new NodeMaterial();
64
+ readonly #tilesTarget = exposureTarget();
65
+ readonly #histogramTarget = exposureTarget();
66
+ #readTarget = exposureTarget();
67
+ #writeTarget = exposureTarget();
68
+ #levels: RenderTarget[] = [];
69
+ readonly #reduced = texture(new Texture());
70
+ readonly #blocks = texture(new Texture());
71
+ readonly #previous = texture(this.#readTarget.texture);
72
+ readonly #result = texture(this.#writeTarget.texture);
73
+ #disposed = false;
74
+ readonly #observation: ExposureReadback;
75
+ // Three's runtime accepts undefined on first use, but its declaration requires a state.
76
+ #rendererState: Parameters<typeof RendererUtils.resetRendererState>[1] | undefined;
77
+
78
+ constructor(
79
+ input: ColourTexture,
80
+ settings: IExposureSettings,
81
+ constantExposure: number,
82
+ meter: Meter = (colour, uv) => exposureMeter(colour, uv),
83
+ decode: Decode = (mean) => exposureLuminance(mean),
84
+ ) {
85
+ super("float");
86
+ validateExposureSettings(settings);
87
+ if (!Number.isFinite(Math.fround(constantExposure)) || Math.fround(constantExposure) <= 0)
88
+ throw new Error("Exposure constant must be finite and positive.");
89
+ this.input = input;
90
+ this.settings = Object.freeze({ ...settings });
91
+ const policy = this.settings;
92
+ this.#constant = constantExposure;
93
+ this.#seed.value = Math.log2(settings.initialExposure);
94
+ this.#enabled.value = settings.enabled;
95
+ this.#observation = new ExposureReadback(constantExposure, () => this.#enabled.value);
96
+ this.updateBeforeType = NodeUpdateType.FRAME;
97
+ this.#meterMaterial.fragmentNode = reduceExposure(input, this.#sourceSize, meter);
98
+ this.#reduceMaterial.fragmentNode = reduceExposure(this.#reduced, this.#reduceSize);
99
+ this.#tilesTarget.setSize(exposureBins, exposureTiles);
100
+ this.#histogramTarget.setSize(exposureBins, 1);
101
+ this.#tilesMaterial.fragmentNode = histogramTiles(this.#blocks, this.#blockSize, policy);
102
+ this.#histogramMaterial.fragmentNode = histogramExposure(texture(this.#tilesTarget.texture));
103
+ this.#adaptMaterial.fragmentNode = adaptExposure(
104
+ texture(this.#histogramTarget.texture),
105
+ this.#previous,
106
+ this.#resetMode,
107
+ this.#seed,
108
+ this.#delta,
109
+ policy,
110
+ decode,
111
+ );
112
+ }
113
+
114
+ override setup(builder: NodeBuilder): Node<"float"> {
115
+ // Force the existing pass dependency even in disabled mode; off never means unmeasured.
116
+ super.setup(builder);
117
+ return this.#enabled.select(
118
+ textureLoad(this.#result, ivec2(0)).r.exp2(),
119
+ float(this.#constant),
120
+ );
121
+ }
122
+
123
+ get exposureNode(): Node<"float"> {
124
+ return nodeObject(this);
125
+ }
126
+
127
+ reset(exposure?: number): void {
128
+ if (this.#disposed) throw new Error("Exposure node is disposed.");
129
+ if (
130
+ exposure !== undefined &&
131
+ (!Number.isFinite(Math.fround(exposure)) || Math.fround(exposure) <= 0)
132
+ )
133
+ throw new Error("Exposure reset must be finite and positive.");
134
+ this.#resetMode.value = exposure === undefined ? 2 : 1;
135
+ if (exposure !== undefined) this.#seed.value = Math.log2(exposure);
136
+ this.#observation.invalidate();
137
+ }
138
+
139
+ setEnabled(enabled: boolean): void {
140
+ if (typeof enabled !== "boolean") throw new Error("Exposure enabled must be boolean.");
141
+ if (this.#disposed) throw new Error("Exposure node is disposed.");
142
+ this.#enabled.value = enabled;
143
+ this.#observation.invalidate();
144
+ }
145
+
146
+ getObservation(): Record<string, unknown> {
147
+ return this.#observation.get();
148
+ }
149
+
150
+ override updateBefore(frame: NodeFrame): undefined {
151
+ if (this.#disposed) throw new Error("Exposure node is disposed.");
152
+ const renderer = frame.renderer;
153
+ if (renderer === null) throw new Error("Exposure requires a renderer.");
154
+ if (!Number.isFinite(frame.deltaTime) || frame.deltaTime < 0 || !Number.isFinite(frame.time))
155
+ throw new Error("Exposure frame time must be finite and nonnegative.");
156
+ renderer.getDrawingBufferSize(this.#size);
157
+ // Level 0 meters 4x4 pixels, level 1 averages 16x16. The histogram gathers level 1.
158
+ const sizes = exposureReductionSizes(this.#size.x, this.#size.y).slice(0, 2);
159
+ this.#sourceSize.value.copy(this.#size);
160
+ this.#delta.value = Math.min(frame.deltaTime, this.settings.maxDelta);
161
+ while (this.#levels.length > sizes.length) this.#levels.pop()?.dispose();
162
+ for (const [i, [width, height]] of sizes.entries()) {
163
+ const level = this.#levels[i] ?? exposureTarget();
164
+ this.#levels[i] = level;
165
+ level.setSize(width, height);
166
+ }
167
+ this.#rendererState ??= RendererUtils.saveRendererState(renderer);
168
+ this.#rendererState = RendererUtils.resetRendererState(renderer, this.#rendererState);
169
+ try {
170
+ for (const [i, level] of this.#levels.entries()) {
171
+ const previous = this.#levels[i - 1];
172
+ if (previous !== undefined) {
173
+ this.#reduced.value = previous.texture;
174
+ this.#reduceSize.value.set(previous.width, previous.height);
175
+ }
176
+ this.#quad.material = i === 0 ? this.#meterMaterial : this.#reduceMaterial;
177
+ renderer.setRenderTarget(level);
178
+ this.#quad.render(renderer);
179
+ }
180
+ const final = this.#levels.at(-1);
181
+ if (final === undefined) throw new Error("Exposure reduction is empty.");
182
+ this.#blocks.value = final.texture;
183
+ this.#blockSize.value.set(final.width, final.height);
184
+ this.#quad.material = this.#tilesMaterial;
185
+ renderer.setRenderTarget(this.#tilesTarget);
186
+ this.#quad.render(renderer);
187
+ this.#quad.material = this.#histogramMaterial;
188
+ renderer.setRenderTarget(this.#histogramTarget);
189
+ this.#quad.render(renderer);
190
+ const write = this.#writeTarget;
191
+ this.#previous.value = this.#readTarget.texture;
192
+ this.#quad.material = this.#adaptMaterial;
193
+ renderer.setRenderTarget(write);
194
+ this.#quad.render(renderer);
195
+ this.#result.value = write.texture;
196
+ this.#writeTarget = this.#readTarget;
197
+ this.#readTarget = write;
198
+ this.#resetMode.value = 0;
199
+ this.#observation.report(renderer, write, frame.time, this.settings.reportInterval);
200
+ } finally {
201
+ RendererUtils.restoreRendererState(renderer, this.#rendererState);
202
+ }
203
+ }
204
+
205
+ override dispose(): void {
206
+ if (this.#disposed) return;
207
+ this.#disposed = true;
208
+ this.#observation.dispose();
209
+ for (const level of [
210
+ ...this.#levels,
211
+ this.#tilesTarget,
212
+ this.#histogramTarget,
213
+ this.#readTarget,
214
+ this.#writeTarget,
215
+ ])
216
+ level.dispose();
217
+ this.#levels = [];
218
+ this.#meterMaterial.dispose();
219
+ this.#reduceMaterial.dispose();
220
+ this.#tilesMaterial.dispose();
221
+ this.#histogramMaterial.dispose();
222
+ this.#adaptMaterial.dispose();
223
+ super.dispose();
224
+ }
225
+ }
@@ -0,0 +1,65 @@
1
+ // Transcribed once by Three.js's own GLSL to TSL transpiler from tools/tempest-bloom.frag, and maintained
2
+ // here by hand since: `tools/generate-shaders.mjs` regenerates only the coast and cloud shaders.
3
+ // Keep the .frag in step when you change this file.
4
+ //
5
+ // The demo's exact bloom: a 5x5 gaussian at twice the input texel size, masked by a soft-knee
6
+ // luminance threshold and normalised by the weight it actually accumulated — not by 25, so the
7
+ // frame's corners, where the kernel hangs off the target, cannot dim. Rendered at quarter
8
+ // resolution: see src/render/postprocessing.ts.
9
+ import { DataTexture, Vector2, Vector3, Vector4 } from "three";
10
+ import {
11
+ Fn,
12
+ Loop,
13
+ exp,
14
+ float,
15
+ frameGroup,
16
+ int,
17
+ max,
18
+ smoothstep,
19
+ texture,
20
+ uniform,
21
+ vec2,
22
+ vec3,
23
+ vec4,
24
+ } from "three/tsl";
25
+ import type { Node, TextureNode } from "three/webgpu";
26
+
27
+ // Uniforms the shader reads. Values are assigned by src/render/world.ts and src/render/clouds.ts,
28
+ // which own the camera basis and the weather; the generated module only holds the nodes.
29
+ const uScenePlaceholder = new DataTexture(new Uint8Array([0, 0, 0, 255]), 1, 1);
30
+ uScenePlaceholder.needsUpdate = true;
31
+ export let uScene: TextureNode = texture(uScenePlaceholder).setGroup(frameGroup);
32
+ export function setScene(value: TextureNode): void {
33
+ uScene = value;
34
+ }
35
+ export const uRes = uniform(new Vector2(), "vec2").setGroup(frameGroup);
36
+
37
+ // Three.js Transpiler r185
38
+
39
+ export const tempestBloom = /*@__PURE__*/ Fn(([vUv]: [Node<"vec2">]) => {
40
+ const c = vec3(0).toVar();
41
+ const w = float(0).toVar();
42
+
43
+ Loop(
44
+ { start: int(-2), end: int(2), condition: "<=" },
45
+ { start: int(-2), end: int(2), condition: "<=" },
46
+ ({ i, j }) => {
47
+ const wt = exp(
48
+ float(j.mul(j).add(i.mul(i)))
49
+ .negate()
50
+ .mul(0.32),
51
+ ).toVar();
52
+ // `vUv` is the bloom quad's own geometry uv, bottom-up; the scene it reads is a render target
53
+ // whose first row is the top of the frame. Unflipped, every highlight blooms mirrored about
54
+ // the horizon — the lamp's glow hung in the sky above it.
55
+ const s = uScene
56
+ .sample(vec2(vUv.x, vUv.y.oneMinus()).add(vec2(float(j), float(i)).div(uRes).mul(2)))
57
+ .rgb.toVar();
58
+ const l = max(s.r, max(s.g, s.b)).toVar();
59
+ c.addAssign(s.mul(smoothstep(0.7, 1.6, l)).mul(wt));
60
+ w.addAssign(wt);
61
+ },
62
+ );
63
+
64
+ return vec4(c.div(w), 1);
65
+ });
@@ -0,0 +1,160 @@
1
+ // Generated for you. Framing is a game-owned decision.
2
+ //
3
+ // The rig, not the scene: everything that decides where the camera stands and what it looks at
4
+ // lives here, so the scene is left wiring lifecycle and publishing state.
5
+ import { Euler, MathUtils, type PerspectiveCamera, Vector3 } from "three";
6
+
7
+ /** The view the game opens on, and the one `resetCamera` returns to. */
8
+ export interface IHomeView {
9
+ readonly pitch: number;
10
+ readonly position: Vector3;
11
+ readonly yaw: number;
12
+ }
13
+
14
+ export const HOME: IHomeView = {
15
+ pitch: 0.21,
16
+ position: new Vector3(1.8, 2.85, 18),
17
+ yaw: -0.085,
18
+ };
19
+
20
+ const PITCH_RANGE: readonly [number, number] = [-0.7, 1.25];
21
+ const WALK_SPEED = 6;
22
+ const RUN_SPEED = 23;
23
+ const LOOK_SENSITIVITY = 0.0023;
24
+
25
+ /** How far the free camera may roam: the coast runs along -z, the sea is at +x. */
26
+ const BOUNDS = {
27
+ maxX: 220,
28
+ maxY: 110,
29
+ maxZ: 90,
30
+ minX: -100,
31
+ minY: 1.65,
32
+ minZ: -350,
33
+ } as const;
34
+
35
+ /**
36
+ * What the rig needs from the engine's input. Structural on purpose: `src/render/` is ordinary
37
+ * Three.js and must not import a package.
38
+ */
39
+ export interface ICameraInput {
40
+ pressed(name: string): boolean;
41
+ raw: {
42
+ readonly pointer: {
43
+ readonly buttons: number;
44
+ readonly down: boolean;
45
+ };
46
+ };
47
+ /**
48
+ * `move` is the key vector; `look` is the drag's motion since the last tick, in pixels — the
49
+ * engine samples it at the tick, so the raw pointer's own counter is already spent.
50
+ */
51
+ vector(name: string): { x: number; y: number };
52
+ }
53
+
54
+ export interface ICameraRig {
55
+ /** Camera-space forward, flat on the ground: what WASD walks along. */
56
+ readonly forward: Vector3;
57
+ readonly heading: number;
58
+ readonly position: Vector3;
59
+ readonly right: Vector3;
60
+ readonly up: Vector3;
61
+ /** True while a key or a drag is asking for the camera, which cancels the cinematic orbit. */
62
+ readonly manual: boolean;
63
+ reset(): void;
64
+ update(dt: number, elapsed: number, input: ICameraInput, cinematic: boolean): void;
65
+ }
66
+
67
+ export function setupCamera(camera: PerspectiveCamera): void {
68
+ camera.fov = 55;
69
+ // Match the source projection/depth coefficients: 1.00012*d - 0.300018.
70
+ camera.near = 0.15;
71
+ camera.far = 2500;
72
+ camera.position.copy(HOME.position);
73
+ camera.updateProjectionMatrix();
74
+ }
75
+
76
+ const LEFT_MOUSE = 1;
77
+
78
+ export function createCameraRig(camera: PerspectiveCamera): ICameraRig {
79
+ const position = HOME.position.clone();
80
+ const rotation = new Euler(0, 0, 0, "YXZ");
81
+ const forward = new Vector3();
82
+ const right = new Vector3();
83
+ const up = new Vector3();
84
+ const worldUp = new Vector3(0, 1, 0);
85
+ let yaw = HOME.yaw;
86
+ let pitch = HOME.pitch;
87
+ let manual = false;
88
+
89
+ const orient = (): void => {
90
+ // The rig stores yaw as the compass heading it publishes, so a reset and a drag agree on
91
+ // sign instead of each carrying their own.
92
+ rotation.set(pitch, -yaw, 0, "YXZ");
93
+ camera.quaternion.setFromEuler(rotation);
94
+ forward.set(Math.sin(yaw) * Math.cos(pitch), Math.sin(pitch), -Math.cos(yaw) * Math.cos(pitch));
95
+ right.crossVectors(forward, worldUp).normalize();
96
+ up.crossVectors(right, forward);
97
+ };
98
+
99
+ const reset = (): void => {
100
+ position.copy(HOME.position);
101
+ yaw = HOME.yaw;
102
+ pitch = HOME.pitch;
103
+ orient();
104
+ };
105
+
106
+ reset();
107
+
108
+ return {
109
+ forward,
110
+ get heading() {
111
+ return Math.round(((yaw * 180) / Math.PI + 360) % 360);
112
+ },
113
+ get manual() {
114
+ return manual;
115
+ },
116
+ position,
117
+ reset,
118
+ right,
119
+ up,
120
+ update(dt, elapsed, input, cinematic) {
121
+ const move = input.vector("move");
122
+ const altitude = Number(input.pressed("ascend")) - Number(input.pressed("descend"));
123
+ const boost = input.pressed("boost");
124
+ const dragging = input.raw.pointer.down && (input.raw.pointer.buttons & LEFT_MOUSE) !== 0;
125
+ manual = move.x !== 0 || move.y !== 0 || altitude !== 0 || boost || dragging;
126
+ if (cinematic && !manual) {
127
+ // A slow orbit of the opening view: the coast stays in frame while the weather plays out.
128
+ position.set(
129
+ HOME.position.x + Math.sin(elapsed * 0.08) * 1.6,
130
+ HOME.position.y + Math.sin(elapsed * 0.06) * 0.16,
131
+ HOME.position.z + Math.cos(elapsed * 0.07) * 1.8,
132
+ );
133
+ yaw = HOME.yaw + Math.sin(elapsed * 0.045) * 0.12;
134
+ pitch = HOME.pitch + Math.sin(elapsed * 0.06) * 0.027;
135
+ orient();
136
+ camera.position.copy(position);
137
+ return;
138
+ }
139
+ if (dragging) {
140
+ const look = input.vector("look");
141
+ yaw += look.x * LOOK_SENSITIVITY;
142
+ pitch = MathUtils.clamp(pitch - look.y * LOOK_SENSITIVITY, PITCH_RANGE[0], PITCH_RANGE[1]);
143
+ }
144
+ // Yaw only, so walking never climbs the hill the camera is standing on.
145
+ const flatForward = new Vector3(Math.sin(yaw), 0, -Math.cos(yaw));
146
+ const flatRight = new Vector3(Math.cos(yaw), 0, Math.sin(yaw));
147
+ const speed = dt * (boost ? RUN_SPEED : WALK_SPEED);
148
+ position.addScaledVector(flatForward, speed * move.y);
149
+ position.addScaledVector(flatRight, speed * move.x);
150
+ position.y += speed * altitude;
151
+ position.set(
152
+ MathUtils.clamp(position.x, BOUNDS.minX, BOUNDS.maxX),
153
+ MathUtils.clamp(position.y, BOUNDS.minY, BOUNDS.maxY),
154
+ MathUtils.clamp(position.z, BOUNDS.minZ, BOUNDS.maxZ),
155
+ );
156
+ orient();
157
+ camera.position.copy(position);
158
+ },
159
+ };
160
+ }
@@ -0,0 +1,242 @@
1
+ // GENERATED FILE — do not edit it. Every line below is the output of Three.js's own GLSL to
2
+ // TSL transpiler, run over tools/tempest-clouds.frag. That .frag file
3
+ // is the source of truth; change it and the generator, never this file.
4
+ //
5
+ // node tools/generate-shaders.mjs
6
+ //
7
+ // The shader is the storm ceiling: a raymarched volume between 145 and 815 metres, lit by a
8
+ // five-tap march toward the sun and filled from a procedural 64³ noise volume. It is one full-screen
9
+ // pass into a render target the coast samples — see src/render/clouds.ts.
10
+ import { Data3DTexture, Vector2, Vector3, Vector4 } from "three";
11
+ import {
12
+ Break,
13
+ Fn,
14
+ If,
15
+ Loop,
16
+ abs,
17
+ add,
18
+ clamp,
19
+ depth,
20
+ dot,
21
+ exp,
22
+ float,
23
+ floor,
24
+ fract,
25
+ frameGroup,
26
+ int,
27
+ length,
28
+ mat2,
29
+ max,
30
+ min,
31
+ mix,
32
+ mul,
33
+ normalize,
34
+ pow,
35
+ screenCoordinate,
36
+ smoothstep,
37
+ sub,
38
+ texture3D,
39
+ uniform,
40
+ vec2,
41
+ vec3,
42
+ vec4,
43
+ } from "three/tsl";
44
+ import type { Node, TextureNode } from "three/webgpu";
45
+
46
+ // Uniforms the shader reads. Values are assigned by src/render/world.ts and src/render/clouds.ts,
47
+ // which own the camera basis and the weather; the generated module only holds the nodes.
48
+ export const uTime = uniform(0, "float").setGroup(frameGroup);
49
+ export const uCloud = uniform(0, "float").setGroup(frameGroup);
50
+ export const uWind = uniform(0, "float").setGroup(frameGroup);
51
+ export const uFlash = uniform(0, "float").setGroup(frameGroup);
52
+ export const uAspect = uniform(0, "float").setGroup(frameGroup);
53
+ export const uTan = uniform(0, "float").setGroup(frameGroup);
54
+ export const uCam = uniform(new Vector3(), "vec3").setGroup(frameGroup);
55
+ export const uForward = uniform(new Vector3(), "vec3").setGroup(frameGroup);
56
+ export const uRight = uniform(new Vector3(), "vec3").setGroup(frameGroup);
57
+ export const uUp = uniform(new Vector3(), "vec3").setGroup(frameGroup);
58
+ export const uStrike = uniform(new Vector3(), "vec3").setGroup(frameGroup);
59
+ export const uSunDir = uniform(new Vector3(), "vec3").setGroup(frameGroup);
60
+ export const uSkyLow = uniform(new Vector3(), "vec3").setGroup(frameGroup);
61
+ export const uSkyHigh = uniform(new Vector3(), "vec3").setGroup(frameGroup);
62
+ const uNoisePlaceholder = new Data3DTexture(new Uint8Array([0, 0, 0, 255]), 1, 1, 1);
63
+ uNoisePlaceholder.needsUpdate = true;
64
+ export let uNoise: TextureNode = texture3D(uNoisePlaceholder).setGroup(frameGroup);
65
+ export function setNoise(value: TextureNode): void {
66
+ uNoise = value;
67
+ }
68
+ export const uSteps = uniform(0, "int").setGroup(frameGroup);
69
+
70
+ // Three.js Transpiler r185
71
+
72
+ // Polyfills
73
+
74
+ const gl_FragCoord = vec3(screenCoordinate.x, screenCoordinate.y.oneMinus(), depth);
75
+
76
+ // The look, owned by src/render/{sky,lighting}.ts and set from there every run.
77
+
78
+ export const hash12 = /*@__PURE__*/ Fn(([p]: [Node<"vec2">]) => {
79
+ const p3 = fract(vec3(p.xyx).mul(0.1031)).toVar();
80
+ p3.addAssign(dot(p3, p3.yzx.add(33.33)));
81
+
82
+ return fract(p3.x.add(p3.y).mul(p3.z));
83
+ });
84
+
85
+ export const hash13 = /*@__PURE__*/ Fn(([p_immutable]: [Node<"vec3">]) => {
86
+ const p = p_immutable.toVar();
87
+ p.assign(fract(p.mul(0.1031)));
88
+ p.addAssign(dot(p, p.zyx.add(31.32)));
89
+
90
+ return fract(p.x.add(p.y).mul(p.z));
91
+ });
92
+
93
+ export const noise2 = /*@__PURE__*/ Fn(([p]: [Node<"vec2">]) => {
94
+ const i = floor(p).toVar();
95
+ const f = fract(p).toVar();
96
+ f.assign(f.mul(f).mul(sub(3, mul(2, f))));
97
+
98
+ return mix(
99
+ mix(hash12(i), hash12(i.add(vec2(1, 0))), f.x),
100
+ mix(hash12(i.add(vec2(0, 1))), hash12(i.add(1)), f.x),
101
+ f.y,
102
+ );
103
+ });
104
+
105
+ export const fbm2 = /*@__PURE__*/ Fn(([p_immutable]: [Node<"vec2">]) => {
106
+ const p = p_immutable.toVar();
107
+ const v = mul(0.5, noise2(p)).toVar();
108
+ p.assign(mat2(0.8, 0.6, -0.6, 0.8).mul(p).mul(2.03).add(19.1));
109
+ v.addAssign(mul(0.25, noise2(p)));
110
+ p.assign(p.mul(2.02).add(9.3));
111
+ v.addAssign(mul(0.125, noise2(p)));
112
+
113
+ return v.add(mul(0.0625, noise2(p.mul(2.01).add(17))));
114
+ });
115
+
116
+ export const ray = /*@__PURE__*/ Fn(([uv]: [Node<"vec2">]) => {
117
+ const q = uv.mul(2).sub(1).toVar();
118
+
119
+ return normalize(
120
+ uForward.add(uRight.mul(q.x).mul(uAspect).mul(uTan)).add(uUp.mul(q.y).mul(uTan)),
121
+ );
122
+ });
123
+
124
+ export const project = /*@__PURE__*/ Fn(([p]: [Node<"vec3">]) => {
125
+ const v = p.sub(uCam).toVar();
126
+ const d = dot(v, uForward).toVar();
127
+
128
+ return vec4(
129
+ dot(v, uRight).div(uAspect.mul(uTan)),
130
+ dot(v, uUp).div(uTan),
131
+ mul(1.00012, d).sub(0.300018),
132
+ d,
133
+ );
134
+ });
135
+
136
+ export const density = /*@__PURE__*/ Fn(([p]: [Node<"vec3">]) => {
137
+ // One value, one return, for the reason given in the coast's `baseColor`: the transpiler turns a
138
+ // GLSL early return into a JavaScript return that only leaves the `If` callback the node graph is
139
+ // being built inside, so the branch would never be assigned. The guard is kept as a guard, so a
140
+ // clear sky still costs one comparison and no noise fetches.
141
+
142
+ const res = float(0).toVar();
143
+
144
+ If(uCloud.greaterThanEqual(0.005), () => {
145
+ const drift = vec3(uTime.mul(add(2, uWind.mul(13))), 0, uTime.mul(1.2)).toVar();
146
+ const q = p.add(drift).mul(0.00105).toVar();
147
+ q.y.mulAssign(1.4);
148
+ const n = uNoise.sample(q).toVar();
149
+ const broad = n.r
150
+ .mul(0.76)
151
+ .add(uNoise.sample(q.mul(2.07).add(vec3(0.1, 0.3, 0.7))).r.mul(0.24))
152
+ .toVar();
153
+
154
+ // Flattened condensation base with turbulent billows above it.
155
+
156
+ const h = p.y.sub(145).div(670).toVar();
157
+ const base = smoothstep(0, 0.09, h)
158
+ .mul(sub(1, smoothstep(0.68, 1, h)))
159
+ .toVar();
160
+ const shape = broad.add(uCloud.mul(0.3)).sub(0.72).toVar();
161
+ const edge = uNoise.sample(q.mul(3.81)).b.sub(0.5).mul(0.12).toVar();
162
+ res.assign(clamp(shape.sub(edge).mul(5.1), 0, 1).mul(base));
163
+ });
164
+
165
+ return res;
166
+ });
167
+
168
+ export const lightAt = /*@__PURE__*/ Fn(([p_immutable, l]: [Node<"vec3">, Node<"vec3">]) => {
169
+ const p = p_immutable.toVar();
170
+ const sum = float(0).toVar();
171
+ const stepLen = float(28).toVar();
172
+
173
+ Loop({ start: int(0), end: 5 }, ({ i }) => {
174
+ p.addAssign(l.mul(stepLen));
175
+ sum.addAssign(density(p).mul(stepLen));
176
+ stepLen.mulAssign(1.7);
177
+ });
178
+
179
+ return exp(sum.negate().mul(0.015));
180
+ });
181
+
182
+ export const tempestClouds = /*@__PURE__*/ Fn(([vUv]: [Node<"vec2">]) => {
183
+ const rd = ray(vUv).toVar();
184
+ rd.y.assign(abs(rd.y));
185
+ rd.assign(normalize(rd));
186
+ const sunDir = uSunDir.toVar();
187
+ const mu = dot(rd, sunDir).toVar();
188
+ const sky = mix(uSkyLow, uSkyHigh, pow(clamp(rd.y, 0, 1), 0.62)).toVar();
189
+ sky.addAssign(vec3(0.31, 0.27, 0.205).mul(pow(max(mu, 0), 14)));
190
+ sky.addAssign(vec3(0.7, 0.57, 0.37).mul(pow(max(mu, 0), 140)));
191
+ sky.addAssign(uFlash.mul(vec3(0.14, 0.22, 0.36)));
192
+ const t0 = max(0, sub(145, uCam.y).div(max(rd.y, 0.008))).toVar();
193
+ const t1 = min(10500, sub(815, uCam.y).div(max(rd.y, 0.008))).toVar();
194
+ const col = vec4(sky, 1).toVar();
195
+
196
+ If(t0.lessThan(t1), () => {
197
+ const dt = t1.sub(t0).div(float(uSteps)).toVar();
198
+ const jitter = hash12(gl_FragCoord.xy).mul(0.75).add(0.12).toVar();
199
+ const light = vec3(0).toVar();
200
+ const trans = float(1).toVar();
201
+ const phase = add(0.45, mul(0.65, pow(max(mu, 0), 5))).toVar();
202
+
203
+ Loop({ start: int(0), end: 96 }, ({ i }) => {
204
+ If(i.greaterThanEqual(uSteps).or(trans.lessThan(0.008)), () => {
205
+ Break();
206
+ });
207
+
208
+ const t = t0.add(float(i).add(jitter).mul(dt)).toVar();
209
+ const p = uCam.add(rd.mul(t)).toVar();
210
+ const d = density(p).toVar();
211
+
212
+ If(d.greaterThan(0.002), () => {
213
+ const sun = lightAt(p, sunDir).toVar();
214
+ const height = clamp(p.y.sub(145).div(670), 0, 1).toVar();
215
+ const ambient = mix(vec3(0.035, 0.061, 0.079), vec3(0.19, 0.25, 0.28), height).toVar();
216
+
217
+ // A small multiple-scattering/powder approximation prevents crushed cloud cores.
218
+
219
+ const c = ambient
220
+ .mul(add(0.7, mul(0.45, sub(1, exp(d.negate().mul(3))))))
221
+ .add(vec3(0.97, 0.94, 0.85).mul(sun).mul(phase).mul(0.7))
222
+ .toVar();
223
+ const glow = exp(
224
+ length(p.sub(uStrike).mul(vec3(1, 0.5, 1)))
225
+ .negate()
226
+ .mul(0.0022),
227
+ ).toVar();
228
+ c.addAssign(vec3(0.85, 1.18, 1.9).mul(uFlash).mul(glow).mul(1.2));
229
+ const absorb = sub(1, exp(d.negate().mul(dt).mul(0.02))).toVar();
230
+ light.addAssign(trans.mul(absorb).mul(c));
231
+ trans.mulAssign(sub(1, absorb));
232
+ });
233
+ });
234
+
235
+ const marched = light.add(trans.mul(sky)).toVar();
236
+ const atmospheric = sub(1, exp(t0.negate().mul(0.000075))).toVar();
237
+ marched.assign(mix(marched, sky, atmospheric.mul(0.66)));
238
+ col.assign(vec4(marched, sub(1, trans)));
239
+ });
240
+
241
+ return col;
242
+ });