create-threenative 0.2.6 → 0.2.8

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 (756) hide show
  1. package/README.md +5 -3
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +607 -26
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +801 -24
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +300 -56
  19. package/dist/threenative.js +717 -156
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rain/AGENTS.md +96 -0
  218. package/templates/rain/CLAUDE.md +98 -0
  219. package/templates/rain/assets/rain-loop.wav +0 -0
  220. package/templates/rain/assets/thunder.wav +0 -0
  221. package/templates/rain/assets/wind-loop.wav +0 -0
  222. package/templates/rain/index.html +18 -0
  223. package/templates/rain/kit.json +7 -0
  224. package/templates/rain/native-playtests/boot.playtest.json +13 -0
  225. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  226. package/templates/rain/package.json +56 -0
  227. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  228. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  229. package/templates/rain/playtests/automation.playtest.json +133 -0
  230. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  231. package/templates/rain/playtests/flash.playtest.json +27 -0
  232. package/templates/rain/playtests/fly.playtest.json +54 -0
  233. package/templates/rain/playtests/lightning.playtest.json +220 -0
  234. package/templates/rain/playtests/loading.playtest.json +57 -0
  235. package/templates/rain/playtests/paused.playtest.json +59 -0
  236. package/templates/rain/playtests/performance.playtest.json +22 -0
  237. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  238. package/templates/rain/playtests/simulation.playtest.json +20 -0
  239. package/templates/rain/playtests/storm.playtest.json +150 -0
  240. package/templates/rain/playtests/survives.playtest.json +58 -0
  241. package/templates/rain/playtests/tiers.playtest.json +179 -0
  242. package/templates/rain/playtests/weather.playtest.json +77 -0
  243. package/templates/rain/public/favicon.svg +5 -0
  244. package/templates/rain/src/audio/storm.ts +314 -0
  245. package/templates/rain/src/game.ts +114 -0
  246. package/templates/rain/src/render/bloom-shader.ts +65 -0
  247. package/templates/rain/src/render/camera.ts +160 -0
  248. package/templates/rain/src/render/clouds-shader.ts +242 -0
  249. package/templates/rain/src/render/clouds.ts +142 -0
  250. package/templates/rain/src/render/lighting.ts +39 -0
  251. package/templates/rain/src/render/lightning.ts +360 -0
  252. package/templates/rain/src/render/loading.ts +327 -0
  253. package/templates/rain/src/render/materials.ts +19 -0
  254. package/templates/rain/src/render/noise-volume.ts +159 -0
  255. package/templates/rain/src/render/palette.ts +18 -0
  256. package/templates/rain/src/render/post-shader.ts +178 -0
  257. package/templates/rain/src/render/postprocessing.ts +226 -0
  258. package/templates/rain/src/render/quality.ts +135 -0
  259. package/templates/rain/src/render/rain.ts +299 -0
  260. package/templates/rain/src/render/sky.ts +28 -0
  261. package/templates/rain/src/render/world-shader.ts +680 -0
  262. package/templates/rain/src/render/world.ts +146 -0
  263. package/templates/{defense → rain}/src/render/worldEnvironment.ts +52 -1
  264. package/templates/rain/src/scenes/Boot.ts +334 -0
  265. package/templates/rain/src/state.ts +257 -0
  266. package/templates/rain/src/style.css +1160 -0
  267. package/templates/rain/src/ui/App.tsx +29 -0
  268. package/templates/rain/src/ui/GameUi.tsx +187 -0
  269. package/templates/rain/src/ui/Hud.tsx +327 -0
  270. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  271. package/templates/rain/src/ui/Menu.tsx +370 -0
  272. package/templates/rain/src/ui/automation.ts +60 -0
  273. package/templates/rain/src/ui/main.tsx +7 -0
  274. package/templates/rain/src/ui/tempest.ts +149 -0
  275. package/templates/rain/tailwind.config.ts +2 -0
  276. package/templates/rain/threenative.config.ts +66 -0
  277. package/templates/rain/tools/generate-shaders.mjs +656 -0
  278. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  279. package/templates/rain/tools/storm-dsp.mjs +177 -0
  280. package/templates/rain/tools/tempest-bloom.frag +10 -0
  281. package/templates/rain/tools/tempest-clouds.frag +86 -0
  282. package/templates/rain/tools/tempest-post.frag +47 -0
  283. package/templates/rain/tools/tempest-world.frag +210 -0
  284. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  285. package/templates/rain/tsconfig.json +17 -0
  286. package/templates/rain/vite.config.ts +37 -0
  287. package/templates/rts/.codex/config.toml +19 -0
  288. package/templates/rts/.cursor/mcp.json +32 -0
  289. package/templates/rts/.gemini/settings.json +32 -0
  290. package/templates/rts/.mcp.json +32 -0
  291. package/templates/rts/.vscode/mcp.json +36 -0
  292. package/templates/rts/.zed/settings.json +36 -0
  293. package/templates/rts/AGENTS.md +96 -0
  294. package/templates/rts/CLAUDE.md +98 -0
  295. package/templates/rts/kit.json +7 -0
  296. package/templates/rts/opencode.json +41 -0
  297. package/templates/{defense → rts}/package.json +13 -7
  298. package/templates/rts/playtests/performance.playtest.json +41 -0
  299. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  300. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  301. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  302. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  303. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  304. package/templates/rts/playtests/survives.playtest.json +58 -0
  305. package/templates/rts/public/favicon.svg +4 -0
  306. package/templates/rts/src/game.ts +64 -0
  307. package/templates/rts/src/main.ts +15 -0
  308. package/templates/rts/src/orders.ts +22 -0
  309. package/templates/rts/src/render/army.ts +346 -0
  310. package/templates/rts/src/render/camera.ts +123 -0
  311. package/templates/rts/src/render/lighting.ts +61 -0
  312. package/templates/rts/src/render/loading.ts +33 -0
  313. package/templates/rts/src/render/materials.ts +152 -0
  314. package/templates/rts/src/render/models.ts +705 -0
  315. package/templates/rts/src/render/palette.ts +17 -0
  316. package/templates/rts/src/render/picking.ts +93 -0
  317. package/templates/rts/src/render/postprocessing.ts +46 -0
  318. package/templates/rts/src/render/quality.ts +128 -0
  319. package/templates/rts/src/render/resources.ts +141 -0
  320. package/templates/rts/src/render/sky.ts +44 -0
  321. package/templates/rts/src/render/terrain.ts +116 -0
  322. package/templates/rts/src/render/worldEnvironment.ts +809 -0
  323. package/templates/rts/src/scenes/Play.ts +650 -0
  324. package/templates/rts/src/sim/ai.ts +1140 -0
  325. package/templates/rts/src/sim/combat.ts +416 -0
  326. package/templates/rts/src/sim/construction.ts +374 -0
  327. package/templates/rts/src/sim/economy.ts +167 -0
  328. package/templates/rts/src/sim/game.ts +1082 -0
  329. package/templates/rts/src/sim/movement.ts +371 -0
  330. package/templates/rts/src/sim/nav.ts +276 -0
  331. package/templates/rts/src/sim/production.ts +180 -0
  332. package/templates/rts/src/sim/terrain.ts +170 -0
  333. package/templates/rts/src/sim/types.ts +647 -0
  334. package/templates/rts/src/sim/vision.ts +46 -0
  335. package/templates/rts/src/state.ts +100 -0
  336. package/templates/{defense → rts}/src/style.css +21 -8
  337. package/templates/rts/src/ui/App.tsx +21 -0
  338. package/templates/rts/src/ui/Commands.tsx +129 -0
  339. package/templates/rts/src/ui/GameUi.tsx +22 -0
  340. package/templates/rts/src/ui/Hud.tsx +165 -0
  341. package/templates/rts/src/ui/Minimap.tsx +84 -0
  342. package/templates/rts/tailwind.config.ts +2 -0
  343. package/templates/rts/threenative.config.ts +56 -0
  344. package/templates/rts/tsconfig.json +17 -0
  345. package/templates/{defense → rts}/vite.config.ts +4 -1
  346. package/templates/runner/AGENTS.md +6 -10
  347. package/templates/runner/CLAUDE.md +6 -10
  348. package/templates/runner/README.md +3 -3
  349. package/templates/runner/package.json +13 -7
  350. package/templates/runner/playtests/performance.playtest.json +2 -2
  351. package/templates/runner/src/conventions.ts +4 -3
  352. package/templates/runner/src/entities/Runner.ts +54 -7
  353. package/templates/runner/src/game.ts +2 -0
  354. package/templates/runner/src/render/camera.ts +4 -2
  355. package/templates/runner/src/render/dust.ts +5 -2
  356. package/templates/runner/src/render/lighting.ts +41 -45
  357. package/templates/runner/src/render/loading.ts +2 -2
  358. package/templates/runner/src/render/materials.ts +165 -25
  359. package/templates/runner/src/render/palette.ts +17 -28
  360. package/templates/runner/src/render/postprocessing.ts +12 -2
  361. package/templates/runner/src/render/quality.ts +42 -96
  362. package/templates/runner/src/render/shapes.ts +59 -37
  363. package/templates/runner/src/render/sky.ts +32 -41
  364. package/templates/runner/src/render/touch-controls.ts +1 -1
  365. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  366. package/templates/runner/src/scenes/Run.ts +26 -6
  367. package/templates/runner/src/track.ts +6 -1
  368. package/templates/runner/threenative.config.ts +14 -1
  369. package/templates/runner/vite.config.ts +4 -1
  370. package/templates/sailing/AGENTS.md +12 -12
  371. package/templates/sailing/CLAUDE.md +12 -12
  372. package/templates/sailing/assets/ship.glb +0 -0
  373. package/templates/sailing/package.json +13 -7
  374. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  375. package/templates/sailing/playtests/sails.playtest.json +33 -0
  376. package/templates/sailing/playtests/win.playtest.json +156 -8
  377. package/templates/sailing/src/conventions.ts +29 -2
  378. package/templates/sailing/src/entities/Ship.ts +381 -57
  379. package/templates/sailing/src/game.ts +14 -0
  380. package/templates/sailing/src/render/camera.ts +63 -9
  381. package/templates/sailing/src/render/lighting.ts +49 -27
  382. package/templates/sailing/src/render/materials.ts +50 -15
  383. package/templates/sailing/src/render/ocean.ts +647 -60
  384. package/templates/sailing/src/render/palette.ts +16 -12
  385. package/templates/sailing/src/render/postprocessing.ts +12 -2
  386. package/templates/sailing/src/render/props.ts +316 -442
  387. package/templates/sailing/src/render/quality.ts +14 -4
  388. package/templates/sailing/src/render/sky.ts +116 -23
  389. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  390. package/templates/sailing/src/scenes/Boot.ts +21 -0
  391. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  392. package/templates/sailing/src/state.ts +6 -0
  393. package/templates/sailing/src/ui/Hud.tsx +41 -9
  394. package/templates/sailing/threenative.config.ts +14 -1
  395. package/templates/sailing/vite.config.ts +4 -1
  396. package/templates/shooter/AGENTS.md +27 -42
  397. package/templates/shooter/CLAUDE.md +27 -42
  398. package/templates/shooter/index.html +1 -0
  399. package/templates/shooter/package.json +13 -7
  400. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  401. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  402. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  403. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  404. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  405. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  406. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  407. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  408. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  409. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  410. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  411. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  412. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  413. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  414. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  415. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  416. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  417. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  418. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  419. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  420. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  421. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  422. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  423. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  424. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  425. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  426. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  427. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  428. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  429. package/templates/shooter/playtests/performance.playtest.json +62 -26
  430. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  431. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  432. package/templates/shooter/playtests/survives.playtest.json +36 -30
  433. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  434. package/templates/shooter/src/entities/Breakables.ts +412 -0
  435. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  436. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  437. package/templates/shooter/src/entities/Rifle.ts +442 -0
  438. package/templates/shooter/src/entities/Target.ts +199 -83
  439. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  440. package/templates/shooter/src/game.ts +75 -41
  441. package/templates/shooter/src/main.ts +0 -1
  442. package/templates/shooter/src/postPhysics.ts +36 -0
  443. package/templates/shooter/src/render/camera.ts +78 -74
  444. package/templates/shooter/src/render/decals.ts +142 -82
  445. package/templates/shooter/src/render/facade.ts +1373 -0
  446. package/templates/shooter/src/render/gunfx.ts +704 -0
  447. package/templates/shooter/src/render/lighting.ts +52 -38
  448. package/templates/shooter/src/render/loading.ts +2 -2
  449. package/templates/shooter/src/render/materials.ts +100 -88
  450. package/templates/shooter/src/render/occlusion.ts +108 -0
  451. package/templates/shooter/src/render/palette.ts +10 -10
  452. package/templates/shooter/src/render/palm.ts +455 -0
  453. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  454. package/templates/shooter/src/render/postprocessing.ts +15 -3
  455. package/templates/shooter/src/render/quality.ts +40 -82
  456. package/templates/shooter/src/render/scale.ts +148 -15
  457. package/templates/shooter/src/render/shapes.ts +138 -613
  458. package/templates/shooter/src/render/sky.ts +35 -35
  459. package/templates/shooter/src/render/town-schematic.ts +120 -0
  460. package/templates/shooter/src/render/town.ts +986 -0
  461. package/templates/shooter/src/render/townMaterials.ts +160 -0
  462. package/templates/shooter/src/render/vehicles.ts +741 -0
  463. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  464. package/templates/shooter/src/scenes/Play.ts +727 -650
  465. package/templates/shooter/src/state.ts +26 -41
  466. package/templates/shooter/src/style.css +207 -11
  467. package/templates/shooter/src/surfaces.ts +131 -0
  468. package/templates/shooter/src/ui/App.tsx +9 -10
  469. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  470. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  471. package/templates/shooter/src/ui/Hud.tsx +428 -39
  472. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  473. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  474. package/templates/shooter/src/ui/main.tsx +2 -3
  475. package/templates/shooter/threenative.config.ts +14 -1
  476. package/templates/shooter/vite.config.ts +4 -1
  477. package/templates/snow/.codex/config.toml +19 -0
  478. package/templates/snow/.cursor/mcp.json +32 -0
  479. package/templates/snow/.gemini/settings.json +32 -0
  480. package/templates/snow/.mcp.json +32 -0
  481. package/templates/snow/.vscode/mcp.json +36 -0
  482. package/templates/snow/.zed/settings.json +36 -0
  483. package/templates/snow/AGENTS.md +88 -0
  484. package/templates/snow/CLAUDE.md +90 -0
  485. package/templates/snow/README.md +26 -0
  486. package/templates/snow/assets/crunch.wav +0 -0
  487. package/templates/snow/assets/wind.wav +0 -0
  488. package/templates/snow/index.html +12 -0
  489. package/templates/snow/kit.json +7 -0
  490. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  491. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  492. package/templates/snow/opencode.json +41 -0
  493. package/templates/snow/package.json +58 -0
  494. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  495. package/templates/{defense → snow}/playtests/performance.playtest.json +4 -7
  496. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  497. package/templates/{defense → snow}/playtests/survives.playtest.json +26 -6
  498. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  499. package/templates/snow/playtests/weather.playtest.json +119 -0
  500. package/templates/snow/public/favicon.svg +5 -0
  501. package/templates/snow/src/audio.ts +58 -0
  502. package/templates/snow/src/commands.ts +8 -0
  503. package/templates/snow/src/entities/Explorer.ts +279 -0
  504. package/templates/snow/src/game.ts +69 -0
  505. package/templates/snow/src/main.ts +15 -0
  506. package/templates/snow/src/render/bootPrint.ts +50 -0
  507. package/templates/snow/src/render/camera.ts +84 -0
  508. package/templates/snow/src/render/explorer.ts +321 -0
  509. package/templates/snow/src/render/lighting.ts +50 -0
  510. package/templates/snow/src/render/loading.ts +325 -0
  511. package/templates/snow/src/render/materials.ts +36 -0
  512. package/templates/snow/src/render/palette.ts +17 -0
  513. package/templates/{defense → snow}/src/render/postprocessing.ts +12 -2
  514. package/templates/snow/src/render/props.ts +42 -0
  515. package/templates/{defense → snow}/src/render/quality.ts +37 -72
  516. package/templates/snow/src/render/scenery.ts +244 -0
  517. package/templates/snow/src/render/sky.ts +57 -0
  518. package/templates/snow/src/render/snowSurface.ts +259 -0
  519. package/templates/snow/src/render/touch-controls.ts +143 -0
  520. package/templates/snow/src/render/weather.ts +279 -0
  521. package/templates/snow/src/render/worldEnvironment.ts +809 -0
  522. package/templates/{defense → snow}/src/scenes/Boot.ts +4 -4
  523. package/templates/snow/src/scenes/Snow.ts +635 -0
  524. package/templates/snow/src/state.ts +46 -0
  525. package/templates/snow/src/style.css +143 -0
  526. package/templates/snow/src/terrain.ts +64 -0
  527. package/templates/snow/src/ui/App.tsx +15 -0
  528. package/templates/snow/src/ui/Controls.tsx +322 -0
  529. package/templates/snow/src/ui/GameUi.tsx +354 -0
  530. package/templates/snow/src/ui/icons.tsx +54 -0
  531. package/templates/snow/src/ui/main.tsx +7 -0
  532. package/templates/snow/tailwind.config.ts +2 -0
  533. package/templates/snow/threenative.config.ts +51 -0
  534. package/templates/snow/tsconfig.json +17 -0
  535. package/templates/snow/vite.config.ts +37 -0
  536. package/templates/starter/AGENTS.md +17 -17
  537. package/templates/starter/CLAUDE.md +17 -17
  538. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  539. package/templates/starter/package.json +13 -7
  540. package/templates/starter/playtests/play.playtest.json +2 -1
  541. package/templates/starter/playtests/survives.playtest.json +1 -1
  542. package/templates/starter/src/conventions.ts +6 -3
  543. package/templates/starter/src/entities/Goal.ts +35 -42
  544. package/templates/starter/src/entities/Player.ts +99 -16
  545. package/templates/starter/src/render/arena.ts +131 -0
  546. package/templates/starter/src/render/lighting.ts +27 -44
  547. package/templates/starter/src/render/materials.ts +164 -35
  548. package/templates/starter/src/render/palette.ts +16 -16
  549. package/templates/starter/src/render/postprocessing.ts +6 -7
  550. package/templates/starter/src/render/quality.ts +43 -101
  551. package/templates/starter/src/render/shapes.ts +1 -1
  552. package/templates/starter/src/render/sky.ts +39 -45
  553. package/templates/starter/src/render/touch-controls.ts +3 -1
  554. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  555. package/templates/starter/src/scenes/Play.ts +82 -81
  556. package/templates/starter/threenative.config.ts +14 -1
  557. package/templates/starter/vite.config.ts +4 -1
  558. package/templates/tower-defense/.codex/config.toml +19 -0
  559. package/templates/tower-defense/.cursor/mcp.json +32 -0
  560. package/templates/tower-defense/.gemini/settings.json +32 -0
  561. package/templates/tower-defense/.mcp.json +32 -0
  562. package/templates/tower-defense/.vscode/mcp.json +36 -0
  563. package/templates/tower-defense/.zed/settings.json +36 -0
  564. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  565. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  566. package/templates/tower-defense/README.md +16 -0
  567. package/templates/tower-defense/index.html +12 -0
  568. package/templates/tower-defense/kit.json +7 -0
  569. package/templates/tower-defense/opencode.json +41 -0
  570. package/templates/tower-defense/package.json +56 -0
  571. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  572. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  573. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  574. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  575. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  576. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  577. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  578. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  579. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  580. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  581. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  582. package/templates/tower-defense/src/balance.ts +187 -0
  583. package/templates/tower-defense/src/board/Board.ts +100 -0
  584. package/templates/tower-defense/src/board/Route.ts +84 -0
  585. package/templates/tower-defense/src/camera-rig.ts +62 -0
  586. package/templates/tower-defense/src/economy.ts +64 -0
  587. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  588. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  589. package/templates/tower-defense/src/game.ts +72 -0
  590. package/templates/tower-defense/src/intents.ts +21 -0
  591. package/templates/tower-defense/src/main.ts +15 -0
  592. package/templates/tower-defense/src/physics.ts +6 -0
  593. package/templates/tower-defense/src/render/camera.ts +38 -0
  594. package/templates/tower-defense/src/render/lighting.ts +42 -0
  595. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  596. package/templates/tower-defense/src/render/materials.ts +103 -0
  597. package/templates/tower-defense/src/render/palette.ts +58 -0
  598. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  599. package/templates/tower-defense/src/render/quality.ts +128 -0
  600. package/templates/tower-defense/src/render/shapes.ts +550 -0
  601. package/templates/tower-defense/src/render/sky.ts +27 -0
  602. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  603. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  604. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  605. package/templates/tower-defense/src/state.ts +88 -0
  606. package/templates/tower-defense/src/style.css +137 -0
  607. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  608. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  609. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  610. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  611. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  612. package/templates/tower-defense/src/ui/main.tsx +14 -0
  613. package/templates/tower-defense/src/waves.ts +90 -0
  614. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  615. package/templates/tower-defense/vite.config.ts +41 -0
  616. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  617. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  618. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  619. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  620. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  621. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  622. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  623. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  624. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  625. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  626. package/agent-files/AGENT-ROLES.md +0 -26
  627. package/templates/action-rpg/src/render/shapes.ts +0 -269
  628. package/templates/action-rpg/src/render/types.ts +0 -3
  629. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  630. package/templates/defense/README.md +0 -10
  631. package/templates/defense/kit.json +0 -7
  632. package/templates/defense/playtests/leak.playtest.json +0 -23
  633. package/templates/defense/playtests/placement.playtest.json +0 -40
  634. package/templates/defense/playtests/scan.playtest.json +0 -20
  635. package/templates/defense/playtests/survive.playtest.json +0 -45
  636. package/templates/defense/src/attackers/Attacker.ts +0 -120
  637. package/templates/defense/src/board/Route.ts +0 -94
  638. package/templates/defense/src/conventions.ts +0 -18
  639. package/templates/defense/src/economy.ts +0 -36
  640. package/templates/defense/src/entities/Player.ts +0 -52
  641. package/templates/defense/src/game.ts +0 -51
  642. package/templates/defense/src/physics.ts +0 -13
  643. package/templates/defense/src/placement/Buildable.ts +0 -49
  644. package/templates/defense/src/render/camera.ts +0 -16
  645. package/templates/defense/src/render/lighting.ts +0 -37
  646. package/templates/defense/src/render/materials.ts +0 -22
  647. package/templates/defense/src/render/palette.ts +0 -28
  648. package/templates/defense/src/render/shapes.ts +0 -246
  649. package/templates/defense/src/render/sky.ts +0 -45
  650. package/templates/defense/src/scenes/Defense.ts +0 -231
  651. package/templates/defense/src/state.ts +0 -56
  652. package/templates/defense/src/towers/Tower.ts +0 -95
  653. package/templates/defense/src/towers/targeting.ts +0 -53
  654. package/templates/defense/src/ui/Hud.tsx +0 -62
  655. package/templates/defense/src/ui/Menu.tsx +0 -7
  656. package/templates/defense/src/waves.ts +0 -40
  657. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  658. package/templates/minimal/src/render/hud.ts +0 -69
  659. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  660. package/templates/platformer/playtests/chase.playtest.json +0 -21
  661. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  662. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  663. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  664. package/templates/platformer/playtests/physics.playtest.json +0 -14
  665. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  666. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  667. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  668. package/templates/platformer/src/conventions.ts +0 -18
  669. package/templates/platformer/src/entities/Character.ts +0 -286
  670. package/templates/platformer/src/entities/Chaser.ts +0 -118
  671. package/templates/platformer/src/entities/Patrol.ts +0 -93
  672. package/templates/platformer/src/level/Platform.ts +0 -46
  673. package/templates/platformer/src/render/rig.ts +0 -60
  674. package/templates/platformer/src/render/terrain.ts +0 -31
  675. package/templates/platformer/src/scenes/Level.ts +0 -241
  676. package/templates/puzzle/README.md +0 -43
  677. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  678. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  679. package/templates/puzzle/src/conventions.ts +0 -25
  680. package/templates/puzzle/src/entities/Ball.ts +0 -70
  681. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  682. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  683. package/templates/puzzle/src/physics.ts +0 -19
  684. package/templates/puzzle/src/room.ts +0 -83
  685. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  686. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  687. package/templates/shooter/playtests/combat.playtest.json +0 -48
  688. package/templates/shooter/playtests/fail.playtest.json +0 -31
  689. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  690. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  691. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  692. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  693. package/templates/shooter/src/combat/damage.ts +0 -40
  694. package/templates/shooter/src/conventions.ts +0 -51
  695. package/templates/shooter/src/entities/Pickup.ts +0 -70
  696. package/templates/shooter/src/entities/Player.ts +0 -310
  697. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  698. package/templates/shooter/src/playtest-events.ts +0 -15
  699. package/templates/shooter/src/render/touch-controls.ts +0 -305
  700. package/templates/shooter/src/render/types.ts +0 -3
  701. package/templates/shooter/src/render/ui.css +0 -330
  702. package/templates/shooter/src/render/ui.ts +0 -75
  703. package/templates/shooter/src/render/vfx.ts +0 -215
  704. package/templates/shooter/src/ui/Menu.tsx +0 -41
  705. package/templates/shooter/src/waves.ts +0 -50
  706. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  707. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  708. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  709. package/templates/starter/playtests/assets.playtest.json +0 -65
  710. package/templates/starter/playtests/buffer.playtest.json +0 -79
  711. package/templates/starter/playtests/cloth.playtest.json +0 -113
  712. package/templates/starter/playtests/coyote.playtest.json +0 -87
  713. package/templates/starter/playtests/gameover.playtest.json +0 -66
  714. package/templates/starter/playtests/goal.playtest.json +0 -67
  715. package/templates/starter/playtests/look.playtest.json +0 -175
  716. package/templates/starter/playtests/models-baseline.png +0 -0
  717. package/templates/starter/playtests/models.playtest.json +0 -74
  718. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  719. package/templates/starter/playtests/odometer.playtest.json +0 -54
  720. package/templates/starter/playtests/restart.playtest.json +0 -91
  721. package/templates/starter/playtests/seed.playtest.json +0 -54
  722. package/templates/starter/playtests/textures-baseline.png +0 -0
  723. package/templates/starter/playtests/textures.playtest.json +0 -74
  724. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  725. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  726. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  727. package/templates/starter/src/render/coast.ts +0 -199
  728. package/templates/starter/src/render/hero.ts +0 -88
  729. package/templates/starter/src/render/implicitSurface.ts +0 -199
  730. package/templates/starter/src/render/kuwahara.ts +0 -174
  731. package/templates/starter/src/render/outline.ts +0 -141
  732. package/templates/starter/src/render/painterly.ts +0 -86
  733. package/templates/starter/src/render/rockRidge.ts +0 -198
  734. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  735. package/templates/starter/src/render/scenery.ts +0 -40
  736. package/templates/starter/src/render/textureLifetime.ts +0 -53
  737. package/templates/starter/src/render/water.ts +0 -38
  738. package/templates/starter/src/render/watercolor.ts +0 -85
  739. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  740. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  741. /package/templates/{defense → rain}/.codex/config.toml +0 -0
  742. /package/templates/{defense → rain}/.cursor/mcp.json +0 -0
  743. /package/templates/{defense → rain}/.gemini/settings.json +0 -0
  744. /package/templates/{defense → rain}/.mcp.json +0 -0
  745. /package/templates/{defense → rain}/.vscode/mcp.json +0 -0
  746. /package/templates/{defense → rain}/.zed/settings.json +0 -0
  747. /package/templates/{defense → rain}/opencode.json +0 -0
  748. /package/templates/{defense → rain}/src/main.ts +0 -0
  749. /package/templates/{defense → rts}/index.html +0 -0
  750. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  751. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  752. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  753. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  754. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  755. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  756. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -1,716 +1,793 @@
