create-threenative 0.2.5 → 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 (631) hide show
  1. package/README.md +25 -3
  2. package/agent-docs/references/assertion-reference.md +40 -1
  3. package/agent-docs/references/build-profiles.md +126 -0
  4. package/agent-docs/references/capability-reference.md +1382 -65
  5. package/agent-docs/references/finding-assets.md +8 -1
  6. package/agent-docs/references/performance-basics.md +117 -0
  7. package/agent-docs/references/rigging-characters.md +51 -0
  8. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  9. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  10. package/agent-docs/references/visual-baseline.md +8 -4
  11. package/agent-docs/references/webview-ui.md +3 -2
  12. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  13. package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
  14. package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
  15. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  16. package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
  17. package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
  18. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  19. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  20. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  21. package/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
  22. package/agent-files/.claude/settings.json +38 -0
  23. package/agent-files/.codex/hooks.json +40 -0
  24. package/capabilities.json +1891 -101
  25. package/dist/index.d.ts +39 -1
  26. package/dist/index.js +480 -56
  27. package/dist/threenative.js +1247 -177
  28. package/package.json +6 -6
  29. package/template-assets/assets/mannequin-combat.glb +0 -0
  30. package/template-assets/assets/mannequin.glb +0 -0
  31. package/template-assets/assets/player-viewmodel.glb +0 -0
  32. package/template-assets/assets/sky.jpg +0 -0
  33. package/template-assets/clearwater/README.md +141 -0
  34. package/template-assets/clearwater/install.mjs +50 -0
  35. package/template-assets/clearwater/src/clearwater.ts +180 -0
  36. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  37. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  38. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  39. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  40. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  41. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  42. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  43. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  44. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  45. package/template-assets/patches/three@0.185.1.patch +2228 -105
  46. package/template-assets/worldEnvironment.ts +52 -1
  47. package/templates/action-rpg/AGENTS.md +43 -43
  48. package/templates/action-rpg/CLAUDE.md +43 -43
  49. package/templates/action-rpg/kit.json +1 -1
  50. package/templates/action-rpg/package.json +14 -8
  51. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  52. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  53. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  54. package/templates/action-rpg/src/conventions.ts +24 -18
  55. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  56. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  57. package/templates/action-rpg/src/entities/Player.ts +102 -32
  58. package/templates/action-rpg/src/game.ts +3 -3
  59. package/templates/action-rpg/src/render/camera.ts +18 -16
  60. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  61. package/templates/action-rpg/src/render/lighting.ts +45 -28
  62. package/templates/action-rpg/src/render/loading.ts +4 -4
  63. package/templates/action-rpg/src/render/materials.ts +191 -47
  64. package/templates/action-rpg/src/render/palette.ts +14 -13
  65. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  66. package/templates/action-rpg/src/render/props.ts +117 -0
  67. package/templates/action-rpg/src/render/quality.ts +40 -82
  68. package/templates/action-rpg/src/render/sky.ts +36 -13
  69. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  71. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  72. package/templates/action-rpg/src/style.css +9 -7
  73. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  74. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  75. package/templates/action-rpg/threenative.config.ts +14 -1
  76. package/templates/action-rpg/vite.config.ts +4 -1
  77. package/templates/minimal/AGENTS.md +12 -12
  78. package/templates/minimal/CLAUDE.md +12 -12
  79. package/templates/minimal/package.json +13 -7
  80. package/templates/minimal/playtests/play.playtest.json +6 -5
  81. package/templates/minimal/playtests/sky.playtest.json +27 -0
  82. package/templates/minimal/src/conventions.ts +6 -3
  83. package/templates/minimal/src/entities/Player.ts +73 -27
  84. package/templates/minimal/src/main.ts +2 -3
  85. package/templates/minimal/src/render/camera.ts +22 -4
  86. package/templates/minimal/src/render/lighting.ts +24 -48
  87. package/templates/minimal/src/render/materials.ts +158 -13
  88. package/templates/minimal/src/render/palette.ts +10 -7
  89. package/templates/minimal/src/render/postprocessing.ts +12 -25
  90. package/templates/minimal/src/render/quality.ts +35 -69
  91. package/templates/minimal/src/render/sky.ts +35 -54
  92. package/templates/minimal/src/render/touch-controls.ts +1 -1
  93. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  94. package/templates/minimal/src/scenes/Play.ts +121 -111
  95. package/templates/minimal/src/state.ts +0 -4
  96. package/templates/minimal/src/style.css +0 -10
  97. package/templates/minimal/threenative.config.ts +15 -1
  98. package/templates/minimal/vite.config.ts +4 -1
  99. package/templates/platformer/AGENTS.md +18 -56
  100. package/templates/platformer/CLAUDE.md +18 -56
  101. package/templates/platformer/kit.json +2 -2
  102. package/templates/platformer/package.json +14 -10
  103. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  104. package/templates/platformer/playtests/collect.playtest.json +8 -34
  105. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  106. package/templates/platformer/playtests/damage.playtest.json +40 -15
  107. package/templates/platformer/playtests/hud.playtest.json +34 -0
  108. package/templates/platformer/playtests/move.playtest.json +24 -0
  109. package/templates/platformer/playtests/performance.playtest.json +24 -7
  110. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  111. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  112. package/templates/platformer/playtests/survives.playtest.json +3 -19
  113. package/templates/platformer/playtests/world.playtest.json +26 -0
  114. package/templates/platformer/src/entities/Fox.ts +273 -0
  115. package/templates/platformer/src/entities/Pickup.ts +43 -60
  116. package/templates/platformer/src/entities/Walker.ts +88 -0
  117. package/templates/platformer/src/game.ts +11 -8
  118. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  119. package/templates/platformer/src/level/Stage.ts +469 -0
  120. package/templates/platformer/src/render/blocks.ts +94 -0
  121. package/templates/platformer/src/render/camera.ts +28 -3
  122. package/templates/platformer/src/render/fox.ts +196 -0
  123. package/templates/platformer/src/render/lighting.ts +42 -33
  124. package/templates/platformer/src/render/materials.ts +115 -5
  125. package/templates/platformer/src/render/palette.ts +68 -53
  126. package/templates/platformer/src/render/pickups.ts +142 -0
  127. package/templates/platformer/src/render/postprocessing.ts +12 -2
  128. package/templates/platformer/src/render/props.ts +147 -0
  129. package/templates/platformer/src/render/quality.ts +47 -99
  130. package/templates/platformer/src/render/scenery.ts +172 -0
  131. package/templates/platformer/src/render/sky.ts +120 -31
  132. package/templates/platformer/src/render/touch-controls.ts +5 -2
  133. package/templates/platformer/src/render/walkers.ts +96 -0
  134. package/templates/platformer/src/render/waterfall.ts +85 -0
  135. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  136. package/templates/platformer/src/scenes/Boot.ts +3 -4
  137. package/templates/platformer/src/scenes/Play.ts +362 -0
  138. package/templates/platformer/src/state.ts +16 -14
  139. package/templates/platformer/src/style.css +9 -8
  140. package/templates/platformer/src/ui/Hud.tsx +62 -29
  141. package/templates/platformer/src/ui/Menu.tsx +2 -2
  142. package/templates/platformer/threenative.config.ts +14 -1
  143. package/templates/platformer/vite.config.ts +4 -1
  144. package/templates/puzzle/AGENTS.md +21 -22
  145. package/templates/puzzle/CLAUDE.md +21 -22
  146. package/templates/puzzle/assets/native-proof.glb +0 -0
  147. package/templates/puzzle/assets/native-proof.png +0 -0
  148. package/templates/puzzle/kit.json +1 -1
  149. package/templates/puzzle/package.json +14 -8
  150. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  151. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  152. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  153. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  154. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  155. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  156. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  157. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  158. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  159. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  160. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  161. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  162. package/templates/puzzle/src/entities/Crate.ts +99 -42
  163. package/templates/puzzle/src/entities/Seal.ts +69 -0
  164. package/templates/puzzle/src/entities/Warden.ts +135 -0
  165. package/templates/puzzle/src/game.ts +15 -11
  166. package/templates/puzzle/src/render/camera.ts +66 -31
  167. package/templates/puzzle/src/render/crateShape.ts +70 -0
  168. package/templates/puzzle/src/render/lighting.ts +41 -41
  169. package/templates/puzzle/src/render/loading.ts +4 -4
  170. package/templates/puzzle/src/render/materials.ts +131 -27
  171. package/templates/puzzle/src/render/palette.ts +19 -29
  172. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  173. package/templates/puzzle/src/render/quality.ts +71 -80
  174. package/templates/puzzle/src/render/shapes.ts +109 -108
  175. package/templates/puzzle/src/render/sky.ts +18 -10
  176. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  177. package/templates/puzzle/src/render/vault.ts +315 -0
  178. package/templates/puzzle/src/render/warden.ts +46 -0
  179. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  180. package/templates/puzzle/src/scenes/Play.ts +793 -0
  181. package/templates/puzzle/src/state.ts +55 -24
  182. package/templates/puzzle/src/style.css +7 -8
  183. package/templates/puzzle/src/ui/App.tsx +2 -2
  184. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  185. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  186. package/templates/puzzle/threenative.config.ts +14 -1
  187. package/templates/puzzle/vite.config.ts +4 -1
  188. package/templates/racing/AGENTS.md +20 -21
  189. package/templates/racing/CLAUDE.md +20 -21
  190. package/templates/racing/package.json +14 -8
  191. package/templates/racing/playtests/boost.playtest.json +33 -12
  192. package/templates/racing/playtests/outcome.playtest.json +32 -50
  193. package/templates/racing/playtests/performance.playtest.json +2 -1
  194. package/templates/racing/playtests/ranking.playtest.json +5 -14
  195. package/templates/racing/playtests/rescue.playtest.json +2 -2
  196. package/templates/racing/playtests/reverse.playtest.json +30 -8
  197. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  198. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  199. package/templates/racing/src/entities/CarBody.ts +327 -0
  200. package/templates/racing/src/entities/LineDriver.ts +220 -0
  201. package/templates/racing/src/entities/RacingCar.ts +150 -89
  202. package/templates/racing/src/entities/Rival.ts +61 -24
  203. package/templates/racing/src/game.ts +5 -0
  204. package/templates/racing/src/render/camera.ts +49 -7
  205. package/templates/racing/src/render/lighting.ts +36 -37
  206. package/templates/racing/src/render/materials.ts +239 -19
  207. package/templates/racing/src/render/palette.ts +19 -21
  208. package/templates/racing/src/render/postprocessing.ts +12 -2
  209. package/templates/racing/src/render/quality.ts +43 -82
  210. package/templates/racing/src/render/shapes.ts +20 -6
  211. package/templates/racing/src/render/sky.ts +47 -39
  212. package/templates/racing/src/render/touch-controls.ts +1 -1
  213. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  214. package/templates/racing/src/scenes/Race.ts +107 -54
  215. package/templates/racing/src/state.ts +2 -0
  216. package/templates/racing/src/track/Checkline.ts +22 -7
  217. package/templates/racing/src/track/Lap.ts +64 -36
  218. package/templates/racing/src/track/Ranking.ts +20 -11
  219. package/templates/racing/src/track/Track.ts +809 -361
  220. package/templates/racing/src/track/TrackSector.ts +40 -11
  221. package/templates/racing/src/track/circuit.ts +477 -0
  222. package/templates/racing/src/track/rescue.ts +16 -4
  223. package/templates/racing/threenative.config.ts +14 -1
  224. package/templates/racing/vite.config.ts +4 -1
  225. package/templates/rts/AGENTS.md +96 -0
  226. package/templates/rts/CLAUDE.md +98 -0
  227. package/templates/rts/kit.json +7 -0
  228. package/templates/{defense → rts}/package.json +14 -8
  229. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  230. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  231. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  232. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  233. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  234. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  235. package/templates/rts/playtests/survives.playtest.json +58 -0
  236. package/templates/rts/public/favicon.svg +4 -0
  237. package/templates/rts/src/game.ts +64 -0
  238. package/templates/rts/src/orders.ts +22 -0
  239. package/templates/rts/src/render/army.ts +346 -0
  240. package/templates/rts/src/render/camera.ts +123 -0
  241. package/templates/rts/src/render/lighting.ts +61 -0
  242. package/templates/rts/src/render/loading.ts +33 -0
  243. package/templates/rts/src/render/materials.ts +152 -0
  244. package/templates/rts/src/render/models.ts +705 -0
  245. package/templates/rts/src/render/palette.ts +17 -0
  246. package/templates/rts/src/render/picking.ts +93 -0
  247. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  248. package/templates/rts/src/render/quality.ts +128 -0
  249. package/templates/rts/src/render/resources.ts +141 -0
  250. package/templates/rts/src/render/sky.ts +44 -0
  251. package/templates/rts/src/render/terrain.ts +116 -0
  252. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  253. package/templates/rts/src/scenes/Play.ts +650 -0
  254. package/templates/rts/src/sim/ai.ts +1140 -0
  255. package/templates/rts/src/sim/combat.ts +416 -0
  256. package/templates/rts/src/sim/construction.ts +374 -0
  257. package/templates/rts/src/sim/economy.ts +167 -0
  258. package/templates/rts/src/sim/game.ts +1082 -0
  259. package/templates/rts/src/sim/movement.ts +371 -0
  260. package/templates/rts/src/sim/nav.ts +276 -0
  261. package/templates/rts/src/sim/production.ts +180 -0
  262. package/templates/rts/src/sim/terrain.ts +170 -0
  263. package/templates/rts/src/sim/types.ts +647 -0
  264. package/templates/rts/src/sim/vision.ts +46 -0
  265. package/templates/rts/src/state.ts +100 -0
  266. package/templates/{defense → rts}/src/style.css +21 -8
  267. package/templates/rts/src/ui/App.tsx +21 -0
  268. package/templates/rts/src/ui/Commands.tsx +129 -0
  269. package/templates/rts/src/ui/GameUi.tsx +22 -0
  270. package/templates/rts/src/ui/Hud.tsx +165 -0
  271. package/templates/rts/src/ui/Minimap.tsx +84 -0
  272. package/templates/rts/tailwind.config.ts +2 -0
  273. package/templates/rts/threenative.config.ts +56 -0
  274. package/templates/rts/tsconfig.json +17 -0
  275. package/templates/{defense → rts}/vite.config.ts +4 -1
  276. package/templates/runner/AGENTS.md +8 -12
  277. package/templates/runner/CLAUDE.md +8 -12
  278. package/templates/runner/README.md +3 -3
  279. package/templates/runner/package.json +14 -8
  280. package/templates/runner/playtests/performance.playtest.json +2 -2
  281. package/templates/runner/src/conventions.ts +4 -3
  282. package/templates/runner/src/entities/Runner.ts +54 -7
  283. package/templates/runner/src/game.ts +2 -0
  284. package/templates/runner/src/render/camera.ts +4 -2
  285. package/templates/runner/src/render/dust.ts +5 -2
  286. package/templates/runner/src/render/lighting.ts +41 -45
  287. package/templates/runner/src/render/loading.ts +2 -2
  288. package/templates/runner/src/render/materials.ts +165 -25
  289. package/templates/runner/src/render/palette.ts +17 -28
  290. package/templates/runner/src/render/postprocessing.ts +12 -2
  291. package/templates/runner/src/render/quality.ts +42 -96
  292. package/templates/runner/src/render/shapes.ts +59 -37
  293. package/templates/runner/src/render/sky.ts +32 -41
  294. package/templates/runner/src/render/touch-controls.ts +1 -1
  295. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  296. package/templates/runner/src/scenes/Run.ts +26 -6
  297. package/templates/runner/src/track.ts +6 -1
  298. package/templates/runner/threenative.config.ts +14 -1
  299. package/templates/runner/vite.config.ts +4 -1
  300. package/templates/sailing/AGENTS.md +14 -14
  301. package/templates/sailing/CLAUDE.md +14 -14
  302. package/templates/sailing/assets/ship.glb +0 -0
  303. package/templates/sailing/package.json +14 -8
  304. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  305. package/templates/sailing/playtests/sails.playtest.json +33 -0
  306. package/templates/sailing/playtests/win.playtest.json +156 -8
  307. package/templates/sailing/src/conventions.ts +29 -2
  308. package/templates/sailing/src/entities/Ship.ts +381 -57
  309. package/templates/sailing/src/game.ts +14 -0
  310. package/templates/sailing/src/render/camera.ts +63 -9
  311. package/templates/sailing/src/render/lighting.ts +49 -27
  312. package/templates/sailing/src/render/materials.ts +50 -15
  313. package/templates/sailing/src/render/ocean.ts +647 -60
  314. package/templates/sailing/src/render/palette.ts +16 -12
  315. package/templates/sailing/src/render/postprocessing.ts +12 -2
  316. package/templates/sailing/src/render/props.ts +316 -442
  317. package/templates/sailing/src/render/quality.ts +14 -4
  318. package/templates/sailing/src/render/sky.ts +116 -23
  319. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  320. package/templates/sailing/src/scenes/Boot.ts +21 -0
  321. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  322. package/templates/sailing/src/state.ts +6 -0
  323. package/templates/sailing/src/ui/Hud.tsx +41 -9
  324. package/templates/sailing/threenative.config.ts +14 -1
  325. package/templates/sailing/vite.config.ts +4 -1
  326. package/templates/shooter/AGENTS.md +29 -44
  327. package/templates/shooter/CLAUDE.md +29 -44
  328. package/templates/shooter/index.html +1 -0
  329. package/templates/shooter/package.json +14 -8
  330. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  331. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  332. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  333. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  334. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  335. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  336. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  337. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  338. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  339. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  340. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  341. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  342. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  343. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  344. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  345. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  346. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  347. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  348. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  349. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  350. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  351. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  352. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  353. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  354. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  355. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  356. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  357. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  358. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  359. package/templates/shooter/playtests/performance.playtest.json +62 -26
  360. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  361. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  362. package/templates/shooter/playtests/survives.playtest.json +36 -30
  363. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  364. package/templates/shooter/src/entities/Breakables.ts +412 -0
  365. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  366. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  367. package/templates/shooter/src/entities/Rifle.ts +442 -0
  368. package/templates/shooter/src/entities/Target.ts +199 -83
  369. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  370. package/templates/shooter/src/game.ts +75 -41
  371. package/templates/shooter/src/main.ts +0 -1
  372. package/templates/shooter/src/postPhysics.ts +36 -0
  373. package/templates/shooter/src/render/camera.ts +78 -74
  374. package/templates/shooter/src/render/decals.ts +142 -82
  375. package/templates/shooter/src/render/facade.ts +1373 -0
  376. package/templates/shooter/src/render/gunfx.ts +704 -0
  377. package/templates/shooter/src/render/lighting.ts +52 -38
  378. package/templates/shooter/src/render/loading.ts +2 -2
  379. package/templates/shooter/src/render/materials.ts +100 -88
  380. package/templates/shooter/src/render/occlusion.ts +108 -0
  381. package/templates/shooter/src/render/palette.ts +10 -10
  382. package/templates/shooter/src/render/palm.ts +455 -0
  383. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  384. package/templates/shooter/src/render/postprocessing.ts +15 -3
  385. package/templates/shooter/src/render/quality.ts +40 -82
  386. package/templates/shooter/src/render/scale.ts +148 -15
  387. package/templates/shooter/src/render/shapes.ts +138 -613
  388. package/templates/shooter/src/render/sky.ts +35 -35
  389. package/templates/shooter/src/render/town-schematic.ts +120 -0
  390. package/templates/shooter/src/render/town.ts +986 -0
  391. package/templates/shooter/src/render/townMaterials.ts +160 -0
  392. package/templates/shooter/src/render/vehicles.ts +741 -0
  393. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  394. package/templates/shooter/src/scenes/Play.ts +727 -650
  395. package/templates/shooter/src/state.ts +26 -41
  396. package/templates/shooter/src/style.css +207 -11
  397. package/templates/shooter/src/surfaces.ts +131 -0
  398. package/templates/shooter/src/ui/App.tsx +9 -10
  399. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  400. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  401. package/templates/shooter/src/ui/Hud.tsx +428 -39
  402. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  403. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  404. package/templates/shooter/src/ui/main.tsx +2 -3
  405. package/templates/shooter/threenative.config.ts +14 -1
  406. package/templates/shooter/vite.config.ts +4 -1
  407. package/templates/starter/AGENTS.md +20 -20
  408. package/templates/starter/CLAUDE.md +20 -20
  409. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  410. package/templates/starter/package.json +15 -9
  411. package/templates/starter/playtests/play.playtest.json +2 -1
  412. package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
  413. package/templates/starter/playtests/survives.playtest.json +1 -1
  414. package/templates/starter/src/conventions.ts +6 -3
  415. package/templates/starter/src/entities/Goal.ts +35 -42
  416. package/templates/starter/src/entities/Player.ts +99 -16
  417. package/templates/starter/src/render/arena.ts +131 -0
  418. package/templates/starter/src/render/lighting.ts +27 -44
  419. package/templates/starter/src/render/materials.ts +164 -35
  420. package/templates/starter/src/render/palette.ts +16 -16
  421. package/templates/starter/src/render/postprocessing.ts +6 -7
  422. package/templates/starter/src/render/quality.ts +43 -101
  423. package/templates/starter/src/render/shapes.ts +1 -1
  424. package/templates/starter/src/render/sky.ts +39 -45
  425. package/templates/starter/src/render/touch-controls.ts +3 -1
  426. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  427. package/templates/starter/src/scenes/Play.ts +82 -81
  428. package/templates/starter/src/ui/Hud.tsx +2 -2
  429. package/templates/starter/src/ui/Menu.tsx +5 -1
  430. package/templates/starter/threenative.config.ts +14 -1
  431. package/templates/starter/vite.config.ts +4 -1
  432. package/templates/tower-defense/.codex/config.toml +19 -0
  433. package/templates/tower-defense/.cursor/mcp.json +32 -0
  434. package/templates/tower-defense/.gemini/settings.json +32 -0
  435. package/templates/tower-defense/.mcp.json +32 -0
  436. package/templates/tower-defense/.vscode/mcp.json +36 -0
  437. package/templates/tower-defense/.zed/settings.json +36 -0
  438. package/templates/{defense → tower-defense}/AGENTS.md +16 -14
  439. package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
  440. package/templates/tower-defense/README.md +16 -0
  441. package/templates/tower-defense/index.html +12 -0
  442. package/templates/tower-defense/kit.json +7 -0
  443. package/templates/tower-defense/opencode.json +41 -0
  444. package/templates/tower-defense/package.json +56 -0
  445. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  446. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  447. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  448. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  449. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  450. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  451. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  452. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  453. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  454. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  455. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  456. package/templates/tower-defense/src/balance.ts +187 -0
  457. package/templates/tower-defense/src/board/Board.ts +100 -0
  458. package/templates/tower-defense/src/board/Route.ts +84 -0
  459. package/templates/tower-defense/src/camera-rig.ts +62 -0
  460. package/templates/tower-defense/src/economy.ts +64 -0
  461. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  462. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  463. package/templates/tower-defense/src/game.ts +72 -0
  464. package/templates/tower-defense/src/intents.ts +21 -0
  465. package/templates/tower-defense/src/main.ts +15 -0
  466. package/templates/tower-defense/src/physics.ts +6 -0
  467. package/templates/tower-defense/src/render/camera.ts +38 -0
  468. package/templates/tower-defense/src/render/lighting.ts +42 -0
  469. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  470. package/templates/tower-defense/src/render/materials.ts +103 -0
  471. package/templates/tower-defense/src/render/palette.ts +58 -0
  472. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  473. package/templates/tower-defense/src/render/quality.ts +128 -0
  474. package/templates/tower-defense/src/render/shapes.ts +550 -0
  475. package/templates/tower-defense/src/render/sky.ts +27 -0
  476. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  477. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  478. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  479. package/templates/tower-defense/src/state.ts +88 -0
  480. package/templates/tower-defense/src/style.css +137 -0
  481. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  482. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  483. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  484. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  485. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  486. package/templates/tower-defense/src/ui/main.tsx +14 -0
  487. package/templates/tower-defense/src/waves.ts +90 -0
  488. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  489. package/templates/tower-defense/vite.config.ts +41 -0
  490. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  491. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  492. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
  493. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  494. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
  495. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
  496. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  497. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  498. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  499. package/agent-files/AGENT-ROLES.md +0 -26
  500. package/templates/action-rpg/src/render/shapes.ts +0 -269
  501. package/templates/action-rpg/src/render/types.ts +0 -3
  502. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  503. package/templates/defense/README.md +0 -10
  504. package/templates/defense/kit.json +0 -7
  505. package/templates/defense/playtests/leak.playtest.json +0 -23
  506. package/templates/defense/playtests/placement.playtest.json +0 -40
  507. package/templates/defense/playtests/scan.playtest.json +0 -20
  508. package/templates/defense/playtests/survive.playtest.json +0 -45
  509. package/templates/defense/playtests/survives.playtest.json +0 -36
  510. package/templates/defense/src/attackers/Attacker.ts +0 -120
  511. package/templates/defense/src/board/Route.ts +0 -94
  512. package/templates/defense/src/conventions.ts +0 -18
  513. package/templates/defense/src/economy.ts +0 -36
  514. package/templates/defense/src/entities/Player.ts +0 -52
  515. package/templates/defense/src/game.ts +0 -51
  516. package/templates/defense/src/physics.ts +0 -13
  517. package/templates/defense/src/placement/Buildable.ts +0 -49
  518. package/templates/defense/src/render/camera.ts +0 -16
  519. package/templates/defense/src/render/lighting.ts +0 -37
  520. package/templates/defense/src/render/materials.ts +0 -22
  521. package/templates/defense/src/render/palette.ts +0 -28
  522. package/templates/defense/src/render/quality.ts +0 -170
  523. package/templates/defense/src/render/shapes.ts +0 -246
  524. package/templates/defense/src/render/sky.ts +0 -45
  525. package/templates/defense/src/scenes/Boot.ts +0 -12
  526. package/templates/defense/src/scenes/Defense.ts +0 -231
  527. package/templates/defense/src/state.ts +0 -56
  528. package/templates/defense/src/towers/Tower.ts +0 -95
  529. package/templates/defense/src/towers/targeting.ts +0 -53
  530. package/templates/defense/src/ui/Hud.tsx +0 -62
  531. package/templates/defense/src/ui/Menu.tsx +0 -7
  532. package/templates/defense/src/waves.ts +0 -40
  533. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  534. package/templates/minimal/src/render/hud.ts +0 -69
  535. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  536. package/templates/platformer/playtests/chase.playtest.json +0 -21
  537. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  538. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  539. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  540. package/templates/platformer/playtests/physics.playtest.json +0 -14
  541. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  542. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  543. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  544. package/templates/platformer/src/conventions.ts +0 -18
  545. package/templates/platformer/src/entities/Character.ts +0 -286
  546. package/templates/platformer/src/entities/Chaser.ts +0 -118
  547. package/templates/platformer/src/entities/Patrol.ts +0 -93
  548. package/templates/platformer/src/level/Platform.ts +0 -46
  549. package/templates/platformer/src/render/rig.ts +0 -60
  550. package/templates/platformer/src/render/terrain.ts +0 -31
  551. package/templates/platformer/src/scenes/Level.ts +0 -241
  552. package/templates/puzzle/README.md +0 -43
  553. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  554. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  555. package/templates/puzzle/src/conventions.ts +0 -25
  556. package/templates/puzzle/src/entities/Ball.ts +0 -70
  557. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  558. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  559. package/templates/puzzle/src/physics.ts +0 -19
  560. package/templates/puzzle/src/room.ts +0 -83
  561. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  562. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  563. package/templates/shooter/playtests/combat.playtest.json +0 -48
  564. package/templates/shooter/playtests/fail.playtest.json +0 -31
  565. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  566. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  567. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  568. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  569. package/templates/shooter/src/combat/damage.ts +0 -40
  570. package/templates/shooter/src/conventions.ts +0 -51
  571. package/templates/shooter/src/entities/Pickup.ts +0 -70
  572. package/templates/shooter/src/entities/Player.ts +0 -310
  573. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  574. package/templates/shooter/src/playtest-events.ts +0 -15
  575. package/templates/shooter/src/render/touch-controls.ts +0 -305
  576. package/templates/shooter/src/render/types.ts +0 -3
  577. package/templates/shooter/src/render/ui.css +0 -330
  578. package/templates/shooter/src/render/ui.ts +0 -75
  579. package/templates/shooter/src/render/vfx.ts +0 -215
  580. package/templates/shooter/src/ui/Menu.tsx +0 -41
  581. package/templates/shooter/src/waves.ts +0 -50
  582. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  583. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  584. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  585. package/templates/starter/playtests/assets.playtest.json +0 -65
  586. package/templates/starter/playtests/buffer.playtest.json +0 -79
  587. package/templates/starter/playtests/cloth.playtest.json +0 -113
  588. package/templates/starter/playtests/coyote.playtest.json +0 -87
  589. package/templates/starter/playtests/gameover.playtest.json +0 -66
  590. package/templates/starter/playtests/goal.playtest.json +0 -67
  591. package/templates/starter/playtests/look.playtest.json +0 -175
  592. package/templates/starter/playtests/models-baseline.png +0 -0
  593. package/templates/starter/playtests/models.playtest.json +0 -74
  594. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  595. package/templates/starter/playtests/odometer.playtest.json +0 -54
  596. package/templates/starter/playtests/seed.playtest.json +0 -54
  597. package/templates/starter/playtests/textures-baseline.png +0 -0
  598. package/templates/starter/playtests/textures.playtest.json +0 -74
  599. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  600. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  601. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  602. package/templates/starter/src/render/coast.ts +0 -199
  603. package/templates/starter/src/render/hero.ts +0 -88
  604. package/templates/starter/src/render/implicitSurface.ts +0 -199
  605. package/templates/starter/src/render/kuwahara.ts +0 -174
  606. package/templates/starter/src/render/outline.ts +0 -141
  607. package/templates/starter/src/render/painterly.ts +0 -86
  608. package/templates/starter/src/render/rockRidge.ts +0 -198
  609. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  610. package/templates/starter/src/render/scenery.ts +0 -40
  611. package/templates/starter/src/render/textureLifetime.ts +0 -53
  612. package/templates/starter/src/render/water.ts +0 -38
  613. package/templates/starter/src/render/watercolor.ts +0 -85
  614. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  615. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  616. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  617. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  618. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  619. /package/templates/{defense → rts}/.mcp.json +0 -0
  620. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  621. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  622. /package/templates/{defense → rts}/index.html +0 -0
  623. /package/templates/{defense → rts}/opencode.json +0 -0
  624. /package/templates/{defense → rts}/src/main.ts +0 -0
  625. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  626. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  627. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  628. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  629. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  630. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  631. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -0,0 +1,1140 @@
