create-threenative 0.2.10 → 0.2.13

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 +227 -34
  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 +15 -10
  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 +14 -9
  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 +15 -10
  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 +15 -10
  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 +15 -10
  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 +72 -1
  420. package/templates/racing/src/scenes/Race.ts +9 -7
  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 +14 -9
  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 +14 -9
  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 +15 -10
  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 +15 -10
  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 +15 -10
  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 +15 -10
  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 +15 -10
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +14 -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 +27 -14
  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 +15 -10
  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,478 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // The painted battlefield: one texture over the whole 224 m map, drawn once at boot on the CPU so it
5
+ // runs where there is no DOM canvas (the desktop and phone hosts). Noise ground, dirt roads with two
6
+ // wheel ruts, damp shorelines, a tiled apron under every base, an expansion ring on every free ore
7
+ // site and a scatter of fissures. Change a colour, a width or a road here; nothing else reads it.
8
+ import { DataTexture, LinearMipmapLinearFilter, RepeatWrapping, SRGBColorSpace } from "three";
9
+ import { HALF, POOLS, RESOURCE_SITES, STARTS, WORLD, terrainNoise } from "../sim/terrain.js";
10
+ import { seeded } from "../sim/types.js";
11
+
12
+ /** Dirt roads between the bases, as world `[x, z]` polylines. Art only: units do not prefer them. */
13
+ export const ROAD_PATHS: readonly (readonly (readonly [number, number])[])[] = [
14
+ [
15
+ [-58, 55],
16
+ [-46, 42],
17
+ [-37, 26],
18
+ [-22, 17],
19
+ [-9, 27],
20
+ [19, 43],
21
+ [38, 56],
22
+ [69, 67],
23
+ ],
24
+ [
25
+ [-70, 44],
26
+ [-70, 22],
27
+ [-60, 15],
28
+ [-56, -8],
29
+ [-55, -31],
30
+ [-62, -53],
31
+ [-70, -72],
32
+ ],
33
+ [
34
+ [-70, -72],
35
+ [-53, -63],
36
+ [-38, -42],
37
+ [-30, -20],
38
+ [7, -20],
39
+ [31, -31],
40
+ [45, -42],
41
+ [59, -53],
42
+ [70, -68],
43
+ ],
44
+ [
45
+ [-9, 27],
46
+ [-8, 1],
47
+ [-11, -6],
48
+ [-12, -20],
49
+ ],
50
+ [
51
+ [69, 67],
52
+ [78, 46],
53
+ [82, 27],
54
+ [85, 0],
55
+ [75, -19],
56
+ [70, -42],
57
+ [70, -68],
58
+ ],
59
+ ];
60
+
61
+ /** The base apron a start stands on, in world metres. Grass and rubble stay off it. */
62
+ export function padAt(x: number, z: number): boolean {
63
+ return STARTS.some((s) => Math.abs(x - s.x) < 24 && Math.abs(z - s.z) < 23);
64
+ }
65
+
66
+ export function segmentDistance(
67
+ x: number,
68
+ z: number,
69
+ a: readonly [number, number],
70
+ b: readonly [number, number],
71
+ ): number {
72
+ const dx = b[0] - a[0];
73
+ const dz = b[1] - a[1];
74
+ const q = Math.max(0, Math.min(1, ((x - a[0]) * dx + (z - a[1]) * dz) / (dx * dx + dz * dz)));
75
+ return Math.hypot(x - a[0] - dx * q, z - a[1] - dz * q);
76
+ }
77
+
78
+ /** RGBA, straight alpha, 0-255 colour and 0-1 alpha. */
79
+ type Paint = readonly [number, number, number, number];
80
+
81
+ /** Texels across the map: 2048 is 11 cm a texel, fine enough for a rivet at tactical zoom. */
82
+ const SIZE = 2048;
83
+ const SCALE = SIZE / WORLD;
84
+ const px = (metres: number): number => (metres + HALF) * SCALE;
85
+
86
+ /** A painter over the texture's own RGBA bytes: every stroke is source-over in sRGB, like a 2D canvas. */
87
+ class Canvas {
88
+ readonly rgba = new Uint8ClampedArray(SIZE * SIZE * 4);
89
+ /** Per-texel distance to the road being stroked, reset only where a road touched it. */
90
+ readonly #distance = new Float32Array(SIZE * SIZE).fill(Number.POSITIVE_INFINITY);
91
+
92
+ blend(index: number, c: Paint, coverage = 1): void {
93
+ const a = c[3] * coverage;
94
+ if (a <= 0) return;
95
+ const rgba = this.rgba;
96
+ const k = index * 4;
97
+ rgba[k] = (rgba[k] ?? 0) + (c[0] - (rgba[k] ?? 0)) * a;
98
+ rgba[k + 1] = (rgba[k + 1] ?? 0) + (c[1] - (rgba[k + 1] ?? 0)) * a;
99
+ rgba[k + 2] = (rgba[k + 2] ?? 0) + (c[2] - (rgba[k + 2] ?? 0)) * a;
100
+ }
101
+
102
+ /** Visit every texel centre inside a pixel-space box, clamped to the map. */
103
+ each(
104
+ x0: number,
105
+ y0: number,
106
+ x1: number,
107
+ y1: number,
108
+ visit: (x: number, y: number, i: number) => void,
109
+ ): void {
110
+ const ax = Math.max(0, Math.floor(x0));
111
+ const ay = Math.max(0, Math.floor(y0));
112
+ const bx = Math.min(SIZE - 1, Math.ceil(x1));
113
+ const by = Math.min(SIZE - 1, Math.ceil(y1));
114
+ for (let y = ay; y <= by; y++)
115
+ for (let x = ax; x <= bx; x++) visit(x + 0.5, y + 0.5, y * SIZE + x);
116
+ }
117
+
118
+ /**
119
+ * One road: each stroke `[width, paint]` drawn over the whole polyline as one path, with round
120
+ * joins and caps. Distances are measured once, only near each segment, then every stroke reads them.
121
+ */
122
+ road(
123
+ points: readonly (readonly [number, number])[],
124
+ strokes: readonly (readonly [number, Paint])[],
125
+ ): void {
126
+ const reach = Math.max(...strokes.map(([width]) => width)) / 2 + 1;
127
+ const distance = this.#distance;
128
+ const touched: number[] = [];
129
+ for (let s = 1; s < points.length; s++) {
130
+ const a = points[s - 1];
131
+ const b = points[s];
132
+ if (a === undefined || b === undefined) continue;
133
+ this.each(
134
+ Math.min(a[0], b[0]) - reach,
135
+ Math.min(a[1], b[1]) - reach,
136
+ Math.max(a[0], b[0]) + reach,
137
+ Math.max(a[1], b[1]) + reach,
138
+ (x, y, i) => {
139
+ const d = segmentDistance(x, y, a, b);
140
+ if (d >= reach) return;
141
+ const was = distance[i] ?? Number.POSITIVE_INFINITY;
142
+ if (was === Number.POSITIVE_INFINITY) touched.push(i);
143
+ if (d < was) distance[i] = d;
144
+ },
145
+ );
146
+ }
147
+ for (const [width, paint] of strokes)
148
+ for (const i of touched)
149
+ this.blend(i, paint, Math.max(0, Math.min(1, width / 2 - (distance[i] ?? 0) + 0.5)));
150
+ for (const i of touched) distance[i] = Number.POSITIVE_INFINITY;
151
+ }
152
+
153
+ /** A short polyline stroked at `width` pixels; fine for a few small marks. */
154
+ polyline(points: readonly (readonly [number, number])[], width: number, c: Paint): void {
155
+ this.road(points, [[width, c]]);
156
+ }
157
+
158
+ /** A straight dashed line, the dash restarting at `a` the way a canvas `moveTo` restarts it. */
159
+ dashed(
160
+ a: readonly [number, number],
161
+ b: readonly [number, number],
162
+ width: number,
163
+ on: number,
164
+ off: number,
165
+ c: Paint,
166
+ ): void {
167
+ const half = width / 2;
168
+ const dx = b[0] - a[0];
169
+ const dy = b[1] - a[1];
170
+ const length = Math.hypot(dx, dy);
171
+ this.each(
172
+ Math.min(a[0], b[0]) - half - 1,
173
+ Math.min(a[1], b[1]) - half - 1,
174
+ Math.max(a[0], b[0]) + half + 1,
175
+ Math.max(a[1], b[1]) + half + 1,
176
+ (x, y, i) => {
177
+ const t = ((x - a[0]) * dx + (y - a[1]) * dy) / length;
178
+ if (t < 0 || t > length || t % (on + off) > on) return;
179
+ this.blend(i, c, Math.max(0, Math.min(1, half - segmentDistance(x, y, a, b) + 0.5)));
180
+ },
181
+ );
182
+ }
183
+
184
+ /** A dashed ring of `radius` pixels: the dash follows the arc length. */
185
+ dashedRing(
186
+ cx: number,
187
+ cy: number,
188
+ radius: number,
189
+ width: number,
190
+ on: number,
191
+ off: number,
192
+ c: Paint,
193
+ ): void {
194
+ const half = width / 2;
195
+ this.each(
196
+ cx - radius - half - 1,
197
+ cy - radius - half - 1,
198
+ cx + radius + half + 1,
199
+ cy + radius + half + 1,
200
+ (x, y, i) => {
201
+ const d = Math.hypot(x - cx, y - cy);
202
+ const arc = (Math.atan2(y - cy, x - cx) + Math.PI) * radius;
203
+ if (arc % (on + off) > on) return;
204
+ this.blend(i, c, Math.max(0, Math.min(1, half - Math.abs(d - radius) + 0.5)));
205
+ },
206
+ );
207
+ }
208
+
209
+ disc(cx: number, cy: number, radius: number, c: Paint): void {
210
+ this.each(cx - radius - 1, cy - radius - 1, cx + radius + 1, cy + radius + 1, (x, y, i) => {
211
+ this.blend(i, c, Math.max(0, Math.min(1, radius - Math.hypot(x - cx, y - cy) + 0.5)));
212
+ });
213
+ }
214
+ }
215
+
216
+ /** Linear stops of a canvas gradient: `[offset, r, g, b, a]`. */
217
+ function gradient(
218
+ stops: readonly (readonly [number, number, number, number, number])[],
219
+ t: number,
220
+ ): Paint {
221
+ let previous = stops[0];
222
+ if (previous === undefined) throw new Error("A gradient needs at least one stop.");
223
+ for (const stop of stops) {
224
+ if (t <= stop[0]) {
225
+ const f = stop[0] === previous[0] ? 1 : (t - previous[0]) / (stop[0] - previous[0]);
226
+ return [
227
+ previous[1] + (stop[1] - previous[1]) * f,
228
+ previous[2] + (stop[2] - previous[2]) * f,
229
+ previous[3] + (stop[3] - previous[3]) * f,
230
+ previous[4] + (stop[4] - previous[4]) * f,
231
+ ];
232
+ }
233
+ previous = stop;
234
+ }
235
+ return [previous[1], previous[2], previous[3], previous[4]];
236
+ }
237
+
238
+ function baseNoise(canvas: Canvas): void {
239
+ // The noise is painted at half resolution and stretched, as a 2D canvas `drawImage` would.
240
+ const half = SIZE / 2;
241
+ const small = new Float32Array(half * half * 3);
242
+ const rng = seeded(951);
243
+ for (let y = 0; y < half; y++)
244
+ for (let x = 0; x < half; x++) {
245
+ const wx = (x / half) * WORLD - HALF;
246
+ const wz = (y / half) * WORLD - HALF;
247
+ const broad = terrainNoise(wx * 0.032, wz * 0.032);
248
+ const grain = terrainNoise(wx * 0.6, wz * 0.6);
249
+ const cool = terrainNoise(wx * 0.08 + 17, wz * 0.08 + 13);
250
+ const v = broad * 27 + grain * 10 + rng() * 5;
251
+ const k = (y * half + x) * 3;
252
+ small[k] = 82 + v - cool * 7;
253
+ small[k + 1] = 78 + v - cool * 3;
254
+ small[k + 2] = 62 + v + cool * 5;
255
+ }
256
+ for (let y = 0; y < SIZE; y++) {
257
+ const sy = Math.min(half - 1, Math.max(0, (y + 0.5) / 2 - 0.5));
258
+ const y0 = Math.floor(sy);
259
+ const y1 = Math.min(half - 1, y0 + 1);
260
+ const fy = sy - y0;
261
+ for (let x = 0; x < SIZE; x++) {
262
+ const sx = Math.min(half - 1, Math.max(0, (x + 0.5) / 2 - 0.5));
263
+ const x0 = Math.floor(sx);
264
+ const x1 = Math.min(half - 1, x0 + 1);
265
+ const fx = sx - x0;
266
+ for (let c = 0; c < 3; c++) {
267
+ const a =
268
+ (small[(y0 * half + x0) * 3 + c] ?? 0) * (1 - fx) +
269
+ (small[(y0 * half + x1) * 3 + c] ?? 0) * fx;
270
+ const b =
271
+ (small[(y1 * half + x0) * 3 + c] ?? 0) * (1 - fx) +
272
+ (small[(y1 * half + x1) * 3 + c] ?? 0) * fx;
273
+ canvas.rgba[(y * SIZE + x) * 4 + c] = a * (1 - fy) + b * fy;
274
+ }
275
+ canvas.rgba[(y * SIZE + x) * 4 + 3] = 255;
276
+ }
277
+ }
278
+ }
279
+
280
+ function roads(canvas: Canvas): void {
281
+ for (const road of ROAD_PATHS) {
282
+ const path = road.map(([x, z]) => [px(x), px(z)] as const);
283
+ canvas.road(path, [
284
+ [9 * SCALE, [149, 136, 105, 0.18]],
285
+ [5.9 * SCALE, [142, 130, 99, 0.35]],
286
+ [4.8 * SCALE, [92, 88, 72, 0.3]],
287
+ ]);
288
+ for (let i = 1; i < road.length; i++) {
289
+ const a = road[i - 1];
290
+ const b = road[i];
291
+ if (a === undefined || b === undefined) continue;
292
+ const d = Math.hypot(b[0] - a[0], b[1] - a[1]);
293
+ for (const side of [-1, 1]) {
294
+ const ox = (-(b[1] - a[1]) / d) * 1.1 * side;
295
+ const oz = ((b[0] - a[0]) / d) * 1.1 * side;
296
+ canvas.dashed(
297
+ [px(a[0] + ox), px(a[1] + oz)],
298
+ [px(b[0] + ox), px(b[1] + oz)],
299
+ 0.45 * SCALE,
300
+ 1.8 * SCALE,
301
+ 0.6 * SCALE,
302
+ [52, 55, 45, 0.16],
303
+ );
304
+ }
305
+ }
306
+ }
307
+ }
308
+
309
+ function shorelines(canvas: Canvas): void {
310
+ const stops = [
311
+ [0, 40, 59, 52, 1],
312
+ [0.58, 79, 95, 69, 1],
313
+ [0.78, 115, 119, 75, 0.6],
314
+ [1, 122, 124, 86, 0],
315
+ ] as const;
316
+ for (const p of POOLS) {
317
+ const cx = px(p.x);
318
+ const cy = px(p.z);
319
+ const rx = p.rx * SCALE;
320
+ const ry = p.rz * SCALE;
321
+ canvas.each(cx - rx * 1.5, cy - ry * 1.5, cx + rx * 1.5, cy + ry * 1.5, (x, y, i) => {
322
+ const d = Math.hypot((x - cx) / rx, (y - cy) / ry);
323
+ canvas.blend(i, gradient(stops, (d - 0.6) / 0.8));
324
+ });
325
+ }
326
+ }
327
+
328
+ function aprons(canvas: Canvas, rng: () => number): void {
329
+ const tile = 4.4 * SCALE;
330
+ for (const s of STARTS) {
331
+ const x0 = px(s.x - 23);
332
+ const y0 = px(s.z - 22);
333
+ const w = 46 * SCALE;
334
+ const h = 44 * SCALE;
335
+ const cut = 2.5 * SCALE;
336
+ // Inside the cut-corner octagon, with the 3-texel rim the canvas stroke would put on its edge.
337
+ const inside = (x: number, y: number, grow = 0): boolean => {
338
+ const lx = x - x0;
339
+ const ly = y - y0;
340
+ if (lx < -grow || ly < -grow || lx > w + grow || ly > h + grow) return false;
341
+ const cx = Math.min(lx, w - lx) + grow;
342
+ const cy = Math.min(ly, h - ly) + grow;
343
+ return cx + cy >= cut;
344
+ };
345
+ const fill: Paint = s.team === 2 ? [88, 97, 108, 1] : [100, 114, 118, 1];
346
+ canvas.each(x0 - 2, y0 - 2, x0 + w + 2, y0 + h + 2, (x, y, i) => {
347
+ if (inside(x, y)) canvas.blend(i, fill);
348
+ if (inside(x, y, 1.5) && !inside(x, y, -1.5)) canvas.blend(i, [137, 147, 141, 1]);
349
+ });
350
+ for (let ty = y0; ty < y0 + h; ty += tile)
351
+ for (let tx = x0; tx < x0 + w; tx += tile) {
352
+ const shade: Paint = [210, 223, 217, rng() * 0.045];
353
+ canvas.each(tx, ty, tx + tile, ty + tile, (x, y, i) => {
354
+ if (!inside(x, y)) return;
355
+ const lx = x - tx;
356
+ const ly = y - ty;
357
+ if (lx < 0 || ly < 0 || lx >= tile || ly >= tile) return;
358
+ if (lx > 1 && ly > 1 && lx < tile - 1 && ly < tile - 1) canvas.blend(i, shade);
359
+ if (lx < 0.7 || ly < 0.7 || lx > tile - 0.7 || ly > tile - 0.7)
360
+ canvas.blend(i, [18, 32, 36, 0.34]);
361
+ for (const rx of [3, tile - 3])
362
+ for (const ry of [3, tile - 3])
363
+ if (lx >= rx && lx < rx + 1.6 && ly >= ry && ly < ry + 1.6)
364
+ canvas.blend(i, [12, 22, 26, 0.34]);
365
+ });
366
+ }
367
+ for (let i = 0; i < 450; i++) {
368
+ const cx = x0 + rng() * w;
369
+ const cy = y0 + rng() * h;
370
+ const r = 2 + rng() * 16;
371
+ canvas.each(cx - r, cy - r, cx + r, cy + r, (x, y, k) => {
372
+ if (inside(x, y))
373
+ canvas.blend(k, [17, 27, 26, 0.1 * Math.max(0, 1 - Math.hypot(x - cx, y - cy) / r)]);
374
+ });
375
+ }
376
+ const border: Paint = [212, 210, 173, 0.6];
377
+ const a = x0 + 8;
378
+ const b = y0 + 8;
379
+ const c = x0 + w - 8;
380
+ const d = y0 + h - 8;
381
+ canvas.dashed([a, b], [c, b], 2, 10, 7, border);
382
+ canvas.dashed([c, b], [c, d], 2, 10, 7, border);
383
+ canvas.dashed([c, d], [a, d], 2, 10, 7, border);
384
+ canvas.dashed([a, d], [a, b], 2, 10, 7, border);
385
+ // The chevron stack on the apron's right side: five small V's pointing down.
386
+ for (let i = 0; i < 5; i++) {
387
+ const vy = y0 + h * 0.4 + i * 8;
388
+ canvas.polyline(
389
+ [
390
+ [x0 + w * 0.87, vy],
391
+ [x0 + w * 0.89, vy + 5],
392
+ [x0 + w * 0.91, vy],
393
+ ],
394
+ 3,
395
+ [220, 213, 161, 0.38],
396
+ );
397
+ }
398
+ }
399
+ }
400
+
401
+ function expansions(canvas: Canvas): void {
402
+ for (const site of RESOURCE_SITES.slice(3)) {
403
+ const x = px(site.baseX);
404
+ const y = px(site.baseZ);
405
+ canvas.disc(x, y, 8 * SCALE, [57, 65, 63, 0.21]);
406
+ canvas.dashedRing(x, y, 7 * SCALE, 1.5, 7, 6, [188, 179, 142, 0.48]);
407
+ }
408
+ }
409
+
410
+ function fissures(canvas: Canvas, rng: () => number): void {
411
+ for (let i = 0; i < 12000; i++) {
412
+ const x = rng() * SIZE;
413
+ const y = rng() * SIZE;
414
+ const rx = 0.5 + rng() * 2;
415
+ const ry = 0.5 + rng();
416
+ const angle = rng() * 6;
417
+ const cos = Math.cos(angle);
418
+ const sin = Math.sin(angle);
419
+ const c: Paint = i % 2 ? [222, 212, 165, 0.06] : [21, 28, 23, 0.12];
420
+ canvas.each(x - rx - 1, y - rx - 1, x + rx + 1, y + rx + 1, (sx, sy, k) => {
421
+ const u = ((sx - x) * cos + (sy - y) * sin) / rx;
422
+ const v = (-(sx - x) * sin + (sy - y) * cos) / ry;
423
+ if (u * u + v * v <= 1) canvas.blend(k, c);
424
+ });
425
+ }
426
+ }
427
+
428
+ /**
429
+ * The battlefield texture, `SIZE` texels across `WORLD` metres: sample it at
430
+ * `(world.xz + HALF) / WORLD`, the same coordinates the fog of war uses.
431
+ */
432
+ export function paintGround(): DataTexture {
433
+ const canvas = new Canvas();
434
+ const rng = seeded(951);
435
+ baseNoise(canvas);
436
+ roads(canvas);
437
+ shorelines(canvas);
438
+ aprons(canvas, rng);
439
+ expansions(canvas);
440
+ fissures(canvas, rng);
441
+ const texture = new DataTexture(new Uint8Array(canvas.rgba.buffer), SIZE, SIZE);
442
+ texture.colorSpace = SRGBColorSpace;
443
+ texture.generateMipmaps = true;
444
+ texture.minFilter = LinearMipmapLinearFilter;
445
+ texture.anisotropy = 8;
446
+ texture.needsUpdate = true;
447
+ return texture;
448
+ }
449
+
450
+ /** Horizontal bands of sandstone, wrapped around every mesa: 128 x 256, repeating across. */
451
+ export function sedimentTexture(): DataTexture {
452
+ const w = 128;
453
+ const h = 256;
454
+ const bytes = new Uint8Array(w * h * 4);
455
+ const rng = seeded(782);
456
+ for (let y = 0; y < h; y++)
457
+ for (let x = 0; x < w; x++) {
458
+ const v =
459
+ 142 +
460
+ Math.sin(y * 0.13) * 10 +
461
+ Math.sin(y * 0.52) * 5 +
462
+ Math.sin(y * 0.029) * 20 +
463
+ (rng() - 0.5) * 14 -
464
+ Math.max(0, Math.sin(y * 0.31 + Math.sin(x * 0.07) * 0.6)) ** 14 * 32;
465
+ const i = (y * w + x) * 4;
466
+ bytes[i] = Math.min(255, v + 16);
467
+ bytes[i + 1] = v + 5;
468
+ bytes[i + 2] = v - 13;
469
+ bytes[i + 3] = 255;
470
+ }
471
+ const texture = new DataTexture(bytes, w, h);
472
+ texture.colorSpace = SRGBColorSpace;
473
+ texture.wrapS = RepeatWrapping;
474
+ texture.generateMipmaps = true;
475
+ texture.minFilter = LinearMipmapLinearFilter;
476
+ texture.needsUpdate = true;
477
+ return texture;
478
+ }
@@ -3,20 +3,33 @@
3
3
  //
