create-threenative 0.2.5 → 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 (631) hide show
  1. package/README.md +25 -3
  2. package/agent-docs/references/assertion-reference.md +40 -1
  3. package/agent-docs/references/build-profiles.md +126 -0
  4. package/agent-docs/references/capability-reference.md +1382 -65
  5. package/agent-docs/references/finding-assets.md +8 -1
  6. package/agent-docs/references/performance-basics.md +117 -0
  7. package/agent-docs/references/rigging-characters.md +51 -0
  8. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  9. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  10. package/agent-docs/references/visual-baseline.md +8 -4
  11. package/agent-docs/references/webview-ui.md +3 -2
  12. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  13. package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
  14. package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
  15. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  16. package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
  17. package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
  18. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  19. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  20. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  21. package/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
  22. package/agent-files/.claude/settings.json +38 -0
  23. package/agent-files/.codex/hooks.json +40 -0
  24. package/capabilities.json +1891 -101
  25. package/dist/index.d.ts +39 -1
  26. package/dist/index.js +480 -56
  27. package/dist/threenative.js +1247 -177
  28. package/package.json +6 -6
  29. package/template-assets/assets/mannequin-combat.glb +0 -0
  30. package/template-assets/assets/mannequin.glb +0 -0
  31. package/template-assets/assets/player-viewmodel.glb +0 -0
  32. package/template-assets/assets/sky.jpg +0 -0
  33. package/template-assets/clearwater/README.md +141 -0
  34. package/template-assets/clearwater/install.mjs +50 -0
  35. package/template-assets/clearwater/src/clearwater.ts +180 -0
  36. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  37. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  38. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  39. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  40. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  41. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  42. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  43. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  44. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  45. package/template-assets/patches/three@0.185.1.patch +2228 -105
  46. package/template-assets/worldEnvironment.ts +52 -1
  47. package/templates/action-rpg/AGENTS.md +43 -43
  48. package/templates/action-rpg/CLAUDE.md +43 -43
  49. package/templates/action-rpg/kit.json +1 -1
  50. package/templates/action-rpg/package.json +14 -8
  51. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  52. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  53. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  54. package/templates/action-rpg/src/conventions.ts +24 -18
  55. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  56. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  57. package/templates/action-rpg/src/entities/Player.ts +102 -32
  58. package/templates/action-rpg/src/game.ts +3 -3
  59. package/templates/action-rpg/src/render/camera.ts +18 -16
  60. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  61. package/templates/action-rpg/src/render/lighting.ts +45 -28
  62. package/templates/action-rpg/src/render/loading.ts +4 -4
  63. package/templates/action-rpg/src/render/materials.ts +191 -47
  64. package/templates/action-rpg/src/render/palette.ts +14 -13
  65. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  66. package/templates/action-rpg/src/render/props.ts +117 -0
  67. package/templates/action-rpg/src/render/quality.ts +40 -82
  68. package/templates/action-rpg/src/render/sky.ts +36 -13
  69. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  71. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  72. package/templates/action-rpg/src/style.css +9 -7
  73. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  74. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  75. package/templates/action-rpg/threenative.config.ts +14 -1
  76. package/templates/action-rpg/vite.config.ts +4 -1
  77. package/templates/minimal/AGENTS.md +12 -12
  78. package/templates/minimal/CLAUDE.md +12 -12
  79. package/templates/minimal/package.json +13 -7
  80. package/templates/minimal/playtests/play.playtest.json +6 -5
  81. package/templates/minimal/playtests/sky.playtest.json +27 -0
  82. package/templates/minimal/src/conventions.ts +6 -3
  83. package/templates/minimal/src/entities/Player.ts +73 -27
  84. package/templates/minimal/src/main.ts +2 -3
  85. package/templates/minimal/src/render/camera.ts +22 -4
  86. package/templates/minimal/src/render/lighting.ts +24 -48
  87. package/templates/minimal/src/render/materials.ts +158 -13
  88. package/templates/minimal/src/render/palette.ts +10 -7
  89. package/templates/minimal/src/render/postprocessing.ts +12 -25
  90. package/templates/minimal/src/render/quality.ts +35 -69
  91. package/templates/minimal/src/render/sky.ts +35 -54
  92. package/templates/minimal/src/render/touch-controls.ts +1 -1
  93. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  94. package/templates/minimal/src/scenes/Play.ts +121 -111
  95. package/templates/minimal/src/state.ts +0 -4
  96. package/templates/minimal/src/style.css +0 -10
  97. package/templates/minimal/threenative.config.ts +15 -1
  98. package/templates/minimal/vite.config.ts +4 -1
  99. package/templates/platformer/AGENTS.md +18 -56
  100. package/templates/platformer/CLAUDE.md +18 -56
  101. package/templates/platformer/kit.json +2 -2
  102. package/templates/platformer/package.json +14 -10
  103. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  104. package/templates/platformer/playtests/collect.playtest.json +8 -34
  105. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  106. package/templates/platformer/playtests/damage.playtest.json +40 -15
  107. package/templates/platformer/playtests/hud.playtest.json +34 -0
  108. package/templates/platformer/playtests/move.playtest.json +24 -0
  109. package/templates/platformer/playtests/performance.playtest.json +24 -7
  110. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  111. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  112. package/templates/platformer/playtests/survives.playtest.json +3 -19
  113. package/templates/platformer/playtests/world.playtest.json +26 -0
  114. package/templates/platformer/src/entities/Fox.ts +273 -0
  115. package/templates/platformer/src/entities/Pickup.ts +43 -60
  116. package/templates/platformer/src/entities/Walker.ts +88 -0
  117. package/templates/platformer/src/game.ts +11 -8
  118. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  119. package/templates/platformer/src/level/Stage.ts +469 -0
  120. package/templates/platformer/src/render/blocks.ts +94 -0
  121. package/templates/platformer/src/render/camera.ts +28 -3
  122. package/templates/platformer/src/render/fox.ts +196 -0
  123. package/templates/platformer/src/render/lighting.ts +42 -33
  124. package/templates/platformer/src/render/materials.ts +115 -5
  125. package/templates/platformer/src/render/palette.ts +68 -53
  126. package/templates/platformer/src/render/pickups.ts +142 -0
  127. package/templates/platformer/src/render/postprocessing.ts +12 -2
  128. package/templates/platformer/src/render/props.ts +147 -0
  129. package/templates/platformer/src/render/quality.ts +47 -99
  130. package/templates/platformer/src/render/scenery.ts +172 -0
  131. package/templates/platformer/src/render/sky.ts +120 -31
  132. package/templates/platformer/src/render/touch-controls.ts +5 -2
  133. package/templates/platformer/src/render/walkers.ts +96 -0
  134. package/templates/platformer/src/render/waterfall.ts +85 -0
  135. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  136. package/templates/platformer/src/scenes/Boot.ts +3 -4
  137. package/templates/platformer/src/scenes/Play.ts +362 -0
  138. package/templates/platformer/src/state.ts +16 -14
  139. package/templates/platformer/src/style.css +9 -8
  140. package/templates/platformer/src/ui/Hud.tsx +62 -29
  141. package/templates/platformer/src/ui/Menu.tsx +2 -2
  142. package/templates/platformer/threenative.config.ts +14 -1
  143. package/templates/platformer/vite.config.ts +4 -1
  144. package/templates/puzzle/AGENTS.md +21 -22
  145. package/templates/puzzle/CLAUDE.md +21 -22
  146. package/templates/puzzle/assets/native-proof.glb +0 -0
  147. package/templates/puzzle/assets/native-proof.png +0 -0
  148. package/templates/puzzle/kit.json +1 -1
  149. package/templates/puzzle/package.json +14 -8
  150. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  151. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  152. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  153. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  154. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  155. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  156. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  157. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  158. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  159. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  160. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  161. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  162. package/templates/puzzle/src/entities/Crate.ts +99 -42
  163. package/templates/puzzle/src/entities/Seal.ts +69 -0
  164. package/templates/puzzle/src/entities/Warden.ts +135 -0
  165. package/templates/puzzle/src/game.ts +15 -11
  166. package/templates/puzzle/src/render/camera.ts +66 -31
  167. package/templates/puzzle/src/render/crateShape.ts +70 -0
  168. package/templates/puzzle/src/render/lighting.ts +41 -41
  169. package/templates/puzzle/src/render/loading.ts +4 -4
  170. package/templates/puzzle/src/render/materials.ts +131 -27
  171. package/templates/puzzle/src/render/palette.ts +19 -29
  172. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  173. package/templates/puzzle/src/render/quality.ts +71 -80
  174. package/templates/puzzle/src/render/shapes.ts +109 -108
  175. package/templates/puzzle/src/render/sky.ts +18 -10
  176. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  177. package/templates/puzzle/src/render/vault.ts +315 -0
  178. package/templates/puzzle/src/render/warden.ts +46 -0
  179. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  180. package/templates/puzzle/src/scenes/Play.ts +793 -0
  181. package/templates/puzzle/src/state.ts +55 -24
  182. package/templates/puzzle/src/style.css +7 -8
  183. package/templates/puzzle/src/ui/App.tsx +2 -2
  184. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  185. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  186. package/templates/puzzle/threenative.config.ts +14 -1
  187. package/templates/puzzle/vite.config.ts +4 -1
  188. package/templates/racing/AGENTS.md +20 -21
  189. package/templates/racing/CLAUDE.md +20 -21
  190. package/templates/racing/package.json +14 -8
  191. package/templates/racing/playtests/boost.playtest.json +33 -12
  192. package/templates/racing/playtests/outcome.playtest.json +32 -50
  193. package/templates/racing/playtests/performance.playtest.json +2 -1
  194. package/templates/racing/playtests/ranking.playtest.json +5 -14
  195. package/templates/racing/playtests/rescue.playtest.json +2 -2
  196. package/templates/racing/playtests/reverse.playtest.json +30 -8
  197. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  198. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  199. package/templates/racing/src/entities/CarBody.ts +327 -0
  200. package/templates/racing/src/entities/LineDriver.ts +220 -0
  201. package/templates/racing/src/entities/RacingCar.ts +150 -89
  202. package/templates/racing/src/entities/Rival.ts +61 -24
  203. package/templates/racing/src/game.ts +5 -0
  204. package/templates/racing/src/render/camera.ts +49 -7
  205. package/templates/racing/src/render/lighting.ts +36 -37
  206. package/templates/racing/src/render/materials.ts +239 -19
  207. package/templates/racing/src/render/palette.ts +19 -21
  208. package/templates/racing/src/render/postprocessing.ts +12 -2
  209. package/templates/racing/src/render/quality.ts +43 -82
  210. package/templates/racing/src/render/shapes.ts +20 -6
  211. package/templates/racing/src/render/sky.ts +47 -39
  212. package/templates/racing/src/render/touch-controls.ts +1 -1
  213. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  214. package/templates/racing/src/scenes/Race.ts +107 -54
  215. package/templates/racing/src/state.ts +2 -0
  216. package/templates/racing/src/track/Checkline.ts +22 -7
  217. package/templates/racing/src/track/Lap.ts +64 -36
  218. package/templates/racing/src/track/Ranking.ts +20 -11
  219. package/templates/racing/src/track/Track.ts +809 -361
  220. package/templates/racing/src/track/TrackSector.ts +40 -11
  221. package/templates/racing/src/track/circuit.ts +477 -0
  222. package/templates/racing/src/track/rescue.ts +16 -4
  223. package/templates/racing/threenative.config.ts +14 -1
  224. package/templates/racing/vite.config.ts +4 -1
  225. package/templates/rts/AGENTS.md +96 -0
  226. package/templates/rts/CLAUDE.md +98 -0
  227. package/templates/rts/kit.json +7 -0
  228. package/templates/{defense → rts}/package.json +14 -8
  229. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  230. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  231. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  232. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  233. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  234. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  235. package/templates/rts/playtests/survives.playtest.json +58 -0
  236. package/templates/rts/public/favicon.svg +4 -0
  237. package/templates/rts/src/game.ts +64 -0
  238. package/templates/rts/src/orders.ts +22 -0
  239. package/templates/rts/src/render/army.ts +346 -0
  240. package/templates/rts/src/render/camera.ts +123 -0
  241. package/templates/rts/src/render/lighting.ts +61 -0
  242. package/templates/rts/src/render/loading.ts +33 -0
  243. package/templates/rts/src/render/materials.ts +152 -0
  244. package/templates/rts/src/render/models.ts +705 -0
  245. package/templates/rts/src/render/palette.ts +17 -0
  246. package/templates/rts/src/render/picking.ts +93 -0
  247. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  248. package/templates/rts/src/render/quality.ts +128 -0
  249. package/templates/rts/src/render/resources.ts +141 -0
  250. package/templates/rts/src/render/sky.ts +44 -0
  251. package/templates/rts/src/render/terrain.ts +116 -0
  252. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  253. package/templates/rts/src/scenes/Play.ts +650 -0
  254. package/templates/rts/src/sim/ai.ts +1140 -0
  255. package/templates/rts/src/sim/combat.ts +416 -0
  256. package/templates/rts/src/sim/construction.ts +374 -0
  257. package/templates/rts/src/sim/economy.ts +167 -0
  258. package/templates/rts/src/sim/game.ts +1082 -0
  259. package/templates/rts/src/sim/movement.ts +371 -0
  260. package/templates/rts/src/sim/nav.ts +276 -0
  261. package/templates/rts/src/sim/production.ts +180 -0
  262. package/templates/rts/src/sim/terrain.ts +170 -0
  263. package/templates/rts/src/sim/types.ts +647 -0
  264. package/templates/rts/src/sim/vision.ts +46 -0
  265. package/templates/rts/src/state.ts +100 -0
  266. package/templates/{defense → rts}/src/style.css +21 -8
  267. package/templates/rts/src/ui/App.tsx +21 -0
  268. package/templates/rts/src/ui/Commands.tsx +129 -0
  269. package/templates/rts/src/ui/GameUi.tsx +22 -0
  270. package/templates/rts/src/ui/Hud.tsx +165 -0
  271. package/templates/rts/src/ui/Minimap.tsx +84 -0
  272. package/templates/rts/tailwind.config.ts +2 -0
  273. package/templates/rts/threenative.config.ts +56 -0
  274. package/templates/rts/tsconfig.json +17 -0
  275. package/templates/{defense → rts}/vite.config.ts +4 -1
  276. package/templates/runner/AGENTS.md +8 -12
  277. package/templates/runner/CLAUDE.md +8 -12
  278. package/templates/runner/README.md +3 -3
  279. package/templates/runner/package.json +14 -8
  280. package/templates/runner/playtests/performance.playtest.json +2 -2
  281. package/templates/runner/src/conventions.ts +4 -3
  282. package/templates/runner/src/entities/Runner.ts +54 -7
  283. package/templates/runner/src/game.ts +2 -0
  284. package/templates/runner/src/render/camera.ts +4 -2
  285. package/templates/runner/src/render/dust.ts +5 -2
  286. package/templates/runner/src/render/lighting.ts +41 -45
  287. package/templates/runner/src/render/loading.ts +2 -2
  288. package/templates/runner/src/render/materials.ts +165 -25
  289. package/templates/runner/src/render/palette.ts +17 -28
  290. package/templates/runner/src/render/postprocessing.ts +12 -2
  291. package/templates/runner/src/render/quality.ts +42 -96
  292. package/templates/runner/src/render/shapes.ts +59 -37
  293. package/templates/runner/src/render/sky.ts +32 -41
  294. package/templates/runner/src/render/touch-controls.ts +1 -1
  295. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  296. package/templates/runner/src/scenes/Run.ts +26 -6
  297. package/templates/runner/src/track.ts +6 -1
  298. package/templates/runner/threenative.config.ts +14 -1
  299. package/templates/runner/vite.config.ts +4 -1
  300. package/templates/sailing/AGENTS.md +14 -14
  301. package/templates/sailing/CLAUDE.md +14 -14
  302. package/templates/sailing/assets/ship.glb +0 -0
  303. package/templates/sailing/package.json +14 -8
  304. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  305. package/templates/sailing/playtests/sails.playtest.json +33 -0
  306. package/templates/sailing/playtests/win.playtest.json +156 -8
  307. package/templates/sailing/src/conventions.ts +29 -2
  308. package/templates/sailing/src/entities/Ship.ts +381 -57
  309. package/templates/sailing/src/game.ts +14 -0
  310. package/templates/sailing/src/render/camera.ts +63 -9
  311. package/templates/sailing/src/render/lighting.ts +49 -27
  312. package/templates/sailing/src/render/materials.ts +50 -15
  313. package/templates/sailing/src/render/ocean.ts +647 -60
  314. package/templates/sailing/src/render/palette.ts +16 -12
  315. package/templates/sailing/src/render/postprocessing.ts +12 -2
  316. package/templates/sailing/src/render/props.ts +316 -442
  317. package/templates/sailing/src/render/quality.ts +14 -4
  318. package/templates/sailing/src/render/sky.ts +116 -23
  319. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  320. package/templates/sailing/src/scenes/Boot.ts +21 -0
  321. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  322. package/templates/sailing/src/state.ts +6 -0
  323. package/templates/sailing/src/ui/Hud.tsx +41 -9
  324. package/templates/sailing/threenative.config.ts +14 -1
  325. package/templates/sailing/vite.config.ts +4 -1
  326. package/templates/shooter/AGENTS.md +29 -44
  327. package/templates/shooter/CLAUDE.md +29 -44
  328. package/templates/shooter/index.html +1 -0
  329. package/templates/shooter/package.json +14 -8
  330. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  331. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  332. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  333. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  334. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  335. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  336. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  337. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  338. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  339. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  340. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  341. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  342. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  343. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  344. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  345. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  346. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  347. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  348. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  349. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  350. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  351. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  352. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  353. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  354. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  355. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  356. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  357. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  358. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  359. package/templates/shooter/playtests/performance.playtest.json +62 -26
  360. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  361. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  362. package/templates/shooter/playtests/survives.playtest.json +36 -30
  363. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  364. package/templates/shooter/src/entities/Breakables.ts +412 -0
  365. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  366. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  367. package/templates/shooter/src/entities/Rifle.ts +442 -0
  368. package/templates/shooter/src/entities/Target.ts +199 -83
  369. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  370. package/templates/shooter/src/game.ts +75 -41
  371. package/templates/shooter/src/main.ts +0 -1
  372. package/templates/shooter/src/postPhysics.ts +36 -0
  373. package/templates/shooter/src/render/camera.ts +78 -74
  374. package/templates/shooter/src/render/decals.ts +142 -82
  375. package/templates/shooter/src/render/facade.ts +1373 -0
  376. package/templates/shooter/src/render/gunfx.ts +704 -0
  377. package/templates/shooter/src/render/lighting.ts +52 -38
  378. package/templates/shooter/src/render/loading.ts +2 -2
  379. package/templates/shooter/src/render/materials.ts +100 -88
  380. package/templates/shooter/src/render/occlusion.ts +108 -0
  381. package/templates/shooter/src/render/palette.ts +10 -10
  382. package/templates/shooter/src/render/palm.ts +455 -0
  383. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  384. package/templates/shooter/src/render/postprocessing.ts +15 -3
  385. package/templates/shooter/src/render/quality.ts +40 -82
  386. package/templates/shooter/src/render/scale.ts +148 -15
  387. package/templates/shooter/src/render/shapes.ts +138 -613
  388. package/templates/shooter/src/render/sky.ts +35 -35
  389. package/templates/shooter/src/render/town-schematic.ts +120 -0
  390. package/templates/shooter/src/render/town.ts +986 -0
  391. package/templates/shooter/src/render/townMaterials.ts +160 -0
  392. package/templates/shooter/src/render/vehicles.ts +741 -0
  393. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  394. package/templates/shooter/src/scenes/Play.ts +727 -650
  395. package/templates/shooter/src/state.ts +26 -41
  396. package/templates/shooter/src/style.css +207 -11
  397. package/templates/shooter/src/surfaces.ts +131 -0
  398. package/templates/shooter/src/ui/App.tsx +9 -10
  399. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  400. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  401. package/templates/shooter/src/ui/Hud.tsx +428 -39
  402. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  403. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  404. package/templates/shooter/src/ui/main.tsx +2 -3
  405. package/templates/shooter/threenative.config.ts +14 -1
  406. package/templates/shooter/vite.config.ts +4 -1
  407. package/templates/starter/AGENTS.md +20 -20
  408. package/templates/starter/CLAUDE.md +20 -20
  409. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  410. package/templates/starter/package.json +15 -9
  411. package/templates/starter/playtests/play.playtest.json +2 -1
  412. package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
  413. package/templates/starter/playtests/survives.playtest.json +1 -1
  414. package/templates/starter/src/conventions.ts +6 -3
  415. package/templates/starter/src/entities/Goal.ts +35 -42
  416. package/templates/starter/src/entities/Player.ts +99 -16
  417. package/templates/starter/src/render/arena.ts +131 -0
  418. package/templates/starter/src/render/lighting.ts +27 -44
  419. package/templates/starter/src/render/materials.ts +164 -35
  420. package/templates/starter/src/render/palette.ts +16 -16
  421. package/templates/starter/src/render/postprocessing.ts +6 -7
  422. package/templates/starter/src/render/quality.ts +43 -101
  423. package/templates/starter/src/render/shapes.ts +1 -1
  424. package/templates/starter/src/render/sky.ts +39 -45
  425. package/templates/starter/src/render/touch-controls.ts +3 -1
  426. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  427. package/templates/starter/src/scenes/Play.ts +82 -81
  428. package/templates/starter/src/ui/Hud.tsx +2 -2
  429. package/templates/starter/src/ui/Menu.tsx +5 -1
  430. package/templates/starter/threenative.config.ts +14 -1
  431. package/templates/starter/vite.config.ts +4 -1
  432. package/templates/tower-defense/.codex/config.toml +19 -0
  433. package/templates/tower-defense/.cursor/mcp.json +32 -0
  434. package/templates/tower-defense/.gemini/settings.json +32 -0
  435. package/templates/tower-defense/.mcp.json +32 -0
  436. package/templates/tower-defense/.vscode/mcp.json +36 -0
  437. package/templates/tower-defense/.zed/settings.json +36 -0
  438. package/templates/{defense → tower-defense}/AGENTS.md +16 -14
  439. package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
  440. package/templates/tower-defense/README.md +16 -0
  441. package/templates/tower-defense/index.html +12 -0
  442. package/templates/tower-defense/kit.json +7 -0
  443. package/templates/tower-defense/opencode.json +41 -0
  444. package/templates/tower-defense/package.json +56 -0
  445. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  446. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  447. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  448. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  449. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  450. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  451. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  452. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  453. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  454. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  455. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  456. package/templates/tower-defense/src/balance.ts +187 -0
  457. package/templates/tower-defense/src/board/Board.ts +100 -0
  458. package/templates/tower-defense/src/board/Route.ts +84 -0
  459. package/templates/tower-defense/src/camera-rig.ts +62 -0
  460. package/templates/tower-defense/src/economy.ts +64 -0
  461. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  462. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  463. package/templates/tower-defense/src/game.ts +72 -0
  464. package/templates/tower-defense/src/intents.ts +21 -0
  465. package/templates/tower-defense/src/main.ts +15 -0
  466. package/templates/tower-defense/src/physics.ts +6 -0
  467. package/templates/tower-defense/src/render/camera.ts +38 -0
  468. package/templates/tower-defense/src/render/lighting.ts +42 -0
  469. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  470. package/templates/tower-defense/src/render/materials.ts +103 -0
  471. package/templates/tower-defense/src/render/palette.ts +58 -0
  472. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  473. package/templates/tower-defense/src/render/quality.ts +128 -0
  474. package/templates/tower-defense/src/render/shapes.ts +550 -0
  475. package/templates/tower-defense/src/render/sky.ts +27 -0
  476. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  477. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  478. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  479. package/templates/tower-defense/src/state.ts +88 -0
  480. package/templates/tower-defense/src/style.css +137 -0
  481. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  482. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  483. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  484. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  485. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  486. package/templates/tower-defense/src/ui/main.tsx +14 -0
  487. package/templates/tower-defense/src/waves.ts +90 -0
  488. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  489. package/templates/tower-defense/vite.config.ts +41 -0
  490. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  491. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  492. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
  493. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  494. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
  495. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
  496. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  497. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  498. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  499. package/agent-files/AGENT-ROLES.md +0 -26
  500. package/templates/action-rpg/src/render/shapes.ts +0 -269
  501. package/templates/action-rpg/src/render/types.ts +0 -3
  502. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  503. package/templates/defense/README.md +0 -10
  504. package/templates/defense/kit.json +0 -7
  505. package/templates/defense/playtests/leak.playtest.json +0 -23
  506. package/templates/defense/playtests/placement.playtest.json +0 -40
  507. package/templates/defense/playtests/scan.playtest.json +0 -20
  508. package/templates/defense/playtests/survive.playtest.json +0 -45
  509. package/templates/defense/playtests/survives.playtest.json +0 -36
  510. package/templates/defense/src/attackers/Attacker.ts +0 -120
  511. package/templates/defense/src/board/Route.ts +0 -94
  512. package/templates/defense/src/conventions.ts +0 -18
  513. package/templates/defense/src/economy.ts +0 -36
  514. package/templates/defense/src/entities/Player.ts +0 -52
  515. package/templates/defense/src/game.ts +0 -51
  516. package/templates/defense/src/physics.ts +0 -13
  517. package/templates/defense/src/placement/Buildable.ts +0 -49
  518. package/templates/defense/src/render/camera.ts +0 -16
  519. package/templates/defense/src/render/lighting.ts +0 -37
  520. package/templates/defense/src/render/materials.ts +0 -22
  521. package/templates/defense/src/render/palette.ts +0 -28
  522. package/templates/defense/src/render/quality.ts +0 -170
  523. package/templates/defense/src/render/shapes.ts +0 -246
  524. package/templates/defense/src/render/sky.ts +0 -45
  525. package/templates/defense/src/scenes/Boot.ts +0 -12
  526. package/templates/defense/src/scenes/Defense.ts +0 -231
  527. package/templates/defense/src/state.ts +0 -56
  528. package/templates/defense/src/towers/Tower.ts +0 -95
  529. package/templates/defense/src/towers/targeting.ts +0 -53
  530. package/templates/defense/src/ui/Hud.tsx +0 -62
  531. package/templates/defense/src/ui/Menu.tsx +0 -7
  532. package/templates/defense/src/waves.ts +0 -40
  533. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  534. package/templates/minimal/src/render/hud.ts +0 -69
  535. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  536. package/templates/platformer/playtests/chase.playtest.json +0 -21
  537. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  538. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  539. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  540. package/templates/platformer/playtests/physics.playtest.json +0 -14
  541. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  542. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  543. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  544. package/templates/platformer/src/conventions.ts +0 -18
  545. package/templates/platformer/src/entities/Character.ts +0 -286
  546. package/templates/platformer/src/entities/Chaser.ts +0 -118
  547. package/templates/platformer/src/entities/Patrol.ts +0 -93
  548. package/templates/platformer/src/level/Platform.ts +0 -46
  549. package/templates/platformer/src/render/rig.ts +0 -60
  550. package/templates/platformer/src/render/terrain.ts +0 -31
  551. package/templates/platformer/src/scenes/Level.ts +0 -241
  552. package/templates/puzzle/README.md +0 -43
  553. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  554. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  555. package/templates/puzzle/src/conventions.ts +0 -25
  556. package/templates/puzzle/src/entities/Ball.ts +0 -70
  557. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  558. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  559. package/templates/puzzle/src/physics.ts +0 -19
  560. package/templates/puzzle/src/room.ts +0 -83
  561. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  562. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  563. package/templates/shooter/playtests/combat.playtest.json +0 -48
  564. package/templates/shooter/playtests/fail.playtest.json +0 -31
  565. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  566. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  567. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  568. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  569. package/templates/shooter/src/combat/damage.ts +0 -40
  570. package/templates/shooter/src/conventions.ts +0 -51
  571. package/templates/shooter/src/entities/Pickup.ts +0 -70
  572. package/templates/shooter/src/entities/Player.ts +0 -310
  573. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  574. package/templates/shooter/src/playtest-events.ts +0 -15
  575. package/templates/shooter/src/render/touch-controls.ts +0 -305
  576. package/templates/shooter/src/render/types.ts +0 -3
  577. package/templates/shooter/src/render/ui.css +0 -330
  578. package/templates/shooter/src/render/ui.ts +0 -75
  579. package/templates/shooter/src/render/vfx.ts +0 -215
  580. package/templates/shooter/src/ui/Menu.tsx +0 -41
  581. package/templates/shooter/src/waves.ts +0 -50
  582. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  583. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  584. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  585. package/templates/starter/playtests/assets.playtest.json +0 -65
  586. package/templates/starter/playtests/buffer.playtest.json +0 -79
  587. package/templates/starter/playtests/cloth.playtest.json +0 -113
  588. package/templates/starter/playtests/coyote.playtest.json +0 -87
  589. package/templates/starter/playtests/gameover.playtest.json +0 -66
  590. package/templates/starter/playtests/goal.playtest.json +0 -67
  591. package/templates/starter/playtests/look.playtest.json +0 -175
  592. package/templates/starter/playtests/models-baseline.png +0 -0
  593. package/templates/starter/playtests/models.playtest.json +0 -74
  594. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  595. package/templates/starter/playtests/odometer.playtest.json +0 -54
  596. package/templates/starter/playtests/seed.playtest.json +0 -54
  597. package/templates/starter/playtests/textures-baseline.png +0 -0
  598. package/templates/starter/playtests/textures.playtest.json +0 -74
  599. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  600. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  601. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  602. package/templates/starter/src/render/coast.ts +0 -199
  603. package/templates/starter/src/render/hero.ts +0 -88
  604. package/templates/starter/src/render/implicitSurface.ts +0 -199
  605. package/templates/starter/src/render/kuwahara.ts +0 -174
  606. package/templates/starter/src/render/outline.ts +0 -141
  607. package/templates/starter/src/render/painterly.ts +0 -86
  608. package/templates/starter/src/render/rockRidge.ts +0 -198
  609. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  610. package/templates/starter/src/render/scenery.ts +0 -40
  611. package/templates/starter/src/render/textureLifetime.ts +0 -53
  612. package/templates/starter/src/render/water.ts +0 -38
  613. package/templates/starter/src/render/watercolor.ts +0 -85
  614. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  615. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  616. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  617. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  618. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  619. /package/templates/{defense → rts}/.mcp.json +0 -0
  620. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  621. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  622. /package/templates/{defense → rts}/index.html +0 -0
  623. /package/templates/{defense → rts}/opencode.json +0 -0
  624. /package/templates/{defense → rts}/src/main.ts +0 -0
  625. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  626. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  627. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  628. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  629. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  630. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  631. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -1,653 +1,178 @@
