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,164 +0,0 @@
1
- {
2
- "name": "weapon-cycle",
3
- "target": "web",
4
- "schemaVersion": 1,
5
- "viewport": {
6
- "width": 1280,
7
- "height": 720
8
- },
9
- "warmupFrames": 30,
10
- "subject": "player",
11
- "steps": [
12
- {
13
- "kind": "wait",
14
- "label": "loaded",
15
- "waitTicks": 4,
16
- "release": true
17
- },
18
- {
19
- "kind": "input",
20
- "label": "hold-trigger",
21
- "press": "KeyF",
22
- "holdTicks": 61,
23
- "release": true
24
- },
25
- {
26
- "kind": "wait",
27
- "label": "burst-settled",
28
- "waitTicks": 6,
29
- "release": true,
30
- "screenshot": "hip-fire"
31
- },
32
- {
33
- "kind": "input",
34
- "label": "reload",
35
- "press": "KeyR",
36
- "holdTicks": 2,
37
- "release": true
38
- },
39
- {
40
- "kind": "wait",
41
- "label": "reloading",
42
- "waitTicks": 20,
43
- "release": true
44
- },
45
- {
46
- "kind": "wait",
47
- "label": "reloaded",
48
- "waitTicks": 60,
49
- "release": true
50
- },
51
- {
52
- "kind": "input",
53
- "label": "aim",
54
- "press": "KeyQ",
55
- "holdTicks": 40,
56
- "release": false
57
- },
58
- {
59
- "kind": "wait",
60
- "label": "aimed",
61
- "waitTicks": 12,
62
- "release": true
63
- }
64
- ],
65
- "assert": {
66
- "diagnostics": {
67
- "noNetworkErrors": true,
68
- "noRuntimeDiagnostics": false,
69
- "runtimeDiagnosticsOptOutReason": "Headless Linux Chromium emits the known WebGPU buffer diagnostic; the weapon-state assertions remain authoritative.",
70
- "runtimeReady": true
71
- },
72
- "resources": [
73
- {
74
- "id": "state",
75
- "path": "ammo",
76
- "atSteps": [
77
- {
78
- "label": "reloaded",
79
- "equals": 30
80
- }
81
- ]
82
- },
83
- {
84
- "id": "state",
85
- "path": "reserve",
86
- "lte": 115,
87
- "changed": true
88
- },
89
- {
90
- "id": "state",
91
- "path": "reloading",
92
- "atSteps": [
93
- {
94
- "label": "reloading",
95
- "equals": 1
96
- },
97
- {
98
- "label": "reloaded",
99
- "equals": 0
100
- }
101
- ]
102
- },
103
- {
104
- "id": "state",
105
- "path": "aiming",
106
- "atSteps": [
107
- {
108
- "label": "aimed",
109
- "equals": 1
110
- }
111
- ]
112
- }
113
- ],
114
- "components": [
115
- {
116
- "entity": "player",
117
- "component": "aiming",
118
- "atSteps": [
119
- {
120
- "label": "aimed",
121
- "equals": 1
122
- }
123
- ]
124
- },
125
- {
126
- "entity": "player",
127
- "component": "fov",
128
- "lte": 45,
129
- "changed": true
130
- },
131
- {
132
- "entity": "decals",
133
- "component": "placed",
134
- "gte": 1,
135
- "changed": true
136
- },
137
- {
138
- "entity": "viewmodel",
139
- "component": "flashOpacity",
140
- "lte": 0.01,
141
- "allowTrivial": "The cone is dark before the first round and dark again once it retires; this row exists to catch the flash that never retires, and the fired signals prove rounds were sent."
142
- }
143
- ],
144
- "signals": [
145
- {
146
- "name": "fired",
147
- "entity": "player",
148
- "minCount": 5,
149
- "atStep": "hold-trigger"
150
- },
151
- {
152
- "name": "reload-started",
153
- "entity": "player",
154
- "minCount": 1,
155
- "atStep": "reload"
156
- },
157
- {
158
- "name": "reloaded",
159
- "entity": "player",
160
- "minCount": 1
161
- }
162
- ]
163
- }
164
- }
@@ -1,40 +0,0 @@
1
- import type { IPhysicsContext } from "@threenative/physics";
2
- import { CollisionShape3D } from "@threenative/physics";
3
- import type { Vector3 } from "three";
4
- import { HOSTILE_LAYER } from "../entities/Player.js";
5
- import type { Target } from "../entities/Target.js";
6
-
7
- export function applyDirectDamage(
8
- targets: ReadonlyMap<number, Target>,
9
- bodyId: number,
10
- amount: number,
11
- ): boolean {
12
- const target = targets.get(bodyId);
13
- return target?.takeDamage(amount) ?? false;
14
- }
15
-
16
- export function applyRadiusDamage(
17
- physics: IPhysicsContext,
18
- centre: Vector3,
19
- radius: number,
20
- amount: number,
21
- targets: ReadonlyMap<number, Target>,
22
- ): Set<number> {
23
- const hits = physics.directSpaceState.intersectShape({
24
- collisionMask: HOSTILE_LAYER,
25
- maxResults: 16,
26
- position: centre,
27
- shape: CollisionShape3D.sphere(radius),
28
- });
29
- const defeated = new Set<number>();
30
- for (const hit of hits) {
31
- const target = targets.get(hit.body.id);
32
- if (target === undefined || !target.alive) continue;
33
- // Candidate discovery is the physics query. This single falloff calculation is the weapon's
34
- // design, not a JavaScript distance scan over the level.
35
- const distance = target.mesh.position.distanceTo(centre);
36
- const falloff = Math.max(0, 1 - distance / radius);
37
- if (target.takeDamage(amount * Math.max(0.25, falloff))) defeated.add(hit.body.id);
38
- }
39
- return defeated;
40
- }
@@ -1,51 +0,0 @@
1
- import { GroundSnap, attachToBone, normaliseToMetres, skeletonBones } from "@threenative/core";
2
- import { Bone, type Group } from "three";
3
- import { scale } from "./render/scale.js";
4
-
5
- export interface IShooterConventions {
6
- readonly applyGrounding: (surfaceY: number, dt: number) => void;
7
- readonly attachedBone: string;
8
- readonly boneNames: readonly string[];
9
- readonly groundSnap: GroundSnap;
10
- readonly normaliseFactor: number;
11
- }
12
-
13
- /**
14
- * The three conventions this kit turns on, in one place.
15
- *
16
- * - `normaliseToMetres` sizes the carbine. The viewmodel is authored at whatever size was
17
- * convenient to lay out; the metre table in `render/scale.ts` decides what it actually is, so a
18
- * replacement model dropped in from an asset site lands at the same size without a magic number
19
- * beside it.
20
- * - `attachToBone` puts the weapon in the hand that holds it. The hand is a real `Bone`, so
21
- * swapping the procedural arms for a rigged pair keeps the same call.
22
- * - `GroundSnap` keeps the boots on the floor. In first person you only see them when you look
23
- * down, which is exactly when a hovering foot is obvious.
24
- *
25
- * Every one of them reports honestly when overridden: `groundSnap.enabled = false` keeps measuring
26
- * and keeps `clearance` truthful.
27
- */
28
- export function preparePlayerConventions(viewmodel: Group, legs: Group): IShooterConventions {
29
- const weapon = viewmodel.getObjectByName("held-rifle");
30
- if (weapon === undefined) throw new Error("Shooter viewmodel is missing its held rifle.");
31
-
32
- const normaliseFactor = normaliseToMetres(weapon, { axis: "longest", metres: scale.rifleLength });
33
- const hand = new Bone();
34
- hand.name = "RightHand";
35
- hand.position.copy(weapon.position);
36
- hand.rotation.copy(weapon.rotation);
37
- viewmodel.add(hand);
38
- weapon.position.set(0, 0, 0);
39
- weapon.rotation.set(0, 0, 0);
40
-
41
- const boneNames = skeletonBones(viewmodel);
42
- attachToBone(viewmodel, "RightHand", weapon);
43
- const groundSnap = new GroundSnap(legs);
44
- return {
45
- applyGrounding: (surfaceY, dt) => groundSnap.apply(legs, surfaceY, dt),
46
- attachedBone: weapon.parent?.name ?? "",
47
- boneNames,
48
- groundSnap,
49
- normaliseFactor,
50
- };
51
- }
@@ -1,70 +0,0 @@
1
- import type { ICtx } from "@threenative/core";
2
- import { Area3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
- import type { Group, Vector3 } from "three";
4
- import { createPickupVisual } from "../render/shapes.js";
5
- import type { GameState } from "../state.js";
6
- import { PLAYER_LAYER } from "./Player.js";
7
-
8
- type GameCtx = ICtx<GameState, IPhysicsContext>;
9
-
10
- export class Pickup {
11
- readonly mesh: Group;
12
- readonly area: Area3D;
13
- readonly tags = ["pickup", "health"];
14
- collected = false;
15
- #base: Vector3;
16
- #time = 0;
17
- #unsubscribe: () => void;
18
- #onCollect: () => void;
19
-
20
- constructor(
21
- ctx: GameCtx,
22
- materials: Parameters<typeof createPickupVisual>[0],
23
- position: Vector3,
24
- playerBodyId: number,
25
- onCollect: () => void,
26
- ) {
27
- this.#base = position.clone();
28
- this.#onCollect = onCollect;
29
- this.mesh = createPickupVisual(materials);
30
- this.mesh.position.copy(position);
31
- ctx.add(this.mesh);
32
- this.area = new Area3D({
33
- collisionMask: PLAYER_LAYER,
34
- entity: "health-pickup",
35
- physics: ctx.physics,
36
- position,
37
- shape: CollisionShape3D.sphere(0.25),
38
- });
39
- this.#unsubscribe = this.area.on("bodyEntered", (body) => {
40
- if (this.collected || body.body.id !== playerBodyId) return;
41
- this.collected = true;
42
- this.mesh.visible = false;
43
- this.area.monitoring = false;
44
- this.#onCollect();
45
- });
46
- }
47
-
48
- update(dt: number): void {
49
- if (this.collected) return;
50
- this.#time += dt;
51
- this.mesh.rotation.y += dt * 2.6;
52
- this.mesh.position.y = this.#base.y + Math.sin(this.#time * 3) * 0.12;
53
- }
54
-
55
- respawn(): void {
56
- this.collected = false;
57
- this.mesh.visible = true;
58
- this.area.monitoring = true;
59
- }
60
-
61
- debug(): Record<string, unknown> {
62
- return { collected: this.collected, position: this.mesh.position.toArray() };
63
- }
64
-
65
- dispose(): void {
66
- this.#unsubscribe();
67
- this.area.dispose();
68
- this.mesh.removeFromParent();
69
- }
70
- }
@@ -1,310 +0,0 @@
1
- import type { ICtx } from "@threenative/core";
2
- import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
- import { Group, MathUtils, type PerspectiveCamera, Vector3 } from "three";
4
- import { type IShooterConventions, preparePlayerConventions } from "../conventions.js";
5
- import { scale } from "../render/scale.js";
6
- import { createLegsVisual, createViewmodelVisual } from "../render/shapes.js";
7
- import type { ITouchInput } from "../render/touch-controls.js";
8
- import type { GameState } from "../state.js";
9
-
10
- export const WORLD_LAYER = 1;
11
- export const PLAYER_LAYER = 2;
12
- export const HOSTILE_LAYER = 4;
13
- export const FRIENDLY_LAYER = 8;
14
- export const PROJECTILE_LAYER = 16;
15
-
16
- type GameCtx = ICtx<GameState, IPhysicsContext>;
17
-
18
- const BODY_Y = scale.humanHeight / 2;
19
- const SPAWN = new Vector3(0, BODY_Y, 5);
20
- const WALK_SPEED = 4.2;
21
- const SPRINT_SPEED = 6.6;
22
- /** Crouched movement. A crouch that only lowers the eye is a camera trick, not a stance. */
23
- const CROUCH_SPEED = 2.2;
24
- /** How fast the stance folds and unfolds. Fast enough to peek with, slow enough to see. */
25
- const CROUCH_RATE = 11;
26
- const FOV_HIP = 72;
27
- const FOV_AIM = 34;
28
- const PITCH_MIN = MathUtils.degToRad(-72);
29
- const PITCH_MAX = MathUtils.degToRad(72);
30
- /** Relative pointer pixels to radians. The delta is already per-frame, so nothing scales by dt. */
31
- const LOOK_RADIANS_PER_PIXEL = 0.005;
32
- /** Down the sights the same hand movement should cover less angle. */
33
- const AIM_SENSITIVITY = 0.5;
34
- const CAPSULE_RADIUS = scale.shoulderWidth / 2;
35
- const CAPSULE_HALF = (scale.humanHeight - CAPSULE_RADIUS * 2) / 2;
36
- /** Metres of stride between planted feet, walking. Sprint covers it sooner, so it sounds faster. */
37
- const STRIDE_METRES = 0.82;
38
-
39
- /**
40
- * Yaw and pitch, integrated from the `look` action.
41
- *
42
- * `look` is bound `pointerRelative`, so `ctx.input.vector("look")` is the pointer delta for this
43
- * tick in canvas pixels. The framework owns the pointer lock and the native equivalent, so nothing
44
- * in this game reads `movementX` or touches the DOM.
45
- */
46
- class Look {
47
- yaw = 0;
48
- pitch = 0;
49
-
50
- /** Applied by both paths: mouse deltas and the right thumb, which has no lock to earn. */
51
- applyDelta(dx: number, dy: number, sensitivity: number): void {
52
- if (dx === 0 && dy === 0) return;
53
- this.yaw -= dx * LOOK_RADIANS_PER_PIXEL * sensitivity;
54
- this.pitch = MathUtils.clamp(
55
- this.pitch - dy * LOOK_RADIANS_PER_PIXEL * sensitivity,
56
- PITCH_MIN,
57
- PITCH_MAX,
58
- );
59
- }
60
- }
61
-
62
- /**
63
- * The player, seen from behind their own eyes.
64
- *
65
- * The body is a capsule the physics solver owns; the camera is placed from it once the solver has
66
- * written the step (see `syncCamera` and the `afterPhysics` call in `scenes/Play.ts`). The
67
- * viewmodel hangs off the camera, so the weapon is always in frame no matter how the body is
68
- * being shoved around.
69
- */
70
- export class Player {
71
- readonly mesh: Group;
72
- /** The weapon and hands, parented to the camera. */
73
- readonly visual: Group;
74
- /** The part of the player their own eyes can see, parented to the body. */
75
- readonly legs: Group;
76
- readonly body: CharacterBody3D;
77
- readonly look = new Look();
78
- readonly maxHealth = 100;
79
- health = 100;
80
- dead = false;
81
- aiming = false;
82
- crouching = false;
83
- sprinting = false;
84
- /** Metres walked. The scene does not read it; a scenario can, through `debug()`. */
85
- distanceMoved = 0;
86
- /** Fired each time a stride completes, so footsteps keep pace with speed rather than time. */
87
- onFootstep: ((sprinting: boolean) => void) | undefined;
88
- #onDamage: (amount: number) => void;
89
- #onDeath: () => void;
90
- #conventions: IShooterConventions;
91
- #camera: PerspectiveCamera;
92
- /** 0 standing, 1 fully folded. Eased, so the eye slides rather than teleports. */
93
- #crouch = 0;
94
- #fov = FOV_HIP;
95
- #lastX = SPAWN.x;
96
- #lastZ = SPAWN.z;
97
- #strideAccumulated = 0;
98
- #moving = 0;
99
-
100
- constructor(
101
- ctx: GameCtx,
102
- camera: PerspectiveCamera,
103
- materials: Parameters<typeof createViewmodelVisual>[0],
104
- spawn: Vector3 = SPAWN,
105
- onDamage: (amount: number) => void = () => undefined,
106
- onDeath: () => void = () => undefined,
107
- ) {
108
- this.#camera = camera;
109
- this.#onDamage = onDamage;
110
- this.#onDeath = onDeath;
111
- this.mesh = new Group();
112
- this.mesh.name = "player";
113
- this.mesh.position.copy(spawn);
114
- ctx.add(this.mesh);
115
- // Two visuals, in two spaces. The viewmodel hangs off the camera so the weapon is always in
116
- // frame; the legs hang off the body so looking down shows a person standing on the floor
117
- // rather than a floating gun.
118
- this.visual = createViewmodelVisual(materials);
119
- camera.add(this.visual);
120
- this.legs = createLegsVisual(materials);
121
- this.mesh.add(this.legs);
122
- this.#conventions = preparePlayerConventions(this.visual, this.legs);
123
- this.body = new CharacterBody3D({
124
- collisionLayer: PLAYER_LAYER,
125
- collisionMask: WORLD_LAYER | HOSTILE_LAYER,
126
- autostep: { maxHeight: 0.35, minWidth: 0.18 },
127
- object: this.mesh,
128
- physics: ctx.physics,
129
- shape: CollisionShape3D.capsule(CAPSULE_RADIUS, CAPSULE_HALF),
130
- });
131
- camera.fov = FOV_HIP;
132
- camera.near = 0.02;
133
- camera.far = 120;
134
- camera.updateProjectionMatrix();
135
- this.syncCamera();
136
- }
137
-
138
- /** Where the eye is right now, crouch included. */
139
- get eyeHeight(): number {
140
- return scale.eyeHeight - BODY_Y - this.#crouch * scale.crouchDrop;
141
- }
142
-
143
- /**
144
- * Heading, in degrees turned to the right of the spawn facing.
145
- *
146
- * Reported rather than `look.yaw` itself because the two have opposite signs: Three turns left
147
- * for a positive rotation about +y, and a player who moved the mouse right expects a positive
148
- * number back. The HUD and the scenarios read this one.
149
- */
150
- get yawDegrees(): number {
151
- return -MathUtils.radToDeg(this.look.yaw);
152
- }
153
-
154
- /** Elevation, in degrees above the horizon. Positive is up, matching the same expectation. */
155
- get pitchDegrees(): number {
156
- return MathUtils.radToDeg(this.look.pitch);
157
- }
158
-
159
- /** How hard the player is moving, 0 to 1. The viewmodel reads this for its bob. */
160
- get moving(): number {
161
- return this.#moving;
162
- }
163
-
164
- /**
165
- * The camera basis is the single source of aim truth.
166
- *
167
- * Every shot starts here rather than from a muzzle offset, because the crosshair is drawn at the
168
- * centre of this basis: a round that starts anywhere else lands somewhere the player did not aim.
169
- * The viewmodel's barrel is then converged onto this ray, not the other way round.
170
- */
171
- aimRay(): { origin: Vector3; direction: Vector3 } {
172
- this.#camera.updateMatrixWorld(true);
173
- return {
174
- origin: this.#camera.getWorldPosition(new Vector3()),
175
- direction: this.#camera.getWorldDirection(new Vector3()).normalize(),
176
- };
177
- }
178
-
179
- /**
180
- * Place the camera at the eye.
181
- *
182
- * Called from `afterPhysics`, never from `update`: `moveAndSlide` only queues the motion, and the
183
- * rapier plugin writes the solved transform after the frame callback returns. Reading
184
- * `mesh.position` inside `update` places the eye one physics step behind the body — invisible on
185
- * flat ground and a third of a metre low on a step, which is how a shot aimed at a target ends
186
- * up in the floor underfoot.
187
- */
188
- syncCamera(): void {
189
- this.#camera.position.set(
190
- this.mesh.position.x,
191
- this.mesh.position.y + this.eyeHeight,
192
- this.mesh.position.z,
193
- );
194
- this.#camera.rotation.set(this.look.pitch, this.look.yaw, 0, "YXZ");
195
- }
196
-
197
- update(ctx: GameCtx, dt: number, touch?: ITouchInput): void {
198
- if (this.dead) return;
199
- this.aiming = ctx.input.pressed("aim") || touch?.aimPressed === true;
200
- this.crouching = ctx.input.pressed("crouch") || touch?.crouchPressed === true;
201
- this.#crouch = MathUtils.damp(this.#crouch, this.crouching ? 1 : 0, CROUCH_RATE, dt);
202
-
203
- const sensitivity = this.aiming ? AIM_SENSITIVITY : 1;
204
- const look = ctx.input.vector("look");
205
- this.look.applyDelta(look.x, look.y, sensitivity);
206
- if (touch !== undefined) this.look.applyDelta(touch.aim.x * 12, touch.aim.y * 12, sensitivity);
207
-
208
- const keyboard = ctx.input.vector("move");
209
- const moveX = MathUtils.clamp(keyboard.x + (touch?.move.x ?? 0), -1, 1);
210
- const moveY = MathUtils.clamp(keyboard.y + (touch?.move.y ?? 0), -1, 1);
211
- // Sprint arrives as its own flag rather than as a longer move vector, so the two vetoes below
212
- // apply to a thumb and to Shift alike. Crouch wins: holding both should not sprint at a
213
- // crouch-walk's silhouette.
214
- const sprintAsked = ctx.input.pressed("sprint") || touch?.sprintPressed === true;
215
- this.sprinting = sprintAsked && !this.aiming && !this.crouching;
216
- const speed = this.crouching ? CROUCH_SPEED : this.sprinting ? SPRINT_SPEED : WALK_SPEED;
217
-
218
- // `vector().y` is +up on the stick; forward on this ground plane is -z at yaw 0.
219
- const forwardX = -Math.sin(this.look.yaw);
220
- const forwardZ = -Math.cos(this.look.yaw);
221
- const rightX = Math.cos(this.look.yaw);
222
- const rightZ = -Math.sin(this.look.yaw);
223
- let vx = forwardX * moveY + rightX * moveX;
224
- let vz = forwardZ * moveY + rightZ * moveX;
225
- const length = Math.hypot(vx, vz);
226
- if (length > 1e-4) {
227
- vx = (vx / length) * speed;
228
- vz = (vz / length) * speed;
229
- } else {
230
- vx = 0;
231
- vz = 0;
232
- }
233
- this.#moving = length > 1e-4 ? speed / SPRINT_SPEED : 0;
234
-
235
- // The backend writes the solved transform after the step, so measuring the mesh either side of
236
- // `moveAndSlide` in one frame always reads zero. Compare against the previous frame instead.
237
- const stride = Math.hypot(
238
- this.mesh.position.x - this.#lastX,
239
- this.mesh.position.z - this.#lastZ,
240
- );
241
- this.distanceMoved += stride;
242
- this.#strideAccumulated += stride;
243
- if (length > 1e-4 && this.#strideAccumulated >= STRIDE_METRES) {
244
- this.#strideAccumulated = 0;
245
- this.onFootstep?.(this.sprinting);
246
- }
247
- this.#lastX = this.mesh.position.x;
248
- this.#lastZ = this.mesh.position.z;
249
-
250
- this.body.velocity.x = vx;
251
- this.body.velocity.z = vz;
252
- this.body.moveAndSlide(dt);
253
- this.#conventions.applyGrounding(0, dt);
254
-
255
- const wanted = this.aiming ? FOV_AIM : FOV_HIP;
256
- this.#fov = MathUtils.damp(this.#fov, wanted, 14, dt);
257
- if (Math.abs(this.#camera.fov - this.#fov) > 0.01) {
258
- this.#camera.fov = this.#fov;
259
- this.#camera.updateProjectionMatrix();
260
- }
261
- }
262
-
263
- takeDamage(amount: number): void {
264
- if (this.dead || !Number.isFinite(amount) || amount <= 0) return;
265
- this.health = Math.max(0, this.health - amount);
266
- this.#onDamage(amount);
267
- if (this.health > 0) return;
268
- this.dead = true;
269
- this.visual.visible = false;
270
- this.legs.visible = false;
271
- this.body.velocity.set(0, 0, 0);
272
- this.#onDeath();
273
- }
274
-
275
- respawn(spawn: Vector3): void {
276
- this.body.teleport(spawn);
277
- this.health = 40;
278
- this.dead = false;
279
- this.visual.visible = true;
280
- this.legs.visible = true;
281
- this.syncCamera();
282
- }
283
-
284
- debug(): Record<string, unknown> {
285
- return {
286
- aiming: this.aiming ? 1 : 0,
287
- crouching: this.crouching ? 1 : 0,
288
- dead: this.dead,
289
- distanceMoved: this.distanceMoved,
290
- fov: this.#camera.fov,
291
- groundClearance: this.#conventions.groundSnap.clearance,
292
- health: this.health,
293
- normaliseFactor: this.#conventions.normaliseFactor,
294
- pitchDegrees: this.pitchDegrees,
295
- position: this.mesh.position.toArray(),
296
- skeletonBones: this.#conventions.boneNames,
297
- weaponBone: this.#conventions.attachedBone,
298
- yawDegrees: this.yawDegrees,
299
- };
300
- }
301
-
302
- dispose(): void {
303
- this.body.dispose();
304
- this.visual.removeFromParent();
305
- this.legs.removeFromParent();
306
- this.mesh.removeFromParent();
307
- }
308
- }
309
-
310
- export { SPAWN };
@@ -1,28 +0,0 @@
1
- import type { Vector3 } from "three";
2
- import type { Target } from "../entities/Target.js";
3
-
4
- export class SpawnPoints {
5
- readonly points: readonly Vector3[];
6
-
7
- constructor(points: readonly Vector3[]) {
8
- if (points.length === 0) throw new Error("SpawnPoints requires at least one point.");
9
- this.points = points.map((point) => point.clone());
10
- }
11
-
12
- furthestFrom(hostiles: readonly Target[]): Vector3 {
13
- let best = this.points[0] as Vector3;
14
- let bestDistance = -1;
15
- for (const point of this.points) {
16
- let nearest = Number.POSITIVE_INFINITY;
17
- for (const hostile of hostiles) {
18
- if (!hostile.alive) continue;
19
- nearest = Math.min(nearest, point.distanceToSquared(hostile.mesh.position));
20
- }
21
- if (nearest > bestDistance) {
22
- best = point;
23
- bestDistance = nearest;
24
- }
25
- }
26
- return best.clone();
27
- }
28
- }
@@ -1,15 +0,0 @@
1
- type PlaytestEvent = {
2
- readonly [key: string]: string | number;
3
- readonly entity: string;
4
- readonly name: string;
5
- };
6
-
7
- const pendingEvents: PlaytestEvent[] = [];
8
-
9
- export function emitPlaytestEvent(event: PlaytestEvent): void {
10
- pendingEvents.push(event);
11
- }
12
-
13
- export function drainPlaytestEvents(): PlaytestEvent[] {
14
- return pendingEvents.splice(0);
15
- }