1
1
  import {
2
- Billboard3D,
3
- CameraShake,
4
- GPUParticles3D,
5
2
  type ICtx,
3
+ type ITracerSpawnOptions,
6
4
  Scene,
7
5
  type SceneFrame,
8
- SpriteAnimator3D,
9
- afterPhysics,
6
+ TracerPool3D,
10
7
  isMobile,
11
- isTouchscreenAvailable,
12
8
  } from "@threenative/core";
9
+ import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
10
+ import type { AnimationClip, Group, Object3D, PerspectiveCamera, Quaternion, Texture } from "three";
13
11
  import {
14
- CollisionShape3D,
15
- type IPhysicsContext,
16
- type IRayHit,
17
- RigidBody3D,
18
- buildStaticColliders,
19
- } from "@threenative/physics";
20
- import { Mesh, MeshBasicMaterial, type PerspectiveCamera, Quaternion, Vector3 } from "three";
21
- import { applyDirectDamage, applyRadiusDamage } from "../combat/damage.js";
22
- import { Pickup } from "../entities/Pickup.js";
23
- import {
24
- FRIENDLY_LAYER,
25
- HOSTILE_LAYER,
26
- PLAYER_LAYER,
27
- Player,
28
- SPAWN,
29
- WORLD_LAYER,
30
- } from "../entities/Player.js";
12
+ AdditiveBlending,
13
+ CylinderGeometry,
14
+ MathUtils,
15
+ MeshBasicMaterial,
16
+ Mesh as MeshClass,
17
+ PlaneGeometry,
18
+ PointLight as PointLightClass,
19
+ Vector3,
20
+ } from "three";
21
+ import { clone as cloneSkeleton } from "three/examples/jsm/utils/SkeletonUtils.js";
22
+ import { BreakableField } from "../entities/Breakables.js";
23
+ import { Enemy } from "../entities/Enemy.js";
24
+ import { FpsPlayer } from "../entities/FpsPlayer.js";
25
+ import { MAGAZINE, RESERVE, Rifle } from "../entities/Rifle.js";
31
26
  import { Target } from "../entities/Target.js";
