create-threenative 0.2.9 → 0.2.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +229 -36
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +17 -11
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +16 -10
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +17 -11
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +17 -11
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +17 -11
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +76 -5
  420. package/templates/racing/src/scenes/Race.ts +53 -42
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +16 -10
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +16 -10
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +17 -11
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +17 -11
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +17 -11
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +17 -11
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +17 -11
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +56 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +53 -34
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +17 -11
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -0,0 +1,915 @@
1
+ import { AnimationPlayer, type ICtx } from "@threenative/core";
2
+ import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
+ import { Group, MathUtils, Vector3 } from "three";
4
+ import { type IHero, createHero } from "../render/hero.js";
5
+ import type { ITouchInput } from "../render/touch-layout.js";
6
+ import type { GameState } from "../state.js";
7
+
8
+ export type GameCtx = ICtx<GameState, IPhysicsContext>;
9
+
10
+ /**
11
+ * The capsule, and so how far the rig's feet sit below the body origin. A `CollisionShape3D`
12
+ * capsule is centred on the body's origin — the hero's waist — so the rig is pushed down by
13
+ * `halfHeight + radius` or the hero floats a body-length above everything it lands on.
14
+ */
15
+ const CAPSULE = { halfHeight: 0.45, radius: 0.35 } as const;
16
+ export const FOOT_OFFSET = CAPSULE.halfHeight + CAPSULE.radius;
17
+ /** The physics layer of the static world. Probes scan only it, so they never hit the hero. */
18
+ export const WORLD_LAYER = 1;
19
+ const HERO_LAYER = 2;
20
+
21
+ /**
22
+ * The whole feel, in metres and seconds, from the 30 Hz reference (1 unit = 1 cm: units/frame
23
+ * × 0.3 = m/s, units/frame² × 9 = m/s²). The course is laid out from this table, never the other
24
+ * way round: change a number here and the gaps in `level/Course.ts` change their meaning.
25
+ */
26
+ export const HERO_FEEL = {
27
+ /** Target ground speed at full stick, and the speed nothing but a long jump or dive exceeds. */
28
+ runCap: 9.6,
29
+ hardCap: 14.4,
30
+ /** Ground acceleration toward the stick target: `runAccel - runDrag · speed` m/s². */
31
+ runAccel: 9.9,
32
+ runDrag: 0.7,
33
+ /** Slowing down to a lower target. */
34
+ overspeedDecel: 9,
35
+ /** Stopping with the stick released (kit value: the reference's coast is longer). */
36
+ stopDecel: 18,
37
+ /** Face yaw approaches the stick yaw at this rate, rad/s (337.5 °/s). */
38
+ turnRate: (337.5 * Math.PI) / 180,
39
+ /** A stick this far from the facing, at speed, is a turn-around skid. */
40
+ skidAngle: (100 * Math.PI) / 180,
41
+ skidMinSpeed: 4.8,
42
+ skidDecel: 36,
43
+ gravity: 36,
44
+ terminalFall: 22.5,
45
+ /** Letting go of jump while still rising faster than this cuts the rise to a quarter. */
46
+ jumpCutSpeed: 6,
47
+ jumpCutFactor: 0.25,
48
+ jumpSpeed: 12.6,
49
+ /** Each running jump adds this share of forward speed to its rise, and keeps 0.8 of it. */
50
+ jumpForwardLift: 0.25,
51
+ jumpForwardKeep: 0.8,
52
+ doubleJumpSpeed: 15.6,
53
+ tripleJumpSpeed: 20.7,
54
+ tripleMinSpeed: 6,
55
+ /**
56
+ * A landing from a single jump, a fall or a side flip opens a double jump, and a landing from a
57
+ * double opens a triple, for this long: the classic's 4 landing frames plus its 5-frame
58
+ * double-jump timer at 30 Hz (sm64 decomp, mario_actions_moving.c:26-52 and :1767,
59
+ * mario.c:1030-1065 and :1411).
60
+ */
61
+ chainWindow: 0.3,
62
+ /**
63
+ * A jump pressed this long before touchdown counts as pressed on landing, so a double tap that
64
+ * comes a little early still chains. The classic has no such buffer: a press before touchdown
65
+ * was simply lost, which is the miss players remember.
66
+ */
67
+ jumpBuffer: 0.12,
68
+ /**
69
+ * The air double jump, the owner's addition to the classic chain (2026-10-24): a second press
70
+ * this long after take-off, from a single jump, a walk-off fall or a wall kick, rises again at
71
+ * `jumpSpeed`. One per flight, back on a landing, a wall kick or a ledge grab. A press the
72
+ * buffer would carry to touchdown stays the chain's.
73
+ */
74
+ airJumpGuard: 0.1,
75
+ backflipSpeed: 18.6,
76
+ backflipBack: 4.8,
77
+ sideflipSpeed: 18.6,
78
+ sideflipForward: 2.4,
79
+ /** Crouch at speed starts a slide; jump inside the window at speed is a long jump. */
80
+ crouchSlideMinSpeed: 3,
81
+ crouchSlideDecel: 6,
82
+ longJumpWindow: 0.5,
83
+ longJumpSpeed: 9,
84
+ longJumpScale: 1.5,
85
+ longJumpGravity: 18,
86
+ /** A wall hit above this speed bounces the hero off and opens the wall-kick window. */
87
+ wallBonkSpeed: 4.8,
88
+ wallKickWindow: 0.167,
89
+ wallKickSpeed: 18.6,
90
+ wallKickForward: 7.2,
91
+ diveBoost: 4.5,
92
+ diveMinSpeed: 4.8,
93
+ diveHop: 4.5,
94
+ diveSlideDecel: 9,
95
+ poundHang: 0.25,
96
+ poundSpeed: 15,
97
+ poundRecover: 0.3,
98
+ /** Air steering acceleration; the hero cannot steer past `runCap` in the air. */
99
+ airAccel: 13.5,
100
+ /** The ledge probe: 0.6 m past the wall, from 1.6 m above the feet down to 1.0 m above them. */
101
+ ledgeAhead: 0.6,
102
+ ledgeTop: 1.6,
103
+ ledgeBottom: 1.0,
104
+ /** Hang time before a forward press climbs, so the grab reads before the climb. */
105
+ ledgeHangMin: 0.25,
106
+ ledgeClimbTime: 0.3,
107
+ /** Below this the hero has fallen into the sea and the checkpoint takes over. */
108
+ killPlane: -6,
109
+ } as const;
110
+
111
+ export type HeroAction =
112
+ | "idle"
113
+ | "run"
114
+ | "skid"
115
+ | "crouch"
116
+ | "crouchSlide"
117
+ | "diveSlide"
118
+ | "poundLand"
119
+ | "single"
120
+ | "double"
121
+ | "triple"
122
+ | "backflip"
123
+ | "sideflip"
124
+ | "longJump"
125
+ | "wallKick"
126
+ | "dive"
127
+ | "groundPound"
128
+ | "fall"
129
+ | "ledgeHang"
130
+ | "ledgeClimb";
131
+
132
+ const GROUND: ReadonlySet<HeroAction> = new Set([
133
+ "idle",
134
+ "run",
135
+ "skid",
136
+ "crouch",
137
+ "crouchSlide",
138
+ "diveSlide",
139
+ "poundLand",
140
+ ]);
141
+ /** Airborne actions a wall can stop and a ledge can catch. */
142
+ const WALL_AIR: ReadonlySet<HeroAction> = new Set([
143
+ "single",
144
+ "double",
145
+ "triple",
146
+ "backflip",
147
+ "sideflip",
148
+ "longJump",
149
+ "wallKick",
150
+ "fall",
151
+ ]);
152
+ /** Airborne actions a second press turns into the air double jump. */
153
+ const AIR_JUMP: ReadonlySet<HeroAction> = new Set(["single", "fall", "wallKick"]);
154
+ /** Dev builds log every jump press and its touchdown as `TN_HERO_INPUT`. */
155
+ const DEV = (import.meta as unknown as { env?: { DEV?: boolean } }).env?.DEV === true;
156
+ /** Jumps whose rise the jump button controls. */
157
+ const VARIABLE: ReadonlySet<HeroAction> = new Set(["single", "double"]);
158
+ /** Jumps a scenario measures: apex above take-off and ground distance along the take-off facing. */
159
+ const MEASURED = ["single", "double", "triple", "backflip", "sideflip", "longJump", "wallKick"];
160
+
161
+ export interface IWallHit {
162
+ readonly x: number;
163
+ readonly y: number;
164
+ readonly z: number;
165
+ readonly nx: number;
166
+ readonly nz: number;
167
+ }
168
+
169
+ /** A ray against the static world: the hit point and normal, or undefined. */
170
+ export type WorldRay = (
171
+ from: Vector3,
172
+ to: Vector3,
173
+ ) => { position: Vector3; normal: Vector3 } | undefined;
174
+
175
+ const _from = new Vector3();
176
+ const _to = new Vector3();
177
+
178
+ /** The nearest wall one probe height found, its unit normal flattened to the ground. */
179
+ interface IWallProbe {
180
+ found: boolean;
181
+ x: number;
182
+ y: number;
183
+ z: number;
184
+ nx: number;
185
+ nz: number;
186
+ }
187
+ const _lower: IWallProbe = { found: false, nx: 0, nz: 0, x: 0, y: 0, z: 0 };
188
+ const _upper: IWallProbe = { found: false, nx: 0, nz: 0, x: 0, y: 0, z: 0 };
189
+ /** The wall probe's rays: along the travel and 45° to either side of it. */
190
+ const WALL_FAN = [0, Math.PI / 4, -Math.PI / 4] as const;
191
+
192
+ function forwardOf(yaw: number, target: Vector3): Vector3 {
193
+ return target.set(-Math.sin(yaw), 0, -Math.cos(yaw));
194
+ }
195
+
196
+ function angleTo(from: number, to: number): number {
197
+ return MathUtils.euclideanModulo(to - from + Math.PI, Math.PI * 2) - Math.PI;
198
+ }
199
+
200
+ /**
201
+ * Pip, the hero: one action state machine on a `CharacterBody3D`, driven by a camera-relative
202
+ * stick and three buttons (jump, crouch, attack). Ground motion is a speed along the facing, as in
203
+ * the reference; air motion is a horizontal velocity the stick nudges. The wall and ledge are found
204
+ * with rays against the static world, because `moveAndSlide` reports the floor and not the wall.
205
+ */
206
+ export class Hero {
207
+ /** The body object. Its origin is the hero's waist, because that is what a capsule is centred on. */
208
+ readonly mesh: Group;
209
+ readonly body: CharacterBody3D;
210
+ readonly rig: IHero;
211
+ readonly tags = ["player"];
212
+ action: HeroAction = "idle";
213
+ yaw = 0;
214
+ landings = 0;
215
+ wallHits = 0;
216
+ /** Ground speed along `yaw`. */
217
+ #speed = 0;
218
+ readonly #air = new Vector3();
219
+ #actionTime = 0;
220
+ #chainStage = 0;
221
+ #chainTimer = 0;
222
+ #jumpBuffer = 0;
223
+ #airJumpReady = true;
224
+ /** Seconds off the ground, and when in this flight jump was last pressed (-1: not yet). */
225
+ #airTime = 0;
226
+ #pressedAt = -1;
227
+ #wallTimer = 0;
228
+ #wallKickRise = 0;
229
+ #wallKickFrom = 0;
230
+ readonly #wall: { nx: number; nz: number } = { nx: 0, nz: 0 };
231
+ readonly #ledge = new Vector3();
232
+ #cut = false;
233
+ #groundY = 0;
234
+ readonly #takeoff = new Vector3();
235
+ #takeoffYaw = 0;
236
+ #takeoffSpeed = 0;
237
+ #peak = 0;
238
+ #airKind: HeroAction = "fall";
239
+ #stickYaw = 0;
240
+ readonly #counts: Record<string, number> = {};
241
+ readonly #apex: Record<string, number> = {};
242
+ readonly #distance: Record<string, number> = {};
243
+ readonly #takeoffSpeeds: Record<string, number> = {};
244
+ #sideflipFacingError = 0;
245
+ #wallKicks = 0;
246
+ #ledgeGrabs = 0;
247
+ #pounds = 0;
248
+ readonly #ray: WorldRay;
249
+ readonly #intended = new Vector3();
250
+ readonly #scratch = new Vector3();
251
+ readonly #anim: AnimationPlayer;
252
+ /** Metres the planted sole slid over the ground while running, and the seconds it was planted. */
253
+ #slid = 0;
254
+ #plantedTime = 0;
255
+ #planted = -1;
256
+ readonly #sole = new Vector3();
257
+ /** Seconds the hero is still invulnerable after a hit. */
258
+ hurtTimer = 0;
259
+
260
+ constructor(ctx: GameCtx, spawn: Vector3, ray: WorldRay) {
261
+ this.#ray = ray;
262
+ this.rig = createHero();
263
+ this.mesh = new Group();
264
+ this.mesh.add(this.rig.group);
265
+ this.rig.group.position.y = -FOOT_OFFSET;
266
+ this.mesh.position.copy(spawn);
267
+ this.#groundY = spawn.y - FOOT_OFFSET;
268
+ ctx.add(this.mesh);
269
+ // `strideRoot` is the body: the walk and run play at the rate the ground it covers asks for.
270
+ this.#anim = new AnimationPlayer({
271
+ clips: this.rig.clips,
272
+ root: this.rig.group,
273
+ strideRoot: this.mesh,
274
+ });
275
+ this.body = new CharacterBody3D({
276
+ autostep: { maxHeight: 0.3, minWidth: 0.2 },
277
+ collisionLayer: HERO_LAYER,
278
+ collisionMask: 0xffff,
279
+ entity: "player",
280
+ gravity: -HERO_FEEL.gravity,
281
+ maxFallSpeed: HERO_FEEL.terminalFall,
282
+ object: this.mesh,
283
+ physics: ctx.physics,
284
+ shape: CollisionShape3D.capsule(CAPSULE.halfHeight, CAPSULE.radius),
285
+ snapToGround: 0.3,
286
+ });
287
+ }
288
+
289
+ get grounded(): boolean {
290
+ return GROUND.has(this.action);
291
+ }
292
+
293
+ /** The height of the last surface the hero stood on, at its feet. */
294
+ get groundY(): number {
295
+ return this.#groundY;
296
+ }
297
+
298
+ get speed(): number {
299
+ return this.grounded ? Math.abs(this.#speed) : Math.hypot(this.#air.x, this.#air.z);
300
+ }
301
+
302
+ /** Puts the hero at `position` facing `yaw`, standing still. */
303
+ teleport(position: Vector3, yaw: number): void {
304
+ this.body.teleport(position);
305
+ this.mesh.quaternion.identity();
306
+ this.yaw = yaw;
307
+ this.#speed = 0;
308
+ this.#air.set(0, 0, 0);
309
+ this.#groundY = position.y - FOOT_OFFSET;
310
+ this.#enter("fall");
311
+ }
312
+
313
+ /** A stomp's rebound: a fresh single-jump rise with no chain. */
314
+ bounce(): void {
315
+ this.#launch("single", HERO_FEEL.jumpSpeed, this.speed);
316
+ this.#cut = true;
317
+ }
318
+
319
+ /** A walker hit: knocked back off `from`, and briefly unhittable. */
320
+ knockBack(from: Vector3): void {
321
+ const away = this.#scratch.subVectors(this.mesh.position, from).setY(0);
322
+ if (away.lengthSq() < 1e-6) forwardOf(this.yaw, away).negate();
323
+ away.normalize().multiplyScalar(6);
324
+ this.#launch("fall", 7, 0);
325
+ this.#air.set(away.x, 0, away.z);
326
+ this.hurtTimer = 1.5;
327
+ }
328
+
329
+ update(ctx: GameCtx, dt: number, cameraYaw: number, touch?: ITouchInput): void {
330
+ const input = ctx.input;
331
+ const move = input.vector("move");
332
+ let stickX = move.x;
333
+ let stickY = move.y;
334
+ if (touch !== undefined) {
335
+ stickX += touch.move.x;
336
+ stickY += touch.move.y;
337
+ }
338
+ // Camera-relative: up on the stick is the direction the camera looks along the ground.
339
+ const forward = forwardOf(cameraYaw, this.#scratch);
340
+ this.#intended.set(
341
+ forward.x * stickY - forward.z * stickX,
342
+ 0,
343
+ forward.z * stickY + forward.x * stickX,
344
+ );
345
+ const magnitude = Math.min(1, this.#intended.length());
346
+ if (magnitude > 0.05) this.#stickYaw = Math.atan2(-this.#intended.x, -this.#intended.z);
347
+ const jumpPressed = input.justPressed("jump") || touch?.jumpPressed === true;
348
+ this.#jumpBuffer = jumpPressed ? HERO_FEEL.jumpBuffer : Math.max(0, this.#jumpBuffer - dt);
349
+ const jumpHeld = input.pressed("jump") || touch?.jumpHeld === true;
350
+ const crouchPressed = input.justPressed("crouch") || touch?.crouchPressed === true;
351
+ const crouchHeld = input.pressed("crouch") || touch?.crouchHeld === true;
352
+ const attackPressed = input.justPressed("attack") || touch?.attackPressed === true;
353
+
354
+ this.#actionTime += dt;
355
+ this.#chainTimer = Math.max(0, this.#chainTimer - dt);
356
+ this.#wallTimer = Math.max(0, this.#wallTimer - dt);
357
+ this.hurtTimer = Math.max(0, this.hurtTimer - dt);
358
+ const grounded = this.body.grounded;
359
+ const was = this.action;
360
+ this.#airTime = GROUND.has(was) ? 0 : this.#airTime + dt;
361
+
362
+ if (this.action === "ledgeHang" || this.action === "ledgeClimb") {
363
+ this.#ledgeStep(magnitude, jumpPressed, crouchPressed);
364
+ } else if (GROUND.has(this.action)) {
365
+ if (!grounded) this.#leaveGround();
366
+ else {
367
+ // A press buffered in the air fires on the first grounded step.
368
+ const jump = jumpPressed || this.#jumpBuffer > 0;
369
+ this.#groundStep(dt, magnitude, jump, crouchPressed, crouchHeld, attackPressed);
370
+ }
371
+ } else {
372
+ if (grounded && this.body.velocity.y <= 0) {
373
+ if (DEV && this.#pressedAt >= 0)
374
+ console.info(
375
+ `TN_HERO_INPUT land airborne=${this.#airTime.toFixed(2)} sincePress=${(this.#airTime - this.#pressedAt).toFixed(2)}`,
376
+ );
377
+ this.#land();
378
+ } else this.#airStep(dt, magnitude, jumpPressed, jumpHeld, crouchPressed, attackPressed);
379
+ }
380
+ if (jumpPressed) {
381
+ this.#pressedAt = GROUND.has(was) ? -1 : this.#airTime;
382
+ if (DEV)
383
+ console.info(
384
+ `TN_HERO_INPUT press airborne=${this.#airTime.toFixed(2)} from=${was} to=${this.action} buffered=${this.#jumpBuffer > 0}`,
385
+ );
386
+ }
387
+
388
+ if (GROUND.has(this.action)) {
389
+ forwardOf(this.yaw, this.#scratch);
390
+ this.body.velocity.x = this.#scratch.x * this.#speed;
391
+ this.body.velocity.z = this.#scratch.z * this.#speed;
392
+ this.#groundY = this.mesh.position.y - FOOT_OFFSET;
393
+ } else if (this.action !== "ledgeHang" && this.action !== "ledgeClimb") {
394
+ this.body.velocity.x = this.#air.x;
395
+ this.body.velocity.z = this.#air.z;
396
+ this.#peak = Math.max(this.#peak, this.mesh.position.y);
397
+ }
398
+ this.body.moveAndSlide(dt);
399
+ this.rig.group.rotation.y = MathUtils.damp(
400
+ this.rig.group.rotation.y,
401
+ this.rig.group.rotation.y + angleTo(this.rig.group.rotation.y, this.yaw),
402
+ 20,
403
+ dt,
404
+ );
405
+ this.#animate(dt);
406
+ this.rig.update({
407
+ action: this.action,
408
+ actionTime: this.#actionTime,
409
+ drop: this.grounded ? 0 : Math.max(0, this.mesh.position.y - FOOT_OFFSET - this.#groundY),
410
+ dt,
411
+ speed: this.speed,
412
+ vy: this.body.velocity.y,
413
+ });
414
+ this.#measureSkate(dt);
415
+ }
416
+
417
+ /**
418
+ * A sole within 10 cm of the feet line is planted; the ground it covers over consecutive planted
419
+ * frames is how far it slid. Zero means the run cycle matches the ground the body covers.
420
+ */
421
+ #measureSkate(dt: number): void {
422
+ const feet = this.mesh.position.y - FOOT_OFFSET;
423
+ let planted = -1;
424
+ this.rig.soles.forEach((sole, i) => {
425
+ if (planted < 0 && sole.getWorldPosition(_to).y - feet < 0.1) planted = i;
426
+ });
427
+ if (this.action !== "run" || this.#speed < 5.5 || planted < 0 || dt <= 0) {
428
+ this.#planted = -1;
429
+ return;
430
+ }
431
+ if (planted === this.#planted) {
432
+ this.#slid += Math.hypot(_to.x - this.#sole.x, _to.z - this.#sole.z);
433
+ this.#plantedTime += dt;
434
+ }
435
+ this.#planted = planted;
436
+ this.#sole.copy(_to);
437
+ }
438
+
439
+ /** The chain jump a press would fire now: 1 a double, 2 a triple, 0 none. */
440
+ get chain(): number {
441
+ return this.#chainTimer > 0 ? this.#chainStage : 0;
442
+ }
443
+
444
+ debug(): Record<string, unknown> {
445
+ return {
446
+ action: this.action,
447
+ chain: this.chain,
448
+ apex: { ...this.#apex },
449
+ counts: { ...this.#counts },
450
+ distance: { ...this.#distance },
451
+ groundY: this.#groundY,
452
+ grounded: this.grounded,
453
+ landings: this.landings,
454
+ ledgeGrabs: this.#ledgeGrabs,
455
+ pounds: this.#pounds,
456
+ position: this.mesh.position.toArray(),
457
+ sideflipFacingError: this.#sideflipFacingError,
458
+ speed: this.speed,
459
+ stride: this.#strideReport(),
460
+ takeoffSpeed: { ...this.#takeoffSpeeds },
461
+ velocity: this.body.velocity.toArray(),
462
+ wallHits: this.wallHits,
463
+ wallKickRise: this.#wallKickRise,
464
+ wallKicks: this.#wallKicks,
465
+ yaw: this.yaw,
466
+ };
467
+ }
468
+
469
+ dispose(): void {
470
+ this.#anim.dispose();
471
+ this.body.dispose();
472
+ this.mesh.removeFromParent();
473
+ }
474
+
475
+ /**
476
+ * Standing and running blend idle, walk and run by ground speed; every other action holds the
477
+ * neutral "air" pose that `render/hero.ts` bends procedurally.
478
+ */
479
+ #animate(dt: number): void {
480
+ if (this.action === "idle" || this.action === "run") {
481
+ const speed = Math.abs(this.#speed);
482
+ const moving = MathUtils.smoothstep(speed, 0.2, 1);
483
+ // A walk plants each foot for half its cycle and a run for 15%, so a blend of the two drags
484
+ // the planted foot: the hand-over is kept short, done by 4 m/s.
485
+ const running = MathUtils.smoothstep(speed, 1.5, 4);
486
+ this.#anim.playWeighted(
487
+ [
488
+ { clip: "idle", weight: 1 - moving },
489
+ { clip: "walk", weight: moving * (1 - running) },
490
+ { clip: "run", weight: moving * running },
491
+ ],
492
+ { transition: 0.15 },
493
+ );
494
+ } else this.#anim.playWeighted([{ clip: "air", weight: 1 }], { transition: 0.08 });
495
+ this.#anim.update(dt);
496
+ }
497
+
498
+ /** The stride report, and the foot speed it implies over the ground speed: 1 is no skating. */
499
+ #strideReport(): Record<string, unknown> {
500
+ const stride = this.#anim.stride;
501
+ const feet = stride.clipGroundSpeed * stride.rate;
502
+ const footRatio = stride.groundSpeed > 0.5 ? feet / stride.groundSpeed : 1;
503
+ return {
504
+ ...stride,
505
+ clip: this.#anim.current ?? "none",
506
+ footRatio,
507
+ skate: this.#plantedTime > 0 ? this.#slid / this.#plantedTime : 0,
508
+ plantedTime: this.#plantedTime,
509
+ inBand: Math.abs(footRatio - 1) <= 0.1,
510
+ };
511
+ }
512
+
513
+ #enter(action: HeroAction): void {
514
+ this.action = action;
515
+ this.#actionTime = 0;
516
+ this.body.gravity = -(action === "longJump" ? HERO_FEEL.longJumpGravity : HERO_FEEL.gravity);
517
+ }
518
+
519
+ /**
520
+ * Leaves the ground as `action` with vertical speed `vy` and `forward` m/s along the facing,
521
+ * counted under `count`.
522
+ */
523
+ #launch(action: HeroAction, vy: number, forward: number, count: string = action): void {
524
+ this.#enter(action);
525
+ forwardOf(this.yaw, this.#air).multiplyScalar(forward);
526
+ this.body.velocity.y = vy;
527
+ this.#cut = false;
528
+ // An air double jump ends the wall kick's flight before any landing records its rise.
529
+ if (this.#airKind === "wallKick") this.#wallKickRise = this.#peak - this.#wallKickFrom;
530
+ this.#airKind = action;
531
+ this.#takeoff.copy(this.mesh.position);
532
+ this.#takeoffYaw = this.yaw;
533
+ this.#takeoffSpeed = this.speed;
534
+ this.#peak = this.mesh.position.y;
535
+ this.#counts[count] = (this.#counts[count] ?? 0) + 1;
536
+ }
537
+
538
+ #groundStep(
539
+ dt: number,
540
+ magnitude: number,
541
+ jumpPressed: boolean,
542
+ crouchPressed: boolean,
543
+ crouchHeld: boolean,
544
+ attackPressed: boolean,
545
+ ): void {
546
+ const feel = HERO_FEEL;
547
+ if (this.action === "poundLand") {
548
+ this.#speed = 0;
549
+ if (this.#actionTime >= feel.poundRecover) this.#enter("idle");
550
+ return;
551
+ }
552
+ if (jumpPressed && this.action !== "diveSlide") {
553
+ this.#jumpFromGround(magnitude);
554
+ return;
555
+ }
556
+ if (attackPressed && this.#speed >= feel.diveMinSpeed) {
557
+ this.#launch("dive", feel.diveHop, Math.min(feel.hardCap, this.#speed + feel.diveBoost));
558
+ return;
559
+ }
560
+ switch (this.action) {
561
+ case "diveSlide":
562
+ this.#speed = Math.max(0, this.#speed - feel.diveSlideDecel * dt);
563
+ if (this.#speed === 0) this.#enter("idle");
564
+ return;
565
+ case "crouchSlide":
566
+ this.#speed = Math.max(0, this.#speed - feel.crouchSlideDecel * dt);
567
+ if (this.#speed === 0 || !crouchHeld) this.#enter(crouchHeld ? "crouch" : "idle");
568
+ return;
569
+ case "crouch":
570
+ this.#speed = Math.max(0, this.#speed - feel.stopDecel * dt);
571
+ if (!crouchHeld) this.#enter("idle");
572
+ return;
573
+ case "skid":
574
+ this.#speed = Math.max(0, this.#speed - feel.skidDecel * dt);
575
+ if (this.#speed === 0) {
576
+ this.yaw = this.#stickYaw;
577
+ this.#enter("run");
578
+ }
579
+ return;
580
+ default:
581
+ break;
582
+ }
583
+ if (crouchPressed || crouchHeld) {
584
+ this.#enter(this.#speed >= feel.crouchSlideMinSpeed ? "crouchSlide" : "crouch");
585
+ return;
586
+ }
587
+ if (magnitude > 0.05) {
588
+ const turn = angleTo(this.yaw, this.#stickYaw);
589
+ if (this.#speed < 0.5) this.yaw = this.#stickYaw;
590
+ else if (Math.abs(turn) > feel.skidAngle && this.#speed >= feel.skidMinSpeed) {
591
+ this.#enter("skid");
592
+ return;
593
+ } else this.yaw += MathUtils.clamp(turn, -feel.turnRate * dt, feel.turnRate * dt);
594
+ const target = magnitude * feel.runCap;
595
+ if (this.#speed <= target)
596
+ this.#speed = Math.min(
597
+ target,
598
+ this.#speed + (feel.runAccel - feel.runDrag * this.#speed) * dt,
599
+ );
600
+ else this.#speed = Math.max(target, this.#speed - feel.overspeedDecel * dt);
601
+ if (this.action !== "run") this.#enter("run");
602
+ } else {
603
+ this.#speed = Math.max(0, this.#speed - feel.stopDecel * dt);
604
+ if (this.#speed === 0 && this.action !== "idle") this.#enter("idle");
605
+ }
606
+ }
607
+
608
+ #jumpFromGround(magnitude: number): void {
609
+ const feel = HERO_FEEL;
610
+ const speed = this.#speed;
611
+ if (this.action === "skid") {
612
+ this.yaw = this.#stickYaw;
613
+ this.#launch("sideflip", feel.sideflipSpeed, feel.sideflipForward);
614
+ return;
615
+ }
616
+ if (this.action === "crouchSlide") {
617
+ if (this.#actionTime <= feel.longJumpWindow && speed >= feel.crouchSlideMinSpeed) {
618
+ this.#launch(
619
+ "longJump",
620
+ feel.longJumpSpeed,
621
+ Math.min(feel.hardCap, speed * feel.longJumpScale),
622
+ );
623
+ return;
624
+ }
625
+ } else if (this.action === "crouch") {
626
+ this.#launch("backflip", feel.backflipSpeed, -feel.backflipBack);
627
+ return;
628
+ }
629
+ if (magnitude > 0.05 && speed < 0.5) this.yaw = this.#stickYaw;
630
+ const chained = this.#chainTimer > 0;
631
+ const lift = feel.jumpForwardLift * speed;
632
+ const forward = speed * feel.jumpForwardKeep;
633
+ if (chained && this.#chainStage === 2 && speed > feel.tripleMinSpeed)
634
+ this.#launch("triple", feel.tripleJumpSpeed, forward);
635
+ else if (chained && this.#chainStage === 1)
636
+ this.#launch("double", feel.doubleJumpSpeed + lift, forward);
637
+ else this.#launch("single", feel.jumpSpeed + lift, forward);
638
+ this.#chainTimer = 0;
639
+ this.#jumpBuffer = 0;
640
+ }
641
+
642
+ #leaveGround(): void {
643
+ // Walked off an edge: a fall that keeps the ground speed as air speed.
644
+ forwardOf(this.yaw, this.#air).multiplyScalar(this.#speed);
645
+ this.#enter("fall");
646
+ this.#airKind = "fall";
647
+ this.#peak = this.mesh.position.y;
648
+ }
649
+
650
+ #airStep(
651
+ dt: number,
652
+ magnitude: number,
653
+ jumpPressed: boolean,
654
+ jumpHeld: boolean,
655
+ crouchPressed: boolean,
656
+ attackPressed: boolean,
657
+ ): void {
658
+ const feel = HERO_FEEL;
659
+ const vy = this.body.velocity.y;
660
+ if (VARIABLE.has(this.action) && !this.#cut && !jumpHeld && vy > feel.jumpCutSpeed) {
661
+ this.body.velocity.y = vy * feel.jumpCutFactor;
662
+ this.#cut = true;
663
+ }
664
+ if (this.action === "groundPound") {
665
+ this.#air.set(0, 0, 0);
666
+ this.body.gravity = 0;
667
+ this.body.velocity.y = this.#actionTime < feel.poundHang ? 0 : -feel.poundSpeed;
668
+ return;
669
+ }
670
+ // A press at the wall is a kick, always: one made just before the contact waits in the buffer
671
+ // for the window, and the air double yields to it while a wall is in reach.
672
+ if ((jumpPressed || this.#jumpBuffer > 0) && this.#wallTimer > 0) {
673
+ this.#jumpBuffer = 0;
674
+ this.#wallKick();
675
+ return;
676
+ }
677
+ if (
678
+ jumpPressed &&
679
+ this.#airJumpReady &&
680
+ AIR_JUMP.has(this.action) &&
681
+ this.#actionTime >= feel.airJumpGuard &&
682
+ !this.#landingSoon() &&
683
+ !this.#wallAhead()
684
+ ) {
685
+ // The air double keeps the air speed: `#launch` would aim it along the facing.
686
+ const { x, z } = this.#air;
687
+ this.#launch("double", feel.jumpSpeed, 0, "airDouble");
688
+ this.#air.set(x, 0, z);
689
+ this.#airJumpReady = false;
690
+ this.#jumpBuffer = 0;
691
+ return;
692
+ }
693
+ if (crouchPressed && this.action !== "dive") {
694
+ this.#enter("groundPound");
695
+ this.#airKind = "groundPound";
696
+ this.#air.set(0, 0, 0);
697
+ return;
698
+ }
699
+ if (attackPressed && this.action !== "dive" && this.speed >= feel.diveMinSpeed * 0.5) {
700
+ const speed = Math.min(feel.hardCap, this.speed + feel.diveBoost);
701
+ this.#enter("dive");
702
+ this.#airKind = "dive";
703
+ this.#counts.dive = (this.#counts.dive ?? 0) + 1;
704
+ forwardOf(this.yaw, this.#air).multiplyScalar(speed);
705
+ return;
706
+ }
707
+ // Air steering: the stick nudges the horizontal velocity, never past the run cap.
708
+ if (magnitude > 0.05 && this.#wallTimer === 0) {
709
+ const before = Math.hypot(this.#air.x, this.#air.z);
710
+ this.#air.addScaledVector(this.#intended, (feel.airAccel * dt) / Math.max(1, magnitude));
711
+ const after = Math.hypot(this.#air.x, this.#air.z);
712
+ const cap = Math.max(before, feel.runCap);
713
+ if (after > cap) this.#air.multiplyScalar(cap / after);
714
+ }
715
+ if (WALL_AIR.has(this.action)) this.#probeWall();
716
+ }
717
+
718
+ /**
719
+ * Falling onto ground within the drop the jump buffer covers: a press now lands as the chain's
720
+ * buffered jump, not as the air double jump.
721
+ */
722
+ #landingSoon(): boolean {
723
+ const vy = this.body.velocity.y;
724
+ if (vy >= 0) return false;
725
+ const t = HERO_FEEL.jumpBuffer;
726
+ const drop = -vy * t + 0.5 * HERO_FEEL.gravity * t * t;
727
+ const feet = this.mesh.position.y - FOOT_OFFSET;
728
+ _from.set(this.mesh.position.x, feet + 0.05, this.mesh.position.z);
729
+ _to.set(_from.x, feet - drop, _from.z);
730
+ const ground = this.#ray(_from, _to);
731
+ return ground !== undefined && ground.normal.y > 0.7;
732
+ }
733
+
734
+ /**
735
+ * A wall the hero will bonk within the jump buffer: met at the upper check inside the distance
736
+ * the buffer covers, fast enough into it to open the kick window.
737
+ */
738
+ #wallAhead(): boolean {
739
+ const reach = Math.hypot(this.#air.x, this.#air.z) * HERO_FEEL.jumpBuffer;
740
+ if (!this.#wallAt(1.5, _upper, CAPSULE.radius + 0.2 + reach)) return false;
741
+ return -(this.#air.x * _upper.nx + this.#air.z * _upper.nz) >= HERO_FEEL.wallBonkSpeed;
742
+ }
743
+
744
+ /**
745
+ * The nearest wall `height` above the feet, on a fan of three rays (the travel and 45° either
746
+ * side), into `out`. The fan stands in for the reference's round wall check, so a wall met at an
747
+ * angle is found too; one ray along the travel missed it.
748
+ */
749
+ #wallAt(height: number, out: IWallProbe, reach = CAPSULE.radius + 0.2): boolean {
750
+ const speed = Math.hypot(this.#air.x, this.#air.z);
751
+ const direction = this.#scratch;
752
+ if (speed > 0.3) direction.set(this.#air.x / speed, 0, this.#air.z / speed);
753
+ else forwardOf(this.yaw, direction);
754
+ const centre = this.mesh.position;
755
+ let best = Number.POSITIVE_INFINITY;
756
+ out.found = false;
757
+ for (const turn of WALL_FAN) {
758
+ const c = Math.cos(turn);
759
+ const s = Math.sin(turn);
760
+ _from.set(centre.x, centre.y - FOOT_OFFSET + height, centre.z);
761
+ _to.set(direction.x * c - direction.z * s, 0, direction.x * s + direction.z * c);
762
+ _to.multiplyScalar(reach).add(_from);
763
+ const hit = this.#ray(_from, _to);
764
+ if (hit === undefined || Math.abs(hit.normal.y) > 0.3) continue;
765
+ const distance = hit.position.distanceToSquared(_from);
766
+ if (distance >= best) continue;
767
+ best = distance;
768
+ const n = Math.hypot(hit.normal.x, hit.normal.z);
769
+ Object.assign(out, {
770
+ found: true,
771
+ nx: hit.normal.x / n,
772
+ nz: hit.normal.z / n,
773
+ x: hit.position.x,
774
+ y: hit.position.y,
775
+ z: hit.position.z,
776
+ });
777
+ }
778
+ return out.found;
779
+ }
780
+
781
+ /**
782
+ * The reference's two wall checks, 0.3 m and 1.5 m above the feet (sm64 mario_step.c:401-402).
783
+ * A wall at the low one only is a ledge's face: it never bonks (mario_step.c:471-480), and
784
+ * falling into it the hero grabs a floor 1.0-1.6 m above the feet (mario_step.c:348-374).
785
+ */
786
+ #probeWall(): void {
787
+ const feel = HERO_FEEL;
788
+ const lower = this.#wallAt(0.3, _lower);
789
+ const upper = this.#wallAt(1.5, _upper);
790
+ if (lower && !upper) {
791
+ // Falling, and moving or pushing into the wall: the reference grabs only when the wall
792
+ // stopped it (mario_step.c:354-365).
793
+ const into =
794
+ -(this.#air.x * _lower.nx + this.#air.z * _lower.nz) -
795
+ (this.#intended.x * _lower.nx + this.#intended.z * _lower.nz);
796
+ if (this.body.velocity.y > 0 || into <= 0.1) return;
797
+ const feet = this.mesh.position.y - FOOT_OFFSET;
798
+ _from.set(
799
+ _lower.x - _lower.nx * feel.ledgeAhead,
800
+ feet + feel.ledgeTop,
801
+ _lower.z - _lower.nz * feel.ledgeAhead,
802
+ );
803
+ _to.set(_from.x, feet + feel.ledgeBottom, _from.z);
804
+ const ledge = this.#ray(_from, _to);
805
+ if (ledge !== undefined && ledge.normal.y > 0.7)
806
+ this.#grabLedge(_lower, _lower.nx, _lower.nz, ledge.position);
807
+ return;
808
+ }
809
+ if (!upper) return;
810
+ const wallX = _upper.nx;
811
+ const wallZ = _upper.nz;
812
+ // Only the speed into the wall counts: a glancing contact slides along it. `#air` is this
813
+ // file's own vector, so the part pushing into the wall is removed here, or the stick would
814
+ // keep adding to it while the body stands still against the wall.
815
+ const into = -(this.#air.x * wallX + this.#air.z * wallZ);
816
+ if (into < feel.wallBonkSpeed || this.#wallTimer > 0) {
817
+ if (into > 0) this.#air.addScaledVector(_from.set(wallX, 0, wallZ), into);
818
+ return;
819
+ }
820
+ // A fast hit: bounce off a little, and open the wall-kick window.
821
+ this.wallHits += 1;
822
+ this.#wallTimer = feel.wallKickWindow;
823
+ this.#wall.nx = wallX;
824
+ this.#wall.nz = wallZ;
825
+ this.#air.set(wallX * 1.2, 0, wallZ * 1.2);
826
+ if (this.body.velocity.y > 0) this.body.velocity.y = 0;
827
+ this.#enter("fall");
828
+ }
829
+
830
+ #wallKick(): void {
831
+ const feel = HERO_FEEL;
832
+ // Face away from the wall: the facing becomes the wall's normal.
833
+ this.yaw = Math.atan2(-this.#wall.nx, -this.#wall.nz);
834
+ this.#wallTimer = 0;
835
+ this.#airJumpReady = true;
836
+ this.#wallKicks += 1;
837
+ this.#wallKickFrom = this.mesh.position.y;
838
+ this.#launch("wallKick", feel.wallKickSpeed, feel.wallKickForward);
839
+ }
840
+
841
+ #grabLedge(wall: { x: number; z: number }, nx: number, nz: number, top: Vector3): void {
842
+ this.#enter("ledgeHang");
843
+ this.#ledgeGrabs += 1;
844
+ this.#airJumpReady = true;
845
+ this.#ledge.copy(top);
846
+ this.yaw = Math.atan2(nx, nz);
847
+ this.#air.set(0, 0, 0);
848
+ this.body.gravity = 0;
849
+ this.body.velocity.set(0, 0, 0);
850
+ this.body.teleport(
851
+ _to.set(
852
+ wall.x + nx * (CAPSULE.radius + 0.02),
853
+ top.y - 1.3 + FOOT_OFFSET,
854
+ wall.z + nz * (CAPSULE.radius + 0.02),
855
+ ),
856
+ );
857
+ }
858
+
859
+ #ledgeStep(magnitude: number, jumpPressed: boolean, crouchPressed: boolean): void {
860
+ const feel = HERO_FEEL;
861
+ this.body.velocity.set(0, 0, 0);
862
+ if (this.action === "ledgeClimb") {
863
+ if (this.#actionTime < feel.ledgeClimbTime) return;
864
+ // Stand on the ledge, one step past its lip.
865
+ this.body.teleport(_to.set(this.#ledge.x, this.#ledge.y + FOOT_OFFSET + 0.05, this.#ledge.z));
866
+ this.#speed = 0;
867
+ this.#groundY = this.#ledge.y;
868
+ this.#enter("idle");
869
+ this.landings += 1;
870
+ return;
871
+ }
872
+ if (crouchPressed) {
873
+ this.#enter("fall");
874
+ this.#airKind = "fall";
875
+ return;
876
+ }
877
+ if (this.#actionTime < feel.ledgeHangMin) return;
878
+ const towardWall = Math.abs(angleTo(this.yaw, this.#stickYaw)) < Math.PI / 2;
879
+ if (jumpPressed || (magnitude > 0.5 && towardWall)) this.#enter("ledgeClimb");
880
+ }
881
+
882
+ #land(): void {
883
+ const feel = HERO_FEEL;
884
+ const kind = this.#airKind;
885
+ this.landings += 1;
886
+ this.#airJumpReady = true;
887
+ this.#pressedAt = -1;
888
+ if (MEASURED.includes(kind)) {
889
+ this.#apex[kind] = this.#peak - this.#takeoff.y;
890
+ const travelled = this.#scratch.subVectors(this.mesh.position, this.#takeoff).setY(0);
891
+ forwardOf(this.#takeoffYaw, _from);
892
+ this.#distance[kind] = travelled.dot(_from);
893
+ this.#takeoffSpeeds[kind] = this.#takeoffSpeed;
894
+ if (kind === "sideflip")
895
+ this.#sideflipFacingError = Math.abs(angleTo(this.yaw, this.#stickYaw));
896
+ if (kind === "wallKick") this.#wallKickRise = this.#peak - this.#wallKickFrom;
897
+ }
898
+ forwardOf(this.yaw, _from);
899
+ this.#speed = Math.max(0, this.#air.x * _from.x + this.#air.z * _from.z);
900
+ this.#chainStage =
901
+ kind === "single" || kind === "fall" || kind === "sideflip" ? 1 : kind === "double" ? 2 : 0;
902
+ this.#chainTimer = this.#chainStage > 0 ? feel.chainWindow : 0;
903
+ this.#air.set(0, 0, 0);
904
+ if (kind === "groundPound") {
905
+ this.#pounds += 1;
906
+ this.#speed = 0;
907
+ this.#enter("poundLand");
908
+ } else if (kind === "dive") this.#enter("diveSlide");
909
+ else if (kind === "backflip") {
910
+ this.#speed = 0;
911
+ this.#enter("idle");
912
+ } else this.#enter(this.#speed > 0 ? "run" : "idle");
913
+ this.#airKind = "fall";
914
+ }
915
+ }