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,244 @@
1
+ // Generated for you. The forest, rocks, grass stems and the far ridge are this game's look.
2
+ // Everything here is ordinary Three.js built from code; nothing is loaded.
3
+ import {
4
+ BufferGeometry,
5
+ Color,
6
+ ConeGeometry,
7
+ CylinderGeometry,
8
+ Float32BufferAttribute,
9
+ Group,
10
+ InstancedMesh,
11
+ LineSegments,
12
+ Mesh,
13
+ Object3D,
14
+ PlaneGeometry,
15
+ SphereGeometry,
16
+ Vector3,
17
+ } from "three";
18
+ import { terrainHeight } from "../terrain.js";
19
+ import type { SnowMaterials } from "./materials.js";
20
+
21
+ /** A round obstacle the explorer walks around: centre and radius on the ground plane. */
22
+ export interface IObstacle {
23
+ readonly x: number;
24
+ readonly z: number;
25
+ readonly radius: number;
26
+ readonly height: number;
27
+ }
28
+
29
+ function seededRandom(seed: number): () => number {
30
+ let state = seed;
31
+ return () => {
32
+ state = (state * 1664525 + 1013904223) >>> 0;
33
+ return state / 4294967296;
34
+ };
35
+ }
36
+
37
+ const smoothstep = (edge0: number, edge1: number, value: number) => {
38
+ const t = Math.max(0, Math.min(1, (value - edge0) / (edge1 - edge0)));
39
+ return t * t * (3 - 2 * t);
40
+ };
41
+
42
+ /** Glade-edge pines by hand, then a ring of forest further out. `[x, z, height]`. */
43
+ function treePlacements(random: () => number): Array<[number, number, number]> {
44
+ const trees: Array<[number, number, number]> = [
45
+ [-9, -6, 6.3],
46
+ [9, -5, 7.5],
47
+ [-11.5, 4, 8.2],
48
+ [10.5, 8, 6.4],
49
+ [-7, -14, 7.8],
50
+ [4, -17, 9],
51
+ [-17, -4, 6],
52
+ [16, -9, 9],
53
+ ];
54
+ for (let index = 0; index < 80; index += 1) {
55
+ const angle = random() * Math.PI * 2;
56
+ const radius = 20 + random() * 52;
57
+ trees.push([Math.sin(angle) * radius, Math.cos(angle) * radius, 4.5 + random() * 6.7]);
58
+ }
59
+ return trees;
60
+ }
61
+
62
+ /** Pines within this radius cast shadows; the shadow map only covers the glade anyway. */
63
+ const SHADOW_RADIUS = 26;
64
+
65
+ function forest(materials: SnowMaterials, random: () => number, obstacles: IObstacle[]): Group {
66
+ const placements = treePlacements(random);
67
+ const levels = 15;
68
+ const trunkGeometry = new CylinderGeometry(0.07, 0.14, 1, 9);
69
+ const branchGeometry = new ConeGeometry(1, 1, 7, 1);
70
+ const boughGeometry = new SphereGeometry(1, 6, 4);
71
+ // Two batches: the trees round the glade cast shadows, the far forest does not. One batch of
72
+ // every bough would put the whole forest — most of a million triangles — into the shadow pass.
73
+ const batches = [true, false].map((near) => {
74
+ const count = placements.filter(([x, z]) => Math.hypot(x, z) < SHADOW_RADIUS === near).length;
75
+ const capacity = count * levels * 6;
76
+ return {
77
+ boughs: new InstancedMesh(boughGeometry, materials.bough, capacity),
78
+ branches: new InstancedMesh(branchGeometry, materials.needles, capacity),
79
+ count: 0,
80
+ near,
81
+ trees: 0,
82
+ trunks: new InstancedMesh(trunkGeometry, materials.trunk, count),
83
+ };
84
+ });
85
+ const dummy = new Object3D();
86
+ const up = new Vector3(0, 1, 0);
87
+ const direction = new Vector3();
88
+ placements.forEach(([x, z, height], tree) => {
89
+ const batch = batches[Math.hypot(x, z) < SHADOW_RADIUS ? 0 : 1];
90
+ if (batch === undefined) return;
91
+ const root = terrainHeight(x, z);
92
+ const scale = height / 7;
93
+ dummy.position.set(x, root + height * 0.48, z);
94
+ dummy.rotation.set(0, 0, 0);
95
+ dummy.scale.set(scale, height, scale);
96
+ dummy.updateMatrix();
97
+ batch.trunks.setMatrixAt(batch.trees, dummy.matrix);
98
+ batch.trees += 1;
99
+ if (Math.hypot(x, z) < 20) obstacles.push({ height, radius: 0.23 * scale, x, z });
100
+ for (let level = 0; level < levels; level += 1) {
101
+ const t = level / levels;
102
+ const y = root + 0.75 + t * (height - 0.65);
103
+ const radius = (1 - t) * height * 0.23 + 0.055;
104
+ // A far tree keeps every tier, so its silhouette holds, with fewer and wider boughs per tier.
105
+ const around = level > 12 || !batch.near ? 4 : 6;
106
+ for (let index = 0; index < around; index += 1) {
107
+ const angle = (index / around) * Math.PI * 2 + level * 0.72 + tree * 1.37;
108
+ const reach = radius * (0.8 + random() * 0.3) * (batch.near ? 1 : 1.2);
109
+ const dx = Math.cos(angle);
110
+ const dz = Math.sin(angle);
111
+ dummy.position.set(x + dx * reach * 0.53, y - 0.06, z + dz * reach * 0.53);
112
+ dummy.quaternion.setFromUnitVectors(up, direction.set(dx, -0.2, dz).normalize());
113
+ dummy.scale.set(reach * 0.27, reach * 1.5, reach * 0.3);
114
+ dummy.updateMatrix();
115
+ batch.branches.setMatrixAt(batch.count, dummy.matrix);
116
+ dummy.position.set(x + dx * reach * 0.54, y + 0.11 * scale, z + dz * reach * 0.54);
117
+ dummy.rotation.set(0, -angle, 0);
118
+ dummy.scale.set(reach * 0.78, 0.13 * scale + reach * 0.09, reach * 0.32);
119
+ dummy.updateMatrix();
120
+ batch.boughs.setMatrixAt(batch.count, dummy.matrix);
121
+ batch.count += 1;
122
+ }
123
+ }
124
+ });
125
+ const group = new Group();
126
+ for (const batch of batches) {
127
+ batch.branches.count = batch.count;
128
+ batch.boughs.count = batch.count;
129
+ for (const mesh of [batch.trunks, batch.branches, batch.boughs]) {
130
+ mesh.castShadow = batch.near;
131
+ mesh.receiveShadow = true;
132
+ mesh.computeBoundingSphere();
133
+ group.add(mesh);
134
+ }
135
+ }
136
+ return group;
137
+ }
138
+
139
+ const ROCKS: ReadonlyArray<[number, number, number]> = [
140
+ [-5, 7, 1.15],
141
+ [-6.7, 7.8, 0.55],
142
+ [7, -8, 1.25],
143
+ [7.8, -7, 0.45],
144
+ [10, 1, 1.4],
145
+ [-10, -3, 0.85],
146
+ [-3, -10.5, 0.6],
147
+ [3, 10, 0.55],
148
+ ];
149
+
150
+ function rocks(materials: SnowMaterials, obstacles: IObstacle[]): Group {
151
+ const group = new Group();
152
+ ROCKS.forEach(([x, z, radius], index) => {
153
+ const geometry = new SphereGeometry(1, 15, 11);
154
+ const position = geometry.getAttribute("position");
155
+ for (let vertex = 0; vertex < position.count; vertex += 1) {
156
+ const px = position.getX(vertex);
157
+ const py = position.getY(vertex);
158
+ const pz = position.getZ(vertex);
159
+ const bump = 1 + 0.085 * Math.sin(px * 13 + py * 8) + 0.065 * Math.sin(pz * 15 + index);
160
+ position.setXYZ(vertex, px * bump, py * bump, pz * bump);
161
+ }
162
+ geometry.computeVertexNormals();
163
+ const y = terrainHeight(x, z) + radius * 0.25;
164
+ const rock = new Mesh(geometry, materials.rock);
165
+ rock.position.set(x, y, z);
166
+ rock.scale.set(radius, radius * 0.7, radius * 0.82);
167
+ rock.rotation.y = index * 1.7;
168
+ const cap = new Mesh(geometry, materials.bough);
169
+ cap.position.set(x, y + radius * 0.39, z);
170
+ cap.scale.set(radius * 0.98, radius * 0.36, radius * 0.84);
171
+ cap.rotation.y = rock.rotation.y;
172
+ for (const mesh of [rock, cap]) {
173
+ mesh.castShadow = true;
174
+ mesh.receiveShadow = true;
175
+ group.add(mesh);
176
+ }
177
+ obstacles.push({ height: radius * 1.1, radius: radius * 0.9, x, z });
178
+ });
179
+ return group;
180
+ }
181
+
182
+ /** Bare stems poking through the powder near the rocks show how deep the snow is. */
183
+ function stems(materials: SnowMaterials, random: () => number, depth: number): LineSegments {
184
+ const points: number[] = [];
185
+ for (let index = 0; index < 140; index += 1) {
186
+ const [rx, rz, radius] = ROCKS[index % ROCKS.length] as [number, number, number];
187
+ const angle = random() * Math.PI * 2;
188
+ const distance = radius + random() * 0.9;
189
+ const x = rx + Math.cos(angle) * distance;
190
+ const z = rz + Math.sin(angle) * distance;
191
+ const y = terrainHeight(x, z) + depth - 0.03;
192
+ const height = 0.14 + random() * 0.36;
193
+ points.push(x, y, z, x + (random() - 0.5) * 0.15, y + height, z + (random() - 0.5) * 0.15);
194
+ }
195
+ const geometry = new BufferGeometry();
196
+ geometry.setAttribute("position", new Float32BufferAttribute(points, 3));
197
+ return new LineSegments(geometry, materials.stem);
198
+ }
199
+
200
+ /** A continuous ridgeline behind the forest rather than repeated cone mountains. */
201
+ function ridge(materials: SnowMaterials): Mesh {
202
+ const geometry = new PlaneGeometry(240, 80, 240, 90);
203
+ geometry.rotateX(-Math.PI / 2);
204
+ geometry.translate(0, 0, -91);
205
+ const position = geometry.getAttribute("position");
206
+ for (let index = 0; index < position.count; index += 1) {
207
+ const x = position.getX(index);
208
+ const z = position.getZ(index);
209
+ const v = (z + 131) / 80;
210
+ const peaks =
211
+ 18 + 10 * Math.sin(x * 0.047 + 1) + 7 * Math.sin(x * 0.1 - 1) + 5 * Math.cos(x * 0.19);
212
+ const envelope = Math.sin(Math.max(0, Math.min(1, v)) * Math.PI) ** 1.65;
213
+ const ridges =
214
+ Math.abs(Math.sin(x * 0.31 + z * 0.27)) * 2.2 + Math.sin(x * 0.82 - z * 0.51) * 0.75;
215
+ position.setY(index, -1 + envelope * (peaks + ridges));
216
+ }
217
+ geometry.computeVertexNormals();
218
+ const normal = geometry.getAttribute("normal");
219
+ const colors: number[] = [];
220
+ const snowy = new Color(0xdce6ed);
221
+ const rockFace = new Color(0x536571);
222
+ const colour = new Color();
223
+ for (let index = 0; index < position.count; index += 1) {
224
+ const exposed = smoothstep(0.5, 0.88, 1 - normal.getY(index)) * 0.66;
225
+ const variation = 0.9 + 0.1 * Math.sin(position.getX(index) * 1.7 + position.getZ(index));
226
+ colour.copy(snowy).lerp(rockFace, exposed).multiplyScalar(variation);
227
+ colors.push(colour.r, colour.g, colour.b);
228
+ }
229
+ geometry.setAttribute("color", new Float32BufferAttribute(colors, 3));
230
+ return new Mesh(geometry, materials.ridge);
231
+ }
232
+
233
+ /** Builds the scenery and reports the obstacles in it, so collision follows what is drawn. */
234
+ export function createScenery(
235
+ materials: SnowMaterials,
236
+ depth: number,
237
+ ): { readonly root: Group; readonly obstacles: readonly IObstacle[] } {
238
+ const random = seededRandom(224);
239
+ const obstacles: IObstacle[] = [];
240
+ const root = new Group();
241
+ root.add(forest(materials, random, obstacles), rocks(materials, obstacles));
242
+ root.add(stems(materials, random, depth), ridge(materials));
243
+ return { obstacles, root };
244
+ }
@@ -0,0 +1,76 @@
1
+ // Generated for you. The sky is game-owned source, not an engine preset.
2
+ import {
3
+ BackSide,
4
+ BufferAttribute,
5
+ Color,
6
+ FogExp2,
7
+ Mesh,
8
+ MeshBasicMaterial,
9
+ type Scene,
10
+ SphereGeometry,
11
+ Vector3,
12
+ } from "three";
13
+ import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
14
+ import { palette } from "./palette.js";
15
+
16
+ const CLEAR_FOG = new Color(palette.skyLow);
17
+ const STORM_FOG = new Color(0xafc3d1);
18
+
19
+ /** The look this fog replaced: FogExp2 at 0.016, measured at 40 m from 2 m up. */
20
+ const EYE_LEVEL = { density: 0.016, distance: 40, cameraHeight: 2 };
21
+
22
+ /**
23
+ * The distance term's density that, with the height term, keeps the old eye-level haze: at
24
+ * `EYE_LEVEL.distance` along the horizon from `EYE_LEVEL.cameraHeight` the two together transmit what
25
+ * FogExp2 at `EYE_LEVEL.density` did. The distance term is lowered, never removed, so the ground
26
+ * still ends in fog at a kilometre.
27
+ */
28
+ function distanceDensity(p: HeightFogParams = HEIGHT_FOG): number {
29
+ const { distance, density, cameraHeight } = EYE_LEVEL;
30
+ const old = (density * distance) ** 2;
31
+ const height = heightFogDepth(p, cameraHeight, cameraHeight, distance) * Math.LN2;
32
+ return Math.sqrt(Math.max(0, old - height)) / distance;
33
+ }
34
+
35
+ /** A graded dome with a warm sun glow, plus the haze; returns how to darken both for a storm. */
36
+ export function setupSky(scene: Scene): (storm: number) => void {
37
+ const RADIUS = 450;
38
+ const geometry = new SphereGeometry(RADIUS, 40, 24);
39
+ const positions = geometry.getAttribute("position");
40
+ const colors = new Float32Array(positions.count * 3);
41
+ const top = new Color(palette.skyHigh);
42
+ const bottom = new Color(0xd6e2ea);
43
+ const sunGlow = new Color(0xffeedd);
44
+ const sun = { x: -0.6, y: 0.57, z: -0.56 };
45
+ const current = new Color();
46
+ for (let index = 0; index < positions.count; index += 1) {
47
+ const x = positions.getX(index) / RADIUS;
48
+ const y = Math.max(0, positions.getY(index) / RADIUS);
49
+ const z = positions.getZ(index) / RADIUS;
50
+ current.copy(bottom).lerp(top, y ** 0.58);
51
+ const toward = Math.max(0, x * sun.x + y * sun.y + z * sun.z);
52
+ current.lerp(sunGlow, toward ** 20 * 0.35);
53
+ colors.set([current.r, current.g, current.b], index * 3);
54
+ }
55
+ geometry.setAttribute("color", new BufferAttribute(colors, 3));
56
+ const material = new MeshBasicMaterial({
57
+ fog: false,
58
+ side: BackSide,
59
+ toneMapped: false,
60
+ vertexColors: true,
61
+ });
62
+ const dome = new Mesh(geometry, material);
63
+ dome.frustumCulled = false;
64
+ dome.renderOrder = -100;
65
+ scene.background = bottom;
66
+ scene.add(dome);
67
+ const fog = new FogExp2(CLEAR_FOG.getHex(), distanceDensity());
68
+ scene.fog = fog;
69
+ scene.fogNode = heightFogNode(fog, HEIGHT_FOG, new Vector3(sun.x, sun.y, sun.z));
70
+ return (storm) => {
71
+ fog.color.copy(CLEAR_FOG).lerp(STORM_FOG, storm);
72
+ // Thick enough to swallow the far forest, thin enough that the explorer stays readable.
73
+ fog.density = distanceDensity() + storm * 0.05;
74
+ material.color.setScalar(1 - storm * 0.3);
75
+ };
76
+ }
@@ -0,0 +1,259 @@
1
+ // Generated for you. How the snow looks: its colour, the blue in a pressed footprint, the
2
+ // compaction view, the glints. `SnowField` stores numbers; everything a screenshot shows is here.
3
+ import { BufferAttribute, type BufferGeometry, Mesh, PlaneGeometry } from "three";
4
+ import {
5
+ attribute,
6
+ color,
7
+ dot,
8
+ float,
9
+ floor,
10
+ fwidth,
11
+ hash,
12
+ max,
13
+ mix,
14
+ normalView,
15
+ normalWorld,
16
+ positionViewDirection,
17
+ positionWorld,
18
+ pow,
19
+ smoothstep,
20
+ uniform,
21
+ vec3,
22
+ } from "three/tsl";
23
+ import { MeshStandardNodeMaterial } from "three/webgpu";
24
+ import { terrainHeight } from "../terrain.js";
25
+ import { palette } from "./palette.js";
26
+
27
+ /** Per-vertex snow state the material reads: indentation (m) and compaction (0..1). */
28
+ const STATE = "snowState";
29
+ /** A window up to this many samples is redrawn at once; wider ones are sliced. */
30
+ const URGENT_CELLS = 12_000;
31
+ /** A wide window is spread over about this many frames, never fewer than eight rows a frame. */
32
+ const SLICE_FRAMES = 15;
33
+ const SLICE_ROWS = 8;
34
+
35
+ type Bounds = {
36
+ readonly column: number;
37
+ readonly columns: number;
38
+ readonly row: number;
39
+ readonly rows: number;
40
+ };
41
+
42
+ /** The parts of `SnowField` (and its `Heightfield`) this renderer reads, by shape. */
43
+ export interface ISnowSource {
44
+ readonly depth: number;
45
+ readonly field: {
46
+ readonly columns: number;
47
+ readonly rows: number;
48
+ readonly width: number;
49
+ readonly depth: number;
50
+ readonly origin: { readonly x: number; readonly z: number };
51
+ toGeometry(): BufferGeometry;
52
+ refreshGeometry(geometry: BufferGeometry, bounds?: Bounds): void;
53
+ toColliderHeights(): Float32Array;
54
+ };
55
+ takeDirtyRegion(): Bounds | undefined;
56
+ copyChannel(
57
+ channel: "indent" | "compaction",
58
+ bounds: Bounds,
59
+ target?: Float32Array,
60
+ ): Float32Array;
61
+ }
62
+
63
+ function union(current: Bounds | undefined, next: Bounds): Bounds {
64
+ if (current === undefined) return { ...next };
65
+ const column = Math.min(current.column, next.column);
66
+ const row = Math.min(current.row, next.row);
67
+ return {
68
+ column,
69
+ columns: Math.max(current.column + current.columns, next.column + next.columns) - column,
70
+ row,
71
+ rows: Math.max(current.row + current.rows, next.row + next.rows) - row,
72
+ };
73
+ }
74
+
75
+ export interface ISnowSurface {
76
+ readonly mesh: Mesh;
77
+ readonly outskirts: Mesh;
78
+ /**
79
+ * Take what the field wrote since the last call. Small windows — a footprint, a rolling ball —
80
+ * are drawn on the next frame; a window wider than `URGENT_CELLS` (snowfall refilling every
81
+ * track at once) is spread over the following frames a band of rows at a time.
82
+ */
83
+ collect(): void;
84
+ /** Push collected windows into the mesh; call once per drawn frame. */
85
+ refresh(): void;
86
+ /** Rows still waiting to be redrawn from a wide refill. */
87
+ readonly pendingRows: number;
88
+ /**
89
+ * Largest gap between a rendered vertex and the canonical surface, metres, after drawing every
90
+ * window still waiting: what the next frame shows, not a frame caught mid-redraw.
91
+ */
92
+ renderError(): number;
93
+ setCompactionView(on: boolean): void;
94
+ /** 0 clear .. 1 blizzard: dims the glints with the sun. */
95
+ setStorm(storm: number): void;
96
+ }
97
+
98
+ const floatUniform = () => uniform(0);
99
+ type FloatUniform = ReturnType<typeof floatUniform>;
100
+
101
+ function snowMaterial(compactionView: FloatUniform, sun: FloatUniform) {
102
+ const material = new MeshStandardNodeMaterial({ metalness: 0, roughness: 0.86 });
103
+ const state = attribute(STATE, "vec2" as const);
104
+ const indent = state.x;
105
+ const compaction = state.y;
106
+ // The hollow of a print darkens towards a cold blue; fresh powder keeps a faint grain.
107
+ const hollow = smoothstep(0.002, 0.11, indent);
108
+ const grain = hash(floor(positionWorld.xz.mul(1.8)));
109
+ const powder = color(palette.snow).mul(grain.mul(0.035).add(0.965));
110
+ const pressed = mix(powder, color(palette.shadow), hollow.mul(0.55).add(compaction.mul(0.1)));
111
+ // Print walls face away from the light: darken by slope so a footprint reads at a glance.
112
+ const wall = mix(float(0.8), float(1), smoothstep(0.55, 0.95, normalWorld.y));
113
+ const lit = pressed.mul(float(1).sub(hollow.mul(0.22))).mul(wall);
114
+ const debug = mix(vec3(0.22, 0.51, 0.67), vec3(0.95, 0.47, 0.16), compaction);
115
+ material.colorNode = mix(lit, debug, compactionView);
116
+ material.roughnessNode = mix(float(0.88), float(0.57), compaction);
117
+ // Ice crystals: one in a hundred tiny cells glints when it faces the eye. Faded out where a
118
+ // pixel covers several cells, so distant snow does not shimmer.
119
+ const crystal = hash(floor(positionWorld.xz.mul(120)));
120
+ const facing = pow(max(dot(normalView, positionViewDirection.negate()), 0), 12);
121
+ const fade = float(1).sub(smoothstep(0.01, 0.055, fwidth(positionWorld.x)));
122
+ material.emissiveNode = vec3(0.7, 0.85, 1).mul(
123
+ smoothstep(0.99, 1, crystal).mul(facing).mul(fade).mul(sun).mul(0.55),
124
+ );
125
+ return material;
126
+ }
127
+
128
+ export function createSnowSurface(snow: ISnowSource): ISnowSurface {
129
+ const field = snow.field;
130
+ const compactionView = floatUniform();
131
+ const sun = floatUniform();
132
+ sun.value = 1;
133
+ const material = snowMaterial(compactionView, sun);
134
+
135
+ const geometry = field.toGeometry();
136
+ const state = new BufferAttribute(new Float32Array(field.rows * field.columns * 2), 2);
137
+ geometry.setAttribute(STATE, state);
138
+ const mesh = new Mesh(geometry, material);
139
+ mesh.position.set(field.origin.x, 0, field.origin.z);
140
+ mesh.receiveShadow = true;
141
+ mesh.name = "snow";
142
+
143
+ // Beyond the playable field the ground keeps going under fresh, untouched snow. Inside the
144
+ // field it ducks under the deformable surface, so the seam at the edge never shows.
145
+ const outskirtsGeometry = new PlaneGeometry(340, 340, 110, 110);
146
+ outskirtsGeometry.rotateX(-Math.PI / 2);
147
+ const ring = outskirtsGeometry.getAttribute("position");
148
+ const half = field.width / 2;
149
+ for (let index = 0; index < ring.count; index += 1) {
150
+ const x = ring.getX(index);
151
+ const z = ring.getZ(index);
152
+ const edge = Math.max(Math.abs(x), Math.abs(z));
153
+ const inside = 1 - Math.min(1, Math.max(0, (edge - (half - 1.5)) / 1.4));
154
+ ring.setY(index, terrainHeight(x, z) + snow.depth - 0.72 * inside - 0.015);
155
+ }
156
+ outskirtsGeometry.computeVertexNormals();
157
+ outskirtsGeometry.setAttribute(STATE, new BufferAttribute(new Float32Array(ring.count * 2), 2));
158
+ const outskirts = new Mesh(outskirtsGeometry, material);
159
+ outskirts.receiveShadow = true;
160
+
161
+ let indents: Float32Array = new Float32Array(0);
162
+ let compactions: Float32Array = new Float32Array(0);
163
+ const writeState = (bounds: Bounds): void => {
164
+ indents = snow.copyChannel("indent", bounds, indents);
165
+ compactions = snow.copyChannel("compaction", bounds, compactions);
166
+ const values = state.array as Float32Array;
167
+ for (let row = 0; row < bounds.rows; row += 1) {
168
+ for (let column = 0; column < bounds.columns; column += 1) {
169
+ const cell = row * bounds.columns + column;
170
+ const vertex = (bounds.row + row) * field.columns + bounds.column + column;
171
+ values[vertex * 2] = indents[cell] as number;
172
+ values[vertex * 2 + 1] = compactions[cell] as number;
173
+ }
174
+ }
175
+ state.needsUpdate = true;
176
+ };
177
+
178
+ let urgent: Bounds | undefined;
179
+ let background: Bounds | undefined;
180
+ // `toGeometry` already drew the field as it stands; the field's own first full write is not news.
181
+ snow.takeDirtyRegion();
182
+ const redraw = (written: Bounds): void => {
183
+ // A normal reads its neighbours, so one sample beyond the written window moves too.
184
+ const column = Math.max(0, written.column - 1);
185
+ const row = Math.max(0, written.row - 1);
186
+ const bounds = {
187
+ column,
188
+ columns: Math.min(field.columns, written.column + written.columns + 1) - column,
189
+ row,
190
+ rows: Math.min(field.rows, written.row + written.rows + 1) - row,
191
+ };
192
+ field.refreshGeometry(geometry, bounds);
193
+ writeState(bounds);
194
+ // Upload only the rows that moved: a whole-field upload every frame is megabytes per frame.
195
+ const first = bounds.row * field.columns;
196
+ const count = bounds.rows * field.columns;
197
+ for (const name of ["position", "normal", STATE]) {
198
+ const attribute = geometry.getAttribute(name) as BufferAttribute;
199
+ attribute.addUpdateRange(first * attribute.itemSize, count * attribute.itemSize);
200
+ }
201
+ };
202
+ const collect = (): void => {
203
+ const written = snow.takeDirtyRegion();
204
+ if (written === undefined) return;
205
+ if (written.columns * written.rows <= URGENT_CELLS) urgent = union(urgent, written);
206
+ else background = union(background, written);
207
+ };
208
+
209
+ return {
210
+ collect,
211
+ mesh,
212
+ outskirts,
213
+ get pendingRows() {
214
+ return background?.rows ?? 0;
215
+ },
216
+ refresh() {
217
+ collect();
218
+ if (urgent !== undefined) redraw(urgent);
219
+ urgent = undefined;
220
+ if (background === undefined) return;
221
+ // Proportional to what is waiting, so a refill always finishes before the next one lands.
222
+ const rows = Math.min(
223
+ background.rows,
224
+ Math.max(SLICE_ROWS, Math.ceil(background.rows / SLICE_FRAMES)),
225
+ );
226
+ redraw({ ...background, rows });
227
+ background =
228
+ rows === background.rows
229
+ ? undefined
230
+ : { ...background, row: background.row + rows, rows: background.rows - rows };
231
+ },
232
+ renderError() {
233
+ collect();
234
+ if (urgent !== undefined) redraw(urgent);
235
+ if (background !== undefined) redraw(background);
236
+ urgent = undefined;
237
+ background = undefined;
238
+ const positions = geometry.getAttribute("position");
239
+ const heights = field.toColliderHeights();
240
+ let worst = 0;
241
+ for (let row = 0; row < field.rows; row += 1)
242
+ for (let column = 0; column < field.columns; column += 1)
243
+ worst = Math.max(
244
+ worst,
245
+ Math.abs(
246
+ positions.getY(row * field.columns + column) -
247
+ (heights[column * field.rows + row] as number),
248
+ ),
249
+ );
250
+ return worst;
251
+ },
252
+ setCompactionView(on) {
253
+ compactionView.value = on ? 1 : 0;
254
+ },
255
+ setStorm(storm) {
256
+ sun.value = 1 - storm * 0.85;
257
+ },
258
+ };
259
+ }