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,187 @@
1
+ // Every number the game is balanced on lives here and nowhere else, with no engine import, so a
2
+ // spec can pin the rules without a renderer and a designer can retune a whole game in one file.
3
+
4
+ export type TowerKind = "sentry" | "mortar" | "arc" | "cryo";
5
+ export type EnemyKind = "skitter" | "runner" | "bulwark" | "titan";
6
+ export type TargetMode = "first" | "strongest" | "nearest";
7
+
8
+ export const TOWER_KINDS: readonly TowerKind[] = ["sentry", "mortar", "arc", "cryo"];
9
+ export const TARGET_MODES: readonly TargetMode[] = ["first", "strongest", "nearest"];
10
+
11
+ export const START_CREDITS = 360;
12
+ export const START_LIVES = 25;
13
+ export const TOTAL_WAVES = 12;
14
+ export const MAX_LEVEL = 3;
15
+ /** Seconds of game time between a cleared wave and the next launch when auto-send is on. */
16
+ export const AUTO_SEND_DELAY = 7;
17
+ /** Share of everything invested in a tower that recycling returns. */
18
+ export const SELL_RATE = 0.65;
19
+
20
+ export interface ITowerDef {
21
+ readonly name: string;
22
+ readonly role: string;
23
+ readonly cost: number;
24
+ /** Metres, centre to centre. */
25
+ readonly range: number;
26
+ readonly damage: number;
27
+ /** Seconds between shots. */
28
+ readonly interval: number;
29
+ }
30
+
31
+ export const TOWERS: Readonly<Record<TowerKind, ITowerDef>> = {
32
+ sentry: {
33
+ name: "Sentry",
34
+ role: "Rapid single-target fire",
35
+ cost: 100,
36
+ range: 5.5,
37
+ damage: 19,
38
+ interval: 0.48,
39
+ },
40
+ mortar: {
41
+ name: "Mortar",
42
+ role: "Splash artillery",
43
+ cost: 160,
44
+ range: 7,
45
+ damage: 66,
46
+ interval: 1.9,
47
+ },
48
+ arc: {
49
+ name: "Arc coil",
50
+ role: "Chains between foes",
51
+ cost: 190,
52
+ range: 4.8,
53
+ damage: 27,
54
+ interval: 0.85,
55
+ },
56
+ cryo: {
57
+ name: "Cryo",
58
+ role: "Slows what it touches",
59
+ cost: 120,
60
+ range: 5.2,
61
+ damage: 7,
62
+ interval: 0.8,
63
+ },
64
+ };
65
+
66
+ export const MORTAR_SPLASH = 2.5;
67
+ export const MORTAR_FLIGHT = 0.68;
68
+ export const ARC_CHAINS = 4;
69
+ export const ARC_HOP = 3.6;
70
+ export const ARC_FALLOFF = 0.87;
71
+ export const CRYO_RADIUS = 2.4;
72
+ export const CRYO_SLOW = 0.45;
73
+ export const CRYO_SLOW_STEP = 0.04;
74
+ export const CRYO_DURATION = 2.25;
75
+
76
+ export interface ITowerStats {
77
+ readonly range: number;
78
+ readonly damage: number;
79
+ readonly interval: number;
80
+ readonly splash: number;
81
+ readonly chains: number;
82
+ /** Speed multiplier applied to a chilled enemy: lower is slower. */
83
+ readonly slow: number;
84
+ }
85
+
86
+ /** What a tower of `kind` does at `level` (1 to `MAX_LEVEL`). */
87
+ export function towerStats(kind: TowerKind, level: number): ITowerStats {
88
+ if (!Number.isInteger(level) || level < 1 || level > MAX_LEVEL)
89
+ throw new Error(`Tower level must be an integer from 1 to ${MAX_LEVEL}.`);
90
+ const base = TOWERS[kind];
91
+ const step = level - 1;
92
+ return {
93
+ chains: ARC_CHAINS + step,
94
+ damage: Math.round(base.damage * (1 + 0.7 * step)),
95
+ interval: base.interval / (1 + 0.12 * step),
96
+ range: base.range + 0.6 * step,
97
+ slow: CRYO_SLOW - CRYO_SLOW_STEP * step,
98
+ splash: MORTAR_SPLASH + 0.25 * step,
99
+ };
100
+ }
101
+
102
+ /** Credits to raise a tower from `level` to the next, or undefined at the top. */
103
+ export function upgradeCost(kind: TowerKind, level: number): number | undefined {
104
+ if (level === 1) return Math.round(TOWERS[kind].cost * 0.85);
105
+ if (level === 2) return Math.round(TOWERS[kind].cost * 1.3);
106
+ return undefined;
107
+ }
108
+
109
+ export function sellValue(invested: number): number {
110
+ return Math.floor(SELL_RATE * invested);
111
+ }
112
+
113
+ export interface IEnemyDef {
114
+ readonly name: string;
115
+ readonly hp: number;
116
+ /** Metres per second. */
117
+ readonly speed: number;
118
+ readonly reward: number;
119
+ /** Lives lost when it reaches the reactor. */
120
+ readonly leak: number;
121
+ readonly scale: number;
122
+ }
123
+
124
+ export const ENEMIES: Readonly<Record<EnemyKind, IEnemyDef>> = {
125
+ skitter: { name: "Skitter", hp: 58, speed: 2.65, reward: 10, leak: 1, scale: 0.82 },
126
+ runner: { name: "Runner", hp: 40, speed: 4.2, reward: 9, leak: 1, scale: 0.67 },
127
+ bulwark: { name: "Bulwark", hp: 210, speed: 1.55, reward: 24, leak: 2, scale: 1.14 },
128
+ titan: { name: "Titan", hp: 1000, speed: 1.02, reward: 180, leak: 8, scale: 1.65 },
129
+ };
130
+
131
+ export interface ISpawn {
132
+ readonly kind: EnemyKind;
133
+ readonly hp: number;
134
+ /** Seconds after the previous spawn (or after the launch, for the first). */
135
+ readonly delay: number;
136
+ }
137
+
138
+ export function waveCount(wave: number): number {
139
+ return 7 + 2 * wave;
140
+ }
141
+
142
+ /** Health multiplier for a wave: 1.0 on wave 1, about 6 on wave 12. */
143
+ export function hpScale(wave: number): number {
144
+ const n = wave - 1;
145
+ return 1 + n * 0.2 + n * n * 0.023;
146
+ }
147
+
148
+ export function waveBonus(wave: number, leaked: boolean): number {
149
+ return 55 + 10 * wave + (leaked ? 0 : 25);
150
+ }
151
+
152
+ export function strikeDamage(wave: number): number {
153
+ return 160 + 36 * wave;
154
+ }
155
+
156
+ export const STRIKE_RADIUS = 4.8;
157
+ export const STRIKE_COOLDOWN = 30;
158
+
159
+ function kindAt(wave: number, index: number): EnemyKind {
160
+ if (wave >= 8 && index % 5 === 0) return "bulwark";
161
+ if (wave >= 3 && index % 6 === 4) return "bulwark";
162
+ if (wave >= 2 && index % 4 === 2) return "runner";
163
+ return "skitter";
164
+ }
165
+
166
+ /** The whole wave as an ordered spawn list. Deterministic: the same wave is the same wave. */
167
+ export function buildWave(wave: number): ISpawn[] {
168
+ if (!Number.isInteger(wave) || wave < 1 || wave > TOTAL_WAVES)
169
+ throw new Error(`Wave must be an integer from 1 to ${TOTAL_WAVES}.`);
170
+ const scale = hpScale(wave);
171
+ const count = waveCount(wave);
172
+ const gap = Math.max(0.35, 1.05 - 0.035 * wave);
173
+ const spawns: ISpawn[] = [];
174
+ for (let index = 0; index < count; index += 1) {
175
+ const kind = kindAt(wave, index);
176
+ spawns.push({
177
+ delay: index === 0 ? 0.15 : gap,
178
+ hp: Math.round(ENEMIES[kind].hp * scale),
179
+ kind,
180
+ });
181
+ }
182
+ if (wave === 6 || wave === 12) {
183
+ const boss = ENEMIES.titan.hp * scale * (wave === 6 ? 0.82 : 1.1);
184
+ spawns.splice(Math.floor(count * 0.55), 0, { delay: 2, hp: Math.round(boss), kind: "titan" });
185
+ }
186
+ return spawns;
187
+ }
@@ -0,0 +1,100 @@
1
+ import { PathFollow3D } from "@threenative/core";
2
+ import { CircleGeometry, Group, Mesh, MeshBasicMaterial, type Object3D, Vector3 } from "three";
3
+ import { decor, pads, reactor as reactorModel, road, terrain } from "../render/shapes.js";
4
+ import { PADS, REACTOR, roundedRoute } from "./Route.js";
5
+
6
+ interface IHost {
7
+ add(object: Object3D): unknown;
8
+ }
9
+
10
+ /** How far from a pad's centre a tap still counts as that pad: Bastion's own forgiving radius. */
11
+ export const PAD_TAP_RADIUS = 1.35;
12
+
13
+ /**
14
+ * The diorama: slab, road, forest, reactor and the sixteen pads, plus the invisible discs the
15
+ * pointer hits. Nothing here decides how anything looks — that is `render/shapes.ts` — this only
16
+ * decides where things stand and which pads are taken.
17
+ */
18
+ export class Board {
19
+ /** The road, as the points `PathFollow3D` walks. */
20
+ readonly points: readonly Vector3[];
21
+ /** Invisible tap targets, one disc per pad, named `pad-<index>`. */
22
+ readonly hits = new Group();
23
+ /** The slab, for taps that land on no pad. */
24
+ readonly ground = terrain();
25
+ readonly #occupied = new Set<number>();
26
+ readonly #reactor: Group;
27
+ #time = 0;
28
+
29
+ constructor(host: IHost) {
30
+ this.points = roundedRoute();
31
+ const path = new PathFollow3D({ points: this.points });
32
+ const line = path.curve.getSpacedPoints(280);
33
+ host.add(this.ground);
34
+ host.add(road(line));
35
+ const keepClear: (readonly [number, number, number])[] = [
36
+ [REACTOR.x, REACTOR.z, 3.4],
37
+ ...line.filter((_, index) => index % 3 === 0).map((p) => [p.x, p.z, 2.3] as const),
38
+ ];
39
+ const hitMaterial = new MeshBasicMaterial({
40
+ colorWrite: false,
41
+ depthWrite: false,
42
+ opacity: 0,
43
+ transparent: true,
44
+ });
45
+ const hitGeometry = new CircleGeometry(PAD_TAP_RADIUS, 24).rotateX(-Math.PI / 2);
46
+ this.hits.name = "pad-hits";
47
+ for (const [index, [x, z]] of PADS.entries()) {
48
+ keepClear.push([x, z, 2.1]);
49
+ const hit = new Mesh(hitGeometry, hitMaterial);
50
+ hit.position.set(x, 0.3, z);
51
+ hit.name = `pad-${index}`;
52
+ this.hits.add(hit);
53
+ }
54
+ host.add(pads(PADS));
55
+ host.add(decor(keepClear));
56
+ this.#reactor = reactorModel();
57
+ this.#reactor.position.copy(REACTOR);
58
+ host.add(this.#reactor);
59
+ host.add(this.hits);
60
+ }
61
+
62
+ occupied(index: number): boolean {
63
+ return this.#occupied.has(index);
64
+ }
65
+
66
+ occupy(index: number): void {
67
+ this.#occupied.add(index);
68
+ }
69
+
70
+ free(index: number): void {
71
+ this.#occupied.delete(index);
72
+ }
73
+
74
+ position(index: number, target = new Vector3()): Vector3 {
75
+ const pad = PADS[index];
76
+ if (pad === undefined) throw new Error(`There is no pad ${index}.`);
77
+ return target.set(pad[0], 0, pad[1]);
78
+ }
79
+
80
+ /** The pad a tap or hover landed on, from any object inside `hits`. */
81
+ padOf(object: Object3D): number | undefined {
82
+ const match = /^pad-(\d+)$/u.exec(object.name);
83
+ return match?.[1] === undefined ? undefined : Number(match[1]);
84
+ }
85
+
86
+ /** Spins the reactor core and lets it bob. Cosmetic, and driven by game time. */
87
+ update(dt: number): void {
88
+ this.#time += dt;
89
+ const core = this.#reactor.getObjectByName("core");
90
+ const ring = this.#reactor.getObjectByName("ring");
91
+ if (core !== undefined) {
92
+ core.rotation.y += dt * 0.9;
93
+ core.position.y = 1.95 + Math.sin(this.#time * 1.6) * 0.09;
94
+ }
95
+ if (ring !== undefined) {
96
+ ring.rotation.z += dt * 1.3;
97
+ ring.position.y = core?.position.y ?? 1.95;
98
+ }
99
+ }
100
+ }
@@ -0,0 +1,84 @@
1
+ import { Vector3 } from "three";
2
+
3
+ /** Where the road runs, in metres on the ground plane. The reactor waits at the last point. */
4
+ export const WAYPOINTS: readonly (readonly [number, number])[] = [
5
+ [-17, -7],
6
+ [-10, -7],
7
+ [-10, 3],
8
+ [-2, 3],
9
+ [-2, -6],
10
+ [6, -6],
11
+ [6, 6],
12
+ [15, 6],
13
+ ];
14
+
15
+ export const REACTOR = new Vector3(15.5, 0, 6);
16
+
17
+ /** The sixteen places a tower can stand. The road is the level design; these are its answers. */
18
+ export const PADS: readonly (readonly [number, number])[] = [
19
+ [-12, -3],
20
+ [-7, -5],
21
+ [-7, 0],
22
+ [-12, 5],
23
+ [-5, 6],
24
+ [1, 1],
25
+ [1, -3],
26
+ [2, -9],
27
+ [9, -7],
28
+ [9, -2],
29
+ [3, 5],
30
+ [9, 9],
31
+ [12, 2],
32
+ [-1, 8],
33
+ [-15, 1],
34
+ [-5, -9],
35
+ ];
36
+
37
+ /** The pad the game starts with a free Sentry on. */
38
+ export const STARTING_PAD = 2;
39
+
40
+ /**
41
+ * Pads ranked by how much road each covers, best first. The "safe build" key walks this list, so
42
+ * three purchases cover most of the route instead of stacking on one corner.
43
+ */
44
+ export const SAFE_PADS: readonly number[] = [2, 6, 0, 5, 1, 7, 9, 4, 11, 10];
45
+
46
+ const CORNER_RADIUS = 1.15;
47
+ const CORNER_SAMPLES = 10;
48
+
49
+ /**
50
+ * The road as a polyline with each corner cut into a short curve, so an enemy turns instead of
51
+ * pivoting. Fed to `PathFollow3D`, which is the single source of truth for where the road is: the
52
+ * ribbon on the ground is drawn from the same curve the enemies walk.
53
+ */
54
+ export function roundedRoute(): Vector3[] {
55
+ const points: Vector3[] = [];
56
+ const corners = WAYPOINTS.map(([x, z]) => new Vector3(x, 0, z));
57
+ const first = corners[0];
58
+ const last = corners.at(-1);
59
+ if (first === undefined || last === undefined) throw new Error("The route needs waypoints.");
60
+ points.push(first.clone());
61
+ for (let index = 1; index < corners.length - 1; index += 1) {
62
+ const before = corners[index - 1];
63
+ const corner = corners[index];
64
+ const after = corners[index + 1];
65
+ if (before === undefined || corner === undefined || after === undefined) continue;
66
+ const toBefore = before.clone().sub(corner);
67
+ const toAfter = after.clone().sub(corner);
68
+ const radius = Math.min(CORNER_RADIUS, toBefore.length() * 0.4, toAfter.length() * 0.4);
69
+ const start = corner.clone().addScaledVector(toBefore.normalize(), radius);
70
+ const end = corner.clone().addScaledVector(toAfter.normalize(), radius);
71
+ for (let step = 0; step <= CORNER_SAMPLES; step += 1) {
72
+ const t = step / CORNER_SAMPLES;
73
+ points.push(
74
+ new Vector3(
75
+ (1 - t) * (1 - t) * start.x + 2 * (1 - t) * t * corner.x + t * t * end.x,
76
+ 0,
77
+ (1 - t) * (1 - t) * start.z + 2 * (1 - t) * t * corner.z + t * t * end.z,
78
+ ),
79
+ );
80
+ }
81
+ }
82
+ points.push(last.clone());
83
+ return points;
84
+ }
@@ -0,0 +1,62 @@
1
+ import type { InputMap } from "@threenative/core";
2
+ import { MathUtils, type PerspectiveCamera, type Vector3 } from "three";
3
+ import { START_YAW, ZOOM_MAX, ZOOM_MIN, placeCamera } from "./render/camera.js";
4
+
5
+ const DRAG_YAW_PER_PIXEL = 0.006;
6
+ const KEY_TURN = Math.PI / 8;
7
+ const WHEEL_ZOOM = 0.12;
8
+ /** Metres per second the view slides at zoom 1, and how far from the board's centre it may go. */
9
+ const PAN_SPEED = 14;
10
+ const PAN_LIMIT = { x: 12, z: 8 } as const;
11
+
12
+ /**
13
+ * The orbit camera: WASD or the arrows pan it, right-drag turns the board, the wheel (or a pinch)
14
+ * zooms, Q and E turn it an eighth of a circle. Panning is relative to the view, so "up" is always
15
+ * up the screen however the board is turned, and it is clamped so a player can never lose the
16
+ * board. The shake offset from a leak or a strike is added on top after the orbit is placed.
17
+ */
18
+ export class CameraRig {
19
+ yaw = START_YAW;
20
+ zoom = 1;
21
+ panX = 0;
22
+ panZ = 0;
23
+ #lastX = 0;
24
+ #dragging = false;
25
+
26
+ update(
27
+ camera: PerspectiveCamera,
28
+ input: Pick<InputMap, "axis" | "justPressed" | "pressed" | "vector">,
29
+ pointerX: number,
30
+ dt: number,
31
+ shake?: Vector3,
32
+ ): void {
33
+ const dragging = input.pressed("orbit");
34
+ if (dragging && this.#dragging) this.yaw -= (pointerX - this.#lastX) * DRAG_YAW_PER_PIXEL;
35
+ this.#dragging = dragging;
36
+ this.#lastX = pointerX;
37
+ if (input.justPressed("turnLeft")) this.yaw += KEY_TURN;
38
+ if (input.justPressed("turnRight")) this.yaw -= KEY_TURN;
39
+ this.zoom = MathUtils.clamp(
40
+ this.zoom * (1 + input.axis("zoom") * WHEEL_ZOOM),
41
+ ZOOM_MIN,
42
+ ZOOM_MAX,
43
+ );
44
+ // `vector("move").y` is +up; the view's "up the screen" on the ground is away from the camera.
45
+ const move = input.vector("move");
46
+ const reach = (PAN_SPEED / this.zoom) * dt;
47
+ const sin = Math.sin(this.yaw);
48
+ const cos = Math.cos(this.yaw);
49
+ this.panX = MathUtils.clamp(
50
+ this.panX + (cos * move.x - sin * move.y) * reach,
51
+ -PAN_LIMIT.x,
52
+ PAN_LIMIT.x,
53
+ );
54
+ this.panZ = MathUtils.clamp(
55
+ this.panZ + (-sin * move.x - cos * move.y) * reach,
56
+ -PAN_LIMIT.z,
57
+ PAN_LIMIT.z,
58
+ );
59
+ placeCamera(camera, this.yaw, this.zoom, this.panX, this.panZ);
60
+ if (shake !== undefined) camera.position.add(shake);
61
+ }
62
+ }
@@ -0,0 +1,64 @@
1
+ import { START_CREDITS, START_LIVES } from "./balance.js";
2
+
3
+ function positive(amount: number, what: string): void {
4
+ if (!Number.isFinite(amount) || amount <= 0)
5
+ throw new Error(`Economy.${what} requires a positive amount.`);
6
+ }
7
+
8
+ /** Credits, reactor lives and score. Nothing here ticks: money moves only when the game says so. */
9
+ export class Economy {
10
+ #credits = START_CREDITS;
11
+ #lives = START_LIVES;
12
+ #score = 0;
13
+ #spent = 0;
14
+
15
+ get credits(): number {
16
+ return this.#credits;
17
+ }
18
+
19
+ get lives(): number {
20
+ return this.#lives;
21
+ }
22
+
23
+ get score(): number {
24
+ return this.#score;
25
+ }
26
+
27
+ get spent(): number {
28
+ return this.#spent;
29
+ }
30
+
31
+ /** False, and no change, when the credits are not there. */
32
+ spend(amount: number): boolean {
33
+ positive(amount, "spend");
34
+ if (amount > this.#credits) return false;
35
+ this.#credits -= amount;
36
+ this.#spent += amount;
37
+ return true;
38
+ }
39
+
40
+ /** A kill: the credits arrive at once and the score is ten times them. */
41
+ reward(amount: number): void {
42
+ positive(amount, "reward");
43
+ this.#credits += amount;
44
+ this.#score += amount * 10;
45
+ }
46
+
47
+ /** A wave-clear payout: worth five score a credit. */
48
+ bonus(amount: number): void {
49
+ positive(amount, "bonus");
50
+ this.#credits += amount;
51
+ this.#score += amount * 5;
52
+ }
53
+
54
+ /** Recycling a tower. Not income, so the score does not move. */
55
+ refund(amount: number): void {
56
+ positive(amount, "refund");
57
+ this.#credits += amount;
58
+ }
59
+
60
+ leak(lives: number): void {
61
+ positive(lives, "leak");
62
+ this.#lives = Math.max(0, this.#lives - lives);
63
+ }
64
+ }