create-threenative 0.2.9 → 0.2.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +229 -36
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +17 -11
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +16 -10
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +17 -11
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +17 -11
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +17 -11
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +76 -5
  420. package/templates/racing/src/scenes/Race.ts +53 -42
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +16 -10
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +16 -10
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +17 -11
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +17 -11
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +17 -11
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +17 -11
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +17 -11
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +56 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +53 -34
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +17 -11
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -0,0 +1,271 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // A procedural misty sky and the forest's mist. The sky is a vertical gradient for the background,
4
+ // and a half-float copy of the same gradient, lifted into light units, for the environment every
5
+ // surface is filled and reflects by. No image file. The mist is height fog on `scene.fogNode`: a
6
+ // distance term (the live `FogExp2`) times a height term that thickens toward the ground, plus a
7
+ // warm glow toward the sun, so the path ahead fades into bright haze while the near ferns stay
8
+ // dark. The engine meters the frame (auto exposure) and maps it through the filmic curve, so these
9
+ // numbers say how the sky and mist relate to the sun, not how bright the screen is.
10
+ import {
11
+ AdditiveBlending,
12
+ Color,
13
+ CylinderGeometry,
14
+ DataTexture,
15
+ DataUtils,
16
+ EquirectangularReflectionMapping,
17
+ FogExp2,
18
+ HalfFloatType,
19
+ InstancedMesh,
20
+ LinearFilter,
21
+ LinearSRGBColorSpace,
22
+ Object3D,
23
+ RGBAFormat,
24
+ type Scene,
25
+ Vector3,
26
+ } from "three";
27
+ import {
28
+ cameraPosition,
29
+ densityFogFactor,
30
+ dot,
31
+ exp2,
32
+ float,
33
+ fog,
34
+ hash,
35
+ instanceIndex,
36
+ max,
37
+ mix,
38
+ normalView,
39
+ positionViewDirection,
40
+ positionWorld,
41
+ pow,
42
+ saturate,
43
+ select,
44
+ sin,
45
+ smoothstep,
46
+ uniform,
47
+ uv,
48
+ vec3,
49
+ } from "three/tsl";
50
+ import { MeshBasicNodeMaterial } from "three/webgpu";
51
+ import { palette } from "./palette.js";
52
+
53
+ /**
54
+ * Unit vector toward the sun: high in the north-west, ahead of a camera that looks down the path,
55
+ * so its shafts slant through the canopy toward the lens and the mist glows on that side.
56
+ */
57
+ export const SUN_DIRECTION = new Vector3(-0.5, 0.72, -0.48).normalize();
58
+
59
+ /** The sky above the canopy, brighter than the mist under it: the forest stands against the light. */
60
+ const SKY_GLOW = 1.5;
61
+ /** How much brighter the sky's light is than its picture. The canopy keeps most of it off the floor. */
62
+ const SKY_RADIANCE = 0.45;
63
+ /** The ground half of the environment: dim green bounce off the moss. */
64
+ const GROUND_FILL = new Color(0.1, 0.13, 0.07);
65
+
66
+ /**
67
+ * The mist, outdoors and under the Hollow's roof. `distance` is the `FogExp2` density; the height
68
+ * term is base-2 optical depth per metre at the ground (`density`), thinning by `heightFalloff` per
69
+ * metre up. `glow` scales the fog colour to the light under the canopy: a mist brighter than the shade
70
+ * it hangs in washes the midground out.
71
+ */
72
+ const MIST = {
73
+ vale: { distance: 0.016, density: 0.005, glow: 0.8 },
74
+ hollow: { distance: 0.004, density: 0.002, glow: 0.5 },
75
+ heightFalloff: 0.3,
76
+ /** Metres of clear air before the mist starts, so the ground at Wren's feet stays crisp. */
77
+ startDistance: 10,
78
+ /** Sun lobe sharpness: up for a tighter glow round the sun. */
79
+ sunExponent: 5,
80
+ /** Metres before the sun glow starts, so the near path is not tinted. */
81
+ sunStartDistance: 6,
82
+ };
83
+ const SUN_COLOUR = new Color(0xffe2b0);
84
+ /** A shaft's added light at its brightest, in the sun's colour; the meter keeps it relative. */
85
+ const SHAFT_BRIGHTNESS = 0.3;
86
+
87
+ function gradient(elevation: number): Color {
88
+ const high = new Color(palette.skyHigh);
89
+ const low = new Color(palette.skyLow);
90
+ const horizon = new Color(palette.horizon);
91
+ if (elevation <= 0) return horizon;
92
+ return elevation < 0.25
93
+ ? horizon.lerp(low, elevation / 0.25)
94
+ : low.lerp(high, Math.min(1, (elevation - 0.25) / 0.75));
95
+ }
96
+
97
+ function equirect(rgba: (elevation: number) => readonly number[]): DataTexture {
98
+ // three's PMREM sizes its cube from width / 4 and needs at least 16: keep width >= 64.
99
+ const width = 128;
100
+ const height = 64;
101
+ const data = new Uint16Array(width * height * 4);
102
+ for (let row = 0; row < height; row += 1) {
103
+ // DataTexture rows start at v=0 (nadir); v=0.5 is the horizon.
104
+ const elevation = Math.sin((row / (height - 1) - 0.5) * Math.PI);
105
+ const texel = rgba(elevation).map(DataUtils.toHalfFloat);
106
+ for (let column = 0; column < width; column += 1) data.set(texel, (row * width + column) * 4);
107
+ }
108
+ const texture = new DataTexture(data, width, height, RGBAFormat, HalfFloatType);
109
+ texture.colorSpace = LinearSRGBColorSpace;
110
+ texture.mapping = EquirectangularReflectionMapping;
111
+ texture.minFilter = LinearFilter;
112
+ texture.magFilter = LinearFilter;
113
+ texture.needsUpdate = true;
114
+ return texture;
115
+ }
116
+
117
+ export interface ISky {
118
+ readonly background: DataTexture;
119
+ readonly environment: DataTexture;
120
+ /** Under the Hollow's roof: a cool stone-grey fill, so the warm torches read against it. */
121
+ readonly hollow: DataTexture;
122
+ }
123
+
124
+ export function createSky(): ISky {
125
+ return {
126
+ background: equirect((e) => [...gradient(e).multiplyScalar(SKY_GLOW).toArray(), 1]),
127
+ environment: equirect((e) => {
128
+ const c = e < 0 ? GROUND_FILL : gradient(e).multiplyScalar(SKY_RADIANCE);
129
+ return [c.r, c.g, c.b, 1];
130
+ }),
131
+ hollow: equirect((e) => [
132
+ ...HOLLOW_FILL.clone()
133
+ .multiplyScalar(e < 0 ? 0.6 : 1)
134
+ .toArray(),
135
+ 1,
136
+ ]),
137
+ };
138
+ }
139
+
140
+ /** The Hollow's sky light: cool blue-grey, the colour of daylight leaking down a stone shaft. */
141
+ const HOLLOW_FILL = new Color(0.42, 0.5, 0.66);
142
+ /** The forest's and the Hollow's light, swapped by `setMist`. */
143
+ let fills: { readonly vale: DataTexture; readonly hollow: DataTexture } | undefined;
144
+
145
+ /** The height term's density at the ground; the fog node reads it every frame. */
146
+ const ground = { density: MIST.vale.density };
147
+
148
+ /**
149
+ * `T_distance x T_height` on `scene.fogNode`: three applies it wherever `scene.fog` would apply.
150
+ * The ray from the camera to a fragment integrates a density that halves every
151
+ * `1 / heightFalloff` metres up, in closed form, so the low path reads hazier than the canopy at the
152
+ * same distance. Toward the sun the mist takes the sun's colour.
153
+ */
154
+ function mistNode(distanceFog: FogExp2) {
155
+ const LN2 = Math.LN2;
156
+ const color = uniform(new Color());
157
+ color.onRenderUpdate(() => color.value.copy(distanceFog.color));
158
+ const density = uniform(0);
159
+ density.onRenderUpdate(() => {
160
+ density.value = distanceFog.density;
161
+ });
162
+ // Density at the camera, once per frame instead of once per fragment.
163
+ const cameraDensity = uniform(0);
164
+ cameraDensity.onRenderUpdate(({ camera }) => {
165
+ const y = camera?.matrixWorld.elements[13] ?? 0;
166
+ cameraDensity.value =
167
+ ground.density * 2 ** Math.max(-127, Math.min(127, -MIST.heightFalloff * y));
168
+ });
169
+ const ray = positionWorld.sub(cameraPosition);
170
+ const length = ray.length().max(1e-4);
171
+ const k = float(MIST.heightFalloff).mul(positionWorld.y.sub(cameraPosition.y)).div(length);
172
+ const integral = (a: number) => {
173
+ const b = max(length, a);
174
+ const curved = cameraDensity
175
+ .mul(exp2(k.mul(a).negate()).sub(exp2(k.mul(b).negate())))
176
+ .div(k.mul(LN2));
177
+ return select(k.mul(b).abs().lessThan(0.01), cameraDensity.mul(b.sub(a)), curved);
178
+ };
179
+ const heightT = exp2(integral(MIST.startDistance).negate());
180
+ const opacity = densityFogFactor(density).oneMinus().mul(heightT).oneMinus();
181
+ const lobe = pow(
182
+ saturate(dot(ray.div(length), vec3(SUN_DIRECTION.x, SUN_DIRECTION.y, SUN_DIRECTION.z))),
183
+ MIST.sunExponent,
184
+ );
185
+ const glow = float(1)
186
+ .sub(exp2(integral(MIST.sunStartDistance).negate()))
187
+ .mul(lobe);
188
+ const sun = new Color(SUN_COLOUR).multiplyScalar(1.4);
189
+ return fog(mix(color, vec3(sun.r, sun.g, sun.b), glow), opacity);
190
+ }
191
+
192
+ export function setupSky(scene: Scene, sky: ISky): void {
193
+ scene.background = sky.background;
194
+ scene.backgroundIntensity = 1;
195
+ // three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
196
+ scene.environment = sky.environment;
197
+ scene.environmentIntensity = 1;
198
+ fills = { hollow: sky.hollow, vale: sky.environment };
199
+ if (scene.fog instanceof FogExp2) return;
200
+ const distanceFog = new FogExp2(palette.horizon, MIST.vale.distance);
201
+ distanceFog.color.multiplyScalar(MIST.vale.glow);
202
+ scene.fog = distanceFog;
203
+ scene.fogNode = mistNode(distanceFog);
204
+ }
205
+
206
+ /**
207
+ * Thins the mist under the Hollow's roof, so a room's far wall and the Warden stay clear, and swaps
208
+ * the forest's green sky light for the Hollow's cool stone fill.
209
+ */
210
+ export function setMist(scene: Scene, indoors: boolean): void {
211
+ const mist = indoors ? MIST.hollow : MIST.vale;
212
+ ground.density = mist.density;
213
+ if (fills !== undefined) scene.environment = indoors ? fills.hollow : fills.vale;
214
+ if (!(scene.fog instanceof FogExp2)) return;
215
+ scene.fog.density = mist.distance;
216
+ scene.fog.color.set(indoors ? HOLLOW_MIST : palette.horizon).multiplyScalar(mist.glow);
217
+ }
218
+ /** The Hollow's thin haze: cool grey, never the forest's green. */
219
+ const HOLLOW_MIST = 0x8a96a4;
220
+
221
+ /**
222
+ * Sun shafts through the canopy: soft open tubes along the sun's direction, added on top of the
223
+ * frame. A tube fades to nothing where its side turns away from the eye, at both ends and close to
224
+ * the lens, and streaks along its length, so it reads as lit mist rather than a solid; it casts and
225
+ * takes no light. Each entry is the x, z where a shaft meets the ground and its radius in metres.
226
+ * Cost: one draw, a few hundred triangles, additive overdraw only where a shaft is on screen.
227
+ */
228
+ export function sunShafts(
229
+ feet: readonly (readonly [number, number, number])[],
230
+ height: (x: number, z: number) => number,
231
+ ): InstancedMesh {
232
+ const length = 18;
233
+ const material = new MeshBasicNodeMaterial({
234
+ blending: AdditiveBlending,
235
+ depthWrite: false,
236
+ fog: false,
237
+ transparent: true,
238
+ });
239
+ const facing = normalView.dot(positionViewDirection).abs();
240
+ const along = uv().y;
241
+ const strength = hash(instanceIndex).mul(hash(instanceIndex)).mul(0.8).add(0.2);
242
+ const streaks = sin(
243
+ uv()
244
+ .x.mul(Math.PI * 14)
245
+ .add(hash(instanceIndex.add(7)).mul(40)),
246
+ )
247
+ .mul(0.3)
248
+ .add(0.7);
249
+ material.colorNode = vec3(SUN_COLOUR.r, SUN_COLOUR.g, SUN_COLOUR.b).mul(SHAFT_BRIGHTNESS);
250
+ material.opacityNode = pow(facing, 2.5)
251
+ .mul(smoothstep(0, 0.12, along))
252
+ .mul(smoothstep(1, 0.45, along))
253
+ .mul(smoothstep(2, 7, positionWorld.distance(cameraPosition)))
254
+ .mul(streaks)
255
+ .mul(strength);
256
+ const geometry = new CylinderGeometry(1, 1, 1, 14, 1, true).translate(0, 0.5, 0);
257
+ const mesh = new InstancedMesh(geometry, material, feet.length);
258
+ mesh.name = "sun-shafts";
259
+ mesh.castShadow = false;
260
+ mesh.receiveShadow = false;
261
+ mesh.frustumCulled = false;
262
+ const place = new Object3D();
263
+ place.quaternion.setFromUnitVectors(new Vector3(0, 1, 0), SUN_DIRECTION);
264
+ feet.forEach(([x, z, radius], i) => {
265
+ place.position.set(x, height(x, z) - 0.5, z);
266
+ place.scale.set(radius, length, radius);
267
+ place.updateMatrix();
268
+ mesh.setMatrixAt(i, place.matrix);
269
+ });
270
+ return mesh;
271
+ }
@@ -0,0 +1,259 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The vale's and the Hollow's surfaces: five tiling photo textures shared with the other kits (see
4
+ // `assets/tex-PROVENANCE.md`), loaded once in `Play.load()`. A surface keeps the colour and the
5
+ // vertex shading the scene paints and takes only the photo's structure: each sample is divided by
6
+ // the photo's own average (its last mip level), so grass blades, rock cracks, bark grooves and
7
+ // coursed stone show in the vale's palette. No surface samples a tile plainly:
8
+ // - `stochastic` (Inigo Quilez's "texture repetition" technique) shifts the floor's grass by a
9
+ // random offset per noise patch and cross-fades two neighbouring offsets, so no two patches line
10
+ // up. The mip level comes from the base UV's own derivatives, so the seams never pick a blurred mip.
11
+ // - `triplanar` maps from the three world axes, so stones, trunks and walls need no UVs and a tile
12
+ // never stretches over a long face.
13
+ import {
14
+ Color,
15
+ type ColorRepresentation,
16
+ DoubleSide,
17
+ FrontSide,
18
+ type Material,
19
+ type Mesh,
20
+ type MeshStandardMaterial,
21
+ type Object3D,
22
+ RepeatWrapping,
23
+ type Texture,
24
+ } from "three";
25
+ import {
26
+ abs,
27
+ attribute,
28
+ color as colorNode,
29
+ cross,
30
+ dFdx,
31
+ dFdy,
32
+ dot,
33
+ float,
34
+ floor,
35
+ fract,
36
+ log2,
37
+ max,
38
+ min,
39
+ mix,
40
+ normalLocal,
41
+ normalWorldGeometry,
42
+ positionLocal,
43
+ positionWorld,
44
+ sin,
45
+ smoothstep,
46
+ texture,
47
+ uniform,
48
+ vec2,
49
+ vec3,
50
+ vec4,
51
+ } from "three/tsl";
52
+ import { MeshStandardNodeMaterial, type Node } from "three/webgpu";
53
+ import { detailTexture, lit } from "./materials.js";
54
+
55
+ /** Game-owned texture detail: an explicit mipBias overrides the temporal sampling convention. */
56
+ export const surfaceSampling: { mipBias: "auto" | number } = { mipBias: "auto" };
57
+ const surfaceMipBias = uniform(0);
58
+ const reportedMipBias = new Set<number>();
59
+
60
+ export function updateSurfaceSampling(scale: number): number {
61
+ if (!Number.isFinite(scale) || scale <= 0 || scale > 1)
62
+ throw new Error("Surface sampling scale must be finite and in (0, 1].");
63
+ const requested = surfaceSampling.mipBias;
64
+ if (requested !== "auto" && !Number.isFinite(requested))
65
+ throw new Error("Surface sampling mipBias must be auto or a finite number.");
66
+ // UE 5.8.3: SceneVisibility.cpp:5338–5352, defaults :180–193; preserve full-resolution sampling.
67
+ const bias = Math.max(
68
+ -4,
69
+ Math.min(
70
+ 4,
71
+ requested === "auto" ? (scale === 1 ? 0 : Math.max(-2, Math.log2(scale) - 0.3)) : requested,
72
+ ),
73
+ );
74
+ surfaceMipBias.value = bias;
75
+ if (requested !== "auto" && !reportedMipBias.has(requested)) {
76
+ console.info(
77
+ `TN_SURFACE_SAMPLING:${JSON.stringify({ mipBias: requested, appliedMipBias: bias })}`,
78
+ );
79
+ reportedMipBias.add(requested);
80
+ }
81
+ return bias;
82
+ }
83
+
84
+ type TextureLoader = {
85
+ texture(path: string, options?: { wrap?: number; anisotropy?: number }): Promise<Texture>;
86
+ };
87
+
88
+ // The files live once in the package's `template-assets/assets/`; the scaffolder copies each one
89
+ // named here, with `tex-PROVENANCE.md` (its licence record).
90
+ const FILES = {
91
+ bark: "tex-bark.webp",
92
+ grass: "tex-grass.webp",
93
+ planks: "tex-planks.webp",
94
+ rock: "tex-rock.webp",
95
+ "stone-wall": "tex-stone-wall.webp",
96
+ } as const;
97
+ export type Surface = keyof typeof FILES;
98
+ /** Metres per repeat of each tile. */
99
+ const TILE: Record<Surface, number> = {
100
+ bark: 1.2,
101
+ grass: 4,
102
+ planks: 1,
103
+ rock: 2.5,
104
+ "stone-wall": 3,
105
+ };
106
+
107
+ let maps: Record<Surface, Texture> | undefined;
108
+ const cache = new Map<string, Material>();
109
+ /** Every colour a surface was asked for: wood, stone and bark tones. */
110
+ const surfaceColors = new Set<number>();
111
+
112
+ /** Loads the five textures once, in sRGB, repeating and anisotropic. */
113
+ export async function loadSurfaces(assets: TextureLoader): Promise<void> {
114
+ const names = Object.keys(FILES) as Surface[];
115
+ const loaded = await Promise.all(
116
+ names.map((name) => assets.texture(FILES[name], { anisotropy: 8, wrap: RepeatWrapping })),
117
+ );
118
+ maps = Object.fromEntries(names.map((name, i) => [name, loaded[i]])) as Record<Surface, Texture>;
119
+ }
120
+
121
+ /**
122
+ * `map` at `at` (in tiles), shifted by a random offset per noise patch and cross-faded between two
123
+ * offsets. `size` is the texture's width in texels: the mip level is computed from it and the base
124
+ * UV's derivatives (the geometric mean of the two axes, at most two levels finer than the long one).
125
+ */
126
+ function stochastic(map: Texture, at: Node<"vec2">, size: number) {
127
+ const dx = dFdx(at);
128
+ const dy = dFdy(at);
129
+ const long = max(dot(dx, dx), dot(dy, dy));
130
+ const short = min(dot(dx, dx), dot(dy, dy));
131
+ const level = max(log2(long).mul(0.5).sub(2), log2(long).add(log2(short)).mul(0.25))
132
+ .add(Math.log2(size))
133
+ .add(surfaceMipBias)
134
+ .max(0);
135
+ // The grain map spans 0.62 to 1: stretched to eight offsets per unit, one noise texel a tile.
136
+ const index = texture(detailTexture(), at.mul(1 / 48))
137
+ .x.sub(0.62)
138
+ .mul(21);
139
+ const i = floor(index);
140
+ const f = fract(index);
141
+ const a = texture(map, at.add(sin(vec2(3, 7).mul(i)))).level(level);
142
+ const b = texture(map, at.add(sin(vec2(3, 7).mul(i.add(1))))).level(level);
143
+ // Fade on the texels' own difference, so the switch follows the texture's features, not a line.
144
+ const fade = smoothstep(0.2, 0.8, f.sub(dot(a.sub(b), vec4(0.1, 0.1, 0.1, 0))));
145
+ return mix(a, b, fade).xyz;
146
+ }
147
+
148
+ /**
149
+ * `map` projected from three axes (world, or the object's own when `local`), `tile` metres per
150
+ * repeat, blended by the normal. A
151
+ * flat-shaded surface takes its face's own normal from the position's derivatives: the owned engine
152
+ * gives a flat-shaded material no vertex normal, so `normalWorldGeometry` would stop the renderer.
153
+ */
154
+ function triplanar(map: Texture, tile: number, flat: boolean, local: boolean) {
155
+ const position = local ? positionLocal : positionWorld;
156
+ const p = position.div(tile);
157
+ const n = abs(
158
+ flat
159
+ ? cross(dFdx(position), dFdy(position)).normalize()
160
+ : local
161
+ ? normalLocal
162
+ : normalWorldGeometry,
163
+ );
164
+ const w = n.mul(n).mul(n).mul(n);
165
+ const sum = w.x.add(w.y).add(w.z);
166
+ return texture(map, p.zy)
167
+ .bias(surfaceMipBias)
168
+ .xyz.mul(w.x)
169
+ .add(texture(map, p.xz).bias(surfaceMipBias).xyz.mul(w.y))
170
+ .add(texture(map, p.xy).bias(surfaceMipBias).xyz.mul(w.z))
171
+ .div(sum);
172
+ }
173
+
174
+ /** A sample over the photo's own average colour: about 1, darker in its cracks, lighter on its ridges. */
175
+ function structure(map: Texture, sample: Node<"vec3">, strength: number | Node<"float">) {
176
+ const mean = max(texture(map, vec2(0.5, 0.5)).level(float(16)).xyz, vec3(0.02, 0.02, 0.02));
177
+ return mix(colorNode(1, 1, 1), sample.div(mean), strength);
178
+ }
179
+
180
+ /**
181
+ * A lit, rough surface in `color` (times the vertex colours when `vertexColors`) carrying the
182
+ * structure of photo `surface`. Before `loadSurfaces` resolves (the hero viewer, unit tests) it is
183
+ * `lit` with the code-baked grain.
184
+ */
185
+ export function surfaced(
186
+ color: ColorRepresentation,
187
+ surface: Surface,
188
+ options: {
189
+ roughness?: number;
190
+ vertexColors?: boolean;
191
+ flat?: boolean;
192
+ doubleSided?: boolean;
193
+ /** How much of the photo's light and dark shows, 0 to 1. */
194
+ strength?: number;
195
+ /** Object-space UVs, so a surface that moves carries its texture with it. */
196
+ local?: boolean;
197
+ } = {},
198
+ ): Material {
199
+ const { strength = 0.9, local = false, ...shape } = options;
200
+ surfaceColors.add(new Color(color).getHex());
201
+ if (maps === undefined) return lit(color, { ...shape, detail: true });
202
+ const key = `${String(color)}|${surface}|${JSON.stringify(options)}`;
203
+ const hit = cache.get(key);
204
+ if (hit !== undefined) return hit;
205
+ const map = maps[surface];
206
+ const material = new MeshStandardNodeMaterial({
207
+ flatShading: options.flat ?? false,
208
+ roughness: options.roughness ?? 0.85,
209
+ side: options.doubleSided === true ? DoubleSide : FrontSide,
210
+ vertexColors: options.vertexColors ?? false,
211
+ });
212
+ material.colorNode = structure(
213
+ map,
214
+ triplanar(map, TILE[surface], options.flat ?? false, local),
215
+ strength,
216
+ ).mul(colorNode(new Color(color)));
217
+ cache.set(key, material);
218
+ return material;
219
+ }
220
+
221
+ /**
222
+ * Meshes under `root` painted in a surface's colour with a plain material and no photo: a chest or
223
+ * a post built with `lit(C.wood)` where `surfaced(C.wood, "planks")` was meant. White is skipped,
224
+ * as a white material takes its colours from the vertices. 0 when every wood, stone and bark tone
225
+ * carries its photo; the whole set when the photos failed to load.
226
+ */
227
+ export function untexturedSurfaces(root: Object3D): number {
228
+ let count = 0;
229
+ root.traverse((object) => {
230
+ if (!(object as Mesh).isMesh) return;
231
+ const materials = [(object as Mesh).material].flat();
232
+ for (const material of materials) {
233
+ const plain = material as MeshStandardMaterial | null;
234
+ if (plain?.type !== "MeshStandardMaterial") continue;
235
+ const hex = plain.color.getHex();
236
+ if (hex !== 0xffffff && surfaceColors.has(hex)) count += 1;
237
+ }
238
+ });
239
+ return count;
240
+ }
241
+
242
+ /**
243
+ * The vale's floor: grass offset per patch on level ground, rock projected from three axes where
244
+ * the ground is steeper than Wren can climb, under the colours `valeGround` paints. Blades show in
245
+ * full only where that paint is green: on the dry, brown banks a grass photo reads as straw.
246
+ */
247
+ export function groundSurface(): Material {
248
+ if (maps === undefined) return lit(0xffffff, { detail: true, vertexColors: true });
249
+ const material = new MeshStandardNodeMaterial({ roughness: 0.9, vertexColors: true });
250
+ const paint = attribute<"vec3">("color", "vec3");
251
+ const grass = structure(
252
+ maps.grass,
253
+ stochastic(maps.grass, positionWorld.xz.div(TILE.grass), 512),
254
+ smoothstep(-0.02, 0.06, paint.y.sub(paint.x)).mul(0.6).add(0.3),
255
+ );
256
+ const rock = structure(maps.rock, triplanar(maps.rock, TILE.rock, false, false), 0.9);
257
+ material.colorNode = mix(grass, rock, smoothstep(0.8, 0.68, normalWorldGeometry.y));
258
+ return material;
259
+ }
@@ -0,0 +1,137 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // On-screen controls for a touch screen, cloned from Fox Dash: a thumbstick that anchors where
4
+ // the thumb lands, and five buttons in a fan on the right — slash, roll, shield, target, use.
5
+ // Drawn as flat overlay meshes on the camera, so they exist on every target the scene does.
6
+ import {
7
+ CircleGeometry,
8
+ Group,
9
+ MathUtils,
10
+ Mesh,
11
+ type MeshBasicMaterial,
12
+ type PerspectiveCamera,
13
+ RingGeometry,
14
+ Vector2,
15
+ } from "three";
16
+ import { flat } from "./materials.js";
17
+ import { C, palette } from "./palette.js";
18
+
19
+ export const TOUCH_BUTTONS = ["attack", "action", "block", "target", "interact"] as const;
20
+ export type TouchButton = (typeof TOUCH_BUTTONS)[number];
21
+
22
+ export interface ITouchPointer {
23
+ readonly position: Vector2;
24
+ }
25
+ export interface ITouchViewport {
26
+ readonly height: number;
27
+ readonly width: number;
28
+ }
29
+ export interface ITouchInput {
30
+ readonly move: Vector2;
31
+ readonly held: Readonly<Record<TouchButton, boolean>>;
32
+ readonly pressed: Readonly<Record<TouchButton, boolean>>;
33
+ }
34
+
35
+ const STICK_RADIUS = 72;
36
+ const BUTTON_RADIUS = 46;
37
+ const EDGE = 36;
38
+
39
+ /** Where each button sits: a quarter-circle fan around the bottom-right corner. */
40
+ function buttonPoint(size: ITouchViewport, index: number): Vector2 {
41
+ const cx = size.width - EDGE - BUTTON_RADIUS;
42
+ const cy = size.height - EDGE - BUTTON_RADIUS;
43
+ if (index === 0) return new Vector2(cx, cy);
44
+ const angle = Math.PI + ((index - 1) / 3) * (Math.PI / 2);
45
+ const reach = BUTTON_RADIUS * 3.1;
46
+ return new Vector2(cx + Math.cos(angle) * reach, cy + Math.sin(angle) * reach);
47
+ }
48
+
49
+ const none = (): Record<TouchButton, boolean> => ({
50
+ action: false,
51
+ attack: false,
52
+ block: false,
53
+ interact: false,
54
+ target: false,
55
+ });
56
+
57
+ export class TouchControls {
58
+ readonly root = new Group();
59
+ readonly object = this.root;
60
+ readonly #camera: PerspectiveCamera;
61
+ readonly #input = { held: none(), move: new Vector2(), pressed: none() };
62
+ readonly #idle: MeshBasicMaterial;
63
+ readonly #active: MeshBasicMaterial;
64
+ readonly #stick: Mesh;
65
+ readonly #knob: Mesh;
66
+ readonly #buttons: Mesh[] = [];
67
+ #anchor = new Vector2();
68
+ #anchored = false;
69
+
70
+ constructor(camera: PerspectiveCamera) {
71
+ this.#camera = camera;
72
+ this.#idle = flat(C.eye, 0.32, { depthTest: false });
73
+ this.#active = flat(palette.accent, 0.6, { depthTest: false });
74
+ this.#stick = new Mesh(new RingGeometry(STICK_RADIUS - 5, STICK_RADIUS, 32), this.#idle);
75
+ this.#knob = new Mesh(new CircleGeometry(28, 24), this.#active);
76
+ this.root.add(this.#stick, this.#knob);
77
+ for (const _ of TOUCH_BUTTONS) {
78
+ const button = new Mesh(new RingGeometry(BUTTON_RADIUS - 5, BUTTON_RADIUS, 28), this.#idle);
79
+ this.#buttons.push(button);
80
+ this.root.add(button);
81
+ }
82
+ this.root.renderOrder = 10_001;
83
+ camera.add(this.root);
84
+ }
85
+
86
+ update(pointers: ReadonlyMap<number, ITouchPointer>, size: ITouchViewport): ITouchInput {
87
+ const rest = new Vector2(STICK_RADIUS + EDGE, size.height - STICK_RADIUS - EDGE);
88
+ let thumb: ITouchPointer | undefined;
89
+ for (const pointer of pointers.values()) {
90
+ if (pointer.position.x < size.width * 0.45 && pointer.position.y > size.height * 0.4) {
91
+ thumb = pointer;
92
+ break;
93
+ }
94
+ }
95
+ const move = this.#input.move;
96
+ if (thumb === undefined) {
97
+ this.#anchored = false;
98
+ move.set(0, 0);
99
+ } else {
100
+ if (!this.#anchored) this.#anchor.copy(thumb.position);
101
+ this.#anchored = true;
102
+ move.set(
103
+ MathUtils.clamp((thumb.position.x - this.#anchor.x) / STICK_RADIUS, -1, 1),
104
+ MathUtils.clamp((this.#anchor.y - thumb.position.y) / STICK_RADIUS, -1, 1),
105
+ );
106
+ }
107
+ const centre = this.#anchored ? this.#anchor : rest;
108
+ for (const [index, name] of TOUCH_BUTTONS.entries()) {
109
+ const point = buttonPoint(size, index);
110
+ let down = false;
111
+ for (const pointer of pointers.values())
112
+ if (pointer.position.distanceToSquared(point) <= BUTTON_RADIUS ** 2) down = true;
113
+ this.#input.pressed[name] = down && !this.#input.held[name];
114
+ this.#input.held[name] = down;
115
+ const button = this.#buttons[index];
116
+ if (button === undefined) continue;
117
+ button.material = down ? this.#active : this.#idle;
118
+ button.position.set(point.x, point.y, 0);
119
+ }
120
+ this.#stick.position.set(centre.x, centre.y, 0);
121
+ this.#knob.position.set(centre.x + move.x * STICK_RADIUS, centre.y - move.y * STICK_RADIUS, 0);
122
+ const worldHeight = 2 * Math.tan(MathUtils.degToRad(this.#camera.fov / 2));
123
+ const pixels = worldHeight / Math.max(1, size.height);
124
+ this.root.position.set((-size.width * pixels) / 2, worldHeight / 2, -1);
125
+ this.root.scale.set(pixels, -pixels, 1);
126
+ return this.#input;
127
+ }
128
+
129
+ debug(): Record<string, unknown> {
130
+ return { held: { ...this.#input.held }, move: this.#input.move.toArray() };
131
+ }
132
+
133
+ dispose(): void {
134
+ this.root.removeFromParent();
135
+ for (const child of this.root.children) if (child instanceof Mesh) child.geometry.dispose();
136
+ }
137
+ }