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,103 +1,219 @@
1
- import type { ICtx, ScheduleHandle } from "@threenative/core";
2
- import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
- import { type Group, Vector3 } from "three";
4
-
5
- import { createTargetVisual } from "../render/shapes.js";
1
+ import type { ICtx } from "@threenative/core";
2
+ import type { IPhysicsContext } from "@threenative/physics";
3
+ import { Group, type Material, Mesh, type Vector3Like } from "three";
4
+ import { scale } from "../render/scale.js";
5
+ import { unitBox, unitPlane } from "../render/shapes.js";
6
6
  import type { GameState } from "../state.js";
7
- import { HOSTILE_LAYER, PLAYER_LAYER, WORLD_LAYER } from "./Player.js";
7
+ import { tagSurface } from "../surfaces.js";
8
8
 
9
9
  type GameCtx = ICtx<GameState, IPhysicsContext>;
10
10
 
11
- const SCAN_RADIUS = 7;
11
+ /** A struck plate swings back up this long after it drops. */
12
+ const RESET_SECONDS = 1.4;
13
+
14
+ /** The four surfaces a plate needs; the town palette supplies them. */
15
+ export type TargetMaterials = {
16
+ readonly face: Material;
17
+ readonly hit: Material;
18
+ readonly frame: Material;
19
+ readonly steel: Material;
20
+ };
21
+
22
+ export type TargetSpec = {
23
+ readonly position: Vector3Like;
24
+ readonly value: 100 | 150 | 250 | 300;
25
+ readonly width?: number;
26
+ readonly height?: number;
27
+ /** A standing target has a deck stand; false selects a fixed structural mount. */
28
+ readonly standing?: boolean;
29
+ /** Surface supporting a mounted target. Deck mounts are freestanding; walkway mounts meet its rail. */
30
+ readonly mountedTo?: "deck" | "walkway";
31
+ /** Yaw the plate faces, radians. Zero faces +z like the range plates did. */
32
+ readonly yaw?: number;
33
+ };
12
34
 