1
+ /** Resource-constrained commanders. Only visible enemies enter tactical memory. */
2
+
3
+ import { supply } from "./economy.js";
4
+ import type { Game } from "./game.js";
5
+ import { RESOURCE_SITES, STARTS } from "./terrain.js";
6
+ import {
7
+ type BuildingType,
8
+ type EntityType,
9
+ type ICommandTarget,
10
+ type IEntity,
11
+ type IOrderResult,
12
+ type IPoint,
13
+ type IResourceNode,
14
+ type ISupply,
15
+ TYPES,
16
+ dist,
17
+ seeded,
18
+ } from "./types.js";
19
+
20
+ export type CommanderState = "ESTABLISHING" | "DEFENDING" | "ATTACKING" | "REGROUPING" | "BUILDUP";
21
+
22
+ export interface ICommanderStats {
23
+ trained: number;
24
+ built: number;
25
+ scouted: number;
26
+ assaults: number;
27
+ retreats: number;
28
+ defenses: number;
29
+ expansions: number;
30
+ aircraft: number;
31
+ garrisons: number;
32
+ }
33
+
34
+ export interface ICommanderMemory {
35
+ id: number;
36
+ type: EntityType;
37
+ team: number;
38
+ x: number;
39
+ z: number;
40
+ time: number;
41
+ /** Set while the structure was seen this tick; the sweep drops everything else. */
42
+ seen: boolean;
43
+ }
44
+
45
+ export interface IExpansion {
46
+ x: number;
47
+ z: number;
48
+ workers: number[];
49
+ started: number;
50
+ }
51
+
52
+ const PRODUCTION_RANK: Readonly<Record<string, number>> = { starport: 0, factory: 1, barracks: 2 };
53
+
54
+ /** The production buildings, by rank, counted so the per-tick query mints no mask array. */
55
+ const PRODUCES: Readonly<Record<string, boolean>> = {
56
+ barracks: true,
57
+ factory: true,
58
+ starport: true,
59
+ };
60
+
61
+ /**
62
+ * The commander's working lists, reused every tick.
63
+ *
64
+ * `update` runs on a 1.2 s clock, so this is not a per-frame budget — but a filter, a map and a
65
+ * spread per list is forty-odd arrays a tick, and a tick lands inside an ordinary frame. These are
66
+ * module-level, never handed to anything that keeps them: `game.command` copies the ids and the
67
+ * point it is given before it returns, and every sort below orders a copy it re-reads by index.
68
+ */
69
+ const _own: IEntity[] = [];
70
+ const _cores: IEntity[] = [];
71
+ const _workers: IEntity[] = [];
72
+ const _army: IEntity[] = [];
73
+ const _second: IEntity[] = [];
74
+ const _enemies: IEntity[] = [];
75
+ const _threat: IEntity[] = [];
76
+ const _structures: IEntity[] = [];
77
+ const _production: IEntity[] = [];
78
+ const _ids: number[] = [];
79
+ const _surviving: IEntity[] = [];
80
+ const _known: ICommanderMemory[] = [];
81
+ const _nodes: IResourceNode[] = [];
82
+ const _gasSites: IResourceNode[] = [];
83
+ const _bunkers: IEntity[] = [];
84
+ const _rangers: IEntity[] = [];
85
+ const _repair: IEntity[] = [];
86
+ const _built: IEntity[] = [];
87
+ const _candidates: IEntity[] = [];
88
+ const _expanded: IEntity[] = [];
89
+ const _builders: IEntity[] = [];
90
+ const _searchSites = RESOURCE_SITES.slice(3);
91
+ /**
92
+ * A one-element id list for the orders that reach a single unit. `Game.command` reads the ids and
93
+ * copies what it needs before it returns, so one list serves every single-unit order.
94
+ */
95
+ const _one: number[] = [0];
96
+
97
+ /** The scouting legs, module-level: the routes were two fresh arrays on every scout order. */
98
+ const SCOUT_ROUTES_1: readonly IPoint[] = [
99
+ { x: 28, z: -42 },
100
+ { x: 15, z: 2 },
101
+ { x: -21, z: 31 },
102
+ { x: -43, z: 47 },
103
+ ];
104
+ const SCOUT_ROUTES_2: readonly IPoint[] = [
105
+ { x: -52, z: -30 },
106
+ { x: -56, z: 3 },
107
+ { x: -46, z: 32 },
108
+ { x: -53, z: 48 },
109
+ ];
110
+
111
+ /** Fills `out` with the live own entities of `team`, in place. */
112
+ function collectOwn(game: Game, team: number, out: IEntity[]): IEntity[] {
113
+ out.length = 0;
114
+ const entities = game.entities;
115
+ for (let i = 0; i < entities.length; i++) {
116
+ const e = entities[i];
117
+ if (e !== undefined && e.team === team && e.hp > 0) out.push(e);
118
+ }
119
+ return out;
120
+ }
121
+
122
+ /** Fills `out` with the mobile, ungarrisoned, non-worker entities of `team`, in place. */
123
+ function collectArmy(game: Game, team: number, out: IEntity[]): IEntity[] {
124
+ out.length = 0;
125
+ const entities = game.entities;
126
+ for (let i = 0; i < entities.length; i++) {
127
+ const e = entities[i];
128
+ if (
129
+ e !== undefined &&
130
+ e.team === team &&
131
+ e.hp > 0 &&
132
+ !e.building &&
133
+ e.type !== "worker" &&
134
+ !e.garrisonId &&
135
+ e.order.kind !== "garrison"
136
+ ) {
137
+ out.push(e);
138
+ }
139
+ }
140
+ return out;
141
+ }
142
+
143
+ /** Counts the own entities of `type`, in place: `filter().length` was an array per question. */
144
+ function countType(game: Game, team: number, type: EntityType): number {
145
+ let found = 0;
146
+ const entities = game.entities;
147
+ for (let i = 0; i < entities.length; i++) {
148
+ const e = entities[i];
149
+ if (e !== undefined && e.team === team && e.hp > 0 && e.type === type) found += 1;
150
+ }
151
+ return found;
152
+ }
153
+
154
+ export class CommanderAI {
155
+ readonly team: number;
156
+ private readonly rng: () => number;
157
+ private clock: number;
158
+ state: CommanderState = "ESTABLISHING";
159
+ private nextAttack: number;
160
+ private lastOrders: number;
161
+ private lastThreat: number;
162
+ private scoutId: number | null = null;
163
+ private scoutLeg = 0;
164
+ private nextScout: number;
165
+ force: number[] = [];
166
+ private initialForce = 0;
167
+ /**
168
+ * The order result this commander's own orders report into. The commander reads `ok` and `count`
169
+ * immediately and keeps neither, so it hands `command` a record it already has rather than
170
+ * letting each order mint one. `Game.command` still returns a fresh result to anyone who does not
171
+ * pass one, which is every other caller in the game.
172
+ */
173
+ private readonly result: IOrderResult = { ok: false, count: 0 };
174
+ /**
175
+ * The order target the repair orders name. `command` reads the id before it returns and the record
176
+ * is never kept, so one is enough for every structure this commander patches.
177
+ */
178
+ private readonly targetPoint: ICommandTarget = { id: 0 };
179
+ target: (IPoint & { team: number }) | null = null;
180
+ /** The commander's rally point, rewritten in place: every tick hands it out. */
181
+ private readonly rally: IPoint = { x: 0, z: 0 };
182
+ /** The commander's own supply answer, held across the calls that ask for it again. */
183
+ private readonly supply: ISupply = { used: 0, cap: 0 };
184
+ expansion: IExpansion | null = null;
185
+ private memory = new Map<number, ICommanderMemory>();
186
+ private airThreatUntil = 0;
187
+ private airTechAt: number;
188
+ private searchLeg = 0;
189
+ readonly stats: ICommanderStats = {
190
+ trained: 0,
191
+ built: 0,
192
+ scouted: 0,
193
+ assaults: 0,
194
+ retreats: 0,
195
+ defenses: 0,
196
+ expansions: 0,
197
+ aircraft: 0,
198
+ garrisons: 0,
199
+ };
200
+
201
+ constructor(team: number, seed = 1, random?: () => number) {
202
+ this.team = team;
203
+ this.rng = random ?? seeded(seed);
204
+ this.clock = team * 0.27;
205
+ this.nextAttack = team === 1 ? 90 : 115;
206
+ this.lastOrders = -100;
207
+ this.lastThreat = -100;
208
+ this.nextScout = 12 + team * 5;
209
+ this.airTechAt = team === 1 ? 100 : 78;
210
+ }
211
+
212
+ update(game: Game, dt: number): void {
213
+ this.clock -= dt;
214
+ if (this.clock > 0 || game.paused || game.result || game.players[this.team]?.eliminated) return;
215
+ this.clock = 1.2;
216
+ const team = this.team;
217
+ const own = collectOwn(game, team, _own);
218
+ const cores = _cores;
219
+ const workers = _workers;
220
+ const structures = _structures;
221
+ cores.length = 0;
222
+ workers.length = 0;
223
+ structures.length = 0;
224
+ let base: IEntity | undefined;
225
+ for (let i = 0; i < own.length; i++) {
226
+ const e = own[i];
227
+ if (e === undefined) continue;
228
+ if (e.building) structures.push(e);
229
+ else if (e.type === "worker") workers.push(e);
230
+ if (e.type === "core") {
231
+ cores.push(e);
232
+ if (e.built && !base) base = e;
233
+ }
234
+ }
235
+ if (!base) base = cores[0];
236
+ if (!base) return;
237
+ let army = collectArmy(game, team, _army);
238
+ const enemies = _enemies;
239
+ enemies.length = 0;
240
+ const entities = game.entities;
241
+ for (let i = 0; i < entities.length; i++) {
242
+ const e = entities[i];
243
+ if (
244
+ e !== undefined &&
245
+ e.team !== team &&
246
+ e.hp > 0 &&
247
+ !e.garrisonId &&
248
+ game.visibleAt(e.x, e.z, team)
249
+ ) {
250
+ enemies.push(e);
251
+ }
252
+ }
253
+ let airSeen = false;
254
+ for (let i = 0; i < enemies.length; i++) {
255
+ if (enemies[i]?.air) airSeen = true;
256
+ }
257
+ if (airSeen) this.airThreatUntil = game.time + 90;
258
+ for (let i = 0; i < enemies.length; i++) {
259
+ const enemy = enemies[i];
260
+ if (enemy === undefined || !enemy.building) continue;
261
+ // Known enemy buildings are one record each, rewritten in place: `Map.set` with a fresh
262
+ // literal allocated an object per visible structure per tick for data that had not changed.
263
+ // A record is minted when a structure is first seen, which is an event like any other.
264
+ const known = this.memory.get(enemy.id);
265
+ if (known) {
266
+ known.type = enemy.type;
267
+ known.team = enemy.team;
268
+ known.x = enemy.x;
269
+ known.z = enemy.z;
270
+ known.time = game.time;
271
+ known.seen = true;
272
+ } else {
273
+ this.memory.set(enemy.id, {
274
+ id: enemy.id,
275
+ type: enemy.type,
276
+ team: enemy.team,
277
+ x: enemy.x,
278
+ z: enemy.z,
279
+ time: game.time,
280
+ seen: true,
281
+ });
282
+ }
283
+ }
284
+ for (const [id, known] of this.memory) {
285
+ if (known.seen) {
286
+ known.seen = false;
287
+ continue;
288
+ }
289
+ if (game.visibleAt(known.x, known.z, team)) this.memory.delete(id);
290
+ }
291
+ const rally = this.rallyPoint(base);
292
+ const threat = _threat;
293
+ threat.length = 0;
294
+ for (let i = 0; i < enemies.length; i++) {
295
+ const enemy = enemies[i];
296
+ if (enemy === undefined) continue;
297
+ if (!TYPES[enemy.type].damage || enemy.type === "worker") continue;
298
+ let near = false;
299
+ for (let c = 0; c < cores.length; c++) {
300
+ const core = cores[c];
301
+ if (core !== undefined && dist(core, enemy) < 34) {
302
+ near = true;
303
+ break;
304
+ }
305
+ }
306
+ if (near) threat.push(enemy);
307
+ }
308
+ this.economy(game, own, cores, base, workers, army, rally, threat.length > 0);
309
+ // Economy can reserve infantry as defenders. Never overwrite those orders.
310
+ army = collectArmy(game, team, _army);
311
+ if (threat.length) {
312
+ this.lastThreat = game.time;
313
+ if (this.state !== "DEFENDING") {
314
+ this.stats.defenses++;
315
+ this.lastOrders = -100;
316
+ }
317
+ this.state = "DEFENDING";
318
+ if (game.time - this.lastOrders > 3.5) {
319
+ let closest: IEntity | undefined;
320
+ let best = Number.POSITIVE_INFINITY;
321
+ for (let i = 0; i < threat.length; i++) {
322
+ const e = threat[i];
323
+ if (e === undefined) continue;
324
+ const d = dist(e, base);
325
+ if (d < best) {
326
+ best = d;
327
+ closest = e;
328
+ }
329
+ }
330
+ if (closest) {
331
+ game.command(this.ids(army, _ids), "attackMove", closest, team, false, this.result);
332
+ }
333
+ this.lastOrders = game.time;
334
+ }
335
+ return;
336
+ }
337
+ if (this.state === "DEFENDING" && game.time - this.lastThreat > 9) {
338
+ this.regroup(game, army, rally);
339
+ }
340
+ if (this.state === "ATTACKING") {
341
+ this.attack(game, army, rally, enemies);
342
+ return;
343
+ }
344
+ if (this.state === "REGROUPING" && game.time < this.nextAttack) return;
345
+ this.state = "BUILDUP";
346
+ this.scout(game, army, base, rally, enemies);
347
+ if (game.time >= this.nextAttack && army.length >= 9) {
348
+ const preferred = team === 1 ? 0 : 1;
349
+ let target: (typeof STARTS)[number] | undefined;
350
+ let best = Number.POSITIVE_INFINITY;
351
+ for (const start of STARTS) {
352
+ if (start.team === team || game.players[start.team]?.eliminated) continue;
353
+ const value = dist(base, start) * (start.team === preferred ? 0.65 : 1);
354
+ if (value < best) {
355
+ best = value;
356
+ target = start;
357
+ }
358
+ }
359
+ if (!target) return;
360
+ const force = _second;
361
+ force.length = 0;
362
+ for (let i = 0; i < army.length; i++) {
363
+ const e = army[i];
364
+ if (e !== undefined && e.id !== this.scoutId) force.push(e);
365
+ }
366
+ // The scout stays home with the first of the rest: the assault never takes every unit, so
367
+ // the base keeps a defender. Starting at 1 is the `.slice(1)` this loop replaced.
368
+ this.force.length = 0;
369
+ for (let i = 1; i < force.length; i++) {
370
+ const e = force[i];
371
+ if (e !== undefined) this.force.push(e.id);
372
+ }
373
+ force.length = this.force.length;
374
+ this.initialForce = force.length;
375
+ // The assault's target is state the commander keeps, so it gets its own object once.
376
+ this.target = { x: target.x, z: target.z, team: target.team };
377
+ game.command(this.force, "attackMove", this.target, team, false, this.result);
378
+ this.state = "ATTACKING";
379
+ this.lastOrders = game.time;
380
+ this.nextAttack = game.time + 85;
381
+ this.stats.assaults++;
382
+ game.emit("assault", {
383
+ team,
384
+ name: game.players[team]?.name ?? "",
385
+ count: force.length,
386
+ targetTeam: target.team,
387
+ x: base.x,
388
+ z: base.z,
389
+ });
390
+ return;
391
+ }
392
+ const idle = _candidates;
393
+ idle.length = 0;
394
+ for (let i = 0; i < army.length; i++) {
395
+ const e = army[i];
396
+ if (e !== undefined && e.id !== this.scoutId && e.order.kind === "idle") idle.push(e);
397
+ }
398
+ if (idle.length) {
399
+ game.command(this.ids(idle, _ids), "attackMove", rally, team, false, this.result);
400
+ }
401
+ }
402
+
403
+ /** The ids of `list`, in the shared buffer: `command` copies them before it returns. */
404
+ private ids(list: IEntity[], out: number[]): number[] {
405
+ out.length = 0;
406
+ for (let i = 0; i < list.length; i++) {
407
+ const e = list[i];
408
+ if (e !== undefined) out.push(e.id);
409
+ }
410
+ return out;
411
+ }
412
+
413
+ /** Push to the next known building, or sweep to an unexplored expansion site. */
414
+ private attack(game: Game, army: IEntity[], rally: IPoint, enemies: IEntity[]): void {
415
+ const target = this.target;
416
+ if (!target) return;
417
+ const surviving = _surviving;
418
+ surviving.length = 0;
419
+ for (let i = 0; i < this.force.length; i++) {
420
+ const e = game.get(this.force[i] ?? -1);
421
+ if (e && !e.garrisonId && e.order.kind !== "garrison") surviving.push(e);
422
+ }
423
+ let health = 0;
424
+ for (let i = 0; i < surviving.length; i++) {
425
+ const e = surviving[i];
426
+ if (e !== undefined) health += e.hp / e.maxHp;
427
+ }
428
+ health /= Math.max(1, surviving.length);
429
+ if (
430
+ surviving.length < Math.max(3, this.initialForce * 0.45) ||
431
+ health < 0.36 ||
432
+ game.players[target.team]?.eliminated
433
+ ) {
434
+ this.regroup(game, army, rally);
435
+ return;
436
+ }
437
+ if (game.time - this.lastOrders <= 16) return;
438
+ const known = _known;
439
+ known.length = 0;
440
+ for (const entry of this.memory.values()) {
441
+ if (entry.team === target.team) known.push(entry);
442
+ }
443
+ // Ranked in place: cores first, then the nearest. A stable selection scan over the same list,
444
+ // because `toSorted` was a copy and the sort comparator was a closure per tick.
445
+ let best: ICommanderMemory | undefined;
446
+ let bestScore = Number.POSITIVE_INFINITY;
447
+ for (let i = 0; i < known.length; i++) {
448
+ const entry = known[i];
449
+ if (entry === undefined) continue;
450
+ // The old comparator was `Number(b.core) - Number(a.core) || dist(a) - dist(b)`, sorted
451
+ // ascending, so a core outranks anything nearer. Minimising the score has to make a core the
452
+ // *smaller* one, or the offset ranks cores last and the army walks at the nearest shed.
453
+ const score = (entry.type === "core" ? -1_000_000 : 0) + dist(entry, target);
454
+ if (score < bestScore) {
455
+ bestScore = score;
456
+ best = entry;
457
+ }
458
+ }
459
+ let goal: IPoint = best ?? target;
460
+ if (!best) {
461
+ let close = false;
462
+ for (let i = 0; i < surviving.length; i++) {
463
+ const e = surviving[i];
464
+ if (e !== undefined && dist(e, goal) < 18) {
465
+ close = true;
466
+ break;
467
+ }
468
+ }
469
+ let enemyBuilding = false;
470
+ for (let i = 0; i < enemies.length; i++) {
471
+ const e = enemies[i];
472
+ if (e !== undefined && e.team === target.team && e.building) {
473
+ enemyBuilding = true;
474
+ break;
475
+ }
476
+ }
477
+ if (close && !enemyBuilding) {
478
+ const next = _searchSites[this.searchLeg++ % _searchSites.length];
479
+ if (next) {
480
+ goal = { x: next.baseX, z: next.baseZ };
481
+ }
482
+ }
483
+ }
484
+ game.command(this.ids(surviving, _ids), "attackMove", goal, this.team, false, this.result);
485
+ this.lastOrders = game.time;
486
+ }
487
+
488
+ /** The rally point is the commander's own, rewritten in place each tick. */
489
+ private rallyPoint(base: IEntity): IPoint {
490
+ const d = Math.hypot(base.x, base.z) || 1;
491
+ const rally = this.rally;
492
+ rally.x = base.x - (base.x / d) * 18;
493
+ rally.z = base.z - (base.z / d) * 18;
494
+ return rally;
495
+ }
496
+
497
+ private regroup(game: Game, army: IEntity[], rally: IPoint): void {
498
+ const free = _candidates;
499
+ free.length = 0;
500
+ for (let i = 0; i < army.length; i++) {
501
+ const e = army[i];
502
+ if (e !== undefined && !e.garrisonId && e.order.kind !== "garrison") free.push(e);
503
+ }
504
+ game.command(this.ids(free, _ids), "move", rally, this.team, false, this.result);
505
+ this.state = "REGROUPING";
506
+ this.nextAttack = Math.max(game.time + 30, this.nextAttack);
507
+ this.stats.retreats++;
508
+ this.force.length = 0;
509
+ this.scoutId = null;
510
+ }
511
+
512
+ private tryBuild(
513
+ game: Game,
514
+ type: BuildingType,
515
+ x: number,
516
+ z: number,
517
+ builderId: number | null = null,
518
+ ): boolean {
519
+ if (!game.canAfford(type, this.team)) return false;
520
+ let freeWorker = false;
521
+ const entities = game.entities;
522
+ for (let i = 0; i < entities.length; i++) {
523
+ const e = entities[i];
524
+ if (
525
+ e !== undefined &&
526
+ e.team === this.team &&
527
+ e.type === "worker" &&
528
+ e.order.kind !== "construct"
529
+ ) {
530
+ freeWorker = true;
531
+ break;
532
+ }
533
+ }
534
+ if (!freeWorker) return false;
535
+ const p = game.findBuildSpot(type, x, z, this.team);
536
+ if (!p) return false;
537
+ const result = game.build(type, p.x, p.z, this.team, builderId);
538
+ if (result.ok) this.stats.built++;
539
+ return result.ok;
540
+ }
541
+
542
+ private trainUnit(game: Game, building: IEntity | undefined, type: EntityType): boolean {
543
+ if (!building || !game.train(building.id, type, this.team, this.result).ok) return false;
544
+ this.stats.trained++;
545
+ if (TYPES[type].air) this.stats.aircraft++;
546
+ return true;
547
+ }
548
+
549
+ private aircraftChoice(
550
+ own: IEntity[],
551
+ queued: (type: EntityType) => number,
552
+ airThreat: boolean,
553
+ ): EntityType {
554
+ let fighters = queued("fighter");
555
+ let bombers = queued("bomber");
556
+ for (let i = 0; i < own.length; i++) {
557
+ const u = own[i];
558
+ if (u === undefined) continue;
559
+ if (u.type === "fighter") fighters += 1;
560
+ else if (u.type === "bomber") bombers += 1;
561
+ }
562
+ const escorts = Math.max(
563
+ this.team === 2 ? 2 : 1,
564
+ airThreat ? 3 : 0,
565
+ Math.ceil((bombers + 1) * (this.team === 2 ? 1.5 : 1)),
566
+ );
567
+ return fighters < escorts ? "fighter" : "bomber";
568
+ }
569
+
570
+ private economy(
571
+ game: Game,
572
+ own: IEntity[],
573
+ cores: IEntity[],
574
+ base: IEntity,
575
+ workers: IEntity[],
576
+ army: IEntity[],
577
+ rally: IPoint,
578
+ underAttack: boolean,
579
+ ): void {
580
+ const team = this.team;
581
+ const bank = game.players[team]?.resources;
582
+ if (!bank) return;
583
+ // The commander's own supply record: `economy` reads `banks` after the calls below, and those
584
+ // ask for supply themselves.
585
+ const banks = this.supply;
586
+ supply(game, team, banks);
587
+ const structures = _structures;
588
+ const count = (type: EntityType): number => {
589
+ let found = 0;
590
+ for (let i = 0; i < structures.length; i++) {
591
+ if (structures[i]?.type === type) found += 1;
592
+ }
593
+ return found;
594
+ };
595
+ const queued = (type: EntityType): number => {
596
+ let waiting = 0;
597
+ for (let i = 0; i < structures.length; i++) {
598
+ const queue = structures[i]?.queue;
599
+ if (!queue) continue;
600
+ for (let q = 0; q < queue.length; q++) {
601
+ if (queue[q]?.type === type) waiting += 1;
602
+ }
603
+ }
604
+ return waiting;
605
+ };
606
+ const anyStructure = (type: EntityType, built: boolean): boolean => {
607
+ for (let i = 0; i < structures.length; i++) {
608
+ const e = structures[i];
609
+ if (e !== undefined && e.type === type && e.built === built) return true;
610
+ }
611
+ return false;
612
+ };
613
+ const airThreat = this.airThreatUntil > game.time;
614
+ if (banks.cap - banks.used < 6 && banks.cap < 120 && !anyStructure("relay", false)) {
615
+ this.tryBuild(game, "relay", base.x - 11, base.z + 6);
616
+ }
617
+ if (!count("refinery")) {
618
+ // The nearest live gas node, selected in place: `filter().sort()[0]` copied the whole node
619
+ // list and allocated a comparator every tick to take its first element.
620
+ let gas: IResourceNode | undefined;
621
+ let best = Number.POSITIVE_INFINITY;
622
+ const nodes = game.nodes;
623
+ for (let i = 0; i < nodes.length; i++) {
624
+ const n = nodes[i];
625
+ if (n === undefined || n.kind !== "gas" || n.amount <= 0) continue;
626
+ const d = dist(n, base);
627
+ if (d < best) {
628
+ best = d;
629
+ gas = n;
630
+ }
631
+ }
632
+ if (gas) this.tryBuild(game, "refinery", gas.x, gas.z);
633
+ }
634
+ if (!count("barracks")) this.tryBuild(game, "barracks", base.x + 13, base.z - 3);
635
+ if (!count("factory") && game.time > 18)
636
+ this.tryBuild(game, "factory", base.x + 3, base.z + 12);
637
+ // Respond only to air actually seen by this faction, not hidden entity data.
638
+ if (airThreat && count("antiair") < 2 && bank.ore >= TYPES.antiair.ore) {
639
+ this.tryBuild(game, "antiair", rally.x + 5, rally.z - 3);
640
+ }
641
+ const airTech =
642
+ game.time > this.airTechAt && !count("starport") && anyStructure("factory", true);
643
+ if (airTech) this.tryBuild(game, "starport", base.x - 2, base.z + 16);
644
+ if (game.time > 75 && count("barracks") < (team === 1 ? 2 : 1) && bank.ore > 400 && !airTech) {
645
+ this.tryBuild(game, "barracks", base.x + 19, base.z + 10);
646
+ }
647
+ if (game.time > 65 && !count("bunker") && bank.ore > 290 && !airTech) {
648
+ this.tryBuild(game, "bunker", rally.x - 3, rally.z - 3);
649
+ }
650
+ if (game.time > 160 && !count("antiair") && bank.ore > 320) {
651
+ this.tryBuild(game, "antiair", base.x - 10, base.z + 13);
652
+ }
653
+ if (underAttack && count("turret") < 2 && bank.ore > 300 && !airThreat) {
654
+ this.tryBuild(game, "turret", rally.x, rally.z);
655
+ }
656
+ if (workers.length + queued("worker") < Math.min(22, 15 + 3 * (cores.length - 1))) {
657
+ for (let i = 0; i < cores.length; i++) {
658
+ const c = cores[i];
659
+ if (c === undefined || !c.built || c.queue.length !== 0) continue;
660
+ if (this.trainUnit(game, c, "worker")) break;
661
+ }
662
+ }
663
+ this.assignWorkers(game, workers, structures, cores);
664
+ this.assignGarrisons(game, structures, army, underAttack);
665
+ let damaged: IEntity | undefined;
666
+ for (let i = 0; i < structures.length; i++) {
667
+ const b = structures[i];
668
+ if (b?.built && b.hp < b.maxHp * 0.7) {
669
+ damaged = b;
670
+ break;
671
+ }
672
+ }
673
+ if (damaged && bank.ore > 120) {
674
+ let onRepair = false;
675
+ for (let i = 0; i < workers.length; i++) {
676
+ if (workers[i]?.order.kind === "repair") {
677
+ onRepair = true;
678
+ break;
679
+ }
680
+ }
681
+ if (!onRepair) {
682
+ let worker: IEntity | undefined;
683
+ let best = Number.POSITIVE_INFINITY;
684
+ for (let i = 0; i < workers.length; i++) {
685
+ const w = workers[i];
686
+ if (w === undefined) continue;
687
+ if (w.order.kind !== "gather" && w.order.kind !== "idle") continue;
688
+ const d = dist(w, damaged);
689
+ if (d < best) {
690
+ best = d;
691
+ worker = w;
692
+ }
693
+ }
694
+ if (worker) {
695
+ this.targetPoint.id = damaged.id;
696
+ _one[0] = worker.id;
697
+ game.command(_one, "repair", this.targetPoint, team, false, this.result);
698
+ }
699
+ }
700
+ }
701
+ const reserve =
702
+ !underAttack && game.time > 250 && cores.length < 2 && army.length >= 12 ? 430 : 0;
703
+ this.expand(game, base, cores, workers, army, underAttack, reserve);
704
+ // Production buildings, ranked in place by the same selection scan the sort used: a copy and
705
+ // a comparator per tick to order at most three buildings.
706
+ const production = _production;
707
+ production.length = 0;
708
+ for (let i = 0; i < structures.length; i++) {
709
+ const b = structures[i];
710
+ if (b?.built && PRODUCES[b.type]) production.push(b);
711
+ }
712
+ for (let i = 0; i < production.length; i++) {
713
+ for (let j = i + 1; j < production.length; j++) {
714
+ const left = production[i];
715
+ const right = production[j];
716
+ if (left === undefined || right === undefined) continue;
717
+ if ((PRODUCTION_RANK[right.type] ?? 0) < (PRODUCTION_RANK[left.type] ?? 0)) {
718
+ production[i] = right;
719
+ production[j] = left;
720
+ }
721
+ }
722
+ }
723
+ for (const building of production) {
724
+ building.rally = rally;
725
+ if (building.queue.length >= 2 || army.length >= 40) continue;
726
+ let type: EntityType = "ranger";
727
+ if (building.type === "starport") {
728
+ type = this.aircraftChoice(own, queued, airThreat);
729
+ } else if (building.type === "factory") {
730
+ let tanks = 0;
731
+ let hovers = 0;
732
+ let flaks = 0;
733
+ for (let i = 0; i < army.length; i++) {
734
+ const e = army[i];
735
+ if (e?.type === "tank") tanks += 1;
736
+ else if (e?.type === "hover") hovers += 1;
737
+ }
738
+ for (let i = 0; i < own.length; i++) {
739
+ if (own[i]?.type === "flak") flaks += 1;
740
+ }
741
+ type =
742
+ airThreat && flaks + queued("flak") < 3
743
+ ? "flak"
744
+ : team === 2
745
+ ? hovers < tanks * 2 + 3
746
+ ? "hover"
747
+ : "tank"
748
+ : tanks < hovers + 3
749
+ ? "tank"
750
+ : "hover";
751
+ } else if (
752
+ game.time > 75 &&
753
+ army.length >= 7 &&
754
+ this.countType(army, "medic") + queued("medic") < Math.ceil(army.length / 12)
755
+ ) {
756
+ type = "medic";
757
+ }
758
+ const factoryReserve = !count("factory") && game.time > 12 ? TYPES.factory.ore : 0;
759
+ const airReserve = airTech ? TYPES.starport.ore : 0;
760
+ const idleSkyport = building.type !== "starport" && this.hasIdle(structures, "starport");
761
+ const aircraft = idleSkyport ? TYPES[this.aircraftChoice(own, queued, airThreat)] : null;
762
+ const aircraftReserve = aircraft?.ore ?? 0;
763
+ const gasReserve = Math.max(airTech ? TYPES.starport.gas : 0, aircraft?.gas ?? 0);
764
+ const preferred: EntityType = team === 2 ? "hover" : "tank";
765
+ const freeFactory = anyStructure("factory", true);
766
+ let preferredCount = 0;
767
+ let freeFactoryQueue = 0;
768
+ for (let i = 0; i < army.length; i++) {
769
+ if (army[i]?.type === preferred) preferredCount += 1;
770
+ }
771
+ for (let i = 0; i < structures.length; i++) {
772
+ const s = structures[i];
773
+ if (s !== undefined && s.type === "factory" && s.built && s.queue.length === 0) {
774
+ freeFactoryQueue += 1;
775
+ }
776
+ }
777
+ const vehicleReserve =
778
+ building.type === "barracks" &&
779
+ preferredCount < 3 &&
780
+ freeFactory &&
781
+ freeFactoryQueue > 0 &&
782
+ bank.gas >= TYPES[preferred].gas
783
+ ? TYPES[preferred].ore
784
+ : 0;
785
+ if (
786
+ bank.ore >=
787
+ TYPES[type].ore +
788
+ Math.max(reserve, factoryReserve, vehicleReserve, airReserve, aircraftReserve) &&
789
+ bank.gas >= TYPES[type].gas + gasReserve
790
+ ) {
791
+ this.trainUnit(game, building, type);
792
+ }
793
+ }
794
+ }
795
+
796
+ /** Counts `type` in `list`, in place. */
797
+ private countType(list: IEntity[], type: EntityType): number {
798
+ let found = 0;
799
+ for (let i = 0; i < list.length; i++) {
800
+ if (list[i]?.type === type) found += 1;
801
+ }
802
+ return found;
803
+ }
804
+
805
+ /** A built structure of `type` with nothing queued. */
806
+ private hasIdle(list: IEntity[], type: EntityType): boolean {
807
+ for (let i = 0; i < list.length; i++) {
808
+ const e = list[i];
809
+ if (e !== undefined && e.type === type && e.built && e.queue.length === 0) return true;
810
+ }
811
+ return false;
812
+ }
813
+
814
+ private assignWorkers(
815
+ game: Game,
816
+ workers: IEntity[],
817
+ structures: IEntity[],
818
+ cores: IEntity[],
819
+ ): void {
820
+ // Gas first, then ore, both collected into the shared node list: the filter here ran once per
821
+ // worker and the per-worker ore filter ran once per worker again.
822
+ const gasSites = _gasSites;
823
+ gasSites.length = 0;
824
+ const nodes = _nodes;
825
+ nodes.length = 0;
826
+ const pool = game.nodes;
827
+ const expansion = this.expansion;
828
+ for (let i = 0; i < pool.length; i++) {
829
+ const n = pool[i];
830
+ if (n === undefined || n.amount <= 0) continue;
831
+ if (n.kind === "gas") {
832
+ for (let s = 0; s < structures.length; s++) {
833
+ const b = structures[s];
834
+ if (b !== undefined && b.type === "refinery" && b.built && dist(b, n) < 3) {
835
+ gasSites.push(n);
836
+ break;
837
+ }
838
+ }
839
+ continue;
840
+ }
841
+ if (n.kind !== "ore") continue;
842
+ for (let c = 0; c < cores.length; c++) {
843
+ const core = cores[c];
844
+ if (core?.built && dist(core, n) < 35) {
845
+ nodes.push(n);
846
+ break;
847
+ }
848
+ }
849
+ }
850
+ for (let i = 0; i < workers.length; i++) {
851
+ const worker = workers[i];
852
+ if (worker === undefined) continue;
853
+ if (
854
+ expansion?.workers.includes(worker.id) === true ||
855
+ worker.order.kind === "construct" ||
856
+ worker.order.kind === "repair"
857
+ )
858
+ continue;
859
+ // Counted per worker, not hoisted: the command at the bottom of the loop puts this worker on
860
+ // gas, so a count taken once would send every idle worker to the refinery.
861
+ let gasWorkers = 0;
862
+ for (let g = 0; g < workers.length; g++) {
863
+ const w = workers[g];
864
+ if (w?.order.kind === "gather" && game.node(w.order.id)?.kind === "gas") gasWorkers += 1;
865
+ }
866
+ const useGas = gasSites.length > 0 && gasWorkers < 4;
867
+ if (
868
+ worker.order.kind !== "idle" &&
869
+ !(
870
+ gasWorkers < 4 &&
871
+ worker.order.kind === "gather" &&
872
+ game.node(worker.order.id)?.kind === "ore" &&
873
+ worker.id % 3 === 0
874
+ )
875
+ ) {
876
+ continue;
877
+ }
878
+ const candidates = useGas ? gasSites : nodes;
879
+ if (!candidates.length) continue;
880
+ // Nearest node, with the workers already claiming it priced in: the same ranking the sort
881
+ // produced, chosen in one pass instead of sorting a list per worker.
882
+ let nearest: IResourceNode | undefined;
883
+ let best = Number.POSITIVE_INFINITY;
884
+ for (let c = 0; c < candidates.length; c++) {
885
+ const n = candidates[c];
886
+ if (n === undefined) continue;
887
+ let claiming = 0;
888
+ for (let w = 0; w < workers.length; w++) {
889
+ const other = workers[w];
890
+ if (
891
+ other !== undefined &&
892
+ (other.order.kind === "gather" ||
893
+ other.order.kind === "repair" ||
894
+ other.order.kind === "construct") &&
895
+ other.order.id === n.id
896
+ ) {
897
+ claiming += 1;
898
+ }
899
+ }
900
+ const score = dist(n, worker) + claiming * 4;
901
+ if (score < best) {
902
+ best = score;
903
+ nearest = n;
904
+ }
905
+ }
906
+ if (nearest) {
907
+ this.targetPoint.id = nearest.id;
908
+ _one[0] = worker.id;
909
+ game.command(_one, "gather", this.targetPoint, this.team, false, this.result);
910
+ }
911
+ }
912
+ }
913
+
914
+ private assignGarrisons(
915
+ game: Game,
916
+ structures: IEntity[],
917
+ army: IEntity[],
918
+ underAttack: boolean,
919
+ ): void {
920
+ const bunkers = _bunkers;
921
+ bunkers.length = 0;
922
+ for (let i = 0; i < structures.length; i++) {
923
+ const b = structures[i];
924
+ if (b !== undefined && b.type === "bunker" && b.built) bunkers.push(b);
925
+ }
926
+ for (const bunker of bunkers) {
927
+ let incoming = 0;
928
+ const entities = game.entities;
929
+ for (let i = 0; i < entities.length; i++) {
930
+ const e = entities[i];
931
+ if (e?.team === this.team && e.order.kind === "garrison" && e.order.id === bunker.id) {
932
+ incoming += 1;
933
+ }
934
+ }
935
+ const needed = (underAttack ? 4 : 2) - bunker.garrison.length - incoming;
936
+ if (needed <= 0) continue;
937
+ const units = _rangers;
938
+ units.length = 0;
939
+ for (let i = 0; i < army.length; i++) {
940
+ const e = army[i];
941
+ if (e === undefined || e.type !== "ranger" || e.order.kind === "garrison") continue;
942
+ if (dist(e, bunker) >= 28) continue;
943
+ if (this.state === "ATTACKING" && this.force.includes(e.id)) continue;
944
+ units.push(e);
945
+ }
946
+ // The `needed` nearest rangers, picked in place instead of sorting and slicing the army.
947
+ const taken = _built;
948
+ taken.length = 0;
949
+ for (let pick = 0; pick < needed && units.length > 0; pick++) {
950
+ let bestIndex = 0;
951
+ let best = Number.POSITIVE_INFINITY;
952
+ for (let i = 0; i < units.length; i++) {
953
+ const d = dist(units[i] ?? bunker, bunker);
954
+ if (d < best) {
955
+ best = d;
956
+ bestIndex = i;
957
+ }
958
+ }
959
+ const chosen = units[bestIndex];
960
+ if (chosen !== undefined) taken.push(chosen);
961
+ units.splice(bestIndex, 1);
962
+ }
963
+ if (
964
+ taken.length &&
965
+ game.command(
966
+ this.ids(taken, _ids),
967
+ "garrison",
968
+ { id: bunker.id },
969
+ this.team,
970
+ false,
971
+ this.result,
972
+ ).ok
973
+ ) {
974
+ this.stats.garrisons += taken.length;
975
+ }
976
+ }
977
+ }
978
+
979
+ private expand(
980
+ game: Game,
981
+ base: IEntity,
982
+ cores: IEntity[],
983
+ workers: IEntity[],
984
+ army: IEntity[],
985
+ underAttack: boolean,
986
+ reserve: number,
987
+ ): void {
988
+ if (cores.length > 1) {
989
+ this.expansion = null;
990
+ return;
991
+ }
992
+ if (underAttack || !reserve || workers.length < 10) return;
993
+ if (!this.expansion && (game.players[this.team]?.resources.ore ?? 0) > 420) {
994
+ // The nearest expansion site with no known enemy core on it, selected in one pass: the
995
+ // `slice().filter().sort()` chain copied the site list, the memory list and the comparator
996
+ // every tick to take its first element.
997
+ let site: (typeof _searchSites)[number] | undefined;
998
+ let best = Number.POSITIVE_INFINITY;
999
+ for (const candidate of _searchSites) {
1000
+ let contested = false;
1001
+ for (const entry of this.memory.values()) {
1002
+ if (
1003
+ entry.type === "core" &&
1004
+ Math.hypot(entry.x - candidate.baseX, entry.z - candidate.baseZ) < 25
1005
+ ) {
1006
+ contested = true;
1007
+ break;
1008
+ }
1009
+ }
1010
+ if (contested) continue;
1011
+ const d = Math.hypot(candidate.baseX - base.x, candidate.baseZ - base.z);
1012
+ if (d < best) {
1013
+ best = d;
1014
+ site = candidate;
1015
+ }
1016
+ }
1017
+ const chosen = _expanded;
1018
+ chosen.length = 0;
1019
+ for (let i = 0; i < workers.length && chosen.length < 2; i++) {
1020
+ const w = workers[i];
1021
+ if (w === undefined) continue;
1022
+ const order = w.order;
1023
+ if (order.kind === "construct" || order.kind === "repair") continue;
1024
+ if (order.kind === "gather" && game.node(order.id)?.kind === "gas") continue;
1025
+ chosen.push(w);
1026
+ }
1027
+ if (!site || !chosen.length) return;
1028
+ // The expansion is state this commander keeps until it lands, so it gets its own records.
1029
+ const escorts = chosen.map((w) => w.id);
1030
+ this.expansion = { x: site.baseX, z: site.baseZ, workers: escorts, started: game.time };
1031
+ game.command(this.expansion.workers, "move", this.expansion, this.team, false, this.result);
1032
+ }
1033
+ const expansion = this.expansion;
1034
+ if (!expansion) return;
1035
+ const builders = _builders;
1036
+ builders.length = 0;
1037
+ for (let i = 0; i < expansion.workers.length; i++) {
1038
+ const w = game.get(expansion.workers[i] ?? -1);
1039
+ if (w && w.order.kind !== "construct") builders.push(w);
1040
+ }
1041
+ if (!builders.length || game.time - expansion.started > 100) {
1042
+ this.expansion = null;
1043
+ return;
1044
+ }
1045
+ let ready: IEntity | undefined;
1046
+ for (let i = 0; i < builders.length; i++) {
1047
+ const w = builders[i];
1048
+ if (w !== undefined && dist(w, expansion) < 11) {
1049
+ ready = w;
1050
+ break;
1051
+ }
1052
+ }
1053
+ if (
1054
+ ready &&
1055
+ game.canAfford("core", this.team) &&
1056
+ this.tryBuild(game, "core", expansion.x, expansion.z, ready.id)
1057
+ ) {
1058
+ this.stats.expansions++;
1059
+ // Do not stop the Surveyor now bound to the new core. Other escorts may mine.
1060
+ for (const worker of builders) {
1061
+ if (worker.id !== ready.id) _one[0] = worker.id;
1062
+ game.command(_one, "stop", {}, this.team, false, this.result);
1063
+ }
1064
+ this.expansion = null;
1065
+ }
1066
+ }
1067
+
1068
+ private scout(
1069
+ game: Game,
1070
+ army: IEntity[],
1071
+ base: IEntity,
1072
+ rally: IPoint,
1073
+ enemies: IEntity[],
1074
+ ): void {
1075
+ if (game.time < this.nextScout) return;
1076
+ let scout = this.scoutId === null ? undefined : game.get(this.scoutId);
1077
+ if (!scout || scout.garrisonId || scout.order.kind === "garrison") {
1078
+ // A fighter, else a hover, else the last unit that can shoot: three scans of the army
1079
+ // instead of a `find`/`find`/`filter().at()` chain and the array it copied.
1080
+ let picked: IEntity | undefined;
1081
+ for (let i = 0; i < army.length; i++) {
1082
+ const e = army[i];
1083
+ if (e?.type === "fighter") {
1084
+ picked = e;
1085
+ break;
1086
+ }
1087
+ }
1088
+ if (!picked) {
1089
+ for (let i = 0; i < army.length; i++) {
1090
+ const e = army[i];
1091
+ if (e?.type === "hover") {
1092
+ picked = e;
1093
+ break;
1094
+ }
1095
+ }
1096
+ }
1097
+ if (!picked) {
1098
+ for (let i = army.length - 1; i >= 0; i--) {
1099
+ const e = army[i];
1100
+ if (e !== undefined && TYPES[e.type].damage) {
1101
+ picked = e;
1102
+ break;
1103
+ }
1104
+ }
1105
+ }
1106
+ scout = picked;
1107
+ if (!scout || army.length < 5) return;
1108
+ this.scoutId = scout.id;
1109
+ }
1110
+ let danger = false;
1111
+ for (let i = 0; i < enemies.length; i++) {
1112
+ const e = enemies[i];
1113
+ if (
1114
+ e !== undefined &&
1115
+ game.canAttack(e, scout) &&
1116
+ dist(e, scout) < (TYPES[e.type].range ?? 0) + 5
1117
+ ) {
1118
+ danger = true;
1119
+ break;
1120
+ }
1121
+ }
1122
+ if (danger || scout.hp < scout.maxHp * 0.5) {
1123
+ _one[0] = scout.id;
1124
+ game.command(_one, "move", rally, this.team, false, this.result);
1125
+ this.scoutId = null;
1126
+ this.nextScout = game.time + 24;
1127
+ return;
1128
+ }
1129
+ if (scout.order.kind === "idle" || this.scoutLeg === 0) {
1130
+ // The scouting legs, module-level: the routes used to be a fresh pair of arrays per call.
1131
+ const routes = this.team === 1 ? SCOUT_ROUTES_1 : SCOUT_ROUTES_2;
1132
+ const point = routes[this.scoutLeg % routes.length];
1133
+ if (!point) return;
1134
+ _one[0] = scout.id;
1135
+ game.command(_one, "move", point, this.team, false, this.result);
1136
+ this.scoutLeg++;
1137
+ this.stats.scouted++;
1138
+ }
1139
+ }
1140
+ }