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
@@ -13,14 +13,13 @@ import {
13
13
  type AnimationClip,
14
14
  Box3,
15
15
  BoxGeometry,
16
- Color,
17
16
  Group,
18
17
  MathUtils,
18
+ Matrix4,
19
19
  Mesh,
20
20
  MeshBasicMaterial,
21
21
  MeshStandardMaterial,
22
22
  type Object3D,
23
- Quaternion,
24
23
  Vector3,
25
24
  } from "three";
26
25
  import { scale } from "../render/scale.js";
@@ -47,6 +46,8 @@ const WALK_SPEED = 2.4;
47
46
  const CHASE_SPEED = 3.4;
48
47
  const HEAR_RANGE = 26;
49
48
  const VIEW_RANGE = 30;
49
+ /** The grip bound the rifle-grip playtest holds each hand to, metres; a wider cheap gap is re-measured exactly. */
50
+ const GRIP_GAP_EXACT_ABOVE = 0.05;
50
51
  const VIEW_HALF_ANGLE = MathUtils.degToRad(46);
51
52
  const ENGAGE_RANGE = 13;
52
53
  const BURST_ROUNDS = 3;
@@ -240,9 +241,103 @@ const ROUTE_START = ROUTE[0] ?? new Vector3();
240
241
  const GOAL_REPLAN_SECONDS = 0.15;
241
242
  /** Blocked-cell bitmaps per collider set, so the squad pays for the nav grid once. */
242
243
  const NAV_GRIDS = new WeakMap<object, Map<string, Uint8Array>>();
244
+ /** Side, in metres, of one bucket of the collider index `#occupied` searches. */
245
+ const OCCUPANCY_BUCKET = 4;
246
+ /** The widest padding `#occupied` is asked for; each box is filed under every bucket it reaches. */
247
+ const OCCUPANCY_PAD = AGENT_RADIUS + 0.16;
248
+
249
+ /** The town's walls bucketed on the ground plane: `[minX, maxX, minZ, maxZ]` per box, per bucket. */
250
+ export interface IOccupancyIndex {
251
+ readonly minX: number;
252
+ readonly minZ: number;
253
+ readonly columns: number;
254
+ readonly rows: number;
255
+ /** The widest padding this index files for; a wider query would silently miss a wall. */
256
+ readonly pad: number;
257
+ readonly buckets: readonly number[][];
258
+ }
259
+ const OCCUPANCY = new WeakMap<object, IOccupancyIndex>();
260
+
261
+ /**
262
+ * Index the colliders that block a walker once per collider set. The same two filters `#occupied`
263
+ * used to apply per box per query: the raised deck is overhead, not a wall, so a soldier routes
264
+ * through the open space under it; and a box under half a metre is a step, not an obstacle.
265
+ *
266
+ * Each wall is filed under every bucket its padded box reaches, so a query looks only at the walls
267
+ * its own bucket holds and still finds a wall whose face is up to `pad` away.
268
+ */
269
+ export function occupancyIndex(colliders: readonly BoxCollider[]): IOccupancyIndex {
270
+ const cached = OCCUPANCY.get(colliders);
271
+ if (cached !== undefined) return cached;
272
+ const walls = colliders.filter(
273
+ (box) => box.min[1] <= scale.humanHeight + scale.ankleHeight * 6 && box.max[1] > 0.5,
274
+ );
275
+ const minX = Math.min(...walls.map((box) => box.min[0])) - OCCUPANCY_PAD;
276
+ const minZ = Math.min(...walls.map((box) => box.min[2])) - OCCUPANCY_PAD;
277
+ const maxX = Math.max(...walls.map((box) => box.max[0])) + OCCUPANCY_PAD;
278
+ const maxZ = Math.max(...walls.map((box) => box.max[2])) + OCCUPANCY_PAD;
279
+ const columns = walls.length === 0 ? 0 : Math.floor((maxX - minX) / OCCUPANCY_BUCKET) + 1;
280
+ const rows = walls.length === 0 ? 0 : Math.floor((maxZ - minZ) / OCCUPANCY_BUCKET) + 1;
281
+ const buckets = Array.from({ length: columns * rows }, (): number[] => []);
282
+ const cell = (value: number, origin: number): number =>
283
+ Math.floor((value - origin) / OCCUPANCY_BUCKET);
284
+ for (const box of walls) {
285
+ for (
286
+ let row = cell(box.min[2] - OCCUPANCY_PAD, minZ);
287
+ row <= cell(box.max[2] + OCCUPANCY_PAD, minZ);
288
+ row += 1
289
+ ) {
290
+ for (
291
+ let column = cell(box.min[0] - OCCUPANCY_PAD, minX);
292
+ column <= cell(box.max[0] + OCCUPANCY_PAD, minX);
293
+ column += 1
294
+ ) {
295
+ buckets[row * columns + column]?.push(box.min[0], box.max[0], box.min[2], box.max[2]);
296
+ }
297
+ }
298
+ }
299
+ const index = { minX, minZ, columns, rows, pad: OCCUPANCY_PAD, buckets };
300
+ OCCUPANCY.set(colliders, index);
301
+ return index;
302
+ }
303
+
304
+ /** True when a body `padding` wide at (x, z) overlaps one of the walls `index` holds near it. */
305
+ export function occupancyBlocked(
306
+ index: IOccupancyIndex,
307
+ x: number,
308
+ z: number,
309
+ padding: number,
310
+ ): boolean {
311
+ if (padding > index.pad) {
312
+ throw new RangeError(
313
+ `Occupancy index files walls ${index.pad} m from a point, asked for ${padding} m.`,
314
+ );
315
+ }
316
+ const column = Math.floor((x - index.minX) / OCCUPANCY_BUCKET);
317
+ const row = Math.floor((z - index.minZ) / OCCUPANCY_BUCKET);
318
+ // Off the filed ground: no wall is within `pad` of a point outside every wall's own range.
319
+ if (column < 0 || column >= index.columns || row < 0 || row >= index.rows) return false;
320
+ const walls = index.buckets[row * index.columns + column];
321
+ if (walls === undefined) return false;
322
+ for (let at = 0; at < walls.length; at += 4) {
323
+ if (
324
+ x > (walls[at] as number) - padding &&
325
+ x < (walls[at + 1] as number) + padding &&
326
+ z > (walls[at + 2] as number) - padding &&
327
+ z < (walls[at + 3] as number) + padding
328
+ ) {
329
+ return true;
330
+ }
331
+ }
332
+ return false;
333
+ }
243
334
 
