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
@@ -1,94 +0,0 @@
1
- import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
2
- import { type Object3D, Vector3 } from "three";
3
- import { GROUND_LAYER, ROUTE_LAYER } from "../physics.js";
4
- import { base, board, routeSegment, surrounds } from "../render/shapes.js";
5
-
6
- export const ROUTE_POINTS = [
7
- new Vector3(-11, 0, -6),
8
- new Vector3(-5, 0, -6),
9
- new Vector3(-5, 0, 0),
10
- new Vector3(2, 0, 0),
11
- new Vector3(2, 0, 6),
12
- new Vector3(11, 0, 6),
13
- ] as const;
14
-
15
- /**
16
- * The four buildable positions, in the order the safe-build key walks them.
17
- *
18
- * The order is the level design. A player who buys three towers gets the first three, and those
19
- * three have to cover the whole route: with `(-2.3, 3.8)` third, the last nine metres — the run
20
- * along `z = 6` out to the exit — sat outside every tower's radius, so an attacker that survived
21
- * the first twenty-seven metres walked the rest unopposed. Measured over ten waves: nineteen
22
- * shots, nineteen kills, twenty attackers, one leak, every run.
23
- *
24
- * `(6.2, 3.8)` is third instead. It reaches the exit run end to end and still covers the corner
25
- * before it, and `(-2.3, 3.8)` becomes the fourth tower a richer player adds for depth rather
26
- * than for coverage. Slot zero stays where it is — the overlap-rejection test builds on it.
27
- */
28
- export const SAFE_BUILD_SLOTS = [
29
- new Vector3(-8.3, 0, -3.8),
30
- new Vector3(-2.3, 0, -3.8),
31
- new Vector3(6.2, 0, 3.8),
32
- new Vector3(-2.3, 0, 3.8),
33
- ] as const;
34
-
35
- export const ROUTE_TEST_SLOT = new Vector3(-8, 0, -6);
36
-
37
- interface IRouteContext {
38
- readonly add: (object: Object3D) => Object3D;
39
- readonly physics: IPhysicsContext;
40
- }
41
-
42
- export class RouteBoard {
43
- readonly points = ROUTE_POINTS.map((point) => point.clone());
44
- readonly surface: Object3D;
45
- readonly #bodies: RigidBody3D[] = [];
46
-
47
- constructor(ctx: IRouteContext) {
48
- this.surface = board();
49
- ctx.add(surrounds());
50
- ctx.add(this.surface);
51
- this.#bodies.push(
52
- new RigidBody3D({
53
- collisionLayer: GROUND_LAYER,
54
- collisionMask: 0xffff,
55
- entity: "ground",
56
- object: this.surface,
57
- physics: ctx.physics,
58
- shape: CollisionShape3D.box(28, 0.2, 20),
59
- type: "fixed",
60
- }),
61
- );
62
- for (let index = 0; index < this.points.length - 1; index += 1) {
63
- const from = this.points[index];
64
- const to = this.points[index + 1];
65
- if (from === undefined || to === undefined) continue;
66
- const midpoint = from.clone().add(to).multiplyScalar(0.5);
67
- const delta = to.clone().sub(from);
68
- const length = Math.max(delta.x, delta.z, -delta.x, -delta.z);
69
- const visual = routeSegment(length, 2.1);
70
- visual.position.copy(midpoint);
71
- visual.rotation.y = Math.abs(delta.z) > Math.abs(delta.x) ? Math.PI / 2 : 0;
72
- ctx.add(visual);
73
- this.#bodies.push(
74
- new RigidBody3D({
75
- collisionLayer: ROUTE_LAYER,
76
- collisionMask: 0xffff,
77
- entity: `route.${index}`,
78
- object: visual,
79
- physics: ctx.physics,
80
- shape: CollisionShape3D.box(length, 0.3, 2.1),
81
- type: "fixed",
82
- }),
83
- );
84
- }
85
- const goal = base();
86
- goal.position.copy(this.points.at(-1) ?? new Vector3());
87
- ctx.add(goal);
88
- }
89
-
90
- dispose(): void {
91
- for (const body of this.#bodies) body.dispose();
92
- this.surface.removeFromParent();
93
- }
94
- }
@@ -1,18 +0,0 @@
1
- import { GroundSnap, normaliseToMetres } from "@threenative/core";
2
- import type { Group } from "three";
3
-
4
- export interface IDefenseConventions {
5
- readonly applyGrounding: (surfaceY: number, dt: number) => void;
6
- readonly groundSnap: GroundSnap;
7
- readonly normaliseFactor: number;
8
- }
9
-
10
- export function prepareCommanderConventions(model: Group): IDefenseConventions {
11
- const normaliseFactor = normaliseToMetres(model, { axis: "height", metres: 1 });
12
- const groundSnap = new GroundSnap(model);
13
- return {
14
- applyGrounding: (surfaceY, dt) => groundSnap.apply(model, surfaceY, dt),
15
- groundSnap,
16
- normaliseFactor,
17
- };
18
- }
@@ -1,36 +0,0 @@
1
- export const STARTING_BALANCE = 120;
2
- export const TOWER_COST = 40;
3
- export const INCOME_RATE = 6;
4
-
5
- export class Economy {
6
- #balance = STARTING_BALANCE;
7
- #income = 0;
8
- #spent = 0;
9
-
10
- get balance(): number {
11
- return this.#balance;
12
- }
13
-
14
- get income(): number {
15
- return this.#income;
16
- }
17
-
18
- get spent(): number {
19
- return this.#spent;
20
- }
21
-
22
- update(dt: number): void {
23
- if (!Number.isFinite(dt) || dt < 0) throw new Error("Economy.update requires a finite delta.");
24
- this.#income += INCOME_RATE * dt;
25
- this.#balance = STARTING_BALANCE + this.#income - this.#spent;
26
- }
27
-
28
- spend(amount: number): boolean {
29
- if (!Number.isFinite(amount) || amount <= 0)
30
- throw new Error("Economy.spend requires a positive amount.");
31
- if (amount > this.#balance) return false;
32
- this.#spent += amount;
33
- this.#balance = STARTING_BALANCE + this.#income - this.#spent;
34
- return true;
35
- }
36
- }
@@ -1,52 +0,0 @@
1
- import type { ICtx } from "@threenative/core";
2
- import type { IPhysicsContext } from "@threenative/physics";
3
- import { type Group, Vector3 } from "three";
4
- import { type IDefenseConventions, prepareCommanderConventions } from "../conventions.js";
5
- import { commander as commanderMesh } from "../render/shapes.js";
6
- import type { GameState } from "../state.js";
7
-
8
- type GameCtx = ICtx<GameState, IPhysicsContext>;
9
-
10
- const MOVE_SPEED = 4;
11
- const SPAWN = new Vector3(9, 0, 8);
12
- const BOARD_BOUNDS = { maxX: 12, maxZ: 8, minX: -12, minZ: -8 } as const;
13
-
14
- export class Player {
15
- readonly mesh: Group;
16
- readonly tags = ["player", "commander"];
17
- #conventions: IDefenseConventions;
18
-
19
- constructor(ctx: GameCtx) {
20
- this.mesh = commanderMesh();
21
- this.mesh.name = "player";
22
- this.mesh.position.copy(SPAWN);
23
- this.#conventions = prepareCommanderConventions(this.mesh);
24
- ctx.add(this.mesh);
25
- }
26
-
27
- update(ctx: GameCtx, dt: number): void {
28
- const move = ctx.input.vector("move");
29
- this.mesh.position.x = Math.max(
30
- BOARD_BOUNDS.minX,
31
- Math.min(BOARD_BOUNDS.maxX, this.mesh.position.x + move.x * MOVE_SPEED * dt),
32
- );
33
- this.mesh.position.z = Math.max(
34
- BOARD_BOUNDS.minZ,
35
- Math.min(BOARD_BOUNDS.maxZ, this.mesh.position.z - move.y * MOVE_SPEED * dt),
36
- );
37
- if (move.lengthSq() > 0) this.mesh.rotation.y = Math.atan2(move.x, -move.y);
38
- this.#conventions.applyGrounding(0, dt);
39
- }
40
-
41
- debug(): Record<string, unknown> {
42
- return {
43
- groundClearance: this.#conventions.groundSnap.clearance,
44
- normaliseFactor: this.#conventions.normaliseFactor,
45
- position: this.mesh.position.toArray(),
46
- };
47
- }
48
-
49
- dispose(): void {
50
- this.mesh.removeFromParent();
51
- }
52
- }
@@ -1,51 +0,0 @@
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 { drainPlaytestEvents as events } from "./playtest-events.js";
6
- import { Boot } from "./scenes/Boot.js";
7
- import { Defense } from "./scenes/Defense.js";
8
- import type { GameState } from "./state.js";
9
-
10
- const game = defineGame<GameState, IPhysicsContext>({
11
- input: {
12
- move: {
13
- down: ["ArrowDown", "KeyS"],
14
- left: ["ArrowLeft", "KeyA"],
15
- right: ["ArrowRight", "KeyD"],
16
- up: ["ArrowUp", "KeyW"],
17
- },
18
- overlapTest: { keys: ["KeyO"] },
19
- restart: { keys: ["KeyR"] },
20
- routeTest: { keys: ["KeyX"] },
21
- safeBuild: { keys: ["KeyB"] },
22
- },
23
- plugins: [rapier({ gravity: { x: 0, y: -9.8, z: 0 } }), playtest({ events })],
24
- display: config.display,
25
- render: config.renderer,
26
- scenes: { boot: Boot, defense: Defense },
27
- seed: 92092,
28
- start: "boot",
29
- });
30
-
31
- export default game;
32
-
33
- /**
34
- * What the UI can ask the game to do.
35
- *
36
- * Intents are one-way and named by the game: the UI sends `restart`, `pause` or `resume` and the
37
- * game decides what each means. Nothing comes back this way — the UI reads the game's published
38
- * state instead, which keeps one source of truth on the side that owns the simulation.
39
- */
40
- game.ui.onIntent((intent) => {
41
- if (intent === "restart") void game.goto("defense");
42
- if (intent === "pause") game.pause();
43
- if (intent === "resume") game.resume();
44
- game.state.set({
45
- // `game.ui.connected` is true only once the UI announced itself, which is what tells an
46
- // overlay that never came up apart from a game whose HUD is simply empty.
47
- uiReady: game.ui.connected,
48
- ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
49
- });
50
- game.state.flush();
51
- });
@@ -1,13 +0,0 @@
1
- /**
2
- * Collision layers, and only collision layers.
3
- *
4
- * Which bit means what is a game decision — the framework never names your layers — so the four
5
- * live here where a scene, a tower and an attacker all read the same numbers. Everything else
6
- * this file used to hold (a `directSpaceState` accessor, a `RigidBody3D` wrapper that only added
7
- * `entity`) is now first-class on `@threenative/physics`: query through `ctx.physics.directSpaceState`
8
- * and pass `entity` straight to `RigidBody3D`.
9
- */
10
- export const GROUND_LAYER = 1;
11
- export const ROUTE_LAYER = 2;
12
- export const TOWER_LAYER = 4;
13
- export const ATTACKER_LAYER = 8;
@@ -1,49 +0,0 @@
1
- import { CollisionShape3D, type PhysicsDirectSpaceState3D } from "@threenative/physics";
2
- import type { Vector3 } from "three";
3
- import { ROUTE_LAYER, TOWER_LAYER } from "../physics.js";
4
-
5
- export type PlacementReason = "clear" | "overlap" | "route";
6
-
7
- export interface IPlacementResult {
8
- readonly reason: PlacementReason;
9
- readonly accepted: boolean;
10
- }
11
-
12
- const BUILD_MASK = ROUTE_LAYER | TOWER_LAYER;
13
- const BUILD_HEIGHT = 0.6;
14
-
15
- export class Buildable {
16
- readonly #query: PhysicsDirectSpaceState3D;
17
- readonly #shape = CollisionShape3D.box(1.55, 1.2, 1.55);
18
- readonly #placed: Vector3[] = [];
19
-
20
- constructor(query: PhysicsDirectSpaceState3D) {
21
- this.#query = query;
22
- }
23
-
24
- validate(position: Vector3): IPlacementResult {
25
- if (![position.x, position.y, position.z].every(Number.isFinite))
26
- throw new Error("Buildable position must be finite.");
27
- const centre = position.clone().setY(BUILD_HEIGHT);
28
- const hits = this.#query.intersectShape({
29
- collisionMask: BUILD_MASK,
30
- maxResults: 32,
31
- position: centre,
32
- shape: this.#shape,
33
- });
34
- if (hits.some((hit) => hit.entity?.startsWith("route.") === true))
35
- return { accepted: false, reason: "route" };
36
- if (
37
- hits.some((hit) => hit.entity?.startsWith("tower.") === true) ||
38
- this.#placed.some((placed) => placed.distanceToSquared(position) < 2.2)
39
- )
40
- return { accepted: false, reason: "overlap" };
41
- return { accepted: true, reason: "clear" };
42
- }
43
-
44
- commit(position: Vector3): void {
45
- if (!this.validate(position).accepted)
46
- throw new Error("Buildable.commit requires a position that passed validation.");
47
- this.#placed.push(position.clone());
48
- }
49
- }
@@ -1,16 +0,0 @@
1
- import type { PerspectiveCamera } from "three";
2
-
3
- export function setupCamera(camera: PerspectiveCamera): void {
4
- camera.fov = 48;
5
- camera.near = 0.1;
6
- camera.far = 400;
7
- // Lower and further back than the old 22/19, so the horizon and the hills behind the sector are
8
- // in frame. Pitched straight down the terrain filled the picture edge to edge and the board had
9
- // a ground but still no *place*.
10
- camera.position.set(0, 14.5, 26);
11
- camera.lookAt(0, 0, -2.5);
12
- // `playtests/pointer-placement.playtest.json` clicks a screen fraction and asserts it lands on
13
- // `build-tile-2-3` (world -9, -3). Those fractions are a projection of *this* camera: move it and
14
- // they must be recomputed, not nudged by eye.
15
- camera.updateProjectionMatrix();
16
- }
@@ -1,37 +0,0 @@
1
- import {
2
- AmbientLight,
3
- DirectionalLight,
4
- HemisphereLight,
5
- PCFSoftShadowMap,
6
- type Scene,
7
- } from "three";
8
- import { palette } from "./palette.js";
9
-
10
- type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
11
-
12
- // Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
13
- // the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
14
- // rendering a black pass.
15
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
16
- renderer.shadowMap.enabled = true;
17
- renderer.shadowMap.type = PCFSoftShadowMap;
18
- scene.add(new HemisphereLight(palette.skyLow, palette.shadow, 1.2));
19
- const key = new DirectionalLight(palette.accent, 3.4);
20
- key.position.set(-8, 18, 10);
21
- key.castShadow = true;
22
- key.shadow.mapSize.set(1024, 1024);
23
- key.shadow.camera.near = 0.5;
24
- key.shadow.camera.far = 80;
25
- key.shadow.camera.left = -26;
26
- key.shadow.camera.right = 26;
27
- key.shadow.camera.top = 26;
28
- key.shadow.camera.bottom = -26;
29
- key.shadow.normalBias = 0.04;
30
- scene.add(key);
31
- const rim = new DirectionalLight(palette.skyLow, 1.15);
32
- rim.position.set(12, 8, -14);
33
- scene.add(rim);
34
- scene.add(new AmbientLight(palette.shadow, 0.25));
35
-
36
- return key;
37
- }
@@ -1,22 +0,0 @@
1
- import { MeshStandardMaterial } from "three";
2
- import { palette, toon } from "./palette.js";
3
-
4
- export function createMaterials() {
5
- return {
6
- accent: toon(palette.accent, 0.42),
7
- attacker: toon(palette.skyLow, 0.58),
8
- ground: toon(palette.ground, 0.94),
9
- route: toon(palette.route, 0.88),
10
- shadow: new MeshStandardMaterial({ color: palette.shadow, roughness: 1 }),
11
- tower: toon(palette.accent, 0.56),
12
- /** The plate the board sits on, and the terrain around it. */
13
- /** The terrain the board sits in: cooler and darker than the board itself. */
14
- terrain: toon(0x2f4a44, 0.96),
15
- /** Hills on the horizon. */
16
- distant: toon(0x44636a, 0.98),
17
- /** Tower and base plating: cool metal against the warm accent. */
18
- plating: toon(0x5c6f7d, 0.6),
19
- /** The one hostile colour. */
20
- hostile: toon(0xd9584f, 0.6),
21
- };
22
- }
@@ -1,28 +0,0 @@
1
- import { MeshStandardMaterial } from "three";
2
-
3
- // A sector at dusk. `ground` was 0x173a3b against a flat 0x2b6a76 sky, and the first frame showed
4
- // a near-black olive rectangle floating in a teal void — the board had no ground under it, no
5
- // horizon behind it, and no value separation from either.
6
- export const palette = {
7
- skyHigh: 0x1d3f5e,
8
- skyLow: 0x86b3b6,
9
- /** The buildable board. Mid, so a tower standing on it reads against it. */
10
- ground: 0x3f5f4c,
11
- route: 0x6b7684,
12
- accent: 0xf5c451,
13
- shadow: 0x1a2c38,
14
- } as const;
15
-
16
- // Terrain and distant hills are shades of these six rather than roles of their own; `materials.ts`
17
- // owns them, next to the surfaces that use them.
18
-
19
- const materials = new Map<string, MeshStandardMaterial>();
20
-
21
- export function toon(color: number, roughness = 0.8): MeshStandardMaterial {
22
- const key = `${color}:${roughness}`;
23
- const cached = materials.get(key);
24
- if (cached !== undefined) return cached;
25
- const material = new MeshStandardMaterial({ color, roughness, metalness: 0.08 });
26
- materials.set(key, material);
27
- return material;
28
- }
@@ -1,170 +0,0 @@
1
- // Generated for you: ordinary Three.js; ThreeNative does not read this file. Delete or rewrite
2
- // it freely — the tiers below are a starting point, not a framework look.
3
- //
4
- // This is the one place this game decides how expensive it looks. `postprocessing.ts` reads
5
- // `qualityPreset(resolveQualityTier(...))` and nothing else, so "make it run on a phone" is one
6
- // file to edit rather than a hunt through anonymous literals.
7
- //
8
- // **Where the numbers come from.** Every millisecond below is GPU time from the per-stage
9
- // ablation recorded in the engine repository's `docs/verification/runtime-perf-state.md`: Chrome
10
- // on an RTX 2080, 1600x900, static build, `gpuMs` read from three's `timestamp-query`. In that
11
- // scene the whole five-stage chain costs **12.5 ms of a 14.7 ms GPU frame**, and the same frame
12
- // with every stage off costs **2.2 ms**. The per-stage figures oversum — removing SSGI also
13
- // removes the denoise passes the later stages sample — so read each as *what turning this one off
14
- // gave back*, not as a share of a partition. A stage nobody has ablated on its own says
15
- // `unmeasured` rather than guessing, and your scene is not that scene: read `TN_FRAME_BUDGET`
16
- // back after you change a tier.
17
- //
18
- // One cost that is **not** a stage here and outweighs most of them: the prefiltered reflection
19
- // probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
20
- // in `sky.ts`, not in this file.
21
- //
22
- import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
23
-
24
- /**
25
- * The three names this game's look comes in.
26
- *
27
- * `low` is what a phone gets and `high` what a desktop gets — those two are this template's
28
- * shipped looks, unchanged. `medium` is the rung in between for a machine that is neither: a
29
- * laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
30
- * what any of them mean.
31
- */
32
- export type QualityTier = "low" | "medium" | "high";
33
-
34
- const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
35
-
36
- /**
37
- * Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
38
- * `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
39
- */
40
- function isQualityTier(value: string): value is QualityTier {
41
- return (QUALITY_TIERS as readonly string[]).includes(value);
42
- }
43
-
44
- /**
45
- * Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
46
- *
47
- * Fails closed. An unrecognised tier name throws with the value it was handed rather than
48
- * quietly rendering the default, because a silent fallback here looks exactly like a tier that
49
- * turned out to have no effect.
50
- */
51
- export function resolveQualityTier(
52
- request: { readonly mobile?: boolean; readonly tier?: string } = {},
53
- ): QualityTier {
54
- const requested = request.tier;
55
- if (requested !== undefined) {
56
- if (!isQualityTier(requested)) {
57
- throw new Error(
58
- `Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
59
- );
60
- }
61
- return requested;
62
- }
63
- return request.mobile === true ? "low" : "high";
64
- }
65
-
66
- /**
67
- * What a desktop gets: this template's shipped desktop look, unchanged.
68
- *
69
- * The whole chain measured 12.5 ms of a 14.7 ms GPU frame in the reference ablation, and SSGI
70
- * with its denoiser is ~9.2 ms of that.
71
- */
72
- const high: IWorldEnvironmentOptions = {
73
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
74
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
75
- // to be.
76
- bloomEnabled: true,
77
- bloomRadius: 0.5,
78
- bloomStrength: 0.42,
79
- bloomThreshold: 0.2,
80
- exposure: 1.15,
81
- // The two full-resolution denoise passes over the AO and GI terms: ~1.9 ms. Only worth running
82
- // when SSGI is on — its noise is what they clean up.
83
- denoiseEnabled: true,
84
- // SSGI, the screen-space indirect-light gather: ~7.3 ms alone, ~9.2 ms with the two denoise
85
- // passes it feeds. The largest stage in the chain by a factor of two, of a 14.7 ms frame.
86
- // Dropping this pair is what `medium` is.
87
- ssgiEnabled: true,
88
- ssgiRadius: 18,
89
- ssgiQuality: "medium",
90
- // Half the frame in each axis, so a quarter of the pixels. Full-res SSGI cost 14.4 ms
91
- // of a 39.7 ms frame on an RTX 2080; this is the same gather over a quarter of the work,
92
- // and it measured *sharper* because the scaler spends what it hands back on resolution.
93
- // `worldEnvironment.ts` explains why it takes a wrapper instead of a property.
94
- ssgiResolutionScale: 0.5,
95
- // Screen-space reflections: ~4.1 ms.
96
- ssrEnabled: true,
97
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
98
- // are on and do nothing" — the ray dies a metre from where it started.
99
- ssrMaxDistance: 44,
100
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
101
- // the rays and is very hard to see in the result.
102
- ssrResolutionScale: 0.5,
103
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
104
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
105
- // that runs one of them.
106
- sharpenEnabled: true,
107
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
108
- sharpenStrength: 0.3,
109
- tonemapMode: "aces",
110
- };
111
-
112
- /**
113
- * `high` minus the gather and its denoiser — the single change in this chain measured to give
114
- * back most of the frame: **14.7 ms -> 5.5 ms of GPU** in the reference ablation. Reflections,
115
- * bloom and the sharpener stay, so it is recognisably the same look.
116
- */
117
- const medium: IWorldEnvironmentOptions = {
118
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
119
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
120
- // to be.
121
- bloomEnabled: true,
122
- bloomRadius: 0.5,
123
- bloomStrength: 0.42,
124
- bloomThreshold: 0.2,
125
- exposure: 1.15,
126
- // Screen-space reflections: ~4.1 ms.
127
- ssrEnabled: true,
128
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
129
- // are on and do nothing" — the ray dies a metre from where it started.
130
- ssrMaxDistance: 44,
131
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
132
- // the rays and is very hard to see in the result.
133
- ssrResolutionScale: 0.5,
134
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
135
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
136
- // that runs one of them.
137
- sharpenEnabled: true,
138
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
139
- sharpenStrength: 0.3,
140
- tonemapMode: "aces",
141
- };
142
-
143
- /**
144
- * What a phone gets: this template's shipped mobile look, unchanged. Bloom and the tone curve,
145
- * nothing screen-space. The ablation's floor — every stage off — was 2.2 ms.
146
- */
147
- const low: IWorldEnvironmentOptions = {
148
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
149
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
150
- // to be.
151
- bloomEnabled: true,
152
- bloomRadius: 0.5,
153
- bloomStrength: 0.42,
154
- bloomThreshold: 0.2,
155
- exposure: 1.15,
156
- tonemapMode: "aces",
157
- };
158
-
159
- const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
160
-
161
- /** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
162
- export function qualityPreset(tier: string): IWorldEnvironmentOptions {
163
- const preset = QUALITY_PRESETS[tier as QualityTier];
164
- if (preset === undefined) {
165
- throw new Error(
166
- `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
167
- );
168
- }
169
- return preset;
170
- }