1
- // Generated for you. All arena silhouettes and gameplay visuals start here.
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // Rounded, cached primitives — the single highest-leverage thing in this
5
+ // folder. A sharp BoxGeometry reads as Minecraft; the same box with a 0.14
6
+ // corner radius reads as a toy, and that soft corner-wrap is most of what
7
+ // separates a stack of boxes from something that looks designed.
8
+ //
9
+ // Nothing here is textured, on purpose. Surface variety comes from alternating
10
+ // palette entries across a run of meshes, never from a bitmap: `CanvasTexture`
11
+ // samples BLACK under `WebGPURenderer`, which is a trap worth knowing about
12
+ // before you spend an afternoon painting one.
2
13
  import {
3
14
  BoxGeometry,
4
- BufferAttribute,
5
- BufferGeometry,
6
- ClampToEdgeWrapping,
15
+ type BufferGeometry,
16
+ ConeGeometry,
7
17
  CylinderGeometry,
8
- DataTexture,
9
- DoubleSide,
10
- Group,
11
18
  type Material,
19
+ MathUtils,
12
20
  Mesh,
13
- MeshBasicMaterial,
14
- NearestFilter,
15
21
  PlaneGeometry,
16
- RGBAFormat,
17
22
  SphereGeometry,
18
- UnsignedByteType,
23
+ TorusKnotGeometry,
24
+ Vector3,
19
25
  } from "three";