32
- import { SpawnPoints } from "../level/SpawnPoints.js";
33
- import { emitPlaytestEvent } from "../playtest-events.js";
34
- import { createArenaShakeOptions, createFirstPersonRig } from "../render/camera.js";
35
- import { DecalField } from "../render/decals.js";
27
+ import { TouchControls } from "../entities/TouchControls.js";
28
+ import { onAfterPhysics } from "../postPhysics.js";
29
+ import { DecalField, bulletHoleTexture } from "../render/decals.js";
30
+ import { ImpactBursts, MuzzleFlash, MuzzleFlashPool, softCircleTexture } from "../render/gunfx.js";
36
31
  import { setupLighting } from "../render/lighting.js";
37
32
  import { createLoadingScreen } from "../render/loading.js";
38
- import { createMaterials } from "../render/materials.js";
33
+ import { BoxOccluders } from "../render/occlusion.js";
34
+ import { PooledBillboards } from "../render/pooled-billboards.js";
39
35
  import { setupPost } from "../render/postprocessing.js";
40
- import {
41
- PICKUP_SPRITE_FRAMES,
42
- createArena,
43
- createFriendlyVisual,
44
- createWallVisual,
45
- } from "../render/shapes.js";
36
+ import { scale } from "../render/scale.js";
46
37
  import { setupSky } from "../render/sky.js";
47
- import { TouchControls } from "../render/touch-controls.js";
48
- import type { ITouchInput } from "../render/touch-controls.js";
49
- import { createImpactDust, createImpactSparks, createMuzzleFlash } from "../render/vfx.js";
50
- import type { GameState } from "../state.js";
51
- import { WaveDirector } from "../waves.js";
52
- import { Hitscan } from "../weapons/Hitscan.js";
53
- import { Projectile } from "../weapons/Projectile.js";
54
- import { MAGAZINE, RESERVE, Viewmodel } from "../weapons/Viewmodel.js";
38
+ import { TOWN_HALF, type Town, buildTown } from "../render/town.js";
39
+ import { createTownMaterials } from "../render/townMaterials.js";
40
+ import { type GameState, TARGET_GOAL } from "../state.js";
41
+ import { resolveSurface } from "../surfaces.js";
55
42
 
56
43
  export type GameCtx = ICtx<GameState, IPhysicsContext>;
57
44
 
58
- const DEMO_POSITION = new Vector3(0, 0.85, -4);
59
- const WAVE_POSITION = new Vector3(0, 0.9, -9);
60
- const SCAN_POSITION = new Vector3(3, 0.9, 0);
61
- const BLAST_CENTRE = new Vector3(0, 0.85, -4);
62
- const SPAWN_POINTS = new SpawnPoints([
63
- new Vector3(-0.4, SPAWN.y, SPAWN.z),
64
- SPAWN,
65
- new Vector3(0.4, SPAWN.y, SPAWN.z),
66
- ]);
67
-
68
- type TargetEntry = { readonly id: string; readonly target: Target };
69
- type ProjectileEntry = {
70
- readonly collisionMask: number;
71
- readonly id: string;
72
- readonly value: Projectile;
73
- };
45
+ /** The reference HUD reads 1:45 on the round clock. */
46
+ const RUN_SECONDS = 105;
47
+ const RANGE_METRES = 70;
48
+ const ROUND_DAMAGE = 10;
49
+
50
+ /**
51
+ * Where the breakable vessels stand. Placed against walls and in doorways rather than out in the
52
+ * open: a pot in the middle of a lane is an obstacle, and a pot beside a doorway is a place
53
+ * someone lives. Every one of these is on the ground deck, clear of the patrol routes.
54
+ */
55
+ const BREAKABLE_SPOTS: readonly {
56
+ kind: "pot" | "jar" | "bottle";
57
+ x: number;
58
+ z: number;
59
+ yaw: number;
60
+ }[] = [
61
+ { kind: "pot", x: -8.4, z: 18.6, yaw: 0.3 },
62
+ { kind: "jar", x: -7.2, z: 18.2, yaw: 1.1 },
63
+ { kind: "pot", x: 11.5, z: 12.4, yaw: -0.6 },
64
+ { kind: "bottle", x: 12.3, z: 12.1, yaw: 0 },
65
+ { kind: "jar", x: 4.2, z: -6.5, yaw: 2.2 },
66
+ { kind: "pot", x: -14.8, z: -3.2, yaw: 0.9 },
67
+ { kind: "bottle", x: -15.6, z: -3.6, yaw: 0 },
68
+ { kind: "jar", x: 17.4, z: -14.2, yaw: -1.4 },
69
+ { kind: "pot", x: -3.6, z: 27.4, yaw: 1.8 },
70
+ { kind: "bottle", x: 8.1, z: 24.6, yaw: 0 },
71
+ ];
72
+
73
+ type LoadedModel = { scene: Group; animations: AnimationClip[] };
74
74
 
