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,321 @@
1
+ // Generated for you. The explorer's look and its procedural pose: every part is a primitive built
2
+ // here, so the character can be restyled — or swapped for a rigged model — without touching the
3
+ // movement or the footsteps in `src/entities/Explorer.ts`.
4
+ import {
5
+ BoxGeometry,
6
+ type BufferGeometry,
7
+ CapsuleGeometry,
8
+ CatmullRomCurve3,
9
+ CylinderGeometry,
10
+ Group,
11
+ type Material,
12
+ Mesh,
13
+ SphereGeometry,
14
+ TorusGeometry,
15
+ TubeGeometry,
16
+ Vector3,
17
+ } from "three";
18
+ import { mergeGeometries } from "three/examples/jsm/utils/BufferGeometryUtils.js";
19
+ import type { SnowMaterials } from "./materials.js";
20
+
21
+ type Point = { x: number; y: number; z: number };
22
+
23
+ /** Where each boot is, in world space, and whether it is in the air. */
24
+ export interface IFootPose {
25
+ readonly side: number;
26
+ readonly x: number;
27
+ readonly y: number;
28
+ readonly z: number;
29
+ readonly angle: number;
30
+ readonly swing: boolean;
31
+ readonly progress: number;
32
+ }
33
+
34
+ interface ISegment {
35
+ readonly mesh: Mesh;
36
+ readonly length: number;
37
+ }
38
+
39
+ interface ILimb {
40
+ readonly side: number;
41
+ readonly upper: ISegment;
42
+ readonly lower: ISegment;
43
+ readonly end: Object3DLike;
44
+ }
45
+
46
+ type Object3DLike = Group | Mesh;
47
+
48
+ /** Bake a group's direct child meshes into one mesh per material, keeping child groups. */
49
+ function mergeRigid(group: Group): void {
50
+ const byMaterial = new Map<Material, BufferGeometry[]>();
51
+ for (const child of [...group.children]) {
52
+ if (!(child instanceof Mesh) || Array.isArray(child.material)) continue;
53
+ child.updateMatrix();
54
+ const geometry = child.geometry.clone().applyMatrix4(child.matrix);
55
+ const list = byMaterial.get(child.material) ?? [];
56
+ list.push(geometry);
57
+ byMaterial.set(child.material, list);
58
+ group.remove(child);
59
+ }
60
+ for (const [material, geometries] of byMaterial) {
61
+ const merged = mergeGeometries(geometries);
62
+ for (const geometry of geometries) geometry.dispose();
63
+ if (merged === null) throw new Error("ExplorerModel could not merge a rigid part.");
64
+ const mesh = new Mesh(merged, material);
65
+ mesh.castShadow = true;
66
+ mesh.receiveShadow = true;
67
+ group.add(mesh);
68
+ }
69
+ }
70
+
71
+ const UP = new Vector3(0, 1, 0);
72
+ const scratchA = new Vector3();
73
+ const scratchB = new Vector3();
74
+
75
+ /** Two-bone IK: the knee that keeps both bones at length, bent towards `bend`. */
76
+ function solveKnee(hip: Point, ankle: Point, upper: number, lower: number, bend: Point): Point {
77
+ let dx = ankle.x - hip.x;
78
+ let dy = ankle.y - hip.y;
79
+ let dz = ankle.z - hip.z;
80
+ let distance = Math.hypot(dx, dy, dz);
81
+ if (distance < 1e-7) {
82
+ dx = 0;
83
+ dy = -1;
84
+ dz = 0;
85
+ distance = 1;
86
+ } else {
87
+ dx /= distance;
88
+ dy /= distance;
89
+ dz /= distance;
90
+ }
91
+ const reach = Math.max(Math.abs(upper - lower) + 1e-6, Math.min(upper + lower - 1e-6, distance));
92
+ const along = (upper * upper - lower * lower + reach * reach) / (2 * reach);
93
+ const across = Math.sqrt(Math.max(0, upper * upper - along * along));
94
+ const dot = bend.x * dx + bend.y * dy + bend.z * dz;
95
+ let bx = bend.x - dx * dot;
96
+ let by = bend.y - dy * dot;
97
+ let bz = bend.z - dz * dot;
98
+ const length = Math.hypot(bx, by, bz) || 1;
99
+ bx /= length;
100
+ by /= length;
101
+ bz /= length;
102
+ return {
103
+ x: hip.x + dx * along + bx * across,
104
+ y: hip.y + dy * along + by * across,
105
+ z: hip.z + dz * along + bz * across,
106
+ };
107
+ }
108
+
109
+ export class ExplorerModel {
110
+ readonly root = new Group();
111
+ readonly #torso = new Group();
112
+ readonly #head = new Group();
113
+ readonly #arms: ILimb[] = [];
114
+ readonly #legs: ILimb[] = [];
115
+ readonly #sphere = new SphereGeometry(1, 20, 14);
116
+
117
+ constructor(materials: SnowMaterials) {
118
+ const m = materials;
119
+ const torso = this.#torso;
120
+ const head = this.#head;
121
+ this.root.add(torso);
122
+ torso.add(head);
123
+ const blob = (material: Material, p: Point, s: Point, parent: Group = this.root) => {
124
+ const mesh = new Mesh(this.#sphere, material);
125
+ mesh.position.set(p.x, p.y, p.z);
126
+ mesh.scale.set(s.x, s.y, s.z);
127
+ mesh.castShadow = true;
128
+ mesh.receiveShadow = true;
129
+ parent.add(mesh);
130
+ return mesh;
131
+ };
132
+ const box = (material: Material, p: Point, s: Point, parent: Group) => {
133
+ const mesh = new Mesh(new BoxGeometry(s.x, s.y, s.z), material);
134
+ mesh.position.set(p.x, p.y, p.z);
135
+ mesh.castShadow = true;
136
+ parent.add(mesh);
137
+ return mesh;
138
+ };
139
+ const tube = (material: Material, points: number[][], radius: number, parent: Group) => {
140
+ const curve = new CatmullRomCurve3(points.map(([x, y, z]) => new Vector3(x, y, z)));
141
+ const mesh = new Mesh(new TubeGeometry(curve, 16, radius, 6, false), material);
142
+ mesh.castShadow = true;
143
+ parent.add(mesh);
144
+ };
145
+ const v = (x: number, y: number, z: number): Point => ({ x, y, z });
146
+
147
+ // Quilted coat, waist and hips.
148
+ blob(m.coat, v(0, 1.29, 0), v(0.292, 0.365, 0.188), torso);
149
+ blob(m.coat, v(0, 1.045, 0), v(0.29, 0.13, 0.193), torso);
150
+ blob(m.pants, v(0, 0.95, 0), v(0.238, 0.135, 0.145));
151
+ for (let quilt = 0; quilt < 5; quilt += 1) {
152
+ const y = 1.07 + quilt * 0.11;
153
+ const profile = Math.sqrt(Math.max(0.3, 1 - ((y - 1.29) / 0.41) ** 2));
154
+ const seam = new Mesh(new TorusGeometry(1, 0.011, 4, 36), m.seam);
155
+ seam.rotation.x = Math.PI / 2;
156
+ seam.scale.set(0.297 * profile, 0.192 * profile, 0.35);
157
+ seam.position.y = y;
158
+ torso.add(seam);
159
+ }
160
+ tube(
161
+ m.rubber,
162
+ [
163
+ [0, 1.02, 0.196],
164
+ [0, 1.3, 0.191],
165
+ [0, 1.56, 0.143],
166
+ ],
167
+ 0.009,
168
+ torso,
169
+ );
170
+ box(m.seam, v(-0.14, 1.4, 0.179), v(0.105, 0.12, 0.019), torso);
171
+ blob(m.seam, v(-0.225, 1.1, 0.1), v(0.067, 0.081, 0.055), torso);
172
+ blob(m.seam, v(0.225, 1.1, 0.1), v(0.067, 0.081, 0.055), torso);
173
+ blob(m.coat, v(0, 1.595, 0), v(0.205, 0.13, 0.17), torso);
174
+
175
+ // Fur-lined hood, goggles and a dusting of snow on top.
176
+ blob(m.coat, v(0, 1.765, -0.015), v(0.229, 0.249, 0.205), head);
177
+ blob(m.skin, v(0, 1.763, 0.16), v(0.143, 0.171, 0.086), head);
178
+ blob(m.gaiter, v(0, 1.683, 0.222), v(0.146, 0.096, 0.045), head);
179
+ for (let tuft = 0; tuft < 28; tuft += 1) {
180
+ const a = (tuft / 28) * Math.PI * 2;
181
+ blob(
182
+ m.fur,
183
+ v(Math.sin(a) * 0.179, 1.766 + Math.cos(a) * 0.213, 0.17 + Math.sin(tuft * 2.3) * 0.008),
184
+ v(0.038, 0.043, 0.043),
185
+ head,
186
+ );
187
+ }
188
+ blob(m.rubber, v(0, 1.823, 0.244), v(0.174, 0.077, 0.043), head);
189
+ blob(m.lens, v(0, 1.825, 0.274), v(0.154, 0.054, 0.027), head);
190
+ blob(m.snowCap, v(-0.015, 1.96, -0.033), v(0.158, 0.036, 0.143), head);
191
+
192
+ // Expedition pack, bedroll and straps.
193
+ blob(m.gaiter, v(0, 1.31, -0.248), v(0.235, 0.3, 0.137), torso);
194
+ blob(m.pants, v(0, 1.49, -0.286), v(0.211, 0.107, 0.124), torso);
195
+ blob(m.coat, v(0, 1.3, -0.373), v(0.124, 0.149, 0.037), torso);
196
+ for (const side of [-1, 1]) {
197
+ tube(
198
+ m.gaiter,
199
+ [
200
+ [side * 0.15, 1.03, 0.175],
201
+ [side * 0.197, 1.4, 0.173],
202
+ [side * 0.17, 1.61, -0.04],
203
+ [side * 0.14, 1.45, -0.32],
204
+ ],
205
+ 0.025,
206
+ torso,
207
+ );
208
+ box(m.metal, v(side * 0.191, 1.34, 0.198), v(0.034, 0.048, 0.012), torso);
209
+ blob(m.pants, v(side * 0.222, 1.25, -0.246), v(0.075, 0.135, 0.087), torso);
210
+ }
211
+ const bedroll = new Mesh(new CylinderGeometry(0.095, 0.095, 0.43, 16), m.pants);
212
+ bedroll.rotation.z = Math.PI / 2;
213
+ bedroll.position.set(0, 1, -0.255);
214
+ bedroll.castShadow = true;
215
+ torso.add(bedroll);
216
+ blob(m.snowCap, v(0, 1.592, -0.289), v(0.172, 0.025, 0.086), torso);
217
+
218
+ const segment = (material: Material, radius: number, length: number): ISegment => {
219
+ const mesh = new Mesh(
220
+ new CapsuleGeometry(radius, Math.max(0.02, length - radius * 2), 6, 12),
221
+ material,
222
+ );
223
+ mesh.castShadow = true;
224
+ mesh.receiveShadow = true;
225
+ this.root.add(mesh);
226
+ return { length, mesh };
227
+ };
228
+ for (const side of [-1, 1]) {
229
+ const hand = blob(m.gaiter, v(0, 0, 0), v(0.069, 0.09, 0.065));
230
+ this.#arms.push({
231
+ end: hand,
232
+ lower: segment(m.coat, 0.084, 0.3),
233
+ side,
234
+ upper: segment(m.coat, 0.105, 0.32),
235
+ });
236
+ const boot = new Group();
237
+ this.root.add(boot);
238
+ blob(m.rubber, v(0, -0.09, 0), v(0.145, 0.047, 0.259), boot);
239
+ blob(m.boot, v(0, -0.025, 0.048), v(0.138, 0.086, 0.202), boot);
240
+ blob(m.boot, v(0, 0.038, -0.09), v(0.118, 0.145, 0.142), boot);
241
+ blob(m.rubber, v(0, -0.015, 0.183), v(0.132, 0.064, 0.073), boot);
242
+ const cuff = new Mesh(new CylinderGeometry(0.095, 0.117, 0.18, 16), m.gaiter);
243
+ cuff.position.set(0, 0.143, -0.066);
244
+ cuff.castShadow = true;
245
+ boot.add(cuff);
246
+ blob(m.snowCap, v(0.02, 0.055, 0.16), v(0.074, 0.015, 0.046), boot);
247
+ this.#legs.push({
248
+ end: boot,
249
+ lower: segment(m.pants, 0.092, 0.475),
250
+ side,
251
+ upper: segment(m.pants, 0.113, 0.475),
252
+ });
253
+ }
254
+ // The torso, hood and boots never bend internally, so each becomes one mesh per material:
255
+ // dozens of primitives as separate draws cost more than the whole snowfield.
256
+ for (const group of [torso, head, ...this.#legs.map((leg) => leg.end as Group)])
257
+ mergeRigid(group);
258
+ }
259
+
260
+ #place(segment: ISegment, from: Point, to: Point): void {
261
+ scratchA.set(from.x, from.y, from.z);
262
+ scratchB.set(to.x - from.x, to.y - from.y, to.z - from.z);
263
+ const length = scratchB.length();
264
+ segment.mesh.position.copy(scratchA).addScaledVector(scratchB, 0.5);
265
+ segment.mesh.quaternion.setFromUnitVectors(UP, scratchB.normalize());
266
+ segment.mesh.scale.y = length / segment.length;
267
+ }
268
+
269
+ /**
270
+ * Pose the body at `position` facing `heading`, with each boot where the gait put it.
271
+ * `cycle` drives the arm swing and torso sway; `speed` scales them.
272
+ */
273
+ pose(
274
+ position: Point,
275
+ heading: number,
276
+ feet: readonly IFootPose[],
277
+ cycle: number,
278
+ speed: number,
279
+ elapsed: number,
280
+ ): void {
281
+ this.root.position.set(position.x, position.y, position.z);
282
+ this.root.rotation.y = heading;
283
+ const gait = Math.sin(cycle * Math.PI * 2);
284
+ const motion = Math.min(1, speed);
285
+ this.#torso.rotation.z = gait * 0.022 * motion;
286
+ this.#torso.rotation.x = speed * 0.022;
287
+ this.#head.rotation.y = Math.sin(elapsed * 0.45) * 0.055 * (1 - motion * 0.6);
288
+ const cos = Math.cos(heading);
289
+ const sin = Math.sin(heading);
290
+ for (const [index, leg] of this.#legs.entries()) {
291
+ const foot = feet[index];
292
+ if (foot === undefined) continue;
293
+ const dx = foot.x - position.x;
294
+ const dz = foot.z - position.z;
295
+ const ankle = { x: dx * cos - dz * sin, y: foot.y - position.y, z: dx * sin + dz * cos };
296
+ const hip = { x: leg.side * 0.145, y: 0.935, z: -0.014 };
297
+ const knee = solveKnee(hip, ankle, 0.475, 0.475, { x: leg.side * 0.08, y: 0, z: 1 });
298
+ this.#place(leg.upper, hip, knee);
299
+ this.#place(leg.lower, knee, ankle);
300
+ leg.end.position.set(ankle.x, ankle.y, ankle.z);
301
+ leg.end.rotation.set(
302
+ foot.swing ? Math.sin(foot.progress * Math.PI * 2) * 0.2 : 0,
303
+ foot.angle - heading,
304
+ 0,
305
+ );
306
+ }
307
+ for (const arm of this.#arms) {
308
+ const swing = gait * arm.side * motion;
309
+ const shoulder = { x: arm.side * 0.287, y: 1.49, z: 0 };
310
+ const elbow = { x: arm.side * 0.376, y: 1.215, z: swing * 0.13 - 0.035 };
311
+ const hand = {
312
+ x: arm.side * 0.397,
313
+ y: 0.976 + Math.abs(swing) * 0.027,
314
+ z: swing * 0.23 + 0.055,
315
+ };
316
+ this.#place(arm.upper, shoulder, elbow);
317
+ this.#place(arm.lower, elbow, hand);
318
+ arm.end.position.set(hand.x, hand.y - 0.031, hand.z);
319
+ }
320
+ }
321
+ }
@@ -0,0 +1,111 @@
1
+ // Generated for you: these controls and this metric are the game's look. Edit freely.
2
+ import { dot, float, vec2, vec3 } from "three/tsl";
3
+ import type { Node } from "three/webgpu";
4
+
5
+ export interface IExposureSettings {
6
+ enabled: boolean;
7
+ /** Middle-grey target; increase to brighten the metered subject. */
8
+ key: number;
9
+ /** Exposure limits in stops. Expand only if the scene needs more range. */
10
+ minStops: number;
11
+ maxStops: number;
12
+ /**
13
+ * Percent of metered weight, dark to bright, ignored at each end of the histogram.
14
+ * Raise highPercent's gap (lower it) when a large bright backdrop still sets the exposure.
15
+ */
16
+ lowPercent: number;
17
+ highPercent: number;
18
+ /** Exponential response per second in log2 space. Up opens the eye; down squints. */
19
+ rateUp: number;
20
+ rateDown: number;
21
+ /** Stop error where cut acceleration begins / reaches its authored maximum. */
22
+ snapLo: number;
23
+ snapHi: number;
24
+ snapGain: number;
25
+ /** Seed for known cuts. reset() without a value adopts the next measured target. */
26
+ initialExposure: number;
27
+ settleStops: number;
28
+ /** Limit catch-up after a suspended frame, avoiding an unrequested cut. */
29
+ maxDelta: number;
30
+ /** Readback/marker cadence in seconds. Metering still runs on every drawn frame. */
31
+ reportInterval: number;
32
+ }
33
+
34
+ export const exposureSettings: Readonly<IExposureSettings> = {
35
+ enabled: false, // Opt in after qualifying this game's bright and dark captures.
36
+ key: 0.18,
37
+ minStops: -12,
38
+ maxStops: 12,
39
+ lowPercent: 10,
40
+ highPercent: 90,
41
+ rateUp: 2,
42
+ rateDown: 4,
43
+ snapLo: 3,
44
+ snapHi: 8,
45
+ snapGain: 1,
46
+ initialExposure: 1,
47
+ settleStops: 0.25,
48
+ maxDelta: 0.1,
49
+ reportInterval: 0.5,
50
+ };
51
+
52
+ /**
53
+ * Return weighted luminance and weight. The histogram's percent clip, not a clamp here, rejects
54
+ * small bright sources. The upper bound only keeps a half-float overflow from poisoning a block.
55
+ */
56
+ export function exposureMeter(colour: Node<"vec4">, uv: Node<"vec2">): Node<"vec2"> {
57
+ const luminance = dot(colour.rgb, vec3(0.2126, 0.7152, 0.0722)).clamp(0.0001, 65504);
58
+ // Larger bottom-of-frame preference favours ground over bright sky (WebGPU UV y is down).
59
+ const weight = float(1).add(uv.y);
60
+ return vec2(luminance.mul(weight), weight);
61
+ }
62
+
63
+ /** Receives the clipped histogram's linear mean luminance. Change it if the game encodes RMS. */
64
+ export function exposureLuminance(mean: Node<"float">): Node<"float"> {
65
+ return mean.max(0.0001);
66
+ }
67
+
68
+ export function validateExposureSettings(value: IExposureSettings): void {
69
+ for (const key of Object.keys(exposureSettings) as (keyof IExposureSettings)[]) {
70
+ if (key === "enabled") continue;
71
+ const number = value[key];
72
+ if (typeof number !== "number" || !Number.isFinite(Math.fround(number)))
73
+ throw new Error(`Invalid exposure ${key}: expected a finite float32 number.`);
74
+ }
75
+ if (
76
+ typeof value.enabled !== "boolean" ||
77
+ Math.fround(value.key) <= 0 ||
78
+ Math.fround(value.initialExposure) <= 0 ||
79
+ value.rateUp < 0 ||
80
+ value.rateDown < 0 ||
81
+ value.snapLo < 0 ||
82
+ value.snapHi <= value.snapLo ||
83
+ value.snapGain < 0 ||
84
+ value.snapGain > 1 ||
85
+ value.lowPercent < 0 ||
86
+ value.highPercent > 100 ||
87
+ value.lowPercent >= value.highPercent ||
88
+ value.minStops >= value.maxStops ||
89
+ value.minStops < -126 ||
90
+ value.maxStops > 126 ||
91
+ value.settleStops < 0 ||
92
+ value.maxDelta <= 0 ||
93
+ value.reportInterval <= 0
94
+ )
95
+ throw new Error("Invalid exposure settings: check limits, rates and thresholds.");
96
+ }
97
+
98
+ /** Resize only the meter. The separate history targets always remain 1x1. */
99
+ export function exposureReductionSizes(width: number, height: number): [number, number][] {
100
+ if (!Number.isSafeInteger(width) || !Number.isSafeInteger(height) || width < 1 || height < 1)
101
+ throw new Error("Exposure drawing buffer dimensions must be positive integers.");
102
+ const sizes: [number, number][] = [];
103
+ let w = width;
104
+ let h = height;
105
+ do {
106
+ w = Math.ceil(w / 4);
107
+ h = Math.ceil(h / 4);
108
+ sizes.push([w, h]);
109
+ } while (w > 1 || h > 1);
110
+ return sizes;
111
+ }
@@ -0,0 +1,178 @@
1
+ // Generated for you: GPU reduction and adaptation; exposure.ts owns the game's look.
2
+ import { FloatType, NearestFilter, RenderTarget } from "three";
3
+ import {
4
+ Fn,
5
+ If,
6
+ Loop,
7
+ float,
8
+ int,
9
+ ivec2,
10
+ mix,
11
+ screenCoordinate,
12
+ smoothstep,
13
+ type texture,
14
+ textureLoad,
15
+ vec2,
16
+ vec4,
17
+ } from "three/tsl";
18
+ import type { Node } from "three/webgpu";
19
+ import type { IExposureSettings } from "./exposure.js";
20
+
21
+ export type ColourTexture = ReturnType<typeof texture>;
22
+ export type Meter = (colour: Node<"vec4">, uv: Node<"vec2">) => Node<"vec2">;
23
+ export type Decode = (mean: Node<"float">) => Node<"float">;
24
+
25
+ export function exposureTarget(): RenderTarget {
26
+ return new RenderTarget(1, 1, {
27
+ type: FloatType,
28
+ minFilter: NearestFilter,
29
+ magFilter: NearestFilter,
30
+ depthBuffer: false,
31
+ });
32
+ }
33
+
34
+ /** Sum/16 at each level keeps values bounded. Mask partial blocks; never replicate edge texels. */
35
+ export function reduceExposure(
36
+ input: ColourTexture,
37
+ size: Node<"vec2">,
38
+ meter?: Meter,
39
+ ): Node<"vec4"> {
40
+ return Fn(() => {
41
+ const sum = vec2(0).toVar();
42
+ const origin = screenCoordinate.xy.floor().mul(4);
43
+ for (let y = 0; y < 4; y++)
44
+ for (let x = 0; x < 4; x++) {
45
+ const pixel = origin.add(vec2(x, y));
46
+ If(pixel.x.lessThan(size.x).and(pixel.y.lessThan(size.y)), () => {
47
+ const colour = textureLoad(input, ivec2(pixel));
48
+ sum.addAssign(meter === undefined ? colour.rg : meter(colour, pixel.add(0.5).div(size)));
49
+ });
50
+ }
51
+ return vec4(sum.div(16), 0, 1);
52
+ })();
53
+ }
54
+
55
+ /** The histogram has 64 bins. Each bin spans (maxStops - minStops) / 64 stops of scene luminance. */
56
+ export const exposureBins = 64;
57
+ /** The gather splits the blocks over 64 tiles, so a bin is summed by 64 short loops, not one long. */
58
+ export const exposureTiles = 64;
59
+
60
+ /**
61
+ * Stage one of the histogram, drawn as a 64 (bins) x 64 (tiles) target. Texel (bin, tile) gathers
62
+ * its tile of the block means of `blocks` (the second reduction level, about 8 000 texels at
63
+ * 1080p, so about 130 per tile) that fall in its bin.
64
+ * r = summed weight, g = summed weight * log2 luminance, so a bin keeps its exact mean.
65
+ */
66
+ export function histogramTiles(
67
+ blocks: ColourTexture,
68
+ size: Node<"vec2">,
69
+ policy: Readonly<IExposureSettings>,
70
+ ): Node<"vec4"> {
71
+ // Range follows the authored stops: goal = log2(key) - log2(L), clamped to [min, max].
72
+ const low = Math.log2(policy.key) - policy.maxStops;
73
+ const span = policy.maxStops - policy.minStops;
74
+ return Fn(() => {
75
+ const bin = screenCoordinate.x.floor();
76
+ const weight = float(0).toVar();
77
+ const logSum = float(0).toVar();
78
+ const width = int(size.x);
79
+ const total = int(size.x.mul(size.y));
80
+ const perTile = total.add(exposureTiles - 1).div(exposureTiles);
81
+ const first = int(screenCoordinate.y.floor()).mul(perTile);
82
+ Loop({ start: 0, end: perTile }, ({ i: offset }) => {
83
+ const i = first.add(offset);
84
+ If(i.lessThan(total), () => {
85
+ const block = textureLoad(blocks, ivec2(i.mod(width), i.div(width)));
86
+ const log = block.r
87
+ .div(block.g.max(1e-20))
88
+ .max(1e-20)
89
+ .log2()
90
+ .clamp(low, low + span);
91
+ const index = log
92
+ .sub(low)
93
+ .mul(exposureBins / span)
94
+ .floor()
95
+ .min(exposureBins - 1);
96
+ If(block.g.greaterThan(0).and(index.equal(bin)), () => {
97
+ weight.addAssign(block.g);
98
+ logSum.addAssign(block.g.mul(log));
99
+ });
100
+ });
101
+ });
102
+ return vec4(weight, logSum, 0, 1);
103
+ })();
104
+ }
105
+
106
+ /** Stage two, drawn as a 64x1 target: one texel per bin, summing that bin over every tile. */
107
+ export function histogramExposure(tiles: ColourTexture): Node<"vec4"> {
108
+ return Fn(() => {
109
+ const bin = int(screenCoordinate.x.floor());
110
+ const sum = vec2(0).toVar();
111
+ Loop(exposureTiles, ({ i }) => {
112
+ sum.addAssign(textureLoad(tiles, ivec2(bin, i)).rg);
113
+ });
114
+ return vec4(sum, 0, 1);
115
+ })();
116
+ }
117
+
118
+ /**
119
+ * UE's average without outliers: drop the darkest lowPercent of the weight, stop at
120
+ * highPercent, take the weighted log2 mean of what is left. Returns (log2 mean, kept weight).
121
+ */
122
+ function clippedLog2Mean(
123
+ histogram: ColourTexture,
124
+ policy: Readonly<IExposureSettings>,
125
+ ): Node<"vec2"> {
126
+ const total = float(0).toVar();
127
+ Loop(exposureBins, ({ i }) => {
128
+ total.addAssign(textureLoad(histogram, ivec2(i, 0)).r);
129
+ });
130
+ const dropLow = total.mul(policy.lowPercent / 100).toVar();
131
+ const keepUpTo = total.mul(policy.highPercent / 100).toVar();
132
+ const kept = float(0).toVar();
133
+ const logSum = float(0).toVar();
134
+ Loop(exposureBins, ({ i }) => {
135
+ const bin = textureLoad(histogram, ivec2(i, 0));
136
+ const removed = bin.r.min(dropLow);
137
+ dropLow.subAssign(removed);
138
+ keepUpTo.subAssign(removed);
139
+ const keep = bin.r.sub(removed).min(keepUpTo);
140
+ keepUpTo.subAssign(keep);
141
+ kept.addAssign(keep);
142
+ logSum.addAssign(bin.g.mul(keep.div(bin.r.max(1e-20))));
143
+ });
144
+ return vec2(logSum.div(kept.max(1e-20)), kept);
145
+ }
146
+
147
+ export function adaptExposure(
148
+ histogram: ColourTexture,
149
+ previous: ColourTexture,
150
+ resetMode: Node<"float">,
151
+ seed: Node<"float">,
152
+ delta: Node<"float">,
153
+ policy: Readonly<IExposureSettings>,
154
+ decode: Decode,
155
+ ): Node<"vec4"> {
156
+ return Fn(() => {
157
+ const measure = clippedLog2Mean(histogram, policy);
158
+ const luminance = decode(measure.x.exp2());
159
+ const valid = measure.y
160
+ .greaterThan(0)
161
+ .and(luminance.greaterThan(0))
162
+ .and(luminance.lessThan(3.4e38));
163
+ const goal = float(Math.log2(policy.key))
164
+ .sub(luminance.max(1e-20).log2())
165
+ .clamp(policy.minStops, policy.maxStops);
166
+ const old = resetMode.equal(1).select(seed, textureLoad(previous, ivec2(0)).r);
167
+ const error = goal.sub(old);
168
+ const rate = error.greaterThan(0).select(float(policy.rateUp), float(policy.rateDown));
169
+ const normal = float(1).sub(delta.mul(rate).negate().exp());
170
+ const cut = smoothstep(policy.snapLo, policy.snapHi, error.abs()).mul(policy.snapGain);
171
+ const adapted = valid.select(
172
+ resetMode.equal(2).select(goal, mix(old, goal, mix(normal, float(1), cut))),
173
+ old,
174
+ );
175
+ const settled = goal.sub(adapted).abs().lessThanEqual(policy.settleStops).select(1, 0);
176
+ return vec4(adapted, valid.select(luminance, -1), goal, settled);
177
+ })();
178
+ }
@@ -0,0 +1,79 @@
1
+ // Generated for you: async GPU observations stay tied to their owner's live generation.
2
+ import type { RenderTarget } from "three";
3
+ import type { Renderer } from "three/webgpu";
4
+
5
+ export class ExposureReadback {
6
+ #pending = false;
7
+ #generation = 0;
8
+ #lastReport = Number.NEGATIVE_INFINITY;
9
+ #disposed = false;
10
+ #value: Record<string, unknown>;
11
+ constructor(
12
+ readonly constant: number,
13
+ readonly enabled: () => boolean,
14
+ ) {
15
+ this.#value = { measured: false, applied: enabled() };
16
+ }
17
+ invalidate(): void {
18
+ this.#generation++;
19
+ this.#value = { measured: false, applied: this.enabled() };
20
+ this.#lastReport = Number.NEGATIVE_INFINITY;
21
+ }
22
+ get(): Record<string, unknown> {
23
+ return { ...this.#value };
24
+ }
25
+ dispose(): void {
26
+ this.#disposed = true;
27
+ this.#generation++;
28
+ }
29
+ report(renderer: Renderer, result: RenderTarget, time: number, interval: number): void {
30
+ if (this.#pending || time - this.#lastReport < interval) return;
31
+ this.#pending = true;
32
+ this.#lastReport = time;
33
+ const generation = this.#generation;
34
+ const current = () => !this.#disposed && generation === this.#generation;
35
+ const enabled = this.enabled;
36
+ const constant = this.constant;
37
+ const publish = (observation: Record<string, unknown>) => {
38
+ this.#value = observation;
39
+ };
40
+ const finished = () => {
41
+ this.#pending = false;
42
+ };
43
+ void renderer
44
+ .readRenderTargetPixelsAsync(result, 0, 0, 1, 1)
45
+ .then((values) => {
46
+ if (!current()) return;
47
+ if (
48
+ !(values instanceof Float32Array) ||
49
+ values.length < 4 ||
50
+ !Array.from(values).every(Number.isFinite) ||
51
+ (values[1] ?? 0) <= 0
52
+ )
53
+ throw new Error("Exposure readback is invalid; measurement is unavailable.");
54
+ const observation = {
55
+ measured: true,
56
+ applied: enabled(),
57
+ luminance: values[1],
58
+ exposureStops: enabled() ? values[0] : Math.log2(constant),
59
+ targetStops: values[2],
60
+ settled: values[3] === 1,
61
+ };
62
+ publish(observation);
63
+ console.info(`TN_AUTO_EXPOSURE:${JSON.stringify(observation)}`);
64
+ })
65
+ .catch((error: unknown) => {
66
+ if (!current()) return;
67
+ const observation = {
68
+ measured: false,
69
+ applied: enabled(),
70
+ reason: String(error),
71
+ };
72
+ publish(observation);
73
+ console.error(`TN_AUTO_EXPOSURE:${JSON.stringify(observation)}`);
74
+ })
75
+ .finally(() => {
76
+ finished();
77
+ });
78
+ }
79
+ }