create-threenative 0.2.9 → 0.2.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +229 -36
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +17 -11
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +16 -10
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +17 -11
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +17 -11
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +17 -11
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +76 -5
  420. package/templates/racing/src/scenes/Race.ts +53 -42
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +16 -10
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +16 -10
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +17 -11
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +17 -11
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +17 -11
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +17 -11
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +17 -11
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +56 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +53 -34
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +17 -11
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -41,6 +41,9 @@ export abstract class Fighter {
41
41
  readonly conventions: IActionRpgConventions;
42
42
  #action = "";
43
43
  #actionRemaining = 0;
44
+ readonly #clipDuration = new Map<string, number>();
45
+ /** The last one-shot clip, the frames it advanced and the seconds it ran against the seconds its whole clip needs. */
46
+ #oneShot = { clip: "", frames: 0, needed: 0, ran: 0 };
44
47
 
45
48
  protected constructor(
46
49
  ctx: GameCtx,
@@ -58,6 +61,7 @@ export abstract class Fighter {
58
61
  this.figure.scale.setScalar(options.scale ?? 1);
59
62
  this.figure.rotation.y = options.facing ?? Math.PI;
60
63
  this.mesh.add(this.figure);
64
+ for (const clip of model.animations) this.#clipDuration.set(clip.name, clip.duration);
61
65
  // Measured, not guessed: the figure sinks by the distance from its own origin to its lowest
62
66
  // posed point, so an asset authored feet-down and one authored mid-stride both land on the
63
67
  // floor. Measured before the body is placed, while the mesh is still at the origin.
@@ -77,15 +81,47 @@ export abstract class Fighter {
77
81
  }
78
82
 
79
83
  /**
80
- * Start a clip. `hold` is how long a one-shot keeps the fighter out of its locomotion loop; the
81
- * caller that owns the state machine decides when the action ends, not the clip.
84
+ * What the playtest bridge reads off a registered entity, and what `assert.animation[]` bounds:
85
+ * the last one-shot action (swing, cast, roll, death; a flinch is a reaction, not an action) and
86
+ * whether it ran its whole clip before locomotion or another action took the rig over. The rig's
87
+ * own clip is the locomotion loop by then, so the one-shot is kept until the next one starts.
82
88
  */
83
- play(action: string, options: { readonly fade?: number; readonly hold?: number } = {}): void {
89
+ get animation(): { advancedFrames: number; current: string; finished: boolean } {
90
+ const { clip, frames, needed, ran } = this.#oneShot;
91
+ return {
92
+ advancedFrames: frames,
93
+ current: clip === "" ? (this.character.current ?? "") : clip,
94
+ finished: clip !== "" && ran >= needed - 1e-6,
95
+ };
96
+ }
97
+
98
+ /**
99
+ * Start a clip and return the rate it plays at. `hold` is how long a one-shot keeps the fighter
100
+ * out of its locomotion loop; the caller that owns the state machine decides when the action
101
+ * ends, not the clip. `fit` speeds the clip up so the whole clip plays inside `hold`.
102
+ */
103
+ play(
104
+ action: string,
105
+ options: { readonly fade?: number; readonly fit?: boolean; readonly hold?: number } = {},
106
+ ): number {
84
107
  const clip = this.clips[action];
85
108
  if (clip === undefined) throw new Error(`Unknown fighter action '${action}'.`);
86
109
  this.#action = action;
87
110
  this.#actionRemaining = options.hold ?? 0;
88
- this.character.play(clip, { fade: options.fade ?? 0.15, mode: "once" });
111
+ const duration = this.#clipDuration.get(clip) ?? 0;
112
+ const speed =
113
+ options.fit === true && this.#actionRemaining > 0 && duration > 0
114
+ ? duration / this.#actionRemaining
115
+ : undefined;
116
+ this.character.play(clip, {
117
+ fade: options.fade ?? 0.15,
118
+ mode: "once",
119
+ ...(speed === undefined ? {} : { speed }),
120
+ });
121
+ // A flinch is a reaction to an enemy, not an action the fighter chose: it never replaces the record.
122
+ if (this.#actionRemaining > 0 && action !== "hit")
123
+ this.#oneShot = { clip, frames: 0, needed: duration / (speed ?? 1), ran: 0 };
124
+ return speed ?? 1;
89
125
  }
90
126
 
91
127
  /** True while a one-shot is still holding; locomotion waits for it. */
@@ -100,6 +136,10 @@ export abstract class Fighter {
100
136
  * from the stick, and `AnimationPlayer`'s stride sync re-times it to the ground actually covered.
101
137
  */
102
138
  protected animateRig(dt: number, heading: number | undefined, speed: number): void {
139
+ if (this.#actionRemaining > 0 && this.#action !== "hit") {
140
+ this.#oneShot.frames += 1;
141
+ this.#oneShot.ran += Math.min(dt, this.#actionRemaining);
142
+ }
103
143
  this.#actionRemaining = Math.max(0, this.#actionRemaining - dt);
104
144
  if (heading !== undefined && speed > 0.05) {
105
145
  const turn = MathUtils.euclideanModulo(
@@ -1,8 +1,7 @@
1
1
  import { CharacterBody3D, CollisionShape3D } from "@threenative/physics";
2
- import { Vector3 } from "three";
2
+ import { MathUtils, type Object3D, Vector3 } from "three";
3
3
  import { createSword } from "../render/props.js";
4
4
  import type { ITouchInput } from "../render/touch-controls.js";
5
- import type { GameState } from "../state.js";
6
5
  import { Fighter, type GameCtx, type IMannequin } from "./Fighter.js";
7
6
 
8
7
  export const WORLD_LAYER = 1;
@@ -26,10 +25,16 @@ const DODGE_SPEED = 9;
26
25
  /** Capsule for a 1.8 m figure: 0.38 m half-height plus a 0.34 m radius at each end. */
27
26
  const HALF_HEIGHT = 0.38;
28
27
  const RADIUS = 0.34;
29
- /** How long a swing, a cast and a roll keep the legs from taking over the clip. */
30
- const SWING = 0.45;
28
+ /**
29
+ * How long a swing, a cast and a roll keep the legs from taking over the clip. The swing and the
30
+ * roll are fitted: their whole clip (`Sword_Attack` 1.53 s, `Roll` 1.47 s) plays inside the hold, so
31
+ * the follow-through is never cut, and a new swing waits for it.
32
+ */
33
+ const SWING = 0.8;
34
+ /** When the blade crosses the front of the figure in `Sword_Attack`, in clip seconds: the hand peaks at 0.40 s. */
35
+ const SWING_CONTACT = 0.4;
31
36
  const CAST = 0.7;
32
- const ROLL = 0.5;
37
+ const ROLL = 0.7;
33
38
  const DODGE_COOLDOWN = 1;
34
39
  const REACH = 0.9;
35
40
 
@@ -38,10 +43,15 @@ export class Player extends Fighter {
38
43
  readonly maxHealth = 100;
39
44
  health: number;
40
45
  dead = false;
41
- equippedItem = "";
42
46
  #bodyDisposed = false;
47
+ #equippedItem = "";
48
+ #sword: Object3D;
49
+ /** The landing half of the swing in progress: damage waits for the blade, not the key. */
50
+ #swing: { remaining: number; land: () => void } | undefined;
43
51
  #dodgeCooldown = 0;
44
52
  #dodgeRemaining = 0;
53
+ #rollDirection = new Vector3();
54
+ #rollDirectionChosen = false;
45
55
  #forward = new Vector3();
46
56
  #origin = new Vector3();
47
57
  #onDamage: (amount: number) => void;
@@ -55,7 +65,10 @@ export class Player extends Fighter {
55
65
  onDamage: (amount: number) => void,
56
66
  onDeath: () => void,
57
67
  ) {
58
- super(ctx, model, CLIPS, { halfExtent: HALF_HEIGHT + RADIUS, weapon: createSword() });
68
+ const sword = createSword();
69
+ super(ctx, model, CLIPS, { halfExtent: HALF_HEIGHT + RADIUS, weapon: sword });
70
+ this.#sword = sword;
71
+ this.equippedItem = "";
59
72
  this.health = Math.max(0, Math.min(this.maxHealth, health));
60
73
  this.mesh.position.copy(spawn);
61
74
  this.#onDamage = onDamage;
@@ -83,18 +96,51 @@ export class Player extends Fighter {
83
96
  }
84
97
  this.#dodgeCooldown = Math.max(0, this.#dodgeCooldown - dt);
85
98
  this.#dodgeRemaining = Math.max(0, this.#dodgeRemaining - dt);
99
+ if (this.#dodgeRemaining > 0 && !this.#rollDirectionChosen) {
100
+ this.#rollDirectionChosen = true;
101
+ this.#rollDirection.set(move.x, 0, -move.y);
102
+ if (this.#rollDirection.lengthSq() > 0.01) this.#rollDirection.normalize();
103
+ else this.facingVector(this.#rollDirection);
104
+ this.figure.rotation.y = Math.atan2(this.#rollDirection.x, this.#rollDirection.z);
105
+ }
86
106
  const speed =
87
107
  this.#dodgeRemaining > 0 ? DODGE_SPEED * (this.#dodgeRemaining / ROLL) : MOVE_SPEED;
88
- this.body.velocity.set(move.x * speed, 0, -move.y * speed);
108
+ if (this.#dodgeRemaining > 0)
109
+ this.body.velocity.copy(this.#rollDirection).multiplyScalar(speed);
110
+ else this.body.velocity.set(move.x * speed, 0, -move.y * speed);
89
111
  this.body.moveAndSlide(dt);
90
112
  this.conventions.applyGrounding(0, dt);
91
113
  const heading = this.busy ? undefined : Math.atan2(this.body.velocity.x, this.body.velocity.z);
92
114
  this.animateRig(dt, heading, Math.hypot(this.body.velocity.x, this.body.velocity.z));
115
+ const swing = this.#swing;
116
+ if (swing === undefined) return;
117
+ swing.remaining -= dt;
118
+ if (swing.remaining > 0) return;
119
+ this.#swing = undefined;
120
+ // A cast or a roll that took the clip over took the blade with it.
121
+ if (this.action === "attack") swing.land();
122
+ }
123
+
124
+ /** The hand holds the blade only while a weapon is equipped, so the figure and the HUD agree. */
125
+ get equippedItem(): string {
126
+ return this.#equippedItem;
127
+ }
128
+
129
+ set equippedItem(itemId: string) {
130
+ this.#equippedItem = itemId;
131
+ this.#sword.visible = itemId !== "";
93
132
  }
94
133
 
95
- /** The swing, the cast and the roll: three inputs, three clips, one state machine. */
96
- strike(): void {
97
- this.play("attack", { fade: 0.05, hold: SWING });
134
+ /**
135
+ * The swing, the cast and the roll: three inputs, three clips, one state machine. `land` runs
136
+ * when the blade reaches the front of the figure; a press during a swing is ignored, so the
137
+ * clip and the hits it deals stay one to one.
138
+ */
139
+ strike(land: () => void): boolean {
140
+ if (this.dead || (this.action === "attack" && this.busy)) return false;
141
+ const rate = this.play("attack", { fade: 0.05, fit: true, hold: SWING });
142
+ this.#swing = { land, remaining: SWING_CONTACT / rate };
143
+ return true;
98
144
  }
99
145
 
100
146
  cast(): void {
@@ -105,7 +151,8 @@ export class Player extends Fighter {
105
151
  if (this.busy || this.#dodgeCooldown > 0) return false;
106
152
  this.#dodgeCooldown = DODGE_COOLDOWN;
107
153
  this.#dodgeRemaining = ROLL;
108
- this.play("dodge", { fade: 0.05, hold: ROLL });
154
+ this.#rollDirectionChosen = false;
155
+ this.play("dodge", { fade: 0.05, hold: ROLL, fit: true });
109
156
  return true;
110
157
  }
111
158
 
@@ -148,12 +195,17 @@ export class Player extends Fighter {
148
195
  action: this.action,
149
196
  dead: this.dead,
150
197
  equippedItem: this.equippedItem,
198
+ facingDegrees:
199
+ Math.round(
200
+ MathUtils.radToDeg(MathUtils.euclideanModulo(this.figure.rotation.y, Math.PI * 2)),
201
+ ) % 360,
151
202
  groundClearance: this.conventions.groundSnap.clearance,
152
203
  health: this.health,
153
204
  normaliseFactor: this.conventions.normaliseFactor,
154
205
  position: this.mesh.position.toArray(),
155
206
  skeletonBones: this.conventions.boneNames,
156
207
  weaponBone: this.conventions.attachedBone,
208
+ weaponVisible: this.#sword.visible,
157
209
  };
158
210
  }
159
211
 
@@ -0,0 +1,444 @@
1
+ // Generated for you. Plain maths, edit or delete it freely: the sky the sun lights, in the sun's own units.
2
+ //
3
+ // Unreal's default level draws its sky from the Sky Atmosphere, lights the scene with a Sky Light
4
+ // that captures it, and tints the sun by the air the sun passes through. All three read ONE sun
5
+ // illuminance, so the sun-to-sky ratio is a consequence of the model and not a constant. This file
6
+ // ports that model: single scattering with Rayleigh and Mie phase functions, an ozone absorption
7
+ // layer, a ground bounce, and the isotropic multiple-scattering approximation (Hillaire, "A
8
+ // Scalable and Production Ready Sky and Atmosphere Rendering Technique", EGSR 2020, the paper the
9
+ // Unreal atmosphere implements). Coefficients are Unreal 5.8.3's defaults, read from
10
+ // Engine/Source/Runtime/Engine/Private/Components/SkyAtmosphereComponent.cpp:95-128 and checked
11
+ // against tools/unreal-reference/template-actors.json. The integration structure follows
12
+ // Engine/Shaders/Private/SkyAtmosphere.usf (IntegrateSingleScatteredLuminance and the multiple
13
+ // scattering pass) and the phase functions in ParticipatingMediaCommon.ush.
14
+ //
15
+ // Units: every radiance below is per unit sun illuminance (1.0 outside the atmosphere). Multiply
16
+ // by the sun's illuminance in the scene's light units (lighting.ts) to get scene radiance, so the
17
+ // sun and the sky can never disagree about exposure.
18
+ //
19
+ // Plain numbers and no `three` import: the same code runs under node for the unit check.
20
+ // ponytail: direct numerical integration at load (about a second at 256x128). A transmittance LUT,
21
+ // or core's `SkyCapture` once its sky-view LUT is physical, replaces the inner loops.
22
+
23
+ export type Rgb = readonly [number, number, number];
24
+ type Vec3 = readonly [number, number, number];
25
+
26
+ export const BOTTOM_KM = 6360;
27
+ export const TOP_KM = 6420;
28
+ export const RAYLEIGH: Rgb = [0.005802, 0.013558, 0.0331]; // per km at sea level
29
+ export const MIE_SCATTER = 0.003996;
30
+ export const MIE_ABSORB = 0.000444;
31
+ export const OZONE: Rgb = [0.00065, 0.001881, 0.000085];
32
+ export const MIE_G = 0.8;
33
+ export const GROUND_ALBEDO = 0.4; // 170/255 sRGB, linear
34
+ export const CAMERA_KM = 0.06; // the reference floor sits 60 m above the planet top
35
+ const FOUR_PI = 4 * Math.PI;
36
+
37
+ const rayleighPhase = (c: number): number => (3 / (16 * Math.PI)) * (1 + c * c);
38
+ const hgPhase = (c: number): number =>
39
+ (1 - MIE_G * MIE_G) / (FOUR_PI * (1 + MIE_G * MIE_G - 2 * MIE_G * c) ** 1.5);
40
+
41
+ const dot = (a: Vec3, b: Vec3): number => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
42
+
43
+ interface IMedium {
44
+ ray: Rgb;
45
+ mie: number;
46
+ ext: Rgb;
47
+ }
48
+
49
+ function medium(h: number): IMedium {
50
+ const ray = Math.exp(-h / 8);
51
+ const mie = Math.exp(-h / 1.2);
52
+ const ozone = Math.max(0, Math.min(1, h < 25 ? h / 15 - 2 / 3 : -h / 15 + 8 / 3));
53
+ const e = (i: 0 | 1 | 2): number =>
54
+ RAYLEIGH[i] * ray + (MIE_SCATTER + MIE_ABSORB) * mie + OZONE[i] * ozone;
55
+ return {
56
+ ray: [RAYLEIGH[0] * ray, RAYLEIGH[1] * ray, RAYLEIGH[2] * ray],
57
+ mie: MIE_SCATTER * mie,
58
+ ext: [e(0), e(1), e(2)],
59
+ };
60
+ }
61
+
62
+ /** Distance from a point at radius `r`, heading with cosine `mu` to the local up, to a sphere. */
63
+ function hitSphere(r: number, mu: number, radius: number, far: boolean): number | undefined {
64
+ const b = r * mu;
65
+ const disc = b * b - (r * r - radius * radius);
66
+ if (disc < 0) return undefined;
67
+ const t = far ? -b + Math.sqrt(disc) : -b - Math.sqrt(disc);
68
+ return t >= 0 ? t : undefined;
69
+ }
70
+
71
+ /**
72
+ * Optical depth from a point to the top of the atmosphere; undefined when the planet blocks the way.
73
+ * Unreal stores this in its transmittance LUT, ten samples a ray (r.SkyAtmosphere.TransmittanceLUT.SampleCount).
74
+ */
75
+ function opticalDepthToTop(r: number, mu: number): Rgb | undefined {
76
+ if (mu < 0 && hitSphere(r, mu, BOTTOM_KM, false) !== undefined) return undefined;
77
+ const length = hitSphere(r, mu, TOP_KM, true) ?? 0;
78
+ const sum: [number, number, number] = [0, 0, 0];
79
+ for (const { from, to, at } of linear(10)(length)) {
80
+ const m = medium(Math.max(0, Math.sqrt(r * r + 2 * r * mu * at + at * at) - BOTTOM_KM));
81
+ for (let c = 0; c < 3; c += 1) sum[c] = (sum[c] ?? 0) + m.ext[c as 0 | 1 | 2] * (to - from);
82
+ }
83
+ return sum;
84
+ }
85
+
86
+ /** Fraction of the sun's illuminance that reaches the ground, per channel. */
87
+ export function sunTransmittance(elevationRad: number): Rgb {
88
+ const depth = opticalDepthToTop(BOTTOM_KM + CAMERA_KM, Math.sin(elevationRad));
89
+ if (depth === undefined) return [0, 0, 0];
90
+ return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
91
+ }
92
+
93
+ /**
94
+ * The colour Unreal gives the sun light itself (FAtmosphereSetup::GetTransmittanceAtGroundLevel,
95
+ * Engine/Source/Runtime/Engine/Private/Components/SkyAtmosphere*): a CPU estimate, not the exact
96
+ * integral. It starts 500 m above the planet, sums 15 equal segments by their start point (the
97
+ * rule over-counts the dense low air) and has no minimum elevation (TransmittanceMinLightElevationAngle
98
+ * is -90). The sky itself reads the transmittance LUT (`sunTransmittance`), so the two differ.
99
+ */
100
+ export function sunLightTransmittance(elevationRad: number): Rgb {
101
+ const f = Math.fround;
102
+ const r0 = BOTTOM_KM + 0.5;
103
+ const mu = Math.sin(elevationRad);
104
+ const tMax = hitSphere(r0, mu, TOP_KM, true) ?? 0;
105
+ const depth: [number, number, number] = [0, 0, 0];
106
+ const step = f(1 / 15);
107
+ for (let t = 0; t < 1; t = f(t + step)) {
108
+ const along = tMax * t;
109
+ const h = Math.max(0, Math.sqrt(r0 * r0 + 2 * r0 * mu * along + along * along) - BOTTOM_KM);
110
+ const m = medium(h);
111
+ for (let c = 0; c < 3; c += 1) depth[c] = (depth[c] ?? 0) + m.ext[c as 0 | 1 | 2] * step * tMax;
112
+ }
113
+ return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
114
+ }
115
+
116
+ /** Fraction of the sun's illuminance that reaches radius `r` where the sun's cosine to local up is `mu`. */
117
+ export function transmittanceToTop(r: number, mu: number): Rgb {
118
+ const depth = opticalDepthToTop(r, mu);
119
+ if (depth === undefined) return [0, 0, 0];
120
+ return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
121
+ }
122
+
123
+ type Multi = (heightKm: number, cosSun: number) => Rgb;
124
+
125
+ /** One ray segment: it spans [from, to] in kilometres and its medium is read at `at`. */
126
+ interface ISegment {
127
+ from: number;
128
+ to: number;
129
+ at: number;
130
+ }
131
+ type Sampling = (tMax: number) => ISegment[];
132
+
133
+ /** Unreal's fixed march (the transmittance, multiple-scattering and distant sky light passes): equal segments, read `offset` of the way in. */
134
+ const linear =
135
+ (steps: number, offset = 0.3): Sampling =>
136
+ (tMax) =>
137
+ Array.from({ length: steps }, (_, i) => ({
138
+ from: (tMax * i) / steps,
139
+ to: (tMax * (i + 1)) / steps,
140
+ at: (tMax * (i + offset)) / steps,
141
+ }));
142
+
143
+ /**
144
+ * Unreal's sky-view march (SamplingSetup.VariableSampleCount in SkyAtmosphere.usf): the count grows
145
+ * from `min` to `max` with the distance, the segments grow with the square of it, and the last one
146
+ * runs on to the end of the ray.
147
+ */
148
+ const variable =
149
+ (min: number, max: number, distanceKm: number, offset = 0.3): Sampling =>
150
+ (tMax) => {
151
+ const count = min + (max - min) * Math.min(1, Math.max(0, tMax / distanceKm));
152
+ const whole = Math.floor(count);
153
+ const tMaxWhole = (tMax * whole) / count;
154
+ return Array.from({ length: Math.ceil(count) }, (_, i) => {
155
+ const [u0, u1] = [(i / whole) ** 2, ((i + 1) / whole) ** 2];
156
+ const from = tMaxWhole * u0;
157
+ const to = u1 > 1 ? tMax : tMaxWhole * u1;
158
+ return { from, to, at: from + (to - from) * offset };
159
+ });
160
+ };
161
+
162
+ interface IGather {
163
+ radiance: [number, number, number];
164
+ /** Integral of the scattering coefficient along the ray, attenuated: the transfer factor. */
165
+ transfer: [number, number, number];
166
+ }
167
+
168
+ /**
169
+ * One view ray from (0, r0, 0) along `dir`, the planet at the origin and `sun` a unit vector.
170
+ * `iso` swaps the phase functions for the isotropic one, as the multiple-scattering pass does.
171
+ * `multi` adds the multiple-scattering luminance at each sample.
172
+ */
173
+ function march(
174
+ r0: number,
175
+ dir: Vec3,
176
+ sun: Vec3,
177
+ iso: boolean,
178
+ multi: Multi | undefined,
179
+ ground: boolean,
180
+ sampling: Sampling,
181
+ ): IGather {
182
+ const out: IGather = { radiance: [0, 0, 0], transfer: [0, 0, 0] };
183
+ const mu0 = dir[1];
184
+ const groundT = mu0 < 0 ? hitSphere(r0, mu0, BOTTOM_KM, false) : undefined;
185
+ const tMax = groundT ?? hitSphere(r0, mu0, TOP_KM, true) ?? 0;
186
+ const cosView = dot(dir, sun);
187
+ const phaseRay = iso ? 1 / FOUR_PI : rayleighPhase(cosView);
188
+ const phaseMie = iso ? 1 / FOUR_PI : hgPhase(cosView);
189
+ const through: [number, number, number] = [1, 1, 1];
190
+ const at = (t: number): Vec3 => [dir[0] * t, r0 + dir[1] * t, dir[2] * t];
191
+ for (const { from, to, at: mid } of sampling(tMax)) {
192
+ const dt = to - from;
193
+ const p = at(mid);
194
+ const rr = Math.hypot(p[0], p[1], p[2]);
195
+ const cosSun = dot(p, sun) / rr;
196
+ const m = medium(Math.max(0, rr - BOTTOM_KM));
197
+ const depth = opticalDepthToTop(rr, cosSun);
198
+ const ms = multi?.(Math.max(0, rr - BOTTOM_KM), cosSun);
199
+ for (let c = 0; c < 3; c += 1) {
200
+ const k = c as 0 | 1 | 2;
201
+ const e = m.ext[k];
202
+ const scatter = m.ray[k] + m.mie;
203
+ const stepT = Math.exp(-e * dt);
204
+ let source = 0;
205
+ if (depth !== undefined)
206
+ source += Math.exp(-depth[k]) * (m.ray[k] * phaseRay + m.mie * phaseMie);
207
+ if (ms !== undefined) source += ms[k] * scatter;
208
+ const integral = e > 1e-12 ? (1 - stepT) / e : dt;
209
+ out.radiance[c] = (out.radiance[c] ?? 0) + (through[c] ?? 1) * source * integral;
210
+ out.transfer[c] = (out.transfer[c] ?? 0) + (through[c] ?? 1) * scatter * integral;
211
+ through[c] = (through[c] ?? 1) * stepT;
212
+ }
213
+ }
214
+ // The sky pass draws no ground luminance (Unreal's sky render passes Ground = false), so the nadir
215
+ // is only the in-scatter up to the planet, near black. The multiple-scattering pass does bounce
216
+ // light off the ground (Ground = true), so `iso` keeps it.
217
+ if (ground && groundT !== undefined) {
218
+ const p = at(groundT);
219
+ const rr = Math.hypot(p[0], p[1], p[2]);
220
+ const cosSun = dot(p, sun) / rr;
221
+ const depth = opticalDepthToTop(rr, cosSun);
222
+ if (depth !== undefined && cosSun > 0)
223
+ for (let c = 0; c < 3; c += 1)
224
+ out.radiance[c] =
225
+ (out.radiance[c] ?? 0) +
226
+ (through[c] ?? 1) * Math.exp(-depth[c as 0 | 1 | 2]) * cosSun * (GROUND_ALBEDO / Math.PI);
227
+ }
228
+ return out;
229
+ }
230
+
231
+ /**
232
+ * Multiple-scattering luminance per unit scattering coefficient, by altitude and the cosine
233
+ * between the local up and the sun: Psi = L2 / (1 - f), the isotropic infinite-bounce sum.
234
+ * Unreal gathers L2 and f from two rays only, straight up and straight down (the shipped "cheap"
235
+ * approximation in RenderMultiScatteredLuminanceLutCS); the full sphere gather overestimated the
236
+ * ground bounce against the Unreal frames by up to 1.6x, so this uses the same two rays.
237
+ */
238
+ function multipleScatteringTable(): Multi {
239
+ const nh = 12;
240
+ const nc = 16;
241
+ const dirs: Vec3[] = [
242
+ [0, 1, 0],
243
+ [0, -1, 0],
244
+ ];
245
+ const table: Rgb[] = [];
246
+ for (let ih = 0; ih < nh; ih += 1) {
247
+ const h = ((ih + 0.5) / nh) ** 2 * (TOP_KM - BOTTOM_KM);
248
+ for (let ic = 0; ic < nc; ic += 1) {
249
+ const cosSun = -1 + (2 * (ic + 0.5)) / nc;
250
+ const sun: Vec3 = [Math.sqrt(1 - cosSun * cosSun), cosSun, 0];
251
+ const sum = [0, 0, 0];
252
+ const transfer = [0, 0, 0];
253
+ for (const dir of dirs) {
254
+ const ray = march(BOTTOM_KM + h, dir, sun, true, undefined, true, linear(15));
255
+ for (let c = 0; c < 3; c += 1) {
256
+ sum[c] = (sum[c] ?? 0) + (ray.radiance[c] ?? 0);
257
+ transfer[c] = (transfer[c] ?? 0) + (ray.transfer[c] ?? 0);
258
+ }
259
+ }
260
+ table.push(
261
+ [0, 1, 2].map((c) => {
262
+ const l2 = (sum[c] ?? 0) / dirs.length;
263
+ const f = Math.min(0.99, (transfer[c] ?? 0) / dirs.length);
264
+ return l2 / (1 - f);
265
+ }) as unknown as Rgb,
266
+ );
267
+ }
268
+ }
269
+ return (h, cosSun) => {
270
+ const u = Math.min(
271
+ nh - 1,
272
+ Math.max(0, Math.sqrt(Math.max(0, h) / (TOP_KM - BOTTOM_KM)) * nh - 0.5),
273
+ );
274
+ const v = Math.min(nc - 1, Math.max(0, ((cosSun + 1) / 2) * nc - 0.5));
275
+ const [u0, v0] = [Math.floor(u), Math.floor(v)];
276
+ const [u1, v1] = [Math.min(nh - 1, u0 + 1), Math.min(nc - 1, v0 + 1)];
277
+ const [fu, fv] = [u - u0, v - v0];
278
+ const cell = (i: number, j: number): Rgb => table[i * nc + j] as Rgb;
279
+ return [0, 1, 2].map((c) => {
280
+ const k = c as 0 | 1 | 2;
281
+ const a = cell(u0, v0)[k] * (1 - fv) + cell(u0, v1)[k] * fv;
282
+ const b = cell(u1, v0)[k] * (1 - fv) + cell(u1, v1)[k] * fv;
283
+ return a * (1 - fu) + b * fu;
284
+ }) as unknown as Rgb;
285
+ };
286
+ }
287
+
288
+ /**
289
+ * Unreal's distant sky light: the mean radiance over the whole sphere seen from `altitudeKm`
290
+ * (r.SkyAtmosphere.DistantSkyLightLUT.Altitude, 6 km), isotropic phase, no ground bounce, the
291
+ * multiple-scattering term included (RenderDistantSkyLightLutCS in
292
+ * Engine/Shaders/Private/SkyAtmosphere.usf). Height fog and volumetric clouds both light with it
293
+ * (GetViewDistanceSkyLightColor). Per unit sun illuminance, like `bakeSkyRadiance`.
294
+ */
295
+ const DISTANT_SKY_LIGHT_ALTITUDE_KM = 6;
296
+ /**
297
+ * Unreal's distant sky light shader: one 8 x 8 group, one stratified direction a thread, ten linear
298
+ * samples a ray (RenderDistantSkyLightLutCS). The directions come from a seeded linear congruential
299
+ * stream (0xDE4DC0DE, GUniformSphereSamplesBuffer in SkyAtmosphereRendering.cpp), so the coarse
300
+ * result is one fixed draw, not a mean; the same draw is reproduced here.
301
+ */
302
+ const DISTANT_GROUP = 8;
303
+ function distantDirections(): Vec3[] {
304
+ let seed = 0xde4dc0de;
305
+ const fraction = (): number => {
306
+ seed = (Math.imul(seed, 196314165) + 907633515) >>> 0;
307
+ return (seed >>> 9) / 8388608;
308
+ };
309
+ const dirs: Vec3[] = new Array(DISTANT_GROUP * DISTANT_GROUP);
310
+ for (let i = 0; i < DISTANT_GROUP; i += 1) {
311
+ for (let j = 0; j < DISTANT_GROUP; j += 1) {
312
+ const up = 1 - (2 * (i + fraction())) / DISTANT_GROUP;
313
+ const phi = (2 * Math.PI * (j + fraction())) / DISTANT_GROUP;
314
+ const ring = Math.sqrt(1 - up * up);
315
+ dirs[j * DISTANT_GROUP + i] = [ring * Math.cos(phi), up, ring * Math.sin(phi)];
316
+ }
317
+ }
318
+ return dirs;
319
+ }
320
+ function distantSkyLight(toSun: { x: number; y: number; z: number }): Rgb {
321
+ const sun: Vec3 = [toSun.x, toSun.y, toSun.z];
322
+ const multi = multipleScatteringTable();
323
+ const dirs = distantDirections();
324
+ const sum: [number, number, number] = [0, 0, 0];
325
+ for (const dir of dirs) {
326
+ const ray = march(
327
+ BOTTOM_KM + DISTANT_SKY_LIGHT_ALTITUDE_KM,
328
+ dir,
329
+ sun,
330
+ true,
331
+ multi,
332
+ false,
333
+ linear(10),
334
+ );
335
+ for (let c = 0; c < 3; c += 1) sum[c] = (sum[c] ?? 0) + (ray.radiance[c] ?? 0) / dirs.length;
336
+ }
337
+ return sum;
338
+ }
339
+
340
+ /**
341
+ * The light height fog and clouds take from the sky, per unit sun illuminance: Unreal's distant sky
342
+ * light (GetViewDistanceSkyLightColor). It needs no fit. The 0.76 / 0.871 / 0.941 factors that stood
343
+ * here made up for a finer march than Unreal's own, ten samples a ray from one fixed 8 x 8 draw of
344
+ * directions (`distantSkyLight`); the same march agrees with the Unreal L3 void within 2.4 percent in
345
+ * green and blue at 15 and 60 degrees, and within 0.6 percent in red at 15 degrees. Red stays 10 percent
346
+ * high at 60 degrees, the same excess the clear sky shows at a high sun (open, PRD-633).
347
+ */
348
+ export function viewDistanceSkyLight(toSun: { x: number; y: number; z: number }): Rgb {
349
+ return distantSkyLight(toSun);
350
+ }
351
+
352
+ /**
353
+ * Sky radiance per unit sun illuminance on an equirectangular grid in three's layout: row 0 is the
354
+ * zenith, the middle row the horizon, the last row the nadir, and u = atan2(z, x) / 2pi + 0.5. `sun`
355
+ * is the unit direction toward the sun, y up.
356
+ *
357
+ * Below the horizon it draws the atmosphere's sunlit ground (albedo `GROUND_ALBEDO`, the term
358
+ * Unreal's multiple-scattering pass uses), where Unreal's own sky capture is near black. Unreal's
359
+ * default level fills that half with Lumen: the floor bounces sun into shadow sides and a mirror
360
+ * reflects it. This environment is the only indirect light the templates have, so the ground stands
361
+ * in for that bounce; without it shadow sides read navy and a chrome ball's lower half black (judge,
362
+ * PRD-633). `ground` false draws Unreal's dark nadir, for a game with its own global illumination.
363
+ */
364
+ export function bakeSkyRadiance(
365
+ toSun: { x: number; y: number; z: number },
366
+ width: number,
367
+ height: number,
368
+ ground: boolean,
369
+ ): Float32Array {
370
+ const sun: Vec3 = [toSun.x, toSun.y, toSun.z];
371
+ const multi = multipleScatteringTable();
372
+ const data = new Float32Array(width * height * 3);
373
+ const r0 = BOTTOM_KM + CAMERA_KM;
374
+ for (let y = 0; y < height; y += 1) {
375
+ const elevation = Math.PI / 2 - ((y + 0.5) / height) * Math.PI;
376
+ for (let x = 0; x < width; x += 1) {
377
+ // three's equirectangular lookup: u = atan2(z, x) / 2pi + 0.5.
378
+ const azimuth = ((x + 0.5) / width - 0.5) * 2 * Math.PI;
379
+ const dir: Vec3 = [
380
+ Math.cos(azimuth) * Math.cos(elevation),
381
+ Math.sin(elevation),
382
+ Math.sin(azimuth) * Math.cos(elevation),
383
+ ];
384
+ const ray = march(r0, dir, sun, false, multi, ground, variable(4, 32, 150));
385
+ const o = (y * width + x) * 3;
386
+ data[o] = ray.radiance[0];
387
+ data[o + 1] = ray.radiance[1];
388
+ data[o + 2] = ray.radiance[2];
389
+ }
390
+ }
391
+ return data;
392
+ }
393
+
394
+ /** The default level's sun: 6 lux, 6500 K (tools/unreal-reference/template-actors.json, every sun). */
395
+ const SUN_LUX = 6;
396
+ export const SUN_KELVIN = 6500;
397
+
398
+ /**
399
+ * The sun in three's light units. Unreal renders a lit diffuse surface as albedo x lux x cos(theta);
400
+ * three's Lambert BRDF carries a 1/pi, so the same lux is pi times as large here. Measured on the
401
+ * Unreal L1 cells (no atmosphere, scene-linear EXR): a 0.18 floor under the 60 degree sun reads
402
+ * 0.874 luminance, within 7% of 0.18 x 6 x sin(60 deg) = 0.935 (the residual is checked on the
403
+ * engine's own L1 capture).
404
+ */
405
+ export const SUN_ILLUMINANCE = SUN_LUX * Math.PI;
406
+
407
+ /**
408
+ * Sky radiance relative to the sun, as Unreal renders it. TEMPORARY, measured and not derived: with
409
+ * the sun at 6 lux the model above is 1.3x too bright against the Unreal L2 frames, flat across
410
+ * channels and across the 15 and 4 degree suns (1.30 / 1.30 / 1.35 at 19 degrees elevation), so
411
+ * the sky is scaled by 1/1.3. The lens attenuation constant 0.78 (PostProcessEyeAdaptation.cpp,
412
+ * r.EyeAdaptation.LensAttenuation) has the right size but the path that would apply it to the
413
+ * atmosphere and not to the sun is not found in the source yet.
414
+ */
415
+ export const SKY_TO_SUN = 0.78;
416
+
417
+ /**
418
+ * Colour of a black-body-like light at `kelvin` as linear sRGB with unit luminance: the Planckian
419
+ * locus fit in the CIE 1960 UCS plane (Krystek 1985) that Unreal uses for a light's temperature
420
+ * (Engine/Source/Runtime/Core/Private/Math/Color.cpp, MakeFromColorTemperature), then XYZ to BT.709.
421
+ */
422
+ export function temperatureColour(kelvin: number): Rgb {
423
+ const t = Math.min(15000, Math.max(1000, kelvin));
424
+ const u =
425
+ (0.860117757 + 1.54118254e-4 * t + 1.28641212e-7 * t * t) /
426
+ (1 + 8.42420235e-4 * t + 7.08145163e-7 * t * t);
427
+ const v =
428
+ (0.317398726 + 4.22806245e-5 * t + 4.20481691e-8 * t * t) /
429
+ (1 - 2.89741816e-5 * t + 1.61456053e-7 * t * t);
430
+ const d = 2 * u - 8 * v + 4;
431
+ const x = (3 * u) / d;
432
+ const y = (2 * v) / d;
433
+ const [bx, bz] = [x / y, (1 - x - y) / y];
434
+ return [
435
+ Math.max(0, 3.2404542 * bx - 1.5371385 - 0.4985314 * bz),
436
+ Math.max(0, -0.969266 * bx + 1.8760108 + 0.041556 * bz),
437
+ Math.max(0, 0.0556434 * bx - 0.2040259 + 1.0572252 * bz),
438
+ ];
439
+ }
440
+
441
+ /** The scene's sun light, registered by `setupLighting` so `setupSky` can tint it by the air. */
442
+ export const sunLight: {
443
+ current?: { color: { setRGB(r: number, g: number, b: number): unknown } };
444
+ } = {};