create-threenative 0.2.6 → 0.2.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (756) hide show
  1. package/README.md +5 -3
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +607 -26
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +801 -24
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +300 -56
  19. package/dist/threenative.js +717 -156
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rain/AGENTS.md +96 -0
  218. package/templates/rain/CLAUDE.md +98 -0
  219. package/templates/rain/assets/rain-loop.wav +0 -0
  220. package/templates/rain/assets/thunder.wav +0 -0
  221. package/templates/rain/assets/wind-loop.wav +0 -0
  222. package/templates/rain/index.html +18 -0
  223. package/templates/rain/kit.json +7 -0
  224. package/templates/rain/native-playtests/boot.playtest.json +13 -0
  225. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  226. package/templates/rain/package.json +56 -0
  227. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  228. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  229. package/templates/rain/playtests/automation.playtest.json +133 -0
  230. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  231. package/templates/rain/playtests/flash.playtest.json +27 -0
  232. package/templates/rain/playtests/fly.playtest.json +54 -0
  233. package/templates/rain/playtests/lightning.playtest.json +220 -0
  234. package/templates/rain/playtests/loading.playtest.json +57 -0
  235. package/templates/rain/playtests/paused.playtest.json +59 -0
  236. package/templates/rain/playtests/performance.playtest.json +22 -0
  237. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  238. package/templates/rain/playtests/simulation.playtest.json +20 -0
  239. package/templates/rain/playtests/storm.playtest.json +150 -0
  240. package/templates/rain/playtests/survives.playtest.json +58 -0
  241. package/templates/rain/playtests/tiers.playtest.json +179 -0
  242. package/templates/rain/playtests/weather.playtest.json +77 -0
  243. package/templates/rain/public/favicon.svg +5 -0
  244. package/templates/rain/src/audio/storm.ts +314 -0
  245. package/templates/rain/src/game.ts +114 -0
  246. package/templates/rain/src/render/bloom-shader.ts +65 -0
  247. package/templates/rain/src/render/camera.ts +160 -0
  248. package/templates/rain/src/render/clouds-shader.ts +242 -0
  249. package/templates/rain/src/render/clouds.ts +142 -0
  250. package/templates/rain/src/render/lighting.ts +39 -0
  251. package/templates/rain/src/render/lightning.ts +360 -0
  252. package/templates/rain/src/render/loading.ts +327 -0
  253. package/templates/rain/src/render/materials.ts +19 -0
  254. package/templates/rain/src/render/noise-volume.ts +159 -0
  255. package/templates/rain/src/render/palette.ts +18 -0
  256. package/templates/rain/src/render/post-shader.ts +178 -0
  257. package/templates/rain/src/render/postprocessing.ts +226 -0
  258. package/templates/rain/src/render/quality.ts +135 -0
  259. package/templates/rain/src/render/rain.ts +299 -0
  260. package/templates/rain/src/render/sky.ts +28 -0
  261. package/templates/rain/src/render/world-shader.ts +680 -0
  262. package/templates/rain/src/render/world.ts +146 -0
  263. package/templates/{defense → rain}/src/render/worldEnvironment.ts +52 -1
  264. package/templates/rain/src/scenes/Boot.ts +334 -0
  265. package/templates/rain/src/state.ts +257 -0
  266. package/templates/rain/src/style.css +1160 -0
  267. package/templates/rain/src/ui/App.tsx +29 -0
  268. package/templates/rain/src/ui/GameUi.tsx +187 -0
  269. package/templates/rain/src/ui/Hud.tsx +327 -0
  270. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  271. package/templates/rain/src/ui/Menu.tsx +370 -0
  272. package/templates/rain/src/ui/automation.ts +60 -0
  273. package/templates/rain/src/ui/main.tsx +7 -0
  274. package/templates/rain/src/ui/tempest.ts +149 -0
  275. package/templates/rain/tailwind.config.ts +2 -0
  276. package/templates/rain/threenative.config.ts +66 -0
  277. package/templates/rain/tools/generate-shaders.mjs +656 -0
  278. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  279. package/templates/rain/tools/storm-dsp.mjs +177 -0
  280. package/templates/rain/tools/tempest-bloom.frag +10 -0
  281. package/templates/rain/tools/tempest-clouds.frag +86 -0
  282. package/templates/rain/tools/tempest-post.frag +47 -0
  283. package/templates/rain/tools/tempest-world.frag +210 -0
  284. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  285. package/templates/rain/tsconfig.json +17 -0
  286. package/templates/rain/vite.config.ts +37 -0
  287. package/templates/rts/.codex/config.toml +19 -0
  288. package/templates/rts/.cursor/mcp.json +32 -0
  289. package/templates/rts/.gemini/settings.json +32 -0
  290. package/templates/rts/.mcp.json +32 -0
  291. package/templates/rts/.vscode/mcp.json +36 -0
  292. package/templates/rts/.zed/settings.json +36 -0
  293. package/templates/rts/AGENTS.md +96 -0
  294. package/templates/rts/CLAUDE.md +98 -0
  295. package/templates/rts/kit.json +7 -0
  296. package/templates/rts/opencode.json +41 -0
  297. package/templates/{defense → rts}/package.json +13 -7
  298. package/templates/rts/playtests/performance.playtest.json +41 -0
  299. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  300. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  301. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  302. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  303. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  304. package/templates/rts/playtests/survives.playtest.json +58 -0
  305. package/templates/rts/public/favicon.svg +4 -0
  306. package/templates/rts/src/game.ts +64 -0
  307. package/templates/rts/src/main.ts +15 -0
  308. package/templates/rts/src/orders.ts +22 -0
  309. package/templates/rts/src/render/army.ts +346 -0
  310. package/templates/rts/src/render/camera.ts +123 -0
  311. package/templates/rts/src/render/lighting.ts +61 -0
  312. package/templates/rts/src/render/loading.ts +33 -0
  313. package/templates/rts/src/render/materials.ts +152 -0
  314. package/templates/rts/src/render/models.ts +705 -0
  315. package/templates/rts/src/render/palette.ts +17 -0
  316. package/templates/rts/src/render/picking.ts +93 -0
  317. package/templates/rts/src/render/postprocessing.ts +46 -0
  318. package/templates/rts/src/render/quality.ts +128 -0
  319. package/templates/rts/src/render/resources.ts +141 -0
  320. package/templates/rts/src/render/sky.ts +44 -0
  321. package/templates/rts/src/render/terrain.ts +116 -0
  322. package/templates/rts/src/render/worldEnvironment.ts +809 -0
  323. package/templates/rts/src/scenes/Play.ts +650 -0
  324. package/templates/rts/src/sim/ai.ts +1140 -0
  325. package/templates/rts/src/sim/combat.ts +416 -0
  326. package/templates/rts/src/sim/construction.ts +374 -0
  327. package/templates/rts/src/sim/economy.ts +167 -0
  328. package/templates/rts/src/sim/game.ts +1082 -0
  329. package/templates/rts/src/sim/movement.ts +371 -0
  330. package/templates/rts/src/sim/nav.ts +276 -0
  331. package/templates/rts/src/sim/production.ts +180 -0
  332. package/templates/rts/src/sim/terrain.ts +170 -0
  333. package/templates/rts/src/sim/types.ts +647 -0
  334. package/templates/rts/src/sim/vision.ts +46 -0
  335. package/templates/rts/src/state.ts +100 -0
  336. package/templates/{defense → rts}/src/style.css +21 -8
  337. package/templates/rts/src/ui/App.tsx +21 -0
  338. package/templates/rts/src/ui/Commands.tsx +129 -0
  339. package/templates/rts/src/ui/GameUi.tsx +22 -0
  340. package/templates/rts/src/ui/Hud.tsx +165 -0
  341. package/templates/rts/src/ui/Minimap.tsx +84 -0
  342. package/templates/rts/tailwind.config.ts +2 -0
  343. package/templates/rts/threenative.config.ts +56 -0
  344. package/templates/rts/tsconfig.json +17 -0
  345. package/templates/{defense → rts}/vite.config.ts +4 -1
  346. package/templates/runner/AGENTS.md +6 -10
  347. package/templates/runner/CLAUDE.md +6 -10
  348. package/templates/runner/README.md +3 -3
  349. package/templates/runner/package.json +13 -7
  350. package/templates/runner/playtests/performance.playtest.json +2 -2
  351. package/templates/runner/src/conventions.ts +4 -3
  352. package/templates/runner/src/entities/Runner.ts +54 -7
  353. package/templates/runner/src/game.ts +2 -0
  354. package/templates/runner/src/render/camera.ts +4 -2
  355. package/templates/runner/src/render/dust.ts +5 -2
  356. package/templates/runner/src/render/lighting.ts +41 -45
  357. package/templates/runner/src/render/loading.ts +2 -2
  358. package/templates/runner/src/render/materials.ts +165 -25
  359. package/templates/runner/src/render/palette.ts +17 -28
  360. package/templates/runner/src/render/postprocessing.ts +12 -2
  361. package/templates/runner/src/render/quality.ts +42 -96
  362. package/templates/runner/src/render/shapes.ts +59 -37
  363. package/templates/runner/src/render/sky.ts +32 -41
  364. package/templates/runner/src/render/touch-controls.ts +1 -1
  365. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  366. package/templates/runner/src/scenes/Run.ts +26 -6
  367. package/templates/runner/src/track.ts +6 -1
  368. package/templates/runner/threenative.config.ts +14 -1
  369. package/templates/runner/vite.config.ts +4 -1
  370. package/templates/sailing/AGENTS.md +12 -12
  371. package/templates/sailing/CLAUDE.md +12 -12
  372. package/templates/sailing/assets/ship.glb +0 -0
  373. package/templates/sailing/package.json +13 -7
  374. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  375. package/templates/sailing/playtests/sails.playtest.json +33 -0
  376. package/templates/sailing/playtests/win.playtest.json +156 -8
  377. package/templates/sailing/src/conventions.ts +29 -2
  378. package/templates/sailing/src/entities/Ship.ts +381 -57
  379. package/templates/sailing/src/game.ts +14 -0
  380. package/templates/sailing/src/render/camera.ts +63 -9
  381. package/templates/sailing/src/render/lighting.ts +49 -27
  382. package/templates/sailing/src/render/materials.ts +50 -15
  383. package/templates/sailing/src/render/ocean.ts +647 -60
  384. package/templates/sailing/src/render/palette.ts +16 -12
  385. package/templates/sailing/src/render/postprocessing.ts +12 -2
  386. package/templates/sailing/src/render/props.ts +316 -442
  387. package/templates/sailing/src/render/quality.ts +14 -4
  388. package/templates/sailing/src/render/sky.ts +116 -23
  389. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  390. package/templates/sailing/src/scenes/Boot.ts +21 -0
  391. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  392. package/templates/sailing/src/state.ts +6 -0
  393. package/templates/sailing/src/ui/Hud.tsx +41 -9
  394. package/templates/sailing/threenative.config.ts +14 -1
  395. package/templates/sailing/vite.config.ts +4 -1
  396. package/templates/shooter/AGENTS.md +27 -42
  397. package/templates/shooter/CLAUDE.md +27 -42
  398. package/templates/shooter/index.html +1 -0
  399. package/templates/shooter/package.json +13 -7
  400. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  401. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  402. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  403. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  404. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  405. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  406. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  407. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  408. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  409. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  410. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  411. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  412. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  413. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  414. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  415. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  416. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  417. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  418. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  419. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  420. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  421. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  422. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  423. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  424. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  425. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  426. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  427. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  428. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  429. package/templates/shooter/playtests/performance.playtest.json +62 -26
  430. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  431. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  432. package/templates/shooter/playtests/survives.playtest.json +36 -30
  433. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  434. package/templates/shooter/src/entities/Breakables.ts +412 -0
  435. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  436. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  437. package/templates/shooter/src/entities/Rifle.ts +442 -0
  438. package/templates/shooter/src/entities/Target.ts +199 -83
  439. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  440. package/templates/shooter/src/game.ts +75 -41
  441. package/templates/shooter/src/main.ts +0 -1
  442. package/templates/shooter/src/postPhysics.ts +36 -0
  443. package/templates/shooter/src/render/camera.ts +78 -74
  444. package/templates/shooter/src/render/decals.ts +142 -82
  445. package/templates/shooter/src/render/facade.ts +1373 -0
  446. package/templates/shooter/src/render/gunfx.ts +704 -0
  447. package/templates/shooter/src/render/lighting.ts +52 -38
  448. package/templates/shooter/src/render/loading.ts +2 -2
  449. package/templates/shooter/src/render/materials.ts +100 -88
  450. package/templates/shooter/src/render/occlusion.ts +108 -0
  451. package/templates/shooter/src/render/palette.ts +10 -10
  452. package/templates/shooter/src/render/palm.ts +455 -0
  453. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  454. package/templates/shooter/src/render/postprocessing.ts +15 -3
  455. package/templates/shooter/src/render/quality.ts +40 -82
  456. package/templates/shooter/src/render/scale.ts +148 -15
  457. package/templates/shooter/src/render/shapes.ts +138 -613
  458. package/templates/shooter/src/render/sky.ts +35 -35
  459. package/templates/shooter/src/render/town-schematic.ts +120 -0
  460. package/templates/shooter/src/render/town.ts +986 -0
  461. package/templates/shooter/src/render/townMaterials.ts +160 -0
  462. package/templates/shooter/src/render/vehicles.ts +741 -0
  463. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  464. package/templates/shooter/src/scenes/Play.ts +727 -650
  465. package/templates/shooter/src/state.ts +26 -41
  466. package/templates/shooter/src/style.css +207 -11
  467. package/templates/shooter/src/surfaces.ts +131 -0
  468. package/templates/shooter/src/ui/App.tsx +9 -10
  469. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  470. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  471. package/templates/shooter/src/ui/Hud.tsx +428 -39
  472. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  473. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  474. package/templates/shooter/src/ui/main.tsx +2 -3
  475. package/templates/shooter/threenative.config.ts +14 -1
  476. package/templates/shooter/vite.config.ts +4 -1
  477. package/templates/snow/.codex/config.toml +19 -0
  478. package/templates/snow/.cursor/mcp.json +32 -0
  479. package/templates/snow/.gemini/settings.json +32 -0
  480. package/templates/snow/.mcp.json +32 -0
  481. package/templates/snow/.vscode/mcp.json +36 -0
  482. package/templates/snow/.zed/settings.json +36 -0
  483. package/templates/snow/AGENTS.md +88 -0
  484. package/templates/snow/CLAUDE.md +90 -0
  485. package/templates/snow/README.md +26 -0
  486. package/templates/snow/assets/crunch.wav +0 -0
  487. package/templates/snow/assets/wind.wav +0 -0
  488. package/templates/snow/index.html +12 -0
  489. package/templates/snow/kit.json +7 -0
  490. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  491. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  492. package/templates/snow/opencode.json +41 -0
  493. package/templates/snow/package.json +58 -0
  494. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  495. package/templates/{defense → snow}/playtests/performance.playtest.json +4 -7
  496. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  497. package/templates/{defense → snow}/playtests/survives.playtest.json +26 -6
  498. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  499. package/templates/snow/playtests/weather.playtest.json +119 -0
  500. package/templates/snow/public/favicon.svg +5 -0
  501. package/templates/snow/src/audio.ts +58 -0
  502. package/templates/snow/src/commands.ts +8 -0
  503. package/templates/snow/src/entities/Explorer.ts +279 -0
  504. package/templates/snow/src/game.ts +69 -0
  505. package/templates/snow/src/main.ts +15 -0
  506. package/templates/snow/src/render/bootPrint.ts +50 -0
  507. package/templates/snow/src/render/camera.ts +84 -0
  508. package/templates/snow/src/render/explorer.ts +321 -0
  509. package/templates/snow/src/render/lighting.ts +50 -0
  510. package/templates/snow/src/render/loading.ts +325 -0
  511. package/templates/snow/src/render/materials.ts +36 -0
  512. package/templates/snow/src/render/palette.ts +17 -0
  513. package/templates/{defense → snow}/src/render/postprocessing.ts +12 -2
  514. package/templates/snow/src/render/props.ts +42 -0
  515. package/templates/{defense → snow}/src/render/quality.ts +37 -72
  516. package/templates/snow/src/render/scenery.ts +244 -0
  517. package/templates/snow/src/render/sky.ts +57 -0
  518. package/templates/snow/src/render/snowSurface.ts +259 -0
  519. package/templates/snow/src/render/touch-controls.ts +143 -0
  520. package/templates/snow/src/render/weather.ts +279 -0
  521. package/templates/snow/src/render/worldEnvironment.ts +809 -0
  522. package/templates/{defense → snow}/src/scenes/Boot.ts +4 -4
  523. package/templates/snow/src/scenes/Snow.ts +635 -0
  524. package/templates/snow/src/state.ts +46 -0
  525. package/templates/snow/src/style.css +143 -0
  526. package/templates/snow/src/terrain.ts +64 -0
  527. package/templates/snow/src/ui/App.tsx +15 -0
  528. package/templates/snow/src/ui/Controls.tsx +322 -0
  529. package/templates/snow/src/ui/GameUi.tsx +354 -0
  530. package/templates/snow/src/ui/icons.tsx +54 -0
  531. package/templates/snow/src/ui/main.tsx +7 -0
  532. package/templates/snow/tailwind.config.ts +2 -0
  533. package/templates/snow/threenative.config.ts +51 -0
  534. package/templates/snow/tsconfig.json +17 -0
  535. package/templates/snow/vite.config.ts +37 -0
  536. package/templates/starter/AGENTS.md +17 -17
  537. package/templates/starter/CLAUDE.md +17 -17
  538. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  539. package/templates/starter/package.json +13 -7
  540. package/templates/starter/playtests/play.playtest.json +2 -1
  541. package/templates/starter/playtests/survives.playtest.json +1 -1
  542. package/templates/starter/src/conventions.ts +6 -3
  543. package/templates/starter/src/entities/Goal.ts +35 -42
  544. package/templates/starter/src/entities/Player.ts +99 -16
  545. package/templates/starter/src/render/arena.ts +131 -0
  546. package/templates/starter/src/render/lighting.ts +27 -44
  547. package/templates/starter/src/render/materials.ts +164 -35
  548. package/templates/starter/src/render/palette.ts +16 -16
  549. package/templates/starter/src/render/postprocessing.ts +6 -7
  550. package/templates/starter/src/render/quality.ts +43 -101
  551. package/templates/starter/src/render/shapes.ts +1 -1
  552. package/templates/starter/src/render/sky.ts +39 -45
  553. package/templates/starter/src/render/touch-controls.ts +3 -1
  554. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  555. package/templates/starter/src/scenes/Play.ts +82 -81
  556. package/templates/starter/threenative.config.ts +14 -1
  557. package/templates/starter/vite.config.ts +4 -1
  558. package/templates/tower-defense/.codex/config.toml +19 -0
  559. package/templates/tower-defense/.cursor/mcp.json +32 -0
  560. package/templates/tower-defense/.gemini/settings.json +32 -0
  561. package/templates/tower-defense/.mcp.json +32 -0
  562. package/templates/tower-defense/.vscode/mcp.json +36 -0
  563. package/templates/tower-defense/.zed/settings.json +36 -0
  564. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  565. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  566. package/templates/tower-defense/README.md +16 -0
  567. package/templates/tower-defense/index.html +12 -0
  568. package/templates/tower-defense/kit.json +7 -0
  569. package/templates/tower-defense/opencode.json +41 -0
  570. package/templates/tower-defense/package.json +56 -0
  571. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  572. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  573. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  574. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  575. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  576. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  577. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  578. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  579. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  580. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  581. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  582. package/templates/tower-defense/src/balance.ts +187 -0
  583. package/templates/tower-defense/src/board/Board.ts +100 -0
  584. package/templates/tower-defense/src/board/Route.ts +84 -0
  585. package/templates/tower-defense/src/camera-rig.ts +62 -0
  586. package/templates/tower-defense/src/economy.ts +64 -0
  587. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  588. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  589. package/templates/tower-defense/src/game.ts +72 -0
  590. package/templates/tower-defense/src/intents.ts +21 -0
  591. package/templates/tower-defense/src/main.ts +15 -0
  592. package/templates/tower-defense/src/physics.ts +6 -0
  593. package/templates/tower-defense/src/render/camera.ts +38 -0
  594. package/templates/tower-defense/src/render/lighting.ts +42 -0
  595. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  596. package/templates/tower-defense/src/render/materials.ts +103 -0
  597. package/templates/tower-defense/src/render/palette.ts +58 -0
  598. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  599. package/templates/tower-defense/src/render/quality.ts +128 -0
  600. package/templates/tower-defense/src/render/shapes.ts +550 -0
  601. package/templates/tower-defense/src/render/sky.ts +27 -0
  602. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  603. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  604. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  605. package/templates/tower-defense/src/state.ts +88 -0
  606. package/templates/tower-defense/src/style.css +137 -0
  607. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  608. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  609. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  610. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  611. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  612. package/templates/tower-defense/src/ui/main.tsx +14 -0
  613. package/templates/tower-defense/src/waves.ts +90 -0
  614. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  615. package/templates/tower-defense/vite.config.ts +41 -0
  616. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  617. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  618. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  619. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  620. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  621. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  622. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  623. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  624. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  625. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  626. package/agent-files/AGENT-ROLES.md +0 -26
  627. package/templates/action-rpg/src/render/shapes.ts +0 -269
  628. package/templates/action-rpg/src/render/types.ts +0 -3
  629. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  630. package/templates/defense/README.md +0 -10
  631. package/templates/defense/kit.json +0 -7
  632. package/templates/defense/playtests/leak.playtest.json +0 -23
  633. package/templates/defense/playtests/placement.playtest.json +0 -40
  634. package/templates/defense/playtests/scan.playtest.json +0 -20
  635. package/templates/defense/playtests/survive.playtest.json +0 -45
  636. package/templates/defense/src/attackers/Attacker.ts +0 -120
  637. package/templates/defense/src/board/Route.ts +0 -94
  638. package/templates/defense/src/conventions.ts +0 -18
  639. package/templates/defense/src/economy.ts +0 -36
  640. package/templates/defense/src/entities/Player.ts +0 -52
  641. package/templates/defense/src/game.ts +0 -51
  642. package/templates/defense/src/physics.ts +0 -13
  643. package/templates/defense/src/placement/Buildable.ts +0 -49
  644. package/templates/defense/src/render/camera.ts +0 -16
  645. package/templates/defense/src/render/lighting.ts +0 -37
  646. package/templates/defense/src/render/materials.ts +0 -22
  647. package/templates/defense/src/render/palette.ts +0 -28
  648. package/templates/defense/src/render/shapes.ts +0 -246
  649. package/templates/defense/src/render/sky.ts +0 -45
  650. package/templates/defense/src/scenes/Defense.ts +0 -231
  651. package/templates/defense/src/state.ts +0 -56
  652. package/templates/defense/src/towers/Tower.ts +0 -95
  653. package/templates/defense/src/towers/targeting.ts +0 -53
  654. package/templates/defense/src/ui/Hud.tsx +0 -62
  655. package/templates/defense/src/ui/Menu.tsx +0 -7
  656. package/templates/defense/src/waves.ts +0 -40
  657. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  658. package/templates/minimal/src/render/hud.ts +0 -69
  659. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  660. package/templates/platformer/playtests/chase.playtest.json +0 -21
  661. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  662. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  663. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  664. package/templates/platformer/playtests/physics.playtest.json +0 -14
  665. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  666. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  667. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  668. package/templates/platformer/src/conventions.ts +0 -18
  669. package/templates/platformer/src/entities/Character.ts +0 -286
  670. package/templates/platformer/src/entities/Chaser.ts +0 -118
  671. package/templates/platformer/src/entities/Patrol.ts +0 -93
  672. package/templates/platformer/src/level/Platform.ts +0 -46
  673. package/templates/platformer/src/render/rig.ts +0 -60
  674. package/templates/platformer/src/render/terrain.ts +0 -31
  675. package/templates/platformer/src/scenes/Level.ts +0 -241
  676. package/templates/puzzle/README.md +0 -43
  677. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  678. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  679. package/templates/puzzle/src/conventions.ts +0 -25
  680. package/templates/puzzle/src/entities/Ball.ts +0 -70
  681. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  682. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  683. package/templates/puzzle/src/physics.ts +0 -19
  684. package/templates/puzzle/src/room.ts +0 -83
  685. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  686. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  687. package/templates/shooter/playtests/combat.playtest.json +0 -48
  688. package/templates/shooter/playtests/fail.playtest.json +0 -31
  689. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  690. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  691. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  692. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  693. package/templates/shooter/src/combat/damage.ts +0 -40
  694. package/templates/shooter/src/conventions.ts +0 -51
  695. package/templates/shooter/src/entities/Pickup.ts +0 -70
  696. package/templates/shooter/src/entities/Player.ts +0 -310
  697. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  698. package/templates/shooter/src/playtest-events.ts +0 -15
  699. package/templates/shooter/src/render/touch-controls.ts +0 -305
  700. package/templates/shooter/src/render/types.ts +0 -3
  701. package/templates/shooter/src/render/ui.css +0 -330
  702. package/templates/shooter/src/render/ui.ts +0 -75
  703. package/templates/shooter/src/render/vfx.ts +0 -215
  704. package/templates/shooter/src/ui/Menu.tsx +0 -41
  705. package/templates/shooter/src/waves.ts +0 -50
  706. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  707. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  708. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  709. package/templates/starter/playtests/assets.playtest.json +0 -65
  710. package/templates/starter/playtests/buffer.playtest.json +0 -79
  711. package/templates/starter/playtests/cloth.playtest.json +0 -113
  712. package/templates/starter/playtests/coyote.playtest.json +0 -87
  713. package/templates/starter/playtests/gameover.playtest.json +0 -66
  714. package/templates/starter/playtests/goal.playtest.json +0 -67
  715. package/templates/starter/playtests/look.playtest.json +0 -175
  716. package/templates/starter/playtests/models-baseline.png +0 -0
  717. package/templates/starter/playtests/models.playtest.json +0 -74
  718. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  719. package/templates/starter/playtests/odometer.playtest.json +0 -54
  720. package/templates/starter/playtests/restart.playtest.json +0 -91
  721. package/templates/starter/playtests/seed.playtest.json +0 -54
  722. package/templates/starter/playtests/textures-baseline.png +0 -0
  723. package/templates/starter/playtests/textures.playtest.json +0 -74
  724. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  725. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  726. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  727. package/templates/starter/src/render/coast.ts +0 -199
  728. package/templates/starter/src/render/hero.ts +0 -88
  729. package/templates/starter/src/render/implicitSurface.ts +0 -199
  730. package/templates/starter/src/render/kuwahara.ts +0 -174
  731. package/templates/starter/src/render/outline.ts +0 -141
  732. package/templates/starter/src/render/painterly.ts +0 -86
  733. package/templates/starter/src/render/rockRidge.ts +0 -198
  734. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  735. package/templates/starter/src/render/scenery.ts +0 -40
  736. package/templates/starter/src/render/textureLifetime.ts +0 -53
  737. package/templates/starter/src/render/water.ts +0 -38
  738. package/templates/starter/src/render/watercolor.ts +0 -85
  739. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  740. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  741. /package/templates/{defense → rain}/.codex/config.toml +0 -0
  742. /package/templates/{defense → rain}/.cursor/mcp.json +0 -0
  743. /package/templates/{defense → rain}/.gemini/settings.json +0 -0
  744. /package/templates/{defense → rain}/.mcp.json +0 -0
  745. /package/templates/{defense → rain}/.vscode/mcp.json +0 -0
  746. /package/templates/{defense → rain}/.zed/settings.json +0 -0
  747. /package/templates/{defense → rain}/opencode.json +0 -0
  748. /package/templates/{defense → rain}/src/main.ts +0 -0
  749. /package/templates/{defense → rts}/index.html +0 -0
  750. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  751. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  752. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  753. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  754. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  755. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  756. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -0,0 +1,1082 @@