13
35
  export class Target {
14
- readonly mesh: Group;
15
- readonly body: RigidBody3D;
16
- readonly tags = ["hostile", "target"];
17
- readonly wave: number | undefined;
18
- health: number;
19
- alive = true;
20
- acquired = false;
21
- scanCount = 0;
22
- #scanHandle: ScheduleHandle | undefined;
23
- #fireTimer = 0;
24
- #onFire: (origin: Vector3) => void;
25
- #scanShape = CollisionShape3D.sphere(SCAN_RADIUS);
26
-
27
- constructor(
28
- ctx: GameCtx,
29
- materials: Parameters<typeof createTargetVisual>[0],
30
- position: Vector3,
31
- options: {
32
- readonly health?: number;
33
- readonly onFire?: (origin: Vector3) => void;
34
- readonly wave?: number;
35
- } = {},
36
- ) {
37
- this.wave = options.wave;
38
- this.health = options.health ?? 40;
39
- this.#onFire = options.onFire ?? (() => undefined);
40
- this.mesh = createTargetVisual(materials);
41
- this.mesh.position.copy(position);
42
- ctx.add(this.mesh);
43
- this.body = new RigidBody3D({
44
- collisionLayer: HOSTILE_LAYER,
45
- collisionMask: WORLD_LAYER,
46
- object: this.mesh,
47
- physics: ctx.physics,
48
- shape: CollisionShape3D.box(1.2, 1.8, 1),
49
- type: "kinematic",
36
+ readonly group = new Group();
37
+ readonly plate: Mesh;
38
+ readonly value: number;
39
+ #up = true;
40
+ #dropY: number;
41
+ #mounted: boolean;
42
+ #faceMaterial: TargetMaterials["face"];
43
+ #hitMaterial: TargetMaterials["hit"];
44
+
45
+ constructor(materials: TargetMaterials, spec: TargetSpec) {
46
+ const width = spec.width ?? scale.silhouette.width;
47
+ const height = spec.height ?? scale.silhouette.height;
48
+ this.#mounted = spec.standing === false;
49
+ this.#dropY = -Math.max(height * 0.65, scale.ankleHeight * 8);
50
+ this.value = spec.value;
51
+ this.#faceMaterial = materials.face;
52
+ this.#hitMaterial = materials.hit;
53
+ // Ten targets share four materials; unique per-target geometry would leave
54
+ // every (geometry, material) group below the projection's batch floor. Unit
55
+ // primitives + scale keep the parts identical to the per-target sizes.
56
+ this.plate = new Mesh(unitPlane(), materials.face);
57
+ this.plate.scale.set(width, height, 1);
58
+ this.plate.name = "target-plate";
59
+ this.plate.castShadow = true;
60
+ this.plate.receiveShadow = false;
61
+ this.plate.userData.target = this;
62
+ // The plate is steel by the palette table; a struck plate is intercepted
63
+ // before surface resolution today, but the tag keeps it honest for decals.
64
+ tagSurface(this.plate, "steel");
65
+ this.plate.position.set(0, 0, 0.03);
66
+
67
+ const carrier = new Group();
68
+ const frame = new Mesh(unitPlane(), materials.frame);
69
+ frame.scale.set(width + 0.1, height + 0.1, 1);
70
+ frame.name = "target-frame";
71
+ frame.castShadow = true;
72
+ carrier.add(frame);
73
+ carrier.add(this.plate);
74
+ carrier.name = "target-carrier";
75
+ this.group.add(carrier);
76
+ this.group.position.set(spec.position.x, spec.position.y, spec.position.z);
77
+ if (spec.yaw !== undefined) this.group.rotation.y = spec.yaw;
78
+
79
+ if (!this.#mounted) {
80
+ // Steel stand: two posts down to the deck plus a cross brace under the plate.
81
+ const legHeight = Math.max(0, spec.position.y - height / 2);
82
+ for (const side of [-1, 1]) {
83
+ const post = new Mesh(unitBox(), materials.steel);
84
+ post.scale.set(scale.ankleHeight * 2.5, legHeight, scale.ankleHeight * 2.5);
85
+ post.name = "target-post";
86
+ post.position.set((side * width) / 2 - side * 0.04, -height / 2 - legHeight / 2, 0);
87
+ post.castShadow = true;
88
+ this.group.add(post);
89
+ }
90
+ const brace = new Mesh(unitBox(), materials.steel);
91
+ brace.scale.set(
92
+ width + scale.ankleHeight * 3,
93
+ scale.ankleHeight * 2.5,
94
+ scale.ankleHeight * 2.5,
95
+ );
96
+ brace.name = "target-brace";
97
+ brace.position.set(0, -height / 2 - 0.03, 0);
98
+ brace.castShadow = true;
99
+ this.group.add(brace);
100
+ const foot = new Mesh(unitBox(), materials.steel);
101
+ foot.scale.set(width + scale.ankleHeight * 15, scale.ankleHeight * 3, scale.ankleHeight * 20);
102
+ foot.name = "target-foot";
103
+ foot.position.set(0, -spec.position.y + 0.03, 0);
104
+ foot.receiveShadow = true;
105
+ this.group.add(foot);
106
+ } else {
107
+ const mountSurfaceY = spec.mountedTo === "walkway" ? scale.walkwaySurface : 0;
108
+ const plateBottom = spec.position.y - height / 2;
109
+ const supportHeight = Math.max(scale.ankleHeight * 2, plateBottom - mountSurfaceY);
110
+ const supportX = width / 2 - scale.ankleHeight * 1.4;
111
+
112
+ // Mounted plates need a real load path. These twin steel uprights run from the declared
113
+ // surface to the frame, so the plate cannot read as a floating five-centimetre tab.
114
+ for (const side of [-1, 1]) {
115
+ const support = new Mesh(unitBox(), materials.steel);
116
+ support.scale.set(scale.ankleHeight * 3.5, supportHeight, scale.ankleHeight * 3.5);
117
+ support.name = "target-support";
118
+ support.position.set(
119
+ side * supportX,
120
+ mountSurfaceY + supportHeight / 2 - spec.position.y,
121
+ -scale.ankleHeight * 1.5,
122
+ );
123
+ support.castShadow = true;
124
+ this.group.add(support);
125
+ }
126
+
127
+ const brace = new Mesh(unitBox(), materials.steel);
128
+ brace.scale.set(width + scale.ankleHeight * 4, scale.ankleHeight * 3, scale.ankleHeight * 5);
129
+ brace.name = "target-mount-brace";
130
+ brace.position.set(
131
+ 0,
132
+ plateBottom - scale.ankleHeight * 1.5 - spec.position.y,
133
+ -scale.ankleHeight * 1.5,
134
+ );
135
+ brace.castShadow = true;
136
+ this.group.add(brace);
137
+
138
+ if (mountSurfaceY === 0) {
139
+ const foot = new Mesh(unitBox(), materials.steel);
140
+ foot.scale.set(
141
+ width + scale.ankleHeight * 18,
142
+ scale.ankleHeight * 4,
143
+ scale.ankleHeight * 18,
144
+ );
145
+ foot.name = "target-mount-foot";
146
+ foot.position.set(0, scale.ankleHeight * 2 - spec.position.y, -scale.ankleHeight * 1.5);
147
+ foot.receiveShadow = true;
148
+ this.group.add(foot);
149
+ } else {
150
+ // The high mounted plate is tied into the existing walkway rail as well as its short
151
+ // deck-side uprights. The carrier remains separate so strike() still hinges in place.
152
+ const railY =
153
+ scale.walkwaySurface - scale.walkway.thickness / 2 + scale.handrailHeight + 0.05;
154
+ const railBracket = new Mesh(unitBox(), materials.steel);
155
+ railBracket.scale.set(width + scale.ankleHeight * 7, scale.ankleHeight * 3, 0.22);
156
+ railBracket.name = "target-rail-bracket";
157
+ railBracket.position.set(0, railY - spec.position.y, -0.1);
158
+ railBracket.castShadow = true;
159
+ this.group.add(railBracket);
160
+ }
161
+
162
+ const mount = new Mesh(unitBox(), materials.steel);
163
+ mount.scale.set(
164
+ width + scale.ankleHeight * 6,
165
+ scale.ankleHeight * 2.5,
166
+ scale.ankleHeight * 4,
167
+ );
168
+ mount.name = "target-mount";
169
+ mount.position.set(0, -scale.ankleHeight * 1.25, -scale.ankleHeight * 2);
170
+ mount.castShadow = true;
171
+ this.group.add(mount);
172
+ }
173
+
174
+ // These small plates move when struck and sit metres from the player; their
175
+ // sun-map silhouettes are sub-pixel while each caster group costs a pass.
176
+ this.group.traverse((object) => {
177
+ const mesh = object as Mesh;
178
+ if (mesh.isMesh === true) mesh.castShadow = false;
50
179
  });
51
180
  }
52
181
 
53
- startScanning(ctx: GameCtx, playerBodyId: number): void {
54
- const scan = (): void => {
55
- if (!this.alive) return;
56
- this.scanCount += 1;
57
- const hits = ctx.physics.directSpaceState.intersectShape({
58
- collisionMask: PLAYER_LAYER,
59
- maxResults: 4,
60
- position: this.mesh.position,
61
- shape: this.#scanShape,
62
- });
63
- this.acquired = hits.some((hit) => hit.body.id === playerBodyId);
64
- this.#scanHandle = ctx.after(ctx.random.range(3, 8) / 60, scan);
65
- };
66
- this.#scanHandle = ctx.after(ctx.random.range(3, 8) / 60, scan);
182
+ get scorable(): boolean {
183
+ return this.#up;
67
184
  }
68
185
 
69
- update(dt: number): void {
70
- if (!this.alive || !this.acquired) return;
71
- this.#fireTimer -= dt;
72
- if (this.#fireTimer > 0) return;
73
- this.#fireTimer = 6;
74
- this.#onFire(this.mesh.position.clone().add(new Vector3(0, 0.9, 0)));
186
+ debug(): { value: number; scorable: boolean; position: number[] } {
187
+ return {
188
+ value: this.value,
189
+ scorable: this.scorable,
190
+ position: this.group.position.toArray(),
191
+ };
75
192
  }
76
193
 
77
- takeDamage(amount: number): boolean {
78
- if (!this.alive || !Number.isFinite(amount) || amount <= 0) return false;
79
- this.health = Math.max(0, this.health - amount);
80
- if (this.health > 0) return false;
81
- this.alive = false;
82
- this.mesh.visible = false;
83
- return true;
194
+ /** The plate the raycast has to hit; `undefined` once it has dropped. */
195
+ get carrier(): Group {
196
+ return this.plate.parent as Group;
84
197
  }
85
198
 
86
- debug(): Record<string, unknown> {
87
- return {
88
- acquired: this.acquired,
89
- alive: this.alive,
90
- health: this.health,
91
- position: this.mesh.position.toArray(),
92
- scanCount: this.scanCount,
93
- selected: this.acquired ? 1 : 0,
94
- wave: this.wave ?? 0,
95
- };
199
+ /** Drops a standing plate below its stand; mounted plates hinge in place. */
200
+ strike(ctx: GameCtx): number {
201
+ if (!this.#up) return 0;
202
+ this.#up = false;
203
+ this.plate.material = this.#hitMaterial;
204
+ const carrier = this.carrier;
205
+ void ctx.tween(carrier.rotation, { x: -Math.PI / 2 }, 0.12);
206
+ if (!this.#mounted) void ctx.tween(carrier.position, { y: this.#dropY }, 0.16);
207
+ ctx.after(RESET_SECONDS, () => {
208
+ if (!this.#mounted) void ctx.tween(carrier.position, { y: 0 }, 0.22);
209
+ void ctx.tween(carrier.rotation, { x: 0 }, 0.26);
210
+ this.plate.material = this.#faceMaterial;
211
+ this.#up = true;
212
+ });
213
+ return this.value;
96
214
  }
97
215
 
98
216
  dispose(): void {
99
- this.#scanHandle?.cancel();
100
- this.body.dispose();
101
- this.mesh.removeFromParent();
217
+ this.group.removeFromParent();
102
218
  }
103
219
  }
@@ -0,0 +1,276 @@
1
+ import type { ICtx } from "@threenative/core";
2
+ import type { IPhysicsContext } from "@threenative/physics";
3
+ import { MathUtils } from "three";
4
+ import type { GameState } from "../state.js";
5
+
6
+ type GameCtx = ICtx<GameState, IPhysicsContext>;
7
+
8
+ /**
9
+ * Thumb controls for playing on a phone, read straight off the engine's multitouch map.
10
+ *
11
+ * ## Why this is game code and not a framework widget
12
+ *
13
+ * `ctx.input.raw.pointers` is a `ReadonlyMap<number, IRawInputPointer>` — every active finger with
14
+ * its id and canvas position. That is the whole platform surface this needs, so the layout, the
15
+ * dead zone, the button placement and the look sensitivity are all decisions this game makes, and
16
+ * nothing here touches `document`, `window` or a touch event. It runs on the native target for the
17
+ * same reason the rest of the scene does.
18
+ *
19
+ * ## The layout, and why it is fixed rather than clever
20
+ *
21
+ * Left thumb drives a floating stick: wherever the finger lands in the left band becomes the
22
+ * origin, and the drag from it is the move vector. A floating origin is the difference between a
23
+ * stick you can use without looking and one you keep missing — a fixed on-screen circle demands
24
+ * the player's eyes, and their eyes are on the fight.
25
+ *
26
+ * Right thumb looks, except inside the action buttons. Look is a *delta* per tick, not a position,
27
+ * so it behaves like a trackpad and never snaps the view when a finger is re-planted.
28
+ *
29
+ * ## Pointer lock does not exist here
30
+ *
31
+ * `Look.consume` refuses to turn the view unless `pointer.captured` is true, which is correct for
32
+ * a mouse and impossible on a touch screen — there is no pointer lock to earn. Touch look is
33
+ * therefore delivered as its own delta that the player adds on top, rather than by pretending a
34
+ * lock was granted.
35
+ */
36
+
37
+ /** Radius, in CSS pixels, a finger must travel before the stick reads full tilt. */
38
+ const STICK_RANGE = 74;
39
+ /** Slack around the origin, so a resting thumb does not creep. */
40
+ const STICK_DEAD_ZONE = 9;
41
+ /** Touch look is a raw pixel delta; this scales it to feel like the mouse without a lock. */
42
+ const LOOK_SCALE = 1.35;
43
+ /**
44
+ * How far forward the stick has to go before it is a sprint, and how far back before it is not.
45
+ *
46
+ * Sprint is a *gesture*, not a seventh button. The right thumb already carries fire, aim, reload
47
+ * and crouch, and the screen a phone has left after those is the screen the player is trying to
48
+ * shoot into — a fifth circle would cost more of the fight than it is worth. Pushing the stick to
49
+ * the stop is what every phone shooter means by "run", and the left thumb is otherwise idle.
50
+ *
51
+ * The two thresholds are a Schmitt trigger. A single one at 0.9 puts the sprint flag on the same
52
+ * knife edge the thumb rests on, so a player holding full forward flickers between walk and sprint
53
+ * several times a second — audible in the footstep cadence and visible in the weapon sway.
54
+ */
55
+ const SPRINT_ENGAGE = 0.92;
56
+ const SPRINT_RELEASE = 0.78;
57
+ /** How straight ahead the push has to be. A diagonal is a strafe, and nobody sprints sideways. */
58
+ const SPRINT_FORWARD_DOT = 0.72;
59
+
60
+ /** A circular on-screen button, positioned from the bottom-right in CSS pixels. */
61
+ type Button = {
62
+ readonly action: "fire" | "aim" | "reload" | "crouch";
63
+ /** Offset from the right edge and the bottom edge, to the button's centre. */
64
+ readonly right: number;
65
+ readonly bottom: number;
66
+ readonly radius: number;
67
+ };
68
+
69
+ /**
70
+ * Thumb-reachable and non-overlapping at 411 CSS px wide, which is a Pixel 8 in portrait — the
71
+ * narrowest surface this has to work on. Fire is the largest and lowest because it is pressed
72
+ * most and missed worst.
73
+ */
74
+ const BUTTONS: readonly Button[] = [
75
+ { action: "fire", right: 86, bottom: 104, radius: 58 },
76
+ { action: "aim", right: 178, bottom: 196, radius: 38 },
77
+ { action: "reload", right: 74, bottom: 216, radius: 34 },
78
+ { action: "crouch", right: 196, bottom: 92, radius: 34 },
79
+ ];
80
+
81
+ type Role =
82
+ | { kind: "stick"; originX: number; originY: number; x: number; y: number }
83
+ | { kind: "look"; lastX: number; lastY: number }
84
+ | { kind: "button"; action: Button["action"] };
85
+
86
+ /** What one tick of touch input asked for. Consumed by the player, drawn by the HUD. */
87
+ export type TouchFrame = {
88
+ readonly moveX: number;
89
+ readonly moveY: number;
90
+ readonly lookX: number;
91
+ readonly lookY: number;
92
+ readonly fire: boolean;
93
+ readonly aim: boolean;
94
+ readonly reload: boolean;
95
+ readonly crouch: boolean;
96
+ readonly sprint: boolean;
97
+ };
98
+
99
+ const IDLE: TouchFrame = {
100
+ moveX: 0,
101
+ moveY: 0,
102
+ lookX: 0,
103
+ lookY: 0,
104
+ fire: false,
105
+ aim: false,
106
+ reload: false,
107
+ crouch: false,
108
+ sprint: false,
109
+ };
110
+
111
+ export class TouchControls {
112
+ #roles = new Map<number, Role>();
113
+ #frame: TouchFrame = IDLE;
114
+ /** True once any finger has touched the surface, so the HUD only appears on a touch device. */
115
+ #engaged = false;
116
+ /** Rising-edge latch: reload should fire once per press, not once per tick held. */
117
+ #reloadWasDown = false;
118
+ /** Hysteresis state for the stick-push sprint: what it decided last tick. */
119
+ #sprinting = false;
120
+
121
+ get frame(): TouchFrame {
122
+ return this.#frame;
123
+ }
124
+
125
+ get engaged(): boolean {
126
+ return this.#engaged;
127
+ }
128
+
129
+ /** Where the left stick is being drawn from and to, in CSS pixels, or undefined when idle. */
130
+ get stick(): { originX: number; originY: number; x: number; y: number } | undefined {
131
+ for (const role of this.#roles.values()) {
132
+ if (role.kind === "stick") {
133
+ return { originX: role.originX, originY: role.originY, x: role.x, y: role.y };
134
+ }
135
+ }
136
+ return undefined;
137
+ }
138
+
139
+ /** The button layout, so the HUD draws exactly the circles this class tests against. */
140
+ static get buttons(): readonly Button[] {
141
+ return BUTTONS;
142
+ }
143
+
144
+ /** Which actions are held this tick, for the HUD's pressed state. */
145
+ heldActions(): ReadonlySet<Button["action"]> {
146
+ const held = new Set<Button["action"]>();
147
+ for (const role of this.#roles.values()) if (role.kind === "button") held.add(role.action);
148
+ return held;
149
+ }
150
+
151
+ #buttonAt(x: number, y: number, width: number, height: number): Button | undefined {
152
+ for (const button of BUTTONS) {
153
+ const cx = width - button.right;
154
+ const cy = height - button.bottom;
155
+ if (Math.hypot(x - cx, y - cy) <= button.radius) return button;
156
+ }
157
+ return undefined;
158
+ }
159
+
160
+ update(ctx: GameCtx): TouchFrame {
161
+ const pointers = ctx.input.raw.pointers;
162
+ const { width, height } = ctx.viewport.size;
163
+
164
+ // Fingers that left the glass give up their role, or a lifted thumb keeps steering.
165
+ for (const id of [...this.#roles.keys()]) {
166
+ if (!pointers.has(id)) this.#roles.delete(id);
167
+ }
168
+
169
+ let lookX = 0;
170
+ let lookY = 0;
171
+
172
+ // One pass. Look is a delta against the previous tick, so it must be read *before* the
173
+ // stored sample is advanced — computing it afterwards reads zero, every tick, forever.
174
+ for (const [id, pointer] of pointers) {
175
+ const x = pointer.position.x;
176
+ const y = pointer.position.y;
177
+ const existing = this.#roles.get(id);
178
+ if (existing === undefined) {
179
+ this.#engaged = true;
180
+ const button = this.#buttonAt(x, y, width, height);
181
+ if (button !== undefined) {
182
+ this.#roles.set(id, { kind: "button", action: button.action });
183
+ } else if (x < width * 0.45) {
184
+ // Floating origin: the stick is wherever the thumb landed.
185
+ this.#roles.set(id, { kind: "stick", originX: x, originY: y, x, y });
186
+ } else {
187
+ this.#roles.set(id, { kind: "look", lastX: x, lastY: y });
188
+ }
189
+ continue;
190
+ }
191
+ if (existing.kind === "stick") {
192
+ existing.x = x;
193
+ existing.y = y;
194
+ } else if (existing.kind === "look") {
195
+ lookX += (x - existing.lastX) * LOOK_SCALE;
196
+ lookY += (y - existing.lastY) * LOOK_SCALE;
197
+ existing.lastX = x;
198
+ existing.lastY = y;
199
+ }
200
+ }
201
+
202
+ let moveX = 0;
203
+ let moveY = 0;
204
+ let stickPush = 0;
205
+ let fire = false;
206
+ let aim = false;
207
+ let reloadDown = false;
208
+ let crouch = false;
209
+
210
+ for (const role of this.#roles.values()) {
211
+ if (role.kind === "stick") {
212
+ const dx = role.x - role.originX;
213
+ // Screen y grows downward; the move action's y is +up, so this is negated.
214
+ const dy = -(role.y - role.originY);
215
+ const distance = Math.hypot(dx, dy);
216
+ if (distance > STICK_DEAD_ZONE) {
217
+ const strength = Math.min(1, (distance - STICK_DEAD_ZONE) / STICK_RANGE);
218
+ moveX = (dx / distance) * strength;
219
+ moveY = (dy / distance) * strength;
220
+ // Forward component only: the push has to be both far and roughly straight ahead.
221
+ stickPush = dy / distance >= SPRINT_FORWARD_DOT ? strength : 0;
222
+ }
223
+ } else if (role.kind === "button") {
224
+ if (role.action === "fire") fire = true;
225
+ if (role.action === "aim") aim = true;
226
+ if (role.action === "reload") reloadDown = true;
227
+ if (role.action === "crouch") crouch = true;
228
+ }
229
+ }
230
+
231
+ // Rising edge: a held reload button should load once, not once per tick.
232
+ const reload = reloadDown && !this.#reloadWasDown;
233
+ this.#reloadWasDown = reloadDown;
234
+
235
+ // Aiming and sprinting are the same request in opposite directions, and the player's own
236
+ // movement code already refuses to sprint while aiming; declining here as well keeps the
237
+ // reported frame honest about what the thumbs actually asked for.
238
+ this.#sprinting = aim
239
+ ? false
240
+ : this.#sprinting
241
+ ? stickPush >= SPRINT_RELEASE
242
+ : stickPush >= SPRINT_ENGAGE;
243
+
244
+ this.#frame = {
245
+ moveX: MathUtils.clamp(moveX, -1, 1),
246
+ moveY: MathUtils.clamp(moveY, -1, 1),
247
+ lookX,
248
+ lookY,
249
+ fire,
250
+ aim,
251
+ reload,
252
+ crouch,
253
+ sprint: this.#sprinting,
254
+ };
255
+ return this.#frame;
256
+ }
257
+
258
+ /** Registered as an entity so a scenario can assert a thumb actually drove the player. */
259
+ debug(): {
260
+ engaged: number;
261
+ activePointers: number;
262
+ moveX: number;
263
+ moveY: number;
264
+ firing: number;
265
+ sprinting: number;
266
+ } {
267
+ return {
268
+ engaged: this.#engaged ? 1 : 0,
269
+ activePointers: this.#roles.size,
270
+ moveX: Number(this.#frame.moveX.toFixed(3)),
271
+ moveY: Number(this.#frame.moveY.toFixed(3)),
272
+ firing: this.#frame.fire ? 1 : 0,
273
+ sprinting: this.#frame.sprint ? 1 : 0,
274
+ };
275
+ }
276
+ }