create-threenative 0.2.10 → 0.2.13

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,959 @@
1
+ import {
2
+ GPUParticles3D,
3
+ Scene,
4
+ type SceneFrame,
5
+ afterPhysics,
6
+ isMobile,
7
+ isTouchscreenAvailable,
8
+ } from "@threenative/core";
9
+ import { type IPhysicsContext, buildStaticColliders } from "@threenative/physics";
10
+ import {
11
+ Box3,
12
+ Euler,
13
+ type Group,
14
+ type InstancedMesh,
15
+ MathUtils,
16
+ type Object3D,
17
+ type PerspectiveCamera,
18
+ Vector3,
19
+ } from "three";
20
+ import { Block } from "../entities/Block.js";
21
+ import { Chest } from "../entities/Chest.js";
22
+ import { Door } from "../entities/Door.js";
23
+ import { Dummy } from "../entities/Dummy.js";
24
+ import { Flicker } from "../entities/Flicker.js";
25
+ import {
26
+ ADVENTURE_FEEL,
27
+ FOOT_OFFSET,
28
+ type GameCtx,
29
+ Hero,
30
+ LAYER,
31
+ readHeroInput,
32
+ } from "../entities/Hero.js";
33
+ import { type ITarget, LockOn } from "../entities/LockOn.js";
34
+ import { Mossling } from "../entities/Mossling.js";
35
+ import { Switch } from "../entities/Switch.js";
36
+ import { Thornback } from "../entities/Thornback.js";
37
+ import { Warden } from "../entities/Warden.js";
38
+ import { Interactions } from "../interact.js";
39
+ import { type IHollow, buildHollow } from "../level/Hollow.js";
40
+ import {
41
+ type IVale,
42
+ buildVale,
43
+ isSolid,
44
+ makeRng,
45
+ measureRelief,
46
+ valeHeight,
47
+ } from "../level/Vale.js";
48
+ import { setupCamera } from "../render/camera.js";
49
+ import { BURSTS, EFFECTS } from "../render/effects.js";
50
+ import { setupLighting } from "../render/lighting.js";
51
+ import { createLoadingScreen } from "../render/loading.js";
52
+ import { setupPost } from "../render/postprocessing.js";
53
+ import { createCompanion, createHeartVessel } from "../render/props.js";
54
+ import { type ISky, createSky, setupSky } from "../render/sky.js";
55
+ import { loadSurfaces, untexturedSurfaces, updateSurfaceSampling } from "../render/surface.js";
56
+ import { TouchControls } from "../render/touch-controls.js";
57
+ import type { Checkpoint, GameState } from "../state.js";
58
+
59
+ export type { GameCtx };
60
+
61
+ const DEG = 180 / Math.PI;
62
+
63
+ export class Play extends Scene<GameState, IPhysicsContext> {
64
+ static override readonly initialState: GameState = {
65
+ assetLoads: 0,
66
+ blockSteps: 0,
67
+ cameraInGround: 0,
68
+ capacity: ADVENTURE_FEEL.startHalves / 2,
69
+ cleared: false,
70
+ companionFarthest: 0,
71
+ companionNearest: 0,
72
+ heightFog: false,
73
+ hutLanterns: 0,
74
+ motesSpawned: 0,
75
+ pathCover: 0,
76
+ pathStones: 0,
77
+ reliefLevelShare: 0,
78
+ reliefRange: 0,
79
+ reliefSteepShare: 0,
80
+ sunShafts: 0,
81
+ untexturedSurfaces: -1,
82
+ defeated: 0,
83
+ doorOpen: false,
84
+ grateOpen: false,
85
+ cameraBlocked: 0,
86
+ fightFramedShare: 0,
87
+ fightOccluded: 0,
88
+ fightOutRun: 0,
89
+ hearts: ADVENTURE_FEEL.startHalves / 2,
90
+ hintOverlap: 0,
91
+ toastOverlap: 0,
92
+ openingFramedShare: 0,
93
+ cameraTurnWorst: 0,
94
+ lookOffCentreWorst: 0,
95
+ torsoCovered: 0,
96
+ torsoContactWorst: 0,
97
+ ringFacingLeast: 0,
98
+ heroViewNearest: 0,
99
+ hitsTaken: 0,
100
+ keys: 0,
101
+ lastRespawn: "",
102
+ lockFacingError: 0,
103
+ lockMarkerLowest: 0,
104
+ lockMarkerShown: false,
105
+ lockStrafeDrift: 0,
106
+ nearWallWorst: 0,
107
+ lockStrafeSeconds: 0,
108
+ lockTarget: "",
109
+ paused: false,
110
+ prompt: "",
111
+ respawns: 0,
112
+ shieldBlocks: 0,
113
+ slashHits: 0,
114
+ slashes: 0,
115
+ stopSeconds: 0,
116
+ sword: false,
117
+ toast: "",
118
+ topSpeed: 0,
119
+ turnSeconds: 0,
120
+ uiReady: false,
121
+ wardenHealth: 3,
122
+ wardenStuns: 0,
123
+ wardenState: "dormant",
124
+ zone: "vale",
125
+ };
126
+
127
+ #sky: ISky | undefined;
128
+ #vale: IVale | undefined;
129
+ #hollow: IHollow | undefined;
130
+ #hero: Hero | undefined;
131
+ #dummies: Dummy[] = [];
132
+ #mosslings: Mossling[] = [];
133
+ #flickers: Flicker[] = [];
134
+ #thornbacks: Thornback[] = [];
135
+ #warden: Warden | undefined;
136
+ #block: Block | undefined;
137
+ #chests: Chest[] = [];
138
+ #post: ReturnType<typeof setupPost> | undefined;
139
+
140
+ /**
141
+ * Both places are built here, and everything a scenario can place is registered here:
142
+ * `setup.place` and `setup.spawn` run after `load()` and before `enter()`, so an entity that first
143
+ * appears in `enter()` cannot be placed. `enter()` builds every body where its mesh now stands.
144
+ */
145
+ override async load(ctx: GameCtx): Promise<void> {
146
+ await loadSurfaces(ctx.assets);
147
+ this.#sky = createSky();
148
+ setupSky(ctx.scene, this.#sky);
149
+ const vale = buildVale(makeRng(1986));
150
+ const hollow = buildHollow(makeRng(1998));
151
+ this.#vale = vale;
152
+ this.#hollow = hollow;
153
+ ctx.add(vale.group);
154
+ ctx.add(hollow.group);
155
+
156
+ const hero = new Hero();
157
+ hero.mesh.position.set(vale.spawn.x, vale.spawn.y + FOOT_OFFSET, vale.spawn.z);
158
+ hero.mesh.rotation.y = vale.spawnYaw;
159
+ this.#hero = ctx.entities.add("player", hero);
160
+ vale.dummies.forEach((at, i) => {
161
+ this.#dummies.push(ctx.entities.add(`dummy.${i}`, new Dummy(`dummy.${i}`, at)));
162
+ });
163
+ [...vale.mosslings, ...hollow.guards].forEach((at, i) => {
164
+ this.#mosslings.push(ctx.entities.add(`mossling.${i}`, new Mossling(`mossling.${i}`, at)));
165
+ });
166
+ [...vale.flickers, ...hollow.flickers].forEach((at, i) => {
167
+ this.#flickers.push(ctx.entities.add(`flicker.${i}`, new Flicker(`flicker.${i}`, at)));
168
+ });
169
+ [...vale.thornbacks, ...hollow.thornbacks].forEach(({ at, yaw }, i) => {
170
+ const id = `thornback.${i}`;
171
+ this.#thornbacks.push(ctx.entities.add(id, new Thornback(id, at, yaw)));
172
+ });
173
+ this.#warden = ctx.entities.add("warden", new Warden("warden", hollow.warden));
174
+ this.#block = ctx.entities.add("block", new Block("block", hollow.block, makeRng(7)));
175
+ this.#chests = [
176
+ new Chest("chest.sword", "sword", vale.swordChest.at, vale.swordChest.yaw),
177
+ new Chest("chest.key", "key", hollow.keyChest.at, hollow.keyChest.yaw),
178
+ ];
179
+ for (const chest of this.#chests) ctx.entities.add(chest.id, chest);
180
+ for (const thing of [
181
+ ...this.#dummies,
182
+ ...this.#mosslings,
183
+ ...this.#flickers,
184
+ ...this.#thornbacks,
185
+ ...this.#chests,
186
+ this.#warden,
187
+ this.#block,
188
+ ])
189
+ ctx.add(thing.mesh);
190
+ }
191
+
192
+ override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
193
+ const { vale, hollow, hero, warden, block } = {
194
+ block: this.#block,
195
+ hero: this.#hero,
196
+ hollow: this.#hollow,
197
+ vale: this.#vale,
198
+ warden: this.#warden,
199
+ };
200
+ const [swordChest, keyChest] = this.#chests;
201
+ if (
202
+ vale === undefined ||
203
+ hollow === undefined ||
204
+ hero === undefined ||
205
+ warden === undefined ||
206
+ block === undefined ||
207
+ swordChest === undefined ||
208
+ keyChest === undefined ||
209
+ this.#sky === undefined
210
+ )
211
+ throw new Error("Play.enter ran before load() built the world.");
212
+ ctx.beforeRender(() => {
213
+ updateSurfaceSampling(
214
+ ctx.renderer.temporalUpscale?.() === true ? ctx.renderer.surface().resolutionScale : 1,
215
+ );
216
+ });
217
+ // `userData.solid` marks exactly the meshes that block (`level/Vale.ts`, `level/Hollow.ts`).
218
+ // The Hollow's roof starts at 5 m, so the default 4.5 m reachable ceiling is raised to keep it.
219
+ for (const root of [vale.group, hollow.group])
220
+ buildStaticColliders(ctx, root, {
221
+ collisionLayer: LAYER.world,
222
+ predicate: isSolid,
223
+ reachableCeiling: 6,
224
+ });
225
+ setupSky(ctx.scene, this.#sky);
226
+ const lighting = setupLighting(
227
+ ctx.scene,
228
+ ctx.renderer.raw as Parameters<typeof setupLighting>[1],
229
+ isMobile(),
230
+ );
231
+ this.#post = setupPost(ctx.renderer, ctx.scene, ctx.camera, {
232
+ godraysLight: lighting.key,
233
+ gpuClass: ctx.renderer.gpuClass?.class,
234
+ mobile: isMobile(),
235
+ software: ctx.renderer.softwareAdapter !== undefined,
236
+ });
237
+ const camera = ctx.camera as PerspectiveCamera;
238
+ ctx.add(camera);
239
+ const loading = createLoadingScreen(ctx);
240
+ const touchControls =
241
+ isMobile() && isTouchscreenAvailable()
242
+ ? ctx.entities.add("touch-controls", new TouchControls(camera))
243
+ : undefined;
244
+
245
+ // ------------------------------------------------------------------ actors
246
+ // A scenario may have moved or turned Wren: read both back, then build her body there.
247
+ hero.yaw = new Euler().setFromQuaternion(hero.mesh.quaternion, "YXZ").y;
248
+ hero.mesh.rotation.set(0, 0, 0);
249
+ hero.spawn(ctx);
250
+ const dummies = this.#dummies;
251
+ const mosslings = this.#mosslings;
252
+ const foes = [...this.#flickers, ...this.#thornbacks];
253
+ for (const thing of [...dummies, ...mosslings, ...foes, warden, block]) thing.spawn(ctx);
254
+ const targets: ITarget[] = [...dummies, ...mosslings, ...foes, warden];
255
+ const lock = new LockOn();
256
+ ctx.add(lock.reticle);
257
+
258
+ // Effects: four pooled emitters, every look parameter in `render/effects.ts`. A cut that lands
259
+ // throws embers, a cut that clanks and a hit the shield turns throw cold sparks; fireflies
260
+ // drift round Wren in the vale, and her companion orb sheds a trail.
261
+ const emitters = {
262
+ ember: ctx.add(new GPUParticles3D(EFFECTS.ember())),
263
+ mote: ctx.add(new GPUParticles3D(EFFECTS.mote())),
264
+ spark: ctx.add(new GPUParticles3D(EFFECTS.spark())),
265
+ wisp: ctx.add(new GPUParticles3D(EFFECTS.wisp())),
266
+ };
267
+ const burst = (kind: keyof typeof BURSTS, at: Vector3): void => {
268
+ const { count, emitter, shape } = BURSTS[kind];
269
+ emitters[emitter].emitParticle({
270
+ count,
271
+ direction: { x: shape[0], y: shape[1], z: shape[2] },
272
+ origin: { x: at.x, y: at.y, z: at.z },
273
+ });
274
+ };
275
+ ctx.entities.add("effects", {
276
+ debug: () => ({
277
+ ember: emitters.ember.stats.spawned,
278
+ mote: emitters.mote.stats.spawned,
279
+ spark: emitters.spark.stats.spawned,
280
+ wisp: emitters.wisp.stats.spawned,
281
+ }),
282
+ });
283
+ // Wren's companion orb rides off her left shoulder, a little behind, and lags so it reads as
284
+ // alive; in a fight it climbs higher, out of the line between the lens and what she fights.
285
+ const companion = createCompanion();
286
+ companion.group.position.copy(hero.mesh.position).setY(hero.mesh.position.y + 0.8);
287
+ ctx.add(companion.group);
288
+ const orbGoal = new Vector3();
289
+ const orb = { clock: 0, farthest: 0, nearest: Number.POSITIVE_INFINITY };
290
+ let moteClock = 0;
291
+ // The landform and the path are fixed: measure them once.
292
+ const relief = measureRelief();
293
+ ctx.state.set({
294
+ hutLanterns: vale.hut.lanterns,
295
+ pathCover: Math.round(vale.path.cover * 1000) / 1000,
296
+ pathStones: vale.path.stones,
297
+ reliefLevelShare: Math.round(relief.levelShare * 1000) / 1000,
298
+ reliefRange: Math.round(relief.range * 100) / 100,
299
+ reliefSteepShare: Math.round(relief.steepShare * 1000) / 1000,
300
+ heightFog: ctx.scene.fogNode !== null,
301
+ sunShafts: (ctx.scene.getObjectByName("sun-shafts") as InstancedMesh | undefined)?.count ?? 0,
302
+ untexturedSurfaces: untexturedSurfaces(ctx.scene),
303
+ });
304
+ const thornbacks = this.#thornbacks;
305
+ const seen = { blocks: 0, clanks: 0, hits: 0 };
306
+ const impact = new Vector3();
307
+
308
+ const grate = new Door(
309
+ "door.grate",
310
+ "grate",
311
+ hollow.grate.at,
312
+ hollow.grate.yaw,
313
+ hollow.grate.width,
314
+ 3,
315
+ );
316
+ const door = new Door(
317
+ "door.locked",
318
+ "locked",
319
+ hollow.lockedDoor.at,
320
+ 0,
321
+ hollow.lockedDoor.width,
322
+ 3,
323
+ );
324
+ for (const thing of [swordChest, keyChest]) thing.spawn(ctx);
325
+ for (const thing of [grate, door]) {
326
+ thing.spawn(ctx);
327
+ ctx.entities.add(thing.id, thing);
328
+ }
329
+
330
+ // --------------------------------------------------------------- the loop's state
331
+ let keys = 0;
332
+ let elapsed = 0;
333
+ let toastUntil = 0;
334
+ let respawns = 0;
335
+ let defeated = 0;
336
+ const counted = new Set<ITarget>();
337
+ let cleared = false;
338
+ let indoors = hollow.contains(hero.mesh.position);
339
+ // The place Wren is not in is hidden: neither draws while she is in the other.
340
+ const enterZone = (inside: boolean): void => {
341
+ indoors = inside;
342
+ lighting.setIndoors(inside);
343
+ vale.group.visible = !inside;
344
+ hollow.group.visible = inside;
345
+ };
346
+ enterZone(indoors);
347
+ let lockAge = 0;
348
+ let strafeDrift = 0;
349
+ let strafeSeconds = 0;
350
+ let lockFacing = 0;
351
+ let markerLow = 0;
352
+ // Respawn point: the start, then the last doorway Wren came through.
353
+ const checkpoint: { at: Vector3; name: Checkpoint; yaw: number } = {
354
+ at: (indoors ? hollow.entry : vale.spawn).clone(),
355
+ name: indoors ? "hollow-entry" : "clearing",
356
+ yaw: Math.PI,
357
+ };
358
+ const toast = (text: string, seconds = 2): void => {
359
+ ctx.state.set({ toast: text });
360
+ toastUntil = elapsed + seconds;
361
+ };
362
+ // The slash hint goes at her first slash or lock, and any toast when the Warden wakes: a fight opens
363
+ // on a clear screen. -1 while no hint is up, else her slash count when it went up.
364
+ let slashHint = -1;
365
+ let wardenSlept = true;
366
+ const standAt = (feet: Vector3): Vector3 =>
367
+ new Vector3(feet.x, feet.y + FOOT_OFFSET + 0.05, feet.z);
368
+
369
+ const interactions = new Interactions(ctx, () => hero.body);
370
+ interactions.add({
371
+ at: swordChest.mesh.position,
372
+ label: () => (swordChest.opened ? undefined : "Open chest"),
373
+ use: () => {
374
+ if (swordChest.open() === undefined) return;
375
+ hero.giveSword();
376
+ toast("THE EMBER BLADE! Click to slash.", 3);
377
+ slashHint = hero.slashes;
378
+ },
379
+ });
380
+ interactions.add({
381
+ at: keyChest.mesh.position,
382
+ label: () => (keyChest.opened ? undefined : "Open chest"),
383
+ use: () => {
384
+ if (keyChest.open() === undefined) return;
385
+ keys += 1;
386
+ toast("A SMALL KEY!");
387
+ },
388
+ });
389
+ interactions.add({
390
+ at: vale.sign.at,
391
+ label: () => "Read sign",
392
+ use: () => toast(vale.sign.text, 4),
393
+ });
394
+ interactions.add(
395
+ {
396
+ at: new Vector3(door.mesh.position.x, 0, door.mesh.position.z + 0.6),
397
+ label: () => (door.open ? undefined : keys > 0 ? "Unlock door" : "Locked"),
398
+ use: () => {
399
+ if (door.unlock(keys)) {
400
+ keys -= 1;
401
+ toast("THE DOOR OPENS");
402
+ } else toast("It is locked. Somewhere in here is a key.");
403
+ },
404
+ },
405
+ 1.6,
406
+ );
407
+ const plate = new Switch(hollow.switchAt, block, (pressed) => {
408
+ grate.setOpen(pressed);
409
+ if (pressed) toast("THE GRATE OPENS");
410
+ });
411
+ plate.spawn(ctx);
412
+
413
+ // The heart vessel appears where the Warden falls; taking it clears the dungeon.
414
+ const vessel: Group = createHeartVessel();
415
+ vessel.visible = false;
416
+ ctx.add(vessel);
417
+
418
+ // The camera arm and the sun read the solved body, so they run after physics has moved it.
419
+ // Drawn solids the physics world does not hold whole (a giant's roots and limbs, a boulder): the
420
+ // arm stops in front of them too, so the lens never ends up inside one.
421
+ const lens: Object3D[] = [];
422
+ ctx.scene.traverse((object) => {
423
+ if (object.userData.lens === true) lens.push(object);
424
+ });
425
+ const lensDirection = new Vector3();
426
+ const rig = setupCamera(
427
+ camera,
428
+ (from, to) => {
429
+ if (from.distanceToSquared(to) < 1e-8) return undefined;
430
+ const world = ctx.physics.directSpaceState.intersectRay({
431
+ collisionMask: LAYER.world,
432
+ from,
433
+ to,
434
+ });
435
+ const far = world?.distance ?? from.distanceTo(to);
436
+ const drawn = ctx.raycast({
437
+ direction: lensDirection.subVectors(to, from).normalize(),
438
+ far,
439
+ origin: from,
440
+ targets: lens,
441
+ });
442
+ return drawn === undefined ? world : { distance: drawn.distance, normal: { y: 0 } };
443
+ },
444
+ // Outdoors the lens stays over the vale's ground; the Hollow's rooms are flat and roofed.
445
+ (x, z) => (indoors ? Number.NEGATIVE_INFINITY : valeHeight(x, z)),
446
+ );
447
+ rig.snap(hero.mesh.position, hero.yaw + Math.PI);
448
+ // The closest the camera came to Wren's head (her head's centre is 1.33 m over her soles).
449
+ const HEAD_HEIGHT = 1.33;
450
+ const NEAR_VIEW = 1.8;
451
+ const head = new Vector3();
452
+ let viewNearest = Number.POSITIVE_INFINITY;
453
+ // Readability, sampled every tick through the camera's own projection. A fight is on while a
454
+ // target is locked, the Warden is awake (its opening, before any lock) or a live hostile
455
+ // stands within FIGHT_RANGE of Wren; then Wren and that target must both sit inside the frame
456
+ // with a 5% margin (6% at the top, so a head never touches the edge), and Wren's screen centre
457
+ // must not sit behind the target; once a lock has glided in (GLIDE ticks), she must not hide
458
+ // over half of it either. Every tick: nothing solid between her head and the lens, walls in
459
+ // the front half of the way from the lens to her cover little of the frame (a grid of rays,
460
+ // every 6th tick), Wren stays clear of the controls card (top right, Menu.tsx), and a toast
461
+ // (Hud.tsx) covers neither Wren nor the fight's target. The worst per-tick view turn and the
462
+ // most of the locked Warden's chest rune ring Wren's box covers at close range are kept too.
463
+ const FIGHT_RANGE = 8;
464
+ const GLIDE = 15;
465
+ // ponytail: the card's and the toast's boxes in view space at 1280 by 720, kept in step with
466
+ // Menu.tsx and Hud.tsx by hand.
467
+ const HINT = { x0: 0.55, y0: 0.6 };
468
+ const TOAST = { x0: -0.97, x1: -0.36, y0: 0.54, y1: 0.78 };
469
+ const fight = {
470
+ inGround: 0,
471
+ blocked: 0,
472
+ frames: 0,
473
+ framed: 0,
474
+ hint: 0,
475
+ nearWall: 0,
476
+ occluded: 0,
477
+ openingFrames: 0,
478
+ openingFramed: 0,
479
+ toast: 0,
480
+ turn: 0,
481
+ centre: 0,
482
+ torso: 0,
483
+ contact: 0,
484
+ ring: Number.POSITIVE_INFINITY,
485
+ run: 0,
486
+ worstRun: 0,
487
+ ticks: 0,
488
+ lockTicks: 0,
489
+ lockedOn: undefined as ITarget | undefined,
490
+ };
491
+ const underToast = (rect: typeof HINT & { x1: number; y1: number }): boolean =>
492
+ toastUntil !== 0 &&
493
+ rect.x1 > TOAST.x0 &&
494
+ rect.x0 < TOAST.x1 &&
495
+ rect.y1 > TOAST.y0 &&
496
+ rect.y0 < TOAST.y1;
497
+ const fightBox = new Box3();
498
+ const viewNow = new Vector3();
499
+ const viewBefore = new Vector3();
500
+ const heroCentre = new Vector3();
501
+ const ray = new Vector3();
502
+ // Wren's silhouette: her body's width across the view, from her feet to the top of her head.
503
+ const heroBox = new Box3();
504
+ const across = new Vector3();
505
+ const heroRect = { x0: 0, x1: 0, y0: 0, y1: 0 };
506
+ const targetRect = { x0: 0, x1: 0, y0: 0, y1: 0 };
507
+ const corner = new Vector3();
508
+ // The Warden's chest rune ring (render/creatures.ts): a disc on its chest face, centred at
509
+ // `at` on the rig, `radius` out to the tips of its strokes; the fight is close inside `within`.
510
+ // Closer than `clear` (ring centre to Wren's) no lens short of side-on clears it, as her
511
+ // half-width alone is 0.32 m: that is shield contact, kept apart.
512
+ const CHEST = { at: new Vector3(0, 1.3, 0.72), radius: 0.48, within: 5, clear: 0.4 };
513
+ const chestRect = { x0: 0, x1: 0, y0: 0, y1: 0 };
514
+ const ringAt = new Vector3();
515
+ const toWren = new Vector3();
516
+ // The ring's screen box: its four rim points (left, right, top, bottom) projected.
517
+ const projectRing = (): void => {
518
+ Object.assign(chestRect, {
519
+ x0: Number.POSITIVE_INFINITY,
520
+ x1: Number.NEGATIVE_INFINITY,
521
+ y0: Number.POSITIVE_INFINITY,
522
+ y1: Number.NEGATIVE_INFINITY,
523
+ });
524
+ for (let i = 0; i < 4; i += 1) {
525
+ const a = (i * Math.PI) / 2;
526
+ corner.copy(CHEST.at);
527
+ corner.x += Math.cos(a) * CHEST.radius;
528
+ corner.y += Math.sin(a) * CHEST.radius;
529
+ warden.rig.group.localToWorld(corner).project(camera);
530
+ chestRect.x0 = Math.min(chestRect.x0, corner.x);
531
+ chestRect.x1 = Math.max(chestRect.x1, corner.x);
532
+ chestRect.y0 = Math.min(chestRect.y0, corner.y);
533
+ chestRect.y1 = Math.max(chestRect.y1, corner.y);
534
+ }
535
+ };
536
+ // The screen area two boxes share.
537
+ const overlap = (a: typeof heroRect, b: typeof heroRect): number =>
538
+ Math.max(0, Math.min(a.x1, b.x1) - Math.max(a.x0, b.x0)) *
539
+ Math.max(0, Math.min(a.y1, b.y1) - Math.max(a.y0, b.y0));
540
+ const solidBetween = (from: Vector3, to: Vector3): boolean =>
541
+ from.distanceToSquared(to) > 1e-8 &&
542
+ ctx.physics.directSpaceState.intersectRay({ collisionMask: LAYER.world, from, to }) !==
543
+ undefined;
544
+ const fightTarget = (): ITarget | undefined => {
545
+ if (lock.target !== undefined) return lock.target;
546
+ if (warden.alive && warden.state !== "dormant") return warden;
547
+ let best: ITarget | undefined;
548
+ let bestDistance = FIGHT_RANGE;
549
+ for (const target of targets) {
550
+ if (!target.alive) continue;
551
+ const distance = target.mesh.position.distanceTo(hero.mesh.position);
552
+ if (distance < bestDistance) {
553
+ best = target;
554
+ bestDistance = distance;
555
+ }
556
+ }
557
+ return best;
558
+ };
559
+ const project = (box: Box3, rect: typeof heroRect): boolean => {
560
+ Object.assign(rect, {
561
+ x0: Number.POSITIVE_INFINITY,
562
+ x1: Number.NEGATIVE_INFINITY,
563
+ y0: Number.POSITIVE_INFINITY,
564
+ y1: Number.NEGATIVE_INFINITY,
565
+ });
566
+ let ahead = true;
567
+ for (let i = 0; i < 8; i += 1) {
568
+ corner.set(
569
+ i & 1 ? box.max.x : box.min.x,
570
+ i & 2 ? box.max.y : box.min.y,
571
+ i & 4 ? box.max.z : box.min.z,
572
+ );
573
+ corner.project(camera);
574
+ ahead &&= corner.z < 1;
575
+ rect.x0 = Math.min(rect.x0, corner.x);
576
+ rect.x1 = Math.max(rect.x1, corner.x);
577
+ rect.y0 = Math.min(rect.y0, corner.y);
578
+ rect.y1 = Math.max(rect.y1, corner.y);
579
+ }
580
+ return ahead && rect.x0 >= -0.9 && rect.y0 >= -0.9 && rect.x1 <= 0.9 && rect.y1 <= 0.88;
581
+ };
582
+ afterPhysics(ctx, (dt) => {
583
+ // An awake Warden stays in the picture from its first stir, before any lock.
584
+ const awake = warden.alive && warden.state !== "dormant";
585
+ rig.update(
586
+ hero.mesh.position,
587
+ lock.target === undefined ? undefined : lock,
588
+ dt,
589
+ awake ? fightBox.setFromObject(warden.mesh) : undefined,
590
+ );
591
+ head.copy(hero.mesh.position).setY(hero.mesh.position.y - FOOT_OFFSET + HEAD_HEIGHT);
592
+ const near = camera.position.distanceTo(head);
593
+ // A wall-pulled camera in a tight room climbs to the ceiling right over her, where her cap
594
+ // fills the lens: closer than NEAR_VIEW she hides, as Ocarina's hero does.
595
+ hero.rig.group.visible = !hero.blinking && near > NEAR_VIEW;
596
+ if (hero.rig.group.visible) viewNearest = Math.min(viewNearest, near);
597
+ lighting.follow(hero.mesh.position);
598
+ camera.updateMatrixWorld();
599
+ // A camera under the vale's ground is inside a bank or an outcrop: the arm must never go there.
600
+ if (!indoors && camera.position.y < valeHeight(camera.position.x, camera.position.z) + 0.2)
601
+ fight.inGround += 1;
602
+ // The orb: off her left shoulder, a little behind, on a slow small circle; higher in a fight.
603
+ orb.clock += dt;
604
+ const f = hero.forward;
605
+ const fighting = lock.target !== undefined || awake;
606
+ orbGoal.set(
607
+ hero.mesh.position.x + f.z * 0.7 - f.x * 0.4 + Math.cos(orb.clock * 1.3) * 0.15,
608
+ head.y + (fighting ? 0.8 : 0.35) + Math.sin(orb.clock * 2.3) * 0.08,
609
+ hero.mesh.position.z - f.x * 0.7 - f.z * 0.4 + Math.sin(orb.clock * 1.3) * 0.15,
610
+ );
611
+ if (companion.group.position.distanceTo(orbGoal) > 6) companion.group.position.copy(orbGoal);
612
+ else companion.group.position.lerp(orbGoal, 1 - Math.exp(-dt * 4));
613
+ const orbGap = companion.group.position.distanceTo(head);
614
+ orb.nearest = Math.min(orb.nearest, orbGap);
615
+ orb.farthest = Math.max(orb.farthest, orbGap);
616
+ burst("wisp", companion.group.position);
617
+ // How far the view turned this tick, in degrees: the fastest swing a player sees.
618
+ camera.getWorldDirection(viewNow);
619
+ if (fight.ticks > 0) fight.turn = Math.max(fight.turn, viewNow.angleTo(viewBefore) * DEG);
620
+ viewBefore.copy(viewNow);
621
+ fight.ticks += 1;
622
+ fight.lockTicks =
623
+ lock.target !== undefined && lock.target === fight.lockedOn ? fight.lockTicks + 1 : 0;
624
+ fight.lockedOn = lock.target;
625
+ if (solidBetween(head, camera.position)) fight.blocked += 1;
626
+ if (fight.ticks % 6 === 0) {
627
+ // A wall or ceiling (any hit not facing up) in the front half of the way from the lens to
628
+ // Wren is foreground clutter: a doorway jamb the camera films her through.
629
+ const reach = near / 2;
630
+ let walls = 0;
631
+ for (let u = -0.75; u <= 0.76; u += 0.3)
632
+ for (let v = -0.75; v <= 0.76; v += 0.5) {
633
+ ray.set(u, v, 0.5).unproject(camera).sub(camera.position).setLength(reach);
634
+ const hit = ctx.physics.directSpaceState.intersectRay({
635
+ collisionMask: LAYER.world,
636
+ from: camera.position,
637
+ to: ray.add(camera.position),
638
+ });
639
+ if (hit !== undefined && hit.normal.y < 0.7) walls += 1;
640
+ }
641
+ fight.nearWall = Math.max(fight.nearWall, walls / 24);
642
+ }
643
+ across.setFromMatrixColumn(camera.matrixWorld, 0).setY(0).normalize().multiplyScalar(0.32);
644
+ const feet = hero.mesh.position.y - FOOT_OFFSET;
645
+ heroBox.min.set(hero.mesh.position.x, feet, hero.mesh.position.z).sub(across);
646
+ heroBox.max.set(hero.mesh.position.x, feet + 1.8, hero.mesh.position.z).add(across);
647
+ const heroIn = project(heroBox, heroRect);
648
+ // Unlocked, the view follows the mouse with Wren near its middle: how far she strays from it.
649
+ if (lock.target === undefined && !awake) {
650
+ heroCentre
651
+ .set(hero.mesh.position.x, feet + 0.9, hero.mesh.position.z)
652
+ .applyMatrix4(camera.matrixWorldInverse);
653
+ const half = Math.tan(MathUtils.degToRad(camera.fov / 2)) * camera.aspect;
654
+ fight.centre = Math.max(
655
+ fight.centre,
656
+ heroCentre.z > -0.1 ? 2 : Math.min(2, Math.abs(heroCentre.x / heroCentre.z) / half),
657
+ );
658
+ }
659
+ if (hero.rig.group.visible && heroRect.x1 > HINT.x0 && heroRect.y1 > HINT.y0) fight.hint += 1;
660
+ const target = fightTarget();
661
+ if (target === undefined) {
662
+ fight.run = 0;
663
+ return;
664
+ }
665
+ const box = target === lock.target ? lock.bounds : fightBox.setFromObject(target.mesh);
666
+ const targetIn = project(box, targetRect);
667
+ heroCentre.set(hero.mesh.position.x, feet + 0.9, hero.mesh.position.z);
668
+ const heroDistance = heroCentre.distanceTo(camera.position);
669
+ heroCentre.project(camera);
670
+ const targetNearer = box.getCenter(corner).distanceTo(camera.position) < heroDistance;
671
+ corner.project(camera);
672
+ const covers = (point: Vector3, rect: typeof heroRect): boolean =>
673
+ point.x > rect.x0 && point.x < rect.x1 && point.y > rect.y0 && point.y < rect.y1;
674
+ // Wren hiding the locked target: she covers its centre and over half of its box.
675
+ const hidden = overlap(heroRect, targetRect);
676
+ const area = (targetRect.x1 - targetRect.x0) * (targetRect.y1 - targetRect.y0);
677
+ const behind = targetNearer
678
+ ? covers(heroCentre, targetRect)
679
+ : target === lock.target &&
680
+ fight.lockTicks > GLIDE &&
681
+ covers(corner, heroRect) &&
682
+ hidden > area / 2;
683
+ fight.frames += 1;
684
+ if (behind) fight.occluded += 1;
685
+ // Locked on the Warden within CHEST.within, once the lock has glided in (its stuns, cuts and
686
+ // shield blocks): the most of the box round its chest rune ring that Wren's box covers.
687
+ if (
688
+ target === warden &&
689
+ lock.target === warden &&
690
+ fight.lockTicks > GLIDE &&
691
+ warden.mesh.position.distanceTo(hero.mesh.position) < CHEST.within
692
+ ) {
693
+ warden.rig.group.updateWorldMatrix(true, false);
694
+ warden.rig.group.localToWorld(ringAt.copy(CHEST.at));
695
+ // How square the ring faces the lens: its on-screen width over its face-on width.
696
+ const facing =
697
+ warden.rig.group.getWorldDirection(ray).dot(corner.subVectors(camera.position, ringAt)) /
698
+ corner.length();
699
+ // A shield stun leaves the ring facing Wren; a wall stun turns it to the wall, unseen anyway.
700
+ const stunnedAtWren =
701
+ warden.state === "stunned" && ray.dot(toWren.subVectors(hero.mesh.position, ringAt)) > 0;
702
+ if (stunnedAtWren) fight.ring = Math.min(fight.ring, Math.max(0, facing));
703
+ // A ring facing away from the lens is behind the Warden's own body: nothing to cover.
704
+ if (facing > 0) {
705
+ projectRing();
706
+ const share =
707
+ overlap(heroRect, chestRect) /
708
+ ((chestRect.x1 - chestRect.x0) * (chestRect.y1 - chestRect.y0));
709
+ const ahead = Math.hypot(
710
+ ringAt.x - hero.mesh.position.x,
711
+ ringAt.z - hero.mesh.position.z,
712
+ );
713
+ if (ahead < CHEST.clear) fight.contact = Math.max(fight.contact, share);
714
+ else fight.torso = Math.max(fight.torso, share);
715
+ }
716
+ }
717
+ if (underToast(heroRect) || underToast(targetRect)) fight.toast += 1;
718
+ if (target === warden && lock.target === undefined) {
719
+ fight.openingFrames += 1;
720
+ if (heroIn && targetIn) fight.openingFramed += 1;
721
+ }
722
+ if (heroIn && targetIn) {
723
+ fight.framed += 1;
724
+ fight.run = 0;
725
+ } else {
726
+ fight.run += 1;
727
+ fight.worstRun = Math.max(fight.worstRun, fight.run);
728
+ }
729
+ });
730
+
731
+ const toTarget = new Vector3();
732
+ // Whether the pointer was captured on the last step; see `readHeroInput`.
733
+ let mouseArmed = false;
734
+ const statePatch: Partial<GameState> = {};
735
+
736
+ return (frameCtx, dt) => {
737
+ loading.update();
738
+ elapsed += dt;
739
+ const input = readHeroInput(
740
+ frameCtx,
741
+ touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
742
+ mouseArmed,
743
+ );
744
+ mouseArmed = frameCtx.input.raw.pointer.captured;
745
+
746
+ // Lock first: the hero reads this step's target for strafing and facing.
747
+ lock.update(
748
+ dt,
749
+ input.target,
750
+ input.targetPressed,
751
+ input.lockPressed,
752
+ hero.mesh.position,
753
+ camera,
754
+ targets,
755
+ );
756
+ if ((input.targetPressed || input.lockPressed) && lock.target === undefined)
757
+ rig.recenter(hero.yaw + Math.PI);
758
+ // Mouse look: only once the pointer is captured, and the lock owns the view while it holds.
759
+ if (frameCtx.input.raw.pointer.captured && lock.target === undefined)
760
+ rig.look(frameCtx.input.vector("look").x);
761
+ hero.update(frameCtx, dt, input, lock, rig.yaw, indoors, targets);
762
+ hero.setPushing(block.update(frameCtx, dt, hero, hero.wish));
763
+
764
+ for (const mossling of mosslings) mossling.update(frameCtx, dt, hero);
765
+ for (const foe of foes) foe.update(dt, hero);
766
+ // Effects fire on the counters' edges: a cut's where the blade met the target, a block's off
767
+ // the shield in front of Wren.
768
+ const clanks = thornbacks.reduce((sum, foe) => sum + foe.clanks, warden.clanks);
769
+ impact.copy(hero.forward).multiplyScalar(0.9).add(hero.mesh.position);
770
+ impact.y += 0.35;
771
+ if (hero.slashHits > seen.hits) burst("hit", hero.strikeAt);
772
+ if (clanks > seen.clanks) burst("clank", hero.strikeAt);
773
+ if (hero.shieldBlocks > seen.blocks) burst("block", impact.setY(hero.mesh.position.y + 0.15));
774
+ Object.assign(seen, { blocks: hero.shieldBlocks, clanks, hits: hero.slashHits });
775
+ warden.update(dt, hero);
776
+ for (const dummy of dummies) dummy.update(dt);
777
+ // A target falls inside Wren's slash, so count the fallen after everything has moved.
778
+ for (const fallen of targets) {
779
+ if (fallen.alive || counted.has(fallen)) continue;
780
+ counted.add(fallen);
781
+ defeated += 1;
782
+ if (fallen === warden) {
783
+ vessel.position.set(warden.mesh.position.x, 1.2, warden.mesh.position.z);
784
+ vessel.visible = true;
785
+ door.setOpen(true);
786
+ toast("THE STONE WARDEN FALLS", 3);
787
+ }
788
+ }
789
+ swordChest.update(dt);
790
+ keyChest.update(dt);
791
+ grate.update(dt);
792
+ door.update(dt);
793
+ plate.update();
794
+ const prompt = interactions.update(hero.mesh.position, input.interact && hero.alive);
795
+ // Fireflies round Wren in the vale, a few every quarter second, from just under her waist.
796
+ moteClock += dt;
797
+ if (!indoors && moteClock >= 0.25) {
798
+ moteClock = 0;
799
+ burst("motes", impact.copy(hero.mesh.position).setY(hero.mesh.position.y - 0.6));
800
+ }
801
+
802
+ if (vessel.visible) {
803
+ vessel.rotation.y += dt * 2;
804
+ vessel.position.y = 1.2 + Math.sin(elapsed * 3) * 0.1;
805
+ if (vessel.position.distanceTo(hero.mesh.position) < 1.2) {
806
+ vessel.visible = false;
807
+ hero.capacity += 2;
808
+ hero.heal(hero.capacity);
809
+ cleared = true;
810
+ toast("HEART VESSEL! The Moss Hollow is cleared.", 5);
811
+ }
812
+ }
813
+
814
+ // The cave mouth carries Wren between the clearing and the Hollow, and moves her checkpoint.
815
+ const at = hero.mesh.position;
816
+ const enter = (name: Checkpoint, feet: Vector3, yaw: number, camYaw: number): void => {
817
+ hero.teleport(standAt(feet));
818
+ hero.yaw = yaw;
819
+ checkpoint.name = name;
820
+ checkpoint.at.copy(feet);
821
+ checkpoint.yaw = yaw;
822
+ rig.snap(hero.mesh.position, camYaw);
823
+ };
824
+ if (Math.hypot(at.x - vale.caveMouth.x, at.z - vale.caveMouth.z) < 1.4)
825
+ enter("hollow-entry", hollow.entry, Math.PI, 0);
826
+ else if (Math.hypot(at.x - hollow.exit.x, at.z - hollow.exit.z) < 0.9)
827
+ enter("cave-exit", vale.caveExit, 0, Math.PI);
828
+ if (
829
+ hollow.contains(at) &&
830
+ at.z < hollow.bossCheckpoint.z &&
831
+ checkpoint.name !== "warden-door"
832
+ ) {
833
+ checkpoint.name = "warden-door";
834
+ checkpoint.at.copy(hollow.bossCheckpoint);
835
+ checkpoint.yaw = Math.PI;
836
+ }
837
+ // The door shuts behind her in the Warden's room and opens again when it falls.
838
+ if (
839
+ door.open &&
840
+ warden.alive &&
841
+ hollow.contains(at) &&
842
+ at.z < hollow.bossCheckpoint.z + 0.5
843
+ ) {
844
+ door.setOpen(false);
845
+ toast("The door grinds shut behind you.");
846
+ }
847
+ const nowIndoors = hollow.contains(at);
848
+ if (nowIndoors !== indoors) enterZone(nowIndoors);
849
+
850
+ // Out of hearts, or off the world: back at the last checkpoint with full hearts.
851
+ if (hero.readyToRespawn || at.y < ADVENTURE_FEEL.killPlane) {
852
+ hero.respawn(standAt(checkpoint.at), checkpoint.yaw);
853
+ rig.snap(hero.mesh.position, checkpoint.yaw + Math.PI);
854
+ respawns += 1;
855
+ frameCtx.state.set({ lastRespawn: checkpoint.name });
856
+ toast("Wren picks herself up.");
857
+ }
858
+
859
+ // Lock-on measurements, over the whole run: the worst drift from the held distance while
860
+ // strafing, the seconds spent strafing, and the worst facing error once 0.3 s has let her
861
+ // turn in.
862
+ const target = lock.target;
863
+ if (target !== undefined) {
864
+ toTarget.subVectors(target.mesh.position, at).setY(0);
865
+ const distance = toTarget.length();
866
+ if (lock.justAcquired) lockAge = 0;
867
+ lockAge += dt;
868
+ if (Math.abs(input.move.y) < 0.2 && input.move.length() > 0.1 && hero.state === "run") {
869
+ strafeDrift = Math.max(strafeDrift, Math.abs(distance - hero.lockDistance));
870
+ strafeSeconds += dt;
871
+ }
872
+ if (lockAge > 0.3) {
873
+ const gap = Math.acos(MathUtils.clamp(hero.forward.dot(toTarget.normalize()), -1, 1));
874
+ lockFacing = Math.max(lockFacing, gap * DEG);
875
+ }
876
+ }
877
+
878
+ const woke = wardenSlept && warden.state !== "dormant";
879
+ wardenSlept = warden.state === "dormant";
880
+ if (woke || (slashHint >= 0 && (hero.slashes > slashHint || lock.target !== undefined))) {
881
+ slashHint = -1;
882
+ toastUntil = elapsed;
883
+ }
884
+ if (toastUntil !== 0 && elapsed >= toastUntil) {
885
+ toastUntil = 0;
886
+ frameCtx.state.set({ toast: "" });
887
+ }
888
+ statePatch.blockSteps = block.steps;
889
+ statePatch.capacity = hero.capacity / 2;
890
+ statePatch.cleared = cleared;
891
+ statePatch.defeated = defeated;
892
+ statePatch.doorOpen = door.open;
893
+ statePatch.grateOpen = grate.open;
894
+ statePatch.hearts = hero.health / 2;
895
+ statePatch.hitsTaken = hero.hitsTaken;
896
+ statePatch.keys = keys;
897
+ statePatch.lockFacingError = Math.round(lockFacing * 10) / 10;
898
+ statePatch.lockStrafeDrift = Math.round(strafeDrift * 1000) / 1000;
899
+ statePatch.lockStrafeSeconds = Math.round(strafeSeconds * 100) / 100;
900
+ statePatch.lockTarget = target?.id ?? "";
901
+ statePatch.lockMarkerShown = lock.reticle.visible;
902
+ if (lock.reticle.visible)
903
+ markerLow = markerLow === 0 ? lock.markerLift : Math.min(markerLow, lock.markerLift);
904
+ statePatch.lockMarkerLowest = Math.round(markerLow * 1000) / 1000;
905
+ statePatch.fightFramedShare =
906
+ fight.frames === 0 ? 0 : Math.round((fight.framed / fight.frames) * 1000) / 1000;
907
+ statePatch.fightOutRun = fight.worstRun;
908
+ statePatch.fightOccluded = fight.occluded;
909
+
910
+ statePatch.cameraBlocked = fight.blocked;
911
+ statePatch.cameraInGround = fight.inGround;
912
+ statePatch.motesSpawned = emitters.mote.stats.spawned;
913
+ statePatch.companionNearest =
914
+ orb.nearest === Number.POSITIVE_INFINITY ? 0 : Math.round(orb.nearest * 100) / 100;
915
+ statePatch.companionFarthest = Math.round(orb.farthest * 100) / 100;
916
+ statePatch.assetLoads = frameCtx.assets.progress.requested;
917
+ statePatch.nearWallWorst = Math.round(fight.nearWall * 1000) / 1000;
918
+ statePatch.hintOverlap = fight.hint;
919
+ statePatch.toastOverlap = fight.toast;
920
+ statePatch.cameraTurnWorst = Math.round(fight.turn * 100) / 100;
921
+ statePatch.lookOffCentreWorst = Math.round(fight.centre * 1000) / 1000;
922
+ statePatch.torsoCovered = Math.round(fight.torso * 1000) / 1000;
923
+ statePatch.torsoContactWorst = Math.round(fight.contact * 1000) / 1000;
924
+ statePatch.ringFacingLeast =
925
+ fight.ring === Number.POSITIVE_INFINITY ? 0 : Math.round(fight.ring * 1000) / 1000;
926
+ statePatch.openingFramedShare =
927
+ fight.openingFrames === 0
928
+ ? 0
929
+ : Math.round((fight.openingFramed / fight.openingFrames) * 1000) / 1000;
930
+ statePatch.heroViewNearest =
931
+ viewNearest === Number.POSITIVE_INFINITY ? 0 : Math.round(viewNearest * 100) / 100;
932
+ statePatch.prompt = prompt;
933
+ statePatch.respawns = respawns;
934
+ statePatch.shieldBlocks = hero.shieldBlocks;
935
+ statePatch.slashHits = hero.slashHits;
936
+ statePatch.slashes = hero.slashes;
937
+ statePatch.stopSeconds = Math.round(hero.stopSeconds * 1000) / 1000;
938
+ statePatch.sword = hero.hasSword;
939
+ statePatch.topSpeed = Math.round(hero.topSpeed * 1000) / 1000;
940
+ statePatch.turnSeconds = Math.round(hero.turnSeconds * 1000) / 1000;
941
+ statePatch.wardenHealth = warden.health;
942
+ statePatch.wardenStuns = warden.stuns;
943
+ statePatch.wardenState = warden.state;
944
+ statePatch.zone = indoors ? "hollow" : "vale";
945
+ frameCtx.state.set(statePatch);
946
+ };
947
+ }
948
+
949
+ override exit(ctx: GameCtx): void {
950
+ this.#post?.dispose();
951
+ this.#post = undefined;
952
+ this.#dummies = [];
953
+ this.#mosslings = [];
954
+ this.#flickers = [];
955
+ this.#thornbacks = [];
956
+ this.#chests = [];
957
+ super.exit(ctx);
958
+ }
959
+ }