4
4
  // One sun. The sky image in `sky.ts` is the fill light — its environment reaches every face the
5
5
  // sun misses — so there is no hemisphere or ambient light stacked on top to flatten the frame.
6
- import { Color, DirectionalLight, Object3D, PCFSoftShadowMap, type Scene, Vector3 } from "three";
6
+ import {
7
+ type Camera,
8
+ Color,
9
+ DirectionalLight,
10
+ HemisphereLight,
11
+ Object3D,
12
+ PCFSoftShadowMap,
13
+ type Scene,
14
+ Vector3,
15
+ } from "three";
16
+ import { legacyColor } from "./palette.js";
7
17
  import { SUN_DIRECTION } from "./sky.js";
8
18
 
9
19
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
10
20
 
11
- /** The shadow map is a window that follows the camera, not the whole 224 m map. 64 m across on a
12
- * 4096 map is 3 cm a texel, so a `tank`'s tracks and a worker's shadow are the same softness. */
21
+ /** The shadow map is a window that follows the camera, not the whole 224 m map. `follow` sizes it
22
+ * to the ground the frame shows, so no shadow ends in a line that slides with a pan or a zoom. */
13
23
  const EXTENT = 32;
24
+ /** Metres of ground kept around the frame's corners: terrain relief and the shadow filter's reach. */
25
+ const MARGIN = 2;
26
+ const corner = new Vector3();
14
27
  const SUN_DISTANCE = 120;
