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,550 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // Every model in the game is built here from boxes, cylinders, cones and icosahedra: no file to
5
+ // download, no licence to carry, and a tower is one function you can read top to bottom. The rules
6
+ // of the look are three: a body in the neutral greens, one accent in the thing's own colour, and a
7
+ // silhouette that says what it does — a twin barrel is a Sentry, a tilted tube is a Mortar, a
8
+ // stack of rings is an Arc coil, two canisters are a Cryo.
9
+ import {
10
+ BoxGeometry,
11
+ BufferGeometry,
12
+ ConeGeometry,
13
+ CylinderGeometry,
14
+ Float32BufferAttribute,
15
+ Group,
16
+ IcosahedronGeometry,
17
+ InstancedMesh,
18
+ Matrix4,
19
+ Mesh,
20
+ MeshBasicMaterial,
21
+ type Object3D,
22
+ PlaneGeometry,
23
+ PointLight,
24
+ Quaternion,
25
+ RingGeometry,
26
+ TorusGeometry,
27
+ Vector3,
28
+ } from "three";
29
+ import type { EnemyKind, TowerKind } from "../balance.js";
30
+ import {
31
+ accentMaterial,
32
+ blackMaterial,
33
+ bodyMaterial,
34
+ darkMaterial,
35
+ enemyMaterial,
36
+ glowMaterial,
37
+ metalMaterial,
38
+ padMarkMaterial,
39
+ padMaterial,
40
+ pineDarkMaterial,
41
+ pineMaterial,
42
+ reactorMaterial,
43
+ roadEdgeMaterial,
44
+ roadInlayMaterial,
45
+ roadMaterial,
46
+ rockMaterial,
47
+ shrubMaterial,
48
+ slabBaseMaterial,
49
+ slabMidMaterial,
50
+ slabTopMaterial,
51
+ tableMaterial,
52
+ trunkMaterial,
53
+ } from "./materials.js";
54
+ import { palette } from "./palette.js";
55
+
56
+ type Material = Mesh["material"];
57
+
58
+ function part(
59
+ geometry: BufferGeometry,
60
+ material: Material,
61
+ position: readonly [number, number, number],
62
+ options: { cast?: boolean; receive?: boolean } = {},
63
+ ): Mesh {
64
+ const mesh = new Mesh(geometry, material);
65
+ mesh.position.set(position[0], position[1], position[2]);
66
+ mesh.castShadow = options.cast ?? true;
67
+ mesh.receiveShadow = options.receive ?? true;
68
+ return mesh;
69
+ }
70
+
71
+ /** The playable slab: three layers of moss and earth, standing on a dark table that meets the fog. */
72
+ export function terrain(width = 38, depth = 25): Group {
73
+ const group = new Group();
74
+ group.name = "terrain";
75
+ group.add(
76
+ part(new BoxGeometry(width, 0.3, depth), slabTopMaterial, [0, -0.15, 0], { cast: false }),
77
+ part(new BoxGeometry(width + 0.6, 0.45, depth + 0.6), slabMidMaterial, [0, -0.525, 0], {
78
+ cast: false,
79
+ }),
80
+ part(new BoxGeometry(width + 1.2, 0.7, depth + 1.2), slabBaseMaterial, [0, -1.1, 0], {
81
+ cast: false,
82
+ }),
83
+ );
84
+ const table = part(
85
+ new PlaneGeometry(600, 600).rotateX(-Math.PI / 2),
86
+ tableMaterial,
87
+ [0, -1.73, 0],
88
+ { cast: false },
89
+ );
90
+ table.name = "table";
91
+ group.add(table);
92
+ return group;
93
+ }
94
+
95
+ /**
96
+ * A flat ribbon following `points`, offset sideways by `offset` and `width` wide. One ribbon is
97
+ * the road, one is the border under it, two thin ones are the inlay lines: all read from the same
98
+ * curve the enemies walk, so the road can never disagree with the path.
99
+ */
100
+ export function ribbon(
101
+ points: readonly Vector3[],
102
+ width: number,
103
+ y: number,
104
+ material: Material,
105
+ offset = 0,
106
+ ): Mesh {
107
+ const positions: number[] = [];
108
+ const indices: number[] = [];
109
+ const tangent = new Vector3();
110
+ for (let index = 0; index < points.length; index += 1) {
111
+ const point = points[index];
112
+ const next = points[Math.min(index + 1, points.length - 1)];
113
+ const previous = points[Math.max(index - 1, 0)];
114
+ if (point === undefined || next === undefined || previous === undefined) continue;
115
+ tangent.subVectors(next, previous).setY(0).normalize();
116
+ const nx = -tangent.z;
117
+ const nz = tangent.x;
118
+ const centre = offset;
119
+ positions.push(
120
+ point.x + nx * (centre - width / 2),
121
+ y,
122
+ point.z + nz * (centre - width / 2),
123
+ point.x + nx * (centre + width / 2),
124
+ y,
125
+ point.z + nz * (centre + width / 2),
126
+ );
127
+ if (index > 0) {
128
+ const a = (index - 1) * 2;
129
+ indices.push(a, a + 2, a + 1, a + 1, a + 2, a + 3);
130
+ }
131
+ }
132
+ const geometry = new BufferGeometry();
133
+ geometry.setAttribute("position", new Float32BufferAttribute(positions, 3));
134
+ geometry.setIndex(indices);
135
+ geometry.computeVertexNormals();
136
+ const mesh = new Mesh(geometry, material);
137
+ mesh.receiveShadow = true;
138
+ return mesh;
139
+ }
140
+
141
+ /** The whole road, drawn from the curve the enemies walk. */
142
+ export function road(points: readonly Vector3[]): Group {
143
+ const group = new Group();
144
+ group.name = "road";
145
+ group.add(
146
+ ribbon(points, 2.65, 0.02, roadEdgeMaterial),
147
+ ribbon(points, 2.14, 0.04, roadMaterial),
148
+ ribbon(points, 0.07, 0.055, roadInlayMaterial, -0.86),
149
+ ribbon(points, 0.07, 0.055, roadInlayMaterial, 0.86),
150
+ );
151
+ return group;
152
+ }
153
+
154
+ /**
155
+ * Every build pad at once: octagonal plates with a warm "+", as three instanced draws instead of
156
+ * forty-eight. A pad is an invitation to build, so it stays visible from across the board.
157
+ */
158
+ export function pads(places: readonly (readonly [number, number])[]): Group {
159
+ const group = new Group();
160
+ group.name = "pads";
161
+ const plate = new InstancedMesh(
162
+ new CylinderGeometry(0.95, 1.05, 0.14, 8).rotateY(Math.PI / 8).translate(0, 0.07, 0),
163
+ padMaterial,
164
+ places.length,
165
+ );
166
+ const bar = new InstancedMesh(
167
+ new BoxGeometry(0.62, 0.05, 0.13).translate(0, 0.16, 0),
168
+ padMarkMaterial,
169
+ places.length,
170
+ );
171
+ const cross = new InstancedMesh(
172
+ new BoxGeometry(0.13, 0.05, 0.62).translate(0, 0.16, 0),
173
+ padMarkMaterial,
174
+ places.length,
175
+ );
176
+ const matrix = new Matrix4();
177
+ for (const [index, [x, z]] of places.entries()) {
178
+ matrix.makeTranslation(x, 0, z);
179
+ plate.setMatrixAt(index, matrix);
180
+ bar.setMatrixAt(index, matrix);
181
+ cross.setMatrixAt(index, matrix);
182
+ }
183
+ plate.castShadow = plate.receiveShadow = true;
184
+ bar.receiveShadow = cross.receiveShadow = true;
185
+ group.add(plate, bar, cross);
186
+ return group;
187
+ }
188
+
189
+ /** How high a tower's muzzle stands, for beams and shells to leave from. */
190
+ export const MUZZLE_HEIGHT = 1.28;
191
+
192
+ export interface ITowerModel {
193
+ readonly group: Group;
194
+ /** Turns to face a target; its local +z is the way it shoots. */
195
+ readonly head: Group;
196
+ /** Where a shot leaves, in the head's own space. */
197
+ readonly muzzle: Vector3;
198
+ }
199
+
200
+ /** One tower of `kind` at `level`: MK.II adds a collar and side plates, MK.III a second collar. */
201
+ export function tower(kind: TowerKind, level: number): ITowerModel {
202
+ const accent = accentMaterial(kind);
203
+ const group = new Group();
204
+ group.add(
205
+ part(new CylinderGeometry(0.88, 1.0, 0.22, 8), darkMaterial, [0, 0.11, 0]),
206
+ part(new CylinderGeometry(0.5, 0.62, 0.7, 8), bodyMaterial, [0, 0.57, 0]),
207
+ );
208
+ for (const [x, z] of [
209
+ [-0.72, -0.72],
210
+ [0.72, -0.72],
211
+ [-0.72, 0.72],
212
+ [0.72, 0.72],
213
+ ] as const)
214
+ group.add(part(new BoxGeometry(0.2, 0.3, 0.2), metalMaterial, [x, 0.3, z]));
215
+ if (level >= 2) {
216
+ const collar = part(new TorusGeometry(0.55, 0.06, 6, 14), accent, [0, 0.86, 0]);
217
+ collar.rotation.x = Math.PI / 2;
218
+ group.add(
219
+ collar,
220
+ part(new BoxGeometry(0.14, 0.4, 0.5), metalMaterial, [-0.62, 0.55, 0]),
221
+ part(new BoxGeometry(0.14, 0.4, 0.5), metalMaterial, [0.62, 0.55, 0]),
222
+ );
223
+ }
224
+ if (level >= 3) {
225
+ const crown = part(new TorusGeometry(0.42, 0.05, 6, 14), accent, [0, 0.96, 0]);
226
+ crown.rotation.x = Math.PI / 2;
227
+ group.add(crown);
228
+ }
229
+ for (let pip = 0; pip < level; pip += 1)
230
+ group.add(
231
+ part(
232
+ new BoxGeometry(0.13, 0.13, 0.13),
233
+ padMarkMaterial,
234
+ [(pip - (level - 1) / 2) * 0.24, 0.2, 0.98],
235
+ {
236
+ cast: false,
237
+ },
238
+ ),
239
+ );
240
+
241
+ const head = new Group();
242
+ head.position.y = 1.05;
243
+ const muzzle = new Vector3(0, 0.2, 0.7);
244
+ if (kind === "sentry") {
245
+ head.add(
246
+ part(new BoxGeometry(0.62, 0.32, 0.72), accent, [0, 0.16, 0]),
247
+ part(new BoxGeometry(0.11, 0.11, 0.78), metalMaterial, [-0.15, 0.2, 0.62]),
248
+ part(new BoxGeometry(0.11, 0.11, 0.78), metalMaterial, [0.15, 0.2, 0.62]),
249
+ );
250
+ muzzle.set(0, 0.2, 1.05);
251
+ } else if (kind === "mortar") {
252
+ const barrel = part(new CylinderGeometry(0.2, 0.26, 0.95, 8), metalMaterial, [0, 0.35, 0.28]);
253
+ barrel.rotation.x = Math.PI / 2 - 0.95;
254
+ const lip = part(new CylinderGeometry(0.27, 0.27, 0.14, 8), accent, [0, 0.66, 0.6]);
255
+ lip.rotation.x = Math.PI / 2 - 0.95;
256
+ head.add(
257
+ part(new BoxGeometry(0.14, 0.5, 0.62), accent, [-0.3, 0.22, 0]),
258
+ part(new BoxGeometry(0.14, 0.5, 0.62), accent, [0.3, 0.22, 0]),
259
+ barrel,
260
+ lip,
261
+ );
262
+ muzzle.set(0, 0.7, 0.66);
263
+ } else if (kind === "arc") {
264
+ for (const [radius, y] of [
265
+ [0.36, 0.12],
266
+ [0.3, 0.32],
267
+ [0.24, 0.5],
268
+ ] as const) {
269
+ const ring = part(new TorusGeometry(radius, 0.055, 6, 14), accent, [0, y, 0]);
270
+ ring.rotation.x = Math.PI / 2;
271
+ head.add(ring);
272
+ }
273
+ const orb = part(
274
+ new IcosahedronGeometry(0.2, 0),
275
+ glowMaterial(palette.towers.arc),
276
+ [0, 0.78, 0],
277
+ {
278
+ cast: false,
279
+ },
280
+ );
281
+ orb.name = "orb";
282
+ head.add(part(new CylinderGeometry(0.1, 0.1, 0.7, 6), metalMaterial, [0, 0.35, 0]), orb);
283
+ muzzle.set(0, 0.78, 0);
284
+ } else {
285
+ head.add(
286
+ part(new CylinderGeometry(0.19, 0.19, 0.72, 8), accent, [-0.22, 0.34, 0]),
287
+ part(new CylinderGeometry(0.19, 0.19, 0.72, 8), accent, [0.22, 0.34, 0]),
288
+ part(new BoxGeometry(0.62, 0.12, 0.34), metalMaterial, [0, 0.72, 0]),
289
+ );
290
+ const nozzle = part(new ConeGeometry(0.16, 0.42, 8), metalMaterial, [0, 0.42, 0.42]);
291
+ nozzle.rotation.x = Math.PI / 2;
292
+ head.add(nozzle);
293
+ muzzle.set(0, 0.42, 0.66);
294
+ }
295
+ group.add(head);
296
+ return { group, head, muzzle };
297
+ }
298
+
299
+ export interface IEnemyModel {
300
+ readonly group: Group;
301
+ /** The walking parts, swung against each other while it moves. Empty for tracked hulls. */
302
+ readonly legs: readonly Mesh[];
303
+ }
304
+
305
+ /** An enemy of `kind`, one metre-ish tall before the game scales it by its definition. */
306
+ export function enemy(kind: EnemyKind): IEnemyModel {
307
+ const shell = enemyMaterial(kind);
308
+ const group = new Group();
309
+ const legs: Mesh[] = [];
310
+ if (kind === "skitter" || kind === "runner") {
311
+ group.add(
312
+ part(new IcosahedronGeometry(0.4, 0), shell, [0, 0.55, 0]),
313
+ part(new BoxGeometry(0.62, 0.16, 0.72), darkMaterial, [0, 0.8, 0]),
314
+ part(new IcosahedronGeometry(0.09, 0), glowMaterial(palette.enemies[kind]), [0, 0.6, 0.42], {
315
+ cast: false,
316
+ }),
317
+ );
318
+ for (const [x, z] of [
319
+ [-0.3, -0.24],
320
+ [0.3, -0.24],
321
+ [-0.3, 0.24],
322
+ [0.3, 0.24],
323
+ ] as const) {
324
+ const leg = part(new BoxGeometry(0.1, 0.5, 0.1), blackMaterial, [x, 0.25, z]);
325
+ legs.push(leg);
326
+ group.add(leg);
327
+ }
328
+ } else {
329
+ group.add(
330
+ part(new BoxGeometry(1.0, 0.42, 1.4), shell, [0, 0.4, 0]),
331
+ part(new BoxGeometry(0.26, 0.36, 1.5), blackMaterial, [-0.62, 0.3, 0]),
332
+ part(new BoxGeometry(0.26, 0.36, 1.5), blackMaterial, [0.62, 0.3, 0]),
333
+ part(new CylinderGeometry(0.4, 0.46, 0.3, 8), darkMaterial, [0, 0.76, -0.05]),
334
+ part(new BoxGeometry(0.16, 0.16, 0.8), metalMaterial, [0, 0.8, 0.55]),
335
+ );
336
+ if (kind === "titan") {
337
+ group.add(
338
+ part(new BoxGeometry(0.14, 0.14, 0.7), metalMaterial, [-0.3, 0.86, 0.5]),
339
+ part(new BoxGeometry(0.14, 0.14, 0.7), metalMaterial, [0.3, 0.86, 0.5]),
340
+ part(
341
+ new IcosahedronGeometry(0.28, 0),
342
+ glowMaterial(palette.enemies.titan),
343
+ [0, 1.1, -0.1],
344
+ {
345
+ cast: false,
346
+ },
347
+ ),
348
+ );
349
+ }
350
+ }
351
+ return { group, legs };
352
+ }
353
+
354
+ /** The thing being defended: a stepped plinth, four arms with cold tips, and a spinning core. */
355
+ export function reactor(): Group {
356
+ const group = new Group();
357
+ group.name = "reactor";
358
+ group.add(
359
+ part(new CylinderGeometry(1.7, 1.9, 0.3, 10), darkMaterial, [0, 0.15, 0]),
360
+ part(new CylinderGeometry(1.35, 1.5, 0.28, 10), metalMaterial, [0, 0.44, 0]),
361
+ part(new CylinderGeometry(0.5, 0.7, 0.9, 8), bodyMaterial, [0, 1.0, 0]),
362
+ );
363
+ for (let arm = 0; arm < 4; arm += 1) {
364
+ const angle = (arm / 4) * Math.PI * 2 + Math.PI / 4;
365
+ const x = Math.cos(angle) * 1.05;
366
+ const z = Math.sin(angle) * 1.05;
367
+ const pylon = part(new BoxGeometry(0.2, 1.3, 0.2), darkMaterial, [x, 0.9, z]);
368
+ pylon.rotation.y = -angle;
369
+ group.add(
370
+ pylon,
371
+ part(
372
+ new IcosahedronGeometry(0.15, 0),
373
+ glowMaterial(palette.model.reactorGlow),
374
+ [x, 1.62, z],
375
+ {
376
+ cast: false,
377
+ },
378
+ ),
379
+ );
380
+ }
381
+ const core = part(new IcosahedronGeometry(0.55, 1), reactorMaterial, [0, 1.95, 0], {
382
+ cast: false,
383
+ });
384
+ core.name = "core";
385
+ const ring = part(
386
+ new TorusGeometry(0.85, 0.05, 6, 24),
387
+ glowMaterial(palette.model.reactorGlow, 0.9),
388
+ [0, 1.95, 0],
389
+ {
390
+ cast: false,
391
+ },
392
+ );
393
+ ring.name = "ring";
394
+ ring.rotation.x = Math.PI / 2.4;
395
+ const light = new PointLight(palette.model.reactor, 8, 14, 1.6);
396
+ light.position.set(0, 2.1, 0);
397
+ group.add(core, ring, light);
398
+ return group;
399
+ }
400
+
401
+ /** Seeded, so the same forest grows on every machine. Same generator Bastion used. */
402
+ export function lcg(seed: number): () => number {
403
+ let state = seed >>> 0;
404
+ return () => {
405
+ state = (Math.imul(state, 1664525) + 1013904223) >>> 0;
406
+ return state / 4294967296;
407
+ };
408
+ }
409
+
410
+ function scatter(
411
+ geometry: BufferGeometry,
412
+ material: Material,
413
+ placements: readonly { x: number; y: number; z: number; scale: number; turn: number }[],
414
+ ): InstancedMesh {
415
+ const mesh = new InstancedMesh(geometry, material, placements.length);
416
+ const matrix = new Matrix4();
417
+ const rotation = new Quaternion();
418
+ const up = new Vector3(0, 1, 0);
419
+ for (const [index, place] of placements.entries()) {
420
+ rotation.setFromAxisAngle(up, place.turn);
421
+ matrix.compose(
422
+ new Vector3(place.x, place.y, place.z),
423
+ rotation,
424
+ new Vector3(place.scale, place.scale, place.scale),
425
+ );
426
+ mesh.setMatrixAt(index, matrix);
427
+ }
428
+ mesh.castShadow = true;
429
+ mesh.receiveShadow = true;
430
+ return mesh;
431
+ }
432
+
433
+ /**
434
+ * Pines, rocks and shrubs on the slab, kept off the road and the pads. Three instanced draws for
435
+ * a hundred and thirty trees: decoration must cost the frame nothing.
436
+ */
437
+ export function decor(
438
+ keepClear: readonly (readonly [number, number, number])[],
439
+ seed = 47021,
440
+ count = 130,
441
+ ): Group {
442
+ const random = lcg(seed);
443
+ const group = new Group();
444
+ group.name = "decor";
445
+ const trees: { x: number; y: number; z: number; scale: number; turn: number }[] = [];
446
+ const rocks: typeof trees = [];
447
+ const shrubs: typeof trees = [];
448
+ let attempts = 0;
449
+ while (trees.length + rocks.length + shrubs.length < count && attempts < count * 40) {
450
+ attempts += 1;
451
+ const x = (random() * 2 - 1) * 18.4;
452
+ const z = (random() * 2 - 1) * 12.1;
453
+ const kind = random();
454
+ const scale = 0.55 + random() * 0.55;
455
+ // A ring of forest around the arena, and only the odd tree inside it: the board is for playing.
456
+ const edge = Math.max(Math.abs(x) / 18.4, Math.abs(z) / 12.1);
457
+ if (edge < 0.78 && random() > 0.06) continue;
458
+ const clear = keepClear.every(([cx, cz, radius]) => Math.hypot(x - cx, z - cz) > radius);
459
+ if (!clear) continue;
460
+ const place = { scale, turn: random() * Math.PI * 2, x, y: 0, z };
461
+ if (kind < 0.72) trees.push(place);
462
+ else if (kind < 0.88) rocks.push({ ...place, scale: scale * 0.7 });
463
+ else shrubs.push({ ...place, scale: scale * 0.8 });
464
+ }
465
+ const pines = scatter(new ConeGeometry(0.72, 1.7, 7).translate(0, 1.25, 0), pineMaterial, trees);
466
+ const crowns = scatter(
467
+ new ConeGeometry(0.5, 1.2, 7).translate(0, 2.05, 0),
468
+ pineDarkMaterial,
469
+ trees,
470
+ );
471
+ const trunks = scatter(
472
+ new CylinderGeometry(0.1, 0.14, 0.5, 6).translate(0, 0.25, 0),
473
+ trunkMaterial,
474
+ trees,
475
+ );
476
+ group.add(
477
+ pines,
478
+ crowns,
479
+ trunks,
480
+ scatter(new IcosahedronGeometry(0.5, 0).translate(0, 0.2, 0), rockMaterial, rocks),
481
+ scatter(new IcosahedronGeometry(0.34, 0).translate(0, 0.16, 0), shrubMaterial, shrubs),
482
+ );
483
+ return group;
484
+ }
485
+
486
+ /** The outline of a range circle: thin, whatever the radius. */
487
+ export function rangeGeometry(radius: number): RingGeometry {
488
+ return new RingGeometry(Math.max(0.01, radius - 0.07), Math.max(0.02, radius), 72).rotateX(
489
+ -Math.PI / 2,
490
+ );
491
+ }
492
+
493
+ /** A flat ring on the ground: a tower's range while it is hovered or selected. */
494
+ export function rangeRing(radius: number): Mesh {
495
+ const ring = new Mesh(rangeGeometry(radius), glowMaterial(palette.accent, 0.55));
496
+ ring.position.y = 0.09;
497
+ ring.renderOrder = 2;
498
+ return ring;
499
+ }
500
+
501
+ /** A see-through tower for the placement preview. */
502
+ export function ghostTower(kind: TowerKind): Group {
503
+ const { group } = tower(kind, 1);
504
+ const material = new MeshBasicMaterial({
505
+ color: palette.towers[kind],
506
+ depthWrite: false,
507
+ opacity: 0.4,
508
+ toneMapped: false,
509
+ transparent: true,
510
+ });
511
+ group.traverse((object: Object3D) => {
512
+ if (object instanceof Mesh) {
513
+ object.material = material;
514
+ object.castShadow = false;
515
+ object.receiveShadow = false;
516
+ }
517
+ });
518
+ return group;
519
+ }
520
+
521
+ export interface IHealthBar {
522
+ readonly group: Group;
523
+ readonly fill: Mesh;
524
+ readonly fillMaterial: MeshBasicMaterial;
525
+ }
526
+
527
+ /** A health bar that faces the camera: an empty track and a fill scaled from its left edge. */
528
+ export function healthBar(width: number): IHealthBar {
529
+ const group = new Group();
530
+ const track = new Mesh(
531
+ new PlaneGeometry(width + 0.08, 0.2),
532
+ new MeshBasicMaterial({
533
+ color: palette.effects.barEmpty,
534
+ depthWrite: false,
535
+ opacity: 0.8,
536
+ transparent: true,
537
+ }),
538
+ );
539
+ const fillMaterial = new MeshBasicMaterial({
540
+ color: palette.effects.barFull,
541
+ depthWrite: false,
542
+ toneMapped: false,
543
+ });
544
+ const fill = new Mesh(new PlaneGeometry(width, 0.13).translate(width / 2, 0, 0), fillMaterial);
545
+ fill.position.set(-width / 2, 0, 0.005);
546
+ track.renderOrder = 3;
547
+ fill.renderOrder = 4;
548
+ group.add(track, fill);
549
+ return { fill, fillMaterial, group };
550
+ }
@@ -0,0 +1,27 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The sky photograph (`assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)" by Greg
4
+ // Zaal and Jarod Guest, CC0) is the *environment* here, not the backdrop: it lights and reflects, and
5
+ // the diorama floats in a dark green void, so a photographed cloud never competes with the board.
6
+ // Swap the file for any equirectangular image, or delete the environment line for a fully lit-by-lamps look.
7
+ import {
8
+ Color,
9
+ EquirectangularReflectionMapping,
10
+ Fog,
11
+ SRGBColorSpace,
12
+ type Scene,
13
+ type Texture,
14
+ } from "three";
15
+ import { palette } from "./palette.js";
16
+
17
+ /** How much of the sky's light reaches the board. The JPEG holds radiance x 0.4, so 1 is dim. */
18
+ const ENVIRONMENT = 1;
19
+
20
+ export function setupSky(scene: Scene, sky: Texture): void {
21
+ sky.mapping = EquirectangularReflectionMapping;
22
+ sky.colorSpace = SRGBColorSpace;
23
+ scene.background = new Color(palette.world.void);
24
+ scene.environment = sky;
25
+ scene.environmentIntensity = ENVIRONMENT;
26
+ scene.fog = new Fog(palette.world.void, 62, 130);
27
+ }