244
335
  // Scratch for the per-frame sight test; five soldiers × three vectors × 60 Hz is real garbage.
245
336
  const scratchGoal = new Vector3();
337
+ /** The hand joint in the rifle's own frame, its clamp onto the rifle box, and the rifle's scale. */
338
+ const scratchGap = new Vector3();
339
+ const scratchScale = new Vector3();
340
+ const scratchHold = new Matrix4();
246
341
  const scratchTo = new Vector3();
247
342
  const scratchFacing = new Vector3();
248
343
  const scratchFlat = new Vector3();
@@ -576,7 +671,8 @@ export class Enemy {
576
671
  #leftKnee: Object3D | undefined;
577
672
  #rightKnee: Object3D | undefined;
578
673
  #colliders: readonly BoxCollider[];
579
- #bodyMeshes: Object3D[] = [];
674
+ #occupancy: IOccupancyIndex;
675
+ #bodyMeshes: Mesh[] = [];
580
676
  #poseBones: Object3D[] = [];
581
677
  #bodyProxy: Object3D | undefined;
582
678
  #body: CharacterBody3D | undefined;
@@ -587,6 +683,12 @@ export class Enemy {
587
683
  #weaponVelocity = new Vector3();
588
684
  #rifleLocalMinZ = -scale.rifleLength * 0.35;
589
685
  #rifleLocalMaxZ = scale.rifleLength * 0.65;
686
+ /** The rifle's bounds in its own frame, measured once at equip: it is rigid, so they never change. */
687
+ #rifleLocalBox: Box3 | null = null;
688
+ /** `hand_r`'s gap to the rifle box, kept until the hold or the parent changes. */
689
+ #rightGripGap: number | null = null;
690
+ /** The rifle's world scale, read with `#rightGripGap`, so a left-hand sample needs no walk for it. */
691
+ #rifleWorldScale = 1;
590
692
  #rightHand: Object3D | undefined;
591
693
  #leftHand: Object3D | undefined;
592
694
  #weaponNodes: string[] = [];
@@ -621,6 +723,7 @@ export class Enemy {
621
723
  options: EnemyOptions = {},
622
724
  ) {
623
725
  this.#colliders = colliders;
726
+ this.#occupancy = occupancyIndex(colliders);
624
727
  this.#route = options.route ?? ROUTE;
625
728
  this.#navMin = options.navBounds?.min ?? NAV_MIN;
626
729
  this.#navMax = options.navBounds?.max ?? NAV_MAX;
@@ -675,11 +778,7 @@ export class Enemy {
675
778
  this.group.add(figure);
676
779
  this.#ground = new GroundSnap(figure, { enabled: false, meshes: this.#bodyMeshes });
677
780
  this.#equip(figure);
678
- // Before the first draw, not on the first death. `#respawn` also calls this, but `#respawn`
679
- // only ever runs off the death timer, so a soldier that has never died would otherwise reach
680
- // his own death still carrying the blend state the asset shipped with — which is both a
681
- // mid-fight pipeline compile and, once `#setOpacity` stopped flipping the flag, a fade that
682
- // does not render at all because opacity is ignored on an opaque material.
781
+ // Precompile the dither fade before the first death.
683
782
  this.#fixBlendState();
684
783
  this.group.name = "enemy";
685
784
  this.group.position.copy(this.#route[0] ?? ROUTE_START);
@@ -799,8 +898,12 @@ export class Enemy {
799
898
  return this.group.position.y;
800
899
  }
801
900
 
901
+ /**
902
+ * The crown height measured once when the model bound, not re-read per call: `chest` asks for it
903
+ * on every sight test, and each live `modelHeight` read is a bone-chain walk into the engine.
904
+ */
802
905
  get bodyHeight(): number {
803
- return this.modelHeight || this.#modelHeightMeasured;
906
+ return this.#modelHeightMeasured;
804
907
  }
805
908
 
806
909
  get headZoneMinY(): number {
@@ -838,6 +941,7 @@ export class Enemy {
838
941
  const bounds = new Box3().setFromObject(rifle);
839
942
  this.#rifleLocalMinZ = bounds.min.z;
840
943
  this.#rifleLocalMaxZ = bounds.max.z;
944
+ this.#rifleLocalBox = bounds;
841
945
 
842
946
  if (hand === undefined) {
843
947
  // No hand bone: hang it beside the hip rather than dropping it. A soldier without a
@@ -890,6 +994,7 @@ export class Enemy {
890
994
  const holder = this.#weapon;
891
995
  if (holder === undefined || this.#rightHand === undefined) return;
892
996
  this.#rightHand.add(holder);
997
+ this.#rightGripGap = null;
893
998
  this.#weaponDetached = false;
894
999
  this.#weaponSettled = false;
895
1000
  this.#weaponVelocity.set(0, 0, 0);
@@ -913,25 +1018,7 @@ export class Enemy {
913
1018
  body.teleport(proxy.position);
914
1019
  }
915
1020
 
916
- /**
917
- * Fade a soldier in or out without changing his pipeline.
918
- *
919
- * `transparent` and `depthWrite` are blend and depth state, not shader uniforms, so flipping
920
- * either one makes WebGPU compile a *new* render pipeline for every material it touches — and a
921
- * soldier is a skinned mesh with several. This used to set `transparent = alpha < 0.999` and
922
- * `depthWrite = alpha > 0.5`, which meant the first death in a round compiled a fresh pipeline
923
- * per material on the frame the corpse started fading. Measured as a single ~180 ms frame,
924
- * mid-round, entirely outside game logic: `outsideGame` peaked at 177-186 ms with a firefight in
925
- * the scenario and 28.6 ms without one, on identical movement.
926
- *
927
- * So the state is fixed at construction and never moves. Only `opacity` changes, which is a
928
- * uniform the existing pipeline already reads. `needsUpdate` is deliberately not set: it forces
929
- * the material to be re-evaluated, and there is nothing left to re-evaluate.
930
- *
931
- * Keeping `depthWrite` on for a fading corpse is the deliberate half of this. It costs a little
932
- * correctness on a half-faded body seen through another one, and it buys never compiling
933
- * mid-fight — and a corpse fading on the ground is not what anyone is looking at.
934
- */
1021
+ /** Change only opacity: switching pipeline state mid-death previously cost ~180 ms. */
935
1022
  #setOpacity(alpha: number): void {
936
1023
  const objects = [
937
1024
  ...this.#bodyMeshes,
@@ -951,12 +1038,7 @@ export class Enemy {
951
1038
  if (alpha < this.#opacityFloor) this.#opacityFloor = alpha;
952
1039
  }
953
1040
 
954
- /**
955
- * Put every material into its final blend state once, before the soldier is ever drawn.
956
- *
957
- * Called at construction so the transparent pipeline is compiled during loading, where a long
958
- * frame is part of the loading screen, rather than on the frame someone dies.
959
- */
1041
+ /** Dither fades keep solid soldiers in the opaque depth/normal passes. */
960
1042
  #fixBlendState(): void {
961
1043
  const objects = [
962
1044
  ...this.#bodyMeshes,
@@ -968,7 +1050,8 @@ export class Enemy {
968
1050
  if (mesh.isMesh !== true) return;
969
1051
  const materials = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
970
1052
  for (const material of materials) {
971
- material.transparent = true;
1053
+ material.transparent = false;
1054
+ material.alphaHash = true;
972
1055
  material.depthWrite = true;
973
1056
  material.needsUpdate = true;
974
1057
  }
@@ -1004,6 +1087,7 @@ export class Enemy {
1004
1087
 
1005
1088
  #holdRifle(clip: string): void {
1006
1089
  const hold = RIFLE_HOLD[clip];
1090
+ this.#rightGripGap = null;
1007
1091
  if (hold !== undefined) {
1008
1092
  this.#weaponModel?.rotation.set(
1009
1093
  ...(hold.map(MathUtils.degToRad) as [number, number, number]),
@@ -1028,7 +1112,7 @@ export class Enemy {
1028
1112
  crouched: boolean,
1029
1113
  dt: number,
1030
1114
  poseLocked = false,
1031
- armed = false,
1115
+ _armed = false,
1032
1116
  ): void {
1033
1117
  // Ground speed is measured from where the body actually got to this frame, not from the
1034
1118
  // speed constant it was asked for: a blocked step, a corner, or a slow turn all cut it.
@@ -1119,10 +1203,46 @@ export class Enemy {
1119
1203
  this.#clipFrames.set(current, frames);
1120
1204
  // Not the first frames: a clip that has only just started is still a crossfade from the last.
1121
1205
  if (frames < 12 || frames % 4 !== 0 || this.#weaponDetached) return;
1122
- const worst = Math.max(this.#contact("hand_r") ?? 0, this.#contact("hand_l") ?? 0);
1206
+ // The rifle's own box sits inside the world box `boneContact` clamps to, so the cheap gap is
1207
+ // never smaller than the honest one: under the 5 cm grip bound it already proves the grip,
1208
+ // and only a wider gap pays for the exact vertex walk.
1209
+ const cheap = Math.max(this.#handGap("hand_r") ?? 0, this.#handGap("hand_l") ?? 0);
1210
+ const worst =
1211
+ cheap <= GRIP_GAP_EXACT_ABOVE
1212
+ ? cheap
1213
+ : Math.max(this.#contact("hand_r") ?? 0, this.#contact("hand_l") ?? 0);
1123
1214
  this.#contactPeak.set(current, Math.max(this.#contactPeak.get(current) ?? 0, worst));
1124
1215
  }
1125
1216
 
1217
+ /**
1218
+ * Metres from a hand joint to the rifle's own bounds, sampled without touching its vertices.
1219
+ *
1220
+ * `boneContact` measures a world-space box over every rifle vertex, which is the honest number
1221
+ * for a playtest and far too much work to repeat while playing. The rifle is rigid, so its
1222
+ * bounds in its own frame never change: transform the joint into that frame, clamp, and scale
1223
+ * the local gap back to metres. One matrix invert and one clamp, no walk.
1224
+ *
1225
+ * The rifle is a child of `hand_r`, so that joint sits where the rifle's own hold puts it: its
1226
+ * gap follows from the rifle's local transform alone and is measured once per hold. Only the
1227
+ * left hand, on another branch of the skeleton, needs the posed world matrices per sample.
1228
+ */
1229
+ #handGap(bone: "hand_r" | "hand_l"): number | null {
1230
+ const weapon = this.#weaponModel;
1231
+ const bounds = this.#rifleLocalBox;
1232
+ const joint = bone === "hand_r" ? this.#rightHand : this.#leftHand;
1233
+ if (weapon === undefined || bounds === null || joint === undefined) return null;
1234
+ if (this.#rightGripGap === null) {
1235
+ weapon.updateWorldMatrix(true, false);
1236
+ this.#rifleWorldScale = weapon.getWorldScale(scratchScale).x;
1237
+ scratchGap.setFromMatrixPosition(scratchHold.copy(weapon.matrix).invert());
1238
+ this.#rightGripGap = bounds.distanceToPoint(scratchGap) * this.#rifleWorldScale;
1239
+ }
1240
+ if (bone === "hand_r") return this.#rightGripGap;
1241
+ weapon.updateWorldMatrix(true, false);
1242
+ weapon.worldToLocal(joint.getWorldPosition(scratchGap));
1243
+ return bounds.distanceToPoint(scratchGap) * this.#rifleWorldScale;
1244
+ }
1245
+
1126
1246
  /**
1127
1247
  * Fire `hooks.onFootstep` each time the locomotion action crosses a half-cycle
1128
1248
  * boundary — one planted foot per half-cycle, so a re-timed walk keeps its steps
@@ -1158,22 +1278,19 @@ export class Enemy {
1158
1278
  return "Death01";
1159
1279
  }
1160
1280
 
1281
+ /**
1282
+ * True when a body `padding` wide at (x, z) overlaps a wall or leaves the map. A path check asks
1283
+ * this for every sample along a segment, so it searches only the walls filed in (x, z)'s bucket
1284
+ * (`occupancyIndex`) instead of the whole town; the answer is the same box test.
1285
+ */
1161
1286
  #occupied(x: number, z: number, padding: number): boolean {
1162
- for (const box of this.#colliders) {
1163
- // The raised deck is overhead, not a wall. Keep its supports and the lower range solids
1164
- // in the navigation map, but let a soldier route through the open space underneath it.
1165
- if (box.min[1] > scale.humanHeight + scale.ankleHeight * 6) continue;
1166
- if (
1167
- x > box.min[0] - padding &&
1168
- x < box.max[0] + padding &&
1169
- z > box.min[2] - padding &&
1170
- z < box.max[2] + padding &&
1171
- box.max[1] > 0.5
1172
- ) {
1173
- return true;
1174
- }
1175
- }
1176
- return x < this.#navMin || x > this.#navMax || z < this.#navMin || z > this.#navMax;
1287
+ return (
1288
+ occupancyBlocked(this.#occupancy, x, z, padding) ||
1289
+ x < this.#navMin ||
1290
+ x > this.#navMax ||
1291
+ z < this.#navMin ||
1292
+ z > this.#navMax
1293
+ );
1177
1294
  }
1178
1295
 
1179
1296
  /** True when the soldier stands in any raised deck's footprint — routing beneath it. */
@@ -1603,8 +1720,7 @@ export class Enemy {
1603
1720
  this.#reattachWeapon();
1604
1721
  this.#bodyClearance = null;
1605
1722
  this.#footClearance = null;
1606
- // Blend state first, and only here: it is what costs a pipeline, so it is set once per
1607
- // soldier and never again. The fade below is a uniform on the pipeline this just built.
1723
+ // Restore the precompiled fade state before changing its opacity uniform.
1608
1724
  this.#fixBlendState();
1609
1725
  this.#setOpacity(0);
1610
1726
  this.#reaction = 0;
@@ -1905,6 +2021,7 @@ export class Enemy {
1905
2021
  * all five at once.
1906
2022
  */
1907
2023
  materialOpacity: number;
2024
+ bodyUsesOpaqueFade: boolean;
1908
2025
  /** Lowest `materialOpacity` this soldier has ever reported. See `#opacityFloor`. */
1909
2026
  materialOpacityFloor: number;
1910
2027
  reaction: number;
@@ -1984,6 +2101,11 @@ export class Enemy {
1984
2101
  deadFor: this.#deadFor,
1985
2102
  armed: this.#weapon !== undefined,
1986
2103
  materialOpacity: this.#fade,
2104
+ bodyUsesOpaqueFade: this.#bodyMeshes.every((mesh) =>
2105
+ (Array.isArray(mesh.material) ? mesh.material : [mesh.material]).every(
2106
+ (material) => !material.transparent && material.alphaHash && material.depthWrite,
2107
+ ),
2108
+ ),
1987
2109
  materialOpacityFloor: this.#opacityFloor,
1988
2110
  reaction: this.#reaction,
1989
2111
  bodyClearance: this.#bodyClearance,
@@ -17,12 +17,13 @@ import {
17
17
  import { scale } from "../render/scale.js";
18
18
  import type { GameState } from "../state.js";
19
19
  import type { TouchFrame } from "./TouchControls.js";
20
+ import { type IStairView, groundMove, stairView } from "./movement.js";
20
21
 
21
22
  type GameCtx = ICtx<GameState, IPhysicsContext>;
22
23
 
23
24
  export const EYE_HEIGHT = scale.eyeHeight;
24
- const WALK_SPEED = 5.6;
25
- const SPRINT_SPEED = 8.2;
25
+ export const WALK_SPEED = 5.6;
26
+ export const SPRINT_SPEED = 8.2;
26
27
  /** Crouched movement, and how far the eye drops. A crouch that only slows you reads as a bug. */
27
28
  const CROUCH_SPEED = 2.6;
28
29
  const CROUCH_EYE_DROP = scale.eyeHeight * 0.34;
@@ -76,6 +77,8 @@ export class FpsPlayer {
76
77
  distanceMoved = 0;
77
78
  aiming = false;
78
79
  crouching = false;
80
+ /** Shift, or a thumb on the stick rim, and neither aiming nor crouching. Read by the rifle. */
81
+ sprinting = false;
79
82
  /** This tick's thumb input, set by the scene before `update`. Undefined on desktop. */
80
83
  touch: TouchFrame | undefined;
81
84
  /**
@@ -86,8 +89,18 @@ export class FpsPlayer {
86
89
  * scenario that samples every few hundred frames still catches a single bad step.
87
90
  */
88
91
  cameraLagPeak = 0;
92
+ /**
93
+ * Fastest climb of the eye in one tick while on the ground, in metres. The body steps up a stair
94
+ * in a few ticks and then stops; an eye welded to it climbs in jolts. A peak, like the lag above.
95
+ */
96
+ viewRisePeak = 0;
89
97
  /** 0 standing, 1 fully folded; eased so the eye slides rather than teleports. */
90
98
  #crouch = 0;
99
+ /** The body height the eye shows, smoothed over stair steps; undefined until the first sync. */
100
+ #view: IStairView | undefined;
101
+ /** The smoothed height minus the body's, when the camera was last placed. */
102
+ #viewOffset = 0;
103
+ #tickDt = 0;
91
104
  /** Set by the scene: fired each time a stride completes, so footsteps keep pace with speed. */
92
105
  onFootstep: ((sprinting: boolean) => void) | undefined;
93
106
  #camera: PerspectiveCamera;
@@ -132,12 +145,17 @@ export class FpsPlayer {
132
145
  };
133
146
  }
134
147
 
135
- /** The camera basis is the single source of aim truth, including hit shake. */
148
+ /**
149
+ * The camera basis is the single source of aim truth, including hit shake. The camera hangs off
150
+ * the scene root, so its own placement is its world pose: reading the position and rotation
151
+ * `syncCamera` wrote is the same answer as `getWorldPosition`/`getWorldDirection` without the
152
+ * walk those two make up the camera and back down the viewmodel, once every frame, for a pose
153
+ * this class had just written itself.
154
+ */
136
155
  aimRay(): { origin: Vector3; direction: Vector3 } {
137
- this.#camera.updateMatrixWorld(true);
138
156
  return {
139
- origin: this.#camera.getWorldPosition(new Vector3()),
140
- direction: this.#camera.getWorldDirection(new Vector3()).normalize(),
157
+ origin: this.#camera.position.clone(),
158
+ direction: new Vector3(0, 0, -1).applyQuaternion(this.#camera.quaternion),
141
159
  };
142
160
  }
143
161
 
@@ -150,8 +168,16 @@ export class FpsPlayer {
150
168
 
151
169
  syncCamera(): void {
152
170
  const eye = this.eye;
171
+ const bodyY = this.mesh.position.y;
172
+ const before = this.#view?.y;
173
+ this.#view = stairView(this.#view, bodyY, this.body.grounded, this.#tickDt);
174
+ if (before !== undefined && this.body.grounded) {
175
+ this.viewRisePeak = Math.max(this.viewRisePeak, Math.abs(this.#view.y - before));
176
+ }
177
+ this.#viewOffset = this.#view.y - bodyY;
153
178
  applyFirstPerson(this.#camera, {
154
179
  ...eye,
180
+ y: eye.y + this.#viewOffset,
155
181
  yaw: this.look.yaw,
156
182
  pitch: this.look.pitch,
157
183
  shake: this.#shake,
@@ -160,7 +186,9 @@ export class FpsPlayer {
160
186
  }
161
187
 
162
188
  update(ctx: GameCtx, dt: number, canAim: boolean): void {
163
- const renderedLag = Math.abs(this.#camera.position.y - this.eye.y);
189
+ this.#tickDt = dt;
190
+ // The stair offset is deliberate; what is left is the body moving after the camera was placed.
191
+ const renderedLag = Math.abs(this.#camera.position.y - this.eye.y - this.#viewOffset);
164
192
  if (renderedLag > this.cameraLagPeak) this.cameraLagPeak = renderedLag;
165
193
  const touch = this.touch;
166
194
  this.aiming = canAim && (ctx.input.pressed("aim") || touch?.aim === true);
@@ -182,6 +210,7 @@ export class FpsPlayer {
182
210
  // same two vetoes below apply to a thumb and to Shift alike.
183
211
  const sprintAsked = ctx.input.pressed("sprint") || touch?.sprint === true;
184
212
  const sprinting = sprintAsked && !this.aiming && !this.crouching;
213
+ this.sprinting = sprinting;
185
214
  // Crouch wins over sprint: holding both should not sprint at a crouch-walk's silhouette.
186
215
  const speed = this.crouching ? CROUCH_SPEED : sprinting ? SPRINT_SPEED : WALK_SPEED;
187
216
  // `vector().y` is +up; forward on this ground plane is -z.
@@ -189,15 +218,15 @@ export class FpsPlayer {
189
218
  const forwardZ = -Math.cos(this.look.yaw);
190
219
  const rightX = Math.cos(this.look.yaw);
191
220
  const rightZ = -Math.sin(this.look.yaw);
192
- let vx = forwardX * move.y + rightX * move.x;
193
- let vz = forwardZ * move.y + rightZ * move.x;
194
- const length = Math.hypot(vx, vz);
221
+ let wishX = forwardX * move.y + rightX * move.x;
222
+ let wishZ = forwardZ * move.y + rightZ * move.x;
223
+ const length = Math.hypot(wishX, wishZ);
195
224
  if (length > 1e-4) {
196
- vx = (vx / length) * speed;
197
- vz = (vz / length) * speed;
225
+ wishX /= length;
226
+ wishZ /= length;
198
227
  } else {
199
- vx = 0;
200
- vz = 0;
228
+ wishX = 0;
229
+ wishZ = 0;
201
230
  }
202
231
  // The backend writes the solved transform after the step, so measuring the
203
232
  // mesh either side of `moveAndSlide` in one frame always reads zero. Compare
@@ -215,8 +244,9 @@ export class FpsPlayer {
215
244
  }
216
245
  this.#lastX = this.mesh.position.x;
217
246
  this.#lastZ = this.mesh.position.z;
218
- this.body.velocity.x = vx;
219
- this.body.velocity.z = vz;
247
+ // Friction, then acceleration toward the wished speed (see `movement.ts`): the body takes a
248
+ // tenth of a second to reach speed and about a third to stop, instead of one tick for both.
249
+ groundMove(this.body.velocity, wishX, wishZ, length > 1e-4 ? speed : 0, dt);
220
250
  this.body.moveAndSlide(dt);
221
251
 
222
252
  this.#shake = Math.max(0, this.#shake - dt * 3.2);
@@ -243,8 +273,15 @@ export class FpsPlayer {
243
273
  this.#shakePeak = Math.max(this.#shakePeak, this.#shake);
244
274
  }
245
275
 
276
+ /** Horizontal speed in m/s, the one the rifle's bob and clip follow. */
277
+ get speed(): number {
278
+ return Math.hypot(this.body.velocity.x, this.body.velocity.z);
279
+ }
280
+
246
281
  debug(): {
247
282
  cameraLagPeak: number;
283
+ viewRisePeak: number;
284
+ speed: number;
248
285
  crouching: number;
249
286
  health: number;
250
287
  position: number[];
@@ -259,6 +296,8 @@ export class FpsPlayer {
259
296
  const cameraDirection = this.#lastFiringCameraDirection;
260
297
  return {
261
298
  cameraLagPeak: this.cameraLagPeak,
299
+ viewRisePeak: this.viewRisePeak,
300
+ speed: this.speed,
262
301
  crouching: this.crouching ? 1 : 0,
263
302
  health: this.health,
264
303
  position: this.mesh.position.toArray(),
@@ -28,6 +28,7 @@ import { FIRST_PERSON } from "../render/camera.js";
28
28
  import { PooledBillboards } from "../render/pooled-billboards.js";
29
29
  import { scale } from "../render/scale.js";
30
30
  import type { GameState } from "../state.js";
31
+ import { SPRINT_SPEED, WALK_SPEED } from "./FpsPlayer.js";
31
32
 
32
33
  type GameCtx = ICtx<GameState, IPhysicsContext>;
33
34
 
@@ -54,6 +55,36 @@ const AIM_Z = -0.16;
54
55
  const ZERO_DISTANCE = 25;
55
56
  const MAX_CONVERGENCE_DEGREES = 8;
56
57
  const UP = new Vector3(0, 1, 0);
58
+ /** Below this share of a gait's speed the clip stops slowing: a crawl still reads as a walk. */
59
+ const MIN_LOCOMOTION_RATE = 0.6;
60
+
61
+ export type LocomotionClip = "Idle" | "Walk" | "Run";
62
+
63
+ export interface ILocomotion {
64
+ readonly clip: LocomotionClip;
65
+ /** Playback rate: the authored rate at full gait speed, slower below it, never faster. */
66
+ readonly timeScale: number;
67
+ /** Fraction of the procedural sway and bob that survives beside the clip. */
68
+ readonly bobScale: number;
69
+ }
70
+
71
+ /**
72
+ * The clip, rate and procedural-bob weight for a body speed.
73
+ *
74
+ * Walking plays Walk and only a sprint plays Run, each at its authored rate (about 1.2 and 1.5
75
+ * cycles a second) at full gait speed and slower while the body eases in. Never faster: the
76
+ * hands are the closest thing on screen, and a sped-up cycle reads as a seizure, not as speed.
77
+ * While a locomotion clip plays it owns the motion, so the procedural bob is off; two unrelated
78
+ * oscillations on the same hands beat against each other.
79
+ */
80
+ export function locomotion(speed: number, sprinting: boolean): ILocomotion {
81
+ if (speed <= WALK_SPEED * 0.05) return { bobScale: 1, clip: "Idle", timeScale: 1 };
82
+ // Run only once the body is actually past walking pace; the key alone at a standstill is not a gait.
83
+ const run = sprinting && speed >= WALK_SPEED;
84
+ const gaitSpeed = run ? SPRINT_SPEED : WALK_SPEED;
85
+ const timeScale = MathUtils.clamp(speed / gaitSpeed, MIN_LOCOMOTION_RATE, 1);
86
+ return { bobScale: 0, clip: run ? "Run" : "Walk", timeScale };
87
+ }
57
88
 
58
89
  export type AimRay = { origin: Vector3; direction: Vector3 };
59
90
 
@@ -81,6 +112,10 @@ export class Rifle {
81
112
  #lowered = 0;
82
113
 
83
114
  #animation: AnimationPlayer | undefined;
115
+ /** Clip seconds the playing clip advanced, and the game seconds that took, since it started. */
116
+ #handsClip: string | undefined;
117
+ #handsClipSeconds = 0;
118
+ #handsSeconds = 0;
84
119
  #clips: ReadonlySet<string>;
85
120
  #shootFor = 0;
86
121
  #camera: PerspectiveCamera;
@@ -398,28 +433,36 @@ export class Rifle {
398
433
  return (this.#flash.material as MeshBasicMaterial).opacity;
399
434
  }
400
435
 
401
- update(dt: number, aiming: boolean, moving: number): void {
436
+ update(dt: number, aiming: boolean, speed: number, sprinting: boolean): void {
402
437
  this.#shootFor = Math.max(0, this.#shootFor - dt);
438
+ const gait = locomotion(speed, sprinting);
403
439
  if (this.reloading) this.#play("Reload");
404
440
  else if (this.#shootFor > 0) this.#play("Shoot", 0.02);
405
- else if (moving > 0.6) this.#play("Run");
406
- else if (moving > 0.05) this.#play("Walk");
407
- else this.#play("Idle");
408
- this.#animation?.update(dt);
441
+ else this.#play(gait.clip);
442
+ this.#syncPlayback(gait);
443
+ this.#advance(dt);
409
444
  this.decay(dt);
410
445
  // The sights drop while the magazine is out and come back up after.
411
446
  const wantLowered = this.reloading ? 1 : 0;
412
447
  this.#lowered += (wantLowered - this.#lowered) * Math.min(1, dt * 9);
413
448
  this.#blend += ((aiming && !this.reloading ? 1 : 0) - this.#blend) * Math.min(1, dt * 12);
449
+ const moving = Math.min(1, speed / WALK_SPEED);
414
450
  this.#sway += dt * (2.6 + moving * 4.4);
415
- this.#apply(moving, dt);
451
+ this.#apply(moving, gait.bobScale);
416
452
  }
417
453
 
418
- #apply(moving: number, _dt: number): void {
454
+ #syncPlayback(gait: ILocomotion): void {
455
+ if (this.#animation === undefined || !this.#clips.has(gait.clip)) return;
456
+ this.#animation.mixer
457
+ .clipAction(this.#animation.clip(gait.clip))
458
+ .setEffectiveTimeScale(gait.timeScale);
459
+ }
460
+
461
+ #apply(moving: number, bobScale: number): void {
419
462
  const t = this.#blend;
420
463
  const hipMotion = 1 - t;
421
- const bob = Math.sin(this.#sway) * 0.008 * (0.35 + moving) * hipMotion;
422
- const bobY = Math.abs(Math.cos(this.#sway)) * 0.01 * (0.25 + moving) * hipMotion;
464
+ const bob = Math.sin(this.#sway) * 0.008 * (0.35 + moving) * hipMotion * bobScale;
465
+ const bobY = Math.abs(Math.cos(this.#sway)) * 0.01 * (0.25 + moving) * hipMotion * bobScale;
423
466
  const kick = this.#kick * this.#kick;
424
467
  this.group.position.set(
425
468
  HIP.x + (-this.#opticLocal.x - HIP.x) * t + bob,
@@ -449,8 +492,35 @@ export class Rifle {
449
492
  this.group.quaternion.premultiply(correction);
450
493
  }
451
494
 
495
+ /** Advance the hands and measure how fast the playing clip actually ran, wraps included. */
496
+ #advance(dt: number): void {
497
+ const animation = this.#animation;
498
+ if (animation === undefined) return;
499
+ const name = animation.current;
500
+ const action =
501
+ name === undefined ? undefined : animation.mixer.clipAction(animation.clip(name));
502
+ const before = action?.time ?? 0;
503
+ animation.update(dt);
504
+ if (action === undefined || dt <= 0) return;
505
+ if (name !== this.#handsClip) {
506
+ this.#handsClip = name;
507
+ this.#handsClipSeconds = 0;
508
+ this.#handsSeconds = 0;
509
+ }
510
+ const duration = action.getClip().duration;
511
+ let advanced = action.time - before;
512
+ if (advanced < 0 && duration > 0) advanced += duration;
513
+ this.#handsClipSeconds += advanced;
514
+ this.#handsSeconds += dt;
515
+ }
516
+
517
+ #handsRate(): number {
518
+ return this.#handsSeconds > 0 ? this.#handsClipSeconds / this.#handsSeconds : 1;
519
+ }
520
+
452
521
  debug(): {
453
522
  barrelAxisErrorDeg: number;
523
+ handsRate: number;
454
524
  flashOpacity: number;
455
525
  muzzleLocal: number[];
456
526
  tipGapToGeometry: number;
@@ -469,6 +539,10 @@ export class Rifle {
469
539
  tipGapToGeometry: this.#flash.position.distanceTo(this.#geometryTipLocal),
470
540
  opticScreen: { x: (optic.x + 1) / 2, y: (1 - optic.y) / 2 },
471
541
  viewmodelLength: this.#viewmodelLength,
542
+ // Clip seconds per game second the playing clip actually ran since it started. Above 1 is
543
+ // the hands sped past their authored cycle: stride sync once read the camera carrying them
544
+ // as walking and played them at up to 3x.
545
+ handsRate: this.#handsRate(),
472
546
  };
473
547
  }
474
548