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
@@ -0,0 +1,561 @@
1
+ import { AnimationPlayer, type ICtx, attachToBone } from "@threenative/core";
2
+ import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
+ import { Group, MathUtils, type Object3D, Vector2, Vector3 } from "three";
4
+ import { type IHeroRig, createBlade, createHero } from "../render/hero.js";
5
+ import type { ITouchInput } from "../render/touch-controls.js";
6
+ import type { GameState } from "../state.js";
7
+ import type { ITarget, LockOn } from "./LockOn.js";
8
+
9
+ export type GameCtx = ICtx<GameState, IPhysicsContext>;
10
+
11
+ /** Collision layers. Static level geometry, doors and the push block stay on the default layer 1. */
12
+ export const LAYER = { world: 1, hero: 2, foe: 4 } as const;
13
+
14
+ const DEG = Math.PI / 180;
15
+
16
+ /**
17
+ * Wren's feel, in metres and seconds, in one table.
18
+ *
19
+ * Run speed, acceleration and turn rate come from the reference game's rules at 1 unit = 2.5 cm and
20
+ * 20 Hz logic: a speed limit of 600 outdoors and 500 indoors reads 3.0 and 2.5 m/s, an approach of
21
+ * 2.0 units/frame² reads 20 m/s², and 2000 binary angle units a frame read 220°/s. Everything else
22
+ * (the sword, the shield, the roll, the hearts) is this kit's own design value.
23
+ * `playtests/move.playtest.json` proves the first three; change one and change its bounds.
24
+ */
25
+ export const ADVENTURE_FEEL = {
26
+ runSpeedVale: 3,
27
+ runSpeedHollow: 2.5,
28
+ acceleration: 20,
29
+ turnRate: 220 * DEG,
30
+ /** While locked on, Wren turns to face the target this much faster than she turns to run. */
31
+ lockTurnScale: 3,
32
+ rollSpeed: 5.5,
33
+ rollTime: 0.45,
34
+ hopSpeed: 3.2,
35
+ hopRise: 3.6,
36
+ slashWindup: 0.2,
37
+ slashActive: 0.15,
38
+ slashRecovery: 0.25,
39
+ slashArc: 120 * DEG,
40
+ slashReach: 1.4,
41
+ shieldCone: 100 * DEG,
42
+ /** Start health: 3 hearts, counted in half-hearts. */
43
+ startHalves: 6,
44
+ invulnerableTime: 1,
45
+ hurtTime: 0.35,
46
+ knockback: 4,
47
+ deathTime: 1.2,
48
+ gravity: -20,
49
+ killPlane: -10,
50
+ } as const;
51
+
52
+ /** The capsule's origin is Wren's waist; her feet sit this far below it (half-height + radius). */
53
+ const CAPSULE = { halfHeight: 0.55, radius: 0.3 } as const;
54
+ export const FOOT_OFFSET = CAPSULE.halfHeight + CAPSULE.radius;
55
+
56
+ export type HeroState =
57
+ | "idle"
58
+ | "run"
59
+ | "roll"
60
+ | "hop"
61
+ | "slash"
62
+ | "block"
63
+ | "push"
64
+ | "hurt"
65
+ | "dead";
66
+
67
+ export interface IHeroInput {
68
+ readonly move: Vector2;
69
+ readonly attack: boolean;
70
+ readonly action: boolean;
71
+ readonly block: boolean;
72
+ readonly target: boolean;
73
+ readonly targetPressed: boolean;
74
+ /** The lock toggle (Tab, middle click) went down this step. */
75
+ readonly lockPressed: boolean;
76
+ readonly interact: boolean;
77
+ }
78
+
79
+ const inputScratch = new Vector2();
80
+
81
+ /**
82
+ * Keyboard, mouse, gamepad and the touch buttons, merged into the verbs Wren reads. `mouseArmed` is
83
+ * whether the pointer was already captured on the previous step: a click that captures it lands
84
+ * between two steps, so reading the capture on the same step would let that click swing the sword.
85
+ */
86
+ export function readHeroInput(ctx: GameCtx, touch?: ITouchInput, mouseArmed = false): IHeroInput {
87
+ const move = inputScratch.copy(ctx.input.vector("move"));
88
+ if (touch !== undefined) move.add(touch.move);
89
+ move.clampLength(0, 1);
90
+ return {
91
+ action: ctx.input.justPressed("action") || touch?.pressed.action === true,
92
+ // The click that captures the pointer is not a swing: the mouse slash counts once armed.
93
+ attack:
94
+ ctx.input.justPressed("attack") ||
95
+ (mouseArmed && ctx.input.justPressed("slash")) ||
96
+ touch?.pressed.attack === true,
97
+ block: ctx.input.pressed("block") || touch?.held.block === true,
98
+ interact: ctx.input.justPressed("interact") || touch?.pressed.interact === true,
99
+ lockPressed: ctx.input.justPressed("lock"),
100
+ move,
101
+ target: ctx.input.pressed("target") || touch?.held.target === true,
102
+ targetPressed: ctx.input.justPressed("target") || touch?.pressed.target === true,
103
+ };
104
+ }
105
+
106
+ /** The angle from a to b, wrapped to (-π, π]. */
107
+ function angleTo(a: number, b: number): number {
108
+ return MathUtils.euclideanModulo(b - a + Math.PI, Math.PI * 2) - Math.PI;
109
+ }
110
+
111
+ export class Hero {
112
+ /** The body object; its origin is Wren's waist, because that is where a capsule is centred. */
113
+ readonly mesh = new Group();
114
+ readonly rig: IHeroRig;
115
+ readonly blade: Object3D;
116
+ readonly #anim: AnimationPlayer;
117
+ readonly tags = ["player"];
118
+ body: CharacterBody3D | undefined;
119
+ state: HeroState = "idle";
120
+ /** Facing yaw: forward is (sin yaw, 0, cos yaw). π faces north (-Z). */
121
+ yaw = Math.PI;
122
+ health: number = ADVENTURE_FEEL.startHalves;
123
+ capacity: number = ADVENTURE_FEEL.startHalves;
124
+ hasSword = false;
125
+ slashes = 0;
126
+ slashHits = 0;
127
+ shieldBlocks = 0;
128
+ hitsTaken = 0;
129
+ topSpeed = 0;
130
+ stopSeconds = 0;
131
+ turnSeconds = 0;
132
+ #timer = 0;
133
+ #drawn = 0;
134
+ #flash = 0;
135
+ #invulnerable = 0;
136
+ #speed = 0;
137
+ #stopClock: number | undefined;
138
+ #turnClock: number | undefined;
139
+ #hitThisSlash = new Set<ITarget>();
140
+ #knock = new Vector3();
141
+ /** Where the last cut met a target, hit or clank. */
142
+ readonly strikeAt = new Vector3();
143
+ /** This step's wish direction on the ground (stick through camera or lock), length up to 1. */
144
+ readonly wish = new Vector3();
145
+ #toTarget = new Vector3();
146
+ /** The distance to the locked target that strafing holds: set on lock and when closing in. */
147
+ lockDistance = 0;
148
+
149
+ constructor() {
150
+ this.rig = createHero();
151
+ this.rig.group.position.y = -FOOT_OFFSET;
152
+ this.mesh.add(this.rig.group);
153
+ // `strideRoot` is the body: the walk and run play at the rate the ground it covers asks for.
154
+ this.#anim = new AnimationPlayer({
155
+ clips: this.rig.clips,
156
+ root: this.rig.group,
157
+ strideRoot: this.mesh,
158
+ });
159
+ this.blade = createBlade();
160
+ this.blade.visible = false;
161
+ // A weapon stays in the hand that holds it: the rig's `RightHand` bone carries the blade.
162
+ attachToBone(this.rig.group, "RightHand", this.blade);
163
+ }
164
+
165
+ /** Builds the physics body where the hero stands now (after any scenario placement). */
166
+ spawn(ctx: GameCtx): void {
167
+ ctx.add(this.mesh);
168
+ this.body = new CharacterBody3D({
169
+ autostep: { maxHeight: 0.3, minWidth: 0.2 },
170
+ collisionLayer: LAYER.hero,
171
+ collisionMask: LAYER.world | LAYER.foe,
172
+ entity: "player",
173
+ gravity: ADVENTURE_FEEL.gravity,
174
+ object: this.mesh,
175
+ physics: ctx.physics,
176
+ shape: CollisionShape3D.capsule(CAPSULE.halfHeight, CAPSULE.radius),
177
+ snapToGround: 0.3,
178
+ });
179
+ }
180
+
181
+ get alive(): boolean {
182
+ return this.state !== "dead";
183
+ }
184
+
185
+ get forward(): Vector3 {
186
+ return new Vector3(Math.sin(this.yaw), 0, Math.cos(this.yaw));
187
+ }
188
+
189
+ giveSword(): void {
190
+ this.hasSword = true;
191
+ }
192
+
193
+ /**
194
+ * One step of the action machine. `cameraYaw` makes the stick camera-relative while unlocked;
195
+ * locked, the stick is target-relative: up closes in, sideways strafes around the target.
196
+ */
197
+ update(
198
+ ctx: GameCtx,
199
+ dt: number,
200
+ input: IHeroInput,
201
+ lock: LockOn,
202
+ cameraYaw: number,
203
+ indoors: boolean,
204
+ targets: readonly ITarget[],
205
+ ): void {
206
+ const body = this.body;
207
+ if (body === undefined) return;
208
+ this.#timer += dt;
209
+ this.#invulnerable = Math.max(0, this.#invulnerable - dt);
210
+ const feel = ADVENTURE_FEEL;
211
+ const runSpeed = indoors ? feel.runSpeedHollow : feel.runSpeedVale;
212
+ const target = lock.target;
213
+ const stick = input.move.length();
214
+
215
+ // Stick to world: camera-relative unlocked; locked, relative to the line to the target.
216
+ if (target !== undefined) {
217
+ this.#toTarget.subVectors(target.mesh.position, this.mesh.position).setY(0);
218
+ const distance = this.#toTarget.length();
219
+ this.#toTarget.normalize();
220
+ if (lock.justAcquired || input.move.y > 0.2) this.lockDistance = distance;
221
+ const tx = this.#toTarget.x;
222
+ const tz = this.#toTarget.z;
223
+ this.wish.set(
224
+ tx * input.move.y - tz * input.move.x,
225
+ 0,
226
+ tz * input.move.y + tx * input.move.x,
227
+ );
228
+ // Strafing holds the lock distance: a straight sideways step drifts outward on a circle.
229
+ if (Math.abs(input.move.y) < 0.2 && stick > 0.1) {
230
+ const drift = MathUtils.clamp((distance - this.lockDistance) * 3, -0.6, 0.6);
231
+ this.wish.addScaledVector(this.#toTarget, drift);
232
+ }
233
+ } else {
234
+ const sin = Math.sin(cameraYaw);
235
+ const cos = Math.cos(cameraYaw);
236
+ // Camera forward is (-sin, -cos) on the ground; its right is (cos, -sin).
237
+ this.wish.set(
238
+ cos * input.move.x - sin * input.move.y,
239
+ 0,
240
+ -sin * input.move.x - cos * input.move.y,
241
+ );
242
+ }
243
+
244
+ const busy =
245
+ this.state === "slash" ||
246
+ this.state === "roll" ||
247
+ this.state === "hop" ||
248
+ this.state === "hurt" ||
249
+ this.state === "dead";
250
+ if (!busy) {
251
+ if (input.attack && this.hasSword) this.#begin("slash");
252
+ else if (input.action && body.grounded) {
253
+ if (target === undefined) this.#begin("roll");
254
+ else {
255
+ this.#begin("hop");
256
+ body.velocity.y = feel.hopRise;
257
+ const away =
258
+ stick > 0.1 ? this.wish.clone().normalize() : this.#toTarget.clone().negate();
259
+ body.velocity.x = away.x * feel.hopSpeed;
260
+ body.velocity.z = away.z * feel.hopSpeed;
261
+ }
262
+ } else if (input.block) this.state = "block";
263
+ else if (this.state === "block") this.state = "idle";
264
+ }
265
+
266
+ // Facing: toward the target while locked, toward the stick otherwise.
267
+ const turnRate = feel.turnRate * (target !== undefined ? feel.lockTurnScale : 1);
268
+ const goalYaw =
269
+ target !== undefined
270
+ ? Math.atan2(this.#toTarget.x, this.#toTarget.z)
271
+ : stick > 0.1
272
+ ? Math.atan2(this.wish.x, this.wish.z)
273
+ : this.yaw;
274
+ const canTurn =
275
+ this.state === "idle" ||
276
+ this.state === "run" ||
277
+ this.state === "block" ||
278
+ this.state === "push" ||
279
+ (this.state === "slash" && target !== undefined);
280
+ const gap = angleTo(this.yaw, goalYaw);
281
+ if (canTurn) {
282
+ // The 180° turn clock: armed when the stick asks for a reversal, stopped when she faces it.
283
+ if (target === undefined && Math.abs(gap) > 150 * DEG && this.#turnClock === undefined)
284
+ this.#turnClock = 0;
285
+ this.yaw += MathUtils.clamp(gap, -turnRate * dt, turnRate * dt);
286
+ }
287
+ if (this.#turnClock !== undefined) {
288
+ this.#turnClock += dt;
289
+ if (Math.abs(angleTo(this.yaw, goalYaw)) < 1e-4) {
290
+ this.turnSeconds = this.#turnClock;
291
+ this.#turnClock = undefined;
292
+ }
293
+ }
294
+
295
+ // Horizontal velocity per state.
296
+ const vx = body.velocity.x;
297
+ const vz = body.velocity.z;
298
+ let nx = vx;
299
+ let nz = vz;
300
+ const forward = this.forward;
301
+ switch (this.state) {
302
+ case "idle":
303
+ case "run":
304
+ case "push": {
305
+ // She plants and pivots rather than running a wide arc: speed follows how far she still
306
+ // has to turn, so a reversal turns on the spot and a right angle slows through the corner.
307
+ const facing = target === undefined ? Math.max(0, Math.cos(angleTo(this.yaw, goalYaw))) : 1;
308
+ const want = stick > 0.1 ? stick * runSpeed * facing : 0;
309
+ this.#speed = approach(this.#speed, want, feel.acceleration * dt);
310
+ if (target !== undefined) {
311
+ const wish = this.wish.lengthSq() > 1e-4 ? this.wish.clone().normalize() : this.wish;
312
+ nx = approach(vx, wish.x * runSpeed * Math.min(1, stick), feel.acceleration * dt);
313
+ nz = approach(vz, wish.z * runSpeed * Math.min(1, stick), feel.acceleration * dt);
314
+ } else {
315
+ nx = forward.x * this.#speed;
316
+ nz = forward.z * this.#speed;
317
+ }
318
+ if (this.state !== "push") this.state = Math.hypot(nx, nz) > 0.2 ? "run" : "idle";
319
+ break;
320
+ }
321
+ case "block":
322
+ case "slash":
323
+ this.#speed = approach(this.#speed, 0, feel.acceleration * dt);
324
+ nx = approach(vx, 0, feel.acceleration * dt);
325
+ nz = approach(vz, 0, feel.acceleration * dt);
326
+ break;
327
+ case "roll":
328
+ nx = forward.x * feel.rollSpeed;
329
+ nz = forward.z * feel.rollSpeed;
330
+ this.#speed = feel.rollSpeed;
331
+ if (this.#timer >= feel.rollTime) this.#end(runSpeed * 0.6);
332
+ break;
333
+ case "hop":
334
+ if (this.#timer > 0.1 && body.grounded) this.#end(0);
335
+ break;
336
+ case "hurt":
337
+ nx = this.#knock.x * (1 - this.#timer / feel.hurtTime);
338
+ nz = this.#knock.z * (1 - this.#timer / feel.hurtTime);
339
+ if (this.#timer >= feel.hurtTime) this.#end(0);
340
+ break;
341
+ case "dead":
342
+ nx = 0;
343
+ nz = 0;
344
+ break;
345
+ }
346
+ if (this.state !== "hop") {
347
+ body.velocity.x = nx;
348
+ body.velocity.z = nz;
349
+ }
350
+
351
+ // The slash: one shape query over the arc on each active frame, each target hit once.
352
+ if (this.state === "slash") {
353
+ const windup = feel.slashWindup;
354
+ const active = windup + feel.slashActive;
355
+ if (this.#timer >= windup && this.#timer < active) this.#strike(ctx, targets);
356
+ if (this.#timer >= active + feel.slashRecovery) this.#end(0);
357
+ }
358
+
359
+ body.moveAndSlide(dt);
360
+
361
+ // Measured feel, for the HUD-free playtests: top ground speed, release-to-stop time.
362
+ const ground = Math.hypot(body.velocity.x, body.velocity.z);
363
+ if (body.grounded && (this.state === "run" || this.state === "idle"))
364
+ this.topSpeed = Math.max(this.topSpeed, ground);
365
+ if (stick < 0.1 && ground > 0.5 && this.#stopClock === undefined && this.state === "run")
366
+ this.#stopClock = 0;
367
+ if (this.#stopClock !== undefined) {
368
+ this.#stopClock += dt;
369
+ if (ground < 0.05) {
370
+ this.stopSeconds = this.#stopClock;
371
+ this.#stopClock = undefined;
372
+ } else if (stick >= 0.1) this.#stopClock = undefined;
373
+ }
374
+
375
+ // The blade comes out for a fight (a lock, a cut, a block) and goes back 3 s after it; both
376
+ // hands go to the block while she pushes.
377
+ if (target !== undefined || this.state === "slash" || this.state === "block") this.#drawn = 3;
378
+ else this.#drawn = Math.max(0, this.#drawn - dt);
379
+ const drawn = this.hasSword && this.#drawn > 0 && this.state !== "push";
380
+ this.blade.visible = drawn;
381
+ this.#flash = Math.max(0, this.#flash - dt * 4);
382
+ this.rig.group.rotation.y = this.yaw;
383
+ this.#animate(dt, Math.hypot(body.velocity.x, body.velocity.z));
384
+ this.rig.update({
385
+ drawn,
386
+ dt,
387
+ flash: this.#flash,
388
+ progress: this.#progress(),
389
+ speed: Math.hypot(body.velocity.x, body.velocity.z),
390
+ state: this.state,
391
+ sword: this.hasSword,
392
+ });
393
+ }
394
+
395
+ /** Puts Wren into the pushing pose this step, or back out of it. */
396
+ setPushing(pushing: boolean): void {
397
+ if (pushing && (this.state === "idle" || this.state === "run")) this.state = "push";
398
+ else if (!pushing && this.state === "push") this.state = "idle";
399
+ }
400
+
401
+ /**
402
+ * A hostile's hit. The shield takes it when raised and the attacker is inside the front cone;
403
+ * otherwise it costs `halves` half-hearts. Returns what happened, for the attacker's reaction.
404
+ */
405
+ takeHit(halves: number, from: Vector3): "blocked" | "hit" | "ignored" {
406
+ if (this.state === "dead" || this.state === "roll" || this.#invulnerable > 0) return "ignored";
407
+ const toAttacker = new Vector3().subVectors(from, this.mesh.position).setY(0).normalize();
408
+ const facing = this.forward.dot(toAttacker);
409
+ if (this.state === "block" && facing >= Math.cos(ADVENTURE_FEEL.shieldCone / 2)) {
410
+ this.shieldBlocks += 1;
411
+ this.#flash = 1;
412
+ return "blocked";
413
+ }
414
+ this.health = Math.max(0, this.health - halves);
415
+ this.hitsTaken += 1;
416
+ this.#invulnerable = ADVENTURE_FEEL.invulnerableTime;
417
+ this.#knock.copy(toAttacker).multiplyScalar(-ADVENTURE_FEEL.knockback);
418
+ this.#begin(this.health <= 0 ? "dead" : "hurt");
419
+ return "hit";
420
+ }
421
+
422
+ heal(halves: number): void {
423
+ this.health = Math.min(this.capacity, this.health + halves);
424
+ }
425
+
426
+ /** True once the death pose has played: the scene respawns her. */
427
+ get readyToRespawn(): boolean {
428
+ return this.state === "dead" && this.#timer >= ADVENTURE_FEEL.deathTime;
429
+ }
430
+
431
+ respawn(at: Vector3, yaw: number): void {
432
+ this.health = this.capacity;
433
+ this.state = "idle";
434
+ this.#speed = 0;
435
+ this.yaw = yaw;
436
+ this.#invulnerable = ADVENTURE_FEEL.invulnerableTime;
437
+ this.teleport(at);
438
+ }
439
+
440
+ teleport(at: Vector3): void {
441
+ this.body?.teleport(at);
442
+ this.mesh.position.copy(at);
443
+ }
444
+
445
+ /** Blinks while invulnerable. */
446
+ get blinking(): boolean {
447
+ return (
448
+ this.#invulnerable > 0 &&
449
+ Math.floor(this.#invulnerable * 14) % 2 === 0 &&
450
+ this.state !== "dead"
451
+ );
452
+ }
453
+
454
+ debug(): Record<string, unknown> {
455
+ return {
456
+ feetY: this.mesh.position.y - FOOT_OFFSET,
457
+ grounded: this.body?.grounded ?? false,
458
+ health: this.health,
459
+ position: this.mesh.position.toArray(),
460
+ state: this.state,
461
+ stride: this.#strideReport(),
462
+ yawDegrees: Math.round(MathUtils.radToDeg(MathUtils.euclideanModulo(this.yaw, Math.PI * 2))),
463
+ };
464
+ }
465
+
466
+ dispose(): void {
467
+ this.#anim.dispose();
468
+ this.body?.dispose();
469
+ this.mesh.removeFromParent();
470
+ }
471
+
472
+ /**
473
+ * On her feet she blends idle, walk and run by ground speed; every other action holds the neutral
474
+ * idle pose that `render/hero.ts` bends procedurally.
475
+ */
476
+ #animate(dt: number, speed: number): void {
477
+ const afoot =
478
+ this.state !== "roll" &&
479
+ this.state !== "hop" &&
480
+ this.state !== "hurt" &&
481
+ this.state !== "dead";
482
+ const moving = afoot ? MathUtils.smoothstep(speed, 0.2, 0.8) : 0;
483
+ const running = MathUtils.smoothstep(speed, 1, 2.4);
484
+ this.#anim.playWeighted(
485
+ [
486
+ { clip: "idle", weight: 1 - moving },
487
+ { clip: "walk", weight: moving * (1 - running) },
488
+ { clip: "run", weight: moving * running },
489
+ ],
490
+ { transition: afoot ? 0.15 : 0.08 },
491
+ );
492
+ this.#anim.update(dt);
493
+ }
494
+
495
+ /** The stride report, and the foot speed it implies over the ground speed: 1 is no skating. */
496
+ #strideReport(): Record<string, unknown> {
497
+ const stride = this.#anim.stride;
498
+ const feet = stride.clipGroundSpeed * stride.rate;
499
+ const footRatio = stride.groundSpeed > 0.5 ? feet / stride.groundSpeed : 1;
500
+ return {
501
+ ...stride,
502
+ clip: this.#anim.current ?? "none",
503
+ footRatio,
504
+ inBand: Math.abs(footRatio - 1) <= 0.1,
505
+ };
506
+ }
507
+
508
+ #begin(state: HeroState): void {
509
+ this.state = state;
510
+ this.#timer = 0;
511
+ if (state === "slash") {
512
+ this.slashes += 1;
513
+ this.#hitThisSlash.clear();
514
+ }
515
+ }
516
+
517
+ #end(speed: number): void {
518
+ this.state = "idle";
519
+ this.#timer = 0;
520
+ this.#speed = speed;
521
+ }
522
+
523
+ #progress(): number {
524
+ const feel = ADVENTURE_FEEL;
525
+ if (this.state === "slash")
526
+ return this.#timer / (feel.slashWindup + feel.slashActive + feel.slashRecovery);
527
+ if (this.state === "roll") return this.#timer / feel.rollTime;
528
+ if (this.state === "hurt") return this.#timer / feel.hurtTime;
529
+ if (this.state === "dead") return this.#timer / feel.deathTime;
530
+ return 0;
531
+ }
532
+
533
+ #strike(ctx: GameCtx, targets: readonly ITarget[]): void {
534
+ const feel = ADVENTURE_FEEL;
535
+ const hits = ctx.physics.directSpaceState.intersectShape({
536
+ collisionMask: LAYER.foe,
537
+ maxResults: 8,
538
+ position: this.mesh.position,
539
+ shape: CollisionShape3D.sphere(feel.slashReach + 1),
540
+ });
541
+ const forward = this.forward;
542
+ for (const hit of hits) {
543
+ const target = targets.find((candidate) => candidate.bodyId === hit.body.id);
544
+ if (target === undefined || !target.alive || this.#hitThisSlash.has(target)) continue;
545
+ const to = new Vector3().subVectors(target.mesh.position, this.mesh.position).setY(0);
546
+ // The reach is measured to the target's surface, the arc from Wren's facing.
547
+ if (to.length() - target.radius > feel.slashReach) continue;
548
+ if (forward.dot(to.normalize()) < Math.cos(feel.slashArc / 2)) continue;
549
+ this.#hitThisSlash.add(target);
550
+ // Where the blade met it: its surface toward Wren, at her chest. The effects fire here.
551
+ this.strikeAt.copy(target.mesh.position).addScaledVector(to, -target.radius);
552
+ this.strikeAt.y = this.mesh.position.y + 0.35;
553
+ if (target.hurt(1, this.mesh.position)) this.slashHits += 1;
554
+ }
555
+ }
556
+ }
557
+
558
+ function approach(current: number, target: number, step: number): number {
559
+ const delta = target - current;
560
+ return Math.abs(delta) <= step ? target : current + Math.sign(delta) * step;
561
+ }