create-threenative 0.2.6 → 0.2.7

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 (622) hide show
  1. package/README.md +2 -2
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +431 -20
  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 +555 -21
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +294 -55
  19. package/dist/threenative.js +714 -154
  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/rts/AGENTS.md +96 -0
  218. package/templates/rts/CLAUDE.md +98 -0
  219. package/templates/rts/kit.json +7 -0
  220. package/templates/{defense → rts}/package.json +13 -7
  221. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  222. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  223. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  224. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  225. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  226. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  227. package/templates/rts/playtests/survives.playtest.json +58 -0
  228. package/templates/rts/public/favicon.svg +4 -0
  229. package/templates/rts/src/game.ts +64 -0
  230. package/templates/rts/src/orders.ts +22 -0
  231. package/templates/rts/src/render/army.ts +346 -0
  232. package/templates/rts/src/render/camera.ts +123 -0
  233. package/templates/rts/src/render/lighting.ts +61 -0
  234. package/templates/rts/src/render/loading.ts +33 -0
  235. package/templates/rts/src/render/materials.ts +152 -0
  236. package/templates/rts/src/render/models.ts +705 -0
  237. package/templates/rts/src/render/palette.ts +17 -0
  238. package/templates/rts/src/render/picking.ts +93 -0
  239. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  240. package/templates/rts/src/render/quality.ts +128 -0
  241. package/templates/rts/src/render/resources.ts +141 -0
  242. package/templates/rts/src/render/sky.ts +44 -0
  243. package/templates/rts/src/render/terrain.ts +116 -0
  244. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  245. package/templates/rts/src/scenes/Play.ts +650 -0
  246. package/templates/rts/src/sim/ai.ts +1140 -0
  247. package/templates/rts/src/sim/combat.ts +416 -0
  248. package/templates/rts/src/sim/construction.ts +374 -0
  249. package/templates/rts/src/sim/economy.ts +167 -0
  250. package/templates/rts/src/sim/game.ts +1082 -0
  251. package/templates/rts/src/sim/movement.ts +371 -0
  252. package/templates/rts/src/sim/nav.ts +276 -0
  253. package/templates/rts/src/sim/production.ts +180 -0
  254. package/templates/rts/src/sim/terrain.ts +170 -0
  255. package/templates/rts/src/sim/types.ts +647 -0
  256. package/templates/rts/src/sim/vision.ts +46 -0
  257. package/templates/rts/src/state.ts +100 -0
  258. package/templates/{defense → rts}/src/style.css +21 -8
  259. package/templates/rts/src/ui/App.tsx +21 -0
  260. package/templates/rts/src/ui/Commands.tsx +129 -0
  261. package/templates/rts/src/ui/GameUi.tsx +22 -0
  262. package/templates/rts/src/ui/Hud.tsx +165 -0
  263. package/templates/rts/src/ui/Minimap.tsx +84 -0
  264. package/templates/rts/tailwind.config.ts +2 -0
  265. package/templates/rts/threenative.config.ts +56 -0
  266. package/templates/rts/tsconfig.json +17 -0
  267. package/templates/{defense → rts}/vite.config.ts +4 -1
  268. package/templates/runner/AGENTS.md +6 -10
  269. package/templates/runner/CLAUDE.md +6 -10
  270. package/templates/runner/README.md +3 -3
  271. package/templates/runner/package.json +13 -7
  272. package/templates/runner/playtests/performance.playtest.json +2 -2
  273. package/templates/runner/src/conventions.ts +4 -3
  274. package/templates/runner/src/entities/Runner.ts +54 -7
  275. package/templates/runner/src/game.ts +2 -0
  276. package/templates/runner/src/render/camera.ts +4 -2
  277. package/templates/runner/src/render/dust.ts +5 -2
  278. package/templates/runner/src/render/lighting.ts +41 -45
  279. package/templates/runner/src/render/loading.ts +2 -2
  280. package/templates/runner/src/render/materials.ts +165 -25
  281. package/templates/runner/src/render/palette.ts +17 -28
  282. package/templates/runner/src/render/postprocessing.ts +12 -2
  283. package/templates/runner/src/render/quality.ts +42 -96
  284. package/templates/runner/src/render/shapes.ts +59 -37
  285. package/templates/runner/src/render/sky.ts +32 -41
  286. package/templates/runner/src/render/touch-controls.ts +1 -1
  287. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  288. package/templates/runner/src/scenes/Run.ts +26 -6
  289. package/templates/runner/src/track.ts +6 -1
  290. package/templates/runner/threenative.config.ts +14 -1
  291. package/templates/runner/vite.config.ts +4 -1
  292. package/templates/sailing/AGENTS.md +12 -12
  293. package/templates/sailing/CLAUDE.md +12 -12
  294. package/templates/sailing/assets/ship.glb +0 -0
  295. package/templates/sailing/package.json +13 -7
  296. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  297. package/templates/sailing/playtests/sails.playtest.json +33 -0
  298. package/templates/sailing/playtests/win.playtest.json +156 -8
  299. package/templates/sailing/src/conventions.ts +29 -2
  300. package/templates/sailing/src/entities/Ship.ts +381 -57
  301. package/templates/sailing/src/game.ts +14 -0
  302. package/templates/sailing/src/render/camera.ts +63 -9
  303. package/templates/sailing/src/render/lighting.ts +49 -27
  304. package/templates/sailing/src/render/materials.ts +50 -15
  305. package/templates/sailing/src/render/ocean.ts +647 -60
  306. package/templates/sailing/src/render/palette.ts +16 -12
  307. package/templates/sailing/src/render/postprocessing.ts +12 -2
  308. package/templates/sailing/src/render/props.ts +316 -442
  309. package/templates/sailing/src/render/quality.ts +14 -4
  310. package/templates/sailing/src/render/sky.ts +116 -23
  311. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  312. package/templates/sailing/src/scenes/Boot.ts +21 -0
  313. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  314. package/templates/sailing/src/state.ts +6 -0
  315. package/templates/sailing/src/ui/Hud.tsx +41 -9
  316. package/templates/sailing/threenative.config.ts +14 -1
  317. package/templates/sailing/vite.config.ts +4 -1
  318. package/templates/shooter/AGENTS.md +27 -42
  319. package/templates/shooter/CLAUDE.md +27 -42
  320. package/templates/shooter/index.html +1 -0
  321. package/templates/shooter/package.json +13 -7
  322. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  323. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  324. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  325. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  326. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  327. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  328. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  329. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  330. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  331. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  332. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  333. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  334. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  335. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  336. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  337. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  338. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  339. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  340. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  341. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  342. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  343. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  344. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  345. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  346. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  347. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  348. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  349. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  350. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  351. package/templates/shooter/playtests/performance.playtest.json +62 -26
  352. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  353. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  354. package/templates/shooter/playtests/survives.playtest.json +36 -30
  355. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  356. package/templates/shooter/src/entities/Breakables.ts +412 -0
  357. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  358. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  359. package/templates/shooter/src/entities/Rifle.ts +442 -0
  360. package/templates/shooter/src/entities/Target.ts +199 -83
  361. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  362. package/templates/shooter/src/game.ts +75 -41
  363. package/templates/shooter/src/main.ts +0 -1
  364. package/templates/shooter/src/postPhysics.ts +36 -0
  365. package/templates/shooter/src/render/camera.ts +78 -74
  366. package/templates/shooter/src/render/decals.ts +142 -82
  367. package/templates/shooter/src/render/facade.ts +1373 -0
  368. package/templates/shooter/src/render/gunfx.ts +704 -0
  369. package/templates/shooter/src/render/lighting.ts +52 -38
  370. package/templates/shooter/src/render/loading.ts +2 -2
  371. package/templates/shooter/src/render/materials.ts +100 -88
  372. package/templates/shooter/src/render/occlusion.ts +108 -0
  373. package/templates/shooter/src/render/palette.ts +10 -10
  374. package/templates/shooter/src/render/palm.ts +455 -0
  375. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  376. package/templates/shooter/src/render/postprocessing.ts +15 -3
  377. package/templates/shooter/src/render/quality.ts +40 -82
  378. package/templates/shooter/src/render/scale.ts +148 -15
  379. package/templates/shooter/src/render/shapes.ts +138 -613
  380. package/templates/shooter/src/render/sky.ts +35 -35
  381. package/templates/shooter/src/render/town-schematic.ts +120 -0
  382. package/templates/shooter/src/render/town.ts +986 -0
  383. package/templates/shooter/src/render/townMaterials.ts +160 -0
  384. package/templates/shooter/src/render/vehicles.ts +741 -0
  385. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  386. package/templates/shooter/src/scenes/Play.ts +727 -650
  387. package/templates/shooter/src/state.ts +26 -41
  388. package/templates/shooter/src/style.css +207 -11
  389. package/templates/shooter/src/surfaces.ts +131 -0
  390. package/templates/shooter/src/ui/App.tsx +9 -10
  391. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  392. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  393. package/templates/shooter/src/ui/Hud.tsx +428 -39
  394. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  395. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  396. package/templates/shooter/src/ui/main.tsx +2 -3
  397. package/templates/shooter/threenative.config.ts +14 -1
  398. package/templates/shooter/vite.config.ts +4 -1
  399. package/templates/starter/AGENTS.md +17 -17
  400. package/templates/starter/CLAUDE.md +17 -17
  401. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  402. package/templates/starter/package.json +13 -7
  403. package/templates/starter/playtests/play.playtest.json +2 -1
  404. package/templates/starter/playtests/survives.playtest.json +1 -1
  405. package/templates/starter/src/conventions.ts +6 -3
  406. package/templates/starter/src/entities/Goal.ts +35 -42
  407. package/templates/starter/src/entities/Player.ts +99 -16
  408. package/templates/starter/src/render/arena.ts +131 -0
  409. package/templates/starter/src/render/lighting.ts +27 -44
  410. package/templates/starter/src/render/materials.ts +164 -35
  411. package/templates/starter/src/render/palette.ts +16 -16
  412. package/templates/starter/src/render/postprocessing.ts +6 -7
  413. package/templates/starter/src/render/quality.ts +43 -101
  414. package/templates/starter/src/render/shapes.ts +1 -1
  415. package/templates/starter/src/render/sky.ts +39 -45
  416. package/templates/starter/src/render/touch-controls.ts +3 -1
  417. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  418. package/templates/starter/src/scenes/Play.ts +82 -81
  419. package/templates/starter/threenative.config.ts +14 -1
  420. package/templates/starter/vite.config.ts +4 -1
  421. package/templates/tower-defense/.codex/config.toml +19 -0
  422. package/templates/tower-defense/.cursor/mcp.json +32 -0
  423. package/templates/tower-defense/.gemini/settings.json +32 -0
  424. package/templates/tower-defense/.mcp.json +32 -0
  425. package/templates/tower-defense/.vscode/mcp.json +36 -0
  426. package/templates/tower-defense/.zed/settings.json +36 -0
  427. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  428. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  429. package/templates/tower-defense/README.md +16 -0
  430. package/templates/tower-defense/index.html +12 -0
  431. package/templates/tower-defense/kit.json +7 -0
  432. package/templates/tower-defense/opencode.json +41 -0
  433. package/templates/tower-defense/package.json +56 -0
  434. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  435. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  436. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  437. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  438. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  439. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  440. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  441. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  442. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  443. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  444. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  445. package/templates/tower-defense/src/balance.ts +187 -0
  446. package/templates/tower-defense/src/board/Board.ts +100 -0
  447. package/templates/tower-defense/src/board/Route.ts +84 -0
  448. package/templates/tower-defense/src/camera-rig.ts +62 -0
  449. package/templates/tower-defense/src/economy.ts +64 -0
  450. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  451. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  452. package/templates/tower-defense/src/game.ts +72 -0
  453. package/templates/tower-defense/src/intents.ts +21 -0
  454. package/templates/tower-defense/src/main.ts +15 -0
  455. package/templates/tower-defense/src/physics.ts +6 -0
  456. package/templates/tower-defense/src/render/camera.ts +38 -0
  457. package/templates/tower-defense/src/render/lighting.ts +42 -0
  458. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  459. package/templates/tower-defense/src/render/materials.ts +103 -0
  460. package/templates/tower-defense/src/render/palette.ts +58 -0
  461. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  462. package/templates/tower-defense/src/render/quality.ts +128 -0
  463. package/templates/tower-defense/src/render/shapes.ts +550 -0
  464. package/templates/tower-defense/src/render/sky.ts +27 -0
  465. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  466. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  467. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  468. package/templates/tower-defense/src/state.ts +88 -0
  469. package/templates/tower-defense/src/style.css +137 -0
  470. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  471. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  472. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  473. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  474. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  475. package/templates/tower-defense/src/ui/main.tsx +14 -0
  476. package/templates/tower-defense/src/waves.ts +90 -0
  477. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  478. package/templates/tower-defense/vite.config.ts +41 -0
  479. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  480. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  481. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  482. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  483. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  484. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  485. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  486. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  487. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  488. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  489. package/agent-files/AGENT-ROLES.md +0 -26
  490. package/templates/action-rpg/src/render/shapes.ts +0 -269
  491. package/templates/action-rpg/src/render/types.ts +0 -3
  492. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  493. package/templates/defense/README.md +0 -10
  494. package/templates/defense/kit.json +0 -7
  495. package/templates/defense/playtests/leak.playtest.json +0 -23
  496. package/templates/defense/playtests/placement.playtest.json +0 -40
  497. package/templates/defense/playtests/scan.playtest.json +0 -20
  498. package/templates/defense/playtests/survive.playtest.json +0 -45
  499. package/templates/defense/playtests/survives.playtest.json +0 -36
  500. package/templates/defense/src/attackers/Attacker.ts +0 -120
  501. package/templates/defense/src/board/Route.ts +0 -94
  502. package/templates/defense/src/conventions.ts +0 -18
  503. package/templates/defense/src/economy.ts +0 -36
  504. package/templates/defense/src/entities/Player.ts +0 -52
  505. package/templates/defense/src/game.ts +0 -51
  506. package/templates/defense/src/physics.ts +0 -13
  507. package/templates/defense/src/placement/Buildable.ts +0 -49
  508. package/templates/defense/src/render/camera.ts +0 -16
  509. package/templates/defense/src/render/lighting.ts +0 -37
  510. package/templates/defense/src/render/materials.ts +0 -22
  511. package/templates/defense/src/render/palette.ts +0 -28
  512. package/templates/defense/src/render/quality.ts +0 -170
  513. package/templates/defense/src/render/shapes.ts +0 -246
  514. package/templates/defense/src/render/sky.ts +0 -45
  515. package/templates/defense/src/scenes/Boot.ts +0 -12
  516. package/templates/defense/src/scenes/Defense.ts +0 -231
  517. package/templates/defense/src/state.ts +0 -56
  518. package/templates/defense/src/towers/Tower.ts +0 -95
  519. package/templates/defense/src/towers/targeting.ts +0 -53
  520. package/templates/defense/src/ui/Hud.tsx +0 -62
  521. package/templates/defense/src/ui/Menu.tsx +0 -7
  522. package/templates/defense/src/waves.ts +0 -40
  523. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  524. package/templates/minimal/src/render/hud.ts +0 -69
  525. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  526. package/templates/platformer/playtests/chase.playtest.json +0 -21
  527. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  528. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  529. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  530. package/templates/platformer/playtests/physics.playtest.json +0 -14
  531. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  532. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  533. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  534. package/templates/platformer/src/conventions.ts +0 -18
  535. package/templates/platformer/src/entities/Character.ts +0 -286
  536. package/templates/platformer/src/entities/Chaser.ts +0 -118
  537. package/templates/platformer/src/entities/Patrol.ts +0 -93
  538. package/templates/platformer/src/level/Platform.ts +0 -46
  539. package/templates/platformer/src/render/rig.ts +0 -60
  540. package/templates/platformer/src/render/terrain.ts +0 -31
  541. package/templates/platformer/src/scenes/Level.ts +0 -241
  542. package/templates/puzzle/README.md +0 -43
  543. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  544. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  545. package/templates/puzzle/src/conventions.ts +0 -25
  546. package/templates/puzzle/src/entities/Ball.ts +0 -70
  547. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  548. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  549. package/templates/puzzle/src/physics.ts +0 -19
  550. package/templates/puzzle/src/room.ts +0 -83
  551. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  552. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  553. package/templates/shooter/playtests/combat.playtest.json +0 -48
  554. package/templates/shooter/playtests/fail.playtest.json +0 -31
  555. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  556. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  557. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  558. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  559. package/templates/shooter/src/combat/damage.ts +0 -40
  560. package/templates/shooter/src/conventions.ts +0 -51
  561. package/templates/shooter/src/entities/Pickup.ts +0 -70
  562. package/templates/shooter/src/entities/Player.ts +0 -310
  563. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  564. package/templates/shooter/src/playtest-events.ts +0 -15
  565. package/templates/shooter/src/render/touch-controls.ts +0 -305
  566. package/templates/shooter/src/render/types.ts +0 -3
  567. package/templates/shooter/src/render/ui.css +0 -330
  568. package/templates/shooter/src/render/ui.ts +0 -75
  569. package/templates/shooter/src/render/vfx.ts +0 -215
  570. package/templates/shooter/src/ui/Menu.tsx +0 -41
  571. package/templates/shooter/src/waves.ts +0 -50
  572. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  573. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  574. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  575. package/templates/starter/playtests/assets.playtest.json +0 -65
  576. package/templates/starter/playtests/buffer.playtest.json +0 -79
  577. package/templates/starter/playtests/cloth.playtest.json +0 -113
  578. package/templates/starter/playtests/coyote.playtest.json +0 -87
  579. package/templates/starter/playtests/gameover.playtest.json +0 -66
  580. package/templates/starter/playtests/goal.playtest.json +0 -67
  581. package/templates/starter/playtests/look.playtest.json +0 -175
  582. package/templates/starter/playtests/models-baseline.png +0 -0
  583. package/templates/starter/playtests/models.playtest.json +0 -74
  584. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  585. package/templates/starter/playtests/odometer.playtest.json +0 -54
  586. package/templates/starter/playtests/restart.playtest.json +0 -91
  587. package/templates/starter/playtests/seed.playtest.json +0 -54
  588. package/templates/starter/playtests/textures-baseline.png +0 -0
  589. package/templates/starter/playtests/textures.playtest.json +0 -74
  590. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  591. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  592. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  593. package/templates/starter/src/render/coast.ts +0 -199
  594. package/templates/starter/src/render/hero.ts +0 -88
  595. package/templates/starter/src/render/implicitSurface.ts +0 -199
  596. package/templates/starter/src/render/kuwahara.ts +0 -174
  597. package/templates/starter/src/render/outline.ts +0 -141
  598. package/templates/starter/src/render/painterly.ts +0 -86
  599. package/templates/starter/src/render/rockRidge.ts +0 -198
  600. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  601. package/templates/starter/src/render/scenery.ts +0 -40
  602. package/templates/starter/src/render/textureLifetime.ts +0 -53
  603. package/templates/starter/src/render/water.ts +0 -38
  604. package/templates/starter/src/render/watercolor.ts +0 -85
  605. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  606. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  607. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  608. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  609. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  610. /package/templates/{defense → rts}/.mcp.json +0 -0
  611. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  612. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  613. /package/templates/{defense → rts}/index.html +0 -0
  614. /package/templates/{defense → rts}/opencode.json +0 -0
  615. /package/templates/{defense → rts}/src/main.ts +0 -0
  616. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  617. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  618. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  619. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  620. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  621. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  622. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -0,0 +1,539 @@
