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,374 @@
1
+ /** Builder/site ownership and lifecycle. Every faction uses these same rules. */
2
+
3
+ import { canAfford, pay } from "./economy.js";
4
+ import type { Game } from "./game.js";
5
+ import { HALF, onBridge, waterBlocked } from "./terrain.js";
6
+ import {
7
+ type BuildingType,
8
+ type EntityType,
9
+ type ICommandTarget,
10
+ IDLE_ORDER,
11
+ type IEntity,
12
+ type IGameEvent,
13
+ type IOrderResult,
14
+ type IPoint,
15
+ type Order,
16
+ TYPES,
17
+ dist,
18
+ } from "./types.js";
19
+
20
+ /** The nearest idle Surveyor, or the one named by the order. A builder owns one site at a time. */
21
+ export function availableBuilder(
22
+ game: Game,
23
+ x: number,
24
+ z: number,
25
+ team: number,
26
+ builderId: number | null = null,
27
+ ): IEntity | null {
28
+ const eligible = (w: IEntity | undefined): w is IEntity =>
29
+ !!w &&
30
+ w.team === team &&
31
+ w.type === "worker" &&
32
+ w.hp > 0 &&
33
+ !w.garrisonId &&
34
+ w.order.kind !== "construct";
35
+ if (builderId !== null && builderId !== undefined) {
36
+ const worker = game.get(builderId);
37
+ return eligible(worker) ? worker : null;
38
+ }
39
+ return (
40
+ game
41
+ .own(team)
42
+ .filter(eligible)
43
+ .sort(
44
+ (a, b) => Math.hypot(a.x - x, a.z - z) - Math.hypot(b.x - x, b.z - z) || a.id - b.id,
45
+ )[0] ?? null
46
+ );
47
+ }
48
+
49
+ /**
50
+ * A perimeter candidate, reused so the ring below costs no objects. Nothing holds it: the loop
51
+ * tests each candidate and copies the accepted one's two numbers into the worker's own point.
52
+ */
53
+ const _workCandidate: IPoint = { x: 0, z: 0 };
54
+
55
+ /**
56
+ * The events this file emits, filled one field at a time. `Game.emit` copies a payload into the
57
+ * queue slot before it returns, so these are never retained and one of each is enough — a weld
58
+ * fires on a construction tick for every site in the game, which is ordinary play, not an event.
59
+ */
60
+ const weldEvent: Partial<IGameEvent> = {};
61
+ const lostEvent: Partial<IGameEvent> = {};
62
+ const buildEvent: Partial<IGameEvent> = {};
63
+ const doneEvent: Partial<IGameEvent> = {};
64
+
65
+ /** A one-element id list and one order target for the resumes this file issues. */
66
+ const _one: number[] = [0];
67
+ const _target: ICommandTarget = { id: 0 };
68
+ /** Nobody here reads the answer to a resume, so it is written into a record nobody keeps. */
69
+ const _result: IOrderResult = { ok: false, count: 0 };
70
+
71
+ export function constructionWorkPoint(
72
+ game: Game,
73
+ worker: IEntity,
74
+ x: number,
75
+ z: number,
76
+ radius: number,
77
+ ): IPoint | null {
78
+ const angle = Math.atan2(worker.z - z, worker.x - x);
79
+ // The same ring `approachInteraction` walks, in place: `Array.from(...).filter()` was 24 point
80
+ // objects and two arrays per builder per build start to test a ring this loop walks anyway.
81
+ for (let i = 0; i < 24; i++) {
82
+ const a = angle + (i % 2 ? 1 : -1) * Math.ceil(i / 2) * (Math.PI / 12);
83
+ _workCandidate.x = x + Math.cos(a) * (radius + worker.r + 0.9);
84
+ _workCandidate.z = z + Math.sin(a) * (radius + worker.r + 0.9);
85
+ if (game.blocked(_workCandidate.x, _workCandidate.z, worker.r)) continue;
86
+ if (game.lineClear(worker, _workCandidate, worker.r)) return _workCandidate;
87
+ const route = game.pathfind(worker, _workCandidate, worker.r);
88
+ const end = route[route.length - 1];
89
+ if (end && dist(end, _workCandidate) < 0.35) return _workCandidate;
90
+ }
91
+ return null;
92
+ }
93
+
94
+ export function beginConstruction(
95
+ game: Game,
96
+ type: BuildingType,
97
+ x: number,
98
+ z: number,
99
+ team = 0,
100
+ builderId: number | null = null,
101
+ ): IOrderResult {
102
+ if (game.result || game.paused) return { ok: false, message: "The operation is not running." };
103
+ let siteX = x;
104
+ let siteZ = z;
105
+ if (type === "refinery" && Number.isFinite(x) && Number.isFinite(z)) {
106
+ const vent = game.nodes
107
+ .filter((n) => n.kind === "gas" && n.amount > 0)
108
+ .sort((a, b) => Math.hypot(a.x - x, a.z - z) - Math.hypot(b.x - x, b.z - z))[0];
109
+ if (vent && Math.hypot(vent.x - x, vent.z - z) < 5) {
110
+ siteX = vent.x;
111
+ siteZ = vent.z;
112
+ }
113
+ }
114
+ const check = buildCheck(game, type, siteX, siteZ, team);
115
+ if (!check.ok) return check;
116
+ const worker = availableBuilder(game, siteX, siteZ, team, builderId);
117
+ if (!worker) {
118
+ return {
119
+ ok: false,
120
+ message: "An available friendly Surveyor is required. Builders cannot work on two sites.",
121
+ };
122
+ }
123
+ if (!canAfford(game, type, team)) return { ok: false, message: "Insufficient minerals or gas." };
124
+ const point = constructionWorkPoint(game, worker, siteX, siteZ, TYPES[type].r);
125
+ if (!point) {
126
+ return {
127
+ ok: false,
128
+ message: "The Surveyor cannot reach this site. Clear a route or choose another location.",
129
+ };
130
+ }
131
+ const resume: Order = worker.order.kind === "gather" ? { ...worker.order } : IDLE_ORDER;
132
+ pay(game, type, team);
133
+ const site = game.spawn(type, team, siteX, siteZ, false);
134
+ Object.assign(site, {
135
+ builderId: worker.id,
136
+ // The site's own `workPoint`, not the ring's shared candidate: a site holds this until it is
137
+ // built or abandoned, and two sites started in the same step would otherwise share one point.
138
+ workPoint: { x: point.x, z: point.z },
139
+ constructionStarted: false,
140
+ resumeOrder: resume,
141
+ createdAt: game.time,
142
+ weldClock: 0,
143
+ });
144
+ worker.order = { kind: "construct", id: site.id };
145
+ worker.orders.length = 0;
146
+ worker.path.length = 0;
147
+ worker.pathGoal = null;
148
+ worker.pathClock = 0;
149
+ worker.targetId = null;
150
+ buildEvent.id = site.id;
151
+ buildEvent.builderId = worker.id;
152
+ buildEvent.x = siteX;
153
+ buildEvent.z = siteZ;
154
+ buildEvent.team = team;
155
+ game.emit("build", buildEvent);
156
+ return { ok: true, id: site.id, builderId: worker.id };
157
+ }
158
+
159
+ export function releaseBuilder(game: Game, site: IEntity, resume = true): void {
160
+ const worker = site.builderId === null ? undefined : game.get(site.builderId);
161
+ site.builderId = null;
162
+ if (!worker || worker.order.kind !== "construct" || worker.order.id !== site.id) return;
163
+ worker.working = false;
164
+ worker.order = IDLE_ORDER;
165
+ worker.path.length = 0;
166
+ worker.pathClock = 0;
167
+ if (resume && !worker.orders.length && site.resumeOrder.kind === "gather") {
168
+ // The id and the target are the commander's own to hand over: `command` reads both before it
169
+ // returns and keeps neither, and this runs on ordinary construction steps.
170
+ _one[0] = worker.id;
171
+ _target.id = site.resumeOrder.id;
172
+ game.command(_one, "gather", _target, worker.team, false, _result);
173
+ }
174
+ }
175
+
176
+ export function abandonConstruction(
177
+ game: Game,
178
+ site: IEntity | undefined,
179
+ reason = "Surveyor left the site",
180
+ refund = 0,
181
+ resume = false,
182
+ ): boolean {
183
+ if (!site || site.built || site.hp <= 0) return false;
184
+ site.hp = 0;
185
+ game.navRevision++;
186
+ if (refund > 0) {
187
+ const bank = game.players[site.team];
188
+ if (bank) {
189
+ const d = TYPES[site.type];
190
+ for (const resource of ["ore", "gas"] as const) {
191
+ const amount = d[resource] * refund;
192
+ bank.resources[resource] += amount;
193
+ bank.spent[resource] -= amount;
194
+ }
195
+ }
196
+ }
197
+ releaseBuilder(game, site, resume);
198
+ lostEvent.id = site.id;
199
+ lostEvent.x = site.x;
200
+ lostEvent.z = site.z;
201
+ lostEvent.team = site.team;
202
+ lostEvent.name = TYPES[site.type].name;
203
+ lostEvent.reason = reason;
204
+ lostEvent.refund = refund;
205
+ game.emit("constructionLost", lostEvent);
206
+ return true;
207
+ }
208
+
209
+ export function cancelConstruction(game: Game, id: number, team = 0): IOrderResult {
210
+ const site = game.get(id);
211
+ if (game.paused || game.result || !site || site.team !== team || !site.building || site.built) {
212
+ return { ok: false, message: "Select your unfinished structure." };
213
+ }
214
+ abandonConstruction(game, site, "Construction cancelled", 0.75, true);
215
+ return { ok: true };
216
+ }
217
+
218
+ export function updateBuilder(game: Game, worker: IEntity, dt: number): void {
219
+ if (worker.order.kind !== "construct") return;
220
+ const site = game.get(worker.order.id);
221
+ if (!site || site.built || site.builderId !== worker.id || site.team !== worker.team) {
222
+ worker.order = IDLE_ORDER;
223
+ worker.working = false;
224
+ return;
225
+ }
226
+ if (site.constructionStarted && dist(worker, site) > site.r + 3.1) {
227
+ abandonConstruction(game, site, "Surveyor moved out of range");
228
+ return;
229
+ }
230
+ worker.working = dist(worker, site.workPoint) < 0.8;
231
+ if (!worker.working) {
232
+ game.travel(worker, site.workPoint.x, site.workPoint.z, dt, 0.45);
233
+ worker.working = dist(worker, site.workPoint) < 0.8;
234
+ }
235
+ if (worker.working) {
236
+ worker.angle = Math.atan2(site.x - worker.x, site.z - worker.z);
237
+ worker.moving = false;
238
+ }
239
+ }
240
+
241
+ export function updateConstruction(game: Game, site: IEntity, dt: number): void {
242
+ const worker = site.builderId === null ? undefined : game.get(site.builderId);
243
+ if (
244
+ !worker ||
245
+ worker.team !== site.team ||
246
+ worker.order.kind !== "construct" ||
247
+ worker.order.id !== site.id
248
+ ) {
249
+ abandonConstruction(game, site, "Surveyor lost or reassigned");
250
+ return;
251
+ }
252
+ if (site.constructionStarted && dist(worker, site) > site.r + 3.1) {
253
+ abandonConstruction(game, site, "Surveyor moved out of range");
254
+ return;
255
+ }
256
+ if (!worker.working || dist(worker, site) > site.r + 3.1) {
257
+ if (!site.constructionStarted && game.time - site.createdAt > 60) {
258
+ abandonConstruction(game, site, "Surveyor could not reach the site");
259
+ }
260
+ return;
261
+ }
262
+ site.constructionStarted = true;
263
+ const d = TYPES[site.type];
264
+ const delta = Math.min(1 - site.progress, dt / d.time);
265
+ site.progress = Math.min(1, site.progress + delta);
266
+ site.hp = Math.min(site.maxHp, site.hp + site.maxHp * 0.8 * delta);
267
+ site.weldClock -= dt;
268
+ if (site.weldClock <= 0) {
269
+ site.weldClock = 0.16;
270
+ weldEvent.id = site.id;
271
+ weldEvent.workerId = worker.id;
272
+ weldEvent.x = worker.x;
273
+ weldEvent.z = worker.z;
274
+ weldEvent.tx = site.x + (worker.x - site.x) * 0.74;
275
+ weldEvent.tz = site.z + (worker.z - site.z) * 0.74;
276
+ weldEvent.height = 0.4 + site.progress * 2;
277
+ weldEvent.team = site.team;
278
+ weldEvent.repair = false;
279
+ game.emit("weld", weldEvent);
280
+ }
281
+ if (site.progress >= 1 - 1e-9) {
282
+ site.progress = 1;
283
+ site.built = true;
284
+ releaseBuilder(game, site, true);
285
+ doneEvent.id = site.id;
286
+ doneEvent.name = d.name;
287
+ doneEvent.team = site.team;
288
+ game.emit("complete", doneEvent);
289
+ }
290
+ }
291
+
292
+ /** Every placement rule a structure must pass, in the order the player is told about them. */
293
+ export function buildCheck(
294
+ game: Game,
295
+ type: EntityType,
296
+ x: number,
297
+ z: number,
298
+ team = 0,
299
+ ): IOrderResult {
300
+ const d = TYPES[type];
301
+ if (!game.players[team]) return { ok: false, message: "Unknown faction." };
302
+ if (!d?.building) return { ok: false, message: "Invalid structure." };
303
+ if (
304
+ !Number.isFinite(x) ||
305
+ !Number.isFinite(z) ||
306
+ Math.abs(x) > HALF - d.r - 2 ||
307
+ Math.abs(z) > HALF - d.r - 2
308
+ ) {
309
+ return { ok: false, message: "Outside the deployment zone." };
310
+ }
311
+ if (d.requires && !game.own(team).some((e) => e.type === d.requires && e.built)) {
312
+ return { ok: false, message: `Requires a completed ${TYPES[d.requires].name}.` };
313
+ }
314
+ const own = game.own(team);
315
+ const within =
316
+ own.some((e) => e.building && e.built && Math.hypot(e.x - x, e.z - z) < 30) ||
317
+ (type === "core" && own.some((e) => e.type === "worker" && Math.hypot(e.x - x, e.z - z) < 13));
318
+ if (!within) {
319
+ return {
320
+ ok: false,
321
+ message:
322
+ type === "core"
323
+ ? "Send a Surveyor to establish this expansion."
324
+ : "Build within 30 meters of your base.",
325
+ };
326
+ }
327
+ if (!game.visibleAt(x, z, team)) return { ok: false, message: "Scout this location first." };
328
+ if (onBridge(x, z, -d.r) || waterBlocked(x, z, game.pools, d.r + 1)) {
329
+ return { ok: false, message: "Cannot deploy in water or on a bridge." };
330
+ }
331
+ for (const e of game.entities) {
332
+ if (e.building && e.hp > 0 && Math.hypot(e.x - x, e.z - z) < e.r + d.r + 1) {
333
+ return { ok: false, message: "Structure footprint is obstructed." };
334
+ }
335
+ }
336
+ for (const o of game.obstacles) {
337
+ if (Math.hypot(o.x - x, o.z - z) < o.r + d.r + 0.8) {
338
+ return { ok: false, message: "Terrain obstructs this location." };
339
+ }
340
+ }
341
+ for (const n of game.nodes) {
342
+ if (
343
+ !(type === "refinery" && n.kind === "gas") &&
344
+ Math.hypot(n.x - x, n.z - z) < n.r + d.r + 0.5
345
+ ) {
346
+ return { ok: false, message: "Keep resource fields clear." };
347
+ }
348
+ }
349
+ if (
350
+ type === "refinery" &&
351
+ !game.nodes.some((n) => n.kind === "gas" && n.amount > 0 && Math.hypot(n.x - x, n.z - z) < 2.5)
352
+ ) {
353
+ return { ok: false, message: "Place an Extractor on a gas vent." };
354
+ }
355
+ return { ok: true };
356
+ }
357
+
358
+ /** The first legal site in widening rings around the requested point. */
359
+ export function findBuildSpot(
360
+ game: Game,
361
+ type: BuildingType,
362
+ x: number,
363
+ z: number,
364
+ team = 0,
365
+ ): IPoint | null {
366
+ for (let r = 0; r < 27; r += 2.5) {
367
+ for (let i = 0; i < 20; i++) {
368
+ const a = i * (Math.PI / 10);
369
+ const p = { x: x + Math.cos(a) * r, z: z + Math.sin(a) * r };
370
+ if (buildCheck(game, type, p.x, p.z, team).ok) return p;
371
+ }
372
+ }
373
+ return null;
374
+ }
@@ -0,0 +1,167 @@
1
+ /** Ore and gas: what a bank can pay for, what supply costs, and the harvest cycle. */
2
+
3
+ import type { Game } from "./game.js";
4
+ import { approachInteraction } from "./movement.js";
5
+ import {
6
+ type EntityType,
7
+ IDLE_ORDER,
8
+ type IEntity,
9
+ type IResourceNode,
10
+ type ISupply,
11
+ TYPES,
12
+ dist,
13
+ } from "./types.js";
14
+
15
+ export function canAfford(game: Game, type: EntityType, team = 0): boolean {
16
+ const d = TYPES[type];
17
+ const bank = game.players[team]?.resources;
18
+ return !!bank && bank.ore >= d.ore && bank.gas >= d.gas;
19
+ }
20
+
21
+ export function pay(game: Game, type: EntityType, team = 0): void {
22
+ const d = TYPES[type];
23
+ const player = game.players[team];
24
+ if (!player) throw new Error(`Unknown faction ${team}`);
25
+ player.resources.ore -= d.ore;
26
+ player.resources.gas -= d.gas;
27
+ player.spent.ore += d.ore;
28
+ player.spent.gas += d.gas;
29
+ }
30
+
31
+ /** Supply already spent, including everything queued, against the cap the built structures grant.
32
+ *
33
+ * `out` is the caller's record rather than a fresh one: every producing structure asks this while it
34
+ * trains and the HUD asks it every frame, and two numbers did not need an object each time. Each
35
+ * caller owns its own — a commander holds its answer across the calls that would overwrite a shared
36
+ * one.
37
+ */
38
+ export function supply(game: Game, team: number, out: ISupply): ISupply {
39
+ let used = 0;
40
+ let cap = 0;
41
+ // Over the live list, not `own()`: this is asked every step by every producing structure, and
42
+ // `own()` hands back a fresh array to answer it.
43
+ const entities = game.entities;
44
+ for (let i = 0; i < entities.length; i++) {
45
+ const e = entities[i];
46
+ if (e === undefined || e.team !== team || e.hp <= 0) continue;
47
+ const d = TYPES[e.type];
48
+ used += d.supply || 0;
49
+ if (e.built) cap += d.cap || 0;
50
+ for (const q of e.queue) used += TYPES[q.type].supply || 0;
51
+ }
52
+ out.used = used;
53
+ out.cap = Math.min(120, cap);
54
+ return out;
55
+ }
56
+
57
+ /** The nearest live node of a kind, found in place: `filter().sort()[0]` was two arrays a call. */
58
+ function nearestNode(
59
+ game: Game,
60
+ entity: IEntity,
61
+ kind: "ore" | "gas",
62
+ requireAmount: boolean,
63
+ ): IResourceNode | null {
64
+ let best: IResourceNode | null = null;
65
+ let bestDistance = Number.POSITIVE_INFINITY;
66
+ for (const n of game.nodes) {
67
+ if (n.kind !== kind || (requireAmount && n.amount <= 0)) continue;
68
+ const away = dist(n, entity);
69
+ if (away < bestDistance) {
70
+ bestDistance = away;
71
+ best = n;
72
+ }
73
+ }
74
+ return best;
75
+ }
76
+
77
+ /** The nearest standing drop-off, found in place, for the same reason. */
78
+ function nearestCore(game: Game, entity: IEntity): IEntity | null {
79
+ const entities = game.entities;
80
+ let best: IEntity | null = null;
81
+ let bestDistance = Number.POSITIVE_INFINITY;
82
+ for (let i = 0; i < entities.length; i++) {
83
+ const e = entities[i];
84
+ if (e === undefined || e.type !== "core" || e.team !== entity.team || e.hp <= 0 || !e.built)
85
+ continue;
86
+ const away = dist(e, entity);
87
+ if (away < bestDistance) {
88
+ bestDistance = away;
89
+ best = e;
90
+ }
91
+ }
92
+ return best;
93
+ }
94
+
95
+ /** Is this team's refinery standing close enough to run the node? */
96
+ function refineryNear(game: Game, entity: IEntity, node: IResourceNode): boolean {
97
+ const entities = game.entities;
98
+ for (let i = 0; i < entities.length; i++) {
99
+ const e = entities[i];
100
+ if (
101
+ e !== undefined &&
102
+ e.type === "refinery" &&
103
+ e.team === entity.team &&
104
+ e.built &&
105
+ e.hp > 0 &&
106
+ dist(e, node) < 3
107
+ )
108
+ return true;
109
+ }
110
+ return false;
111
+ }
112
+
113
+ /** Walks the node, fills up over 1.8 s, then carries the load back to a drop-off. */
114
+ export function harvest(game: Game, entity: IEntity, dt: number): void {
115
+ if (entity.order.kind !== "gather") return;
116
+ const order = entity.order;
117
+ const node = game.node(order.id);
118
+ if (!node || (node.amount <= 0 && order.phase !== "return")) {
119
+ const next = nearestNode(game, entity, "ore", true);
120
+ if (next) {
121
+ order.id = next.id;
122
+ order.phase = "out";
123
+ } else {
124
+ entity.order = IDLE_ORDER;
125
+ }
126
+ return;
127
+ }
128
+ if (node.kind === "gas" && order.phase !== "return" && !refineryNear(game, entity, node)) {
129
+ entity.order = IDLE_ORDER;
130
+ return;
131
+ }
132
+ if (order.phase === "return") {
133
+ const base = nearestCore(game, entity);
134
+ if (!base) {
135
+ entity.order = IDLE_ORDER;
136
+ return;
137
+ }
138
+ if (approachInteraction(game, entity, base, base.r + 1.7, dt)) {
139
+ const player = game.players[entity.team];
140
+ if (!player) {
141
+ entity.order = IDLE_ORDER;
142
+ return;
143
+ }
144
+ const kind = entity.carryKind ?? "ore";
145
+ player.resources[kind] += entity.carry;
146
+ player.gathered[kind] += entity.carry;
147
+ if (entity.team === 0) game.gathered += entity.carry;
148
+ entity.carry = 0;
149
+ order.phase = "out";
150
+ entity.path.length = 0;
151
+ }
152
+ return;
153
+ }
154
+ if (approachInteraction(game, entity, node, node.kind === "gas" ? 4.15 : 2.8, dt)) {
155
+ entity.angle = Math.atan2(node.x - entity.x, node.z - entity.z);
156
+ entity.harvestTimer += dt;
157
+ if (entity.harvestTimer >= 1.8) {
158
+ const amount = Math.min(node.amount, node.kind === "gas" ? 8 : 10);
159
+ node.amount -= amount;
160
+ entity.carry = amount;
161
+ entity.carryKind = node.kind;
162
+ entity.harvestTimer = 0;
163
+ order.phase = "return";
164
+ entity.path.length = 0;
165
+ }
166
+ }
167
+ }