20
-
21
- import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
22
- import type { ReturnTypeOfMaterials } from "./types.js";
26
+ import { mergeVertices } from "three/addons/utils/BufferGeometryUtils.js";
23
27
 
24
28
  const roundedCache = new Map<string, BufferGeometry>();
25
29
 
26
- export type ShooterMaterials = ReturnTypeOfMaterials;
27
-
28
- export const PICKUP_SPRITE_FRAMES = [
29
- { x: 0, y: 0, width: 8, height: 8, duration: 0.07 },
30
- { x: 8, y: 0, width: 12, height: 10, duration: 0.11 },
31
- { x: 20, y: 2, width: 12, height: 8, duration: 0.15 },
32
- ] as const;
33
-
34
- const PICKUP_ATLAS_WIDTH = 32;
35
- const PICKUP_ATLAS_HEIGHT = 16;
36
-
37
- function setPixel(
38
- data: Uint8Array,
39
- width: number,
40
- height: number,
41
- x: number,
42
- y: number,
43
- colour: readonly [number, number, number, number],
44
- ): void {
45
- if (x < 0 || y < 0 || x >= width || y >= height) return;
46
- const row = height - 1 - y;
47
- const index = (row * width + x) * 4;
48
- data[index] = colour[0];
49
- data[index + 1] = colour[1];
50
- data[index + 2] = colour[2];
51
- data[index + 3] = colour[3];
52
- }
53
-
54
- function createPickupAtlas(): DataTexture {
55
- const data = new Uint8Array(PICKUP_ATLAS_WIDTH * PICKUP_ATLAS_HEIGHT * 4);
56
- for (let y = 0; y < PICKUP_ATLAS_HEIGHT; y += 1) {
57
- for (let x = 0; x < PICKUP_ATLAS_WIDTH; x += 1) {
58
- const frame = PICKUP_SPRITE_FRAMES.find(
59
- ({ x: left, y: top, width, height }) =>
60
- x >= left && x < left + width && y >= top && y < top + height,
61
- );
62
- if (frame === undefined) continue;
63
- const localX = x - frame.x - (frame.width - 1) / 2;
64
- const localY = y - frame.y - (frame.height - 1) / 2;
65
- const radius = Math.min(frame.width, frame.height) * 0.42;
66
- if (Math.hypot(localX, localY) > radius) continue;
67
- const colour: readonly [number, number, number, number] = [
68
- 100 + Math.round((frame.width / 12) * 100),
69
- 225,
70
- 255,
71
- 255,
72
- ];
73
- setPixel(data, PICKUP_ATLAS_WIDTH, PICKUP_ATLAS_HEIGHT, x, y, colour);
74
- }
30
+ // Canonical primitives: ONE geometry object per shape, sized per mesh through
31
+ // `mesh.scale`. A plain `new BoxGeometry(w, h, d)` per mesh is pixel-identical
32
+ // to a shared unit box scaled by (w, h, d) — positions are linear in the
33
+ // dimensions and the axis-aligned normals survive a diagonal scale — but the
34
+ // per-mesh version gives every mesh its own geometry identity, and identity is
35
+ // what instancing keys on. A town that builds 200 solids this way draws 200
36
+ // times where it could draw once; these exist so that never happens again.
37
+ let unitBoxGeometry: BufferGeometry | undefined;
38
+ export function unitBox(): BufferGeometry {
39
+ unitBoxGeometry ??= new BoxGeometry(1, 1, 1);
40
+ return unitBoxGeometry;
41
+ }
42
+
43
+ let unitPlaneGeometry: BufferGeometry | undefined;
44
+ export function unitPlane(): BufferGeometry {
45
+ unitPlaneGeometry ??= new PlaneGeometry(1, 1);
46
+ return unitPlaneGeometry;
47
+ }
48
+
49
+ const unitCylinderCache = new Map<number, BufferGeometry>();
50
+ /** A radius-1, height-1 cylinder scaled by (r, h, r); segments are part of the shape. */
51
+ export function unitCylinder(segments: number): BufferGeometry {
52
+ let geometry = unitCylinderCache.get(segments);
53
+ if (geometry === undefined) {
54
+ geometry = new CylinderGeometry(1, 1, 1, segments);
55
+ unitCylinderCache.set(segments, geometry);
75
56
  }
76
- const texture = new DataTexture(
77
- data,
78
- PICKUP_ATLAS_WIDTH,
79
- PICKUP_ATLAS_HEIGHT,
80
- RGBAFormat,
81
- UnsignedByteType,
82
- );
83
- texture.magFilter = NearestFilter;
84
- texture.minFilter = NearestFilter;
85
- texture.wrapS = ClampToEdgeWrapping;
86
- texture.wrapT = ClampToEdgeWrapping;
87
- texture.needsUpdate = true;
88
- return texture;
89
- }
90
-
91
- const NAMEPLATE_GLYPHS: Readonly<Record<string, readonly string[]>> = {
92
- A: ["01110", "10001", "10001", "11111", "10001", "10001", "10001"],
93
- E: ["11111", "10000", "10000", "11110", "10000", "10000", "11111"],
94
- G: ["01110", "10001", "10000", "10111", "10001", "10001", "01110"],
95
- R: ["11110", "10001", "10001", "11110", "10100", "10010", "10001"],
96
- T: ["11111", "00100", "00100", "00100", "00100", "00100", "00100"],
97
- };
98
-
99
- const NAMEPLATE_WIDTH = 48;
100
- const NAMEPLATE_HEIGHT = 12;
101
- const NAMEPLATE_BACKGROUND: readonly [number, number, number, number] = [7, 18, 27, 240];
102
- const NAMEPLATE_INK: readonly [number, number, number, number] = [138, 239, 255, 255];
103
- const NAMEPLATE_BORDER: readonly [number, number, number, number] = [53, 128, 154, 255];
104
-
105
- function fillNameplate(data: Uint8Array): void {
106
- for (let y = 0; y < NAMEPLATE_HEIGHT; y += 1) {
107
- for (let x = 0; x < NAMEPLATE_WIDTH; x += 1)
108
- setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, x, y, NAMEPLATE_BACKGROUND);
109
- }
110
- }
111
-
112
- function drawNameplateBorder(data: Uint8Array): void {
113
- for (let x = 0; x < NAMEPLATE_WIDTH; x += 1) {
114
- setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, x, 0, NAMEPLATE_BORDER);
115
- setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, x, NAMEPLATE_HEIGHT - 1, NAMEPLATE_BORDER);
116
- }
117
- for (let y = 0; y < NAMEPLATE_HEIGHT; y += 1) {
118
- setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, 0, y, NAMEPLATE_BORDER);
119
- setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, NAMEPLATE_WIDTH - 1, y, NAMEPLATE_BORDER);
120
- }
121
- }
122
-
123
- function drawNameplateText(data: Uint8Array): void {
124
- for (const [index, character] of [..."TARGET"].entries()) {
125
- const glyph = NAMEPLATE_GLYPHS[character];
126
- if (glyph === undefined) continue;
127
- for (const [row, line] of glyph.entries()) {
128
- for (const [column, lit] of [...line].entries()) {
129
- if (lit === "1")
130
- setPixel(
131
- data,
132
- NAMEPLATE_WIDTH,
133
- NAMEPLATE_HEIGHT,
134
- 6 + index * 7 + column,
135
- 2 + row,
136
- NAMEPLATE_INK,
137
- );
138
- }
139
- }
140
- }
141
- }
142
-
143
- function createNameplateTexture(): DataTexture {
144
- const data = new Uint8Array(NAMEPLATE_WIDTH * NAMEPLATE_HEIGHT * 4);
145
- fillNameplate(data);
146
- drawNameplateBorder(data);
147
- drawNameplateText(data);
148
- const texture = new DataTexture(
149
- data,
150
- NAMEPLATE_WIDTH,
151
- NAMEPLATE_HEIGHT,
152
- RGBAFormat,
153
- UnsignedByteType,
154
- );
155
- texture.magFilter = NearestFilter;
156
- texture.minFilter = NearestFilter;
157
- texture.wrapS = ClampToEdgeWrapping;
158
- texture.wrapT = ClampToEdgeWrapping;
159
- texture.needsUpdate = true;
160
- return texture;
161
- }
162
-
163
- function createTargetNameplate(): Group {
164
- const group = new Group();
165
- group.name = "target-nameplate";
166
- const mesh = new Mesh(
167
- new PlaneGeometry(1.05, 0.26),
168
- new MeshBasicMaterial({
169
- depthWrite: false,
170
- map: createNameplateTexture(),
171
- side: DoubleSide,
172
- transparent: true,
173
- }),
174
- );
175
- mesh.name = "target-nameplate-surface";
176
- group.add(mesh);
177
- return group;
178
- }
179
-
180
- function compactBox(width: number, height: number, depth: number): BufferGeometry {
181
- const halfX = width / 2;
182
- const halfY = height / 2;
183
- const halfZ = depth / 2;
184
- const positions = new Float32Array([
185
- -halfX,
186
- -halfY,
187
- -halfZ,
188
- halfX,
189
- -halfY,
190
- -halfZ,
191
- halfX,
192
- halfY,
193
- -halfZ,
194
- -halfX,
195
- halfY,
196
- -halfZ,
197
- -halfX,
198
- -halfY,
199
- halfZ,
200
- halfX,
201
- -halfY,
202
- halfZ,
203
- halfX,
204
- halfY,
205
- halfZ,
206
- -halfX,
207
- halfY,
208
- halfZ,
209
- ]);
210
- const normals = new Float32Array(positions.length);
211
- for (let index = 0; index < positions.length; index += 3) {
212
- const x = positions[index] ?? 0;
213
- const y = positions[index + 1] ?? 0;
214
- const z = positions[index + 2] ?? 0;
215
- const length = Math.hypot(x, y, z) || 1;
216
- normals[index] = x / length;
217
- normals[index + 1] = y / length;
218
- normals[index + 2] = z / length;
219
- }
220
- const geometry = new BufferGeometry();
221
- geometry.setAttribute("position", new BufferAttribute(positions, 3));
222
- geometry.setAttribute("normal", new BufferAttribute(normals, 3));
223
- geometry.setIndex([
224
- 0, 1, 2, 0, 2, 3, 4, 6, 5, 4, 7, 6, 0, 4, 5, 0, 5, 1, 1, 5, 6, 1, 6, 2, 2, 6, 7, 2, 7, 3, 4, 0,
225
- 3, 4, 3, 7,
226
- ]);
227
57
  return geometry;
228
58
  }
