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
@@ -1,10 +1,32 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
3
  //
4
- // One sun. The sky image in `sky.ts` is the fill light — its environment reaches every face the
4
+ // One sun. The sky 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
6
  import { Color, DirectionalLight, PCFSoftShadowMap, type Scene, Vector3 } from "three";
7
- import { SUN_DIRECTION } from "./sky.js";
7
+ import {
8
+ SUN_ILLUMINANCE,
9
+ SUN_KELVIN,
10
+ sunLight,
11
+ sunLightTransmittance,
12
+ temperatureColour,
13
+ } from "./atmosphere.js";
14
+ import { SKY_OPTIONS, SUN_DIRECTION } from "./sky.js";
15
+
16
+ /** The sun as Unreal's default level has it: 6 lux at 6500 K, tinted by the air it crosses. */
17
+ function atmosphereSun(): DirectionalLight {
18
+ const tint = temperatureColour(SUN_KELVIN);
19
+ const through = sunLightTransmittance(Math.asin(Math.min(1, Math.max(-1, SUN_DIRECTION.y))));
20
+ const colour = new Color().setRGB(
21
+ tint[0] * through[0],
22
+ tint[1] * through[1],
23
+ tint[2] * through[2],
24
+ );
25
+ const key = new DirectionalLight(colour, SUN_ILLUMINANCE);
26
+ // `gpuSky.ts` re-tints it when the sun moves.
27
+ sunLight.current = key;
28
+ return key;
29
+ }
8
30
 
9
31
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
10
32
 
