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,650 @@
1
+ import { type ICtx, Scene, type SceneFrame, isMobile } from "@threenative/core";
2
+ import { Object3D, type OrthographicCamera, type Texture, type Vector2 } from "three";
3
+ import { onSceneIntent } from "../orders.js";
4
+ import { createArmy } from "../render/army.js";
5
+ import {
6
+ EDGE,
7
+ type IRtsView,
8
+ applyRtsCamera,
9
+ createRtsView,
10
+ focusRts,
11
+ groundAt,
12
+ panRts,
13
+ panSpeed,
14
+ zoomRts,
15
+ } from "../render/camera.js";
16
+ import { type ISun, setupLighting } from "../render/lighting.js";
17
+ import { createLoadingScreen } from "../render/loading.js";
18
+ import { createUnitModels } from "../render/models.js";
19
+ import { type PickTarget, pickEntity, unitsInBox } from "../render/picking.js";
20
+ import { setupPost } from "../render/postprocessing.js";
21
+ import { createResources } from "../render/resources.js";
22
+ import { setupSky } from "../render/sky.js";
23
+ import { createTerrain } from "../render/terrain.js";
24
+ import { Game } from "../sim/game.js";
25
+ import { HALF, WORLD, terrainHeight } from "../sim/terrain.js";
26
+ import {
27
+ type BuildingType,
28
+ type EntityType,
29
+ type ICommandTarget,
30
+ type IEntity,
31
+ type IPoint,
32
+ type IResourceNode,
33
+ SIM_STEP,
34
+ TYPES,
35
+ dist,
36
+ } from "../sim/types.js";
37
+ import { type GameState, INITIAL_STATE } from "../state.js";
38
+
39
+ export type GameCtx = ICtx<GameState, undefined>;
40
+
41
+ /** The engine ticks at 60 Hz; the rules advance on their own 0.05 s clock, collected here. */
42
+ const STEP = SIM_STEP;
43
+ /** Never run more than a quarter second of catch-up: a tab that was backgrounded must not spend a
44
+ * second of catch-up stalling the frame it came back on. */
45
+ const MAX_CATCH_UP = 0.25;
46
+ /** A drag shorter than this is a click, not a box. */
47
+ const DRAG_SLOP = 4;
48
+ /** The coarse fog raster the HUD draws: 28 cells over 224 m is one every 8 m. */
49
+ const MINIMAP = 28;
50
+ /** Every order the panel can name, in the order the readout lists them. */
51
+ const ORDER_KINDS = [
52
+ "attack",
53
+ "attackMove",
54
+ "construct",
55
+ "gather",
56
+ "garrison",
57
+ "heal",
58
+ "hold",
59
+ "idle",
60
+ "move",
61
+ "repair",
62
+ ] as const;
63
+
64
+ const REFUSALS: Readonly<Record<string, string>> = {
65
+ attack: "Those units cannot attack that target. Check the air and ground tables.",
66
+ attackMove: "Those units cannot advance under fire.",
67
+ garrison: "Select Vanguards and a friendly bunker with free slots.",
68
+ repair: "Select a Surveyor and a completed friendly structure.",
69
+ };
70
+
71
+ /** One drag, one canvas pointer. Reused, because a drag is a press, a move and a release. */
72
+ interface IDrag {
73
+ from: Vector2;
74
+ id: number;
75
+ to: Vector2;
76
+ }
77
+
78
+ /**
79
+ * The selection's own anchor, registered with the playtest bridge.
80
+ *
81
+ * The entities themselves are instanced: one `Object3D` holds sixty tanks and its position is none
82
+ * of theirs. So the scene publishes a handle on the selection — its size, the orders it holds and
83
+ * the centroid it stands at — and a scenario reads a real world position and a real order off it.
84
+ * It is not a test-only object: the panel's position readout is the same number.
85
+ */
86
+ class SelectionAnchor {
87
+ readonly object = new Object3D();
88
+ count = 0;
89
+ order = "";
90
+
91
+ debug(): Record<string, number | string> {
92
+ return {
93
+ count: this.count,
94
+ order: this.order,
95
+ x: Math.round(this.object.position.x * 100) / 100,
96
+ z: Math.round(this.object.position.z * 100) / 100,
97
+ };
98
+ }
99
+ }
100
+
101
+ export class Play extends Scene<GameState, undefined> {
102
+ static override readonly initialState: GameState = INITIAL_STATE;
103
+
104
+ #sky: Texture | undefined;
105
+ #sim: Game | undefined;
106
+ #view: IRtsView | undefined;
107
+ #sun: ISun | undefined;
108
+ #terrain: ReturnType<typeof createTerrain> | undefined;
109
+ #army: ReturnType<typeof createArmy> | undefined;
110
+ #resources: ReturnType<typeof createResources> | undefined;
111
+ #models: ReturnType<typeof createUnitModels> | undefined;
112
+ #selection: number[] = [];
113
+ #selected = new Set<number>();
114
+ #anchor = new SelectionAnchor();
115
+ #drag: IDrag | undefined;
116
+ #box: number[] = [0, 0, 0, 0];
117
+ #found: number[] = [];
118
+ #kinds = new Uint8Array(ORDER_KINDS.length);
119
+ #mode = "";
120
+ #pointerSeen = false;
121
+ #accumulator = 0;
122
+ #minimapDirty = true;
123
+ #publishedStep = -1;
124
+ #notice = "";
125
+ #fogText = "";
126
+ #dots: number[] = [];
127
+ #patch: Partial<GameState> = {};
128
+
129
+ override async load(ctx: GameCtx): Promise<void> {
130
+ this.#sky = await ctx.assets.texture("sky.jpg");
131
+ }
132
+
133
+ override enter(ctx: GameCtx): SceneFrame<GameState, undefined> {
134
+ if (this.#sky === undefined) throw new Error("Play.enter ran before load() loaded sky.jpg.");
135
+ const camera = ctx.camera as OrthographicCamera;
136
+ // The world is seeded from the engine's own stream rather than from a constant, so two
137
+ // projects built from this template open on different maps — and one project's map is still
138
+ // reproducible from the `seed` in src/game.ts.
139
+ const sim = new Game({ seed: Math.floor(ctx.random.range(1, 1_000_000)) });
140
+ this.#sim = sim;
141
+ const view = createRtsView(-70, 58);
142
+ this.#view = view;
143
+
144
+ setupSky(ctx.scene, this.#sky);
145
+ const sun = setupLighting(
146
+ ctx.scene,
147
+ ctx.renderer.raw as Parameters<typeof setupLighting>[1],
148
+ isMobile(),
149
+ );
150
+ this.#sun = sun;
151
+ // isMobile() arrives as an argument because src/render/ imports no framework package: the
152
+ // platform decision is made here, in portable game code, exactly like createRandom.
153
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, {
154
+ godraysLight: sun.key,
155
+ mobile: isMobile(),
156
+ software: ctx.renderer.softwareAdapter !== undefined,
157
+ });
158
+ const loading = createLoadingScreen(ctx);
159
+ this.#terrain = createTerrain();
160
+ this.#models = createUnitModels();
161
+ this.#army = createArmy(this.#models);
162
+ this.#resources = createResources();
163
+ const world = new Object3D();
164
+ world.add(this.#terrain.root, this.#resources.root, this.#army.root, this.#anchor.object);
165
+ ctx.add(world);
166
+ ctx.entities.add("selection", this.#anchor);
167
+ applyRtsCamera(camera, view, ctx.viewport.size, STEP);
168
+ // The commander opens on their own base with their army already selected: a strategy game that
169
+ // starts with an empty selection teaches the click by making the player guess.
170
+ this.#selectIds(sim.army().map((entity) => entity.id));
171
+ onSceneIntent((intent, payload) => this.#intent(intent, payload));
172
+
173
+ return (frameCtx, dt) => {
174
+ loading.update();
175
+ this.#readInput(frameCtx, dt);
176
+ this.#accumulator = Math.min(this.#accumulator + dt, MAX_CATCH_UP);
177
+ while (this.#accumulator >= STEP) {
178
+ sim.update(STEP);
179
+ this.#accumulator -= STEP;
180
+ }
181
+ this.#drain(sim);
182
+ this.#prune(sim);
183
+ applyRtsCamera(camera, view, frameCtx.viewport.size, dt);
184
+ sun.follow(view.target.x, view.target.z);
185
+ this.#army?.sync(sim, this.#selected, sim.time, dt, camera);
186
+ if (this.#minimapDirty) {
187
+ this.#minimapDirty = false;
188
+ this.#terrain?.updateFog(sim);
189
+ this.#resources?.sync(sim);
190
+ this.#minimap(sim);
191
+ }
192
+ this.#publish(frameCtx, sim, view);
193
+ };
194
+ }
195
+
196
+ override exit(ctx: GameCtx): void {
197
+ onSceneIntent(() => undefined);
198
+ ctx.entities.remove("selection");
199
+ this.#army?.dispose();
200
+ this.#models?.dispose();
201
+ this.#resources?.dispose();
202
+ this.#army = undefined;
203
+ this.#models = undefined;
204
+ this.#resources = undefined;
205
+ this.#terrain = undefined;
206
+ this.#sun = undefined;
207
+ this.#sim = undefined;
208
+ this.#view = undefined;
209
+ this.#selection = [];
210
+ this.#selected.clear();
211
+ this.#drag = undefined;
212
+ this.#mode = "";
213
+ super.exit(ctx);
214
+ }
215
+
216
+ // ---------------------------------------------------------------- input
217
+
218
+ /**
219
+ * Everything the pointer and the keys do, read through `ctx.input` bindings and nothing else.
220
+ *
221
+ * One pass, at the top of the frame: a gesture becomes an intent against the state the last
222
+ * frame drew, and a held key or the wheel applies on the step that follows. No `src/render/`
223
+ * file and no listener outside `src/main.ts` and `src/ui/` is involved.
224
+ */
225
+ #readInput(ctx: GameCtx, dt: number): void {
226
+ const sim = this.#sim;
227
+ const view = this.#view;
228
+ if (sim === undefined || view === undefined) return;
229
+ const camera = ctx.camera as OrthographicCamera;
230
+ const size = ctx.viewport.size;
231
+ const raw = ctx.input.raw;
232
+ const keys = raw.keys;
233
+
234
+ const pan = ctx.input.vector("move");
235
+ const speed = panSpeed(view) * dt;
236
+ if (pan.x !== 0 || pan.y !== 0) panRts(view, pan.x * speed, -pan.y * speed);
237
+ // The pointer reads (0, 0) until the surface has seen one, and (0, 0) is the top-left corner.
238
+ // Scrolling on that is how a strategy game opens with the camera already at the map edge
239
+ // because nobody has touched the mouse yet.
240
+ const at = raw.pointer.position;
241
+ if (at.x !== 0 || at.y !== 0) this.#pointerSeen = true;
242
+ // Edge scroll: the cursor within `EDGE` pixels of the frame pans, but never while it is
243
+ // pressing something — a drag that reached the edge was a drag, not a scroll.
244
+ if (this.#pointerSeen && raw.pointer.buttons === 0 && this.#drag === undefined) {
245
+ if (at.x < EDGE) panRts(view, -speed, 0);
246
+ else if (at.x > size.width - EDGE) panRts(view, speed, 0);
247
+ else if (at.y < EDGE) panRts(view, 0, -speed);
248
+ else if (at.y > size.height - EDGE) panRts(view, 0, speed);
249
+ }
250
+ const zoom = ctx.input.axis("zoom");
251
+ if (zoom !== 0) zoomRts(view, zoom);
252
+
253
+ if (this.#drag !== undefined) {
254
+ const live = raw.pointers.get(this.#drag.id);
255
+ if (live !== undefined) this.#drag.to.copy(live.position);
256
+ }
257
+ for (const edges of raw.pointerEdges.values())
258
+ for (const edge of edges) {
259
+ if (edge.type !== "down") {
260
+ this.#release(ctx, edge.id, edge.position);
261
+ } else if ((edge.buttons & 2) !== 0) {
262
+ this.#orderAt(ctx, edge.position, isShifted(keys));
263
+ } else {
264
+ this.#drag = { from: edge.position.clone(), id: edge.id, to: edge.position.clone() };
265
+ }
266
+ }
267
+
268
+ if (ctx.input.justPressed("cancel")) this.#mode = "";
269
+ if (ctx.input.justPressed("army")) this.#selectIds(sim.army().map((entity) => entity.id));
270
+ if (ctx.input.justPressed("base")) this.#focusBase(sim);
271
+ if (ctx.input.justPressed("attack")) this.#mode = "attack";
272
+ if (ctx.input.justPressed("moveOrder")) this.#mode = "move";
273
+ if (ctx.input.justPressed("hold")) sim.command(this.#selection, "hold");
274
+ if (ctx.input.justPressed("stopOrder")) sim.command(this.#selection, "stop");
275
+ }
276
+
277
+ #release(ctx: GameCtx, id: number, at: Vector2): void {
278
+ const drag = this.#drag;
279
+ const sim = this.#sim;
280
+ const view = this.#view;
281
+ if (drag === undefined || drag.id !== id || sim === undefined || view === undefined) return;
282
+ this.#drag = undefined;
283
+ const camera = ctx.camera as OrthographicCamera;
284
+ const size = ctx.viewport.size;
285
+ const keys = ctx.input.raw.keys;
286
+ if (Math.hypot(at.x - drag.from.x, at.y - drag.from.y) <= DRAG_SLOP) {
287
+ const hit = pickEntity(sim, camera, view, size, at.x, at.y);
288
+ if (hit === undefined) {
289
+ if (!isShifted(keys)) this.#selectIds([]);
290
+ return;
291
+ }
292
+ this.#toggleSelection(hit, isShifted(keys));
293
+ return;
294
+ }
295
+ // Shift adds to what is selected; a fresh drag replaces it.
296
+ const keep = isShifted(keys) ? this.#selection.filter((id) => sim.get(id)?.team === 0) : [];
297
+ unitsInBox(sim, camera, view, size, drag.from, drag.to, isAlt(keys), this.#found);
298
+ this.#selectIds(keep.concat(this.#found));
299
+ }
300
+
301
+ #toggleSelection(hit: PickTarget, additive: boolean): void {
302
+ const sim = this.#sim;
303
+ if (sim === undefined || hit === undefined) return;
304
+ if (!additive) {
305
+ this.#selectIds([hit.id]);
306
+ return;
307
+ }
308
+ if (hit.team !== 0) return;
309
+ this.#selectIds(
310
+ this.#selected.has(hit.id)
311
+ ? this.#selection.filter((id) => id !== hit.id)
312
+ : this.#selection.concat(hit.id),
313
+ );
314
+ }
315
+
316
+ #orderAt(ctx: GameCtx, at: Vector2, append: boolean): void {
317
+ const sim = this.#sim;
318
+ const view = this.#view;
319
+ if (sim === undefined || view === undefined) return;
320
+ const camera = ctx.camera as OrthographicCamera;
321
+ if (this.#mode.startsWith("build:")) {
322
+ const ground = groundAt(camera, at.x, at.y, ctx.viewport.size);
323
+ if (ground === null) return;
324
+ const type = this.#mode.slice(6) as BuildingType;
325
+ const result = sim.build(type, ground.x, ground.z, 0);
326
+ if (!result.ok) {
327
+ this.#notice = result.message ?? "That site cannot be built there.";
328
+ return;
329
+ }
330
+ this.#notice = `${TYPES[type].name} ordered. Its Surveyor must stay on site.`;
331
+ this.#army?.marker(ground.x, ground.z, false);
332
+ this.#mode = "";
333
+ return;
334
+ }
335
+ if (this.#selection.length === 0) return;
336
+ const ground = groundAt(camera, at.x, at.y, ctx.viewport.size);
337
+ if (ground === null) return;
338
+ const hit = pickEntity(sim, camera, view, ctx.viewport.size, at.x, at.y);
339
+ const choice = this.#contextual(sim, ground, hit);
340
+ const result = sim.command(this.#selection, choice.kind, choice.target, 0, append);
341
+ if (!result.ok) {
342
+ this.#notice = REFUSALS[choice.kind] ?? "No selected unit can do that.";
343
+ return;
344
+ }
345
+ this.#notice = "";
346
+ this.#army?.marker(
347
+ ground.x,
348
+ ground.z,
349
+ choice.kind === "attack" || choice.kind === "attackMove",
350
+ );
351
+ this.#mode = "";
352
+ }
353
+
354
+ /**
355
+ * What a right-click means: whatever is under the cursor that the selection can actually do,
356
+ * and a plain move otherwise. The order of the tests is the order of what a commander means —
357
+ * kill this, enter that bunker, patch this wall, mine that field, walk over there.
358
+ */
359
+ #contextual(
360
+ sim: Game,
361
+ ground: IPoint,
362
+ hit: PickTarget,
363
+ ): { readonly kind: string; readonly target: ICommandTarget } {
364
+ const mode = this.#mode;
365
+ const move = { kind: "move", target: ground } as const;
366
+ if (mode === "attack")
367
+ return hit !== undefined && hit.team > 0
368
+ ? { kind: "attack", target: { id: hit.id } }
369
+ : { kind: "attackMove", target: ground };
370
+ if (mode === "rally" || mode === "move") return move;
371
+ if (mode === "garrison" || mode === "repair") return { kind: mode, target: { id: hit?.id } };
372
+ if (hit !== undefined && hit.team > 0) return { kind: "attack", target: { id: hit.id } };
373
+ const has = (type: EntityType) => this.#selection.some((id) => sim.get(id)?.type === type);
374
+ if (hit !== undefined && hit.team === 0 && hit.type === "bunker" && has("ranger"))
375
+ return { kind: "garrison", target: { id: hit.id } };
376
+ if (
377
+ hit !== undefined &&
378
+ hit.team === 0 &&
379
+ hit.building &&
380
+ hit.hp < hit.maxHp - 0.1 &&
381
+ has("worker")
382
+ )
383
+ return { kind: "repair", target: { id: hit.id } };
384
+ const node = nodeNear(sim, ground.x, ground.z);
385
+ if (node !== undefined && has("worker")) return { kind: "gather", target: { id: node.id } };
386
+ return move;
387
+ }
388
+
389
+ /**
390
+ * A UI button, or a key that only names a mode. One door, so the two can never disagree about
391
+ * what "retreat" or "place a Skyport" means.
392
+ */
393
+ #intent(intent: string, payload?: unknown): void {
394
+ const sim = this.#sim;
395
+ if (sim === undefined) return;
396
+ const value = typeof payload === "string" ? payload : "";
397
+ switch (intent) {
398
+ case "army":
399
+ this.#selectIds(sim.army().map((entity) => entity.id));
400
+ break;
401
+ case "base":
402
+ this.#focusBase(sim);
403
+ break;
404
+ case "order":
405
+ this.#mode = value;
406
+ break;
407
+ case "place":
408
+ this.#mode = `build:${value}`;
409
+ break;
410
+ case "cancel":
411
+ this.#mode = "";
412
+ break;
413
+ case "train": {
414
+ const producer = this.#primary();
415
+ const result =
416
+ producer === undefined
417
+ ? { ok: false, message: "Select a production building first." }
418
+ : sim.train(producer.id, value as EntityType);
419
+ this.#notice = result.ok
420
+ ? `${TYPES[value as EntityType].name} queued.`
421
+ : (result.message ?? "That cannot be trained here.");
422
+ break;
423
+ }
424
+ case "cancelTrain": {
425
+ const producer = this.#primary();
426
+ if (producer !== undefined)
427
+ sim.cancelTrain(
428
+ producer.id,
429
+ producer.queue.findIndex((item) => item.type === value),
430
+ );
431
+ break;
432
+ }
433
+ case "retreat": {
434
+ const core = sim.own().find((entity) => entity.type === "core" && entity.built);
435
+ if (core !== undefined) {
436
+ sim.command(this.#selection, "move", { x: core.x + 9, z: core.z + 8 });
437
+ this.#army?.marker(core.x + 9, core.z + 8, false);
438
+ }
439
+ break;
440
+ }
441
+ default:
442
+ break;
443
+ }
444
+ }
445
+
446
+ #focusBase(sim: Game): void {
447
+ const core = sim.own().find((entity) => entity.type === "core");
448
+ if (core !== undefined && this.#view !== undefined)
449
+ focusRts(this.#view, core.x + 2, core.z - 6);
450
+ }
451
+
452
+ #selectIds(ids: readonly number[]): void {
453
+ this.#selection = [...ids];
454
+ this.#selected.clear();
455
+ for (const id of this.#selection) this.#selected.add(id);
456
+ }
457
+
458
+ #primary(): IEntity | undefined {
459
+ const sim = this.#sim;
460
+ if (sim === undefined) return undefined;
461
+ for (const id of this.#selection) {
462
+ const entity = sim.get(id);
463
+ if (entity !== undefined) return entity;
464
+ }
465
+ return undefined;
466
+ }
467
+
468
+ // --------------------------------------------------------------- events
469
+
470
+ /** Anything the selection lost, or anything it gained sight of, changes what may be ordered. */
471
+ #prune(sim: Game): void {
472
+ let dropped = false;
473
+ for (const id of this.#selection) {
474
+ const entity = sim.get(id);
475
+ if (entity === undefined || (entity.team > 0 && !sim.visibleAt(entity.x, entity.z))) {
476
+ this.#selected.delete(id);
477
+ dropped = true;
478
+ }
479
+ }
480
+ if (dropped) this.#selection = this.#selection.filter((id) => this.#selected.has(id));
481
+ }
482
+
483
+ #drain(sim: Game): void {
484
+ for (const event of sim.drainEvents()) {
485
+ const team = Number(event.team ?? -1);
486
+ if (event.type === "trained" && team === 0) this.#notice = `${String(event.name)} ready.`;
487
+ else if (event.type === "complete" && team === 0)
488
+ this.#notice = `${String(event.name)} online.`;
489
+ else if (event.type === "eliminated" && team > 0)
490
+ this.#notice = `${String(event.name)} command network destroyed.`;
491
+ else if (event.type === "constructionLost" && team === 0)
492
+ this.#notice = `${String(event.name)}: ${String(event.reason)}`;
493
+ else if (event.type === "end") this.#notice = "";
494
+ }
495
+ }
496
+
497
+ // ---------------------------------------------------------------- state
498
+
499
+ /**
500
+ * The published state: cheap numbers every frame, and the two derived views — the queue and the
501
+ * tactical overview — on the simulation's own clock, because both are lists and a list rebuilt
502
+ * sixty times a second to change by a hundredth is the allocation this scene is avoiding.
503
+ */
504
+ #publish(ctx: GameCtx, sim: Game, view: IRtsView): void {
505
+ const primary = this.#primary();
506
+ this.#kinds.fill(0);
507
+ let count = 0;
508
+ let teams = 0;
509
+ let x = 0;
510
+ let z = 0;
511
+ for (const id of this.#selection) {
512
+ const entity = sim.get(id);
513
+ if (entity === undefined || entity.garrisonId !== null) continue;
514
+ count += 1;
515
+ teams |= 1 << entity.team;
516
+ x += entity.x;
517
+ z += entity.z;
518
+ const kind = ORDER_KINDS.indexOf(entity.order.kind as (typeof ORDER_KINDS)[number]);
519
+ if (kind >= 0) this.#kinds[kind] = 1;
520
+ }
521
+ if (count > 0) {
522
+ x /= count;
523
+ z /= count;
524
+ this.#anchor.object.position.set(x, terrainHeight(x, z), z);
525
+ }
526
+ this.#anchor.count = count;
527
+ this.#anchor.order = ORDER_KINDS.filter((_, index) => this.#kinds[index] === 1).join(",");
528
+
529
+ const supply = sim.supply(0);
530
+ const patch = this.#patch;
531
+ patch.cameraX = Math.round(view.target.x * 10) / 10;
532
+ patch.cameraZoom = Math.round(view.zoom * 10) / 10;
533
+ patch.cameraZ = Math.round(view.target.z * 10) / 10;
534
+ patch.gathered = sim.gathered;
535
+ patch.gas = Math.floor(sim.resources.gas);
536
+ patch.kills = sim.kills;
537
+ patch.mode = this.#mode;
538
+ patch.ore = Math.floor(sim.resources.ore);
539
+ patch.primaryBuilt = primary?.built ?? true;
540
+ patch.primaryHp = primary?.hp ?? 0;
541
+ patch.primaryMaxHp = primary?.maxHp ?? 0;
542
+ patch.primaryProgress = primary?.progress ?? 0;
543
+ patch.primaryTeam = primary?.team ?? 0;
544
+ patch.primaryType = primary?.type ?? "";
545
+ patch.result = sim.result ?? "";
546
+ patch.selection = count;
547
+ patch.selectionOrder = this.#anchor.order;
548
+ patch.selectionTeams = countBits(teams);
549
+ patch.selectionX = Math.round(x * 100) / 100;
550
+ patch.selectionZ = Math.round(z * 100) / 100;
551
+ patch.simTime = Math.floor(sim.time * 20);
552
+ patch.supplyCap = supply.cap;
553
+ patch.supplyUsed = supply.used;
554
+ if (this.#drag === undefined) {
555
+ patch.dragBox = null;
556
+ } else {
557
+ // Mutated in place: the store holds the reference and the bridge clones at the boundary, so
558
+ // a rubber band does not allocate a fresh array on every frame it is being dragged.
559
+ this.#box[0] = Math.min(this.#drag.from.x, this.#drag.to.x);
560
+ this.#box[1] = Math.min(this.#drag.from.y, this.#drag.to.y);
561
+ this.#box[2] = Math.abs(this.#drag.to.x - this.#drag.from.x);
562
+ this.#box[3] = Math.abs(this.#drag.to.y - this.#drag.from.y);
563
+ patch.dragBox = this.#box;
564
+ }
565
+ if (this.#publishedStep !== Math.floor(sim.time * 20)) {
566
+ this.#publishedStep = Math.floor(sim.time * 20);
567
+ // The fog texture and the overview are rebuilt on the simulation's clock, not the frame's:
568
+ // a fog raster is 784 cells and a contact is a quad, and neither moves faster than the
569
+ // rules that move it.
570
+ this.#minimapDirty = true;
571
+ patch.minimapDots = this.#dots;
572
+ patch.minimapFog = this.#fogText;
573
+ patch.notice = this.#notice;
574
+ patch.queue = (primary?.queue ?? []).map(
575
+ (item) => `${item.type}:${item.progress.toFixed(2)}`,
576
+ );
577
+ }
578
+ ctx.state.set(patch);
579
+ }
580
+
581
+ /**
582
+ * The tactical overview: one character per cell of a coarse fog raster, then one quad per
583
+ * contact. Rebuilt on the simulation's clock rather than per frame — a map is a map, and the
584
+ * units on it move metres a second, not pixels.
585
+ */
586
+ #minimap(sim: Game): void {
587
+ const size = sim.gridSize;
588
+ const cell = Math.max(1, Math.floor(size / MINIMAP));
589
+ let fog = "";
590
+ const dots: number[] = [];
591
+ for (let row = 0; row < MINIMAP; row += 1) {
592
+ for (let column = 0; column < MINIMAP; column += 1) {
593
+ const index = (row * cell + (cell >> 1)) * size + (column * cell + (cell >> 1));
594
+ fog += sim.visible[index] === 1 ? "#" : sim.explored[index] === 1 ? "," : ".";
595
+ }
596
+ }
597
+ const scale = (MINIMAP / WORLD) * 10;
598
+ const put = (x: number, z: number, team: number, kind: number) =>
599
+ dots.push(Math.round((x + HALF) * scale), Math.round((z + HALF) * scale), team, kind);
600
+ for (const entity of sim.entities) {
601
+ if (entity.garrisonId !== null) continue;
602
+ if (entity.team > 0 && !sim.visibleAt(entity.x, entity.z)) continue;
603
+ put(entity.x, entity.z, entity.team, entity.building ? 1 : 0);
604
+ }
605
+ for (const node of sim.nodes) {
606
+ if (node.amount <= 0) continue;
607
+ const index = cellIndex(sim, node.x, node.z);
608
+ if (index < 0 || sim.explored[index] !== 1) continue;
609
+ put(node.x, node.z, 9, node.kind === "ore" ? 2 : 3);
610
+ }
611
+ this.#fogText = fog;
612
+ this.#dots = dots;
613
+ }
614
+ }
615
+
616
+ /**
617
+ * The ore or gas under a point, if any.
618
+ *
619
+ * The reach is the field's own footprint, not one crystal's: an ore node is seven cones on a 4.4 m
620
+ * ring, so a click has to land on the deposit rather than on a 1.6 m rock inside it. A click
621
+ * anywhere within a couple of metres of the site's centre lands on one of the seven.
622
+ */
623
+ function nodeNear(sim: Game, x: number, z: number): IResourceNode | undefined {
624
+ for (const node of sim.nodes) {
625
+ if (node.amount <= 0 || !sim.visibleAt(node.x, node.z)) continue;
626
+ if (dist(node, { x, z }) < node.r + 3.5) return node;
627
+ }
628
+ return undefined;
629
+ }
630
+
631
+ function cellIndex(sim: Game, x: number, z: number): number {
632
+ const ix = Math.floor((x + HALF) / sim.cell);
633
+ const iz = Math.floor((z + HALF) / sim.cell);
634
+ if (ix < 0 || iz < 0 || ix >= sim.gridSize || iz >= sim.gridSize) return -1;
635
+ return iz * sim.gridSize + ix;
636
+ }
637
+
638
+ function countBits(mask: number): number {
639
+ let bits = 0;
640
+ for (let value = mask; value !== 0; value >>= 1) bits += value & 1;
641
+ return bits;
642
+ }
643
+
644
+ function isShifted(keys: ReadonlySet<string>): boolean {
645
+ return keys.has("ShiftLeft") || keys.has("ShiftRight");
646
+ }
647
+
648
+ function isAlt(keys: ReadonlySet<string>): boolean {
649
+ return keys.has("AltLeft") || keys.has("AltRight");
650
+ }