1
+ import { CameraShake, type ICtx, Scene, type SceneFrame, isMobile } from "@threenative/core";
2
+ import type { IPhysicsContext } from "@threenative/physics";
3
+ import { type Group, type Mesh, type PerspectiveCamera, type Texture, Vector3 } from "three";
4
+ import {
5
+ ENEMIES,
6
+ type EnemyKind,
7
+ type ISpawn,
8
+ STRIKE_COOLDOWN,
9
+ STRIKE_RADIUS,
10
+ TARGET_MODES,
11
+ TOWERS,
12
+ TOWER_KINDS,
13
+ type TargetMode,
14
+ type TowerKind,
15
+ sellValue,
16
+ strikeDamage,
17
+ towerStats,
18
+ upgradeCost,
19
+ waveBonus,
20
+ } from "../balance.js";
21
+ import { Board } from "../board/Board.js";
22
+ import { SAFE_PADS, STARTING_PAD } from "../board/Route.js";
23
+ import { CameraRig } from "../camera-rig.js";
24
+ import { Economy } from "../economy.js";
25
+ import { Effects } from "../effects/Effects.js";
26
+ import { Enemy } from "../enemies/Enemy.js";
27
+ import { drainIntents } from "../intents.js";
28
+ import { emitPlaytestEvent } from "../playtest-events.js";
29
+ import { setupCamera } from "../render/camera.js";
30
+ import { setupLighting } from "../render/lighting.js";
31
+ import { createLoadingScreen } from "../render/loading.js";
32
+ import { palette } from "../render/palette.js";
33
+ import { setupPost } from "../render/postprocessing.js";
34
+ import { ghostTower, rangeGeometry, rangeRing } from "../render/shapes.js";
35
+ import { setupSky } from "../render/sky.js";
36
+ import { type GameState, INITIAL_STATE } from "../state.js";
37
+ import { Tower } from "../towers/Tower.js";
38
+ import { WaveDirector } from "../waves.js";
39
+
40
+ export type GameCtx = ICtx<GameState, IPhysicsContext>;
41
+ type FrameCtx = Parameters<SceneFrame<GameState, IPhysicsContext>>[0];
42
+
43
+ /** Keys that are nothing but an intent of the same name. */
44
+ const KEY_INTENTS = [
45
+ "launch",
46
+ "strike",
47
+ "upgrade",
48
+ "recycle",
49
+ "cancel",
50
+ "help",
51
+ "speed",
52
+ "autosend",
53
+ ] as const;
54
+
55
+ const SPEEDS = [1, 2, 3] as const;
56
+ /** The strike may land anywhere on the slab, and nowhere off it. */
57
+ const STRIKE_BOUNDS = { x: 19, z: 12 } as const;
58
+ const LEFT_SHIFT = "ShiftLeft";
59
+ const RIGHT_SHIFT = "ShiftRight";
60
+
61
+ function sameState(a: GameState, b: GameState): boolean {
62
+ for (const key of Object.keys(a) as (keyof GameState)[]) if (a[key] !== b[key]) return false;
63
+ return true;
64
+ }
65
+
66
+ export class Battle extends Scene<GameState, IPhysicsContext> {
67
+ static override readonly initialState = INITIAL_STATE;
68
+
69
+ #sky: Texture | undefined;
70
+
71
+ override async load(ctx: GameCtx): Promise<void> {
72
+ this.#sky = await ctx.assets.texture("sky.jpg");
73
+ }
74
+
75
+ override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
76
+ if (this.#sky === undefined) throw new Error("Battle.enter ran before load() loaded sky.jpg.");
77
+ setupSky(ctx.scene, this.#sky);
78
+ const { key } = setupLighting(
79
+ ctx.scene,
80
+ ctx.renderer.raw as Parameters<typeof setupLighting>[1],
81
+ isMobile(),
82
+ );
83
+ // isMobile() arrives as an argument because src/render/ imports no framework package: the
84
+ // platform decision is made here, in portable game code.
85
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, {
86
+ godraysLight: key,
87
+ mobile: isMobile(),
88
+ software: ctx.renderer.softwareAdapter !== undefined,
89
+ });
90
+ const camera = ctx.camera as PerspectiveCamera;
91
+ setupCamera(camera);
92
+ ctx.add(camera);
93
+ const loading = createLoadingScreen(ctx);
94
+
95
+ const board = new Board({ add: (object) => ctx.add(object) });
96
+ const effects = new Effects({ add: (object) => ctx.add(object) }, () => ctx.random());
97
+ const rig = new CameraRig();
98
+ const shake = new CameraShake({
99
+ amplitude: new Vector3(0.5, 0.35, 0.5),
100
+ curve: (radians) => Math.sin(radians) * Math.sin(radians * 0.37),
101
+ decay: 5,
102
+ frequency: 19,
103
+ rotationAmplitude: new Vector3(0, 0, 0),
104
+ });
105
+ const economy = new Economy();
106
+
107
+ // ── enemies: one pool per kind, built on demand and reused ─────────────────────────────────
108
+ const enemies = new Map<string, Enemy>();
109
+ const pools = new Map<EnemyKind, Enemy[]>();
110
+ let kills = 0;
111
+ let leaks = 0;
112
+ let status: GameState["status"] = "PLAYING";
113
+ let toastText = "";
114
+ let toastSeq = 0;
115
+ const toast = (text: string): void => {
116
+ toastText = text;
117
+ toastSeq += 1;
118
+ };
119
+ const onDefeated = (enemy: Enemy): void => {
120
+ kills += 1;
121
+ economy.reward(ENEMIES[enemy.kind].reward);
122
+ effects.burst(
123
+ enemy.deathPoint,
124
+ palette.enemies[enemy.kind],
125
+ enemy.kind === "titan" ? 28 : 10,
126
+ 4.5,
127
+ );
128
+ };
129
+ const onLeak = (enemy: Enemy): void => {
130
+ const lost = ENEMIES[enemy.kind].leak;
131
+ leaks += lost;
132
+ economy.leak(lost);
133
+ waves.markLeak();
134
+ shake.trigger();
135
+ toast(`Reactor hit -${lost}`);
136
+ if (economy.lives <= 0) status = "LOST";
137
+ };
138
+ const spawnEnemy = (spawn: ISpawn, wave: number): void => {
139
+ let pool = pools.get(spawn.kind);
140
+ if (pool === undefined) {
141
+ pool = [];
142
+ pools.set(spawn.kind, pool);
143
+ }
144
+ let enemy = pool.find((candidate) => !candidate.active);
145
+ if (enemy === undefined) {
146
+ const entityId = `enemy.${spawn.kind}.${pool.length}`;
147
+ enemy = new Enemy({
148
+ id: entityId,
149
+ kind: spawn.kind,
150
+ onDefeated,
151
+ onLeak,
152
+ physics: ctx.physics,
153
+ points: board.points,
154
+ });
155
+ pool.push(enemy);
156
+ enemies.set(entityId, enemy);
157
+ ctx.add(enemy.mesh);
158
+ ctx.entities.add(entityId, enemy);
159
+ }
160
+ enemy.reset(`${enemy.entityId}.w${wave}`, spawn.hp);
161
+ };
162
+ const waves = new WaveDirector({
163
+ onCleared: (wave, leaked) => {
164
+ const bonus = waveBonus(wave, leaked);
165
+ economy.bonus(bonus);
166
+ toast(wave >= 12 ? "The line held" : `Wave ${wave} cleared +${bonus}`);
167
+ if (waves.won) status = "WON";
168
+ },
169
+ onSpawn: spawnEnemy,
170
+ });
171
+
172
+ // ── towers ─────────────────────────────────────────────────────────────────────────────────
173
+ const towers = new Map<string, Tower>();
174
+ const towerAt = new Map<number, Tower>();
175
+ let towerSerial = 0;
176
+ let shots = 0;
177
+ let placementRejects = 0;
178
+ let fundsRejects = 0;
179
+ const world = {
180
+ effects,
181
+ enemies,
182
+ onShot: () => {
183
+ shots += 1;
184
+ },
185
+ query: ctx.physics.directSpaceState,
186
+ random: ctx.random,
187
+ };
188
+ const raise = (kind: TowerKind, pad: number, invested: number): Tower => {
189
+ const id = String(towerSerial);
190
+ towerSerial += 1;
191
+ const tower = new Tower({ id, kind, padIndex: pad, position: board.position(pad), world });
192
+ tower.invested = invested;
193
+ towers.set(id, tower);
194
+ towerAt.set(pad, tower);
195
+ board.occupy(pad);
196
+ ctx.add(tower.group);
197
+ ctx.entities.add(`tower.${id}`, tower);
198
+ return tower;
199
+ };
200
+ raise("sentry", STARTING_PAD, TOWERS.sentry.cost);
201
+
202
+ // ── selection, arming and the preview under the pointer ────────────────────────────────────
203
+ let armed: TowerKind | "" = "";
204
+ let strikeArmed = false;
205
+ let strikeTimer = 0;
206
+ let selected: Tower | undefined;
207
+ let hoverPad: number | undefined;
208
+ let helpOpen = false;
209
+ let paused = false;
210
+ let autoSend = false;
211
+ let speedIndex = 0;
212
+
213
+ const ghosts = new Map<TowerKind, Group>();
214
+ for (const kind of TOWER_KINDS) {
215
+ const ghost = ghostTower(kind);
216
+ ghost.visible = false;
217
+ ctx.add(ghost);
218
+ ghosts.set(kind, ghost);
219
+ }
220
+ const hoverRing: Mesh = rangeRing(1);
221
+ const selectRing: Mesh = rangeRing(1);
222
+ hoverRing.visible = selectRing.visible = false;
223
+ ctx.add(hoverRing);
224
+ ctx.add(selectRing);
225
+ let hoverRadius = 0;
226
+ let selectRadius = 0;
227
+ const setRing = (ring: Mesh, radius: number): void => {
228
+ ring.geometry.dispose();
229
+ ring.geometry = rangeGeometry(radius);
230
+ };
231
+
232
+ const select = (tower: Tower | undefined): void => {
233
+ selected = tower;
234
+ if (tower === undefined) {
235
+ selectRing.visible = false;
236
+ return;
237
+ }
238
+ selectRing.position.set(tower.position.x, 0.09, tower.position.z);
239
+ if (selectRadius !== tower.stats.range) {
240
+ selectRadius = tower.stats.range;
241
+ setRing(selectRing, selectRadius);
242
+ }
243
+ selectRing.visible = true;
244
+ };
245
+
246
+ const build = (kind: TowerKind, pad: number, keepArmed: boolean): boolean => {
247
+ if (board.occupied(pad)) {
248
+ placementRejects += 1;
249
+ return false;
250
+ }
251
+ if (!economy.spend(TOWERS[kind].cost)) {
252
+ fundsRejects += 1;
253
+ toast("Not enough credits");
254
+ return false;
255
+ }
256
+ select(raise(kind, pad, TOWERS[kind].cost));
257
+ if (!keepArmed) armed = "";
258
+ emitPlaytestEvent({ entity: `pad.${pad}`, name: "built", kind });
259
+ return true;
260
+ };
261
+
262
+ const strike = (at: Vector3): void => {
263
+ if (Math.abs(at.x) > STRIKE_BOUNDS.x || Math.abs(at.z) > STRIKE_BOUNDS.z) {
264
+ toast("Target the board");
265
+ return;
266
+ }
267
+ strikeArmed = false;
268
+ strikeTimer = STRIKE_COOLDOWN;
269
+ const damage = strikeDamage(Math.max(1, waves.wave));
270
+ const centre = new Vector3(at.x, 0, at.z);
271
+ effects.column(centre, palette.effects.strike);
272
+ effects.ring(centre, STRIKE_RADIUS, palette.effects.strike, 0.6);
273
+ effects.burst(centre, palette.effects.strike, 36, 7);
274
+ shake.trigger();
275
+ for (const enemy of enemies.values())
276
+ if (
277
+ enemy.active &&
278
+ Math.hypot(enemy.position.x - at.x, enemy.position.z - at.z) <= STRIKE_RADIUS
279
+ )
280
+ enemy.takeDamage(damage);
281
+ emitPlaytestEvent({ entity: "strike", name: "struck", damage });
282
+ };
283
+
284
+ const tapPad = (pad: number | undefined, point: Vector3): void => {
285
+ if (status !== "PLAYING" || paused) return;
286
+ if (strikeArmed) {
287
+ strike(point);
288
+ return;
289
+ }
290
+ if (pad === undefined) {
291
+ select(undefined);
292
+ return;
293
+ }
294
+ const there = towerAt.get(pad);
295
+ if (there !== undefined) {
296
+ select(selected === there ? undefined : there);
297
+ return;
298
+ }
299
+ if (armed === "") {
300
+ toast("Choose a tower from the armory");
301
+ return;
302
+ }
303
+ const shift = ctx.input.raw.keys.has(LEFT_SHIFT) || ctx.input.raw.keys.has(RIGHT_SHIFT);
304
+ build(armed, pad, shift);
305
+ };
306
+ ctx.pointer?.on(board.hits, "pointerEntered", (event) => {
307
+ hoverPad = board.padOf(event.object);
308
+ });
309
+ ctx.pointer?.on(board.hits, "pointerExited", () => {
310
+ hoverPad = undefined;
311
+ });
312
+ ctx.pointer?.on(board.hits, "tapped", (event) =>
313
+ tapPad(board.padOf(event.object), event.point),
314
+ );
315
+ ctx.pointer?.on(board.ground, "tapped", (event) => tapPad(undefined, event.point));
316
+
317
+ const upgrade = (): void => {
318
+ const tower = selected;
319
+ if (tower === undefined) return;
320
+ const cost = upgradeCost(tower.kind, tower.level);
321
+ if (cost === undefined) {
322
+ toast("Already at MK.III");
323
+ return;
324
+ }
325
+ if (!economy.spend(cost)) {
326
+ fundsRejects += 1;
327
+ toast("Not enough credits");
328
+ return;
329
+ }
330
+ tower.invested += cost;
331
+ tower.upgrade();
332
+ select(tower);
333
+ setRing(selectRing, tower.stats.range);
334
+ selectRadius = tower.stats.range;
335
+ emitPlaytestEvent({ entity: `tower.${tower.id}`, name: "upgraded", level: tower.level });
336
+ };
337
+ const recycle = (): void => {
338
+ const tower = selected;
339
+ if (tower === undefined) return;
340
+ const refund = sellValue(tower.invested);
341
+ economy.refund(Math.max(1, refund));
342
+ board.free(tower.padIndex);
343
+ towerAt.delete(tower.padIndex);
344
+ towers.delete(tower.id);
345
+ select(undefined);
346
+ ctx.entities.remove(`tower.${tower.id}`);
347
+ toast(`Recycled +${refund}`);
348
+ };
349
+ const safeBuild = (): void => {
350
+ const pad = SAFE_PADS.find((candidate) => !board.occupied(candidate));
351
+ if (pad === undefined) {
352
+ placementRejects += 1;
353
+ toast("No free pads");
354
+ return;
355
+ }
356
+ build(armed === "" ? "sentry" : armed, pad, false);
357
+ };
358
+
359
+ const arm = (kind: TowerKind | ""): void => {
360
+ armed = armed === kind ? "" : kind;
361
+ strikeArmed = false;
362
+ };
363
+ const handleIntent = (intent: string, payload: unknown): void => {
364
+ if (status !== "PLAYING" && intent !== "restart" && intent !== "help") return;
365
+ switch (intent) {
366
+ case "arm":
367
+ if (payload === "" || TOWER_KINDS.includes(payload as TowerKind))
368
+ arm(payload as TowerKind | "");
369
+ break;
370
+ case "launch":
371
+ if (!paused && waves.launch()) toast(`Wave ${waves.wave} incoming`);
372
+ break;
373
+ case "upgrade":
374
+ upgrade();
375
+ break;
376
+ case "recycle":
377
+ recycle();
378
+ break;
379
+ case "target":
380
+ if (selected !== undefined && TARGET_MODES.includes(payload as TargetMode))
381
+ selected.mode = payload as TargetMode;
382
+ break;
383
+ case "speed":
384
+ speedIndex = (speedIndex + 1) % SPEEDS.length;
385
+ break;
386
+ case "autosend":
387
+ autoSend = !autoSend;
388
+ waves.autoSend = autoSend;
389
+ break;
390
+ case "pause":
391
+ paused = true;
392
+ break;
393
+ case "resume":
394
+ paused = false;
395
+ break;
396
+ case "strike":
397
+ if (waves.phase === "combat" && strikeTimer <= 0) {
398
+ strikeArmed = !strikeArmed;
399
+ armed = "";
400
+ } else toast(strikeTimer > 0 ? "Strike recharging" : "Strike needs a wave");
401
+ break;
402
+ case "cancel":
403
+ armed = "";
404
+ strikeArmed = false;
405
+ select(undefined);
406
+ helpOpen = false;
407
+ break;
408
+ case "help":
409
+ helpOpen = !helpOpen;
410
+ break;
411
+ default:
412
+ break;
413
+ }
414
+ };
415
+
416
+ ctx.entities.add("battle", {
417
+ debug: () => ({
418
+ armed,
419
+ hostiles: waves.queued + [...enemies.values()].filter((enemy) => enemy.active).length,
420
+ hoverPad: hoverPad ?? -1,
421
+ phase: waves.phase,
422
+ selected: selected?.id ?? "",
423
+ wave: waves.wave,
424
+ }),
425
+ });
426
+
427
+ // ── one frame, in four steps ───────────────────────────────────────────────────────────────
428
+ // Keys and UI intents meet in `handleIntent`: a key is only an intent that arrived from the
429
+ // keyboard, so a button and its hotkey can never disagree.
430
+ const readKeys = (input: FrameCtx["input"]): void => {
431
+ for (const name of KEY_INTENTS) if (input.justPressed(name)) handleIntent(name, undefined);
432
+ if (input.justPressed("pause")) handleIntent(paused ? "resume" : "pause", undefined);
433
+ if (input.justPressed("safeBuild")) safeBuild();
434
+ for (const [index, kind] of TOWER_KINDS.entries())
435
+ if (input.justPressed(`tower${index + 1}`)) handleIntent("arm", kind);
436
+ for (const { intent, payload } of drainIntents()) handleIntent(intent, payload);
437
+ };
438
+
439
+ const stepSimulation = (step: number): void => {
440
+ strikeTimer = Math.max(0, strikeTimer - step);
441
+ for (const enemy of enemies.values()) enemy.update(step);
442
+ for (const tower of towers.values()) tower.update(step);
443
+ effects.update(step);
444
+ board.update(step);
445
+ let alive = 0;
446
+ for (const enemy of enemies.values()) if (enemy.active) alive += 1;
447
+ waves.update(step, alive, effects.inFlight);
448
+ };
449
+
450
+ // The preview follows the pointer: a see-through tower where one would stand, and the ring of
451
+ // what it would cover — or, over a tower already built, the ring of the tower itself.
452
+ const syncPreview = (): void => {
453
+ for (const ghost of ghosts.values()) ghost.visible = false;
454
+ hoverRing.visible = false;
455
+ if (hoverPad === undefined || status !== "PLAYING") return;
456
+ const there = towerAt.get(hoverPad);
457
+ const at = board.position(hoverPad);
458
+ const range =
459
+ there !== undefined ? there.stats.range : armed === "" ? 0 : towerStats(armed, 1).range;
460
+ if (range > 0) {
461
+ if (range !== hoverRadius) {
462
+ hoverRadius = range;
463
+ setRing(hoverRing, range);
464
+ }
465
+ hoverRing.position.set(at.x, 0.09, at.z);
466
+ hoverRing.visible = true;
467
+ }
468
+ const ghost = there === undefined && armed !== "" ? ghosts.get(armed) : undefined;
469
+ if (ghost === undefined) return;
470
+ ghost.position.copy(at);
471
+ ghost.visible = true;
472
+ };
473
+
474
+ // Publish only what changed: the HUD is another process on native, and a frame that changed
475
+ // nothing should cost it nothing.
476
+ const next: GameState = { ...INITIAL_STATE };
477
+ const publish = (frameCtx: FrameCtx, speed: number): void => {
478
+ const previous = frameCtx.state.getState();
479
+ let hostiles = waves.queued;
480
+ for (const enemy of enemies.values()) if (enemy.active) hostiles += 1;
481
+ const sel = selected;
482
+ const cost = sel === undefined ? undefined : upgradeCost(sel.kind, sel.level);
483
+ next.armed = armed;
484
+ next.autoSend = autoSend;
485
+ // The credits shown are whole: a fraction never appears on screen, so it must not republish.
486
+ next.credits = Math.floor(economy.credits);
487
+ next.fundsRejects = fundsRejects;
488
+ next.helpOpen = helpOpen;
489
+ next.hostiles = hostiles;
490
+ next.kills = kills;
491
+ next.leaks = leaks;
492
+ next.lives = economy.lives;
493
+ next.paused = paused || helpOpen;
494
+ next.phase = waves.phase;
495
+ next.placementRejects = placementRejects;
496
+ next.score = economy.score;
497
+ next.selDamage = sel?.stats.damage ?? 0;
498
+ next.selKind = sel?.kind ?? "";
499
+ next.selLevel = sel?.level ?? 0;
500
+ next.selMode = sel?.mode ?? "first";
501
+ next.selRange = sel === undefined ? 0 : Math.round(sel.stats.range * 10) / 10;
502
+ next.selSell = sel === undefined ? 0 : sellValue(sel.invested);
503
+ next.selUpgrade = cost ?? 0;
504
+ next.selected = sel !== undefined;
505
+ next.shots = shots;
506
+ next.speed = speed;
507
+ next.spent = economy.spent;
508
+ next.status = status;
509
+ next.strikeArmed = strikeArmed;
510
+ next.strikeCooldown = Math.ceil(strikeTimer);
511
+ next.toast = toastText;
512
+ next.toastSeq = toastSeq;
513
+ next.towers = towers.size;
514
+ next.uiReady = previous.uiReady;
515
+ next.wave = waves.wave;
516
+ if (!sameState(next, previous)) frameCtx.state.set(next);
517
+ };
518
+
519
+ return (frameCtx, rawDt) => {
520
+ loading.update();
521
+ const input = frameCtx.input;
522
+ if (input.justPressed("restart")) {
523
+ frameCtx.state.set(INITIAL_STATE);
524
+ frameCtx.state.flush();
525
+ void frameCtx.goto("battle");
526
+ return;
527
+ }
528
+ readKeys(input);
529
+ const speed = SPEEDS[speedIndex] ?? 1;
530
+ const delta = Math.min(rawDt, 0.1);
531
+ if (status === "PLAYING" && !paused && !helpOpen) stepSimulation(delta * speed);
532
+ const offset = shake.update(delta);
533
+ rig.update(camera, input, input.raw.pointer.position.x, delta, offset.position);
534
+ for (const enemy of enemies.values()) if (enemy.active) enemy.faceCamera(camera.quaternion);
535
+ syncPreview();
536
+ publish(frameCtx, speed);
537
+ };
538
+ }
539
+ }
@@ -1,12 +1,12 @@
1
1
  import { Scene } from "@threenative/core";
