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
@@ -0,0 +1,218 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // Everything the hero collects or stomps, from primitives: a coin, a red gem, a Sunseed and the
4
+ // three walkers (a "bumblet", a hopper and a thornback). Each is a `Group` whose origin is its base or its centre as named below,
5
+ // so the entity that owns it only ever moves and spins the group.
6
+ import {
7
+ ConeGeometry,
8
+ CylinderGeometry,
9
+ Group,
10
+ IcosahedronGeometry,
11
+ Mesh,
12
+ OctahedronGeometry,
13
+ SphereGeometry,
14
+ TorusGeometry,
15
+ } from "three";
16
+ import { flat, lit } from "./materials.js";
17
+ import { C } from "./palette.js";
18
+
19
+ function shadowed(mesh: Mesh): Mesh {
20
+ mesh.castShadow = true;
21
+ return mesh;
22
+ }
23
+
24
+ /** A spinning coin, origin at its centre. */
25
+ function coin(): Group {
26
+ const group = new Group();
27
+ const disc = shadowed(
28
+ new Mesh(
29
+ new CylinderGeometry(0.34, 0.34, 0.08, 18),
30
+ // Low metalness: a metal coin takes its colour from what it reflects, and over a lawn that
31
+ // turns gold olive. The glow keeps it saturated whatever the meter does.
32
+ lit(C.gold, { metalness: 0.15, roughness: 0.35, emissive: 0.3 }),
33
+ ),
34
+ );
35
+ disc.rotation.x = Math.PI / 2;
36
+ group.add(disc);
37
+ group.add(
38
+ new Mesh(
39
+ new TorusGeometry(0.34, 0.05, 6, 18),
40
+ lit(C.goldDark, { metalness: 0.15, roughness: 0.4, emissive: 0.2 }),
41
+ ),
42
+ );
43
+ return group;
44
+ }
45
+
46
+ /**
47
+ * A red gem, origin at its centre. It casts no shadow: a sharp-edged octahedron under a high sun
48
+ * throws a hard dark diamond on the block it floats over, which reads as a hole, not a gem.
49
+ */
50
+ function gem(): Group {
51
+ const group = new Group();
52
+ const body = new Mesh(
53
+ new OctahedronGeometry(0.42),
54
+ lit(C.gem, { flat: true, roughness: 0.25, emissive: 0.25 }),
55
+ );
56
+ body.scale.set(1.2, 1.7, 1.2);
57
+ group.add(body);
58
+ return group;
59
+ }
60
+
61
+ /** A Sunseed: a glowing seed with two leaves, origin at its centre. */
62
+ function seed(): Group {
63
+ const group = new Group();
64
+ const seed = shadowed(
65
+ new Mesh(
66
+ new IcosahedronGeometry(0.62, 1),
67
+ lit(C.seed, { flat: true, roughness: 0.3, emissive: 0.6 }),
68
+ ),
69
+ );
70
+ seed.scale.set(0.85, 1.1, 0.85);
71
+ group.add(seed);
72
+ for (const side of [-1, 1]) {
73
+ const leaf = shadowed(new Mesh(new SphereGeometry(0.32, 10, 6), lit(C.leaf)));
74
+ leaf.scale.set(1, 0.18, 0.5);
75
+ leaf.position.set(0.35 * side, 0.72, 0);
76
+ leaf.rotation.z = 0.5 * side;
77
+ group.add(leaf);
78
+ }
79
+ const halo = new Mesh(new TorusGeometry(0.95, 0.04, 6, 32), flat(C.seed, { opacity: 0.55 }));
80
+ group.add(halo);
81
+ return group;
82
+ }
83
+
84
+ /** The walker: a round purple bumblet on two stubby feet, origin at its feet, facing -Z. */
85
+ function walker(): Group {
86
+ const group = new Group();
87
+ const body = shadowed(
88
+ new Mesh(new SphereGeometry(0.55, 20, 14), lit(C.walker, { roughness: 0.6 })),
89
+ );
90
+ body.position.y = 0.62;
91
+ body.scale.set(1, 0.85, 1);
92
+ group.add(body);
93
+ const belly = new Mesh(new SphereGeometry(0.38, 14, 10), lit(C.walkerBelly));
94
+ belly.position.set(0, 0.5, -0.3);
95
+ belly.scale.set(1, 0.8, 0.5);
96
+ group.add(belly);
97
+ for (const side of [-1, 1]) {
98
+ const eye = new Mesh(new SphereGeometry(0.11, 10, 8), flat(C.white));
99
+ eye.position.set(0.19 * side, 0.82, -0.44);
100
+ group.add(eye);
101
+ const pupil = new Mesh(new SphereGeometry(0.055, 8, 6), flat(C.ink));
102
+ pupil.position.set(0.19 * side, 0.8, -0.53);
103
+ group.add(pupil);
104
+ const horn = shadowed(new Mesh(new ConeGeometry(0.08, 0.28, 8), lit(C.walkerBelly)));
105
+ horn.position.set(0.28 * side, 1.12, -0.05);
106
+ horn.rotation.z = -0.4 * side;
107
+ group.add(horn);
108
+ const foot = shadowed(new Mesh(new SphereGeometry(0.17, 10, 8), lit(C.boots)));
109
+ foot.position.set(0.26 * side, 0.12, -0.06);
110
+ foot.scale.set(1, 0.7, 1.3);
111
+ foot.name = side < 0 ? "footL" : "footR";
112
+ group.add(foot);
113
+ }
114
+ return group;
115
+ }
116
+
117
+ /** Two eyes, white with a pupil, either side of the snout; `y`/`z` place them, `size` the white. */
118
+ function eyes(group: Group, x: number, y: number, z: number, size: number): void {
119
+ for (const side of [-1, 1]) {
120
+ const eye = new Mesh(new SphereGeometry(size, 10, 8), flat(C.white));
121
+ eye.position.set(x * side, y, z);
122
+ group.add(eye);
123
+ const pupil = new Mesh(new SphereGeometry(size * 0.5, 8, 6), flat(C.ink));
124
+ pupil.position.set(x * side, y - size * 0.1, z - size * 0.8);
125
+ group.add(pupil);
126
+ }
127
+ }
128
+
129
+ /** The hopper: a lime, frog-round bouncer on two long feet, eyes on top, origin at its feet. */
130
+ function hopper(): Group {
131
+ const group = new Group();
132
+ const body = shadowed(
133
+ new Mesh(new SphereGeometry(0.5, 18, 12), lit(C.hopper, { roughness: 0.5 })),
134
+ );
135
+ body.position.y = 0.5;
136
+ body.scale.set(1.05, 0.82, 1);
137
+ group.add(body);
138
+ const belly = new Mesh(new SphereGeometry(0.34, 14, 10), lit(C.hopperBelly));
139
+ belly.position.set(0, 0.4, -0.28);
140
+ belly.scale.set(1, 0.8, 0.5);
141
+ group.add(belly);
142
+ eyes(group, 0.2, 0.92, -0.18, 0.15);
143
+ for (const side of [-1, 1]) {
144
+ const foot = shadowed(new Mesh(new SphereGeometry(0.16, 10, 8), lit(C.hopperBelly)));
145
+ foot.position.set(0.32 * side, 0.08, -0.12);
146
+ foot.scale.set(0.9, 0.5, 1.9);
147
+ group.add(foot);
148
+ }
149
+ return group;
150
+ }
151
+
152
+ /**
153
+ * The thornback: a low rust shell bristling with dark spikes, a sand-coloured head poking out the
154
+ * front, origin at its feet. The spikes are the group named `spikes`, which its telegraph raises.
155
+ */
156
+ function thornback(): Group {
157
+ const group = new Group();
158
+ const shell = shadowed(
159
+ new Mesh(
160
+ new SphereGeometry(0.72, 18, 10, 0, Math.PI * 2, 0, Math.PI / 2),
161
+ lit(C.thornShell, { flat: true, roughness: 0.55 }),
162
+ ),
163
+ );
164
+ shell.position.y = 0.22;
165
+ shell.scale.set(1, 0.85, 1.1);
166
+ group.add(shell);
167
+ const skirt = new Mesh(new CylinderGeometry(0.74, 0.7, 0.2, 18), lit(C.thornBelly));
168
+ skirt.position.y = 0.14;
169
+ group.add(skirt);
170
+ const spikes = new Group();
171
+ spikes.name = "spikes";
172
+ spikes.position.y = 0.22;
173
+ const spike = new ConeGeometry(0.09, 0.42, 6);
174
+ for (let i = 0; i < 9; i += 1) {
175
+ // One on top, then a ring of eight leaning out.
176
+ const tip = shadowed(new Mesh(spike, lit(C.spike, { flat: true })));
177
+ const angle = (i / 8) * Math.PI * 2;
178
+ const lean = i === 8 ? 0 : 0.75;
179
+ tip.position.set(
180
+ Math.sin(angle) * lean * 0.6,
181
+ i === 8 ? 0.72 : 0.5,
182
+ Math.cos(angle) * lean * 0.66,
183
+ );
184
+ tip.rotation.set(Math.cos(angle) * lean, 0, -Math.sin(angle) * lean);
185
+ spikes.add(tip);
186
+ }
187
+ group.add(spikes);
188
+ const head = shadowed(new Mesh(new SphereGeometry(0.27, 14, 10), lit(C.thornBelly)));
189
+ head.position.set(0, 0.36, -0.78);
190
+ group.add(head);
191
+ eyes(group, 0.12, 0.46, -0.98, 0.075);
192
+ for (const side of [-1, 1]) {
193
+ for (const end of [-1, 1]) {
194
+ const foot = shadowed(new Mesh(new SphereGeometry(0.13, 8, 6), lit(C.thornBelly)));
195
+ foot.position.set(0.5 * side, 0.08, 0.42 * end);
196
+ foot.scale.set(1, 0.7, 1.2);
197
+ group.add(foot);
198
+ }
199
+ }
200
+ return group;
201
+ }
202
+
203
+ // Each model is built once and every copy clones it, which shares the geometry and materials.
204
+ // The renderer batches meshes that share both, so forty coins become one instanced draw.
205
+ function shared(build: () => Group): () => Group {
206
+ let model: Group | undefined;
207
+ return () => {
208
+ model ??= build();
209
+ return model.clone();
210
+ };
211
+ }
212
+
213
+ export const coinModel = shared(coin);
214
+ export const gemModel = shared(gem);
215
+ export const seedModel = shared(seed);
216
+ export const walkerModel = shared(walker);
217
+ export const hopperModel = shared(hopper);
218
+ export const thornbackModel = shared(thornback);
@@ -0,0 +1,54 @@
1
+ // Generated for you. This is ordinary Three.js configuration — edit it freely.
2
+ //
3
+ // The look is a fresh Unreal 5.8.3 project's, and it comes from ThreeNative core: the filmic
4
+ // tone curve, metered auto exposure, local exposure, Unreal's bloom and vignette, contact
5
+ // occlusion and temporal anti-aliasing on `high`. The engine's `qualityPreset(tier)` is that look
6
+ // per tier; this file's `qualityPreset` only adds what this game changes on top of it, each change with its reason and its
7
+ // cost. It starts empty on purpose: no tone curve or exposure is pinned here, so the game looks
8
+ // like the engine default until you decide otherwise. The meter is the starter kits' shared one
9
+ // (`kitExposure.ts`: core's Unreal meter at 0 EV).
10
+ //
11
+ // Tiers: `high` (a desktop GPU, Unreal's Epic), `medium` (integrated GPUs and high-end phones)
12
+ // and `low` (other phones and software adapters). A budget breach drops `renderChainTier`, never
13
+ // the curve or the meter. Force one with `setupPost(renderer, scene, camera, { tier: "low" })`.
14
+ import {
15
+ type IWorldEnvironmentOptions,
16
+ type QualityTier,
17
+ qualityPreset as engineQualityPreset,
18
+ qualityTiers,
19
+ } from "@threenative/core";
20
+ import { kitExposureSettings } from "./kitExposure.js";
21
+
22
+ export type { QualityTier };
23
+
24
+ // What `high` changes on top of the engine's `high`. Nothing yet.
25
+ const high: IWorldEnvironmentOptions = {};
26
+ // What `medium` changes on top of the engine's `medium`. Nothing yet.
27
+ const medium: IWorldEnvironmentOptions = {};
28
+ // What `low` changes on top of the engine's `low`. Nothing yet.
29
+ const low: IWorldEnvironmentOptions = {};
30
+
31
+ const OVERRIDES: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
32
+
33
+ /**
34
+ * Share of the meadow's grass tufts each tier draws (`render/foliage.ts`). Not a look option: the
35
+ * same seeded tufts, fewer of them. Cost: every tuft is 12 triangles, so the full meadow is about
36
+ * 21k tufts (255k triangles), one draw per 12 m cell of land; the meadow's distance thinning
37
+ * draws every tuft within 16 m of the camera and an eighth of them past 46 m.
38
+ */
39
+ export const GRASS_SHARE: Record<QualityTier, number> = { high: 1, low: 0.25, medium: 0.4 };
40
+
41
+ /**
42
+ * Picks the tier: an explicit `tier` wins, a software adapter gets `low`, then the GPU family,
43
+ * then `mobile`. An unknown tier name throws (in core) rather than rendering the default.
44
+ */
45
+ export function resolveQualityTier(
46
+ request: Parameters<typeof qualityTiers.resolve>[0] = {},
47
+ ): QualityTier {
48
+ return qualityTiers.resolve(request);
49
+ }
50
+
51
+ /** The engine's look for `tier`, with this game's overrides on top. */
52
+ export function qualityPreset(tier: QualityTier): IWorldEnvironmentOptions {
53
+ return { ...engineQualityPreset(tier), exposurePolicy: kitExposureSettings, ...OVERRIDES[tier] };
54
+ }
@@ -0,0 +1,262 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // A blue gradient with the sun's warm halo and a deck of big cumulus, painted per texel from seeded
4
+ // noise, is the background and, prefiltered by three, the environment: the sky lights every face
5
+ // the sun misses, which is the stock Unreal outdoor setup of one directional sun plus a sky light.
6
+ // Brightness is the tone curve's and the meter's business (`postprocessing.ts`); this file only
7
+ // decides colour, so a darker or warmer sky is an edit to `palette.ts`.
8
+ import {
9
+ Color,
10
+ DataTexture,
11
+ EquirectangularReflectionMapping,
12
+ FogExp2,
13
+ LinearFilter,
14
+ RGBAFormat,
15
+ SRGBColorSpace,
16
+ type Scene,
17
+ UnsignedByteType,
18
+ Vector3,
19
+ } from "three";
20
+ import { palette } from "./palette.js";
21
+
22
+ /**
23
+ * Unit vector toward the sun: a low golden-hour sun about 22° up in the east, a little south, so it
24
+ * rakes across the meadow from the right of a camera looking north to the castle, throws long
25
+ * shadows to the left, rims the grass tips and the hero, and still grazes the castle's south front.
26
+ */
27
+ export const SUN_DIRECTION = new Vector3(0.9, 0.38, 0.16).normalize();
28
+
29
+ /** A 256 x 256 lattice of seeded values: the noise reads a table, far cheaper than a hash per call. */
30
+ const LATTICE = (() => {
31
+ let state = 9137;
32
+ return Float32Array.from({ length: 256 * 256 }, () => {
33
+ state = (state * 1664525 + 1013904223) >>> 0;
34
+ return state / 0x1_0000_0000;
35
+ });
36
+ })();
37
+
38
+ /** Smooth 2D value noise on the lattice, for the cloud deck: deterministic, repeats every 256 units. */
39
+ function noise(x: number, y: number): number {
40
+ const i = Math.floor(x);
41
+ const j = Math.floor(y);
42
+ const fx = (x - i) * (x - i) * (3 - 2 * (x - i));
43
+ const fy = (y - j) * (y - j) * (3 - 2 * (y - j));
44
+ const i0 = i & 255;
45
+ const i1 = (i + 1) & 255;
46
+ const j0 = (j & 255) << 8;
47
+ const j1 = ((j + 1) & 255) << 8;
48
+ const c00 = LATTICE[j0 + i0] as number;
49
+ const c10 = LATTICE[j0 + i1] as number;
50
+ const c01 = LATTICE[j1 + i0] as number;
51
+ const c11 = LATTICE[j1 + i1] as number;
52
+ const top = c00 + (c10 - c00) * fx;
53
+ return top + (c01 + (c11 - c01) * fx - top) * fy;
54
+ }
55
+
56
+ function fbm(x0: number, y0: number, octaves = 5): number {
57
+ let x = x0;
58
+ let y = y0;
59
+ let sum = 0;
60
+ let amplitude = 0.5;
61
+ for (let octave = 0; octave < octaves; octave += 1) {
62
+ sum += amplitude * noise(x, y);
63
+ x = x * 2.03 + 17.1;
64
+ y = y * 2.03 + 9.7;
65
+ amplitude *= 0.5;
66
+ }
67
+ return sum;
68
+ }
69
+
70
+ /**
71
+ * Cloud density on a flat deck seen from below, at deck coordinates (x, y): a broad field of
72
+ * heaps warped by a second noise, with billowed edges from the finer octaves.
73
+ */
74
+ function density(x: number, y: number): number {
75
+ const wx = x + 0.9 * fbm(x * 0.5 + 3.1, y * 0.5, 3);
76
+ const wy = y + 0.9 * fbm(x * 0.5, y * 0.5 + 7.3, 3);
77
+ return fbm(wx, wy);
78
+ }
79
+
80
+ const smooth = (from: number, to: number, value: number): number => {
81
+ const t = Math.min(1, Math.max(0, (value - from) / (to - from)));
82
+ return t * t * (3 - 2 * t);
83
+ };
84
+
85
+ /**
86
+ * sRGB equirectangular radiance from the ground bounce through the horizon to the zenith.
87
+ * `saturation` below 1 pulls every texel toward its own grey: the fill light uses a 30%-saturated
88
+ * copy, because a real sky's shade light is greyed by haze and cloud, and the full blue of the
89
+ * backdrop turns every shadow on the grass teal.
90
+ *
91
+ * The clouds are cumulus on a deck: (azimuth, elevation) projects onto it, so they bunch up and
92
+ * flatten toward the horizon. Each is lit by where its density climbs: a texel whose deck is
93
+ * denser toward the sun, or above it on screen, is on the cloud's shaded side or its flat base.
94
+ */
95
+ export function skyTexture(saturation = 1, width = 2048): DataTexture {
96
+ // three's PMREM sizes its cube from width / 4 and needs at least 16: keep width >= 64.
97
+ const height = width / 2;
98
+ const data = new Uint8Array(width * height * 4);
99
+ // The colours are read into plain numbers once: the loops below run per texel, millions of
100
+ // times, and plain arithmetic there is far cheaper than a `Color` method call.
101
+ const rgb = (color: Color): readonly [number, number, number] => [color.r, color.g, color.b];
102
+ const [highR, highG, highB] = rgb(new Color(palette.skyHigh));
103
+ const [lowR, lowG, lowB] = rgb(new Color(palette.skyLow));
104
+ const [horizonR, horizonG, horizonB] = rgb(new Color(palette.horizon));
105
+ const [groundR, groundG, groundB] = rgb(new Color(palette.grass));
106
+ const [glowR, glowG, glowB] = rgb(new Color(0xffe2b8));
107
+ const [litR, litG, litB] = [1, 0.98, 0.94];
108
+ const [shadeR, shadeG, shadeB] = [0.56, 0.62, 0.74];
109
+ let baseR = 0;
110
+ let baseG = 0;
111
+ let baseB = 0;
112
+ // Pass 1: the deck's density under every cloud-band texel, once (the shading reads neighbours).
113
+ const deck = new Float32Array(width * height);
114
+ const bands = new Float32Array(height);
115
+ for (let row = 0; row < height; row += 1) {
116
+ const elevation = (row / (height - 1) - 0.5) * Math.PI;
117
+ // Scattered heaps overhead, above the cumulus banks; thinning toward the zenith.
118
+ bands[row] = smooth(0.22, 0.4, elevation) * (1 - 0.55 * smooth(0.5, 1.2, elevation));
119
+ if ((bands[row] ?? 0) <= 0) continue;
120
+ // Flattened less than a true deck would be: cumulus heaps stand tall, they are not a sheet.
121
+ const reach = (1 / (Math.tan(elevation) + 0.1)) ** 0.7 * 0.75;
122
+ for (let column = 0; column < width; column += 1) {
123
+ const azimuth = (column / width - 0.5) * Math.PI * 2;
124
+ deck[row * width + column] = density(Math.cos(azimuth) * reach, Math.sin(azimuth) * reach);
125
+ }
126
+ }
127
+ // The cumulus banks over the far hills, per column: where a bank stands (`cluster`), its heaped
128
+ // top and its flat base, in radians of elevation. Noise is read on a circle, so azimuth wraps.
129
+ const tops = new Float32Array(width);
130
+ const bases = new Float32Array(width);
131
+ for (let column = 0; column < width; column += 1) {
132
+ const azimuth = (column / width - 0.5) * Math.PI * 2;
133
+ const px = Math.cos(azimuth) * 4;
134
+ const py = Math.sin(azimuth) * 4;
135
+ const cluster = smooth(0.3, 0.52, fbm(px * 0.6 + 31, py * 0.6 + 7, 3));
136
+ const heap = smooth(0.3, 0.75, fbm(px * 1.6 + 3, py * 1.6 + 11, 2));
137
+ bases[column] = 0.07 + 0.02 * noise(px * 2 + 5, py * 2);
138
+ // Domed: the heap height falls off smoothly to nothing at a bank's ends.
139
+ tops[column] = (bases[column] ?? 0) + (0.04 + 0.26 * heap) * Math.sqrt(cluster) - 0.02;
140
+ }
141
+ // Pass 2: colour. A step of about 0.7 degrees toward the sun and up the sky, in texels.
142
+ const step = Math.max(1, Math.round(width / 512));
143
+ const sunAzimuth = Math.atan2(SUN_DIRECTION.z, SUN_DIRECTION.x);
144
+ const sunElevation = Math.asin(SUN_DIRECTION.y);
145
+ for (let row = 0; row < height; row += 1) {
146
+ const elevation = (row / (height - 1) - 0.5) * Math.PI;
147
+ const up = Math.sin(elevation);
148
+ const cosE = Math.cos(elevation);
149
+ // A thin haze band, then blue deepening to the zenith; below, the haze over the ground.
150
+ if (up < 0) {
151
+ const t = Math.min(1, -up * 3);
152
+ baseR = mix(horizonR, groundR, t);
153
+ baseG = mix(horizonG, groundG, t);
154
+ baseB = mix(horizonB, groundB, t);
155
+ } else if (up < 0.12) {
156
+ const t = up / 0.12;
157
+ baseR = mix(horizonR, lowR, t);
158
+ baseG = mix(horizonG, lowG, t);
159
+ baseB = mix(horizonB, lowB, t);
160
+ } else {
161
+ const t = Math.min(1, (up - 0.12) / 0.55);
162
+ baseR = mix(lowR, highR, t);
163
+ baseG = mix(lowG, highG, t);
164
+ baseB = mix(lowB, highB, t);
165
+ }
166
+ const band = bands[row] ?? 0;
167
+ const above = Math.min(height - 1, row + step);
168
+ const towardRow = Math.min(
169
+ height - 1,
170
+ Math.max(0, row + (sunElevation > elevation ? step : -step)),
171
+ );
172
+ for (let column = 0; column < width; column += 1) {
173
+ // three's equirectangular u: azimuth from +X toward +Z, u = 0.5 on +X.
174
+ const azimuth = (column / width - 0.5) * Math.PI * 2;
175
+ const tx = Math.cos(azimuth) * cosE;
176
+ const tz = Math.sin(azimuth) * cosE;
177
+ // The sun's halo: a warm glow round its direction, wider than the disc the lens never sees.
178
+ const sun = Math.max(0, tx * SUN_DIRECTION.x + up * SUN_DIRECTION.y + tz * SUN_DIRECTION.z);
179
+ const halo = 0.6 * sun ** 32 + 0.22 * sun ** 5;
180
+ let r = mix(baseR, glowR, halo);
181
+ let g = mix(baseG, glowG, halo);
182
+ let b = mix(baseB, glowB, halo);
183
+ const d = deck[row * width + column] ?? 0;
184
+ const cover = band > 0 ? smooth(0.43, 0.54, d) * band : 0;
185
+ if (cover > 0.002) {
186
+ const turn = Math.sin(sunAzimuth - azimuth) > 0 ? step : -step;
187
+ const towardColumn = (column + turn + width) % width;
188
+ // Denser a step toward the sun: the far side of a heap. Denser a step up the sky: its base.
189
+ const toward = (deck[towardRow * width + towardColumn] ?? 0) - d;
190
+ const base01 = (deck[above * width + column] ?? 0) - d;
191
+ // Thick middles go a little grey, as a real heap's core does.
192
+ const light =
193
+ smooth(-0.05, 0.05, -toward * 1.2 - base01 * 2) * (1 - 0.35 * smooth(0.6, 0.8, d));
194
+ // The edge facing the sun catches its warmth.
195
+ const warm = 0.4 * sun ** 3 * light;
196
+ r = mix(r, mix(mix(shadeR, litR, light), glowR, warm), cover);
197
+ g = mix(g, mix(mix(shadeG, litG, light), glowG, warm), cover);
198
+ b = mix(b, mix(mix(shadeB, litB, light), glowB, warm), cover);
199
+ }
200
+ const foot = bases[column] ?? 0;
201
+ const top = tops[column] ?? 0;
202
+ if (elevation > foot && elevation < top + 0.05) {
203
+ // Billowed outline: finer noise lifts and bites the heap's top edge.
204
+ // Elevation moves radially and azimuth round the circle: round puffs, and azimuth wraps.
205
+ const puff = (e: number) =>
206
+ fbm(Math.cos(azimuth) * (14 + e * 15), Math.sin(azimuth) * (14 + e * 15), 3);
207
+ const lump = puff(elevation);
208
+ const below = top + (lump - 0.5) * 0.11 - elevation;
209
+ const inside = smooth(0, 0.02, below) * smooth(foot, foot + 0.012, elevation);
210
+ if (inside > 0.002) {
211
+ // Flat grey base, sunlit crowns, each lump shaded on its lower side.
212
+ const height01 = smooth(foot, top, elevation);
213
+ // A puff's crown is denser than the sky just above it: lit. Its underside is not: shaded.
214
+ const crown = smooth(-0.03, 0.03, lump - puff(elevation + 0.015));
215
+ const light = Math.min(
216
+ 1,
217
+ (0.05 + 0.95 * height01 ** 1.2) * (0.5 + 0.65 * crown) +
218
+ 0.25 * (1 - smooth(0, 0.05, below)),
219
+ );
220
+ const warm = 0.45 * sun ** 2 * light;
221
+ r = mix(r, mix(mix(shadeR, litR, light), glowR, warm), inside);
222
+ g = mix(g, mix(mix(shadeG, litG, light), glowG, warm), inside);
223
+ b = mix(b, mix(mix(shadeB, litB, light), glowB, warm), inside);
224
+ }
225
+ }
226
+ const grey = r * 0.2126 + g * 0.7152 + b * 0.0722;
227
+ const i = (row * width + column) * 4;
228
+ data[i] = Math.round(255 * linearToSrgb(r + (grey - r) * (1 - saturation)));
229
+ data[i + 1] = Math.round(255 * linearToSrgb(g + (grey - g) * (1 - saturation)));
230
+ data[i + 2] = Math.round(255 * linearToSrgb(b + (grey - b) * (1 - saturation)));
231
+ data[i + 3] = 255;
232
+ }
233
+ }
234
+ const sky = new DataTexture(data, width, height, RGBAFormat, UnsignedByteType);
235
+ sky.mapping = EquirectangularReflectionMapping;
236
+ sky.colorSpace = SRGBColorSpace;
237
+ sky.magFilter = LinearFilter;
238
+ sky.minFilter = LinearFilter;
239
+ sky.needsUpdate = true;
240
+ return sky;
241
+ }
242
+
243
+ const mix = (from: number, to: number, t: number): number => from + (to - from) * t;
244
+
245
+ function linearToSrgb(value: number): number {
246
+ const v = Math.min(1, Math.max(0, value));
247
+ return v < 0.0031308 ? v * 12.92 : 1.055 * v ** (1 / 2.4) - 0.055;
248
+ }
249
+
250
+ /** `fill` is the environment light: by default the sky itself, in this game `skyTexture(0.3, 128)`. */
251
+ export function setupSky(scene: Scene, sky: DataTexture, fill: DataTexture = sky): void {
252
+ scene.background = sky;
253
+ scene.backgroundIntensity = 1;
254
+ scene.environment = fill;
255
+ // The sky fills the shade above the background's own level, so a cast shadow reads as a
256
+ // mid-tone of the ground's colour, not a near-black hole in it. Low enough that the low sun's
257
+ // long shadows still read across the lawn.
258
+ scene.environmentIntensity = 1.1;
259
+ // Light haze: about 5% at the castle 70 m off, a third by the far hills at 200 m, so distance reads
260
+ // as layers of paler blue-green, as aerial perspective does in a stock Unreal outdoor level.
261
+ scene.fog = new FogExp2(palette.horizon, 0.0031);
262
+ }