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,284 @@
1
+ import {
2
+ BoxGeometry,
3
+ Color,
4
+ IcosahedronGeometry,
5
+ InstancedMesh,
6
+ Matrix4,
7
+ Mesh,
8
+ type MeshBasicMaterial,
9
+ type Object3D,
10
+ Quaternion,
11
+ RingGeometry,
12
+ SphereGeometry,
13
+ Vector3,
14
+ } from "three";
15
+ import { glowMaterial } from "../render/materials.js";
16
+ import { palette } from "../render/palette.js";
17
+
18
+ interface IHost {
19
+ add(object: Object3D): unknown;
20
+ }
21
+
22
+ const BEAMS = 40;
23
+ const RINGS = 16;
24
+ const SHELLS = 8;
25
+ const SPARKS = 320;
26
+ const FORWARD = new Vector3(0, 0, 1);
27
+
28
+ interface IBeam {
29
+ readonly mesh: Mesh;
30
+ life: number;
31
+ total: number;
32
+ thickness: number;
33
+ }
34
+
35
+ interface IRing {
36
+ readonly mesh: Mesh;
37
+ life: number;
38
+ total: number;
39
+ radius: number;
40
+ }
41
+
42
+ interface IShell {
43
+ readonly mesh: Mesh;
44
+ life: number;
45
+ total: number;
46
+ height: number;
47
+ readonly from: Vector3;
48
+ readonly to: Vector3;
49
+ onLand: (() => void) | undefined;
50
+ }
51
+
52
+ interface ISpark {
53
+ life: number;
54
+ total: number;
55
+ readonly position: Vector3;
56
+ readonly velocity: Vector3;
57
+ size: number;
58
+ }
59
+
60
+ /**
61
+ * Every transient the fight throws up — beams, shockwaves, mortar shells and sparks — from fixed
62
+ * pools built once. A burst that finds its pool empty simply skips: the effect is decoration, the
63
+ * damage has already happened. Randomness comes from the seeded source the scene hands in, so the
64
+ * same seed throws the same sparks.
65
+ *
66
+ * Fade is by shrinking, never by opacity, so one shared material serves a whole pool per colour.
67
+ */
68
+ export class Effects {
69
+ readonly #beams: IBeam[] = [];
70
+ readonly #rings: IRing[] = [];
71
+ readonly #shells: IShell[] = [];
72
+ readonly #sparks: ISpark[] = [];
73
+ readonly #sparkMesh: InstancedMesh;
74
+ readonly #materials = new Map<number, MeshBasicMaterial>();
75
+ readonly #matrix = new Matrix4();
76
+ readonly #rotation = new Quaternion();
77
+ readonly #scale = new Vector3();
78
+ readonly #colour = new Color();
79
+ readonly #direction = new Vector3();
80
+ readonly #middle = new Vector3();
81
+ readonly #top = new Vector3();
82
+ #nextSpark = 0;
83
+
84
+ readonly #random: () => number;
85
+
86
+ constructor(host: IHost, random: () => number) {
87
+ this.#random = random;
88
+ const beamGeometry = new BoxGeometry(1, 1, 1);
89
+ for (let index = 0; index < BEAMS; index += 1) {
90
+ const mesh = new Mesh(beamGeometry, this.#material(0xffffff));
91
+ mesh.visible = false;
92
+ host.add(mesh);
93
+ this.#beams.push({ life: 0, mesh, thickness: 0.1, total: 1 });
94
+ }
95
+ const ringGeometry = new RingGeometry(0.86, 1, 40).rotateX(-Math.PI / 2);
96
+ for (let index = 0; index < RINGS; index += 1) {
97
+ const mesh = new Mesh(ringGeometry, this.#material(0xffffff));
98
+ mesh.visible = false;
99
+ host.add(mesh);
100
+ this.#rings.push({ life: 0, mesh, radius: 1, total: 1 });
101
+ }
102
+ const shellGeometry = new SphereGeometry(0.2, 8, 6);
103
+ for (let index = 0; index < SHELLS; index += 1) {
104
+ const mesh = new Mesh(shellGeometry, this.#material(palette.towers.mortar));
105
+ mesh.visible = false;
106
+ host.add(mesh);
107
+ this.#shells.push({
108
+ from: new Vector3(),
109
+ height: 4,
110
+ life: 0,
111
+ mesh,
112
+ onLand: undefined,
113
+ to: new Vector3(),
114
+ total: 1,
115
+ });
116
+ }
117
+ this.#sparkMesh = new InstancedMesh(
118
+ new IcosahedronGeometry(0.1, 0),
119
+ glowMaterial(0xffffff),
120
+ SPARKS,
121
+ );
122
+ this.#sparkMesh.frustumCulled = false;
123
+ this.#sparkMesh.count = 0;
124
+ host.add(this.#sparkMesh);
125
+ for (let index = 0; index < SPARKS; index += 1)
126
+ this.#sparks.push({
127
+ life: 0,
128
+ position: new Vector3(),
129
+ size: 1,
130
+ total: 1,
131
+ velocity: new Vector3(),
132
+ });
133
+ }
134
+
135
+ /** Mortar shells still in the air. A wave is not over until they land. */
136
+ get inFlight(): number {
137
+ let count = 0;
138
+ for (const shell of this.#shells) if (shell.life > 0) count += 1;
139
+ return count;
140
+ }
141
+
142
+ #material(color: number): MeshBasicMaterial {
143
+ let material = this.#materials.get(color);
144
+ if (material === undefined) {
145
+ material = glowMaterial(color);
146
+ this.#materials.set(color, material);
147
+ }
148
+ return material;
149
+ }
150
+
151
+ /** A straight beam between two points that thins to nothing over `life` seconds. */
152
+ beam(from: Vector3, to: Vector3, color: number, life = 0.14, thickness = 0.09): void {
153
+ const slot = this.#beams.find((beam) => beam.life <= 0);
154
+ if (slot === undefined) return;
155
+ slot.mesh.material = this.#material(color);
156
+ slot.life = slot.total = life;
157
+ slot.thickness = thickness;
158
+ this.#direction.subVectors(to, from);
159
+ const length = this.#direction.length();
160
+ this.#middle.addVectors(from, to).multiplyScalar(0.5);
161
+ slot.mesh.position.copy(this.#middle);
162
+ if (length > 1e-4)
163
+ slot.mesh.quaternion.setFromUnitVectors(FORWARD, this.#direction.divideScalar(length));
164
+ slot.mesh.scale.set(thickness, thickness, length);
165
+ slot.mesh.visible = true;
166
+ }
167
+
168
+ /** A jagged bolt: `segments` short beams wandering off the straight line. */
169
+ bolt(from: Vector3, to: Vector3, color: number, jitter: () => number, segments = 4): void {
170
+ const previous = new Vector3().copy(from);
171
+ for (let index = 1; index <= segments; index += 1) {
172
+ const next = new Vector3().lerpVectors(from, to, index / segments);
173
+ if (index < segments) next.add(new Vector3(jitter() * 0.5, jitter() * 0.3, jitter() * 0.5));
174
+ this.beam(previous, next, color, 0.16, 0.07);
175
+ previous.copy(next);
176
+ }
177
+ }
178
+
179
+ /** A flat shockwave on the ground that grows to `radius` and thins away. */
180
+ ring(at: Vector3, radius: number, color: number, life = 0.4): void {
181
+ const slot = this.#rings.find((ring) => ring.life <= 0);
182
+ if (slot === undefined) return;
183
+ slot.mesh.material = this.#material(color);
184
+ slot.life = slot.total = life;
185
+ slot.radius = radius;
186
+ slot.mesh.position.set(at.x, 0.12, at.z);
187
+ slot.mesh.scale.setScalar(0.01);
188
+ slot.mesh.visible = true;
189
+ }
190
+
191
+ /** A mortar shell on a parabola. `onLand` runs when it arrives. */
192
+ shell(from: Vector3, to: Vector3, seconds: number, height: number, onLand: () => void): void {
193
+ const slot = this.#shells.find((shell) => shell.life <= 0);
194
+ if (slot === undefined) {
195
+ onLand();
196
+ return;
197
+ }
198
+ slot.from.copy(from);
199
+ slot.to.copy(to);
200
+ slot.life = slot.total = seconds;
201
+ slot.height = height;
202
+ slot.onLand = onLand;
203
+ slot.mesh.position.copy(from);
204
+ slot.mesh.visible = true;
205
+ }
206
+
207
+ /** Sparks thrown outward from `at`, tinted `color`. */
208
+ burst(at: Vector3, color: number, count: number, speed = 4): void {
209
+ this.#colour.set(color);
210
+ for (let index = 0; index < count; index += 1) {
211
+ const slot = this.#sparks[this.#nextSpark];
212
+ this.#nextSpark = (this.#nextSpark + 1) % SPARKS;
213
+ if (slot === undefined) return;
214
+ slot.life = slot.total = 0.35 + this.#random() * 0.4;
215
+ slot.position.copy(at);
216
+ slot.velocity.set(
217
+ (this.#random() - 0.5) * speed,
218
+ this.#random() * speed * 0.9 + 0.5,
219
+ (this.#random() - 0.5) * speed,
220
+ );
221
+ slot.size = 0.6 + this.#random() * 0.9;
222
+ this.#sparkMesh.setColorAt(this.#sparks.indexOf(slot), this.#colour);
223
+ }
224
+ if (this.#sparkMesh.instanceColor !== null) this.#sparkMesh.instanceColor.needsUpdate = true;
225
+ }
226
+
227
+ /** The orbital strike's column of light from the sky. */
228
+ column(at: Vector3, color: number): void {
229
+ this.#top.set(at.x, 15, at.z);
230
+ this.beam(this.#top, at, color, 0.5, 0.9);
231
+ }
232
+
233
+ update(dt: number): void {
234
+ for (const beam of this.#beams) {
235
+ if (beam.life <= 0) continue;
236
+ beam.life -= dt;
237
+ if (beam.life <= 0) {
238
+ beam.mesh.visible = false;
239
+ continue;
240
+ }
241
+ const t = beam.life / beam.total;
242
+ beam.mesh.scale.x = beam.mesh.scale.y = beam.thickness * t;
243
+ }
244
+ for (const ring of this.#rings) {
245
+ if (ring.life <= 0) continue;
246
+ ring.life -= dt;
247
+ if (ring.life <= 0) {
248
+ ring.mesh.visible = false;
249
+ continue;
250
+ }
251
+ const t = 1 - ring.life / ring.total;
252
+ ring.mesh.scale.setScalar(Math.max(0.01, ring.radius * (1 - (1 - t) * (1 - t))));
253
+ }
254
+ for (const shell of this.#shells) {
255
+ if (shell.life <= 0) continue;
256
+ shell.life -= dt;
257
+ const t = Math.min(1, 1 - shell.life / shell.total);
258
+ shell.mesh.position.lerpVectors(shell.from, shell.to, t);
259
+ shell.mesh.position.y += Math.sin(t * Math.PI) * shell.height;
260
+ if (shell.life > 0) continue;
261
+ shell.mesh.visible = false;
262
+ const land = shell.onLand;
263
+ shell.onLand = undefined;
264
+ land?.();
265
+ }
266
+ let live = 0;
267
+ for (const [index, spark] of this.#sparks.entries()) {
268
+ if (spark.life <= 0) {
269
+ this.#matrix.makeScale(0, 0, 0);
270
+ this.#sparkMesh.setMatrixAt(index, this.#matrix);
271
+ continue;
272
+ }
273
+ live = index + 1;
274
+ spark.life -= dt;
275
+ spark.velocity.y -= 9 * dt;
276
+ spark.position.addScaledVector(spark.velocity, dt);
277
+ const s = Math.max(0, spark.life / spark.total) * spark.size;
278
+ this.#matrix.compose(spark.position, this.#rotation.identity(), this.#scale.set(s, s, s));
279
+ this.#sparkMesh.setMatrixAt(index, this.#matrix);
280
+ }
281
+ this.#sparkMesh.count = live;
282
+ this.#sparkMesh.instanceMatrix.needsUpdate = true;
283
+ }
284
+ }
@@ -0,0 +1,198 @@
1
+ import { type IPathFollow3DSample, PathFollow3D } from "@threenative/core";
2
+ import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
+ import { Group, type Mesh, type Quaternion, Vector3 } from "three";
4
+ import { ENEMIES, type EnemyKind } from "../balance.js";
5
+ import { ENEMY_LAYER } from "../physics.js";
6
+ import { emitPlaytestEvent } from "../playtest-events.js";
7
+ import { palette } from "../render/palette.js";
8
+ import { enemy as enemyModel, healthBar } from "../render/shapes.js";
9
+
10
+ /** Where a parked enemy waits: far below the board, where no tower's query can find it. */
11
+ const PARKED = new Vector3(0, -80, 0);
12
+ /** Bastion's sizes read small from this far back, so every walker is drawn twice as large. */
13
+ const SIZE = 2;
14
+
15
+ /**
16
+ * One walker. Built once per pool slot and reused: `reset` puts it back on the road at full health,
17
+ * and dying or reaching the reactor parks it out of every range query. It follows the same
18
+ * `PathFollow3D` curve the road is drawn from, so the enemy can never leave the road it is drawn on.
19
+ */
20
+ export class Enemy {
21
+ readonly entityId: string;
22
+ readonly kind: EnemyKind;
23
+ /** The root: position only. The model inside it turns to face the road. */
24
+ readonly mesh = new Group();
25
+ readonly tags = ["enemy", "hostile"];
26
+ id: string;
27
+ /** Where it fell, kept because it is parked the same instant. */
28
+ readonly deathPoint = new Vector3();
29
+ hp = 0;
30
+ maxHp = 0;
31
+ readonly #body: RigidBody3D;
32
+ readonly #model: Group;
33
+ readonly #legs: readonly Mesh[];
34
+ readonly #bar: ReturnType<typeof healthBar>;
35
+ readonly #path: PathFollow3D;
36
+ readonly #sample: IPathFollow3DSample = {
37
+ point: new Vector3(),
38
+ progress: 0,
39
+ tangent: new Vector3(0, 0, 1),
40
+ };
41
+ readonly #onDefeated: (enemy: Enemy) => void;
42
+ readonly #onLeak: (enemy: Enemy) => void;
43
+ #dead = true;
44
+ #escaped = false;
45
+ #slow = 1;
46
+ #slowTimer = 0;
47
+ #phase = 0;
48
+
49
+ constructor(options: {
50
+ readonly id: string;
51
+ readonly kind: EnemyKind;
52
+ readonly points: readonly Vector3[];
53
+ readonly physics: IPhysicsContext;
54
+ readonly onDefeated: (enemy: Enemy) => void;
55
+ readonly onLeak: (enemy: Enemy) => void;
56
+ }) {
57
+ this.entityId = options.id;
58
+ this.id = options.id;
59
+ this.kind = options.kind;
60
+ this.#onDefeated = options.onDefeated;
61
+ this.#onLeak = options.onLeak;
62
+ const definition = ENEMIES[options.kind];
63
+ this.#path = new PathFollow3D({ points: options.points, speed: definition.speed });
64
+ const model = enemyModel(options.kind);
65
+ this.#model = model.group;
66
+ this.#legs = model.legs;
67
+ this.#model.scale.setScalar(definition.scale * SIZE);
68
+ this.mesh.add(this.#model);
69
+ this.#bar = healthBar(options.kind === "titan" ? 2.1 : 1.25);
70
+ this.#bar.group.position.y = 1.35 * definition.scale * SIZE + 0.45;
71
+ this.#bar.group.visible = false;
72
+ this.mesh.add(this.#bar.group);
73
+ this.mesh.visible = false;
74
+ this.mesh.position.copy(PARKED);
75
+ this.#body = new RigidBody3D({
76
+ collisionLayer: ENEMY_LAYER,
77
+ collisionMask: 0,
78
+ entity: this.entityId,
79
+ object: this.mesh,
80
+ physics: options.physics,
81
+ shape: CollisionShape3D.sphere(0.5 * definition.scale * SIZE),
82
+ type: "kinematic",
83
+ });
84
+ }
85
+
86
+ get dead(): boolean {
87
+ return this.#dead;
88
+ }
89
+
90
+ get escaped(): boolean {
91
+ return this.#escaped;
92
+ }
93
+
94
+ /** On the road and fighting: neither killed nor arrived. */
95
+ get active(): boolean {
96
+ return !this.#dead && !this.#escaped;
97
+ }
98
+
99
+ /** Metres walked along the road. "First" targeting is the largest of these. */
100
+ get progress(): number {
101
+ return this.#path.progress;
102
+ }
103
+
104
+ get position(): Vector3 {
105
+ return this.mesh.position;
106
+ }
107
+
108
+ get chilled(): boolean {
109
+ return this.#slow < 1;
110
+ }
111
+
112
+ reset(id: string, hp: number): void {
113
+ this.id = id;
114
+ this.hp = this.maxHp = hp;
115
+ this.#dead = false;
116
+ this.#escaped = false;
117
+ this.#slow = 1;
118
+ this.#slowTimer = 0;
119
+ this.#phase = 0;
120
+ this.#path.progressTo(0);
121
+ this.#bar.group.visible = false;
122
+ this.#bar.fill.scale.x = 1;
123
+ this.mesh.visible = true;
124
+ this.#place(this.#path.sample(0, this.#sample));
125
+ }
126
+
127
+ takeDamage(amount: number): void {
128
+ if (!this.active) return;
129
+ if (!Number.isFinite(amount) || amount <= 0) throw new Error("Enemy damage must be positive.");
130
+ this.hp = Math.max(0, this.hp - amount);
131
+ this.#bar.group.visible = true;
132
+ this.#bar.fill.scale.x = this.hp / this.maxHp;
133
+ if (this.hp > 0) return;
134
+ this.#dead = true;
135
+ this.deathPoint.copy(this.mesh.position).setY(0.5);
136
+ this.#retire();
137
+ this.#onDefeated(this);
138
+ emitPlaytestEvent({ entity: this.id, name: "defeated" });
139
+ }
140
+
141
+ /** Slows the walker to `multiplier` of its speed for `seconds`. The strongest chill wins. */
142
+ chill(multiplier: number, seconds: number): void {
143
+ if (!this.active) return;
144
+ this.#slow = this.#slowTimer > 0 ? Math.min(this.#slow, multiplier) : multiplier;
145
+ this.#slowTimer = seconds;
146
+ this.#bar.fillMaterial.color.setHex(palette.effects.barChilled);
147
+ }
148
+
149
+ /** Turns the health bar to face the camera. The root never rotates, so the camera's own turn is right. */
150
+ faceCamera(quaternion: Quaternion): void {
151
+ this.#bar.group.quaternion.copy(quaternion);
152
+ }
153
+
154
+ update(dt: number): void {
155
+ if (!this.active) return;
156
+ if (this.#slowTimer > 0) {
157
+ this.#slowTimer -= dt;
158
+ if (this.#slowTimer <= 0) {
159
+ this.#slow = 1;
160
+ this.#bar.fillMaterial.color.setHex(palette.effects.barFull);
161
+ }
162
+ }
163
+ this.#path.speed = ENEMIES[this.kind].speed * this.#slow;
164
+ this.#place(this.#path.advance(dt, this.#sample));
165
+ this.#phase += dt * this.#path.speed * 5;
166
+ for (const [index, leg] of this.#legs.entries())
167
+ leg.scale.y = 1 + 0.18 * Math.sin(this.#phase + (index % 2) * Math.PI);
168
+ if (!this.#path.completed) return;
169
+ this.#escaped = true;
170
+ this.#retire();
171
+ this.#onLeak(this);
172
+ emitPlaytestEvent({ entity: this.id, name: "leaked" });
173
+ }
174
+
175
+ debug(): Record<string, unknown> {
176
+ return {
177
+ hp: this.hp,
178
+ kind: this.kind,
179
+ position: this.mesh.position.toArray(),
180
+ progress: this.#path.progress,
181
+ };
182
+ }
183
+
184
+ dispose(): void {
185
+ this.#body.dispose();
186
+ this.mesh.removeFromParent();
187
+ }
188
+
189
+ #retire(): void {
190
+ this.mesh.visible = false;
191
+ this.mesh.position.copy(PARKED);
192
+ }
193
+
194
+ #place(sample: IPathFollow3DSample): void {
195
+ this.mesh.position.copy(sample.point).setY(0);
196
+ this.#model.rotation.y = Math.atan2(sample.tangent.x, sample.tangent.z);
197
+ }
198
+ }
@@ -0,0 +1,72 @@
1
+ import { defineGame } from "@threenative/core";
2
+ import { playtest } from "@threenative/core/playtest";
3
+ import { type IPhysicsContext, rapier } from "@threenative/physics";
4
+ import config from "../threenative.config.js";
5
+ import { pushIntent } from "./intents.js";
6
+ import { drainPlaytestEvents as events } from "./playtest-events.js";
7
+ import { Battle } from "./scenes/Battle.js";
8
+ import { Boot } from "./scenes/Boot.js";
9
+ import type { GameState } from "./state.js";
10
+
11
+ const game = defineGame<GameState, IPhysicsContext>({
12
+ input: {
13
+ cancel: { keys: ["Escape"] },
14
+ help: { keys: ["KeyH"] },
15
+ autosend: { keys: ["KeyN"] },
16
+ launch: { keys: ["Space"] },
17
+ move: {
18
+ down: ["ArrowDown", "KeyS"],
19
+ left: ["ArrowLeft", "KeyA"],
20
+ right: ["ArrowRight", "KeyD"],
21
+ up: ["ArrowUp", "KeyW"],
22
+ },
23
+ orbit: { mouseButtons: [2] },
24
+ pause: { keys: ["KeyP"] },
25
+ recycle: { keys: ["KeyX"] },
26
+ restart: { keys: ["KeyR"] },
27
+ safeBuild: { keys: ["KeyB"] },
28
+ speed: { keys: ["KeyG"] },
29
+ strike: { keys: ["KeyF"] },
30
+ tower1: { keys: ["Digit1"] },
31
+ tower2: { keys: ["Digit2"] },
32
+ tower3: { keys: ["Digit3"] },
33
+ tower4: { keys: ["Digit4"] },
34
+ turnLeft: { keys: ["KeyQ"] },
35
+ turnRight: { keys: ["KeyE"] },
36
+ upgrade: { keys: ["KeyU"] },
37
+ zoom: { scroll: true },
38
+ },
39
+ // Nothing in this game falls: the towers only *ask* who is in range, and the walkers follow a
40
+ // curve. The world still needs a solver to answer those questions, so gravity is simply zero.
41
+ plugins: [rapier({ gravity: { x: 0, y: 0, z: 0 } }), playtest({ events })],
42
+ display: config.display,
43
+ render: config.renderer,
44
+ scenes: { battle: Battle, boot: Boot },
45
+ seed: 47021,
46
+ start: "boot",
47
+ });
48
+
49
+ export default game;
50
+
51
+ /**
52
+ * What the UI can ask the game to do.
53
+ *
54
+ * Intents are one-way and named by the game: the UI sends `arm`, `launch`, `upgrade`, `recycle`,
55
+ * `target`, `speed`, `pause`, `strike`, `restart` and the game decides what each means. Nothing
56
+ * comes back this way — the UI reads the game's published state instead, which keeps one source
57
+ * of truth on the side that owns the simulation. The listener only files the request; the scene
58
+ * reads it inside its own frame, where changing the world is safe.
59
+ */
60
+ game.ui.onIntent((intent, payload) => {
61
+ if (intent === "restart") {
62
+ void game.goto("battle");
63
+ return;
64
+ }
65
+ pushIntent(intent, payload);
66
+ game.state.set({
67
+ // `game.ui.connected` is true only once the UI announced itself, which is what tells an
68
+ // overlay that never came up apart from a game whose HUD is simply empty.
69
+ uiReady: game.ui.connected,
70
+ });
71
+ game.state.flush();
72
+ });
@@ -0,0 +1,21 @@
1
+ /**
2
+ * What the UI asked for, waiting for the scene to read it.
3
+ *
4
+ * `game.ui.onIntent` fires outside any scene, so the listener only *files* the request here and the
5
+ * scene drains it once a frame, inside the fixed step, where changing game state is safe. The queue
6
+ * is the seam: nothing in the HUD can reach the simulation any other way.
7
+ */
8
+ export interface IIntent {
9
+ readonly intent: string;
10
+ readonly payload?: unknown;
11
+ }
12
+
13
+ const pending: IIntent[] = [];
14
+
15
+ export function pushIntent(intent: string, payload?: unknown): void {
16
+ pending.push({ intent, payload });
17
+ }
18
+
19
+ export function drainIntents(): IIntent[] {
20
+ return pending.splice(0);
21
+ }
@@ -0,0 +1,15 @@
1
+ import { acceptHotUpdate } from "@threenative/core/hot";
2
+ import { createElement } from "react";
3
+ import { createRoot } from "react-dom/client";
4
+ import game from "./game.js";
5
+ import { App } from "./ui/App.js";
6
+ import "./style.css";
7
+
8
+ import.meta.hot?.accept();
9
+ acceptHotUpdate(game, import.meta.hot);
10
+ const root = document.getElementById("root");
11
+ if (root === null) throw new Error("Missing #root element.");
12
+ const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
13
+ const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
14
+ appRoot.__threenativeRoot = reactRoot;
15
+ reactRoot.render(createElement(App, { game }));
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Collision layers, and only collision layers. Which bit means what is a game decision — the
3
+ * framework never names your layers. Towers do not collide with anything: they only *ask* who is in
4
+ * range, and this is the one layer that question looks at.
5
+ */
6
+ export const ENEMY_LAYER = 1;
@@ -0,0 +1,38 @@
1
+ import type { PerspectiveCamera } from "three";
2
+
3
+ /** Radians above the ground plane, and the yaw the game opens on. Bastion's own diorama angle. */
4
+ export const ELEVATION = 0.83;
5
+ export const START_YAW = 0.34;
6
+ /** Metres from the board's centre at zoom 1. Zoom divides it. */
7
+ const DISTANCE = 58;
8
+ export const ZOOM_MIN = 0.65;
9
+ export const ZOOM_MAX = 1.7;
10
+
11
+ export function setupCamera(camera: PerspectiveCamera): void {
12
+ camera.fov = 32;
13
+ camera.near = 1;
14
+ camera.far = 320;
15
+ placeCamera(camera, START_YAW, 1);
16
+ }
17
+
18
+ /**
19
+ * Puts the camera on its orbit: `yaw` around the point it looks at, `zoom` in and out, and that point
20
+ * slid across the ground by (`panX`, `panZ`). It always looks at the board, never away from it.
21
+ */
22
+ export function placeCamera(
23
+ camera: PerspectiveCamera,
24
+ yaw: number,
25
+ zoom: number,
26
+ panX = 0,
27
+ panZ = 0,
28
+ ): void {
29
+ const distance = DISTANCE / zoom;
30
+ const flat = Math.cos(ELEVATION) * distance;
31
+ camera.position.set(
32
+ panX + Math.sin(yaw) * flat,
33
+ Math.sin(ELEVATION) * distance,
34
+ panZ + Math.cos(yaw) * flat,
35
+ );
36
+ camera.lookAt(panX, 0, panZ + 1.2);
37
+ camera.updateProjectionMatrix();
38
+ }
@@ -0,0 +1,42 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // Three lights, each with one job: a warm low sun that carves every facet and throws the shadows, a
5
+ // cool sky-to-moss hemisphere that keeps the shaded sides from going black, and a faint cold rim from
6
+ // behind that separates the towers from the slab. The photographed sky in `sky.ts` is the fourth
7
+ // source: it is what metal reflects.
8
+ import { DirectionalLight, HemisphereLight, PCFSoftShadowMap, type Scene } from "three";
9
+
10
+ type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
11
+
12
+ export function setupLighting(
13
+ scene: Scene,
14
+ renderer: ShadowRenderer,
15
+ mobile = false,
16
+ ): { key: DirectionalLight } {
17
+ renderer.shadowMap.enabled = true;
18
+ renderer.shadowMap.type = PCFSoftShadowMap;
19
+ scene.add(new HemisphereLight(0xd5e8db, 0x3a4435, 1.5));
20
+ const key = new DirectionalLight(0xffe3b1, 3.4);
21
+ key.position.set(-18, 30, 17);
22
+ key.castShadow = true;
23
+ const size = mobile ? 2048 : 4096;
24
+ key.shadow.mapSize.set(size, size);
25
+ key.shadow.radius = 2;
26
+ key.shadow.camera.near = 1;
27
+ key.shadow.camera.far = 90;
28
+ const extent = 26;
29
+ key.shadow.camera.left = -extent;
30
+ key.shadow.camera.right = extent;
31
+ key.shadow.camera.top = extent;
32
+ key.shadow.camera.bottom = -extent;
33
+ key.shadow.bias = -0.0003;
34
+ key.shadow.normalBias = 0.03;
35
+ scene.add(key);
36
+ const rim = new DirectionalLight(0xa6d6c4, 0.9);
37
+ rim.position.set(15, 12, -18);
38
+ scene.add(rim);
39
+ // The key light is returned because `WorldEnvironment`'s godrays stage raymarches against its
40
+ // shadow map, so `setupPost` needs the light itself.
41
+ return { key };
42
+ }