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,269 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The island's surfaces: the eight tiling photo textures in `assets/` (see
4
+ // `tex-PROVENANCE.md`), loaded once through `ctx.assets`, and the samplers that hide their tiling. A tile
5
+ // repeated over a field reads as wallpaper, so no surface here samples a texture plainly:
6
+ // - `stochastic` (Inigo Quilez's "texture repetition" technique) shifts the texture by a random
7
+ // offset per patch of a low-frequency noise and cross-fades two neighbouring offsets, so no two
8
+ // patches of grass or sand line up. The mip level comes from the base UV's own derivatives, so
9
+ // the seams between offsets never pick a blurred mip.
10
+ // - `macro` multiplies a brightness and hue drift from two scales of world-space noise (9 m, 37 m),
11
+ // which breaks up the repeat of the structured textures (stone, tiles) that cannot be offset.
12
+ // - `triplanar` maps the rock from three axes on cliffs and slopes, where a top-down UV stretches.
13
+ import { type DataTexture, LinearFilter, RepeatWrapping, type Texture, Vector2 } from "three";
14
+ import {
15
+ abs,
16
+ attribute,
17
+ dFdx,
18
+ dFdy,
19
+ dot,
20
+ floor,
21
+ fract,
22
+ log2,
23
+ max,
24
+ min,
25
+ mix,
26
+ normalWorldGeometry,
27
+ positionWorld,
28
+ sin,
29
+ smoothstep,
30
+ texture,
31
+ uniform,
32
+ uv,
33
+ vec2,
34
+ vec3,
35
+ vec4,
36
+ } from "three/tsl";
37
+ import { MeshStandardNodeMaterial, type Node } from "three/webgpu";
38
+ import { valueNoise } from "./ground.js";
39
+ import { paintedTexture } from "./materials.js";
40
+
41
+ /** Game-owned texture detail: an explicit mipBias overrides the temporal sampling convention. */
42
+ export const surfaceSampling: { mipBias: "auto" | number } = { mipBias: "auto" };
43
+ const surfaceMipBias = uniform(0);
44
+ const reportedMipBias = new Set<number>();
45
+
46
+ export function updateSurfaceSampling(scale: number): number {
47
+ if (!Number.isFinite(scale) || scale <= 0 || scale > 1)
48
+ throw new Error("Surface sampling scale must be finite and in (0, 1].");
49
+ const requested = surfaceSampling.mipBias;
50
+ if (requested !== "auto" && !Number.isFinite(requested))
51
+ throw new Error("Surface sampling mipBias must be auto or a finite number.");
52
+ // UE 5.8.3: SceneVisibility.cpp:5338–5352, defaults :180–193; preserve full-resolution sampling.
53
+ const bias = Math.max(
54
+ -4,
55
+ Math.min(
56
+ 4,
57
+ requested === "auto" ? (scale === 1 ? 0 : Math.max(-2, Math.log2(scale) - 0.3)) : requested,
58
+ ),
59
+ );
60
+ surfaceMipBias.value = bias;
61
+ if (requested !== "auto" && !reportedMipBias.has(requested)) {
62
+ console.info(
63
+ `TN_SURFACE_SAMPLING:${JSON.stringify({ mipBias: requested, appliedMipBias: bias })}`,
64
+ );
65
+ reportedMipBias.add(requested);
66
+ }
67
+ return bias;
68
+ }
69
+
70
+ type TextureLoader = {
71
+ texture(
72
+ path: string,
73
+ options?: { data?: boolean; wrap?: number; anisotropy?: number },
74
+ ): Promise<Texture>;
75
+ };
76
+
77
+ // Shared with the other kits: the files live once in the package's `template-assets/assets/` and the
78
+ // scaffolder copies each one named here, with `tex-PROVENANCE.md` (its licence record).
79
+ const ALBEDO = [
80
+ "tex-grass.webp",
81
+ "tex-sand.webp",
82
+ "tex-rock.webp",
83
+ "tex-stone-wall.webp",
84
+ "tex-bark.webp",
85
+ "tex-birch-bark.webp",
86
+ "tex-planks.webp",
87
+ ];
88
+ const NORMAL = [
89
+ "tex-sand-normal.webp",
90
+ "tex-rock-normal.webp",
91
+ "tex-stone-wall-normal.webp",
92
+ "tex-bark-normal.webp",
93
+ "tex-planks-normal.webp",
94
+ ];
95
+ /** `tex-stone-wall-normal.webp` -> `stone-wall`: the surface name the materials look up. */
96
+ const surfaceName = (file: string) => file.replace(/^tex-|(?:-normal)?\.webp$/gu, "");
97
+
98
+ export interface ISurfaces {
99
+ readonly albedo: Readonly<Record<string, Texture>>;
100
+ readonly normal: Readonly<Record<string, Texture>>;
101
+ /** 64 x 64 tiling value noise, linear: the patches and the macro drift sample it. */
102
+ readonly noise: DataTexture;
103
+ }
104
+
105
+ /** Loads every texture once: albedo in sRGB, normal maps as data, all repeating and anisotropic. */
106
+ export async function loadSurfaces(assets: TextureLoader): Promise<ISurfaces> {
107
+ const load = (file: string, data: boolean) =>
108
+ assets.texture(file, { anisotropy: 8, data, wrap: RepeatWrapping });
109
+ const [albedo, normal] = await Promise.all([
110
+ Promise.all(ALBEDO.map((file) => load(file, false))),
111
+ Promise.all(NORMAL.map((file) => load(file, true))),
112
+ ]);
113
+ const field = valueNoise(64, 5);
114
+ const noise = paintedTexture(
115
+ 64,
116
+ 64,
117
+ (x, y) => {
118
+ const value = field(x / 64, y / 64);
119
+ return [value, value, value];
120
+ },
121
+ false,
122
+ );
123
+ noise.generateMipmaps = false;
124
+ noise.minFilter = LinearFilter;
125
+ return {
126
+ albedo: Object.fromEntries(ALBEDO.map((file, i) => [surfaceName(file), albedo[i] as Texture])),
127
+ normal: Object.fromEntries(NORMAL.map((file, i) => [surfaceName(file), normal[i] as Texture])),
128
+ noise,
129
+ };
130
+ }
131
+
132
+ /**
133
+ * `map` at `at` (in tiles), shifted by a random offset per noise patch and cross-faded between two
134
+ * offsets. `size` is the texture's width in texels: the mip level is computed from it and the base
135
+ * UV's derivatives (the geometric mean of the two axes, at most two levels finer than the long
136
+ * one: an anisotropic filter's sharpness without its taps).
137
+ */
138
+ export function stochastic(map: Texture, noise: Texture, at: Node<"vec2">, size: number) {
139
+ const dx = dFdx(at);
140
+ const dy = dFdy(at);
141
+ const long = max(dot(dx, dx), dot(dy, dy));
142
+ const short = min(dot(dx, dx), dot(dy, dy));
143
+ const level = max(log2(long).mul(0.5).sub(2), log2(long).add(log2(short)).mul(0.25))
144
+ .add(Math.log2(size))
145
+ .add(surfaceMipBias)
146
+ .max(0);
147
+ // One noise texel spans about a tile; eight offsets per unit of noise.
148
+ const index = texture(noise, at.mul(1 / 48)).x.mul(8);
149
+ const i = floor(index);
150
+ const f = fract(index);
151
+ const offsetA = sin(vec2(3, 7).mul(i));
152
+ const offsetB = sin(vec2(3, 7).mul(i.add(1)));
153
+ const a = texture(map, at.add(offsetA)).level(level);
154
+ const b = texture(map, at.add(offsetB)).level(level);
155
+ // Fade on the texels' own difference, so the switch follows the texture's features, not a line.
156
+ const fade = smoothstep(0.2, 0.8, f.sub(dot(a.sub(b), vec4(0.1, 0.1, 0.1, 0))));
157
+ return mix(a, b, fade).xyz;
158
+ }
159
+
160
+ /** World-space brightness drift, about 0.84 to 1.12, from noise at 37 m and 9 m. */
161
+ export function macro(noise: Texture, xz: Node<"vec2">) {
162
+ const broad = texture(noise, xz.mul(1 / (37 * 64))).x;
163
+ const fine = texture(noise, xz.mul(1 / (9 * 64)).add(0.37)).x;
164
+ return broad.mul(0.6).add(fine.mul(0.4)).mul(0.28).add(0.84);
165
+ }
166
+
167
+ /** `map` projected from the three world axes, `tile` metres per repeat, blended by the normal. */
168
+ export function triplanar(map: Texture, tile: number) {
169
+ const p = positionWorld.div(tile);
170
+ const n = abs(normalWorldGeometry);
171
+ const w = n.mul(n).mul(n).mul(n);
172
+ const sum = w.x.add(w.y).add(w.z);
173
+ return texture(map, p.zy)
174
+ .bias(surfaceMipBias)
175
+ .xyz.mul(w.x)
176
+ .add(texture(map, p.xz).bias(surfaceMipBias).xyz.mul(w.y))
177
+ .add(texture(map, p.xy).bias(surfaceMipBias).xyz.mul(w.z))
178
+ .div(sum);
179
+ }
180
+
181
+ /**
182
+ * The terrain: grass, sand and rock blended by the `layer` attribute `paintGround` writes (x sand,
183
+ * y rock, z worn grass by the path), each edge broken up by noise so a path never ends on a ruled
184
+ * line, then the macro drift. The vertex `tint` is the lawn's broad hue patches.
185
+ */
186
+ export function groundMaterial(s: ISurfaces): MeshStandardNodeMaterial {
187
+ const material = new MeshStandardNodeMaterial({ roughness: 0.94 });
188
+ const xz = positionWorld.xz;
189
+ const layer = attributeVec3("layer");
190
+ const tint = attributeVec3("tint");
191
+ // The photo tile is a dull olive: pushed toward the reference's vivid lawn green.
192
+ const grass = stochastic(s.albedo.grass as Texture, s.noise, xz.div(4), 512)
193
+ .mul(tint)
194
+ .mul(vec3(0.9, 1.08, 0.55));
195
+ // Warmed toward the reference's golden path sand; the photo tile is a pale grey-beige.
196
+ const sand = stochastic(s.albedo.sand as Texture, s.noise, xz.div(3), 512).mul(
197
+ vec3(1.05, 0.93, 0.72),
198
+ );
199
+ // Greyed: the photo tile is a warm brown that reads as straw on a sunlit cliff.
200
+ const rock = triplanar(s.albedo.rock as Texture, 2.5).mul(vec3(0.82, 0.86, 0.95));
201
+ const edge = texture(s.noise, xz.div(5 * 64)).x.sub(0.5);
202
+ const worn = mix(grass, grass.mul(vec3(0.95, 0.85, 0.7)), layer.z);
203
+ const sandy = smoothstep(0.3, 0.7, layer.x.add(edge.mul(0.7)));
204
+ const rocky = smoothstep(0.35, 0.65, layer.y.add(edge.mul(0.4)));
205
+ material.colorNode = mix(mix(worn, sand, sandy), rock, rocky).mul(macro(s.noise, xz));
206
+ material.normalMap = s.normal.sand as Texture;
207
+ material.normalScale = new Vector2(0.7, 0.7);
208
+ return material;
209
+ }
210
+
211
+ /** A drum's lawn: the terrain's grass, offset per patch, under the geometry's hue patches. */
212
+ export function lawnMaterial(s: ISurfaces): MeshStandardNodeMaterial {
213
+ // vertexColors multiplies the colorNode by the geometry's `color` patches.
214
+ const material = new MeshStandardNodeMaterial({ roughness: 0.94, vertexColors: true });
215
+ const xz = positionWorld.xz;
216
+ material.colorNode = stochastic(s.albedo.grass as Texture, s.noise, xz.div(4), 512).mul(
217
+ macro(s.noise, xz),
218
+ );
219
+ return material;
220
+ }
221
+
222
+ /**
223
+ * Coursed stone on the geometry's own UVs (`planarUv`, 3 m a tile), the macro drift, and grime: a
224
+ * darker, greener band in the metre and a half above `foot` (world y), where rain splashes and moss
225
+ * grows. Block colour already varies inside the texture.
226
+ */
227
+ export function masonryMaterial(s: ISurfaces, foot: number): MeshStandardNodeMaterial {
228
+ const material = new MeshStandardNodeMaterial({ roughness: 0.88 });
229
+ const grime = smoothstep(foot, foot + 1.6, positionWorld.y).oneMinus();
230
+ const stone = texture(s.albedo["stone-wall"] as Texture, uv()).bias(surfaceMipBias).xyz;
231
+ material.colorNode = mix(stone, stone.mul(vec3(0.62, 0.66, 0.52)), grime.mul(0.7)).mul(
232
+ macro(s.noise, positionWorld.xz.add(positionWorld.y)),
233
+ );
234
+ material.normalMap = s.normal["stone-wall"] as Texture;
235
+ material.normalScale = new Vector2(1.3, 1.3);
236
+ return material;
237
+ }
238
+
239
+ /** Natural rock (boulders): triplanar, so any shape takes it without UVs. */
240
+ export function rockMaterial(s: ISurfaces): MeshStandardNodeMaterial {
241
+ const material = new MeshStandardNodeMaterial({ roughness: 0.9 });
242
+ material.colorNode = triplanar(s.albedo.rock as Texture, 2.5).mul(
243
+ macro(s.noise, positionWorld.xz),
244
+ );
245
+ return material;
246
+ }
247
+
248
+ /** A plain textured surface on the geometry's UVs: roof tiles, planks, bark. */
249
+ export function texturedMaterial(
250
+ s: ISurfaces,
251
+ name: string,
252
+ options: { roughness?: number; normalScale?: number; doubleSided?: boolean } = {},
253
+ ): MeshStandardNodeMaterial {
254
+ const normal = s.normal[name];
255
+ const material = new MeshStandardNodeMaterial({
256
+ map: s.albedo[name] as Texture,
257
+ normalMap: normal ?? null,
258
+ normalScale: new Vector2(options.normalScale ?? 1, options.normalScale ?? 1),
259
+ roughness: options.roughness ?? 0.85,
260
+ side: options.doubleSided === true ? 2 : 0,
261
+ });
262
+ material.colorNode = texture(s.albedo[name] as Texture).bias(surfaceMipBias);
263
+ return material;
264
+ }
265
+
266
+ /** A named vec3 vertex attribute as a node. */
267
+ function attributeVec3(name: string): Node<"vec3"> {
268
+ return attribute<"vec3">(name, "vec3");
269
+ }
@@ -0,0 +1,179 @@
1
+ import {
2
+ CircleGeometry,
3
+ type ColorRepresentation,
4
+ Group,
5
+ MathUtils,
6
+ Mesh,
7
+ MeshBasicMaterial,
8
+ type PerspectiveCamera,
9
+ RingGeometry,
10
+ Vector2,
11
+ } from "three";
12
+ import { C, palette } from "./palette.js";
13
+ import {
14
+ BUTTON_RADIUS,
15
+ type ITouchInput,
16
+ type ITouchPointer,
17
+ type ITouchViewport,
18
+ MOVE_RADIUS,
19
+ type TouchButton,
20
+ touchControlPoint,
21
+ } from "./touch-layout.js";
22
+
23
+ export type { ITouchInput };
24
+
25
+ /** Flat overlay material: drawn over the scene, never occluded by it. */
26
+ function overlayMaterial(color: ColorRepresentation, opacity: number): MeshBasicMaterial {
27
+ return new MeshBasicMaterial({
28
+ color,
29
+ depthTest: false,
30
+ depthWrite: false,
31
+ opacity,
32
+ transparent: true,
33
+ });
34
+ }
35
+
36
+ /** The 5px-thick outline every control shares. */
37
+ function ringMesh(radius: number, material: MeshBasicMaterial): Mesh {
38
+ return new Mesh(new RingGeometry(radius - 5, radius, 32), material);
39
+ }
40
+
41
+ const BUTTONS: readonly TouchButton[] = ["jump", "attack", "crouch"];
42
+
43
+ /**
44
+ * A thumbstick anchored where the thumb lands, plus jump, attack and crouch buttons, drawn on a
45
+ * plane in front of the camera. Pixel space in, `ITouchInput` out; `Hero.ts` adds it to the keys.
46
+ */
47
+ export class TouchControls {
48
+ readonly root = new Group();
49
+ readonly object = this.root;
50
+ #camera: PerspectiveCamera;
51
+ #input = {
52
+ attackPressed: false,
53
+ crouchHeld: false,
54
+ crouchPressed: false,
55
+ jumpHeld: false,
56
+ jumpPressed: false,
57
+ move: new Vector2(),
58
+ };
59
+ readonly #held: Record<TouchButton, boolean> = { attack: false, crouch: false, jump: false };
60
+ readonly #centres: Record<TouchButton, Vector2> = {
61
+ attack: new Vector2(),
62
+ crouch: new Vector2(),
63
+ jump: new Vector2(),
64
+ };
65
+ readonly #rings: Record<TouchButton, Mesh>;
66
+ #moveAnchor = new Vector2();
67
+ #hasMoveAnchor = false;
68
+ #resting = new Vector2();
69
+ #lastWidth = -1;
70
+ #lastHeight = -1;
71
+ #moveBase: Mesh;
72
+ #moveKnob: Mesh;
73
+ #idleMaterial: MeshBasicMaterial;
74
+ #activeMaterial: MeshBasicMaterial;
75
+
76
+ constructor(camera: PerspectiveCamera) {
77
+ this.#camera = camera;
78
+ // Ink, not white: the island is bright grass and sky almost everywhere a thumb lands.
79
+ this.#idleMaterial = overlayMaterial(C.ink, 0.3);
80
+ this.#activeMaterial = overlayMaterial(palette.accent, 0.58);
81
+ this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
82
+ this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);
83
+ this.#rings = {
84
+ attack: ringMesh(BUTTON_RADIUS, this.#idleMaterial),
85
+ crouch: ringMesh(BUTTON_RADIUS, this.#idleMaterial),
86
+ jump: ringMesh(BUTTON_RADIUS, this.#idleMaterial),
87
+ };
88
+ this.root.add(this.#moveBase, this.#moveKnob, ...Object.values(this.#rings));
89
+ this.root.renderOrder = 10_001;
90
+ camera.add(this.root);
91
+ }
92
+
93
+ update(pointers: ReadonlyMap<number, ITouchPointer>, size: ITouchViewport): ITouchInput {
94
+ this.#ensureLayout(size);
95
+ let left: ITouchPointer | undefined;
96
+ for (const pointer of pointers.values()) {
97
+ if (pointer.position.x < size.width * 0.5 && pointer.position.y > size.height * 0.4) {
98
+ left = pointer;
99
+ break;
100
+ }
101
+ }
102
+ const move = this.#input.move;
103
+ if (left === undefined) {
104
+ this.#hasMoveAnchor = false;
105
+ move.set(0, 0);
106
+ } else {
107
+ if (!this.#hasMoveAnchor) {
108
+ this.#moveAnchor.copy(left.position);
109
+ this.#hasMoveAnchor = true;
110
+ }
111
+ move.set(
112
+ MathUtils.clamp((left.position.x - this.#moveAnchor.x) / MOVE_RADIUS, -1, 1),
113
+ // Screen y grows downward and the game's move.y is +up.
114
+ MathUtils.clamp((this.#moveAnchor.y - left.position.y) / MOVE_RADIUS, -1, 1),
115
+ );
116
+ }
117
+ const centre = this.#hasMoveAnchor ? this.#moveAnchor : this.#resting;
118
+ this.#moveKnob.position.set(
119
+ centre.x + move.x * MOVE_RADIUS,
120
+ centre.y - move.y * MOVE_RADIUS,
121
+ 0,
122
+ );
123
+ for (const name of BUTTONS) {
124
+ const down = this.#at(pointers, this.#centres[name]);
125
+ const pressed = down && !this.#held[name];
126
+ this.#held[name] = down;
127
+ this.#rings[name].material = down ? this.#activeMaterial : this.#idleMaterial;
128
+ if (name === "jump") {
129
+ this.#input.jumpPressed = pressed;
130
+ this.#input.jumpHeld = down;
131
+ } else if (name === "crouch") {
132
+ this.#input.crouchPressed = pressed;
133
+ this.#input.crouchHeld = down;
134
+ } else this.#input.attackPressed = pressed;
135
+ }
136
+ this.#layout(size);
137
+ return this.#input;
138
+ }
139
+
140
+ debug(): Record<string, unknown> {
141
+ return { ...this.#held, move: this.#input.move.toArray() };
142
+ }
143
+
144
+ dispose(): void {
145
+ this.root.removeFromParent();
146
+ for (const child of this.root.children) {
147
+ if (child instanceof Mesh) child.geometry.dispose();
148
+ }
149
+ this.#idleMaterial.dispose();
150
+ this.#activeMaterial.dispose();
151
+ }
152
+
153
+ #ensureLayout(size: ITouchViewport): void {
154
+ if (size.width === this.#lastWidth && size.height === this.#lastHeight) return;
155
+ this.#lastWidth = size.width;
156
+ this.#lastHeight = size.height;
157
+ this.#resting.copy(touchControlPoint(size, "move"));
158
+ for (const name of BUTTONS) this.#centres[name].copy(touchControlPoint(size, name));
159
+ }
160
+
161
+ #layout(size: ITouchViewport): void {
162
+ const worldHeight = 2 * Math.tan(MathUtils.degToRad(this.#camera.fov / 2));
163
+ const pixels = worldHeight / Math.max(1, size.height);
164
+ this.root.position.set((-size.width * pixels) / 2, worldHeight / 2, -1);
165
+ this.root.scale.set(pixels, -pixels, 1);
166
+ const move = this.#hasMoveAnchor ? this.#moveAnchor : this.#resting;
167
+ this.#moveBase.position.set(move.x, move.y, 0);
168
+ for (const name of BUTTONS)
169
+ this.#rings[name].position.set(this.#centres[name].x, this.#centres[name].y, 0);
170
+ }
171
+
172
+ #at(pointers: ReadonlyMap<number, ITouchPointer>, centre: Vector2): boolean {
173
+ const radiusSquared = BUTTON_RADIUS * BUTTON_RADIUS;
174
+ for (const pointer of pointers.values()) {
175
+ if (pointer.position.distanceToSquared(centre) <= radiusSquared) return true;
176
+ }
177
+ return false;
178
+ }
179
+ }
@@ -0,0 +1,48 @@
1
+ import { Vector2 } from "three";
2
+
3
+ /**
4
+ * Where the on-screen controls sit. Pure geometry: no Three.js objects, no scene, so a test can
5
+ * check the maths without a renderer.
6
+ */
7
+
8
+ export const MOVE_RADIUS = 72;
9
+ export const BUTTON_RADIUS = 58;
10
+ const EDGE = 36;
11
+
12
+ export interface ITouchPointer {
13
+ readonly position: Vector2;
14
+ }
15
+
16
+ export interface ITouchViewport {
17
+ readonly height: number;
18
+ readonly width: number;
19
+ }
20
+
21
+ export type TouchButton = "attack" | "crouch" | "jump";
22
+ type TouchControlName = TouchButton | "move";
23
+
24
+ /** Jump nearest the thumb's rest, attack beside it, crouch above them: one thumb rolls across all three. */
25
+ const BUTTON_SLOTS: Record<TouchButton, readonly [number, number]> = {
26
+ attack: [1, 0],
27
+ crouch: [0.5, 1],
28
+ jump: [0, 0],
29
+ };
30
+
31
+ export function touchControlPoint(size: ITouchViewport, name: TouchControlName): Vector2 {
32
+ if (name === "move") return new Vector2(MOVE_RADIUS + EDGE, size.height - MOVE_RADIUS - EDGE);
33
+ const [column, row] = BUTTON_SLOTS[name];
34
+ const step = BUTTON_RADIUS * 2 + 16;
35
+ return new Vector2(
36
+ size.width - BUTTON_RADIUS - EDGE - column * step,
37
+ size.height - BUTTON_RADIUS - EDGE - row * step,
38
+ );
39
+ }
40
+
41
+ export interface ITouchInput {
42
+ readonly attackPressed: boolean;
43
+ readonly crouchHeld: boolean;
44
+ readonly crouchPressed: boolean;
45
+ readonly jumpHeld: boolean;
46
+ readonly jumpPressed: boolean;
47
+ readonly move: Vector2;
48
+ }
@@ -0,0 +1,191 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The sea: a lit standard material, so the sun's glints and the sky's reflection come from the
4
+ // scene's own lights. Its colour runs from turquoise over the sand to deep blue off the shelf, read
5
+ // from a baked depth map of the island; a white wash breathes along every shore with the swell. The
6
+ // swell is core's `WaveField` (built in `level/Course.ts` and handed in), evaluated per pixel so its
7
+ // normals never repeat; two scrolling octaves of ripple normals on top break the sun's highlight
8
+ // into glitter. The ripples fade on the pixel footprint and the slope they lose becomes roughness,
9
+ // or the far sea turns into a shimmering mirror.
10
+ import {
11
+ ClampToEdgeWrapping,
12
+ DataTexture,
13
+ LinearFilter,
14
+ LinearMipmapLinearFilter,
15
+ RepeatWrapping,
16
+ type Texture,
17
+ } from "three";
18
+ import {
19
+ cameraViewMatrix,
20
+ color,
21
+ dFdx,
22
+ dFdy,
23
+ float,
24
+ length,
25
+ max,
26
+ mix,
27
+ normalize,
28
+ positionWorld,
29
+ sin,
30
+ smoothstep,
31
+ texture,
32
+ time,
33
+ vec2,
34
+ vec3,
35
+ vec4,
36
+ } from "three/tsl";
37
+ import { MeshStandardNodeMaterial, type Node } from "three/webgpu";
38
+ import { paintedTexture } from "./materials.js";
39
+ import { C } from "./palette.js";
40
+
41
+ /** Depth past which the sea is its deep colour, and the depth the map stores at full scale. */
42
+ const DEEP = 6;
43
+ const MAX_DEPTH = 12;
44
+
45
+ /** A square of the world, in metres, that the depth map covers. Past it the sea is deep. */
46
+ export interface ISeaFloor {
47
+ readonly minX: number;
48
+ readonly minZ: number;
49
+ readonly size: number;
50
+ /** Height of the floor (land or sea bed) at a point. */
51
+ height(x: number, z: number): number;
52
+ readonly seaLevel: number;
53
+ }
54
+
55
+ /** The swell's graphs, as core's `WaveField` gives them; `point` is world XZ. */
56
+ export interface ISwell {
57
+ heightNode(options: { point: Node<"vec2">; time: Node<"float"> }): Node<"float">;
58
+ normalNode(options: {
59
+ point: Node<"vec2">;
60
+ fade: Node<"float">;
61
+ time: Node<"float">;
62
+ }): Node<"vec3">;
63
+ }
64
+
65
+ /** The water depth over `floor`, 256² texels, red = depth / MAX_DEPTH; land reads zero. */
66
+ function depthMap(floor: ISeaFloor): DataTexture {
67
+ const n = 256;
68
+ const map = paintedTexture(
69
+ n,
70
+ n,
71
+ (i, j) => {
72
+ const x = floor.minX + ((i + 0.5) / n) * floor.size;
73
+ const z = floor.minZ + ((j + 0.5) / n) * floor.size;
74
+ const depth = Math.max(0, floor.seaLevel - floor.height(x, z));
75
+ return [Math.min(1, depth / MAX_DEPTH), 0, 0];
76
+ },
77
+ false,
78
+ );
79
+ // Clamped, not tiled: past the map the border's open water carries on, not a copy of the island.
80
+ map.wrapS = ClampToEdgeWrapping;
81
+ map.wrapT = ClampToEdgeWrapping;
82
+ map.magFilter = LinearFilter;
83
+ map.minFilter = LinearFilter;
84
+ return map;
85
+ }
86
+
87
+ /** Tiling ripples: periodic value noise, its slope in red/green and its height in alpha. */
88
+ function rippleMap(): DataTexture {
89
+ const n = 256;
90
+ const hash = (x: number, z: number): number => {
91
+ const a = Math.sin(x * 127.1 + z * 311.7) * 43758.5453;
92
+ return a - Math.floor(a);
93
+ };
94
+ const noise = (u: number, v: number, k: number): number => {
95
+ const x = u * k;
96
+ const z = v * k;
97
+ const i = Math.floor(x);
98
+ const j = Math.floor(z);
99
+ let a = x - i;
100
+ let b = z - j;
101
+ a = a * a * a * (a * (a * 6 - 15) + 10);
102
+ b = b * b * b * (b * (b * 6 - 15) + 10);
103
+ const h = (hx: number, hz: number): number => hash(((hx % k) + k) % k, ((hz % k) + k) % k);
104
+ return (
105
+ (h(i, j) * (1 - a) + h(i + 1, j) * a) * (1 - b) +
106
+ (h(i, j + 1) * (1 - a) + h(i + 1, j + 1) * a) * b
107
+ );
108
+ };
109
+ const height = (u: number, v: number): number =>
110
+ noise(u, v, 8) * 0.58 +
111
+ noise(u, v, 16) * 0.28 +
112
+ noise(u, v, 32) * 0.11 +
113
+ noise(u, v, 64) * 0.03;
114
+ const e = 1 / n;
115
+ const data = new Uint8Array(n * n * 4);
116
+ for (let j = 0; j < n; j += 1) {
117
+ for (let i = 0; i < n; i += 1) {
118
+ const u = i / n;
119
+ const v = j / n;
120
+ const nx = (height(u + e, v) - height(u - e, v)) * 6;
121
+ const nz = (height(u, v + e) - height(u, v - e)) * 6;
122
+ const at = (j * n + i) * 4;
123
+ data[at] = Math.max(0, Math.min(255, (nx * 0.5 + 0.5) * 255));
124
+ data[at + 1] = Math.max(0, Math.min(255, (nz * 0.5 + 0.5) * 255));
125
+ data[at + 2] = 255;
126
+ data[at + 3] = height(u, v) * 255;
127
+ }
128
+ }
129
+ const map = new DataTexture(data, n, n);
130
+ map.wrapS = RepeatWrapping;
131
+ map.wrapT = RepeatWrapping;
132
+ map.magFilter = LinearFilter;
133
+ map.minFilter = LinearMipmapLinearFilter;
134
+ map.generateMipmaps = true;
135
+ map.needsUpdate = true;
136
+ return map;
137
+ }
138
+
139
+ export function seaMaterial(floor: ISeaFloor, swell: ISwell): MeshStandardNodeMaterial {
140
+ const depthTexture: Texture = depthMap(floor);
141
+ const ripples = rippleMap();
142
+ const at = vec2(positionWorld.x, positionWorld.z);
143
+ const depthUv = at.sub(vec2(floor.minX, floor.minZ)).div(floor.size);
144
+ // Outside the map the sea is deep: the map's border texels are all open water.
145
+ const depth = texture(depthTexture, depthUv).r.mul(MAX_DEPTH);
146
+ // The two octaves are turned 37° apart, so their rows never line up into streaks.
147
+ const turned = vec2(at.x.mul(0.8).sub(at.y.mul(0.6)), at.x.mul(0.6).add(at.y.mul(0.8)));
148
+ const micro = texture(ripples, at.mul(0.05).add(time.mul(vec2(0.012, 0.007))));
149
+ const fine = texture(ripples, turned.mul(0.15).add(time.mul(vec2(-0.025, 0.018))));
150
+
151
+ // Ripples fade where one pixel covers more ground than a ripple is wide.
152
+ const footprint = max(length(dFdx(positionWorld)), length(dFdy(positionWorld)));
153
+ const fade = float(1).sub(smoothstep(0.04, 0.5, footprint));
154
+ const slope = micro.rg.mul(2).sub(1).add(fine.rg.mul(2).sub(1).mul(0.45)).mul(0.22).mul(fade);
155
+ // The ripples ride on the swell: add their slope to the swell's.
156
+ const big = swell.normalNode({ fade, point: at, time });
157
+ const normalWorld = normalize(
158
+ vec3(big.x.div(big.y).sub(slope.x), 1, big.z.div(big.y).sub(slope.y)),
159
+ );
160
+
161
+ // A wash that runs up and back along the shore with the swell, broken by the ripples so it is
162
+ // never a clean line.
163
+ const swash = sin(time.mul(1.3).sub(depth.mul(5)))
164
+ .mul(0.18)
165
+ .add(swell.heightNode({ point: at, time }).mul(0.8));
166
+ const band = smoothstep(0.9, 0.15, depth.add(swash));
167
+ const froth = smoothstep(0.45, 0.62, micro.a.mul(0.6).add(fine.a.mul(0.4)).add(band.mul(0.35)));
168
+ const foam = band
169
+ .mul(froth)
170
+ .add(smoothstep(0.25, 0.05, depth).mul(0.6))
171
+ .clamp(0, 1);
172
+
173
+ const shallow = color(0x45d6c4);
174
+ const shelf = color(0x2aa3c9);
175
+ const deep = color(0x1a5aa8);
176
+ const body = mix(
177
+ mix(shallow, shelf, smoothstep(0.2, 2.2, depth)),
178
+ deep,
179
+ smoothstep(2, DEEP, depth),
180
+ );
181
+
182
+ // Transparent: the sand shows through the shallows and fades out over the shelf. It also keeps
183
+ // the sea out of the post chain's normal pass, which cannot take a material's normalNode yet.
184
+ const material = new MeshStandardNodeMaterial({ metalness: 0, transparent: true });
185
+ material.colorNode = mix(body, color(C.foam), foam);
186
+ material.opacityNode = max(smoothstep(0, 3, depth).mul(0.45).add(0.55), foam);
187
+ material.normalNode = normalize(cameraViewMatrix.mul(vec4(normalWorld, 0)).xyz);
188
+ // Glossy water, rougher where the ripples have faded out and where the foam is.
189
+ material.roughnessNode = float(0.05).add(float(1).sub(fade).mul(0.16)).add(foam.mul(0.7));
190
+ return material;
191
+ }