75
75
  export class Play extends Scene<GameState, IPhysicsContext> {
76
76
  static override readonly initialState: GameState = {
77
- paused: false,
78
- uiReady: false,
79
- aimedShots: 0,
80
- aiming: 0,
77
+ aiming: false,
81
78
  ammo: MAGAZINE,
82
- reserve: RESERVE,
83
- reloading: 0,
84
- armor: 0,
85
- cameraShakes: 0,
86
- deaths: 0,
87
- demoDamage: 0,
88
- demoTargetAlive: 1,
89
- friendlyPassed: 0,
90
- gameOver: 0,
91
- gameWon: 0,
79
+ blips: [],
80
+ distanceMoved: 0,
92
81
  health: 100,
93
- hitDistanceTenths: 0,
94
- hitNormalXPercent: -101,
95
- hitNormalYPercent: -101,
96
- hitNormalZPercent: -101,
97
- lives: 3,
98
- nameplateFacingCamera: 0,
99
- pickupFrame: 0,
100
- pickupFrameChanges: 0,
101
- pickups: 0,
102
- pitchDegrees: 0,
103
- radiusInsideDeaths: 0,
104
- radiusMidAlive: 1,
105
- radiusNearAlive: 1,
106
- radiusOutsideAlive: -1,
107
- respawns: 0,
108
- scanCount: 0,
109
- score: 0,
110
- shotsFired: 0,
111
- targetsRemaining: 1,
112
- wave: 1,
113
- wavesCleared: 0,
114
- wallBlocked: 0,
115
- yawDegrees: 0,
82
+ hitFlash: 0,
83
+ hurtFlash: 0,
116
84
  phase: "playing",
85
+ playerX: 0,
86
+ playerYaw: 0,
87
+ playerZ: 32,
88
+ reloads: 0,
89
+ reserve: RESERVE,
90
+ score: 0,
91
+ shots: 0,
92
+ targetsHit: 0,
93
+ timeRemaining: RUN_SECONDS,
117
94
  };
118
95
 
119
- override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
120
- const camera = ctx.camera as PerspectiveCamera;
121
- const materials = createMaterials();
122
- setupSky(ctx.scene);
123
- const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
124
- // isMobile() arrives as an argument because src/render/ imports no framework package: the
125
- // platform decision is made here, in portable game code, exactly like createRandom.
126
- setupPost(ctx.renderer, ctx.scene, camera, { godraysLight: sun, mobile: isMobile() });
127
- const loading = createLoadingScreen(ctx);
128
- ctx.add(camera);
129
- const showTouchControls = isMobile() && isTouchscreenAvailable();
130
- const touchControls = showTouchControls
131
- ? ctx.entities.add("touch-controls", new TouchControls(camera))
132
- : undefined;
133
- const shake = new CameraShake(createArenaShakeOptions());
134
- const rig = createFirstPersonRig(camera, shake);
135
- const billboards: Billboard3D[] = [];
136
- const billboardFront = new Vector3(0, 0, 1);
137
- const billboardExpected = new Vector3();
138
- const billboardCameraPosition = new Vector3();
139
- const billboardObjectPosition = new Vector3();
140
- const billboardUp = new Vector3(0, 1, 0);
141
- const billboardExpectedUp = new Vector3();
142
- const billboardCameraQuaternion = new Quaternion();
143
- const billboardWorldQuaternion = new Quaternion();
144
- const spriteAnimators: SpriteAnimator3D[] = [];
145
- ctx.viewport.resize();
146
-
147
- const arena = createArena(materials);
148
- ctx.add(arena.group);
149
- buildStaticColliders(ctx, arena.group, {
150
- collisionLayer: WORLD_LAYER,
151
- collisionMask: PLAYER_LAYER | HOSTILE_LAYER | FRIENDLY_LAYER,
152
- predicate: (object) => object.name === "arena-floor" || object.name.startsWith("arena-wall-"),
153
- });
154
-
155
- const playerRef: { value?: Player } = {};
156
- const getPlayer = (): Player => {
157
- if (playerRef.value === undefined) throw new Error("Shooter player is not initialized.");
158
- return playerRef.value;
159
- };
160
- const targets = new Map<number, Target>();
161
- const waveTargets: TargetEntry[] = [];
162
- const projectiles: ProjectileEntry[] = [];
163
- const targetScratch: Target[] = [];
164
- let projectileIndex = 0;
165
- const waveDirector = new WaveDirector();
166
- const hitscan = new Hitscan();
167
- const spawnPoints = SPAWN_POINTS;
168
- const elapsed = { value: 0 };
169
- const enemyDirection = new Vector3();
170
- const decalPoint = new Vector3();
171
- const decalNormal = new Vector3();
172
-
173
- const onEnemyProjectileHit = (hit: IRayHit): void => {
174
- if (hit.body.id === getPlayer().body.body.id) {
175
- getPlayer().takeDamage(20);
176
- burst(impactDustVfx, hit.position, "vfx-impact");
177
- emitPlaytestEvent({ entity: "player", name: "projectile-hit" });
178
- }
179
- };
180
- const onPlayerProjectileHit = (hit: IRayHit): void => {
181
- if (applyDirectDamage(targets, hit.body.id, 22)) {
182
- burst(impactVfx, hit.position, "vfx-impact");
183
- emitPlaytestEvent({ entity: "player", name: "projectile-defeated" });
96
+ #assets:
97
+ | {
98
+ enemy: LoadedModel;
99
+ viewmodel: LoadedModel;
100
+ sky: Texture;
184
101
  }
185
- };
186
-
187
- const acquireProjectile = (
188
- origin: Vector3,
189
- direction: Vector3,
190
- collisionMask: number,
191
- onHit: (hit: IRayHit) => void,
192
- ): void => {
193
- for (const entry of projectiles) {
194
- if (!entry.value.dead || entry.collisionMask !== collisionMask) continue;
195
- entry.value.reset(origin, direction, onHit);
196
- return;
197
- }
198
- const id = `projectile.pool.${projectileIndex++}`;
199
- const projectile = new Projectile(ctx, materials, origin, direction, collisionMask, onHit);
200
- projectiles.push({ collisionMask, id, value: projectile });
201
- ctx.entities.add(id, projectile);
202
- };
203
-
204
- const createEnemyProjectile = (origin: Vector3): void => {
205
- const direction = enemyDirection.copy(getPlayer().mesh.position).sub(origin).normalize();
206
- acquireProjectile(origin, direction, WORLD_LAYER | PLAYER_LAYER, onEnemyProjectileHit);
207
- };
102
+ | undefined;
103
+
104
+ override async load(ctx: GameCtx): Promise<void> {
105
+ // Three files, and one of them is the whole town: the geometry is procedural
106
+ // (`render/town.ts`), so the only downloads are two rigs and one photograph.
107
+ //
108
+ // - `mannequin-combat.glb` is Quaternius' UAL mannequin (CC0), the soldiers.
109
+ // - `player-viewmodel.glb` is "Animated FPS hands (rifle animation pack)" by
110
+ // Cransh, CC-BY-4.0 — https://sketchfab.com/3d-models/animated-fps-hands-rifle-animation-pack-5f2d0ed780a94724b36ab505f7564057
111
+ // - `sky.jpg` is Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)" by
112
+ // Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky),
113
+ // and is background, environment light and fog colour at once (`render/sky.ts`).
114
+ // No per-asset progress is published to the HUD: `src/render/loading.ts` is the one boot
115
+ // surface, it rides `ctx.startup`, and a second bar drawn over it was the two-bar screen.
116
+ const [enemy, viewmodel, sky] = await Promise.all([
117
+ ctx.assets.model<LoadedModel>("mannequin-combat.glb"),
118
+ ctx.assets.model<LoadedModel>("player-viewmodel.glb"),
119
+ ctx.assets.texture("sky.jpg"),
120
+ ]);
121
+ this.#assets = { enemy, viewmodel, sky };
122
+ }
208
123
 
209
- const registerTarget = (
210
- id: string,
211
- position: Vector3,
212
- options: ConstructorParameters<typeof Target>[3] = {},
213
- scan = true,
214
- ): Target => {
215
- const target = new Target(ctx, materials, position, {
216
- ...options,
217
- onFire: options.onFire ?? createEnemyProjectile,
218
- });
219
- const nameplate = target.mesh.getObjectByName("target-nameplate");
220
- if (nameplate === undefined)
221
- throw new Error("Shooter target visual is missing its target-nameplate.");
222
- billboards.push(new Billboard3D(nameplate, { camera }));
223
- targets.set(target.body.body.id, target);
224
- ctx.entities.add(id, target);
225
- if (scan) target.startScanning(ctx, getPlayer().body.body.id);
226
- return target;
227
- };
124
+ override exit(): void {
125
+ // The hook closes over this scene's player. Leaving it registered means a restart keeps
126
+ // syncing the camera to the torn-down body until `enter` happens to overwrite it.
127
+ onAfterPhysics(undefined);
128
+ }
228
129
 
229
- const removeEntity = (id: string): void => {
230
- if (ctx.entities.get(id) !== undefined) ctx.entities.remove(id);
231
- };
130
+ override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
131
+ const assets = this.#assets;
132
+ if (assets === undefined) throw new Error("Town assets did not load.");
232
133
 
233
- const onDamage = (amount: number): void => {
234
- const previous = ctx.state.getState();
235
- ctx.state.set({ health: getPlayer().health, score: previous.score, armor: 0 });
236
- emitPlaytestEvent({ entity: "player", name: "damaged", amount });
237
- };
134
+ const camera = ctx.camera as PerspectiveCamera;
135
+ setupSky(ctx.scene, assets.sky);
136
+ // The shadow map is fitted to the town, not to the arena this template's lighting was
137
+ // written for, and both this call and the post chain below are told whether this is a phone
138
+ // — a 2048² map and the `low` tier instead of a 4096² map plus full-resolution GTAO over 832
139
+ // renderables, which is not a phone's frame. `isMobile` is passed in rather than imported
140
+ // because `src/render/` reads no framework package.
141
+ const mobile = isMobile();
142
+ const { key } = setupLighting(
143
+ ctx.scene,
144
+ ctx.renderer.raw as Parameters<typeof setupLighting>[1],
145
+ TOWN_HALF,
146
+ mobile,
147
+ );
148
+ setupPost(ctx.renderer, ctx.scene, camera, {
149
+ godraysLight: key,
150
+ mobile,
151
+ software: ctx.renderer.softwareAdapter !== undefined,
152
+ });
153
+ ctx.add(camera);
238
154
 
239
- const onDeath = (): void => {
240
- const previous = ctx.state.getState();
241
- const lives = Math.max(0, previous.lives - 1);
242
- const deaths = previous.deaths + 1;
243
- ctx.state.set({
244
- deaths,
245
- gameOver: lives === 0 ? 1 : 0,
246
- lives,
247
- phase: lives === 0 ? "lost" : "dead",
248
- });
249
- emitPlaytestEvent({ entity: "player", name: "died", lives });
250
- if (lives === 0) return;
251
- ctx.after(0.5, () => {
252
- waveDirector.reset();
253
- targetScratch.length = 0;
254
- for (const entry of waveTargets) targetScratch.push(entry.target);
255
- const spawn = spawnPoints.furthestFrom(targetScratch);
256
- getPlayer().respawn(spawn);
257
- const state = ctx.state.getState();
258
- ctx.state.set({
259
- health: getPlayer().health,
260
- phase: "playing",
261
- respawns: state.respawns + 1,
262
- wave: waveDirector.wave,
263
- wavesCleared: waveDirector.cleared,
264
- });
265
- emitPlaytestEvent({ entity: "player", name: "respawned" });
266
- });
267
- };
155
+ // The in-canvas launch screen. It rides `startup.whenReady()` and prewarms the pipelines
156
+ // without waiting for them: holding the screen for a town-wide compile would run a whole
157
+ // playtest behind a progress bar.
158
+ const loading = createLoadingScreen(ctx);
159
+ const materials = createTownMaterials();
160
+ const town: Town = buildTown(materials);
161
+ ctx.add(town.group);
162
+ // Plates are raycast targets like any solid: without them in the list a round flies
163
+ // straight through and scores whatever soldier happens to stand behind the plate.
164
+ const plateMeshes: Object3D[] = [];
165
+ town.targets.forEach((spec, index) => {
166
+ const entity = `target-${index}`;
167
+ ctx.entities.remove(entity);
168
+ // The spec list is data; the plates themselves are entities so playtests can read them.
169
+ const plate = new Target(
170
+ {
171
+ face: materials.plateFace,
172
+ hit: materials.plateHit,
173
+ frame: materials.plateFrame,
174
+ steel: materials.steel,
175
+ },
176
+ spec,
177
+ );
178
+ // Plates live inside the town group like every other prop, so scene-wide
179
+ // audits that traverse the town find them where they belong.
180
+ town.group.add(plate.group);
181
+ ctx.entities.add(entity, plate);
182
+ plateMeshes.push(plate.plate);
183
+ });
268
184
 
269
- const player = new Player(ctx, camera, materials, SPAWN.clone(), onDamage, onDeath);
270
- playerRef.value = player;
271
- ctx.entities.add("player", player);
272
- const viewmodel = new Viewmodel(player.visual);
273
- ctx.entities.add("viewmodel", viewmodel);
274
- // Marks live on the scene root, not on what they hit: a hole is stuck to the world, and a
275
- // target that dies should not take the holes in the wall behind it with it.
276
- const decals = new DecalField(ctx.scene, { count: 24 });
277
- ctx.entities.add("decals", decals);
278
- // Two seconds in, every material this pool needs has been compiled; stop drawing the slots
279
- // nobody has used.
280
- ctx.after(2, () => decals.settle());
281
-
282
- const muzzleVfx = ctx.add(new GPUParticles3D(createMuzzleFlash()));
283
- const impactVfx = ctx.add(new GPUParticles3D(createImpactSparks()));
284
- const impactDustVfx = ctx.add(new GPUParticles3D(createImpactDust()));
285
- muzzleVfx.visible = false;
286
- impactVfx.visible = false;
287
- impactDustVfx.visible = false;
288
- const burst = (
289
- particles: GPUParticles3D,
290
- position: { readonly x: number; readonly y: number; readonly z: number },
291
- name: string,
185
+ // One fixed body per solid so the player slides along walls properly. These
186
+ // colliders have no visual, so they take a bare `position` and never allocate a
187
+ // carrier Object3D to hold a transform nothing reads.
188
+ const staticBody = (
189
+ centreX: number,
190
+ centreY: number,
191
+ centreZ: number,
192
+ sx: number,
193
+ sy: number,
194
+ sz: number,
292
195
  ): void => {
293
- particles.position.copy(position);
294
- particles.visible = true;
295
- particles.restart();
296
- ctx.after(0.45, () => {
297
- particles.visible = false;
196
+ new RigidBody3D({
197
+ physics: ctx.physics,
198
+ position: { x: centreX, y: centreY, z: centreZ },
199
+ shape: CollisionShape3D.box(sx, sy, sz),
200
+ type: "fixed",
298
201
  });
299
- emitPlaytestEvent({ entity: "player", name });
300
202
  };
301
-
302
- const demo = registerTarget(
303
- "demo-target",
304
- DEMO_POSITION,
305
- { health: 20, onFire: () => undefined },
306
- false,
307
- );
308
- registerTarget("scan-target", SCAN_POSITION, { health: 20, onFire: () => undefined });
309
- const friendly = createFriendlyVisual(materials);
310
- friendly.name = "friendly-drone";
311
- friendly.position.set(0, 1, 1.4);
312
- ctx.add(friendly);
313
- const friendlyBody = new RigidBody3D({
314
- collisionLayer: FRIENDLY_LAYER,
315
- collisionMask: 0,
316
- object: friendly,
317
- physics: ctx.physics,
318
- shape: CollisionShape3D.box(0.34, 1.5, 0.34),
319
- type: "fixed",
203
+ for (const box of town.colliders) {
204
+ staticBody(
205
+ (box.min[0] + box.max[0]) / 2,
206
+ (box.min[1] + box.max[1]) / 2,
207
+ (box.min[2] + box.max[2]) / 2,
208
+ box.max[0] - box.min[0],
209
+ box.max[1] - box.min[1],
210
+ box.max[2] - box.min[2],
211
+ );
212
+ }
213
+ staticBody(0, -0.5, 0, TOWN_HALF * 2 + 4, 1, TOWN_HALF * 2 + 4);
214
+
215
+ const playerSetup = ctx.entities.get<{
216
+ readonly isObject3D?: boolean;
217
+ readonly position: Vector3;
218
+ readonly quaternion?: Quaternion;
219
+ }>("player");
220
+ ctx.entities.remove("player");
221
+ const player = new FpsPlayer(ctx, camera);
222
+ if (playerSetup?.isObject3D === true && playerSetup.position.lengthSq() > 1e-6) {
223
+ player.mesh.position.copy(playerSetup.position);
224
+ player.body.teleport(player.mesh.position);
225
+ // A scenario can aim the spawn through the placeholder's rotation. Only the
226
+ // look angles are taken (the body stays upright): forward's height is the
227
+ // pitch, its heading the yaw — identity falls out as the constructor defaults.
228
+ if (playerSetup.quaternion !== undefined) {
229
+ const forward = new Vector3(0, 0, -1).applyQuaternion(playerSetup.quaternion);
230
+ player.look.pitch = Math.asin(MathUtils.clamp(forward.y, -1, 1));
231
+ player.look.yaw = Math.atan2(-forward.x, -forward.z);
232
+ }
233
+ player.syncCamera();
234
+ }
235
+ ctx.entities.add("player", player);
236
+ // The camera is placed here, after rapier has written the solved transform, rather than at the
237
+ // end of `player.update` where `mesh.position` is still last step's. See `onAfterPhysics`.
238
+ // Split the physics step out of `outsideGame`.
239
+ //
240
+ onAfterPhysics(() => {
241
+ player.syncCamera();
320
242
  });
321
-
322
- const wall = createWallVisual(materials);
323
- wall.name = "probe-wall";
324
- wall.position.set(4, 1.4, 5);
325
- ctx.add(wall);
326
- const wallBody = new RigidBody3D({
327
- collisionLayer: WORLD_LAYER,
328
- collisionMask: PLAYER_LAYER | FRIENDLY_LAYER,
329
- object: wall,
330
- physics: ctx.physics,
331
- shape: CollisionShape3D.box(0.65, 2.8, 2.8),
332
- type: "fixed",
243
+ // Thumb controls. Registered so a scenario can assert a finger actually drove the player,
244
+ // and read every tick below before the player consumes its input.
245
+ // Two seconds in, every pooled pipeline has been through a real draw, so the unused slots can
246
+ // stop being submitted. Worth ~a third of the draw calls on a phone.
247
+ ctx.after(2, () => {
248
+ decals.settle();
249
+ smoke.settle();
250
+ impacts.settle();
251
+ rifle.settlePools();
252
+ breakables.settle();
253
+ enemyFlashes.settle();
254
+ playerTracers.settle();
255
+ enemyTracers.settle();
333
256
  });
334
257
 
335
- const radiusNear = registerTarget(
336
- "radius.near",
337
- new Vector3(0.8, 0.85, -4),
338
- { health: 30, onFire: () => undefined },
339
- false,
340
- );
341
- const radiusMid = registerTarget(
342
- "radius.mid",
343
- new Vector3(-1.8, 0.85, -4),
344
- { health: 30, onFire: () => undefined },
345
- false,
258
+ const touch = new TouchControls();
259
+ ctx.entities.remove("touch");
260
+ ctx.entities.add("touch", touch);
261
+ const rifle = new Rifle(
262
+ camera,
263
+ assets.viewmodel.scene as Object3D,
264
+ assets.viewmodel.animations,
265
+ ctx.scene,
346
266
  );
347
- const radiusOutside = registerTarget(
348
- "radius.outside",
349
- new Vector3(6.5, 0.85, -4),
350
- { health: 30, onFire: () => undefined },
351
- false,
352
- );
353
-
354
- // Well clear of every respawn point. At 1.2 m the player landed inside the pack's trigger the
355
- // instant they respawned, which handed back a full bar for dying — the opposite of what a
356
- // health pickup is for.
357
- const pickup = new Pickup(
358
- ctx,
359
- materials,
360
- new Vector3(-2.6, SPAWN.y, SPAWN.z),
361
- player.body.body.id,
362
- () => {
363
- player.health = Math.min(player.maxHealth, player.health + 60);
364
- const state = ctx.state.getState();
365
- ctx.state.set({
366
- armor: state.armor + 1,
367
- health: player.health,
368
- pickups: state.pickups + 1,
369
- });
370
- emitPlaytestEvent({ entity: "player", name: "collected" });
371
- ctx.after(4, () => pickup.respawn());
372
- },
373
- );
374
- ctx.entities.add("health-pickup", pickup);
375
- const pickupAnimation = pickup.mesh.getObjectByName("pickup-animation");
376
- if (
377
- !(pickupAnimation instanceof Mesh) ||
378
- !(pickupAnimation.material instanceof MeshBasicMaterial)
379
- )
380
- throw new Error("Shooter pickup visual is missing its animated sprite material.");
381
- if (pickupAnimation.material.map === null)
382
- throw new Error("Shooter pickup animated sprite is missing its atlas texture.");
383
- spriteAnimators.push(
384
- new SpriteAnimator3D({ frames: PICKUP_SPRITE_FRAMES, texture: pickupAnimation.material.map }),
385
- );
386
-
387
- const spawnWave = (wave: number): void => {
388
- const target = registerTarget(`wave.target.${wave}`, WAVE_POSITION.clone(), {
389
- health: 35,
390
- wave,
391
- });
392
- waveTargets.push({ id: `wave.target.${wave}`, target });
393
- ctx.state.set({ targetsRemaining: 1, wave });
394
- emitPlaytestEvent({ entity: "wave", name: "started", wave });
395
- };
396
- waveDirector.start(spawnWave);
397
- rig.snap(player);
398
- // The eye is placed here, after the solver wrote the step, and never inside the frame
399
- // callback. Placing it from `update` leaves the camera one physics step behind the body.
400
- afterPhysics(ctx, (dt) => rig.follow(player, dt));
401
-
402
- const resolveHitscanImpact = (
403
- hit: NonNullable<ReturnType<typeof hitscan.fire>>,
404
- state: GameState,
405
- ): void => {
406
- const target = targets.get(hit.body.id);
407
- if (target !== undefined) applyDirectDamage(targets, hit.body.id, 40);
408
- burst(impactVfx, hit.position, "vfx-impact");
409
- burst(impactDustVfx, hit.position, "vfx-impact-dust");
410
- // A round that leaves nothing behind teaches the player their shots land nowhere.
411
- decalPoint.set(hit.position.x, hit.position.y, hit.position.z);
412
- decalNormal.set(hit.normal.x, hit.normal.y, hit.normal.z);
413
- decals.place(decalPoint, decalNormal, target === undefined ? 1 : 0.7);
414
- const demoHit = hit.body.id === demo.body.body.id;
415
- shake.trigger();
416
- ctx.state.set({
417
- cameraShakes: state.cameraShakes + 1,
418
- demoTargetAlive: demo.alive ? 1 : 0,
419
- friendlyPassed: demoHit && friendlyBody.body.id !== hit.body.id ? 1 : state.friendlyPassed,
420
- ...(demoHit
267
+ ctx.entities.add("rifle", rifle);
268
+
269
+ // Five soldiers patrol the ground lanes, one per route — a full T side holding
270
+ // the town. The model asset is shared; each Enemy normalises its own copy out of
271
+ // the cached scene only once, so later soldiers clone the prepared rig.
272
+ const enemySetup = ctx.entities.get<{
273
+ readonly isObject3D?: boolean;
274
+ readonly position: Vector3;
275
+ }>("enemy");
276
+ ctx.entities.remove("enemy");
277
+ // A scenario that shoots a soldier needs one who does not patrol. Placing the
278
+ // optional "enemy-frozen" placeholder turns soldier 0 into a sentry standing at
279
+ // that spot for the whole round: presence is the flag, position is the spawn
280
+ // (facing +z, toward a player placed north of him). It takes precedence over the
281
+ // plain "enemy" placement when both are present. The placeholder parks off-map
282
+ // until placed (see game.ts), so an origin spawn is still a real placement.
283
+ const frozenSetup = ctx.entities.get<{
284
+ readonly isObject3D?: boolean;
285
+ readonly position: Vector3;
286
+ }>("enemy-frozen");
287
+ ctx.entities.remove("enemy-frozen");
288
+ const frozenSpawn =
289
+ frozenSetup?.isObject3D === true && frozenSetup.position.y > -100
290
+ ? frozenSetup.position.clone()
291
+ : undefined;
292
+ const navBounds = { min: -TOWN_HALF - 1, max: TOWN_HALF + 1 };
293
+ const enemies: Enemy[] = [];
294
+ for (let index = 0; index < town.enemyRoutes.length; index += 1) {
295
+ // Every soldier needs its own rig: the class mutates scale and pose, and the rifle is
296
+ // welded to its right hand, so a shared skeleton would be scaled twice.
297
+ const soldier = new Enemy(
298
+ ctx,
299
+ cloneSkeleton(assets.enemy.scene),
300
+ assets.enemy.animations,
301
+ town.colliders,
302
+ index === 0 && frozenSpawn !== undefined
421
303
  ? {
422
- demoDamage: state.demoDamage + 40,
423
- hitDistanceTenths: Math.round(hit.distance * 10),
424
- hitNormalXPercent: Math.round(hit.normal.x * 100),
425
- hitNormalYPercent: Math.round(hit.normal.y * 100),
426
- hitNormalZPercent: Math.round(hit.normal.z * 100),
304
+ route: [frozenSpawn],
305
+ navBounds,
306
+ decks: town.decks,
307
+ frozen: true,
427
308
  }
428
- : {}),
429
- });
430
- emitPlaytestEvent({
431
- entity: "player",
432
- name: "hit",
433
- distanceTenths: Math.round(hit.distance * 10),
434
- });
435
- if (target?.alive === false) emitPlaytestEvent({ entity: "target", name: "defeated" });
309
+ : {
310
+ route: town.enemyRoutes[index],
311
+ navBounds,
312
+ decks: town.decks,
313
+ },
314
+ );
315
+ if (index === 0 && frozenSpawn !== undefined) {
316
+ soldier.group.position.copy(frozenSpawn);
317
+ soldier.group.updateWorldMatrix(true, true);
318
+ } else if (
319
+ index === 0 &&
320
+ enemySetup?.isObject3D === true &&
321
+ enemySetup.position.lengthSq() > 1e-6
322
+ ) {
323
+ soldier.group.position.copy(enemySetup.position);
324
+ soldier.group.updateWorldMatrix(true, true);
325
+ }
326
+ ctx.add(soldier.group);
327
+ ctx.entities.add(index === 0 ? "enemy" : `enemy-${index}`, soldier);
328
+ enemies.push(soldier);
329
+ }
330
+
331
+ // Vessels standing about the town that come apart when they are shot. They are the one thing
332
+ // in the world that answers a round with more than a mark, which is what stops the town
333
+ // reading as a shooting gallery with scenery painted on it.
334
+ const breakables = new BreakableField(ctx.scene, ctx.physics, () => ctx.random());
335
+ for (const spot of BREAKABLE_SPOTS) {
336
+ breakables.add(spot.kind, { x: spot.x, y: 0, z: spot.z }, spot.yaw);
337
+ }
338
+ ctx.entities.remove("breakables");
339
+ ctx.entities.add("breakables", breakables);
340
+
341
+ // Hitscan picks against an explicit list: the town solids, the plates and the
342
+ // soldier proxies. Raycasting the whole scene would also hit the viewmodel welded
343
+ // to the camera and score every shot as a miss at 0.4 m.
344
+ const hittable: Object3D[] = [
345
+ ...town.hittable,
346
+ ...plateMeshes,
347
+ ...breakables.hittable(),
348
+ ...enemies.map((e) => e.hitbox),
349
+ ];
350
+ // Sight lines treat a standing plate like the old range did: thin dressing the
351
+ // LOS check skips by its userData, but a solid that can still stop a round.
352
+ // Sight lines are answered in two stages, cheap first.
353
+ //
354
+ // The raycast on its own cost 15.4 ms of a 16.3 ms frame across five soldiers — the whole
355
+ // mid-round hitch, in one call. Replacing it outright with a box test against the town's
356
+ // colliders was fast but wrong: a collider is a solid slab where the building has a doorway,
357
+ // so soldiers went blind through openings they should see through, and
358
+ // `enemy-reaches-walkway` started failing about half the time.
359
+ //
360
+ // So the box test is a pre-filter, not a replacement. Colliders are conservative — they cover
361
+ // at least as much as the walls they stand for — which means "no box in the way" is a
362
+ // trustworthy *clear*, and that is the common case while a firefight is in the open. Only a
363
+ // box-blocked line needs the exact answer, and that is where the doorways are.
364
+ const boxes = new BoxOccluders(town.colliders);
365
+ ctx.entities.remove("occluders");
366
+ ctx.entities.add("occluders", boxes);
367
+ const occluders: Object3D[] = [...town.hittable, ...plateMeshes];
368
+
369
+ const lineOfSight = (from: Vector3, to: Vector3): boolean => {
370
+ if (boxes.clear(from, to)) return true;
371
+ const direction = new Vector3().subVectors(to, from);
372
+ const distance = direction.length();
373
+ if (distance < 0.001) return true;
374
+ for (const hit of ctx.raycastAll({
375
+ direction: direction.multiplyScalar(1 / distance),
376
+ far: distance - 0.2,
377
+ origin: from,
378
+ targets: occluders,
379
+ })) {
380
+ // Plates and paint are thin dressing; only solids block sight.
381
+ if (hit.object.userData.target !== undefined) continue;
382
+ return false;
383
+ }
384
+ return true;
436
385
  };
437
386
 
387
+ // Impact bursts: flash, sparks, chips and dust in one pooled system keyed by
388
+ // surface — steel sprays fast bright sparks, stone/plaster throw pale chips
389
+ // under a dust cloud, wood spits brown splinters. One expanding circle read
390
+ // as a decal; a burst is what makes a hit look like material answering.
391
+ const impacts = new ImpactBursts(ctx.scene, () => ctx.random());
392
+ // Bullet holes. They stay put: a mark that fades tells the player their rounds went nowhere.
393
+ // What colour the crushed rim comes out is per material — steel burns bare and cold, plaster
394
+ // and stone go pale, wood darkens. See `decals.ts` for why the pool is shaped this way.
395
+ const decals = new DecalField(ctx.scene, {
396
+ countPerVariant: 56,
397
+ map: bulletHoleTexture(),
398
+ size: 0.13,
399
+ tints: {
400
+ plaster: 0xf3ead8,
401
+ stone: 0xd2cbbb,
402
+ steel: 0xb6bcc4,
403
+ wood: 0x8a6a44,
404
+ },
405
+ });
406
+ ctx.entities.remove("decals");
407
+ ctx.entities.add("decals", decals);
408
+ // `hit.face.normal` is object-local; transform it into world space before any
409
+ // spawn math, or rotated meshes send their bursts into the wall.
410
+ const impactNormal = new Vector3();
411
+ const impactUp = new Vector3(0, 1, 0);
412
+ // Player rounds trail warm white; the enemy's are red so you can tell incoming from
413
+ // outgoing at a glance, which is the whole point of seeing a trajectory at all.
414
+ // Unit-length tapered cylinder along +Y, base at the origin: scaling y stretches it end to
415
+ // end. Tapered — the far end is the glowing slug's head, the near end its thinning tail;
416
+ // a uniform tube read as a chalk line.
417
+ const tracerGeometry = new CylinderGeometry(0.009, 0.002, 1, 6, 1, true);
418
+ tracerGeometry.translate(0, 0.5, 0);
419
+ const tracerMaterial = (colour: number): MeshBasicMaterial =>
420
+ new MeshBasicMaterial({
421
+ blending: AdditiveBlending,
422
+ color: colour,
423
+ depthWrite: false,
424
+ // A tracer is a hot gas trail, not a painted line. At 0.9 the old 1.7 cm cylinder read
425
+ // as chalk drawn across the frame; thin and half-transparent over the additive blend is
426
+ // what makes it a thing that glowed rather than a thing that was drawn.
427
+ opacity: 0.55,
428
+ transparent: true,
429
+ });
430
+ const playerTracers = new TracerPool3D(ctx.scene, {
431
+ count: 12,
432
+ geometry: tracerGeometry,
433
+ material: tracerMaterial(0xffe6b0),
434
+ });
435
+ const enemyTracers = new TracerPool3D(ctx.scene, {
436
+ count: 16,
437
+ geometry: tracerGeometry,
438
+ material: tracerMaterial(0xff6a4d),
439
+ });
440
+ // Per-shot variation, computed here so replays stay seeded: two rounds must never read
441
+ // as one drawn line, and a point-blank round dies faster than a far one. The pool only
442
+ // applies these; the numbers are this game's.
443
+ const tracerShot = (distance: number): ITracerSpawnOptions => ({
444
+ // Long enough to see the round travel, short enough that it is gone before the next one.
445
+ lifetime: MathUtils.clamp(distance / 400, 0.025, 0.13),
446
+ segmentLength: 1.5 + ctx.random() * 0.8,
447
+ widthScale: 0.7 + ctx.random() * 0.5,
448
+ });
438
449
  /**
439
- * One round.
450
+ * Not every round is a tracer. A real belt carries one in four or five, and that is not a
451
+ * detail — it is the whole reason tracers read as individual rounds instead of a continuous
452
+ * beam. Drawing one per shot at 600 rounds a minute paints a solid stripe down the lane.
440
453
  *
441
- * The ray starts at the camera and runs down the camera's own forward axis, because that is
442
- * where the crosshair is drawn. Starting it at the muzzle instead puts the round a hand's
443
- * width to the right of where the player aimed, which is invisible at range and infuriating
444
- * up close. The muzzle is where the *flash* goes, and the weapon leans to meet this ray.
454
+ * The enemy's are more frequent because they are the player's only warning of where incoming
455
+ * fire is coming from; the player's own are sparse because they already know.
445
456
  */
446
- const fireHitscan = (whileAiming: boolean): void => {
447
- if (!viewmodel.fire()) return;
448
- const state = ctx.state.getState();
449
- const ray = player.aimRay();
450
- const hit = hitscan.fire(ctx.physics, ray.origin, ray.direction, HOSTILE_LAYER | WORLD_LAYER);
451
- burst(muzzleVfx, viewmodel.muzzlePoint(), "vfx-muzzle");
452
- ctx.state.set({
453
- aimedShots: whileAiming ? state.aimedShots + 1 : state.aimedShots,
454
- ammo: viewmodel.ammo,
455
- shotsFired: state.shotsFired + 1,
457
+ let playerTracerCursor = 0;
458
+ let enemyTracerCursor = 0;
459
+ const playerTracerDue = (): boolean => playerTracerCursor++ % 4 === 0;
460
+ const enemyTracerDue = (): boolean => enemyTracerCursor++ % 2 === 0;
461
+ // One hoisted rng closure shared by every per-shot spawn: a closure literal at a
462
+ // call site is a fresh allocation on every trigger pull.
463
+ const shotRng = (): number => ctx.random();
464
+
465
+ let elapsed = 0;
466
+ let hitFlash = 0;
467
+ // How red the screen is *right now*, because a round is landing. A separate scalar from
468
+ // `hitFlash` (which is the crosshair's scoring marker) and from `health`, because the
469
+ // vignette answers "am I being shot" and not "am I nearly dead": reading it off `health`
470
+ // gave a soldier at 40 with nobody shooting him a permanent red screen, and no feedback at
471
+ // all for the 70 rounds it takes to get there.
472
+ let hurtFlash = 0;
473
+ const eye = new Vector3();
474
+
475
+ const fire = (frameCtx: GameCtx, aimRay: { origin: Vector3; direction: Vector3 }): void => {
476
+ if (!rifle.fire()) return;
477
+ eye.copy(aimRay.origin);
478
+ const direction = aimRay.direction.clone().normalize();
479
+ player.recordFiringDirection(direction);
480
+ const hit = frameCtx.raycast({
481
+ direction,
482
+ far: RANGE_METRES,
483
+ origin: eye,
484
+ targets: hittable,
456
485
  });
457
- emitPlaytestEvent({ entity: "player", name: "fired", aimed: whileAiming ? 1 : 0 });
458
- if (hit !== undefined) resolveHitscanImpact(hit, state);
459
- };
460
-
461
- const reload = (): void => {
462
- if (viewmodel.reloading || viewmodel.ammo >= MAGAZINE || viewmodel.reserve <= 0) return;
463
- viewmodel.reload(ctx);
464
- ctx.state.set({ reloading: 1 });
465
- emitPlaytestEvent({ entity: "player", name: "reload-started" });
466
- };
467
-
468
- const fireProjectile = (): void => {
469
- const ray = player.aimRay();
470
- burst(muzzleVfx, viewmodel.muzzlePoint(), "vfx-muzzle");
471
- acquireProjectile(
472
- ray.origin,
473
- ray.direction,
474
- HOSTILE_LAYER | WORLD_LAYER,
475
- onPlayerProjectileHit,
476
- );
477
- };
478
-
479
- const fireRadius = (): void => {
480
- burst(impactDustVfx, BLAST_CENTRE, "vfx-blast");
481
- applyRadiusDamage(ctx.physics, BLAST_CENTRE, 3.5, 80, targets);
482
- let insideDeaths = 0;
483
- if (!radiusNear.alive) insideDeaths += 1;
484
- if (!radiusMid.alive) insideDeaths += 1;
485
- ctx.state.set({
486
- radiusInsideDeaths: insideDeaths,
487
- radiusMidAlive: radiusMid.alive ? 1 : 0,
488
- radiusNearAlive: radiusNear.alive ? 1 : 0,
489
- radiusOutsideAlive: radiusOutside.alive ? 1 : 0,
490
- });
491
- emitPlaytestEvent({ entity: "player", name: "radius-damage", defeated: insideDeaths });
492
- };
493
-
494
- const probeWall = (): void => {
495
- const from = player.mesh.position.clone().add(new Vector3(0, player.eyeHeight, 0));
496
- const to = from.clone().add(new Vector3(10, 0, 0));
497
- const hit = hitscan.probe(ctx.physics, from, to, WORLD_LAYER | FRIENDLY_LAYER);
498
- if (hit?.body.id !== wallBody.body.id) return;
499
- ctx.state.set({ wallBlocked: 1 });
500
- emitPlaytestEvent({ entity: "player", name: "wall-blocked" });
501
- };
502
-
503
- const removeDeadTargets = (): void => {
504
- if (!demo.alive && ctx.entities.get("demo-target") !== undefined) {
505
- removeEntity("demo-target");
506
- targets.delete(demo.body.body.id);
486
+ // Every soldier within earshot reacts, not just the closest one.
487
+ for (const soldier of enemies) soldier.hearShot(eye.clone());
488
+ // The trail is drawn whether or not the round connects — a miss you cannot see is a
489
+ // miss you cannot correct.
490
+ const barrel = rifle.barrelRay();
491
+ const distance = hit === undefined ? RANGE_METRES : hit.point.distanceTo(eye);
492
+ if (playerTracerDue()) {
493
+ playerTracers.spawn(barrel.origin, barrel.direction, distance, tracerShot(distance));
507
494
  }
508
- for (let index = waveTargets.length - 1; index >= 0; index -= 1) {
509
- const entry = waveTargets[index];
510
- if (entry?.target.alive !== false) continue;
511
- removeEntity(entry.id);
512
- targets.delete(entry.target.body.body.id);
513
- waveTargets.splice(index, 1);
495
+ playerFlash.spawn(barrel.origin, barrel.direction, shotRng);
496
+ if (hit === undefined) return;
497
+
498
+ const target = hit.object.userData.target as Target | undefined;
499
+ if (target !== undefined) {
500
+ if (!target.scorable) return;
501
+ const value = target.strike(frameCtx);
502
+ if (value > 0) {
503
+ frameCtx.state.set((state) => ({
504
+ score: state.score + value,
505
+ targetsHit: state.targetsHit + 1,
506
+ }));
507
+ hitFlash = 0.12;
508
+ }
509
+ return;
510
+ }
511
+ const struck = hit.object.userData.enemy as Enemy | undefined;
512
+ if (struck !== undefined) {
513
+ const multiplier =
514
+ hit.point.y >= struck.headZoneMinY ? 4 : hit.point.y < struck.legZoneMaxY ? 0.7 : 1;
515
+ struck.recordHit(multiplier, direction);
516
+ const earned = struck.hurt(frameCtx, ROUND_DAMAGE * multiplier);
517
+ if (earned > 0) {
518
+ frameCtx.state.set((state) => ({
519
+ score: state.score + earned,
520
+ targetsHit: state.targetsHit + 1,
521
+ }));
522
+ hitFlash = 0.12;
523
+ }
524
+ return;
514
525
  }
526
+ impactNormal.copy(hit.face?.normal ?? impactUp).transformDirection(hit.object.matrixWorld);
527
+ // A vessel answers a round by coming apart, not by taking a mark. Ask first: the breakable
528
+ // branch consumes the hit, so nothing below stamps a bullet hole into geometry that is no
529
+ // longer there.
530
+ if (breakables.shatter(hit.object, hit.point, direction) !== undefined) {
531
+ impacts.spawn(hit.point, impactNormal, "stone");
532
+ return;
533
+ }
534
+ // One tag, resolved once: the builder stamped `userData.surface` on every
535
+ // solid at construction, so VFX and decals read the same answer here
536
+ // instead of each walking its own name rules.
537
+ const surface = resolveSurface(hit.object);
538
+ impacts.spawn(hit.point, impactNormal, surface);
539
+ // The mark outlives the burst. `impactNormal` is already in world space above; handing a
540
+ // raycast's object-local `face.normal` straight to a decal buries it in the wall.
541
+ decals.place(hit.point, impactNormal, surface, 0.82 + ctx.random() * 0.45);
515
542
  };
516
543
 
517
- const restart = (frameCtx: GameCtx): boolean => {
518
- if (!frameCtx.input.justPressed("restart")) return false;
519
- frameCtx.state.set(Play.initialState);
520
- frameCtx.state.flush();
521
- void frameCtx.goto("play");
522
- return true;
523
- };
544
+ // A muzzle flash is three things at once: a bright star-silhouette card, a light
545
+ // that touches the world, and smoke that outlives both. One round glow alone
546
+ // reads as a lamp switching on; the uneven rays are what say "gunshot".
547
+ //
548
+ // One flash per shooter, never one shared between them. The squad used to share a single
549
+ // quad and a single lifetime, so any soldier firing reset it for all of them — under
550
+ // sustained fire from five men the lifetime never reached zero and the flash sat lit at the
551
+ // last muzzle that fired, which is the "flash that never gets destroyed". See
552
+ // `MuzzleFlashPool` for the whole story.
553
+ const smokeSprite = softCircleTexture(64, 0.05);
554
+ const enemyFlashes = new MuzzleFlashPool(ctx.scene, 6, {
555
+ colour: 0xffd79a,
556
+ forwardOffset: 0.22,
557
+ life: 0.05,
558
+ lightColour: 0xffb347,
559
+ lightDistance: 11,
560
+ // Brighter than before but over a shorter life. Peak brightness is what says "explosion at
561
+ // the muzzle"; duration is what makes the same light read as a lamp someone switched on.
562
+ lightIntensity: 44,
563
+ size: scale.muzzleFlash * 1.25,
564
+ });
565
+ // Registered so a scenario can prove a squad's flashes retire. Sustained fire from five
566
+ // soldiers is exactly the case that used to hold the old single shared flash open forever.
567
+ ctx.entities.remove("enemy-flashes");
568
+ ctx.entities.add("enemy-flashes", {
569
+ debug: (): { peakOpacity: number } => ({ peakOpacity: enemyFlashes.peakOpacity() }),
570
+ });
524
571
 
525
- const handleAimEdges = (frameCtx: GameCtx): void => {
526
- if (frameCtx.input.justPressed("aim")) {
527
- ctx.state.set({ aiming: 1 });
528
- emitPlaytestEvent({ entity: "player", name: "aim-engaged" });
529
- }
530
- if (frameCtx.input.justReleased("aim")) {
531
- ctx.state.set({ aiming: 0 });
532
- emitPlaytestEvent({ entity: "player", name: "aim-released" });
572
+ // The player's own flash is drawn in world space at the measured muzzle tip:
573
+ // the star card reads on camera and the light kicks the wall ahead of the
574
+ // barrel for a frame. Rifle's suppressed cone stays as the tight forward core.
575
+ const playerFlash = new MuzzleFlash(ctx.scene, {
576
+ colour: 0xffd9a0,
577
+ forwardOffset: 0.06,
578
+ life: 0.06,
579
+ lightColour: 0xffb347,
580
+ lightDistance: 14,
581
+ lightIntensity: 40,
582
+ size: 0.34,
583
+ });
584
+
585
+ const smokeMaterial = new MeshBasicMaterial({
586
+ color: 0xb9bec6,
587
+ depthWrite: false,
588
+ map: smokeSprite,
589
+ opacity: 0.5,
590
+ transparent: true,
591
+ });
592
+ // Enemy muzzle smoke rides the same pooled-billboard mechanism as the player's.
593
+ // Scratch vectors keep the fire path allocation-free; the three random draws per
594
+ // puff keep their original order so seeded replays stay identical.
595
+ const smoke = new PooledBillboards(ctx.scene, {
596
+ count: 10,
597
+ geometry: new PlaneGeometry(0.4, 0.4),
598
+ materialPrototype: smokeMaterial,
599
+ });
600
+ const smokeAt = new Vector3();
601
+ const smokeDrift = new Vector3();
602
+ const spawnSmoke = (at: Vector3, forward: Vector3, ctxFrame: GameCtx): void => {
603
+ for (let index = 0; index < 2; index += 1) {
604
+ const driftX = (ctxFrame.random() - 0.5) * 0.5;
605
+ const driftY = 0.55 + ctxFrame.random() * 0.35;
606
+ const driftZ = (ctxFrame.random() - 0.5) * 0.5;
607
+ smoke.spawn({
608
+ at: smokeAt.copy(at).addScaledVector(forward, 0.3 + index * 0.16),
609
+ drift: smokeDrift.set(driftX, driftY, driftZ),
610
+ life: 0.75,
611
+ opacity: 0.5,
612
+ scaleFrom: 0.35,
613
+ scaleTo: 1.475,
614
+ });
533
615
  }
534
616
  };
535
617
 
536
- const handleInput = (frameCtx: GameCtx, touch?: ITouchInput): void => {
537
- handleAimEdges(frameCtx);
538
- // Held *or* just pressed, and the weapon's cyclic cooldown decides which of those frames
539
- // sends a round — so a tap and a held trigger run exactly the same path. The edge is not
540
- // redundant: a mouse button that goes down and up between two fixed-step ticks leaves a
541
- // latched edge and no held state, which is how a click can otherwise fire nothing at all.
542
- const trigger =
543
- frameCtx.input.pressed("fire") ||
544
- frameCtx.input.justPressed("fire") ||
545
- touch?.firePressed === true;
546
- if (trigger) fireHitscan(player.aiming);
547
- if (frameCtx.input.justPressed("reload") || touch?.reloadPressed === true) reload();
548
- if (frameCtx.input.justPressed("projectile")) fireProjectile();
549
- if (frameCtx.input.justPressed("blast")) fireRadius();
550
- if (frameCtx.input.justPressed("probe")) probeWall();
551
- if (frameCtx.input.justPressed("damage")) player.takeDamage(35);
552
- if (frameCtx.input.justPressed("lethal")) player.takeDamage(player.health + 1);
618
+ const hooks = {
619
+ lineOfSight,
620
+ damagePlayer: (amount: number): void => {
621
+ player.hurt(amount);
622
+ hurtFlash = 1;
623
+ },
624
+ onMuzzleFlash: (at: Vector3, direction: Vector3, distance: number): void => {
625
+ enemyFlashes.spawn(at, direction, shotRng);
626
+ if (enemyTracerDue()) enemyTracers.spawn(at, direction, distance, tracerShot(distance));
627
+ spawnSmoke(at, direction, ctx);
628
+ },
553
629
  };
554
630
 
555
- const updateProjectiles = (frameCtx: GameCtx, dt: number): void => {
556
- for (const entry of projectiles) entry.value.update(frameCtx, dt);
631
+ // What the renderer actually drew last frame, so a scenario can fail on an empty picture.
632
+ //
633
+ // Every gate in this project is blind to how the game looks, and that is not a slogan: a
634
+ // `prewarm(ctx.scene)` call once put every material in the town at zero opacity, and the whole
635
+ // suite stayed green. Decals still "placed", soldiers still pathfound, diagnostics were clean,
636
+ // and the frame budget *improved*, because a level nobody draws is cheap. `survives` checks for
637
+ // a nonblank frame and passed too — the sky and the clouds are not blank.
638
+ //
639
+ // Triangles are the assertion that would have caught it. A game drawing its level submits
640
+ // hundreds of thousands of them; a game drawing only its sky submits a handful.
641
+ const renderInfo = (): {
642
+ drawCalls: number;
643
+ triangles: number;
644
+ invisibleMeshes: number;
645
+ } => {
646
+ // drawCalls/triangles are the totals captured inside the frame callback
647
+ // (top of the returned frame callback below), because `renderer.info`
648
+ // resets at the start of each render — a between-frames read sees zeros.
649
+ // The capture lags one frame, which a settled assertion does not care about.
650
+ const invisibleMeshes = countInvisibleMeshes();
651
+ return {
652
+ drawCalls: lastWorldDraws,
653
+ triangles: lastWorldTriangles,
654
+ invisibleMeshes,
655
+ };
557
656
  };
558
-
559
- const updateWaves = (frameCtx: GameCtx): void => {
560
- let liveTargets = 0;
561
- for (const entry of waveTargets) if (entry.target.alive) liveTargets += 1;
562
- waveDirector.update(frameCtx, liveTargets, spawnWave, (wave) => {
563
- const state = frameCtx.state.getState();
564
- frameCtx.state.set({ score: state.score + 100, wavesCleared: waveDirector.cleared });
565
- emitPlaytestEvent({ entity: "wave", name: "cleared", wave });
657
+ let lastWorldDraws = 0;
658
+ let lastWorldTriangles = 0;
659
+ const countInvisibleMeshes = (): number => {
660
+ // Meshes the renderer is still drawing that cannot possibly show up: fully transparent.
661
+ //
662
+ // Counting pixels does not catch this. A scene whose materials are all at zero opacity
663
+ // submits *more* triangles than a healthy one, because transparency pushes every mesh off
664
+ // the projection's batched lane, and the resulting sky-only picture is neither blank nor
665
+ // notably brighter than the real one — both a nonblank-ratio and a dark-pixel-ratio
666
+ // assertion passed on it. The invariant that actually holds is simpler: nothing in this
667
+ // game's level is supposed to be invisible, so any solid mesh at zero opacity is a defect.
668
+ let invisibleMeshes = 0;
669
+ ctx.scene.traverse((object) => {
670
+ const mesh = object as { isMesh?: boolean; material?: unknown };
671
+ if (mesh.isMesh !== true || mesh.material === undefined) return;
672
+ const surfaces = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
673
+ for (const surface of surfaces) {
674
+ const material = surface as { opacity?: number; visible?: boolean };
675
+ if (material.visible === false) continue;
676
+ if ((material.opacity ?? 1) <= 0) invisibleMeshes += 1;
677
+ }
566
678
  });
567
- if (waveDirector.won) frameCtx.state.set({ gameWon: 1, phase: "won" });
679
+ return invisibleMeshes;
568
680
  };
569
-
570
- let lastAmmo = -1;
571
- let lastReserve = -1;
572
- let lastReloading = -1;
573
- const weaponPatch: Partial<GameState> = {};
574
- const publishWeapon = (frameCtx: GameCtx): void => {
575
- const reloading = viewmodel.reloading ? 1 : 0;
576
- if (
577
- viewmodel.ammo === lastAmmo &&
578
- viewmodel.reserve === lastReserve &&
579
- reloading === lastReloading
580
- )
681
+ ctx.entities.remove("render");
682
+ ctx.entities.add("render", { debug: renderInfo });
683
+ return (frameCtx, dt) => {
684
+ loading.update();
685
+ // The totals of the frame that just finished, read before this frame's
686
+ // render resets `renderer.info` — the `render` entity serves these to the
687
+ // draw-budget scenario. A between-frames read would see zeros.
688
+ const lastInfo = ctx.renderer.info as
689
+ | { render?: { drawCalls?: number; triangles?: number } }
690
+ | undefined;
691
+ lastWorldDraws = lastInfo?.render?.drawCalls ?? 0;
692
+ lastWorldTriangles = lastInfo?.render?.triangles ?? 0;
693
+ if (frameCtx.input.justPressed("restart")) {
694
+ frameCtx.state.set(Play.initialState);
695
+ frameCtx.state.flush();
696
+ void frameCtx.goto("play");
581
697
  return;
582
- if (lastReloading === 1 && reloading === 0)
583
- emitPlaytestEvent({ entity: "player", name: "reloaded" });
584
- lastAmmo = viewmodel.ammo;
585
- lastReserve = viewmodel.reserve;
586
- lastReloading = reloading;
587
- weaponPatch.ammo = viewmodel.ammo;
588
- weaponPatch.reserve = viewmodel.reserve;
589
- weaponPatch.reloading = reloading;
590
- frameCtx.state.set(weaponPatch);
591
- };
698
+ }
592
699
 
593
- const hudPatch: Partial<GameState> = {};
594
- const lookPatch: Partial<GameState> = {};
595
- let lastHealth = -1;
596
- let lastScanCount = -1;
597
- let lastTargetsRemaining = -1;
598
- let lastWave = -1;
599
- let lastWavesCleared = -1;
600
- let lastPickupFrame = -1;
601
- const pickupPatch: Partial<GameState> = {};
602
- const nameplatePatch: Partial<GameState> = {};
603
- const syncNameplateFacingCamera = (frameCtx: GameCtx): void => {
604
- const nameplate = billboards[0]?.object;
605
- if (nameplate === undefined) return;
606
- nameplate.updateWorldMatrix(true, false);
607
- camera.getWorldPosition(billboardCameraPosition);
608
- nameplate.getWorldPosition(billboardObjectPosition);
609
- billboardExpected.subVectors(billboardCameraPosition, billboardObjectPosition).normalize();
610
- billboardFront
611
- .set(0, 0, 1)
612
- .applyQuaternion(nameplate.getWorldQuaternion(billboardWorldQuaternion));
613
- camera.getWorldQuaternion(billboardCameraQuaternion);
614
- billboardExpectedUp
615
- .set(0, 1, 0)
616
- .applyQuaternion(billboardCameraQuaternion)
617
- .projectOnPlane(billboardExpected)
618
- .normalize();
619
- billboardUp
620
- .set(0, 1, 0)
621
- .applyQuaternion(nameplate.getWorldQuaternion(billboardWorldQuaternion));
622
- const nameplateFacingCamera =
623
- billboardFront.dot(billboardExpected) >= 0.999 &&
624
- billboardUp.dot(billboardExpectedUp) >= 0.999
625
- ? 1
626
- : 0;
627
- if (frameCtx.state.getState().nameplateFacingCamera === nameplateFacingCamera) return;
628
- nameplatePatch.nameplateFacingCamera = nameplateFacingCamera;
629
- frameCtx.state.set(nameplatePatch);
630
- };
631
- const syncStateAndHud = (frameCtx: GameCtx): void => {
632
- let liveTargets = 0;
633
- for (const entry of waveTargets) if (entry.target.alive) liveTargets += 1;
634
- let currentScanCount = 0;
635
- for (const target of targets.values()) currentScanCount += target.scanCount;
636
- const previous = frameCtx.state.getState();
637
- const scanCount = Math.max(previous.scanCount, currentScanCount);
638
- const wave = waveDirector.wave;
639
- const wavesCleared = waveDirector.cleared;
640
- if (
641
- player.health === lastHealth &&
642
- scanCount === lastScanCount &&
643
- liveTargets === lastTargetsRemaining &&
644
- wave === lastWave &&
645
- wavesCleared === lastWavesCleared
646
- )
700
+ // Every shot effect decays outside the phase gate. An early return with a quad still lit
701
+ // leaves it frozen in the world behind the end screen, which is indistinguishable from an
702
+ // effect that failed to clean itself up.
703
+ enemyFlashes.update(dt, eye);
704
+ impacts.update(dt, eye);
705
+ playerFlash.update(dt, eye);
706
+ breakables.update(dt);
707
+ smoke.update(dt, eye);
708
+ rifle.updateSmoke(dt, eye);
709
+ playerTracers.update(dt);
710
+ enemyTracers.update(dt);
711
+
712
+ const state = frameCtx.state.getState();
713
+ if (state.phase !== "playing") {
714
+ // The run is over: hold the frame, keep looking around, wait for Enter.
715
+ //
716
+ // The viewmodel's muzzle cone and its point light still have to retire. `rifle.update` is
717
+ // the pose-and-animation half and belongs to gameplay, but a round fired on the very frame
718
+ // the clock expired would otherwise leave the cone and the light burning on screen for as
719
+ // long as the end card is up.
720
+ rifle.decay(dt);
721
+ player.update(frameCtx, dt, false);
647
722
  return;
648
- lastHealth = player.health;
649
- lastScanCount = scanCount;
650
- lastTargetsRemaining = liveTargets;
651
- lastWave = wave;
652
- lastWavesCleared = wavesCleared;
653
- hudPatch.health = player.health;
654
- hudPatch.scanCount = scanCount;
655
- hudPatch.targetsRemaining = liveTargets;
656
- hudPatch.wave = wave;
657
- hudPatch.wavesCleared = wavesCleared;
658
- frameCtx.state.set(hudPatch);
659
- };
723
+ }
660
724
 
661
- /**
662
- * Publish where the player is looking.
663
- *
664
- * The player integrates the look deltas itself, inside `update`, on the same path a native
665
- * build takes. This only reports the result, and only when it changed — a state write every
666
- * frame would flush the bridge for nothing on a still mouse.
667
- */
668
- let lastYawDegrees = Number.NaN;
669
- let lastPitchDegrees = Number.NaN;
670
- const publishLook = (frameCtx: GameCtx): void => {
671
- const yawDegrees = Math.round(player.yawDegrees);
672
- const pitchDegrees = Math.round(player.pitchDegrees);
673
- if (yawDegrees === lastYawDegrees && pitchDegrees === lastPitchDegrees) return;
674
- lastYawDegrees = yawDegrees;
675
- lastPitchDegrees = pitchDegrees;
676
- lookPatch.yawDegrees = yawDegrees;
677
- lookPatch.pitchDegrees = pitchDegrees;
678
- frameCtx.state.set(lookPatch);
679
- };
725
+ elapsed += dt;
726
+ hitFlash = Math.max(0, hitFlash - dt * 2.4);
727
+ // About a third of a second: long enough to be a hit, short enough not to be a state.
728
+ hurtFlash = Math.max(0, hurtFlash - dt * 3);
729
+ const timeRemaining = Math.max(0, RUN_SECONDS - elapsed);
730
+
731
+ // Any press on the surface buys the pointer, which is what makes the mouse steer.
732
+ // This is deliberately not folded into the `fire` branch: gating it on the fire action
733
+ // means the view stays stuck until you take a shot, and aiming or simply clicking to
734
+ // start would leave the camera dead. Keyboard shots never reach here, so the playtests
735
+ // never ask for a lock they did not earn.
736
+ const pointer = frameCtx.input.raw.pointer;
737
+ // Never on a touch screen: there is no pointer to lock, the request is refused or prompts,
738
+ // and every thumb press would ask again. Thumb input needs no capture to steer.
739
+ if (pointer.down && !pointer.captured && !touch.engaged) {
740
+ frameCtx.input.captureMouse();
741
+ }
680
742
 
681
- return (frameCtx, dt) => {
682
- loading.update();
683
- elapsed.value += dt;
684
- if (restart(frameCtx)) return;
685
- const touch = touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size);
686
- // Look and stance first: the weapon pose and the shot both read this frame's aim, so a
687
- // round fired below would otherwise use last frame's crosshair.
688
- player.update(frameCtx, dt, touch);
689
- handleInput(frameCtx, touch);
690
- publishLook(frameCtx);
691
-
692
- const ray = player.aimRay();
693
- viewmodel.converge(ray.origin, ray.direction);
694
- viewmodel.update(dt, player.aiming, player.moving);
695
- publishWeapon(frameCtx);
696
- hitscan.update(dt);
697
- updateProjectiles(frameCtx, dt);
698
- for (const target of targets.values()) target.update(dt);
699
- for (const animator of spriteAnimators) animator.update(dt);
700
- const pickupFrame = spriteAnimators[0]?.frameIndex ?? 0;
701
- if (pickupFrame !== lastPickupFrame) {
702
- lastPickupFrame = pickupFrame;
703
- const previous = frameCtx.state.getState();
704
- pickupPatch.pickupFrame = pickupFrame;
705
- pickupPatch.pickupFrameChanges = previous.pickupFrameChanges + 1;
706
- frameCtx.state.set(pickupPatch);
743
+ player.touch = touch.update(frameCtx);
744
+ player.update(frameCtx, dt, !rifle.reloading);
745
+ const moveVector = frameCtx.input.vector("move");
746
+ const aimRay = player.aimRay();
747
+ rifle.converge(aimRay.origin, aimRay.direction);
748
+ rifle.update(dt, player.aiming, Math.min(1, Math.hypot(moveVector.x, moveVector.y)));
749
+ // Held, not tapped. The trigger is polled every frame and `Rifle` decides which of those
750
+ // frames sends a round, so a held button fires at the weapon's cyclic rate instead of asking
751
+ // the player to produce ten clicks a second by hand.
752
+ if (frameCtx.input.pressed("fire") || player.touch?.fire === true) fire(frameCtx, aimRay);
753
+ if (frameCtx.input.justPressed("reload") || player.touch?.reload === true) {
754
+ rifle.reload(frameCtx);
707
755
  }
708
- pickup.update(dt);
709
- removeDeadTargets();
710
- updateWaves(frameCtx);
711
- syncStateAndHud(frameCtx);
712
- for (const billboard of billboards) billboard.update();
713
- syncNameplateFacingCamera(frameCtx);
756
+
757
+ eye.set(player.eye.x, player.eye.y, player.eye.z);
758
+ for (const soldier of enemies) {
759
+ soldier.update(frameCtx, dt, eye, 0, hooks);
760
+ }
761
+
762
+ const hitCount = frameCtx.state.getState().targetsHit;
763
+ let phase: GameState["phase"] = "playing";
764
+ if (hitCount >= TARGET_GOAL) phase = "complete";
765
+ else if (player.health <= 0 || timeRemaining <= 0) phase = "failed";
766
+
767
+ frameCtx.state.set({
768
+ aiming: player.aiming,
769
+ ammo: rifle.ammo,
770
+ blips: enemies.map((soldier, index) => ({
771
+ id: index,
772
+ alive: soldier.alive,
773
+ x: soldier.group.position.x,
774
+ z: soldier.group.position.z,
775
+ })),
776
+ distanceMoved: player.distanceMoved,
777
+ health: player.health,
778
+ hitFlash,
779
+ hurtFlash,
780
+ phase,
781
+ playerX: player.mesh.position.x,
782
+ playerYaw: player.look.yaw,
783
+ playerZ: player.mesh.position.z,
784
+ reloads: rifle.reloads,
785
+ reserve: rifle.reserve,
786
+ score: frameCtx.state.getState().score,
787
+ shots: rifle.shots,
788
+ timeRemaining,
789
+ });
790
+ if (phase !== "playing") frameCtx.state.flush();
714
791
  };
715
792
  }
716
793
  }