create-threenative 0.2.10 → 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 +227 -34
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +15 -10
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +14 -9
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +15 -10
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +15 -10
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +15 -10
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +72 -1
  420. package/templates/racing/src/scenes/Race.ts +9 -7
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +14 -9
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +14 -9
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +15 -10
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +15 -10
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +15 -10
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +15 -10
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +15 -10
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +14 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +27 -14
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +15 -10
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -17,22 +17,41 @@ import {
17
17
  InstancedMesh,
18
18
  MeshBasicMaterial,
19
19
  Object3D,
20
+ type OrthographicCamera,
20
21
  PlaneGeometry,
21
22
  RingGeometry,
23
+ Vector3,
22
24
  } from "three";
23
25
  import type { Game } from "../sim/game.js";
24
26
  import { HALF, STARTS, terrainHeight } from "../sim/terrain.js";
25
27
  import { type IEntity, TYPES } from "../sim/types.js";
26
28
  import type { IUnitModels } from "./models.js";
27
- import { palette } from "./palette.js";
29
+ import { legacyColor, palette } from "./palette.js";
28
30
 
29
31
  /** Copies one (type, team) can be on screen at once. The supply cap is 120 for the whole map. */
30
32
  const CAPACITY = 128;
31
33
  /** Order markers alive at once, oldest released first. */
32
34
  const MARKERS = 24;
33
- /** Bar thickness, in metres. Enough to read at the closest zoom, thin enough not to crowd. */
34
- const BAR = 0.34;
35
+ /**
36
+ * Bar sizes in screen pixels, not metres, as AstraCraft draws them: a 3 px fill inside a 1 px dark
37
+ * frame, 30 px over a unit and 60 px over a building, and a 2 px build or queue line 6 px below.
38
+ * A readout keeps one size on screen at every zoom, as in every strategy game.
39
+ */
40
+ const BAR_HEIGHT = 3;
41
+ const BAR_BORDER = 1;
42
+ const BAR_WIDTH = { building: 60, unit: 30 } as const;
43
+ const WORK_HEIGHT = 2;
44
+ const WORK_DROP = 6;
35
45
  const MARKER_LIFE = 0.8;
46
+ /**
47
+ * Where an entity was before the latest rules step: `id, x, z, angle, altitude` per slot, slot =
48
+ * `id % POSE_SLOTS`. The rules move units 20 times a second and the screen shows 60, so a unit
49
+ * drawn where the rules left it moves on one frame in three; drawn between its last two poses, it
50
+ * moves on every frame. ponytail: a slot shared by two live ids (ids 4096 apart) draws the newer
51
+ * one unblended for that step; key by entity if a match ever holds that many at once.
52
+ */
53
+ const POSE_SLOTS = 4096;
54
+ const POSE = 5;
36
55
 