15
28
 
16
29
  export interface ISun {
17
30
  readonly key: DirectionalLight;
18
- /** Keep the shadow window over the point the camera is looking at. */
19
- readonly follow: (x: number, z: number) => void;
31
+ /** Keep the shadow window over the point the camera is looking at, wide enough for its whole frame. */
32
+ readonly follow: (x: number, z: number, camera: Camera) => void;
20
33
  }
21
34
 
22
35
  export function setupLighting(scene: Scene, renderer: ShadowRenderer, mobile = false): ISun {
@@ -24,21 +37,29 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer, mobile = f
24
37
  renderer.shadowMap.type = PCFSoftShadowMap;
25
38
 
26
39
  // Warm white, matched by eye to the photographed midday sun against its own sky.
27
- const key = new DirectionalLight(0xfff1e0, 4.5);
40
+ // A warm key, a cool sky over warm ground, and a cool rim from behind the camera. Intensities are
41
+ // three's physical units: the legacy 1.55 / 0.8 / 0.35 times pi.
42
+ scene.add(new HemisphereLight(legacyColor(0xc8e6ef), legacyColor(0x625343), 0.8 * Math.PI));
43
+ const fill = new DirectionalLight(legacyColor(0x83c8dc), 0.35 * Math.PI);
44
+ fill.position.set(30, 25, 40);
45
+ scene.add(fill);
46
+ const key = new DirectionalLight(legacyColor(0xffe7c4), 1.55 * Math.PI);
28
47
  key.position.copy(SUN_DIRECTION).multiplyScalar(SUN_DISTANCE);
29
48
  key.castShadow = true;
30
49
  const size = mobile ? 2048 : 4096;
31
50
  key.shadow.mapSize.set(size, size);
32
- key.shadow.radius = 2;
51
+ // AstraCraft ran three r140, whose PCFSoft kernel ignored the radius: about one texel. Radius 2
52
+ // left contact shadows lighter and blurrier than the reference (PRD-765 judge round 2).
53
+ key.shadow.radius = 1;
33
54
  key.shadow.camera.near = 1;
34
55
  key.shadow.camera.far = SUN_DISTANCE * 2.5;
35
56
  key.shadow.camera.left = -EXTENT;
36
57
  key.shadow.camera.right = EXTENT;
37
58
  key.shadow.camera.top = EXTENT;
38
59
  key.shadow.camera.bottom = -EXTENT;
39
- // Small biases: a large normal bias is what lifts a model's shadow off its own feet.
40
- key.shadow.bias = -0.0002;
41
- key.shadow.normalBias = 0.02;
60
+ // AstraCraft's biases: the window spans up to 300 m at the widest zoom, about 7 cm a texel.
61
+ key.shadow.bias = -0.0005;
62
+ key.shadow.normalBias = 0.07;
42
63
  scene.add(key);
43
64
  // The light's target is the origin by default, so a directional light that never moves casts one
44
65
  // fixed set of shadows across the whole map. It is added to the scene because three only updates
@@ -48,7 +69,7 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer, mobile = f
48
69
  key.target = target;
49
70
  return {
50
71
  key,
51
- follow: (x, z) => {
72
+ follow: (x, z, camera) => {
52
73
  target.position.set(x, 0, z);
53
74
  target.updateMatrixWorld();
54
75
  key.position.set(
@@ -56,6 +77,36 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer, mobile = f
56
77
  SUN_DIRECTION.y * SUN_DISTANCE,
57
78
  z + SUN_DIRECTION.z * SUN_DISTANCE,
58
79
  );
80
+ key.updateMatrixWorld();
81
+ const shadow = key.shadow.camera;
82
+ shadow.position.setFromMatrixPosition(key.matrixWorld);
83
+ shadow.lookAt(target.position);
84
+ shadow.updateMatrixWorld();
85
+ // Where the frame's four corner rays meet the ground, in the shadow camera's own axes.
86
+ let span = EXTENT;
87
+ for (const [nx, ny] of [
88
+ [-1, -1],
89
+ [1, -1],
90
+ [-1, 1],
91
+ [1, 1],
92
+ ] as const) {
93
+ const near = corner.set(nx, ny, -1).unproject(camera);
94
+ const nearX = near.x;
95
+ const nearY = near.y;
96
+ const nearZ = near.z;
97
+ const far = corner.set(nx, ny, 1).unproject(camera);
98
+ const t = nearY / (nearY - far.y);
99
+ corner.set(nearX + (far.x - nearX) * t, 0, nearZ + (far.z - nearZ) * t);
100
+ corner.applyMatrix4(shadow.matrixWorldInverse);
101
+ span = Math.max(span, Math.abs(corner.x) + MARGIN, Math.abs(corner.y) + MARGIN);
102
+ }
103
+ if (shadow.right !== span) {
104
+ shadow.left = -span;
105
+ shadow.right = span;
106
+ shadow.top = span;
107
+ shadow.bottom = -span;
108
+ shadow.updateProjectionMatrix();
109
+ }
59
110
  },
60
111
  };
61
112
  }
@@ -1,15 +1,6 @@
1
1
  // Generated for you. Scene-owned material assignments; no engine appearance hooks.
2
- import {
3
- type Camera,
4
- type DirectionalLight,
5
- Material,
6
- Mesh,
7
- MeshStandardMaterial,
8
- type Object3D,
9
- type Scene,
10
- type Texture,
11
- } from "three";
12
- import { type IBacklightControls, backlightMaterial } from "./backlightMaterial.js";
2
+ import type { Camera, DirectionalLight, Object3D, Scene, Texture } from "three";
3
+ import type { IBacklightControls } from "./backlightMaterial.js";
13
4
  import {
14
5
  type IEnvironmentMeasurement,
15
6
  measureEnvironment,