@@ -32,8 +54,9 @@ export function setupLighting(
32
54
  renderer.shadowMap.enabled = true;
33
55
  renderer.shadowMap.type = PCFSoftShadowMap;
34
56
 
35
- // Warm white, matched by eye to the photographed midday sun against its own sky.
36
- const key = new DirectionalLight(0xfff1e0, 4.5);
57
+ // Warm white, matched by eye to the photographed midday sun against its own sky (owner
58
+ // The photo sky keeps the warm white matched by eye to its photographed midday sun.
59
+ const key = SKY_OPTIONS.sky === "photo" ? new DirectionalLight(0xfff1e0, 4.5) : atmosphereSun();
37
60
  // The light sits outside the map's own box, so its near plane is not inside the town.
38
61
  key.position.copy(SUN_DIRECTION).multiplyScalar(halfExtent * 2);
39
62
  key.castShadow = true;
@@ -65,7 +65,15 @@ export function createMaterialAssignments(scene: Scene, controls: IBacklightCont
65
65
  converted.delete(source);
66
66
  }
67
67
  function unsupported(material: Material): string | undefined {
68
- if (!(material instanceof MeshStandardMaterial) || material.type !== "MeshStandardMaterial")
68
+ // A town surface (`surface.ts`) is a standard node material with no emission of its own, so it
69
+ // takes the same rim and fill: the copy keeps its colour and roughness nodes.
70
+ const surface =
71
+ (material as { isMeshStandardNodeMaterial?: boolean }).isMeshStandardNodeMaterial === true &&
72
+ (material as { emissiveNode?: unknown }).emissiveNode === null;
73
+ if (
74
+ !surface &&
75
+ (!(material instanceof MeshStandardMaterial) || material.type !== "MeshStandardMaterial")
76
+ )
69
77
  return "unsupported material type";
70
78
  if (
71
79
  material.onBeforeCompile !== Material.prototype.onBeforeCompile ||
@@ -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,
@@ -49,9 +49,17 @@ export class BoxOccluders {
49
49
  return this.#boxes.length;
50
50
  }
51
51
 
52
- /** True when nothing solid stands between `from` and `to`. */
53
- clear(from: Vector3, to: Vector3): boolean {
52
+ /**
53
+ * True when nothing solid stands between `from` and `to`.
54
+ *
55
+ * With `into`, every crossed box is appended to it and the walk does not stop at the first
56
+ * one: the caller needs the whole set to narrow its exact test to the pieces standing there.
57
+ * A crossed box is conservative — the deck colliders span the open air beneath a walkway —
58
+ * so it is a candidate list, not the answer.
59
+ */
60
+ clear(from: Vector3, to: Vector3, into?: TownCollider[]): boolean {
54
61
  this.#tests += 1;
62
+ into?.splice(0, into.length);
55
63
  const dx = to.x - from.x;
56
64
  const dy = to.y - from.y;
57
65
  const dz = to.z - from.z;
@@ -97,9 +105,10 @@ export class BoxOccluders {
97
105
  if (tEnter > tExit) continue;
98
106
 
99
107
  // The segment enters this box before it ends: something solid is in the way.
100
- return false;
108
+ if (into === undefined) return false;
109
+ into.push(box);
101
110
  }
102
- return true;
111
+ return into === undefined || into.length === 0;
103
112
  }
104
113
 
105
114
  debug(): { boxes: number; tests: number } {
@@ -1,6 +1,7 @@
1
1
  // Generated for you. Keep these roles coherent when you change the look.
2
2
  // Neutral greys carry the light; one saturated blue marks what you can touch.
3
3
  export const palette = {
4
+ // Neutral grey ground: owner 2026-10-26 prefers the 7b546d6 look to the beige 0x9b9185.
4
5
  floor: 0xb4b1ae,
5
6
  structure: 0x747578,
6
7
  gridLine: 0x3a3a3c,
@@ -1,8 +1,10 @@
1
+ import type { OutputRenderer } from "@threenative/core";
2
+ import { WorldEnvironment } from "@threenative/core";
1
3
  // Generated for you: ordinary Three.js; ThreeNative does not read this file.
2
4
  //
3
5
  // This file wires two things together and decides nothing itself. `quality.ts`, in this folder,
4
- // owns which stages run at which tier and records what each one measured. `WorldEnvironment`,
5
- // also in this folder, builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
6
+ // owns which stages run at which tier and records what each one measured. `WorldEnvironment` from
7
+ // the core package builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
6
8
  // applied or refused **with a reason**, so a stage that silently no-op'd is never mistaken for
7
9
  // one you turned off.
8
10
  //
@@ -12,8 +14,6 @@
12
14
  // `TN_QUALITY_TIER` names the tier that ran either way.
13
15
  import type { Camera, DirectionalLight, Scene } from "three";
14
16
  import { type QualityTier, qualityPreset, resolveQualityTier } from "./quality.js";
15
- import type { OutputRenderer } from "./worldEnvironment.js";
16
- import { WorldEnvironment } from "./worldEnvironment.js";
17
17
 
18
18
  export function setupPost(
19
19
  renderer: OutputRenderer,
@@ -24,7 +24,14 @@
24
24
  // frame. With the gather on, `playtests/play.playtest.json` measured **34.2 ms p95 against the
25
25
  // 33 ms ceiling**; without it the same scenario passes. Turn it on when you replace the
26
26
  // atmosphere with a flat sky, and read the p95 back out of `TN_FRAME_BUDGET`.
27
- import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
27
+ import {
28
+ type IWorldEnvironmentOptions,
29
+ qualityPreset as coreQualityPreset,
30
+ qualityTiers,
31
+ } from "@threenative/core";
32
+ import { exposureSettings } from "./exposure.js";
33
+ export type { QualityTier } from "@threenative/core";
34
+ import type { QualityTier } from "@threenative/core";
28
35
 
29
36
  /**
30
37
  * The three names this game's look comes in.
@@ -34,123 +41,58 @@ import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
34
41
  * laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
35
42
  * what any of them mean.
36
43
  */
37
- export type QualityTier = "low" | "medium" | "high";
38
-
39
- const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
44
+ export const resolveQualityTier = qualityTiers.resolve;
40
45
 
41
46
  /**
42
- * Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
43
- * `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
47
+ * Named overrides of core's Unreal look: the owner (2026-10-26) prefers the 7b546d6 neutral look,
48
+ * white plaster and grey ground with no yellow cast. `TN_WORLD_ENVIRONMENT` reports the tone curve,
49
+ * the exposure and the gather this runs; delete a line to take core's value back.
44
50
  */
45
- function isQualityTier(value: string): value is QualityTier {
46
- return (QUALITY_TIERS as readonly string[]).includes(value);
47
- }
48
-
49
- /**
50
- * Where each GPU family starts, from `ctx.renderer.gpuClass`.
51
- *
52
- * A start, not a ceiling: the measured frame-budget windows move the look from here, and an
53
- * explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
54
- * family rule matched — falls back to the `mobile` flag, exactly as before families existed.
55
- * Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
56
- */
57
- const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
58
- software: "low",
59
- "mobile-low": "low",
60
- "mobile-mid": "low",
61
- "mobile-high": "medium",
62
- integrated: "medium",
63
- discrete: "high",
64
- };
65
-
66
- /**
67
- * Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
68
- *
69
- * Fails closed. An unrecognised tier name throws with the value it was handed rather than
70
- * quietly rendering the default, because a silent fallback here looks exactly like a tier that
71
- * turned out to have no effect.
72
- */
73
- export function resolveQualityTier(
74
- request: {
75
- readonly gpuClass?: string;
76
- readonly mobile?: boolean;
77
- readonly software?: boolean;
78
- readonly tier?: string;
79
- } = {},
80
- ): QualityTier {
81
- const requested = request.tier;
82
- if (requested !== undefined) {
83
- if (!isQualityTier(requested)) {
84
- throw new Error(
85
- `Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
86
- );
87
- }
88
- return requested;
89
- }
90
- // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
91
- // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
92
- // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
93
- // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
94
- // `tier` above still wins over it.
95
- if (request.software === true) return "low";
96
- const family =
97
- request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
98
- if (family !== undefined) return family;
99
- return request.mobile === true ? "low" : "high";
100
- }
101
-
102
- /**
103
- * The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the sun
104
- * disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey walls and
105
- * flattens contrast), and a corner falloff. Antialiasing is on in every tier that installs a chain;
106
- * see `screenSpaceAA` in `worldEnvironment.ts`.
107
- *
108
- * No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
109
- * captured sky (`sky.ts`), and SSR on rough floors traced speckle into the grid; RCAS then rang the
110
- * smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
111
- */
112
- const shared: IWorldEnvironmentOptions = {
113
- // Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
114
- bloomEnabled: true,
115
- bloomRadius: 0.6,
116
- bloomStrength: 0.22,
117
- bloomThreshold: 1,
51
+ export const neutralLook: IWorldEnvironmentOptions = {
52
+ // ACES at a fixed exposure: core's filmic curve and metered exposure read yellowish on this town.
53
+ tonemapMode: "aces",
118
54
  autoExposureEnabled: false,
119
55
  exposure: 0.62,
120
- tonemapMode: "aces",
121
- vignetteAmount: 0.22,
122
- };
123
-
124
- /**
125
- * What a desktop gets: contact occlusion on top — the dark line where a foot meets the floor and a
126
- * wall meets the ground, most of what separates "objects in a world" from "objects pasted on a
127
- * background". Gathered at full resolution and denoised: at half, the upsample left a grain around
128
- * every foot.
129
- */
130
- const high: IWorldEnvironmentOptions = {
131
- ...shared,
132
- // GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
133
- gtaoEnabled: true,
56
+ // The kit's bloom: a low threshold that lifts the sunlit whitewash a little.
57
+ bloomRadius: 0.5,
58
+ bloomStrength: 0.7,
59
+ bloomThreshold: 0.2,
60
+ // No screen-probe gather or reflections: the bounce off the sunlit ground tints the shade warm.
61
+ finalGatherMethod: "none",
62
+ ssgiEnabled: false,
63
+ ssrEnabled: false,
64
+ // The kit's contact occlusion: whole-frame, a 0.35 m reach, 16 directions (8 on medium).
65
+ gtaoDistanceExponent: 1,
66
+ gtaoDistanceFalloff: 1,
67
+ gtaoIndirectOnly: false,
134
68
  gtaoRadius: 0.35,
69
+ gtaoSamples: 16,
70
+ // 4x MSAA under the chain on every tier.
71
+ samples: 4,
72
+ // No motion blur, on any tier. Core's is Unreal's (UE 5.8.3: Engine/Source/Runtime/Engine/
73
+ // Private/Scene.cpp:646-648, amount 0.5, 5 % cap, 30 fps target), and Unreal scales it by the
74
+ // frame time (Renderer/Private/SceneVisibility.cpp:5650-5658): on a 144 Hz display a moderate
75
+ // mouse turn smears the whole frame to the cap, and aiming is reading that frame. The hands and
76
+ // rifle are skinned, and the engine gives a skinned draw the camera's motion, so they smeared
77
+ // like the far wall; Unreal keeps them sharp with first-person velocity
78
+ // (Engine/Shaders/Private/VelocityShader.usf:74-82). `motionBlurEnabled: true` brings it back.
79
+ motionBlurEnabled: false,
135
80
  };
136
81
 
137
- /** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
138
- const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8, renderChainTier: "medium" };
139
-
140
- /** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
141
- const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
142
-
143
- const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
82
+ /** The 7b546d6 per-tier values: half the occlusion directions on medium, none of it on a phone. */
83
+ const neutralTiers: Readonly<Record<string, IWorldEnvironmentOptions>> = {
84
+ high: {},
85
+ medium: { gtaoSamples: 8 },
86
+ low: { gtaoEnabled: false, gtaoRadius: 0.25, motionBlurEnabled: false, temporalAA: false },
87
+ };
144
88
 
145
- /** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
146
89
  export function qualityPreset(tier: string): IWorldEnvironmentOptions {
147
- const preset = QUALITY_PRESETS[tier as QualityTier];
148
- if (preset === undefined) {
149
- throw new Error(
150
- `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
151
- );
152
- }
153
- return preset;
90
+ return {
91
+ ...coreQualityPreset(tier),
92
+ ...neutralLook,
93
+ ...neutralTiers[tier],
94
+ exposurePolicy: exposureSettings,
95
+ };
154
96
  }
155
97
 
156
98
  /** First admitted material lane: high desktop hardware WebGPU in the browser only. */
@@ -1,14 +1,3 @@
1
- // The one place a real-world size is declared.
2
- //
3
- // One metre is one metre. Everything that builds or measures a physical object imports
4
- // from here, so the game renders at the right size. A model that arrives in centimetres is
5
- // normalised on load — never accommodated by tuning a literal beside it.
6
- //
7
- // This file is why the 2.68 m soldier, the 1.19 m AK and the 1.43 m viewmodel cannot
8
- // come back: there is no second place to write a size.
9
-
10
- import type { Object3D } from "three";
11
-
12
1
  /** Real-world sizes, in metres. */
13
2
  export const scale = {
14
3
  /** Adult soldier, boots to head-top. */
@@ -1,11 +1,18 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  //
3
+ // The default sky is Unreal 5.8.3's default level: a Sky Atmosphere with its volumetric cloud layer, a
4
+ // sky light that captures it, a sun tinted by the air it crosses, and an exponential height fog that
5
+ // takes its colour from the sky (`atmosphere.ts`, `clouds.ts`, `gpuSky.ts`). Sun, sky and fog read one
6
+ // illuminance, so moving `SUN_DIRECTION` recolours all three together. `SKY_OPTIONS.sky = "photo"`
7
+ // keeps the photograph below; `clouds: false` keeps a clear sky.
8
+ //
3
9
  // The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
4
10
  // by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
5
11
  // The same image is the background, the environment light every surface reflects and is filled by,
6
12
  // and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
7
13
  // equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
8
14
  import {
15
+ CanvasTexture,
9
16
  EquirectangularReflectionMapping,
10
17
  FogExp2,
11
18
  SRGBColorSpace,
@@ -13,6 +20,7 @@ import {
13
20
  type Texture,
14
21
  Vector3,
15
22
  } from "three";
23
+ import { createGpuSky } from "./gpuSky.js";
16
24
  import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
17
25
  import { palette } from "./palette.js";
18
26
 
@@ -42,15 +50,43 @@ function distanceDensity(p: HeightFogParams = HEIGHT_FOG): number {
42
50
  return Math.sqrt(Math.max(0, old - height)) / distance;
43
51
  }
44
52
 
45
- export function setupSky(scene: Scene, sky: Texture): void {
53
+ /**
54
+ * The environment light needs no more than 1024x512 of the 4096x2048 sky: three bakes an
55
+ * equirectangular source into a cube a quarter of its width, so the full image makes a 1024 cube and
56
+ * a bake of about 50 s on a software adapter, longer than the startup hold. Frames then draw with no
57
+ * fill light, and the shade reads black until the bake ends. The 256 cube of this copy lights the
58
+ * matte town the same and bakes in seconds. The background keeps the full image.
59
+ */
60
+ const ENVIRONMENT_SIZE = { width: 1024, height: 512 } as const;
61
+
62
+ function environmentOf(sky: Texture): Texture {
63
+ const cached = sky.userData.environment as Texture | undefined;
64
+ if (cached !== undefined) return cached;
65
+ // A host with no OffscreenCanvas (a unit-test stub) or no drawable 2d context keeps the full image:
66
+ // the bake is only slower.
67
+ if (typeof OffscreenCanvas === "undefined") return sky;
68
+ const canvas = new OffscreenCanvas(ENVIRONMENT_SIZE.width, ENVIRONMENT_SIZE.height);
69
+ const context = canvas.getContext("2d");
70
+ // The native host's OffscreenCanvas answers "2d" with a bare object that cannot draw an image.
71
+ if (context === null || typeof context.drawImage !== "function") return sky;
72
+ context.drawImage(sky.image as CanvasImageSource, 0, 0, canvas.width, canvas.height);
73
+ const environment = new CanvasTexture(canvas);
74
+ environment.mapping = EquirectangularReflectionMapping;
75
+ environment.colorSpace = SRGBColorSpace;
76
+ sky.userData.environment = environment;
77
+ return environment;
78
+ }
79
+
80
+ function setupPhotoSky(scene: Scene, sky: Texture): void {
46
81
  sky.mapping = EquirectangularReflectionMapping;
47
82
  sky.colorSpace = SRGBColorSpace;
48
83
  scene.background = sky;
84
+ // The full range: owner 2026-10-26 prefers the 7b546d6 neutral look to the dimmed 0.65 / 0.55 sky.
49
85
  scene.backgroundIntensity = SKY_RANGE;
50
86
  // three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
51
87
  // It is what makes a standard material read as a material: sky-blue fill on faces the sun
52
88
  // misses, and a sky to reflect, sharper as roughness drops.
53
- scene.environment = sky;
89
+ scene.environment = environmentOf(sky);
54
90
  scene.environmentIntensity = SKY_RANGE;
55
91
  // Almost nothing inside the arena (1.4% at 30 m), and the ground plane gone into the horizon by
56
92
  // a kilometre — so the floor meets the sky instead of ending at a line.
@@ -59,3 +95,68 @@ export function setupSky(scene: Scene, sky: Texture): void {
59
95
  scene.fog = distanceFog;
60
96
  scene.fogNode = heightFogNode(distanceFog, HEIGHT_FOG, SUN_DIRECTION);
61
97
  }
98
+
99
+ export const SKY_OPTIONS: { sky: "atmosphere" | "photo"; clouds: boolean; ground: boolean } = {
100
+ sky: "atmosphere",
101
+ clouds: true,
102
+ // The sunlit ground below the horizon stands in for Unreal's Lumen floor bounce: it lifts shadow
103
+ // sides and a mirror reflects it. Set false when the game adds its own global illumination.
104
+ ground: true,
105
+ };
106
+
107
+ /**
108
+ * Unreal's default level fog in metres: density and falloff are per 1000 cm (x0.1 per metre), and its
109
+ * line integral carries ln2 against the exact integral `heightFog.ts` evaluates. `fogHeight` sits
110
+ * 68.5 m below the floor, where the default level puts the fog actor. Inscattering is black and the
111
+ * start distance 0, as in Unreal: the colour comes from the sky.
112
+ */
113
+ const ATMOSPHERE_FOG = {
114
+ ...HEIGHT_FOG,
115
+ density: 0.00436 * Math.LN2,
116
+ heightFalloff: 0.02,
117
+ fogHeight: -68.5,
118
+ startDistance: 0,
119
+ };
120
+
121
+ /** White in the 8-bit environment is this much scene radiance (`createGpuSky`). */
122
+ const ENVIRONMENT_RANGE = 4;
123
+
124
+ /**
125
+ * `photo` is only read when `SKY_OPTIONS.sky` is "photo". `fogged` false leaves the sky unfogged;
126
+ * `clouds` false draws the clear atmosphere. A software adapter draws the 64 x 32 bake as the
127
+ * background, with no LUT or cloud passes.
128
+ */
129
+ export function setupSky(
130
+ scene: Scene,
131
+ photo?: Texture,
132
+ software = false,
133
+ fogged = true,
134
+ clouds = SKY_OPTIONS.clouds,
135
+ ): void {
136
+ if (SKY_OPTIONS.sky === "photo") {
137
+ if (photo === undefined) throw new Error('SKY_OPTIONS.sky "photo" needs assets/sky.jpg loaded');
138
+ setupPhotoSky(scene, photo);
139
+ return;
140
+ }
141
+ // Height fog only; FogExp2 holds the colour `heightFogNode` reads, at zero density. `createGpuSky`
142
+ // sets that colour from the sky and again whenever the sun moves.
143
+ const fog = new FogExp2(0xffffff, 0);
144
+ scene.fog = fog;
145
+ scene.fogNode = heightFogNode(fog, { ...ATMOSPHERE_FOG }, SUN_DIRECTION);
146
+ const { node, environment } = createGpuSky(
147
+ scene,
148
+ SUN_DIRECTION,
149
+ fogged,
150
+ clouds,
151
+ ATMOSPHERE_FOG,
152
+ SKY_OPTIONS.ground,
153
+ );
154
+ environment.mapping = EquirectangularReflectionMapping;
155
+ environment.colorSpace = SRGBColorSpace;
156
+ scene.background = environment;
157
+ scene.backgroundNode = software ? null : node.backgroundNode;
158
+ scene.backgroundIntensity = software ? ENVIRONMENT_RANGE : 1;
159
+ // Unreal's sky light: the same sky, so the fill on every shaded face is the sky's colour.
160
+ scene.environment = environment;
161
+ scene.environmentIntensity = ENVIRONMENT_RANGE;
162
+ }
@@ -0,0 +1,140 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // Bayview's surfaces: five tiling textures generated for this kit (see `assets/bay-PROVENANCE.md`),
4
+ // loaded once in `Play.load()`. A surface keeps the colour `palette.ts` gives it and takes only the
5
+ // texture's structure: each sample is divided by the texture's own average (its last mip level), so
6
+ // the town's neutral whites and greys stay where the palette puts them. The town's geometry already
7
+ // carries world-metre UVs (`worldGridUVs`), so one sample is a fixed size on every face.
8
+ // - The same texture sampled again at a much larger, turned scale breaks the repeat at street distance.
9
+ // - A wall darkens towards the street, where dust and splash collect (`grime`).
10
+ // - Roughness follows the texture: a worn, lighter patch is smoother than a pit.
11
+ // - The fine detail fades out with distance, as a Megascans detail texture does in Unreal: past
12
+ // `fade` metres a board joint is under a pixel and would only crawl.
13
+ import {
14
+ type ColorRepresentation,
15
+ type Material,
16
+ RepeatWrapping,
17
+ type Texture,
18
+ Vector2,
19
+ } from "three";
20
+ import {
21
+ cameraPosition,
22
+ float,
23
+ materialColor,
24
+ materialRoughness,
25
+ max,
26
+ mix,
27
+ positionWorld,
28
+ smoothstep,
29
+ texture,
30
+ uv,
31
+ vec2,
32
+ vec3,
33
+ } from "three/tsl";
34
+ import { MeshStandardNodeMaterial, type Node } from "three/webgpu";
35
+
36
+ type TextureLoader = {
37
+ texture(
38
+ path: string,
39
+ options?: { wrap?: number; anisotropy?: number; data?: boolean },
40
+ ): Promise<Texture>;
41
+ };
42
+
43
+ // The files live once in the package's `template-assets/assets/`; the scaffolder copies each one
44
+ // named here, with `bay-PROVENANCE.md` (its generation record). The three most-seen surfaces also
45
+ // carry a normal map derived from their own light and dark: a joint, a gap or a trowel mark is a dent.
46
+ const FILES = {
47
+ plaster: "bay-plaster.webp",
48
+ pavement: "bay-pavement.webp",
49
+ wood: "bay-wood.webp",
50
+ metal: "bay-metal.webp",
51
+ ground: "bay-ground.webp",
52
+ } as const;
53
+ export type Surface = keyof typeof FILES;
54
+ const NORMALS: Partial<Record<Surface, string>> = {
55
+ plaster: "bay-plaster-normal.webp",
56
+ pavement: "bay-pavement-normal.webp",
57
+ wood: "bay-wood-normal.webp",
58
+ };
59
+ /** Metres per repeat of each tile. */
60
+ const TILE: Record<Surface, number> = {
61
+ plaster: 3,
62
+ pavement: 2.4,
63
+ wood: 2.4,
64
+ metal: 1.5,
65
+ ground: 4,
66
+ };
67
+
68
+ let maps: Record<Surface, Texture> | undefined;
69
+ let normals: Partial<Record<Surface, Texture>> = {};
70
+
71
+ /** Loads the textures once: albedo in sRGB, normal maps as data, all repeating and anisotropic. */
72
+ export async function loadSurfaces(assets: TextureLoader): Promise<void> {
73
+ const load = (file: string, data: boolean) =>
74
+ assets.texture(file, { anisotropy: 8, data, wrap: RepeatWrapping });
75
+ const names = Object.keys(FILES) as Surface[];
76
+ const bumped = names.filter((name) => NORMALS[name] !== undefined);
77
+ const [albedo, normal] = await Promise.all([
78
+ Promise.all(names.map((name) => load(FILES[name], false))),
79
+ Promise.all(bumped.map((name) => load(NORMALS[name] as string, true))),
80
+ ]);
81
+ maps = Object.fromEntries(names.map((name, i) => [name, albedo[i]])) as Record<Surface, Texture>;
82
+ normals = Object.fromEntries(
83
+ bumped.map((name, i) => {
84
+ // The normal map rides the geometry's metre UVs, so its repeat sets the tile size.
85
+ (normal[i] as Texture).repeat.setScalar(1 / TILE[name]);
86
+ return [name, normal[i]];
87
+ }),
88
+ );
89
+ }
90
+
91
+ /** A sample over the texture's own average: about 1, darker in its pits, lighter on its ridges. */
92
+ function structure(map: Texture, at: Node<"vec2">, strength: Node<"float"> | number) {
93
+ const mean = max(texture(map, vec2(0.5, 0.5)).level(float(16)).xyz, vec3(0.02, 0.02, 0.02));
94
+ return mix(vec3(1, 1, 1), texture(map, at).xyz.div(mean), strength);
95
+ }
96
+
97
+ export interface ISurfaceOptions {
98
+ readonly roughness: number;
99
+ readonly metalness?: number;
100
+ /** How much of the texture's light and dark shows, 0 to 1. */
101
+ readonly strength?: number;
102
+ /** How much darker the foot of a wall is than its top, 0 to 1. */
103
+ readonly grime?: number;
104
+ /** How deep the surface's normal map reads; 0 is flat. */
105
+ readonly bump?: number;
106
+ /** How much the large, turned copy of the texture shows, 0 to 1. */
107
+ readonly patches?: number;
108
+ /** Metres from the camera at which the fine detail has faded to a fifth. */
109
+ readonly fade?: number;
110
+ }
111
+
112
+ /**
113
+ * A lit surface in `color` carrying the structure of texture `surface`, or `undefined` before
114
+ * `loadSurfaces` resolves (unit tests, a failed download): the caller keeps its plain material then.
115
+ */
116
+ export function surfaced(
117
+ color: ColorRepresentation,
118
+ surface: Surface,
119
+ options: ISurfaceOptions,
120
+ ): Material | undefined {
121
+ if (maps === undefined) return undefined;
122
+ const map = maps[surface];
123
+ const { strength = 0.8, grime = 0, metalness = 0, bump = 0, patches: wear = 0.45 } = options;
124
+ const { fade = 40 } = options;
125
+ const at = uv().div(TILE[surface]);
126
+ const near = smoothstep(fade, fade * 0.25, positionWorld.distance(cameraPosition));
127
+ const detail = structure(map, at, near.mul(0.8).add(0.2).mul(strength));
128
+ // A turned, seven-times-larger copy: soft patches of wear that do not line up with the tile.
129
+ const patches = structure(map, vec2(at.y.mul(-0.137), at.x.mul(0.141)), wear);
130
+ const foot = mix(float(1 - grime), float(1), smoothstep(0, 1.4, positionWorld.y));
131
+ const material = new MeshStandardNodeMaterial({ color, roughness: options.roughness, metalness });
132
+ material.colorNode = materialColor.mul(detail).mul(patches).mul(foot);
133
+ material.roughnessNode = materialRoughness.mul(float(2).sub(detail.x).clamp(0.7, 1.3));
134
+ const normal = normals[surface];
135
+ if (bump > 0 && normal !== undefined) {
136
+ material.normalMap = normal;
137
+ material.normalScale = new Vector2(bump, bump);
138
+ }
139
+ return material;
140
+ }
@@ -40,7 +40,6 @@ import {
40
40
  addDoorsAndShutters,
41
41
  addRoofLife,
42
42
  createFacade,
43
- finishFacade,
44
43
  visibleFaces,
45
44
  } from "./facade.js";
46
45
  import { worldGridUVs } from "./materials.js";
@@ -966,11 +965,9 @@ export function buildTown(materials: TownMaterials): Town {
966
965
  // Raised deck footprints, for the under-the-deck observation.
967
966
  const decks: DeckFootprint[] = [BACK_PLAT_DECK, HEAVEN_DECK, CATWALK_DECK];
968
967
 
969
- // One merge for the whole town's joinery, parapets and rooftop clutter.
970
- finishFacade(facade);
971
-
972
- // Every solid now exists carrying its final material — merged facade batches
973
- // included — so this one walk can tag them all. Must stay after the merge.
968
+ // Every solid now exists carrying its final material, so this one walk can
969
+ // tag them all — while a crate is still called "crate": the engine
970
+ // merges the settled town later, and a hit still names the authored mesh.
974
971
  tagSurfaces(hittable, materials);
975
972
 
976
973
  return {