37
56
  interface IBatch {
38
57
  readonly list: IEntity[];
@@ -49,12 +68,21 @@ export interface IArmy {
49
68
  /** An expanding ring where an order landed, so a click has a visible consequence. */
50
69
  readonly marker: (x: number, z: number, hostile: boolean) => void;
51
70
  readonly root: Object3D;
71
+ /** Record every entity's pose. Call it just before each rules step. */
72
+ readonly step: (game: Game) => void;
73
+ /** Once per drawn frame: write every transform this frame shows. */
52
74
  readonly sync: (
53
75
  game: Game,
54
76
  selected: ReadonlySet<number>,
55
77
  time: number,
56
78
  dt: number,
57
79
  camera: Camera,
80
+ /** Screen pixels per metre at depth 1, measured by the scene: a render file imports no package. */
81
+ pixelsPerMetre: number,
82
+ /** How far the frame is into the latest rules step, 0 (the pose before it) to 1 (its result). */
83
+ blend: number,
84
+ /** Where the camera draws this frame from, so a bar's edges land on whole pixels. */
85
+ eye: Vector3,
58
86
  ) => void;
59
87
  readonly dispose: () => void;
60
88
  }
@@ -63,10 +91,14 @@ const _dummy = new Object3D();
63
91
  const _tint = new Color();
64
92
  const _friendly = new Color(0x9be6bb);
65
93
  const _hurt = new Color(0xddad71);
66
- const _hostile = new Color(0xff8756);
94
+ /** A rival's bar is its faction colour, as in AstraCraft. */
95
+ const _teamFill = STARTS.map((start) => new Color(start.css));
67
96
  const _work = new Color(0x77eddf);
68
97
  const _queue = new Color(0x77cddd);
69
- const _backing = new Color(palette.gridLine);
98
+ const _backing = new Color(0x08151e);
99
+ const _right = new Vector3();
100
+ const _at = { altitude: 0, angle: 0, x: 0, z: 0 };
101
+ const _offset = new Vector3();
70
102
 
71
103
  export function createArmy(
72
104
  models: IUnitModels,
@@ -78,15 +110,16 @@ export function createArmy(
78
110
  for (let index = 0; index < MARKERS; index += 1) markers.push({ life: 0, x: 0, z: 0 });
79
111
 
80
112
  // One ring per faction, because the ring's colour *is* the faction: a single mesh would need a
81
- // per-instance colour, and three draws are cheaper than the bookkeeping.
113
+ // per-instance colour, and three draws are cheaper than the bookkeeping. AstraCraft's thin ring:
114
+ // its legacy-linear faction colour at 0.75 opacity, no dark underlay (PRD-765 judge round 2).
82
115
  const rings = STARTS.map(
83
116
  (start) =>
84
117
  new InstancedMesh(
85
- new RingGeometry(1, 1.075, 40).rotateX(-Math.PI / 2),
118
+ new RingGeometry(1, 1.095, 40).rotateX(-Math.PI / 2),
86
119
  new MeshBasicMaterial({
87
- color: start.color,
120
+ color: legacyColor(start.color),
88
121
  depthWrite: false,
89
- opacity: 0.85,
122
+ opacity: 0.75,
90
123
  transparent: true,
91
124
  }),
92
125
  CAPACITY,
@@ -102,6 +135,18 @@ export function createArmy(
102
135
  // array for every ring, every frame.
103
136
  const ringTeams = STARTS.map((start, index) => start.team ?? index);
104
137
 
138
+ // A dark border keeps the order marker readable on bright ground.
139
+ const backingMaterial = new MeshBasicMaterial({ color: palette.unseen, depthWrite: false });
140
+ const markerBackings = new InstancedMesh(
141
+ new RingGeometry(0.47, 0.69, 24).rotateX(-Math.PI / 2),
142
+ backingMaterial,
143
+ MARKERS,
144
+ );
145
+ markerBackings.instanceMatrix.setUsage(DynamicDrawUsage);
146
+ markerBackings.frustumCulled = false;
147
+ markerBackings.renderOrder = 1;
148
+ root.add(markerBackings);
149
+
105
150
  // Two quads per readout — a coloured fill over the dark backdrop ring that frames it — so a bar
106
151
  // reads against any ground. `toneMapped: false` keeps them at the colour they were authored.
107
152
  const bars = new InstancedMesh(
@@ -112,6 +157,9 @@ export function createArmy(
112
157
  bars.instanceMatrix.setUsage(DynamicDrawUsage);
113
158
  bars.frustumCulled = false;
114
159
  bars.renderOrder = 3;
160
+ // The colour attribute exists before the first draw: three.js compiles the material once, and a
161
+ // batch first drawn without `instanceColor` stays white on that engine (PRD-765 A/B).
162
+ bars.setColorAt(0, _backing);
115
163
  root.add(bars);
116
164
 
117
165
  const markerRings = new InstancedMesh(
@@ -127,6 +175,7 @@ export function createArmy(
127
175
  markerRings.instanceMatrix.setUsage(DynamicDrawUsage);
128
176
  markerRings.frustumCulled = false;
129
177
  markerRings.renderOrder = 2;
178
+ markerRings.setColorAt(0, _backing);
130
179
  root.add(markerRings);
131
180
 
132
181
  const batch = (type: string, team: number): IBatch => {
@@ -149,31 +198,89 @@ export function createArmy(
149
198
  };
150
199
 
151
200
  let barCount = 0;
201
+ /** Screen pixels per metre this frame (orthographic: the same at every depth). */
202
+ let pixels = 1;
203
+ /** Half the viewport in pixels, and the camera's up axis in world space this frame. */
204
+ let halfWidth = 0;
205
+ let halfHeight = 0;
206
+ const up = new Vector3();
207
+ /** The camera position this frame draws from, and how far it is into the latest rules step. */
208
+ let eye: Vector3 = up;
209
+ let blend = 1;
210
+ const poses = new Float64Array(POSE_SLOTS * POSE).fill(-1);
152
211
 
153
- /**
154
- * One readout: a fill over its own backdrop, both camera-facing quads, the fill growing from
155
- * the left so a half-full bar reads as "half" rather than as "small".
156
- */
157
- const pushBar = (entity: IEntity, width: number, fraction: number, y: number, colour: Color) => {
158
- const height = terrainHeight(entity.x, entity.z) + y;
212
+ /** The pose this frame draws `entity` at, between its last two rules steps, written into `_at`. */
213
+ const pose = (entity: IEntity): typeof _at => {
214
+ const slot = (entity.id % POSE_SLOTS) * POSE;
215
+ const altitude = entity.altitude || 0;
216
+ if (poses[slot] !== entity.id) {
217
+ _at.x = entity.x;
218
+ _at.z = entity.z;
219
+ _at.angle = entity.angle;
220
+ _at.altitude = altitude;
221
+ return _at;
222
+ }
223
+ const x = poses[slot + 1] as number;
224
+ const z = poses[slot + 2] as number;
225
+ const angle = poses[slot + 3] as number;
226
+ const height = poses[slot + 4] as number;
227
+ // The short way round, so a unit turning through ±π does not spin the long way.
228
+ let turn = entity.angle - angle;
229
+ turn -= Math.round(turn / (2 * Math.PI)) * 2 * Math.PI;
230
+ _at.x = x + (entity.x - x) * blend;
231
+ _at.z = z + (entity.z - z) * blend;
232
+ _at.angle = angle + turn * blend;
233
+ _at.altitude = height + (altitude - height) * blend;
234
+ return _at;
235
+ };
236
+
237
+ /** The bar's anchor in world space and on screen, in pixels from the top-left. */
238
+ const _base = new Vector3();
239
+ let anchorX = 0;
240
+ let anchorY = 0;
241
+ /** One camera-facing quad covering the screen rectangle `x, y, w, h`, in whole pixels. */
242
+ const quad = (x: number, y: number, w: number, h: number, colour: Color) => {
243
+ _dummy.position
244
+ .copy(_base)
245
+ .addScaledVector(_right, (x + w / 2 - anchorX) / pixels)
246
+ .addScaledVector(up, (anchorY - y - h / 2) / pixels);
159
247
  _dummy.quaternion.copy(camera.quaternion);
160
- _dummy.position.set(entity.x, height, entity.z);
161
- _dummy.scale.set(width, BAR, 1);
162
- _dummy.updateMatrix();
163
- bars.setMatrixAt(barCount, _dummy.matrix);
164
- bars.setColorAt(barCount, _backing);
165
- barCount += 1;
166
- const fill = width * Math.max(0, Math.min(1, fraction));
167
- if (fill <= 0) return;
168
- _dummy.scale.set(fill, BAR * 0.7, 1);
169
- _dummy.updateMatrix();
170
- _dummy.translateX((fill - width) / 2);
248
+ _dummy.scale.set(w / pixels, h / pixels, 1);
171
249
  _dummy.updateMatrix();
172
250
  bars.setMatrixAt(barCount, _dummy.matrix);
173
251
  bars.setColorAt(barCount, colour);
174
252
  barCount += 1;
175
253
  };
176
254
 
255
+ /**
256
+ * One readout, AstraCraft's: a fill growing from the left inside a 1 px dark frame, hung from a
257
+ * point above the model, and an unframed build or queue line under it. Every edge sits on a whole
258
+ * pixel: a frame on a fractional position is shared by two pixel rows that trade coverage as the
259
+ * unit moves, which reads as a border that shimmers.
260
+ */
261
+ const pushBar = (entity: IEntity, fraction: number, colour: Color, work: number, tone: Color) => {
262
+ const at = pose(entity);
263
+ const lift = entity.building ? TYPES[entity.type].r + 1.3 : entity.air ? 2.1 : 3.1;
264
+ _base.set(at.x, terrainHeight(at.x, at.z) + at.altitude + lift, at.z);
265
+ _offset.copy(_base).sub(eye);
266
+ anchorX = halfWidth + _offset.dot(_right) * pixels;
267
+ anchorY = halfHeight - _offset.dot(up) * pixels;
268
+ const width = entity.building ? BAR_WIDTH.building : BAR_WIDTH.unit;
269
+ const left = Math.round(anchorX - width / 2);
270
+ const top = Math.round(anchorY);
271
+ quad(
272
+ left - BAR_BORDER,
273
+ top - BAR_BORDER,
274
+ width + 2 * BAR_BORDER,
275
+ BAR_HEIGHT + 2 * BAR_BORDER,
276
+ _backing,
277
+ );
278
+ const fill = Math.round(width * Math.max(0, Math.min(1, fraction)));
279
+ if (fill > 0) quad(left, top, fill, BAR_HEIGHT, colour);
280
+ const done = Math.round(width * Math.max(0, Math.min(1, work)));
281
+ if (done > 0) quad(left, top + WORK_DROP, done, WORK_HEIGHT, tone);
282
+ };
283
+
177
284
  let camera: Camera;
178
285
 
179
286
  return {
@@ -187,8 +294,26 @@ export function createArmy(
187
294
  slot.z = z;
188
295
  markerRings.setColorAt(index, _tint.set(hostile ? 0xff775a : 0x6cfbe2));
189
296
  },
190
- sync: (game, selected, time, dt, view) => {
297
+ step: (game) => {
298
+ for (const entity of game.entities) {
299
+ const slot = (entity.id % POSE_SLOTS) * POSE;
300
+ poses[slot] = entity.id;
301
+ poses[slot + 1] = entity.x;
302
+ poses[slot + 2] = entity.z;
303
+ poses[slot + 3] = entity.angle;
304
+ poses[slot + 4] = entity.altitude || 0;
305
+ }
306
+ },
307
+ sync: (game, selected, time, dt, view, pixelsPerMetre, share, from) => {
191
308
  camera = view;
309
+ pixels = pixelsPerMetre;
310
+ blend = Math.max(0, Math.min(1, share));
311
+ eye = from;
312
+ up.set(0, 1, 0).applyQuaternion(view.quaternion);
313
+ _right.set(1, 0, 0).applyQuaternion(view.quaternion);
314
+ const frame = view as OrthographicCamera;
315
+ halfWidth = (((frame.right - frame.left) / frame.zoom) * pixels) / 2;
316
+ halfHeight = (((frame.top - frame.bottom) / frame.zoom) * pixels) / 2;
192
317
  for (const entry of batches.values()) entry.list.length = 0;
193
318
  for (const entity of game.entities) {
194
319
  if (entity.garrisonId !== null) continue;
@@ -201,14 +326,15 @@ export function createArmy(
201
326
  for (let index = 0; index < list.length; index++) {
202
327
  const entity = list[index];
203
328
  if (entity === undefined) continue;
329
+ const at = pose(entity);
204
330
  _dummy.position.set(
205
- entity.x,
206
- terrainHeight(entity.x, entity.z) + (entity.altitude || 0) + bob(entity, time),
207
- entity.z,
331
+ at.x,
332
+ terrainHeight(at.x, at.z) + at.altitude + bob(entity, time),
333
+ at.z,
208
334
  );
209
335
  _dummy.rotation.set(
210
336
  0,
211
- entity.angle,
337
+ at.angle,
212
338
  entity.air && entity.moving ? Math.sin(time + entity.id) * 0.025 : 0,
213
339
  );
214
340
  // A site under construction grows out of the ground instead of appearing whole, which
@@ -221,10 +347,10 @@ export function createArmy(
221
347
  for (const part of entry.parts) {
222
348
  part.count = list.length;
223
349
  if (part.count === 0) continue;
350
+ // No bound is recomputed here: every part mesh is `frustumCulled = false`, so nothing
351
+ // reads one — and on the native engine the call crosses the bridge and walks every
352
+ // instance in the batch.
224
353
  upload(part.instanceMatrix, part.count);
225
- // The instance-aware bound, or the batch is culled by its own geometry's origin-sized
226
- // sphere and half the battlefield silently disappears.
227
- part.computeBoundingSphere();
228
354
  }
229
355
  }
230
356
 
@@ -236,9 +362,11 @@ export function createArmy(
236
362
  for (const entity of game.entities) {
237
363
  if (entity.garrisonId !== null || entity.team !== team) continue;
238
364
  if (team !== 0 && !game.visibleAt(entity.x, entity.z)) continue;
239
- if (!entity.building && !selected.has(entity.id)) continue;
240
- const radius = entity.r + 0.4;
241
- _dummy.position.set(entity.x, terrainHeight(entity.x, entity.z) + 0.13, entity.z);
365
+ // Only the selection is ringed: the painted apron already frames every building.
366
+ if (!selected.has(entity.id)) continue;
367
+ const radius = entity.r + 0.3;
368
+ const at = pose(entity);
369
+ _dummy.position.set(at.x, terrainHeight(at.x, at.z) + 0.13, at.z);
242
370
  _dummy.rotation.set(0, 0, 0);
243
371
  _dummy.scale.set(radius, 1, radius);
244
372
  _dummy.updateMatrix();
@@ -257,21 +385,19 @@ export function createArmy(
257
385
  // A unit earns a bar once something has happened to it, or once it is selected; a building
258
386
  // always has one, because its queue and its build site are the numbers being watched.
259
387
  if (!entity.building && !hurt && !selected.has(entity.id)) continue;
260
- const width = entity.building ? 6 : 3;
261
- const y =
262
- (entity.altitude || 0) +
263
- (entity.air ? 2.1 : entity.building ? TYPES[entity.type].r + 1.3 : 3.1);
388
+ const health = entity.maxHp > 0 ? entity.hp / entity.maxHp : 0;
389
+ const building = entity.building && !entity.built;
264
390
  pushBar(
265
391
  entity,
266
- width,
267
- entity.maxHp > 0 ? entity.hp / entity.maxHp : 0,
268
- y,
269
- entity.team > 0 ? _hostile : hurt ? _hurt : _friendly,
392
+ health,
393
+ entity.team > 0
394
+ ? (_teamFill[entity.team] ?? _friendly)
395
+ : health < 0.3
396
+ ? _hurt
397
+ : _friendly,
398
+ !entity.building ? 0 : building ? entity.progress : (entity.queue[0]?.progress ?? 0),
399
+ building ? _work : _queue,
270
400
  );
271
- if (entity.building && !entity.built)
272
- pushBar(entity, width, entity.progress, y - 0.9, _work);
273
- else if (entity.queue.length > 0)
274
- pushBar(entity, width, entity.queue[0]?.progress ?? 0, y - 0.9, _queue);
275
401
  }
276
402
  bars.count = barCount;
277
403
  upload(bars.instanceMatrix, barCount);
@@ -286,10 +412,13 @@ export function createArmy(
286
412
  _dummy.scale.setScalar(1 + (1 - slot.life / MARKER_LIFE) * 3);
287
413
  _dummy.updateMatrix();
288
414
  markerRings.setMatrixAt(live, _dummy.matrix);
415
+ markerBackings.setMatrixAt(live, _dummy.matrix);
289
416
  live += 1;
290
417
  }
291
418
  markerRings.count = live;
419
+ markerBackings.count = live;
292
420
  upload(markerRings.instanceMatrix, live);
421
+ upload(markerBackings.instanceMatrix, live);
293
422
  },
294
423
  dispose: () => {
295
424
  // The model geometries belong to `models`, which frees them; the materials are shared by
@@ -308,6 +437,9 @@ export function createArmy(
308
437
  (bars.material as MeshBasicMaterial).dispose();
309
438
  markerRings.geometry.dispose();
310
439
  (markerRings.material as MeshBasicMaterial).dispose();
440
+ markerBackings.geometry.dispose();
441
+ backingMaterial.dispose();
442
+ root.remove(markerBackings);
311
443
  },
312
444
  };
313
445
  }
@@ -5,7 +5,6 @@ import {
5
5
  type DirectionalLight,
6
6
  Material,
7
7
  type MeshStandardMaterial,
8
- type Object3D,
9
8
  type Scene,
10
9
  Vector3,
11
10
  } from "three";
@@ -75,41 +74,73 @@ export function backlightMaterial(source: MeshStandardMaterial, controls: IBackl
75
74
  return material;
76
75
  }
77
76
 
77
+ interface IRenderFrame {
78
+ readonly renderId?: number;
79
+ readonly frameId?: number;
80
+ readonly camera?: Camera | null;
81
+ }
82
+
78
83
  function createGraph(controls: IBacklightControls) {
79
- const rimGain = uniform(controls.rimGain).onRenderUpdate(() => {
84
+ // One render validates the controls and resolves the key once for all eight uniforms: each read can
85
+ // be a native bridge call, and a render reads the same values throughout.
86
+ let checkedFrame: IRenderFrame | undefined;
87
+ let checkedRender: number | undefined;
88
+ const check = (frame: IRenderFrame) => {
89
+ const render = frame.renderId ?? frame.frameId;
90
+ if (frame === checkedFrame && render === checkedRender) return;
80
91
  validateControls(controls);
92
+ checkedFrame = frame;
93
+ checkedRender = render;
94
+ };
95
+ const keyDirectionValue = new Vector3(0, 1, 0);
96
+ const keyTargetValue = new Vector3();
97
+ let keyFrame: IRenderFrame | undefined;
98
+ let keyRender: number | undefined;
99
+ let keyGainValue = 0;
100
+ const key = (frame: IRenderFrame) => {
101
+ const render = frame.renderId ?? frame.frameId;
102
+ if (frame !== keyFrame || render !== keyRender) {
103
+ keyGainValue = resolveKey(
104
+ controls,
105
+ keyDirectionValue,
106
+ keyTargetValue,
107
+ frame.camera ?? controls.camera,
108
+ );
109
+ keyFrame = frame;
110
+ keyRender = render;
111
+ }
112
+ return keyGainValue;
113
+ };
114
+ const rimGain = uniform(controls.rimGain).onRenderUpdate((frame) => {
115
+ check(frame);
81
116
  return controls.rimGain;
82
117
  });
83
- const fillGain = uniform(0).onRenderUpdate(() => {
84
- validateControls(controls);
118
+ const fillGain = uniform(0).onRenderUpdate((frame) => {
119
+ check(frame);
85
120
  return controls.fillAdmitted ? controls.fillGain : 0;
86
121
  });
87
- const fillColor = uniform(controls.fillColor).onRenderUpdate(() => {
88
- validateControls(controls);
122
+ const fillColor = uniform(controls.fillColor).onRenderUpdate((frame) => {
123
+ check(frame);
89
124
  return controls.fillColor;
90
125
  });
91
- const fillDirection = uniform(controls.fillDirection).onRenderUpdate(() => {
92
- validateControls(controls);
126
+ const fillDirection = uniform(controls.fillDirection).onRenderUpdate((frame) => {
127
+ check(frame);
93
128
  return controls.fillDirection;
94
129
  });
95
- const fillAngularSize = uniform(controls.fillAngularSize).onRenderUpdate(() => {
96
- validateControls(controls);
130
+ const fillAngularSize = uniform(controls.fillAngularSize).onRenderUpdate((frame) => {
131
+ check(frame);
97
132
  return controls.fillAngularSize;
98
133
  });
99
- const keyColor = uniform(controls.key.color).onRenderUpdate(() => {
100
- validateControls(controls);
134
+ const keyColor = uniform(controls.key.color).onRenderUpdate((frame) => {
135
+ check(frame);
101
136
  return controls.key.color;
102
137
  });
103
- const keyDirectionValue = new Vector3(0, 1, 0);
104
- const keyTargetValue = new Vector3();
105
138
  const keyDirection = uniform(keyDirectionValue).onRenderUpdate((frame) => {
106
- resolveKey(controls, keyDirectionValue, keyTargetValue, frame.camera ?? controls.camera);
139
+ key(frame);
107
140
  return keyDirectionValue;
108
141
  });
109
142
  // Removal/visibility/intensity are live. A removed sun cannot leave an invented rim behind.
110
- const keyGain = uniform(0).onRenderUpdate((frame) =>
111
- resolveKey(controls, keyDirectionValue, keyTargetValue, frame.camera ?? controls.camera),
112
- );
143
+ const keyGain = uniform(0).onRenderUpdate((frame) => key(frame));
113
144
  const N = normalView.normalize();
114
145
  const V = positionViewDirection.normalize();
115
146
  const L = cameraViewMatrix.transformDirection(keyDirection);