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
@@ -0,0 +1,704 @@
1
+ import {
2
+ AdditiveBlending,
3
+ Color,
4
+ DataTexture,
5
+ type Material,
6
+ Matrix4,
7
+ Mesh,
8
+ MeshBasicMaterial,
9
+ NormalBlending,
10
+ type Object3D,
11
+ PlaneGeometry,
12
+ PointLight,
13
+ RGBAFormat,
14
+ type Texture,
15
+ UnsignedByteType,
16
+ Vector3,
17
+ } from "three";
18
+ import type { ImpactSurface } from "../surfaces.js";
19
+
20
+ /**
21
+ * A white disc that falls off to nothing at the rim: the smoke and dust sprite.
22
+ *
23
+ * Written here rather than imported from the core package because nothing under
24
+ * `src/render/` may import a package — this file is the user's to rewrite, and a
25
+ * framework call in it is one more thing to unlearn when the look changes. It is the
26
+ * same 20 lines the framework ships, and the reason it exists at all is in
27
+ * `particles.ts`: `CanvasTexture` samples black under `WebGPURenderer`.
28
+ */
29
+ export function softCircleTexture(size = 64, hardness = 0.05): Texture {
30
+ const data = new Uint8Array(size * size * 4);
31
+ const centre = (size - 1) / 2;
32
+ for (let y = 0; y < size; y += 1) {
33
+ for (let x = 0; x < size; x += 1) {
34
+ const dx = (x - centre) / centre;
35
+ const dy = (y - centre) / centre;
36
+ const distance = Math.sqrt(dx * dx + dy * dy);
37
+ const falloff = distance >= 1 ? 0 : Math.min(1, (1 - distance) / (1 - hardness)) ** 1.6;
38
+ const index = (y * size + x) * 4;
39
+ data[index] = 255;
40
+ data[index + 1] = 255;
41
+ data[index + 2] = 255;
42
+ data[index + 3] = Math.round(falloff * 255);
43
+ }
44
+ }
45
+ const texture = new DataTexture(data, size, size, RGBAFormat, UnsignedByteType);
46
+ texture.needsUpdate = true;
47
+ return texture;
48
+ }
49
+
50
+ /**
51
+ * Gunshot feedback, built as pixel data rather than painted canvases.
52
+ *
53
+ * What a gunshot needs to read is not one sprite but three time-scales at once: a
54
+ * flash that lives ~3 frames, debris that flies for a few hundred milliseconds,
55
+ * and dust that lingers after both are gone. Everything here is pooled and
56
+ * allocated once — the fire path may not allocate, or rapid fire GC-hitches.
57
+ *
58
+ * Textures are `DataTexture` for the reason recorded in `particles.ts`:
59
+ * `CanvasTexture` samples black under `WebGPURenderer`.
60
+ */
61
+
62
+ type Ray = { angle: number; length: number; width: number };
63
+
64
+ /** Uneven petal lengths are what separate a flash silhouette from a glow ball. */
65
+ const FLASH_RAYS: readonly Ray[] = [
66
+ { angle: 0.0, length: 0.98, width: 0.045 },
67
+ { angle: 0.17, length: 0.52, width: 0.03 },
68
+ { angle: 0.35, length: 0.82, width: 0.038 },
69
+ { angle: 0.53, length: 0.44, width: 0.028 },
70
+ { angle: 0.69, length: 0.94, width: 0.042 },
71
+ { angle: 0.86, length: 0.56, width: 0.03 },
72
+ ];
73
+
74
+ /**
75
+ * Star-shaped muzzle flash: a white-hot core with six tapered rays of uneven
76
+ * reach. Brightness lands in both RGB and alpha, with the core pushed towards
77
+ * pure white and the ray tips left warm, so the silhouette has temperature
78
+ * variation instead of one flat colour.
79
+ */
80
+ export function flashTexture(size = 128): Texture {
81
+ const data = new Uint8Array(size * size * 4);
82
+ const centre = (size - 1) / 2;
83
+ const coreRadius = size * 0.17;
84
+ const glowRadius = size * 0.36;
85
+ const raySpan = size * 0.48;
86
+ for (let y = 0; y < size; y += 1) {
87
+ for (let x = 0; x < size; x += 1) {
88
+ const px = x - centre;
89
+ const py = y - centre;
90
+ const distance = Math.sqrt(px * px + py * py);
91
+ let brightness = Math.max(0, 1 - distance / glowRadius) ** 2.2;
92
+ brightness += Math.max(0, 1 - distance / coreRadius) ** 1.4 * 1.35;
93
+ for (const ray of FLASH_RAYS) {
94
+ const rayAngle = ray.angle * Math.PI * 2;
95
+ const along = px * Math.cos(rayAngle) + py * Math.sin(rayAngle);
96
+ const reach = ray.length * raySpan;
97
+ if (along <= 0 || along >= reach) continue;
98
+ const across = Math.abs(-px * Math.sin(rayAngle) + py * Math.cos(rayAngle));
99
+ const falloff = 1 - along / reach;
100
+ brightness += Math.exp(-((across / (ray.width * size)) ** 2)) * falloff ** 1.7 * 1.15;
101
+ }
102
+ const value = Math.min(1, brightness);
103
+ const heat = Math.min(1, value * 1.6);
104
+ const index = (y * size + x) * 4;
105
+ data[index] = Math.round(value * 255);
106
+ data[index + 1] = Math.round(value * (196 + 59 * heat));
107
+ data[index + 2] = Math.round(value * (150 + 105 * heat));
108
+ data[index + 3] = Math.round(value * 255);
109
+ }
110
+ }
111
+ const texture = new DataTexture(data, size, size, RGBAFormat, UnsignedByteType);
112
+ texture.needsUpdate = true;
113
+ return texture;
114
+ }
115
+
116
+ /**
117
+ * Spark streak: bright round head at the top of the frame, fading tail below.
118
+ * Burst quads are stretched along their velocity with this mapped on, so the
119
+ * head always leads the motion.
120
+ */
121
+ function streakTexture(size = 64): Texture {
122
+ const data = new Uint8Array(size * size * 4);
123
+ const centre = (size - 1) / 2;
124
+ for (let y = 0; y < size; y += 1) {
125
+ for (let x = 0; x < size; x += 1) {
126
+ const across = Math.abs(x - centre) / centre;
127
+ const along = y / (size - 1);
128
+ const edges = Math.max(0, 1 - across) ** 1.8;
129
+ const value = edges * (0.18 + 0.82 * along ** 1.6);
130
+ const index = (y * size + x) * 4;
131
+ data[index] = Math.round(Math.min(1, value * 1.25) * 255);
132
+ data[index + 1] = Math.round(value * 235);
133
+ data[index + 2] = Math.round(value * 190);
134
+ data[index + 3] = Math.round(value * 255);
135
+ }
136
+ }
137
+ const texture = new DataTexture(data, size, size, RGBAFormat, UnsignedByteType);
138
+ texture.needsUpdate = true;
139
+ return texture;
140
+ }
141
+
142
+ /** How one surface answers a bullet. Counts are per burst; pools hold several. */
143
+ const SURFACE_STYLES: Readonly<
144
+ Record<
145
+ ImpactSurface,
146
+ {
147
+ flashColour: number;
148
+ flashScale: number;
149
+ chipColour: number;
150
+ chipCount: number;
151
+ chipSpeed: number;
152
+ chipSize: number;
153
+ dustColour: number;
154
+ dustCount: number;
155
+ dustSize: number;
156
+ sparkColour: number;
157
+ sparkCount: number;
158
+ sparkSpeed: number;
159
+ }
160
+ >
161
+ > = {
162
+ // Steel rings and sheds fast bright sparks that die mid-air.
163
+ steel: {
164
+ flashColour: 0xfff3d0,
165
+ flashScale: 0.62,
166
+ chipColour: 0xffcf7d,
167
+ chipCount: 3,
168
+ chipSpeed: 4.5,
169
+ chipSize: 0.026,
170
+ dustColour: 0x8d8d92,
171
+ dustCount: 1,
172
+ dustSize: 0.3,
173
+ sparkColour: 0xffe08a,
174
+ sparkCount: 11,
175
+ sparkSpeed: 9,
176
+ },
177
+ // Stone spalls pale chips and throws a real cloud.
178
+ stone: {
179
+ flashColour: 0xf2dcb2,
180
+ flashScale: 0.46,
181
+ chipColour: 0xcfc6b2,
182
+ chipCount: 6,
183
+ chipSpeed: 3.2,
184
+ chipSize: 0.034,
185
+ dustColour: 0xa39d90,
186
+ dustCount: 2,
187
+ dustSize: 0.52,
188
+ sparkColour: 0xd99c56,
189
+ sparkCount: 4,
190
+ sparkSpeed: 5.5,
191
+ },
192
+ // Plaster is softer: more dust, cream-coloured crumbs, almost no sparks.
193
+ plaster: {
194
+ flashColour: 0xefd9ae,
195
+ flashScale: 0.44,
196
+ chipColour: 0xe3dac4,
197
+ chipCount: 5,
198
+ chipSpeed: 2.6,
199
+ chipSize: 0.04,
200
+ dustColour: 0xbdb3a0,
201
+ dustCount: 3,
202
+ dustSize: 0.58,
203
+ sparkColour: 0xcf9a5c,
204
+ sparkCount: 2,
205
+ sparkSpeed: 4.5,
206
+ },
207
+ // Wood throws brown splinters and a tan puff; sparks barely feature.
208
+ wood: {
209
+ flashColour: 0xe8c795,
210
+ flashScale: 0.4,
211
+ chipColour: 0x7d5a36,
212
+ chipCount: 7,
213
+ chipSpeed: 3.6,
214
+ chipSize: 0.045,
215
+ dustColour: 0xa8875d,
216
+ dustCount: 2,
217
+ dustSize: 0.44,
218
+ sparkColour: 0xc47f3c,
219
+ sparkCount: 2,
220
+ sparkSpeed: 4,
221
+ },
222
+ };
223
+
224
+ type BurstSlot = {
225
+ age: number;
226
+ life: number;
227
+ mesh: Mesh;
228
+ velocity: Vector3;
229
+ spin: number;
230
+ seed: number;
231
+ baseScale: number;
232
+ };
233
+
234
+ const GRAVITY_SPARKS = 9;
235
+ const GRAVITY_CHIPS = 19;
236
+
237
+ // Scratch state for the spawn/update loops — nothing below allocates per shot.
238
+ const scratchBasisT1 = new Vector3();
239
+ const scratchBasisT2 = new Vector3();
240
+ const scratchDir = new Vector3();
241
+ const scratchAxisX = new Vector3();
242
+ const scratchAxisZ = new Vector3();
243
+ const scratchAxisY = new Vector3();
244
+ const scratchMatrix = new Matrix4();
245
+ const scratchColour = new Color();
246
+
247
+ /**
248
+ * Pooled impact bursts: an additive surface flash, velocity-stretched spark
249
+ * streaks, tumbling material chips and a lingering dust puff, styled per
250
+ * surface. Steel sprays bright fast sparks; stone and plaster throw pale chips
251
+ * under grey dust; wood spits brown splinters.
252
+ *
253
+ * Every mesh sits in the scene from construction at zero opacity — revealing a
254
+ * hidden mesh on the first shot makes WebGPU build its pipeline mid-frame.
255
+ */
256
+ export class ImpactBursts {
257
+ readonly #sparks: BurstSlot[] = [];
258
+ readonly #chips: BurstSlot[] = [];
259
+ readonly #dust: BurstSlot[] = [];
260
+ readonly #flashes: { age: number; baseScale: number; life: number; mesh: Mesh; roll: number }[] =
261
+ [];
262
+ /** Dead slots stop being submitted once their pipeline exists. See `settle`. */
263
+ #settled = false;
264
+ #sparkCursor = 0;
265
+ #chipCursor = 0;
266
+ #dustCursor = 0;
267
+ #flashCursor = 0;
268
+ readonly #rng: () => number;
269
+ readonly #streakMap: Texture;
270
+ readonly #dustMap: Texture;
271
+
272
+ constructor(parent: Object3D, rng: () => number) {
273
+ this.#rng = rng;
274
+ this.#streakMap = streakTexture();
275
+ this.#dustMap = softCircleTexture(64, 0.05);
276
+ const quad = new PlaneGeometry(1, 1);
277
+ const buildPool = (
278
+ count: number,
279
+ blending: typeof AdditiveBlending | typeof NormalBlending,
280
+ renderOrder: number,
281
+ map: Texture | undefined,
282
+ ): BurstSlot[] => {
283
+ const slots: BurstSlot[] = [];
284
+ for (let index = 0; index < count; index += 1) {
285
+ const material = new MeshBasicMaterial({
286
+ blending,
287
+ color: 0xffffff,
288
+ depthWrite: false,
289
+ map,
290
+ opacity: 0,
291
+ transparent: true,
292
+ });
293
+ const mesh = new Mesh(quad, material);
294
+ mesh.visible = true;
295
+ mesh.frustumCulled = false;
296
+ mesh.renderOrder = renderOrder;
297
+ parent.add(mesh);
298
+ slots.push({
299
+ age: 0,
300
+ baseScale: 1,
301
+ life: 0,
302
+ mesh,
303
+ seed: index * 1.618,
304
+ spin: 0,
305
+ velocity: new Vector3(),
306
+ });
307
+ }
308
+ return slots;
309
+ };
310
+ this.#sparks.push(...buildPool(40, AdditiveBlending, 26, this.#streakMap));
311
+ this.#chips.push(...buildPool(32, NormalBlending, 25, undefined));
312
+ this.#dust.push(...buildPool(18, NormalBlending, 24, this.#dustMap));
313
+ for (let index = 0; index < 6; index += 1) {
314
+ const material = new MeshBasicMaterial({
315
+ blending: AdditiveBlending,
316
+ color: 0xffffff,
317
+ depthWrite: false,
318
+ map: flashTexture(),
319
+ opacity: 0,
320
+ transparent: true,
321
+ });
322
+ const mesh = new Mesh(quad, material);
323
+ mesh.visible = true;
324
+ mesh.frustumCulled = false;
325
+ mesh.renderOrder = 27;
326
+ parent.add(mesh);
327
+ this.#flashes.push({ age: 0, baseScale: 1, life: 0, mesh, roll: 0 });
328
+ }
329
+ }
330
+
331
+ /** Throw one surface's worth of reaction off `at`, facing along `normal`. */
332
+ spawn(at: Vector3, normal: Vector3, surface: ImpactSurface): void {
333
+ const style = SURFACE_STYLES[surface];
334
+ // A tangent basis around the normal lets burst directions hug the surface
335
+ // hemisphere without calling out to allocation-heavy helpers.
336
+ scratchBasisT1.set(0, 1, 0);
337
+ if (Math.abs(normal.y) > 0.9) scratchBasisT1.set(1, 0, 0);
338
+ scratchBasisT1.cross(normal).normalize();
339
+ scratchBasisT2.crossVectors(normal, scratchBasisT1);
340
+
341
+ this.#spawnFlash(at, normal, style);
342
+ for (let index = 0; index < style.sparkCount; index += 1) this.#spawnSpark(at, normal, style);
343
+ for (let index = 0; index < style.chipCount; index += 1) this.#spawnChip(at, normal, style);
344
+ for (let index = 0; index < style.dustCount; index += 1) this.#spawnDust(at, normal, style);
345
+ }
346
+
347
+ #hemisphere(normal: Vector3, spread: number, out: Vector3): void {
348
+ const rng = this.#rng;
349
+ out
350
+ .copy(normal)
351
+ .addScaledVector(scratchBasisT1, (rng() * 2 - 1) * spread)
352
+ .addScaledVector(scratchBasisT2, (rng() * 2 - 1) * spread)
353
+ .normalize();
354
+ }
355
+
356
+ #spawnFlash(at: Vector3, normal: Vector3, style: (typeof SURFACE_STYLES)[ImpactSurface]): void {
357
+ const slot = this.#flashes[this.#flashCursor % this.#flashes.length];
358
+ this.#flashCursor += 1;
359
+ if (slot === undefined) return;
360
+ slot.mesh.position.copy(at).addScaledVector(normal, 0.035);
361
+ slot.baseScale = style.flashScale * (0.85 + this.#rng() * 0.4);
362
+ slot.roll = this.#rng() * Math.PI * 2;
363
+ slot.life = 0.075;
364
+ this.#wake(slot.mesh);
365
+ slot.age = 0;
366
+ (slot.mesh.material as MeshBasicMaterial).color.setHex(style.flashColour);
367
+ (slot.mesh.material as MeshBasicMaterial).opacity = 1;
368
+ }
369
+
370
+ #spawnSpark(at: Vector3, normal: Vector3, style: (typeof SURFACE_STYLES)[ImpactSurface]): void {
371
+ const slot = this.#sparks[this.#sparkCursor % this.#sparks.length];
372
+ this.#sparkCursor += 1;
373
+ if (slot === undefined) return;
374
+ this.#hemisphere(normal, 0.85, scratchDir);
375
+ slot.velocity.copy(scratchDir).multiplyScalar(style.sparkSpeed * (0.45 + this.#rng() * 0.85));
376
+ slot.mesh.position.copy(at).addScaledVector(normal, 0.012);
377
+ slot.age = 0;
378
+ slot.life = 0.2 + this.#rng() * 0.2;
379
+ this.#wake(slot.mesh);
380
+ slot.seed = this.#rng() * 10;
381
+ slot.baseScale = 1;
382
+ scratchColour.setHex(style.sparkColour);
383
+ const material = slot.mesh.material as MeshBasicMaterial;
384
+ material.color.copy(scratchColour);
385
+ material.opacity = 1;
386
+ }
387
+
388
+ #spawnChip(at: Vector3, normal: Vector3, style: (typeof SURFACE_STYLES)[ImpactSurface]): void {
389
+ const slot = this.#chips[this.#chipCursor % this.#chips.length];
390
+ this.#chipCursor += 1;
391
+ if (slot === undefined) return;
392
+ this.#hemisphere(normal, 1.15, scratchDir);
393
+ slot.velocity.copy(scratchDir).multiplyScalar(style.chipSpeed * (0.4 + this.#rng() * 0.9));
394
+ slot.mesh.position.copy(at).addScaledVector(normal, 0.01);
395
+ slot.mesh.scale.setScalar(style.chipSize * (0.6 + this.#rng() * 0.8));
396
+ slot.mesh.rotation.set(this.#rng() * Math.PI, this.#rng() * Math.PI, this.#rng() * Math.PI);
397
+ slot.spin = (this.#rng() * 2 - 1) * 18;
398
+ slot.age = 0;
399
+ slot.life = 0.38 + this.#rng() * 0.3;
400
+ this.#wake(slot.mesh);
401
+ slot.baseScale = slot.mesh.scale.x;
402
+ const material = slot.mesh.material as MeshBasicMaterial;
403
+ material.color.setHex(style.chipColour);
404
+ material.opacity = 1;
405
+ }
406
+
407
+ #spawnDust(at: Vector3, normal: Vector3, style: (typeof SURFACE_STYLES)[ImpactSurface]): void {
408
+ const slot = this.#dust[this.#dustCursor % this.#dust.length];
409
+ this.#dustCursor += 1;
410
+ if (slot === undefined) return;
411
+ slot.mesh.position
412
+ .copy(at)
413
+ .addScaledVector(normal, style.dustSize * 0.3)
414
+ .addScaledVector(scratchBasisT1, (this.#rng() * 2 - 1) * style.dustSize * 0.25)
415
+ .addScaledVector(scratchBasisT2, (this.#rng() * 2 - 1) * style.dustSize * 0.25);
416
+ // Dust hangs: a slow push off the wall, then near-stationary drift.
417
+ slot.velocity
418
+ .copy(normal)
419
+ .multiplyScalar(style.chipSpeed * 0.22)
420
+ .addScaledVector(scratchBasisT1, (this.#rng() * 2 - 1) * 0.2)
421
+ .addScaledVector(scratchBasisT2, (this.#rng() * 2 - 1) * 0.2);
422
+ slot.age = 0;
423
+ slot.life = 0.55 + this.#rng() * 0.3;
424
+ this.#wake(slot.mesh);
425
+ slot.baseScale = style.dustSize * (0.7 + this.#rng() * 0.5);
426
+ const material = slot.mesh.material as MeshBasicMaterial;
427
+ material.color.setHex(style.dustColour);
428
+ material.opacity = 0;
429
+ }
430
+
431
+ /** Integrate everything live; `eye` keeps flashes, dust and sparks camera-facing. */
432
+ /**
433
+ * Stop drawing spent bursts.
434
+ *
435
+ * Every slot is resident from frame one so its pipeline compiles during loading. On a phone the
436
+ * draw call costs more than the quad does, so a dead card is not free the way it is on a
437
+ * desktop; once the pipeline exists, hiding it is reversible for nothing.
438
+ */
439
+ settle(): void {
440
+ this.#settled = true;
441
+ for (const pool of [this.#sparks, this.#chips, this.#dust]) {
442
+ for (const slot of pool) if (slot.life <= 0) slot.mesh.visible = false;
443
+ }
444
+ for (const flash of this.#flashes) if (flash.life <= 0) flash.mesh.visible = false;
445
+ }
446
+
447
+ /** Show a slot that is being reused after `settle` hid it. */
448
+ #wake(mesh: Mesh): void {
449
+ if (this.#settled) mesh.visible = true;
450
+ }
451
+
452
+ update(dt: number, eye: Vector3): void {
453
+ for (const slot of this.#sparks) {
454
+ if (slot.life <= 0) continue;
455
+ slot.age += dt;
456
+ const t = slot.age / slot.life;
457
+ if (t >= 1) {
458
+ slot.life = 0;
459
+ if (this.#settled) slot.mesh.visible = false;
460
+ (slot.mesh.material as MeshBasicMaterial).opacity = 0;
461
+ continue;
462
+ }
463
+ slot.velocity.y -= GRAVITY_SPARKS * dt;
464
+ slot.velocity.multiplyScalar(Math.exp(-3.4 * dt));
465
+ slot.mesh.position.addScaledVector(slot.velocity, dt);
466
+ // Stretched billboard: the quad's long axis follows the velocity as seen
467
+ // from the camera, so streaks stay readable from any view angle.
468
+ const speed = slot.velocity.length();
469
+ scratchAxisZ.subVectors(eye, slot.mesh.position).normalize();
470
+ scratchAxisX.crossVectors(slot.velocity, scratchAxisZ);
471
+ if (scratchAxisX.lengthSq() < 1e-6) scratchAxisX.set(1, 0, 0);
472
+ scratchAxisX.normalize();
473
+ scratchAxisZ.crossVectors(scratchAxisX, slot.velocity).normalize();
474
+ scratchMatrix.makeBasis(scratchAxisX, slot.velocity.clone().normalize(), scratchAxisZ);
475
+ slot.mesh.quaternion.setFromRotationMatrix(scratchMatrix);
476
+ slot.mesh.scale.set(0.028, Math.min(0.34, 0.05 + speed * 0.03), 1);
477
+ // Flicker on the way out keeps sparks from dying like a fading lamp.
478
+ const flicker = 0.7 + 0.3 * Math.sin(slot.age * 80 + slot.seed * 7);
479
+ (slot.mesh.material as MeshBasicMaterial).opacity = (1 - t) ** 1.5 * flicker;
480
+ }
481
+ for (const slot of this.#chips) {
482
+ if (slot.life <= 0) continue;
483
+ slot.age += dt;
484
+ const t = slot.age / slot.life;
485
+ if (t >= 1) {
486
+ slot.life = 0;
487
+ if (this.#settled) slot.mesh.visible = false;
488
+ (slot.mesh.material as MeshBasicMaterial).opacity = 0;
489
+ continue;
490
+ }
491
+ slot.velocity.y -= GRAVITY_CHIPS * dt;
492
+ slot.velocity.multiplyScalar(Math.exp(-0.7 * dt));
493
+ slot.mesh.position.addScaledVector(slot.velocity, dt);
494
+ slot.mesh.rotation.z += slot.spin * dt;
495
+ (slot.mesh.material as MeshBasicMaterial).opacity = Math.min(1, (1 - t) * 3);
496
+ }
497
+ for (const slot of this.#dust) {
498
+ if (slot.life <= 0) continue;
499
+ slot.age += dt;
500
+ const t = slot.age / slot.life;
501
+ if (t >= 1) {
502
+ slot.life = 0;
503
+ if (this.#settled) slot.mesh.visible = false;
504
+ (slot.mesh.material as MeshBasicMaterial).opacity = 0;
505
+ continue;
506
+ }
507
+ slot.velocity.multiplyScalar(Math.exp(-2.6 * dt));
508
+ slot.velocity.y += dt * 0.35;
509
+ slot.mesh.position.addScaledVector(slot.velocity, dt);
510
+ slot.mesh.lookAt(eye);
511
+ const grow = slot.baseScale * (0.55 + t * 1.5);
512
+ slot.mesh.scale.setScalar(grow);
513
+ // Fast in, slow out: the puff appears with the flash and outlives it.
514
+ (slot.mesh.material as MeshBasicMaterial).opacity =
515
+ Math.min(1, slot.age * 9) * (1 - t) ** 1.6 * 0.55;
516
+ }
517
+ for (const slot of this.#flashes) {
518
+ if (slot.life <= 0) continue;
519
+ slot.age += dt;
520
+ const t = slot.age / slot.life;
521
+ if (t >= 1) {
522
+ slot.life = 0;
523
+ if (this.#settled) slot.mesh.visible = false;
524
+ (slot.mesh.material as MeshBasicMaterial).opacity = 0;
525
+ continue;
526
+ }
527
+ slot.mesh.lookAt(eye);
528
+ slot.mesh.rotateZ(slot.roll);
529
+ // Pop: slightly larger than life at birth, settled by mid-life.
530
+ slot.mesh.scale.setScalar(slot.baseScale * (1.18 - t * 0.3));
531
+ (slot.mesh.material as MeshBasicMaterial).opacity = (1 - t) ** 1.4;
532
+ }
533
+ }
534
+ }
535
+
536
+ /**
537
+ * One reusable muzzle flash: the star card plus a point light that kicks the
538
+ * world for a couple of frames. Allocated once per shooter and driven by
539
+ * lifetime — never constructed during play, and `visible` never toggles
540
+ * (pipeline rebuilds stall the frame; see the note in `Rifle`).
541
+ */
542
+ export class MuzzleFlash {
543
+ readonly #card: Mesh;
544
+ readonly #light: PointLight;
545
+ #life = 0;
546
+ readonly #maxLife: number;
547
+ readonly #peakIntensity: number;
548
+ #roll = 0;
549
+ readonly #baseSize: number;
550
+ readonly #forwardOffset: number;
551
+ #settled = false;
552
+
553
+ constructor(
554
+ parent: Object3D,
555
+ options: {
556
+ size?: number;
557
+ colour?: number;
558
+ lightColour?: number;
559
+ lightIntensity?: number;
560
+ lightDistance?: number;
561
+ life?: number;
562
+ forwardOffset?: number;
563
+ } = {},
564
+ ) {
565
+ this.#baseSize = options.size ?? 0.4;
566
+ this.#maxLife = options.life ?? 0.07;
567
+ this.#peakIntensity = options.lightIntensity ?? 30;
568
+ this.#forwardOffset = options.forwardOffset ?? 0.05;
569
+ const material = new MeshBasicMaterial({
570
+ blending: AdditiveBlending,
571
+ color: options.colour ?? 0xffd9a0,
572
+ depthWrite: false,
573
+ map: flashTexture(),
574
+ opacity: 0,
575
+ transparent: true,
576
+ });
577
+ this.#card = new Mesh(new PlaneGeometry(1, 1), material);
578
+ this.#card.visible = true;
579
+ this.#card.frustumCulled = false;
580
+ this.#card.renderOrder = 28;
581
+ this.#settled = false;
582
+ parent.add(this.#card);
583
+ this.#light = new PointLight(
584
+ options.lightColour ?? 0xffc46a,
585
+ 0,
586
+ options.lightDistance ?? 10,
587
+ 2,
588
+ );
589
+ parent.add(this.#light);
590
+ }
591
+
592
+ /** Fire the flash from `at`, pointing along `direction`. */
593
+ spawn(at: Vector3, direction: Vector3, rng: () => number): void {
594
+ this.#card.position.copy(at).addScaledVector(direction, this.#forwardOffset);
595
+ this.#light.position.copy(this.#card.position).addScaledVector(direction, 0.4);
596
+ this.#roll = rng() * Math.PI * 2;
597
+ this.#card.scale.setScalar(this.#baseSize * (0.85 + rng() * 0.5));
598
+ this.#card.visible = true;
599
+ (this.#card.material as MeshBasicMaterial).opacity = 1;
600
+ this.#light.intensity = this.#peakIntensity;
601
+ this.#life = this.#maxLife;
602
+ }
603
+
604
+ /**
605
+ * Stop submitting the card while no flash is alive.
606
+ *
607
+ * The card is resident from construction at zero opacity so its pipeline compiles during
608
+ * loading; the cost is a draw per idle flash forever, and on a phone the draw call is the
609
+ * expensive part. Once compiled the pipeline is cached, so `spawn` re-showing it is free.
610
+ */
611
+ settle(): void {
612
+ this.#settled = true;
613
+ if (this.#life <= 0) this.#card.visible = false;
614
+ }
615
+
616
+ /** Current card opacity. Zero means retired — the playtest gate for a stuck flash reads this. */
617
+ get opacity(): number {
618
+ return (this.#card.material as MeshBasicMaterial).opacity;
619
+ }
620
+
621
+ update(dt: number, eye: Vector3): void {
622
+ this.#life = Math.max(0, this.#life - dt);
623
+ if (this.#life <= 0) {
624
+ (this.#card.material as MeshBasicMaterial).opacity = 0;
625
+ if (this.#settled) this.#card.visible = false;
626
+ this.#light.intensity = 0;
627
+ return;
628
+ }
629
+ const t = this.#life / this.#maxLife;
630
+ this.#card.lookAt(eye);
631
+ this.#card.rotateZ(this.#roll);
632
+ (this.#card.material as MeshBasicMaterial).opacity = Math.min(1, t * 1.6);
633
+ this.#light.intensity = this.#peakIntensity * t ** 1.5;
634
+ }
635
+
636
+ dispose(): void {
637
+ (this.#card.material as Material).dispose();
638
+ this.#card.removeFromParent();
639
+ this.#light.removeFromParent();
640
+ }
641
+ }
642
+
643
+ /**
644
+ * Independent muzzle flashes, one per concurrent shot.
645
+ *
646
+ * ## The bug this replaces
647
+ *
648
+ * A squad used to share a single flash quad and a single point light. Two soldiers firing a few
649
+ * frames apart teleported the quad between them, and — worse — every shot from anyone reset the
650
+ * one shared lifetime. Under sustained fire from five men that lifetime never reached zero, so
651
+ * the flash sat permanently lit at whichever muzzle fired last, looking for all the world like a
652
+ * flash that had failed to clean itself up. It had not: it was being kept alive by other people's
653
+ * gunfire.
654
+ *
655
+ * Round-robin over N independent slots fixes it by construction. Each slot owns its own lifetime,
656
+ * so no shooter can hold another shooter's flash open, and `update` retires slots on their own
657
+ * clock whatever else is firing.
658
+ *
659
+ * Every slot's card and light are in the scene from construction with opacity and intensity at
660
+ * zero — revealing a hidden mesh or a hidden light mid-round makes WebGPU rebuild pipelines and
661
+ * stalls the frame, which is the note in `Rifle` and it applies just as hard here.
662
+ */
663
+ export class MuzzleFlashPool {
664
+ readonly #slots: MuzzleFlash[] = [];
665
+ #cursor = 0;
666
+
667
+ constructor(
668
+ parent: Object3D,
669
+ count: number,
670
+ options: ConstructorParameters<typeof MuzzleFlash>[1] = {},
671
+ ) {
672
+ for (let index = 0; index < count; index += 1) {
673
+ this.#slots.push(new MuzzleFlash(parent, options));
674
+ }
675
+ }
676
+
677
+ spawn(at: Vector3, direction: Vector3, rng: () => number): void {
678
+ const slot = this.#slots[this.#cursor % this.#slots.length];
679
+ this.#cursor += 1;
680
+ slot?.spawn(at, direction, rng);
681
+ }
682
+
683
+ /** Stop submitting every idle slot's card. See `MuzzleFlash.settle`. */
684
+ settle(): void {
685
+ for (const slot of this.#slots) slot.settle();
686
+ }
687
+
688
+ /** Every slot, every frame. Call this outside any gameplay-phase gate — see `Play`. */
689
+ update(dt: number, eye: Vector3): void {
690
+ for (const slot of this.#slots) slot.update(dt, eye);
691
+ }
692
+
693
+ /** Highest opacity across the pool. A playtest reads it to prove flashes retire. */
694
+ peakOpacity(): number {
695
+ let peak = 0;
696
+ for (const slot of this.#slots) peak = Math.max(peak, slot.opacity);
697
+ return peak;
698
+ }
699
+
700
+ dispose(): void {
701
+ for (const slot of this.#slots) slot.dispose();
702
+ this.#slots.length = 0;
703
+ }
704
+ }