1
+ /** Deterministic RTS rules, shared by every faction. No browser dependencies. */
2
+
3
+ import { CommanderAI } from "./ai.js";
4
+ import {
5
+ applyDamage,
6
+ canAttackTarget,
7
+ engage,
8
+ garrisonCheck,
9
+ unloadGarrison,
10
+ updateGarrisonArrival,
11
+ updateRepair,
12
+ updateSupport,
13
+ } from "./combat.js";
14
+ import {
15
+ abandonConstruction,
16
+ beginConstruction,
17
+ buildCheck,
18
+ cancelConstruction,
19
+ findBuildSpot,
20
+ updateBuilder,
21
+ updateConstruction,
22
+ } from "./construction.js";
23
+ import { canAfford, harvest, pay, supply } from "./economy.js";
24
+ import {
25
+ clearMovement,
26
+ newPathPool,
27
+ separateEntities,
28
+ spawnExit,
29
+ travelEntity,
30
+ } from "./movement.js";
31
+ import { findRoute } from "./nav.js";
32
+ import { cancelTrain, train, updateProduction } from "./production.js";
33
+ import {
34
+ HALF,
35
+ MAP_CELL,
36
+ POOLS,
37
+ RESOURCE_SITES,
38
+ ROCK_FIELDS,
39
+ STARTS,
40
+ WORLD,
41
+ waterBlocked,
42
+ } from "./terrain.js";
43
+ import {
44
+ type BuildingType,
45
+ COMMAND_KINDS,
46
+ EVENT_FIELDS,
47
+ type EntityType,
48
+ type IBank,
49
+ type ICommandTarget,
50
+ IDLE_ORDER,
51
+ type IEntity,
52
+ type IGameEvent,
53
+ type IObstacle,
54
+ type IOrderResult,
55
+ type IPlayer,
56
+ type IPoint,
57
+ type IQueueItem,
58
+ type IResourceNode,
59
+ type IResult,
60
+ type ISupply,
61
+ type Order,
62
+ SIM_STEP,
63
+ TYPES,
64
+ clamp,
65
+ dist,
66
+ formation,
67
+ planeDistance,
68
+ seeded,
69
+ } from "./types.js";
70
+ import { updateVision, visibleAt } from "./vision.js";
71
+
72
+ /** One allocation-free answer to "is a standing core near this unit?", asked once per unit per step. */
73
+ function coreNear(game: Game, unit: IEntity): boolean {
74
+ const entities = game.entities;
75
+ for (let i = 0; i < entities.length; i++) {
76
+ const b = entities[i];
77
+ if (
78
+ b !== undefined &&
79
+ b.type === "core" &&
80
+ b.built &&
81
+ b.hp > 0 &&
82
+ b.team === unit.team &&
83
+ dist(b, unit) < 15
84
+ )
85
+ return true;
86
+ }
87
+ return false;
88
+ }
89
+
90
+ /** Does this faction still have a core standing? Asked three times a step, so no closure per call. */
91
+ function coreAlive(game: Game, team: number): boolean {
92
+ const entities = game.entities;
93
+ for (let i = 0; i < entities.length; i++) {
94
+ const e = entities[i];
95
+ if (e !== undefined && e.team === team && e.type === "core" && e.hp > 0) return true;
96
+ }
97
+ return false;
98
+ }
99
+
100
+ function anyEnemyCoreAlive(game: Game): boolean {
101
+ const entities = game.entities;
102
+ for (let i = 0; i < entities.length; i++) {
103
+ const e = entities[i];
104
+ if (e !== undefined && e.team > 0 && e.type === "core" && e.hp > 0) return true;
105
+ }
106
+ return false;
107
+ }
108
+
109
+ export interface IGameOptions {
110
+ ai?: boolean;
111
+ seed?: number;
112
+ /** Injected worldgen stream. Defaults to the seeded mulberry32 the original world used. */
113
+ random?: () => number;
114
+ }
115
+
116
+ /**
117
+ * The scratch one `command` call works in: the deduplicated selection, its mobile half, and the
118
+ * formation grid. Retained on the game and reused, because a group order runs for every unit in the
119
+ * selection and `[...new Set(ids)].map().filter()` plus a fresh `formation()` was five arrays and one
120
+ * object per unit per order.
121
+ *
122
+ * `command` re-enters itself — reassigning a builder abandons its site, which resumes the worker —
123
+ * so the scratch is taken by depth rather than shared outright: the nested call builds its own, and
124
+ * only a call with no nested call behind it hands the retained one back.
125
+ */
126
+ interface IOrderScratch {
127
+ depth: number;
128
+ units: IEntity[];
129
+ mobile: IEntity[];
130
+ points: IPoint[];
131
+ seen: Set<number>;
132
+ }
133
+
134
+ /** How many events a batch holds before the oldest is dropped, and so the size of one bank. */
135
+ const EVENT_CAPACITY = 250;
136
+
137
+ const eliminatedEvent: Partial<IGameEvent> = {};
138
+ const endEvent: Partial<IGameEvent> = {};
139
+
140
+ /** What an event field reads when the event that owns it did not set it. */
141
+ const EMPTY = undefined as unknown as never;
142
+
143
+ /**
144
+ * How many order records a unit owns. A unit's current order plus a full 20-order queue is 21 live
145
+ * records, and the record for a replacement order is written before the queue it replaces is
146
+ * dropped, so 22 is the smallest number that cannot hand the same record to two live orders.
147
+ */
148
+ const ORDER_POOL = 22;
149
+
150
+ /**
151
+ * The orders `command` writes, filled one field at a time and copied into a pool record. They are
152
+ * never retained: `writeOrder` copies before returning, so one of each kind is enough however many
153
+ * units a group order touches. `kind` is set per branch, so only the fields that kind reads matter.
154
+ */
155
+ const moveOrder = { kind: "move" as "move" | "attackMove", x: 0, z: 0 };
156
+ const gatherOrder = { kind: "gather" as const, id: 0, phase: "out" as "out" | "return" };
157
+ const targetOrder = {
158
+ kind: "attack" as "attack" | "garrison" | "repair" | "heal" | "follow",
159
+ id: 0,
160
+ };
161
+ const HOLD_ORDER: Order = { kind: "hold" };
162
+
163
+ /**
164
+ * A record of this unit's own that nothing is reading: not its current order and not any of the up
165
+ * to 20 it has queued. A cursor cannot do this, because a cancelled order frees a slot in the middle
166
+ * and a wrap then writes over the order the unit is walking. The search is over the unit's own 22
167
+ * records and allocates nothing; a unit with a full queue has none, and the caller refuses instead.
168
+ */
169
+ function takeOrder(unit: IEntity): Order | undefined {
170
+ const pool = unit.orderPool;
171
+ for (let i = 0; i < pool.length; i++) {
172
+ const record = pool[i];
173
+ if (record === undefined || record === unit.order) continue;
174
+ if (unit.orders.includes(record)) continue;
175
+ return record;
176
+ }
177
+ return undefined;
178
+ }
179
+
180
+ /**
181
+ * Copies `next` over a record of the unit's own that nothing is reading, and hands that record back.
182
+ * The unit's current order is not one of those: it is replaced by the returned record, so writing
183
+ * over it would leave the old order and the new one as the same object — which is what a cursor over
184
+ * the ring did after eleven appends wrapped it onto the order the unit was walking.
185
+ */
186
+ function writeOrder(unit: IEntity, next: Order): Order | undefined {
187
+ const record = takeOrder(unit);
188
+ if (record === undefined) return undefined;
189
+ copyOrder(record, next);
190
+ return record;
191
+ }
192
+
193
+ /**
194
+ * Field by field, so an order that had a target does not keep it after being overwritten by one that
195
+ * only moves. `id` is where a stale value shows: a move order read as an attack on whatever the
196
+ * last target was.
197
+ */
198
+ function copyOrder(record: Order, next: Order): void {
199
+ const to = record as unknown as {
200
+ kind: Order["kind"];
201
+ x: number;
202
+ z: number;
203
+ id: number;
204
+ phase: "out" | "return";
205
+ };
206
+ const from = next as unknown as typeof to;
207
+ to.kind = from.kind;
208
+ to.x = from.x;
209
+ to.z = from.z;
210
+ to.id = from.id;
211
+ to.phase = from.phase;
212
+ }
213
+
214
+ /** A building's own training-queue records: one per position, plus the one a push is written into. */
215
+ function makeQueuePool(): IQueueItem[] {
216
+ const pool: IQueueItem[] = [];
217
+ for (let i = 0; i < 7; i++) pool.push({ id: 0, type: "worker", progress: 0 });
218
+ return pool;
219
+ }
220
+
221
+ /** Fills a caller-owned result. `message` is left off: an order that reports one is rare and cold. */
222
+ function writeResult(into: IOrderResult, ok: boolean, count: number): IOrderResult {
223
+ into.ok = ok;
224
+ into.count = count;
225
+ return into;
226
+ }
227
+
228
+ /** A unit's own order records, built when the unit is born. */
229
+ function makeOrderPool(): Order[] {
230
+ const pool: Order[] = [];
231
+ for (let i = 0; i < ORDER_POOL; i++) {
232
+ pool.push({
233
+ kind: "idle",
234
+ x: 0,
235
+ z: 0,
236
+ id: 0,
237
+ phase: "out",
238
+ } as unknown as Order);
239
+ }
240
+ return pool;
241
+ }
242
+
243
+ /** One bank: 250 records that all have every declared field, so a reused slot keeps its shape. */
244
+ function makeEventBank(): IGameEvent[] {
245
+ const bank: IGameEvent[] = [];
246
+ for (let i = 0; i < EVENT_CAPACITY; i++) {
247
+ bank.push({
248
+ type: "",
249
+ time: 0,
250
+ id: 0,
251
+ unitId: 0,
252
+ workerId: 0,
253
+ builderId: 0,
254
+ targetId: 0,
255
+ team: 0,
256
+ name: "",
257
+ count: 0,
258
+ targetTeam: 0,
259
+ x: 0,
260
+ z: 0,
261
+ y: 0,
262
+ tx: 0,
263
+ tz: 0,
264
+ ty: 0,
265
+ height: 0,
266
+ altitude: 0,
267
+ building: false,
268
+ repair: false,
269
+ destruction: false,
270
+ unit: "",
271
+ typeName: "",
272
+ style: "",
273
+ result: "",
274
+ reason: "",
275
+ refund: 0,
276
+ });
277
+ }
278
+ return bank;
279
+ }
280
+
281
+ export class Game {
282
+ readonly rng: () => number;
283
+ readonly seed: number;
284
+ ai: boolean;
285
+ entities: IEntity[] = [];
286
+ nodes: IResourceNode[] = [];
287
+ obstacles: IObstacle[] = [];
288
+ pools = POOLS.map((p) => ({ ...p }));
289
+ nextId = 1;
290
+ nextQueueId = 1;
291
+ worldSize = WORLD;
292
+ cell = MAP_CELL;
293
+ gridSize = WORLD / MAP_CELL;
294
+ players: IPlayer[];
295
+ resources: IBank;
296
+ visible: Uint8Array;
297
+ explored: Uint8Array;
298
+ time = 0;
299
+ kills = 0;
300
+ losses = 0;
301
+ gathered = 0;
302
+ paused = false;
303
+ result: IResult = null;
304
+ events: IGameEvent[] = [];
305
+ /** The live bank of event records, the one being written to right now. */
306
+ #slots: IGameEvent[] = [];
307
+ /** The bank handed out by the last drain: still readable until the next one. */
308
+ #spareSlots: IGameEvent[] = [];
309
+ /** The bank neither of the other two is using, kept so a drain never allocates. */
310
+ #pool: IGameEvent[] = [];
311
+ /** The array the last drain handed out, reused as the next batch's array. */
312
+ #spareEvents: IGameEvent[] = [];
313
+ #cursor = 0;
314
+ #used = 0;
315
+
316
+ /** The scratch for one level of nesting, reused: a group order nests a few deep, repeatedly. */
317
+ #nestedScratch(depth: number): IOrderScratch {
318
+ const found = this.scratchPool[depth - 1];
319
+ if (found !== undefined) {
320
+ found.depth = 0;
321
+ found.seen.clear();
322
+ return found;
323
+ }
324
+ if (this.scratchPool.length >= 3)
325
+ return { depth: 0, units: [], mobile: [], points: [], seen: new Set() };
326
+ const made: IOrderScratch = { depth: 0, units: [], mobile: [], points: [], seen: new Set() };
327
+ this.scratchPool.push(made);
328
+ return made;
329
+ }
330
+ navRevision = 0;
331
+ visionClock = 0;
332
+ navMasks = new Map<string, Uint8Array>();
333
+ commanders: CommanderAI[] = [];
334
+
335
+ constructor({ ai = true, seed = 17, random }: IGameOptions = {}) {
336
+ this.rng = random ?? seeded(seed);
337
+ // Cold, and once: two banks of distinct records, because a drained batch stays readable until
338
+ // the next drain, and the array that carries it is reused rather than reallocated.
339
+ this.#pool = makeEventBank();
340
+ this.#slots = this.#pool;
341
+ this.#spareSlots = makeEventBank();
342
+ this.#spareEvents = [];
343
+ this.seed = seed;
344
+ this.ai = ai;
345
+ this.players = STARTS.map((s) => ({
346
+ team: s.team,
347
+ name: s.name,
348
+ resources: { ore: s.team ? 550 : 700, gas: s.team ? 100 : 150 },
349
+ gathered: { ore: 0, gas: 0 },
350
+ spent: { ore: 0, gas: 0 },
351
+ eliminated: false,
352
+ visible: new Uint8Array(this.gridSize ** 2),
353
+ explored: new Uint8Array(this.gridSize ** 2),
354
+ }));
355
+ const home = this.players[0];
356
+ if (!home) throw new Error("The seeded world has no team 0");
357
+ this.resources = home.resources;
358
+ this.visible = home.visible;
359
+ this.explored = home.explored;
360
+ this.initialize();
361
+ this.commanders = [new CommanderAI(1, seed + 31), new CommanderAI(2, seed + 79)];
362
+ }
363
+
364
+ initialize(): void {
365
+ for (const [x, z, r] of ROCK_FIELDS) {
366
+ this.obstacles.push({ x, z, r, kind: "rock" });
367
+ for (let i = 0; i < 2; i++) {
368
+ const a = this.rng() * Math.PI * 2;
369
+ this.obstacles.push({
370
+ x: x + Math.cos(a) * r * 0.7,
371
+ z: z + Math.sin(a) * r * 0.7,
372
+ r: 1.1 + this.rng() * 1.5,
373
+ kind: "rock",
374
+ });
375
+ }
376
+ }
377
+ RESOURCE_SITES.forEach((site, index) => {
378
+ for (let i = 0; i < 7; i++) {
379
+ const a = 0.15 + (i / 7) * Math.PI * 1.8;
380
+ this.nodes.push({
381
+ id: this.nextId++,
382
+ kind: "ore",
383
+ x: site.x + Math.cos(a) * 4.4,
384
+ z: site.z + Math.sin(a) * 4.4,
385
+ r: 1.6,
386
+ amount: 2100,
387
+ site: index,
388
+ });
389
+ }
390
+ this.nodes.push({
391
+ id: this.nextId++,
392
+ kind: "gas",
393
+ x: site.gx,
394
+ z: site.gz,
395
+ r: 2.6,
396
+ amount: 3000,
397
+ site: index,
398
+ });
399
+ });
400
+ for (const start of STARTS) {
401
+ const { team, x, z } = start;
402
+ const site = RESOURCE_SITES[team];
403
+ if (!site) continue;
404
+ this.spawn("core", team, x, z);
405
+ this.spawn("barracks", team, x + 14, z - 2);
406
+ this.spawn("relay", team, x - 7, z - 16);
407
+ this.spawn("refinery", team, site.gx, site.gz);
408
+ if (team) this.spawn("turret", team, x + 1, z + 15);
409
+ const ores = this.nodes.filter((n) => n.site === team && n.kind === "ore");
410
+ const gas = this.nodes.find((n) => n.site === team && n.kind === "gas");
411
+ if (!gas) continue;
412
+ const count = team ? 8 : 10;
413
+ for (let i = 0; i < count; i++) {
414
+ const u = this.spawn(
415
+ "worker",
416
+ team,
417
+ x - 9 - (i % 3) * 1.7,
418
+ z - 4 + Math.floor(i / 3) * 1.9,
419
+ );
420
+ const node = i >= count - 2 ? gas : ores[i % ores.length];
421
+ if (!node) continue;
422
+ this.command([u.id], "gather", { id: node.id }, team);
423
+ }
424
+ for (const v of formation(team ? 5 : 8, x + 15, z - 16, 2.2)) {
425
+ this.spawn("ranger", team, v.x, v.z);
426
+ }
427
+ this.spawn(team === 2 ? "hover" : "tank", team, x + 3, z - 18);
428
+ if (!team) this.spawn("hover", team, x + 10, z - 23);
429
+ }
430
+ this.updateVision();
431
+ }
432
+
433
+ own(team = 0): IEntity[] {
434
+ return this.entities.filter((e) => e.team === team && e.hp > 0);
435
+ }
436
+
437
+ army(team = 0): IEntity[] {
438
+ return this.own(team).filter((e) => !e.building && e.type !== "worker" && !e.garrisonId);
439
+ }
440
+
441
+ canAttack(a: IEntity | undefined, b: IEntity | undefined): boolean {
442
+ return canAttackTarget(this, a, b);
443
+ }
444
+
445
+ unload(id: number, team = 0): IOrderResult {
446
+ return unloadGarrison(this, id, team);
447
+ }
448
+
449
+ get(id: number): IEntity | undefined {
450
+ // A loop, not `find`: this is asked for every ordered unit, every step, and `find` builds a
451
+ // closure and an iterator to answer it.
452
+ const entities = this.entities;
453
+ for (let i = 0; i < entities.length; i++) {
454
+ const e = entities[i];
455
+ if (e !== undefined && e.id === id && e.hp > 0) return e;
456
+ }
457
+ return undefined;
458
+ }
459
+
460
+ node(id: number): IResourceNode | undefined {
461
+ const nodes = this.nodes;
462
+ for (let i = 0; i < nodes.length; i++) {
463
+ const n = nodes[i];
464
+ if (n !== undefined && n.id === id) return n;
465
+ }
466
+ return undefined;
467
+ }
468
+
469
+ spawn(type: EntityType, team: number, x: number, z: number, built = true): IEntity {
470
+ const d = TYPES[type];
471
+ if (!d) throw new Error(`Unknown entity ${type}`);
472
+ const e: IEntity = {
473
+ id: this.nextId++,
474
+ type,
475
+ team,
476
+ x,
477
+ z,
478
+ air: !!d.air,
479
+ altitude: d.altitude || 0,
480
+ garrisonId: null,
481
+ garrison: [],
482
+ builderId: null,
483
+ workPoint: { x, z },
484
+ constructionStarted: false,
485
+ createdAt: 0,
486
+ resumeOrder: IDLE_ORDER,
487
+ weldClock: 0,
488
+ working: false,
489
+ hp: built ? d.hp : d.hp * 0.2,
490
+ maxHp: d.hp,
491
+ building: !!d.building,
492
+ r: d.r,
493
+ built,
494
+ progress: built ? 1 : 0,
495
+ angle: team === 0 ? Math.PI : 0,
496
+ order: IDLE_ORDER,
497
+ orders: [],
498
+ orderPool: makeOrderPool(),
499
+ queue: [],
500
+ queuePool: makeQueuePool(),
501
+ rally: null,
502
+ cooldown: 0,
503
+ carry: 0,
504
+ carryKind: null,
505
+ harvestTimer: 0,
506
+ path: [],
507
+ pathClock: 0,
508
+ pathGoal: null,
509
+ pathEnd: null,
510
+ pathAdjusted: false,
511
+ goalPoint: { x, z },
512
+ pathGoalPoint: { x, z },
513
+ pathEndPoint: { x, z },
514
+ pathPool: newPathPool(),
515
+ interactionPoint: { x, z },
516
+ interactionGoal: { point: null, range: 0, retryAt: 0, revision: -1, targetId: -1 },
517
+ pathRevision: 0,
518
+ moving: false,
519
+ targetId: null,
520
+ healTargetId: null,
521
+ healFxClock: 0,
522
+ repairClock: 0,
523
+ flash: 0,
524
+ hitFlash: 0,
525
+ lastDamaged: -20,
526
+ exitRevision: 0,
527
+ nextExitAttempt: 0,
528
+ };
529
+ this.entities.push(e);
530
+ if (e.building) this.navRevision++;
531
+ return e;
532
+ }
533
+
534
+ /** The scene's own supply record: it reads the answer straight into the state patch it publishes. */
535
+ readonly publishedSupply: ISupply = { used: 0, cap: 0 };
536
+
537
+ supply(team = 0) {
538
+ return supply(this, team, this.publishedSupply);
539
+ }
540
+
541
+ canAfford(type: EntityType, team = 0): boolean {
542
+ return canAfford(this, type, team);
543
+ }
544
+
545
+ pay(type: EntityType, team = 0): void {
546
+ pay(this, type, team);
547
+ }
548
+
549
+ /** `into` is passed through for the commander; see `train`. Anyone else gets a fresh result. */
550
+ train(id: number, type: EntityType, team = 0, into?: IOrderResult): IOrderResult {
551
+ return train(this, id, type, team, into);
552
+ }
553
+
554
+ cancelTrain(id: number, index: number, team = 0): IOrderResult {
555
+ return cancelTrain(this, id, index, team);
556
+ }
557
+
558
+ buildCheck(type: EntityType, x: number, z: number, team = 0): IOrderResult {
559
+ return buildCheck(this, type, x, z, team);
560
+ }
561
+
562
+ findBuildSpot(type: BuildingType, x: number, z: number, team = 0): IPoint | null {
563
+ return findBuildSpot(this, type, x, z, team);
564
+ }
565
+
566
+ build(
567
+ type: BuildingType,
568
+ x: number,
569
+ z: number,
570
+ team = 0,
571
+ builderId: number | null = null,
572
+ ): IOrderResult {
573
+ return beginConstruction(this, type, x, z, team, builderId);
574
+ }
575
+
576
+ cancelBuild(id: number, team = 0): IOrderResult {
577
+ return cancelConstruction(this, id, team);
578
+ }
579
+
580
+ /** The one entry point for a player order. Anything it does not accept returns `{ok: false}`. */
581
+ readonly orderScratch: IOrderScratch = {
582
+ depth: 0,
583
+ units: [],
584
+ mobile: [],
585
+ points: [],
586
+ seen: new Set(),
587
+ };
588
+ /**
589
+ * The scratch one nesting level deeper uses, and the next, and so on. A nested command (a
590
+ * reassigned builder abandoning its site resumes the worker, which orders it) needs a selection
591
+ * and a formation grid of its own, and minting one per nesting meant a fresh array to grow the
592
+ * grid into every time a worker was reassigned mid-construction. Three levels is well past any
593
+ * chain this ruleset produces, and the fourth falls back to a fresh scratch rather than growing.
594
+ */
595
+ readonly scratchPool: IOrderScratch[] = [];
596
+
597
+ /**
598
+ * Orders a selection. `into` is for the hot internal callers: the result is read immediately and
599
+ * thrown away, so the AI passes a record it owns rather than making one per order. A caller that
600
+ * does not pass one gets a fresh result it may keep, which is the public contract and does not
601
+ * change.
602
+ */
603
+ command(
604
+ ids: number[],
605
+ kind: string,
606
+ target: ICommandTarget = {},
607
+ team = 0,
608
+ append = false,
609
+ into?: IOrderResult,
610
+ ): IOrderResult {
611
+ const scratch = this.orderScratch;
612
+ // A nested call (a reassigned builder abandoning its site resumes the worker) gets its own
613
+ // scratch, so the outer call's selection and formation grid are still intact underneath it.
614
+ const mine: IOrderScratch = scratch.depth > 0 ? this.#nestedScratch(scratch.depth) : scratch;
615
+ scratch.depth += 1;
616
+ try {
617
+ return this.#command(ids, kind, target, team, append, mine, into);
618
+ } finally {
619
+ scratch.depth -= 1;
620
+ }
621
+ }
622
+
623
+ #command(
624
+ ids: number[],
625
+ kind: string,
626
+ target: ICommandTarget,
627
+ team: number,
628
+ append: boolean,
629
+ scratch: IOrderScratch,
630
+ into: IOrderResult | undefined,
631
+ ): IOrderResult {
632
+ if (this.result || this.paused || !Array.isArray(ids) || !this.players[team])
633
+ return into === undefined ? { ok: false } : writeResult(into, false, 0);
634
+ if (!COMMAND_KINDS.includes(kind))
635
+ return into === undefined ? { ok: false } : writeResult(into, false, 0);
636
+ if (
637
+ (kind === "move" || kind === "attackMove") &&
638
+ (!Number.isFinite(target.x) || !Number.isFinite(target.z))
639
+ ) {
640
+ return into === undefined ? { ok: false } : writeResult(into, false, 0);
641
+ }
642
+ // The selection, deduplicated in first-seen order — the order `[...new Set(ids)]` gave, and the
643
+ // order every formation slot and every `units` index below depends on.
644
+ const seen = scratch.seen;
645
+ const units = scratch.units;
646
+ const mobile = scratch.mobile;
647
+ seen.clear();
648
+ units.length = 0;
649
+ mobile.length = 0;
650
+ for (let i = 0; i < ids.length; i++) {
651
+ const id = ids[i];
652
+ if (id === undefined || seen.has(id)) continue;
653
+ seen.add(id);
654
+ const e = this.get(id);
655
+ if (!e || e.team !== team || e.garrisonId) continue;
656
+ units.push(e);
657
+ if (!e.building) mobile.push(e);
658
+ }
659
+ const points = formation(
660
+ mobile.length,
661
+ clamp(target.x ?? 0, -HALF + 4, HALF - 4),
662
+ clamp(target.z ?? 0, -HALF + 4, HALF - 4),
663
+ mobile.some((e) => e.type === "tank") ? 2.7 : 2.05,
664
+ scratch.points,
665
+ );
666
+ let i = 0;
667
+ let accepted = 0;
668
+ for (const unit of units) {
669
+ if (unit.building) {
670
+ if (
671
+ (kind === "move" || kind === "attackMove") &&
672
+ unit.built &&
673
+ TYPES[unit.type].trains?.length
674
+ ) {
675
+ unit.rally = {
676
+ x: clamp(target.x ?? 0, -HALF + 4, HALF - 4),
677
+ z: clamp(target.z ?? 0, -HALF + 4, HALF - 4),
678
+ };
679
+ accepted++;
680
+ }
681
+ continue;
682
+ }
683
+ const point = points[i++];
684
+ if (!point) continue;
685
+ let order: Order;
686
+ if (kind === "gather") {
687
+ if (unit.type !== "worker") continue;
688
+ let n = target.id === undefined ? undefined : this.node(target.id);
689
+ const b = target.id === undefined ? undefined : this.get(target.id);
690
+ if (b?.type === "refinery" && b.team === team) {
691
+ n = this.nodes.find((node) => node.kind === "gas" && dist(node, b) < 3);
692
+ }
693
+ if (!n || n.amount <= 0) continue;
694
+ if (
695
+ n.kind === "gas" &&
696
+ !this.entities.some(
697
+ (x) =>
698
+ x.team === team && x.type === "refinery" && x.built && x.hp > 0 && dist(x, n) < 3,
699
+ )
700
+ )
701
+ continue;
702
+ gatherOrder.id = n.id;
703
+ gatherOrder.phase = unit.carry ? "return" : "out";
704
+ order = gatherOrder;
705
+ } else if (kind === "garrison") {
706
+ const bunker = target.id === undefined ? undefined : this.get(target.id);
707
+ if (!bunker || !garrisonCheck(this, unit, bunker)) continue;
708
+ targetOrder.kind = "garrison";
709
+ targetOrder.id = bunker.id;
710
+ order = targetOrder;
711
+ } else if (kind === "repair") {
712
+ const structure = target.id === undefined ? undefined : this.get(target.id);
713
+ if (
714
+ unit.type !== "worker" ||
715
+ !structure ||
716
+ !structure.building ||
717
+ !structure.built ||
718
+ structure.team !== team
719
+ )
720
+ continue;
721
+ targetOrder.kind = "repair";
722
+ targetOrder.id = structure.id;
723
+ order = targetOrder;
724
+ } else if (kind === "heal" || kind === "follow") {
725
+ const ally = target.id === undefined ? undefined : this.get(target.id);
726
+ if (
727
+ unit.type !== "medic" ||
728
+ !ally ||
729
+ ally.building ||
730
+ ally.garrisonId ||
731
+ ally.team !== team ||
732
+ ally.id === unit.id ||
733
+ ally.air
734
+ )
735
+ continue;
736
+ targetOrder.kind = kind as "heal" | "follow";
737
+ targetOrder.id = ally.id;
738
+ order = targetOrder;
739
+ } else if (kind === "attack") {
740
+ const enemy = target.id === undefined ? undefined : this.get(target.id);
741
+ if (!enemy || !this.canAttack(unit, enemy) || !this.visibleAt(enemy.x, enemy.z, team))
742
+ continue;
743
+ targetOrder.kind = "attack";
744
+ targetOrder.id = enemy.id;
745
+ order = targetOrder;
746
+ } else if (kind === "stop") {
747
+ order = IDLE_ORDER;
748
+ } else if (kind === "hold") {
749
+ order = HOLD_ORDER;
750
+ } else {
751
+ moveOrder.kind = kind === "attackMove" ? "attackMove" : "move";
752
+ moveOrder.x = clamp(point.x, -HALF + 3, HALF - 3);
753
+ moveOrder.z = clamp(point.z, -HALF + 3, HALF - 3);
754
+ order = moveOrder;
755
+ }
756
+ if (append && kind !== "stop" && kind !== "hold" && unit.order.kind !== "idle") {
757
+ if (unit.orders.length < 20) {
758
+ // A queued order is a record of its own: the current order and up to 20 queued ones are
759
+ // all readable at once, so they cannot come from one shared record. The record is taken
760
+ // before anything live is written, so a full queue leaves the current order as it was.
761
+ const queued = takeOrder(unit);
762
+ if (queued === undefined) continue;
763
+ copyOrder(queued, order);
764
+ unit.orders.push(queued);
765
+ accepted++;
766
+ }
767
+ } else {
768
+ // The record a new order goes into is written before `abandonConstruction` reads the old
769
+ // order, because writing it touches a free record and never the one the unit is following.
770
+ // `stop` keeps the one idle order every idle unit shares rather than a copy of it.
771
+ const record = order === IDLE_ORDER ? IDLE_ORDER : writeOrder(unit, order);
772
+ if (record === undefined) continue;
773
+ if (unit.order.kind === "construct") {
774
+ abandonConstruction(this, this.get(unit.order.id), "Surveyor reassigned");
775
+ }
776
+ unit.order = record;
777
+ unit.orders.length = 0;
778
+ clearMovement(unit);
779
+ unit.targetId = null;
780
+ unit.harvestTimer = 0;
781
+ accepted++;
782
+ }
783
+ }
784
+ if (into === undefined) return { ok: accepted > 0, count: accepted };
785
+ return writeResult(into, accepted > 0, accepted);
786
+ }
787
+
788
+ /**
789
+ * Records one game event.
790
+ *
791
+ * The record is a slot, not an object minted per event. There are two banks of 250 distinct
792
+ * records and two arrays holding them, all built once when the game is born, and `drainEvents`
793
+ * swaps which bank is live. That is what lets the array a caller is holding stay readable: the
794
+ * next events land in the other bank, so the batch just returned is not overwritten under the
795
+ * consumer that is still reading it. Two banks, not one, because the batch outlives the call
796
+ * that produced it until the next drain.
797
+ *
798
+ * `payload` is copied into the slot field by field rather than kept, so a call site may hand over
799
+ * a scratch object it reuses: the copy happens before this returns, and the queue never aliases
800
+ * the caller's object. A field the payload does not carry is cleared, so a reused slot never
801
+ * reports a value left by the event that held it before.
802
+ */
803
+ emit(type: string, payload: Partial<IGameEvent> = {}): void {
804
+ const slots = this.#slots;
805
+ // The overflow rule is the one this always had: the 251st event drops the oldest, and the bank is
806
+ // a ring, so "oldest" is the slot the cursor is about to reuse.
807
+ const slot = slots[this.#cursor];
808
+ if (slot === undefined) return;
809
+ for (let f = 0; f < EVENT_FIELDS.length; f++) {
810
+ const key = EVENT_FIELDS[f] as keyof IGameEvent;
811
+ slot[key] = (payload[key] ?? EMPTY) as never;
812
+ }
813
+ slot.type = type;
814
+ slot.time = this.time;
815
+ this.#cursor += 1;
816
+ if (this.#cursor === EVENT_CAPACITY) this.#cursor = 0;
817
+ if (this.#used < EVENT_CAPACITY) this.#used += 1;
818
+ // The array is the ordered view of the ring, oldest first, which is the order the queue had.
819
+ // Below the cap the batch is already in that order, so the new record is appended and nothing is
820
+ // rewritten. A full bank rotates instead: the record the cursor just left is the oldest one, so
821
+ // the whole array is rewritten rather than shifted, which is the 250 writes that drops one.
822
+ const events = this.events;
823
+ if (this.#used < EVENT_CAPACITY) {
824
+ events.push(slot);
825
+ } else {
826
+ events.length = EVENT_CAPACITY;
827
+ for (let i = 0; i < EVENT_CAPACITY; i++) {
828
+ const record = slots[(this.#cursor + i) % EVENT_CAPACITY];
829
+ if (record !== undefined) events[i] = record;
830
+ }
831
+ }
832
+ }
833
+
834
+ /**
835
+ * Hands the caller this frame's events and starts a fresh batch.
836
+ *
837
+ * The returned array and the records in it stay valid until the NEXT `drainEvents`: the live bank
838
+ * is swapped for the other one first, so events emitted after this call cannot land in the batch
839
+ * being read. `Play.#drain` reads its batch synchronously and keeps only the notice strings, so
840
+ * nothing in this template outlives the call.
841
+ */
842
+ drainEvents(): IGameEvent[] {
843
+ const handed = this.events;
844
+ // The array just handed out becomes the next batch's array, and the one that was waiting takes
845
+ // over as this batch's. Two arrays, swapped: a drain on an ordinary frame allocates nothing,
846
+ // which is the frame `Play` drains on.
847
+ this.events = this.#spareEvents;
848
+ this.#spareEvents = handed;
849
+ this.#slots = this.#spareSlots;
850
+ this.#spareSlots = this.#pool;
851
+ this.#pool = this.#slots;
852
+ this.#cursor = 0;
853
+ this.#used = 0;
854
+ this.events.length = 0;
855
+ return handed;
856
+ }
857
+
858
+ /** The simulation's fixed step. The engine's fixed loop calls this; a test calls it in a loop. */
859
+ step(dt: number = SIM_STEP): void {
860
+ this.update(dt);
861
+ }
862
+
863
+ update(dt: number): void {
864
+ if (this.paused || this.result || !Number.isFinite(dt) || dt <= 0) return;
865
+ const step = Math.min(dt, 0.1);
866
+ this.time += step;
867
+ this.visionClock += step;
868
+ // Indexed over the length captured up front, not a copy of the array: a unit trained mid-step
869
+ // is picked up on the next step, exactly as the copied array did, and the step no longer
870
+ // copies sixty records to iterate them.
871
+ const entities = this.entities;
872
+ const visited = entities.length;
873
+ for (let index = 0; index < visited; index++) {
874
+ const e = entities[index];
875
+ if (e === undefined || e.hp <= 0 || e.garrisonId) continue;
876
+ if (e.hp <= 0 || e.garrisonId) continue;
877
+ e.moving = false;
878
+ e.healTargetId = null;
879
+ e.cooldown = Math.max(0, e.cooldown - step);
880
+ e.flash = Math.max(0, e.flash - step);
881
+ e.hitFlash = Math.max(0, e.hitFlash - step);
882
+ e.pathClock = Math.max(0, e.pathClock - step);
883
+ const d = TYPES[e.type];
884
+ const queued = e.order.kind === "idle" ? e.orders.shift() : undefined;
885
+ if (queued) e.order = queued;
886
+ if (!e.built) {
887
+ updateConstruction(this, e, step);
888
+ continue;
889
+ }
890
+ if (e.order.kind === "construct") {
891
+ updateBuilder(this, e, step);
892
+ continue;
893
+ }
894
+ if (e.order.kind === "garrison") {
895
+ updateGarrisonArrival(this, e, step);
896
+ continue;
897
+ }
898
+ if (e.order.kind === "repair") {
899
+ updateRepair(this, e, step);
900
+ continue;
901
+ }
902
+ updateProduction(this, e, step);
903
+ if (e.building) {
904
+ if (d.damage || d.capacity) this.fight(e, step, true);
905
+ continue;
906
+ }
907
+ if (
908
+ e.hp < e.maxHp &&
909
+ this.time - e.lastDamaged > 8 &&
910
+ e.order.kind !== "attack" &&
911
+ coreNear(this, e)
912
+ ) {
913
+ e.hp = Math.min(e.maxHp, e.hp + step * 4);
914
+ }
915
+ if (e.order.kind === "gather") {
916
+ harvest(this, e, step);
917
+ continue;
918
+ }
919
+ if (e.order.kind === "move") {
920
+ if (this.travel(e, e.order.x, e.order.z, step, 0.45)) e.order = IDLE_ORDER;
921
+ continue;
922
+ }
923
+ const fought = d.heal
924
+ ? updateSupport(this, e, step, e.order.kind === "hold")
925
+ : this.fight(e, step, e.order.kind === "hold");
926
+ if (!fought && e.order.kind === "attackMove") {
927
+ if (this.travel(e, e.order.x, e.order.z, step, 0.6)) e.order = IDLE_ORDER;
928
+ }
929
+ }
930
+ this.separate(step);
931
+ this.pruneDead();
932
+ if (this.visionClock > 0.3) {
933
+ this.updateVision();
934
+ this.visionClock = 0;
935
+ }
936
+ if (this.ai) for (const commander of this.commanders) commander.update(this, step);
937
+ let anyEliminated = false;
938
+ for (const player of this.players) {
939
+ if (player.eliminated || coreAlive(this, player.team)) continue;
940
+ player.eliminated = true;
941
+ eliminatedEvent.team = player.team;
942
+ eliminatedEvent.name = player.name;
943
+ this.emit("eliminated", eliminatedEvent);
944
+ for (const e of this.own(player.team)) {
945
+ this.damage(e, e.hp, player.team === 0 ? 1 : 0);
946
+ }
947
+ }
948
+ for (const player of this.players) {
949
+ if (player.eliminated) {
950
+ anyEliminated = true;
951
+ break;
952
+ }
953
+ }
954
+ this.pruneDead();
955
+ if (anyEliminated) this.updateVision();
956
+ if (!coreAlive(this, 0)) {
957
+ this.result = "defeat";
958
+ endEvent.result = "defeat";
959
+ this.emit("end", endEvent);
960
+ } else if (!anyEnemyCoreAlive(this)) {
961
+ this.result = "victory";
962
+ endEvent.result = "victory";
963
+ this.emit("end", endEvent);
964
+ }
965
+ }
966
+
967
+ /** Drops the dead in place, order kept: the same survivors the filtered copy left, without it. */
968
+ pruneDead(): void {
969
+ const entities = this.entities;
970
+ let kept = 0;
971
+ for (let i = 0; i < entities.length; i++) {
972
+ const e = entities[i];
973
+ if (e === undefined || e.hp <= 0) continue;
974
+ entities[kept] = e;
975
+ kept += 1;
976
+ }
977
+ entities.length = kept;
978
+ }
979
+
980
+ spawnPoint(building: IEntity, type: EntityType = "worker"): IPoint | null {
981
+ return spawnExit(this, building, type);
982
+ }
983
+
984
+ harvest(entity: IEntity, dt: number): void {
985
+ harvest(this, entity, dt);
986
+ }
987
+
988
+ fight(entity: IEntity, dt: number, hold = false): boolean {
989
+ return engage(this, entity, dt, hold);
990
+ }
991
+
992
+ damage(entity: IEntity, amount: number, attacker?: number): void {
993
+ applyDamage(this, entity, amount, attacker);
994
+ }
995
+
996
+ blocked(x: number, z: number, r = 0.7): boolean {
997
+ if (Math.abs(x) > HALF - r - 1 || Math.abs(z) > HALF - r - 1) return true;
998
+ if (waterBlocked(x, z, this.pools, r)) return true;
999
+ for (const o of this.obstacles) if (planeDistance(x, z, o.x, o.z) < o.r + r) return true;
1000
+ for (const b of this.entities) {
1001
+ if (b.building && b.hp > 0 && planeDistance(x, z, b.x, b.z) < b.r + r) return true;
1002
+ }
1003
+ return false;
1004
+ }
1005
+
1006
+ lineClear(a: IPoint, b: IPoint, r = 0.7): boolean {
1007
+ const d = dist(a, b);
1008
+ const n = Math.ceil(d / 1.1);
1009
+ for (let i = 1; i <= n; i++) {
1010
+ if (this.blocked(a.x + ((b.x - a.x) * i) / n, a.z + ((b.z - a.z) * i) / n, r)) return false;
1011
+ }
1012
+ return true;
1013
+ }
1014
+
1015
+ pathfind(a: IPoint, b: IPoint, radius = 0.8): IPoint[] {
1016
+ return findRoute(this, a, b, radius);
1017
+ }
1018
+
1019
+ travel(entity: IEntity, x: number, z: number, dt: number, stop = 0.5): boolean {
1020
+ return travelEntity(this, entity, x, z, dt, stop);
1021
+ }
1022
+
1023
+ separate(dt: number): void {
1024
+ separateEntities(this, dt);
1025
+ }
1026
+
1027
+ updateVision(): void {
1028
+ updateVision(this);
1029
+ }
1030
+
1031
+ visibleAt(x: number, z: number, team = 0): boolean {
1032
+ return visibleAt(this, x, z, team);
1033
+ }
1034
+
1035
+ /** Everything a replay has to match: banks, fog, every node and every entity. */
1036
+ serialize(): string {
1037
+ return JSON.stringify({
1038
+ time: this.time,
1039
+ kills: this.kills,
1040
+ losses: this.losses,
1041
+ gathered: this.gathered,
1042
+ result: this.result,
1043
+ navRevision: this.navRevision,
1044
+ nextId: this.nextId,
1045
+ nextQueueId: this.nextQueueId,
1046
+ players: this.players.map((p) => ({
1047
+ team: p.team,
1048
+ name: p.name,
1049
+ resources: p.resources,
1050
+ gathered: p.gathered,
1051
+ spent: p.spent,
1052
+ eliminated: p.eliminated,
1053
+ visible: Array.from(p.visible),
1054
+ explored: Array.from(p.explored),
1055
+ })),
1056
+ nodes: this.nodes.map((n) => ({ id: n.id, kind: n.kind, amount: n.amount })),
1057
+ entities: this.entities.map((e) => ({
1058
+ id: e.id,
1059
+ type: e.type,
1060
+ team: e.team,
1061
+ x: e.x,
1062
+ z: e.z,
1063
+ hp: e.hp,
1064
+ built: e.built,
1065
+ progress: e.progress,
1066
+ angle: e.angle,
1067
+ order: e.order,
1068
+ orders: e.orders,
1069
+ queue: e.queue,
1070
+ carry: e.carry,
1071
+ carryKind: e.carryKind,
1072
+ garrison: e.garrison,
1073
+ garrisonId: e.garrisonId,
1074
+ builderId: e.builderId,
1075
+ cooldown: e.cooldown,
1076
+ targetId: e.targetId,
1077
+ working: e.working,
1078
+ path: e.path,
1079
+ })),
1080
+ });
1081
+ }
1082
+ }