2
2
  import type { IPhysicsContext } from "@threenative/physics";
3
3
  import type { GameState } from "../state.js";
4
- import { type GameCtx, Play } from "./Play.js";
4
+ import { Battle, type GameCtx } from "./Battle.js";
5
5
 
6
6
  export class Boot extends Scene<GameState, IPhysicsContext> {
7
- static override readonly initialState = Play.initialState;
7
+ static override readonly initialState = Battle.initialState;
8
8
 
9
9
  override enter(ctx: GameCtx): void {
10
- void ctx.goto("play");
10
+ void ctx.goto("battle");
11
11
  }
12
12
  }
@@ -0,0 +1,88 @@
1
+ import type { TargetMode, TowerKind } from "./balance.js";
2
+ import { START_CREDITS, START_LIVES } from "./balance.js";
3
+
4
+ export type GameStatus = "LOST" | "PLAYING" | "WON";
5
+
6
+ /**
7
+ * Everything the HUD reads, and nothing it can write: the UI sends intents and the game decides.
8
+ * Flat on purpose — the state crosses a process boundary on every native target, and a flat record
9
+ * is the cheapest thing to diff and mirror.
10
+ */
11
+ export type GameState = {
12
+ /** Set from the UI's pause and resume intents, and read back by the menu. */
13
+ paused: boolean;
14
+ /** The field guide is up; the simulation is held while it is. */
15
+ helpOpen: boolean;
16
+ /** True once the UI layer has rendered and published its interactive rectangles. */
17
+ uiReady: boolean;
18
+ status: GameStatus;
19
+ phase: "build" | "combat";
20
+ wave: number;
21
+ credits: number;
22
+ lives: number;
23
+ score: number;
24
+ kills: number;
25
+ leaks: number;
26
+ towers: number;
27
+ /** Enemies still to come plus enemies on the road. */
28
+ hostiles: number;
29
+ autoSend: boolean;
30
+ speed: number;
31
+ /** The tower kind the next pad tap builds, or "" when none is armed. */
32
+ armed: TowerKind | "";
33
+ strikeArmed: boolean;
34
+ /** Whole seconds until the orbital strike is ready; 0 when it is. */
35
+ strikeCooldown: number;
36
+ /** The selected tower's panel, flat: `selected` is false when nothing is selected. */
37
+ selected: boolean;
38
+ selKind: TowerKind | "";
39
+ selLevel: number;
40
+ selMode: TargetMode;
41
+ selDamage: number;
42
+ selRange: number;
43
+ /** Credits the next upgrade costs, 0 at the top level. */
44
+ selUpgrade: number;
45
+ selSell: number;
46
+ /** One line of feedback ("Not enough credits"); `toastSeq` changes with every new one. */
47
+ toast: string;
48
+ toastSeq: number;
49
+ shots: number;
50
+ spent: number;
51
+ placementRejects: number;
52
+ fundsRejects: number;
53
+ };
54
+
55
+ export const INITIAL_STATE: GameState = {
56
+ armed: "",
57
+ autoSend: false,
58
+ credits: START_CREDITS,
59
+ fundsRejects: 0,
60
+ helpOpen: false,
61
+ hostiles: 0,
62
+ kills: 0,
63
+ leaks: 0,
64
+ lives: START_LIVES,
65
+ paused: false,
66
+ phase: "build",
67
+ placementRejects: 0,
68
+ score: 0,
69
+ selDamage: 0,
70
+ selKind: "",
71
+ selLevel: 0,
72
+ selMode: "first",
73
+ selRange: 0,
74
+ selSell: 0,
75
+ selUpgrade: 0,
76
+ selected: false,
77
+ shots: 0,
78
+ speed: 1,
79
+ spent: 0,
80
+ status: "PLAYING",
81
+ strikeArmed: false,
82
+ strikeCooldown: 0,
83
+ toast: "",
84
+ toastSeq: 0,
85
+ towers: 1,
86
+ uiReady: false,
87
+ wave: 0,
88
+ };