229
59
 
230
60
  /**
231
- * A box with **face** normals, cached by size.
232
- *
233
- * `compactBox` above shares eight vertices between all six faces and derives each normal by
234
- * normalising the vertex position. That is fine for something roughly cubic, and wrong for
235
- * anything long and thin: for the arena's 22 x 4.2 x 0.4 back wall every normal comes out pointing
236
- * along +/-X, so the inner face is shaded as though it faced sideways and an overhead key misses
237
- * it completely. The wall rendered as a black band straight across the middle of the frame at
238
- * exactly the height the targets stand — and no palette or light change could lift it, because the
239
- * surface was not facing the light.
240
- *
241
- * A `BoxGeometry` has twenty-four vertices and the **same twelve triangles**, so this costs
242
- * nothing against the triangle budget. `compactBox` stays for the flat trim strips and decals,
243
- * where the geometry really is a thin quad and the shading does not matter.
61
+ * A box with rounded edges: every vertex of a segmented box pushed outward
62
+ * from the clamped "inner" box by `radius`, then welded so normals interpolate
63
+ * smoothly across the seams instead of faceting at them.
244
64
  */
245
- function roundedBox(width: number, height: number, depth: number): BufferGeometry {
246
- const key = `${width},${height},${depth}`;
65
+ export function roundedBox(
66
+ width: number,
67
+ height: number,
68
+ depth: number,
69
+ radius = 0.14,
70
+ segments = 3,
71
+ ): BufferGeometry {
72
+ const key = `${width},${height},${depth},${radius},${segments}`;
247
73
  const cached = roundedCache.get(key);
248
74
  if (cached !== undefined) return cached;
249
- const geometry = new BoxGeometry(width, height, depth);
250
- roundedCache.set(key, geometry);
251
- return geometry;
252
- }
253
75
 
254
- /**
255
- * Bake a group of rigid meshes down to one mesh per material.
256
- *
257
- * The arena's floor panels, its skirting and each drone are all static relative to their parent,
258
- * and authored one mesh at a time they cost one draw each. With five hostiles on the field that
259
- * put `production-performance` at five hundred draws. Merging keeps every material separate and
260
- * separately editable and costs no triangles at all.
261
- */
262
- function bakeByMaterial(parts: readonly Mesh[], root: Group): void {
263
- const byMaterial = new Map<Material, Mesh[]>();
264
- for (const mesh of parts) {
265
- const bucket = byMaterial.get(mesh.material as Material);
266
- if (bucket === undefined) byMaterial.set(mesh.material as Material, [mesh]);
267
- else bucket.push(mesh);
268
- }
269
- for (const [material, meshes] of byMaterial) {
270
- const geometry = mergeGeometries(
271
- meshes.map((mesh) => {
272
- mesh.updateMatrix();
273
- const placed = mesh.geometry.clone().applyMatrix4(mesh.matrix);
274
- const cloned = placed.index === null ? placed : placed.toNonIndexed();
275
- for (const name of Object.keys(cloned.attributes)) {
276
- if (name !== "position") cloned.deleteAttribute(name);
277
- }
278
- return cloned;
279
- }),
280
- false,
76
+ const limit = Math.min(radius, width / 2 - 1e-3, height / 2 - 1e-3, depth / 2 - 1e-3);
77
+ const geometry = new BoxGeometry(width, height, depth, segments, segments, segments);
78
+ // No UVs and no normals: both are rebuilt after welding, and a geometry with
79
+ // stale UVs is a geometry someone will eventually try to texture.
80
+ geometry.deleteAttribute("uv");
81
+ geometry.deleteAttribute("normal");
82
+
83
+ const position = geometry.attributes.position;
84
+ if (position === undefined) throw new Error("Rounded box lost its position attribute.");
85
+ const inner = new Vector3(width / 2 - limit, height / 2 - limit, depth / 2 - limit);
86
+ const vertex = new Vector3();
87
+ const clamped = new Vector3();
88
+ for (let index = 0; index < position.count; index += 1) {
89
+ vertex.fromBufferAttribute(position, index);
90
+ clamped.set(
91
+ MathUtils.clamp(vertex.x, -inner.x, inner.x),
92
+ MathUtils.clamp(vertex.y, -inner.y, inner.y),
93
+ MathUtils.clamp(vertex.z, -inner.z, inner.z),
281
94
  );
282
- if (geometry === null) throw new Error("mergeGeometries returned null baking a visual.");
283
- geometry.computeVertexNormals();
284
- const merged = new Mesh(geometry, material);
285
- merged.castShadow = meshes[0]?.castShadow ?? true;
286
- merged.receiveShadow = true;
287
- root.add(merged);
95
+ vertex.sub(clamped);
96
+ const length = vertex.length();
97
+ if (length > 1e-6) vertex.multiplyScalar(limit / length);
98
+ position.setXYZ(index, vertex.x + clamped.x, vertex.y + clamped.y, vertex.z + clamped.z);
288
99
  }
289
- }
290
100
 
291
- function shadowed(mesh: Mesh, cast = true): Mesh {
292
- mesh.castShadow = cast;
293
- mesh.receiveShadow = true;
294
- return mesh;
101
+ const welded = mergeVertices(geometry, 1e-4);
102
+ welded.computeVertexNormals();
103
+ roundedCache.set(key, welded);
104
+ return welded;
295
105
  }
296
106
 
297
- function block(width: number, height: number, depth: number, material: Material): Mesh {
298
- return shadowed(new Mesh(roundedBox(width, height, depth), material));
107
+ export interface IShapeOptions {
108
+ readonly castShadow?: boolean;
109
+ readonly radius?: number;
110
+ readonly receiveShadow?: boolean;
111
+ readonly segments?: number;
299
112
  }
300
113
 
301
- export function createArena(materials: ShooterMaterials) {
302
- const group = new Group();
303
- group.name = "arena";
304
- // Everything static and non-interactive: floor panels, skirting, boundary lines, cover lips.
305
- // Baked into one mesh per material at the end of this function.
306
- const decoration: Mesh[] = [];
307
- const floor = block(22, 0.4, 24, materials.arena);
308
- floor.name = "arena-floor";
309
- floor.position.set(0, -0.2, -1);
310
- group.add(floor);
311
- // Four walls, not three. In first person the player turns around, and an arena open at the back
312
- // shows the void the third-person camera never pointed at.
313
- const walls = [
314
- { depth: 24, position: [-11, 1.9, -1] as const, width: 0.4 },
315
- { depth: 24, position: [11, 1.9, -1] as const, width: 0.4 },
316
- { depth: 0.4, position: [0, 1.9, -13] as const, width: 22 },
317
- { depth: 0.4, position: [0, 1.9, 11] as const, width: 22 },
318
- ].map(({ depth, position, width }, index) => {
319
- const wall = block(width, 4.2, depth, materials.shadow);
320
- wall.name = `arena-wall-${index}`;
321
- wall.position.set(position[0], position[1], position[2]);
322
- group.add(wall);
323
- // A lit skirting strip where the wall meets the deck. Without one the join is the darkest
324
- // value in the arena and reads as a black band cut across the middle of the frame, which is
325
- // exactly where the targets stand.
326
- const skirting = new Mesh(
327
- compactBox(width < 1 ? width + 0.12 : width, 0.14, depth < 1 ? depth + 0.12 : depth),
328
- materials.trim,
329
- );
330
- skirting.position.set(position[0], 0.12, position[2]);
331
- skirting.castShadow = false;
332
- decoration.push(skirting);
333
- return wall;
334
- });
335
- // Cover. An arena with a flat floor is a shooting gallery: these are what turns "walk forward
336
- // and hold fire" into peeking, and they are what the crouch is for.
337
- const cover = [
338
- { height: 1.15, position: [-4.6, 0, -3.2] as const, size: [2.4, 1.2] as const },
339
- { height: 1.15, position: [4.6, 0, -3.2] as const, size: [2.4, 1.2] as const },
340
- { height: 0.95, position: [0, 0, -7.4] as const, size: [3.6, 1.1] as const },
341
- { height: 2.6, position: [-7.4, 0, -8.6] as const, size: [1.5, 1.5] as const },
342
- { height: 2.6, position: [7.4, 0, -8.6] as const, size: [1.5, 1.5] as const },
343
- { height: 0.9, position: [-2.4, 0, 2.4] as const, size: [1.4, 1.4] as const },
344
- { height: 0.9, position: [2.4, 0, 2.4] as const, size: [1.4, 1.4] as const },
345
- ].map(({ height, position, size }, index) => {
346
- const crate = block(size[0], height, size[1], materials.cover);
347
- crate.name = `arena-wall-cover-${index}`;
348
- crate.position.set(position[0], height / 2, position[2]);
349
- group.add(crate);
350
- // A lit lip along the top edge, so cover reads as cover at a glance in a dim arena.
351
- const lip = new Mesh(compactBox(size[0] + 0.06, 0.05, size[1] + 0.06), materials.edge);
352
- lip.position.set(position[0], height + 0.02, position[2]);
353
- lip.castShadow = false;
354
- lip.receiveShadow = false;
355
- decoration.push(lip);
356
- return crate;
357
- });
358
- // Floor panels, then a boundary line. A full accent grid every three metres across the whole
359
- // floor is what shipped, and it photographed as a debug overlay switched on by mistake: bright
360
- // yellow rules over everything, drawing the eye away from the targets standing on them.
361
- for (let x = -8; x <= 8; x += 5.4) {
362
- for (let z = -11; z <= 9; z += 5) {
363
- const panel = new Mesh(compactBox(4.9, 0.02, 4.5), materials.floorPanel);
364
- panel.position.set(x, 0.011, z);
365
- panel.castShadow = false;
366
- panel.receiveShadow = true;
367
- decoration.push(panel);
368
- }
369
- }
370
- for (const [width, depth, z] of [
371
- [21.4, 0.06, -12.6],
372
- [21.4, 0.06, 10.6],
373
- ] as const) {
374
- const line = new Mesh(compactBox(width, 0.014, depth), materials.trim);
375
- line.position.set(0, 0.02, z);
376
- line.castShadow = false;
377
- decoration.push(line);
378
- }
379
- for (const side of [-1, 1]) {
380
- const line = new Mesh(compactBox(0.06, 0.014, 23.2), materials.trim);
381
- line.position.set(side * 10.6, 0.02, -1);
382
- line.castShadow = false;
383
- decoration.push(line);
384
- }
385
- bakeByMaterial(decoration, group);
386
- return { cover, floor, group, walls };
387
- }
388
-
389
- /**
390
- * The carbine and the hands that hold it, authored pointing -z.
391
- *
392
- * Deliberately built from primitives rather than loaded from a `.glb`: a kit that ships a
393
- * 12 MB weapon model teaches an agent to reach for one, and this reads as a weapon at a
394
- * fraction of the download. Swap it for a real model by loading a `.glb` in `Scene.load()` and
395
- * handing it to `preparePlayerConventions` instead — `normaliseToMetres` sizes either one.
396
- *
397
- * It is authored at roughly 0.55 m so `normaliseToMetres` has real work to do: the size that
398
- * ships is the one in `render/scale.ts`, never the one that happened to be convenient here.
399
- */
400
- export function createViewmodelVisual(materials: ShooterMaterials): Group {
401
- const group = new Group();
402
- group.name = "viewmodel";
403
-
404
- const rifle = new Group();
405
- rifle.name = "held-rifle";
406
-
407
- const part = (
408
- geometry: BufferGeometry,
409
- material: Material,
410
- x: number,
411
- y: number,
412
- z: number,
413
- ): Mesh => {
414
- const mesh = new Mesh(geometry, material);
415
- mesh.position.set(x, y, z);
416
- // The viewmodel is drawn over the arena and never casts into it: a weapon held at the eye
417
- // throws a shadow the size of the room.
418
- mesh.castShadow = false;
419
- mesh.receiveShadow = false;
420
- mesh.frustumCulled = false;
421
- rifle.add(mesh);
422
- return mesh;
423
- };
424
-
425
- part(compactBox(0.062, 0.072, 0.24), materials.gunmetal, 0, 0, -0.02);
426
- part(compactBox(0.05, 0.052, 0.15), materials.polymer, 0, -0.002, -0.2);
427
- part(
428
- new CylinderGeometry(0.011, 0.011, 0.2, 6).rotateX(Math.PI / 2),
429
- materials.gunmetal,
430
- 0,
431
- 0.012,
432
- -0.31,
433
- );
434
- part(
435
- new CylinderGeometry(0.021, 0.019, 0.07, 6).rotateX(Math.PI / 2),
436
- materials.gunmetal,
437
- 0,
438
- 0.012,
439
- -0.43,
440
- );
441
- // Magazine and pistol grip, both raked back the way a real one sits in the hand.
442
- const magazine = part(compactBox(0.04, 0.13, 0.062), materials.polymer, 0, -0.09, -0.04);
443
- magazine.rotation.x = -0.16;
444
- const grip = part(compactBox(0.038, 0.1, 0.05), materials.polymer, 0, -0.075, 0.07);
445
- grip.rotation.x = 0.3;
446
- part(compactBox(0.055, 0.062, 0.13), materials.polymer, 0, -0.006, 0.13);
447
- // The optic. `preparePlayerConventions` does not look for it by name, but a rigged replacement
448
- // usually ships one called this, and the aiming pose is authored against its position.
449
- const optic = part(compactBox(0.036, 0.038, 0.07), materials.gunmetal, 0, 0.057, -0.01);
450
- optic.name = "optic";
451
- part(compactBox(0.008, 0.008, 0.008), materials.sight, 0, 0.058, -0.045);
452
- part(compactBox(0.044, 0.012, 0.09), materials.gunmetal, 0, 0.04, -0.02);
453
-
454
- group.add(rifle);
455
-
456
- // Two gloved forearms. They live outside `held-rifle` so `normaliseToMetres` measures the
457
- // weapon and not the person carrying it.
458
- const arms = new Group();
459
- arms.name = "viewmodel-arms";
460
- const forearm = (x: number, y: number, z: number, pitch: number, yaw: number): void => {
461
- const mesh = new Mesh(compactBox(0.048, 0.046, 0.3), materials.glove);
462
- mesh.position.set(x, y, z);
463
- mesh.rotation.set(pitch, yaw, 0);
464
- mesh.castShadow = false;
465
- mesh.receiveShadow = false;
466
- mesh.frustumCulled = false;
467
- arms.add(mesh);
468
- };
469
- forearm(0.075, -0.15, 0.02, 0.5, -0.26);
470
- forearm(-0.055, -0.12, -0.2, 0.36, 0.32);
471
- group.add(arms);
472
- return group;
114
+ function shadowed(mesh: Mesh, options: IShapeOptions): Mesh {
115
+ mesh.castShadow = options.castShadow ?? true;
116
+ mesh.receiveShadow = options.receiveShadow ?? true;
117
+ return mesh;
473
118
  }
474
119
 
475
- /**
476
- * What the player sees when they look down: hips, thighs, shins, boots.
477
- *
478
- * Nothing above the waist, because a chest at eye height fills the frame and clips through the
479
- * near plane. `GroundSnap` measures this group, so the boots are what meets the floor.
480
- */
481
- export function createLegsVisual(materials: ShooterMaterials): Group {
482
- const group = new Group();
483
- group.name = "player-legs";
484
- const leg = (side: number): void => {
485
- const thigh = block(0.19, 0.44, 0.21, materials.player);
486
- thigh.position.set(side * 0.13, -0.24, 0);
487
- group.add(thigh);
488
- const shin = block(0.15, 0.4, 0.17, materials.shadow);
489
- shin.position.set(side * 0.13, -0.64, 0.01);
490
- group.add(shin);
491
- const boot = block(0.17, 0.11, 0.3, materials.trim);
492
- boot.position.set(side * 0.13, -0.855, -0.04);
493
- group.add(boot);
494
- };
495
- leg(-1);
496
- leg(1);
497
- const hips = block(0.42, 0.2, 0.24, materials.player);
498
- hips.position.y = -0.02;
499
- group.add(hips);
500
- return group;
120
+ /** The workhorse: a rounded box that casts and receives shadows. */
121
+ export function block(
122
+ width: number,
123
+ height: number,
124
+ depth: number,
125
+ material: Material,
126
+ options: IShapeOptions = {},
127
+ ): Mesh {
128
+ const geometry = roundedBox(width, height, depth, options.radius ?? 0.14, options.segments ?? 3);
129
+ return shadowed(new Mesh(geometry, material), options);
501
130
  }
502
131
 
503
- /**
504
- * The hostile: a hovering combat drone.
505
- *
506
- * What shipped here was a 1.2 x 1.8 box in hostile pink with two thin bars crossed over it, and
507
- * the first frame read exactly like that — a sheet of pink card with a plus drawn on it, in
508
- * triplicate. A drone made of nine boxes is barely more geometry (this template's `compactBox` is
509
- * twelve triangles) and it has a front, a top and a silhouette, which is what tells the player
510
- * which way a thing is facing and whether they have hit it.
511
- *
512
- * The collision box in `Target.ts` is unchanged at 1.2 x 1.8 x 1: this fills that volume rather
513
- * than redefining it.
514
- */
515
- export function createTargetVisual(materials: ShooterMaterials): Group {
516
- const group = new Group();
517
- group.name = "target-visual";
518
- // Keep a non-zero parent rotation in the stock scene so the nameplate demonstrates world-space
519
- // billboarding instead of accidentally passing only in the unparented case.
520
- group.rotation.y = 0.22;
521
- const parts: Mesh[] = [];
522
-
523
- // Core: a chest that tapers to a narrower waist, so the thing has a top and a bottom.
524
- const chest = block(0.94, 0.72, 0.62, materials.hostile);
525
- chest.position.y = 1.24;
526
- parts.push(chest);
527
- const waist = block(0.6, 0.44, 0.46, materials.shadow);
528
- waist.position.y = 0.78;
529
- parts.push(waist);
530
- const skirt = block(0.78, 0.26, 0.56, materials.hostile);
531
- skirt.position.y = 0.5;
532
- parts.push(skirt);
533
-
534
- // Head and the single lit eye: the read that says which way it is looking.
535
- const head = block(0.4, 0.3, 0.34, materials.shadow);
536
- head.position.y = 1.72;
537
- parts.push(head);
538
- const eye = new Mesh(compactBox(0.26, 0.09, 0.06), materials.sight);
539
- eye.position.set(0, 1.74, -0.2);
540
- eye.castShadow = false;
541
- parts.push(eye);
542
-
543
- // Shoulder pods, canted outward. Most of the silhouette at range comes from these.
544
- for (const side of [-1, 1]) {
545
- const pod = block(0.28, 0.34, 0.46, materials.shadow);
546
- pod.position.set(side * 0.62, 1.32, 0);
547
- pod.rotation.z = side * -0.22;
548
- parts.push(pod);
549
- const muzzle = new Mesh(compactBox(0.1, 0.1, 0.34), materials.trim);
550
- muzzle.position.set(side * 0.66, 1.28, -0.34);
551
- muzzle.castShadow = false;
552
- parts.push(muzzle);
553
- // Trailing legs. A hovering thing with nothing below it reads as a floating box.
554
- const leg = block(0.1, 0.5, 0.12, materials.shadow);
555
- leg.position.set(side * 0.24, 0.2, 0.06);
556
- leg.rotation.x = -0.24;
557
- parts.push(leg);
558
- }
559
-
560
- // A lit band around the chest, so a hit registers against something bright.
561
- const band = new Mesh(compactBox(0.98, 0.07, 0.66), materials.trim);
562
- band.position.y = 1.44;
563
- band.castShadow = false;
564
- parts.push(band);
565
-
566
- bakeByMaterial(parts, group);
567
- const nameplate = createTargetNameplate();
568
- nameplate.position.y = 2.2;
569
- group.add(nameplate);
570
- return group;
132
+ export function ball(radius: number, material: Material, options: IShapeOptions = {}): Mesh {
133
+ const segments = options.segments ?? 16;
134
+ const geometry = new SphereGeometry(radius, segments, Math.max(6, Math.round(segments / 2)));
135
+ return shadowed(new Mesh(geometry, material), options);
571
136
  }
572
137
 
573
- /**
574
- * The friendly: a hovering escort drone.
575
- *
576
- * `Play.ts` places this at y = 1 — it is a *drone*, and it hovers. Authored as an upright figure
577
- * it read as a teal fencepost standing in mid-air right down the player's sightline, which is the
578
- * worst possible shape for the one object in the arena they must not shoot. Wider than it is tall,
579
- * with a lit ring, it reads as friendly kit at a glance.
580
- *
581
- * It stays narrow across the beam: it has to stand in the player's line of fire for the
582
- * friendly-layer proof to mean anything, and at 0.9 m across that put a cyan wall two metres in
583
- * front of the eye.
584
- */
585
- export function createFriendlyVisual(materials: ShooterMaterials): Group {
586
- const group = new Group();
587
- const parts: Mesh[] = [];
588
- const hull = block(0.42, 0.24, 0.36, materials.player);
589
- parts.push(hull);
590
- const belly = block(0.26, 0.16, 0.22, materials.shadow);
591
- belly.position.y = -0.18;
592
- parts.push(belly);
593
- const visor = new Mesh(compactBox(0.3, 0.08, 0.05), materials.trim);
594
- visor.position.set(0, 0.02, -0.2);
595
- visor.castShadow = false;
596
- parts.push(visor);
597
- // Four rotor arms and a lit ring, so it reads as a drone and not as a floating brick.
598
- for (const [x, z] of [
599
- [-1, -1],
600
- [1, -1],
601
- [-1, 1],
602
- [1, 1],
603
- ] as const) {
604
- const arm = block(0.2, 0.05, 0.2, materials.shadow);
605
- arm.position.set(x * 0.26, 0.06, z * 0.24);
606
- parts.push(arm);
607
- const rotor = new Mesh(compactBox(0.3, 0.02, 0.3), materials.player);
608
- rotor.position.set(x * 0.34, 0.12, z * 0.3);
609
- rotor.castShadow = false;
610
- parts.push(rotor);
611
- }
612
- const ring = new Mesh(compactBox(0.56, 0.03, 0.5), materials.trim);
613
- ring.position.y = -0.12;
614
- ring.castShadow = false;
615
- parts.push(ring);
616
- const beacon = new Mesh(new CylinderGeometry(0.02, 0.02, 0.22, 5), materials.trim);
617
- beacon.position.y = 0.22;
618
- parts.push(beacon);
619
- bakeByMaterial(parts, group);
620
- return group;
138
+ export function tube(
139
+ radiusTop: number,
140
+ radiusBottom: number,
141
+ height: number,
142
+ material: Material,
143
+ options: IShapeOptions = {},
144
+ ): Mesh {
145
+ const geometry = new CylinderGeometry(radiusTop, radiusBottom, height, options.segments ?? 16);
146
+ return shadowed(new Mesh(geometry, material), options);
621
147
  }
622
148
 
623
- export function createWallVisual(materials: ShooterMaterials): Mesh {
624
- return block(0.65, 2.8, 2.8, materials.shadow);
149
+ export function spike(
150
+ radius: number,
151
+ height: number,
152
+ material: Material,
153
+ options: IShapeOptions = {},
154
+ ): Mesh {
155
+ const geometry = new ConeGeometry(radius, height, options.segments ?? 14);
156
+ return shadowed(new Mesh(geometry, material), options);
625
157
  }
626
158
 
627
- export function createPickupVisual(materials: ShooterMaterials): Group {
628
- const group = new Group();
629
- const base = block(0.65, 0.12, 0.65, materials.trim);
630
- base.position.y = 0.06;
631
- group.add(base);
632
- const orb = new Mesh(new SphereGeometry(0.25, 4, 3), materials.player);
633
- orb.position.y = 0.45;
634
- orb.castShadow = true;
635
- group.add(orb);
636
- const animated = new Mesh(
637
- new PlaneGeometry(0.9, 0.9),
638
- new MeshBasicMaterial({
639
- depthWrite: false,
640
- map: createPickupAtlas(),
641
- side: DoubleSide,
642
- transparent: true,
643
- }),
644
- );
645
- animated.name = "pickup-animation";
646
- animated.position.y = 0.7;
647
- group.add(animated);
648
- return group;
159
+ /** A smooth prop for the starter scene. */
160
+ export function sculpture(material: Material): Mesh {
161
+ // 128 × 24 is 6,144 triangles. The old 500 × 100 mesh pushed 100k triangles
162
+ // through the colour, shadow and bloom passes for no visible gain.
163
+ const geometry = new TorusKnotGeometry(1.35, 0.38, 128, 24);
164
+ return shadowed(new Mesh(geometry, material), {});
649
165
  }
650
166
 
651
- export function createProjectileVisual(materials: ShooterMaterials): Mesh {
652
- return shadowed(new Mesh(new SphereGeometry(0.12, 4, 3), materials.trim), false);
167
+ /**
168
+ * Deterministic PRNG. Never Math.random: the world has to be byte-identical on
169
+ * every reload or a screenshot diff means nothing and you cannot tell a bug
170
+ * from a reroll.
171
+ */
172
+ export function makeRandom(seed = 1337): () => number {
173
+ let state = seed >>> 0;
174
+ return () => {
175
+ state = (state * 1664525 + 1013904223) >>> 0;
176
+ return state / 4294967296;
177
+ };
653
178
  }