create-threenative 0.2.6 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (622) hide show
  1. package/README.md +2 -2
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +431 -20
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +555 -21
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +294 -55
  19. package/dist/threenative.js +714 -154
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rts/AGENTS.md +96 -0
  218. package/templates/rts/CLAUDE.md +98 -0
  219. package/templates/rts/kit.json +7 -0
  220. package/templates/{defense → rts}/package.json +13 -7
  221. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  222. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  223. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  224. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  225. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  226. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  227. package/templates/rts/playtests/survives.playtest.json +58 -0
  228. package/templates/rts/public/favicon.svg +4 -0
  229. package/templates/rts/src/game.ts +64 -0
  230. package/templates/rts/src/orders.ts +22 -0
  231. package/templates/rts/src/render/army.ts +346 -0
  232. package/templates/rts/src/render/camera.ts +123 -0
  233. package/templates/rts/src/render/lighting.ts +61 -0
  234. package/templates/rts/src/render/loading.ts +33 -0
  235. package/templates/rts/src/render/materials.ts +152 -0
  236. package/templates/rts/src/render/models.ts +705 -0
  237. package/templates/rts/src/render/palette.ts +17 -0
  238. package/templates/rts/src/render/picking.ts +93 -0
  239. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  240. package/templates/rts/src/render/quality.ts +128 -0
  241. package/templates/rts/src/render/resources.ts +141 -0
  242. package/templates/rts/src/render/sky.ts +44 -0
  243. package/templates/rts/src/render/terrain.ts +116 -0
  244. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  245. package/templates/rts/src/scenes/Play.ts +650 -0
  246. package/templates/rts/src/sim/ai.ts +1140 -0
  247. package/templates/rts/src/sim/combat.ts +416 -0
  248. package/templates/rts/src/sim/construction.ts +374 -0
  249. package/templates/rts/src/sim/economy.ts +167 -0
  250. package/templates/rts/src/sim/game.ts +1082 -0
  251. package/templates/rts/src/sim/movement.ts +371 -0
  252. package/templates/rts/src/sim/nav.ts +276 -0
  253. package/templates/rts/src/sim/production.ts +180 -0
  254. package/templates/rts/src/sim/terrain.ts +170 -0
  255. package/templates/rts/src/sim/types.ts +647 -0
  256. package/templates/rts/src/sim/vision.ts +46 -0
  257. package/templates/rts/src/state.ts +100 -0
  258. package/templates/{defense → rts}/src/style.css +21 -8
  259. package/templates/rts/src/ui/App.tsx +21 -0
  260. package/templates/rts/src/ui/Commands.tsx +129 -0
  261. package/templates/rts/src/ui/GameUi.tsx +22 -0
  262. package/templates/rts/src/ui/Hud.tsx +165 -0
  263. package/templates/rts/src/ui/Minimap.tsx +84 -0
  264. package/templates/rts/tailwind.config.ts +2 -0
  265. package/templates/rts/threenative.config.ts +56 -0
  266. package/templates/rts/tsconfig.json +17 -0
  267. package/templates/{defense → rts}/vite.config.ts +4 -1
  268. package/templates/runner/AGENTS.md +6 -10
  269. package/templates/runner/CLAUDE.md +6 -10
  270. package/templates/runner/README.md +3 -3
  271. package/templates/runner/package.json +13 -7
  272. package/templates/runner/playtests/performance.playtest.json +2 -2
  273. package/templates/runner/src/conventions.ts +4 -3
  274. package/templates/runner/src/entities/Runner.ts +54 -7
  275. package/templates/runner/src/game.ts +2 -0
  276. package/templates/runner/src/render/camera.ts +4 -2
  277. package/templates/runner/src/render/dust.ts +5 -2
  278. package/templates/runner/src/render/lighting.ts +41 -45
  279. package/templates/runner/src/render/loading.ts +2 -2
  280. package/templates/runner/src/render/materials.ts +165 -25
  281. package/templates/runner/src/render/palette.ts +17 -28
  282. package/templates/runner/src/render/postprocessing.ts +12 -2
  283. package/templates/runner/src/render/quality.ts +42 -96
  284. package/templates/runner/src/render/shapes.ts +59 -37
  285. package/templates/runner/src/render/sky.ts +32 -41
  286. package/templates/runner/src/render/touch-controls.ts +1 -1
  287. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  288. package/templates/runner/src/scenes/Run.ts +26 -6
  289. package/templates/runner/src/track.ts +6 -1
  290. package/templates/runner/threenative.config.ts +14 -1
  291. package/templates/runner/vite.config.ts +4 -1
  292. package/templates/sailing/AGENTS.md +12 -12
  293. package/templates/sailing/CLAUDE.md +12 -12
  294. package/templates/sailing/assets/ship.glb +0 -0
  295. package/templates/sailing/package.json +13 -7
  296. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  297. package/templates/sailing/playtests/sails.playtest.json +33 -0
  298. package/templates/sailing/playtests/win.playtest.json +156 -8
  299. package/templates/sailing/src/conventions.ts +29 -2
  300. package/templates/sailing/src/entities/Ship.ts +381 -57
  301. package/templates/sailing/src/game.ts +14 -0
  302. package/templates/sailing/src/render/camera.ts +63 -9
  303. package/templates/sailing/src/render/lighting.ts +49 -27
  304. package/templates/sailing/src/render/materials.ts +50 -15
  305. package/templates/sailing/src/render/ocean.ts +647 -60
  306. package/templates/sailing/src/render/palette.ts +16 -12
  307. package/templates/sailing/src/render/postprocessing.ts +12 -2
  308. package/templates/sailing/src/render/props.ts +316 -442
  309. package/templates/sailing/src/render/quality.ts +14 -4
  310. package/templates/sailing/src/render/sky.ts +116 -23
  311. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  312. package/templates/sailing/src/scenes/Boot.ts +21 -0
  313. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  314. package/templates/sailing/src/state.ts +6 -0
  315. package/templates/sailing/src/ui/Hud.tsx +41 -9
  316. package/templates/sailing/threenative.config.ts +14 -1
  317. package/templates/sailing/vite.config.ts +4 -1
  318. package/templates/shooter/AGENTS.md +27 -42
  319. package/templates/shooter/CLAUDE.md +27 -42
  320. package/templates/shooter/index.html +1 -0
  321. package/templates/shooter/package.json +13 -7
  322. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  323. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  324. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  325. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  326. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  327. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  328. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  329. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  330. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  331. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  332. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  333. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  334. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  335. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  336. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  337. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  338. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  339. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  340. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  341. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  342. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  343. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  344. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  345. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  346. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  347. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  348. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  349. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  350. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  351. package/templates/shooter/playtests/performance.playtest.json +62 -26
  352. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  353. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  354. package/templates/shooter/playtests/survives.playtest.json +36 -30
  355. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  356. package/templates/shooter/src/entities/Breakables.ts +412 -0
  357. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  358. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  359. package/templates/shooter/src/entities/Rifle.ts +442 -0
  360. package/templates/shooter/src/entities/Target.ts +199 -83
  361. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  362. package/templates/shooter/src/game.ts +75 -41
  363. package/templates/shooter/src/main.ts +0 -1
  364. package/templates/shooter/src/postPhysics.ts +36 -0
  365. package/templates/shooter/src/render/camera.ts +78 -74
  366. package/templates/shooter/src/render/decals.ts +142 -82
  367. package/templates/shooter/src/render/facade.ts +1373 -0
  368. package/templates/shooter/src/render/gunfx.ts +704 -0
  369. package/templates/shooter/src/render/lighting.ts +52 -38
  370. package/templates/shooter/src/render/loading.ts +2 -2
  371. package/templates/shooter/src/render/materials.ts +100 -88
  372. package/templates/shooter/src/render/occlusion.ts +108 -0
  373. package/templates/shooter/src/render/palette.ts +10 -10
  374. package/templates/shooter/src/render/palm.ts +455 -0
  375. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  376. package/templates/shooter/src/render/postprocessing.ts +15 -3
  377. package/templates/shooter/src/render/quality.ts +40 -82
  378. package/templates/shooter/src/render/scale.ts +148 -15
  379. package/templates/shooter/src/render/shapes.ts +138 -613
  380. package/templates/shooter/src/render/sky.ts +35 -35
  381. package/templates/shooter/src/render/town-schematic.ts +120 -0
  382. package/templates/shooter/src/render/town.ts +986 -0
  383. package/templates/shooter/src/render/townMaterials.ts +160 -0
  384. package/templates/shooter/src/render/vehicles.ts +741 -0
  385. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  386. package/templates/shooter/src/scenes/Play.ts +727 -650
  387. package/templates/shooter/src/state.ts +26 -41
  388. package/templates/shooter/src/style.css +207 -11
  389. package/templates/shooter/src/surfaces.ts +131 -0
  390. package/templates/shooter/src/ui/App.tsx +9 -10
  391. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  392. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  393. package/templates/shooter/src/ui/Hud.tsx +428 -39
  394. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  395. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  396. package/templates/shooter/src/ui/main.tsx +2 -3
  397. package/templates/shooter/threenative.config.ts +14 -1
  398. package/templates/shooter/vite.config.ts +4 -1
  399. package/templates/starter/AGENTS.md +17 -17
  400. package/templates/starter/CLAUDE.md +17 -17
  401. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  402. package/templates/starter/package.json +13 -7
  403. package/templates/starter/playtests/play.playtest.json +2 -1
  404. package/templates/starter/playtests/survives.playtest.json +1 -1
  405. package/templates/starter/src/conventions.ts +6 -3
  406. package/templates/starter/src/entities/Goal.ts +35 -42
  407. package/templates/starter/src/entities/Player.ts +99 -16
  408. package/templates/starter/src/render/arena.ts +131 -0
  409. package/templates/starter/src/render/lighting.ts +27 -44
  410. package/templates/starter/src/render/materials.ts +164 -35
  411. package/templates/starter/src/render/palette.ts +16 -16
  412. package/templates/starter/src/render/postprocessing.ts +6 -7
  413. package/templates/starter/src/render/quality.ts +43 -101
  414. package/templates/starter/src/render/shapes.ts +1 -1
  415. package/templates/starter/src/render/sky.ts +39 -45
  416. package/templates/starter/src/render/touch-controls.ts +3 -1
  417. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  418. package/templates/starter/src/scenes/Play.ts +82 -81
  419. package/templates/starter/threenative.config.ts +14 -1
  420. package/templates/starter/vite.config.ts +4 -1
  421. package/templates/tower-defense/.codex/config.toml +19 -0
  422. package/templates/tower-defense/.cursor/mcp.json +32 -0
  423. package/templates/tower-defense/.gemini/settings.json +32 -0
  424. package/templates/tower-defense/.mcp.json +32 -0
  425. package/templates/tower-defense/.vscode/mcp.json +36 -0
  426. package/templates/tower-defense/.zed/settings.json +36 -0
  427. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  428. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  429. package/templates/tower-defense/README.md +16 -0
  430. package/templates/tower-defense/index.html +12 -0
  431. package/templates/tower-defense/kit.json +7 -0
  432. package/templates/tower-defense/opencode.json +41 -0
  433. package/templates/tower-defense/package.json +56 -0
  434. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  435. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  436. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  437. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  438. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  439. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  440. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  441. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  442. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  443. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  444. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  445. package/templates/tower-defense/src/balance.ts +187 -0
  446. package/templates/tower-defense/src/board/Board.ts +100 -0
  447. package/templates/tower-defense/src/board/Route.ts +84 -0
  448. package/templates/tower-defense/src/camera-rig.ts +62 -0
  449. package/templates/tower-defense/src/economy.ts +64 -0
  450. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  451. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  452. package/templates/tower-defense/src/game.ts +72 -0
  453. package/templates/tower-defense/src/intents.ts +21 -0
  454. package/templates/tower-defense/src/main.ts +15 -0
  455. package/templates/tower-defense/src/physics.ts +6 -0
  456. package/templates/tower-defense/src/render/camera.ts +38 -0
  457. package/templates/tower-defense/src/render/lighting.ts +42 -0
  458. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  459. package/templates/tower-defense/src/render/materials.ts +103 -0
  460. package/templates/tower-defense/src/render/palette.ts +58 -0
  461. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  462. package/templates/tower-defense/src/render/quality.ts +128 -0
  463. package/templates/tower-defense/src/render/shapes.ts +550 -0
  464. package/templates/tower-defense/src/render/sky.ts +27 -0
  465. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  466. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  467. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  468. package/templates/tower-defense/src/state.ts +88 -0
  469. package/templates/tower-defense/src/style.css +137 -0
  470. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  471. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  472. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  473. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  474. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  475. package/templates/tower-defense/src/ui/main.tsx +14 -0
  476. package/templates/tower-defense/src/waves.ts +90 -0
  477. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  478. package/templates/tower-defense/vite.config.ts +41 -0
  479. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  480. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  481. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  482. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  483. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  484. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  485. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  486. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  487. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  488. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  489. package/agent-files/AGENT-ROLES.md +0 -26
  490. package/templates/action-rpg/src/render/shapes.ts +0 -269
  491. package/templates/action-rpg/src/render/types.ts +0 -3
  492. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  493. package/templates/defense/README.md +0 -10
  494. package/templates/defense/kit.json +0 -7
  495. package/templates/defense/playtests/leak.playtest.json +0 -23
  496. package/templates/defense/playtests/placement.playtest.json +0 -40
  497. package/templates/defense/playtests/scan.playtest.json +0 -20
  498. package/templates/defense/playtests/survive.playtest.json +0 -45
  499. package/templates/defense/playtests/survives.playtest.json +0 -36
  500. package/templates/defense/src/attackers/Attacker.ts +0 -120
  501. package/templates/defense/src/board/Route.ts +0 -94
  502. package/templates/defense/src/conventions.ts +0 -18
  503. package/templates/defense/src/economy.ts +0 -36
  504. package/templates/defense/src/entities/Player.ts +0 -52
  505. package/templates/defense/src/game.ts +0 -51
  506. package/templates/defense/src/physics.ts +0 -13
  507. package/templates/defense/src/placement/Buildable.ts +0 -49
  508. package/templates/defense/src/render/camera.ts +0 -16
  509. package/templates/defense/src/render/lighting.ts +0 -37
  510. package/templates/defense/src/render/materials.ts +0 -22
  511. package/templates/defense/src/render/palette.ts +0 -28
  512. package/templates/defense/src/render/quality.ts +0 -170
  513. package/templates/defense/src/render/shapes.ts +0 -246
  514. package/templates/defense/src/render/sky.ts +0 -45
  515. package/templates/defense/src/scenes/Boot.ts +0 -12
  516. package/templates/defense/src/scenes/Defense.ts +0 -231
  517. package/templates/defense/src/state.ts +0 -56
  518. package/templates/defense/src/towers/Tower.ts +0 -95
  519. package/templates/defense/src/towers/targeting.ts +0 -53
  520. package/templates/defense/src/ui/Hud.tsx +0 -62
  521. package/templates/defense/src/ui/Menu.tsx +0 -7
  522. package/templates/defense/src/waves.ts +0 -40
  523. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  524. package/templates/minimal/src/render/hud.ts +0 -69
  525. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  526. package/templates/platformer/playtests/chase.playtest.json +0 -21
  527. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  528. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  529. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  530. package/templates/platformer/playtests/physics.playtest.json +0 -14
  531. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  532. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  533. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  534. package/templates/platformer/src/conventions.ts +0 -18
  535. package/templates/platformer/src/entities/Character.ts +0 -286
  536. package/templates/platformer/src/entities/Chaser.ts +0 -118
  537. package/templates/platformer/src/entities/Patrol.ts +0 -93
  538. package/templates/platformer/src/level/Platform.ts +0 -46
  539. package/templates/platformer/src/render/rig.ts +0 -60
  540. package/templates/platformer/src/render/terrain.ts +0 -31
  541. package/templates/platformer/src/scenes/Level.ts +0 -241
  542. package/templates/puzzle/README.md +0 -43
  543. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  544. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  545. package/templates/puzzle/src/conventions.ts +0 -25
  546. package/templates/puzzle/src/entities/Ball.ts +0 -70
  547. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  548. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  549. package/templates/puzzle/src/physics.ts +0 -19
  550. package/templates/puzzle/src/room.ts +0 -83
  551. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  552. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  553. package/templates/shooter/playtests/combat.playtest.json +0 -48
  554. package/templates/shooter/playtests/fail.playtest.json +0 -31
  555. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  556. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  557. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  558. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  559. package/templates/shooter/src/combat/damage.ts +0 -40
  560. package/templates/shooter/src/conventions.ts +0 -51
  561. package/templates/shooter/src/entities/Pickup.ts +0 -70
  562. package/templates/shooter/src/entities/Player.ts +0 -310
  563. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  564. package/templates/shooter/src/playtest-events.ts +0 -15
  565. package/templates/shooter/src/render/touch-controls.ts +0 -305
  566. package/templates/shooter/src/render/types.ts +0 -3
  567. package/templates/shooter/src/render/ui.css +0 -330
  568. package/templates/shooter/src/render/ui.ts +0 -75
  569. package/templates/shooter/src/render/vfx.ts +0 -215
  570. package/templates/shooter/src/ui/Menu.tsx +0 -41
  571. package/templates/shooter/src/waves.ts +0 -50
  572. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  573. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  574. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  575. package/templates/starter/playtests/assets.playtest.json +0 -65
  576. package/templates/starter/playtests/buffer.playtest.json +0 -79
  577. package/templates/starter/playtests/cloth.playtest.json +0 -113
  578. package/templates/starter/playtests/coyote.playtest.json +0 -87
  579. package/templates/starter/playtests/gameover.playtest.json +0 -66
  580. package/templates/starter/playtests/goal.playtest.json +0 -67
  581. package/templates/starter/playtests/look.playtest.json +0 -175
  582. package/templates/starter/playtests/models-baseline.png +0 -0
  583. package/templates/starter/playtests/models.playtest.json +0 -74
  584. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  585. package/templates/starter/playtests/odometer.playtest.json +0 -54
  586. package/templates/starter/playtests/restart.playtest.json +0 -91
  587. package/templates/starter/playtests/seed.playtest.json +0 -54
  588. package/templates/starter/playtests/textures-baseline.png +0 -0
  589. package/templates/starter/playtests/textures.playtest.json +0 -74
  590. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  591. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  592. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  593. package/templates/starter/src/render/coast.ts +0 -199
  594. package/templates/starter/src/render/hero.ts +0 -88
  595. package/templates/starter/src/render/implicitSurface.ts +0 -199
  596. package/templates/starter/src/render/kuwahara.ts +0 -174
  597. package/templates/starter/src/render/outline.ts +0 -141
  598. package/templates/starter/src/render/painterly.ts +0 -86
  599. package/templates/starter/src/render/rockRidge.ts +0 -198
  600. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  601. package/templates/starter/src/render/scenery.ts +0 -40
  602. package/templates/starter/src/render/textureLifetime.ts +0 -53
  603. package/templates/starter/src/render/water.ts +0 -38
  604. package/templates/starter/src/render/watercolor.ts +0 -85
  605. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  606. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  607. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  608. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  609. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  610. /package/templates/{defense → rts}/.mcp.json +0 -0
  611. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  612. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  613. /package/templates/{defense → rts}/index.html +0 -0
  614. /package/templates/{defense → rts}/opencode.json +0 -0
  615. /package/templates/{defense → rts}/src/main.ts +0 -0
  616. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  617. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  618. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  619. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  620. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  621. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  622. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -0,0 +1,986 @@
1
+ // The Bayview town itself: an 84 m whitewashed Mediterranean block laid out
2
+ // per docs/bayview-design.md — CT spawn north, T spawn south, A site west,
3
+ // B site east, mid in the centre, raised decks (back plat, heaven, catwalk),
4
+ // the waterfront dock, crates, barrels and palms between the lanes. The palms
5
+ // themselves are geometry-heavy enough to own a file: see `palm.ts`.
6
+ //
7
+ // Buildings form continuous street walls along every lane (the references are
8
+ // dense white blocks, never scattered boxes), heights step between neighbours
9
+ // 5–9.2 m with setback storeys and slim towers, every roofline carries a
10
+ // parapet plus water tanks / AC boxes / antenna masts / vents, and every
11
+ // lane-facing face gets blue doors, shutter pairs, balconies and striped
12
+ // awnings from one deterministic hash so replays render identically.
13
+ //
14
+ // Everything solid goes into `hittable` (the raycast stops there) and gets a
15
+ // collider; raised decks sit overhead so ground navigation ignores them while
16
+ // their posts still block it. Site letters are built from boxes because
17
+ // CanvasTexture samples black under WebGPURenderer.
18
+ import {
19
+ BoxGeometry,
20
+ BufferGeometry,
21
+ CatmullRomCurve3,
22
+ CylinderGeometry,
23
+ Group,
24
+ Line,
25
+ Mesh,
26
+ PlaneGeometry,
27
+ RingGeometry,
28
+ Vector3,
29
+ } from "three";
30
+ import type { TargetSpec } from "../entities/Target.js";
31
+ // Impact surfaces are stamped here at construction so audio, VFX and any later
32
+ // consumer read one tag off the mesh instead of re-deriving name tables.
33
+ import { tagSurfaces } from "../surfaces.js";
34
+ import {
35
+ BAYVIEW_ARCHES,
36
+ FACE_INDEX,
37
+ FACE_NORMAL,
38
+ type Face,
39
+ addArchGateway,
40
+ addDoorsAndShutters,
41
+ addRoofLife,
42
+ createFacade,
43
+ finishFacade,
44
+ visibleFaces,
45
+ } from "./facade.js";
46
+ import { worldGridUVs } from "./materials.js";
47
+ import { type PalmPlacement, addPalms } from "./palm.js";
48
+ import { unitCylinder } from "./shapes.js";
49
+ import { gridSolid } from "./townMaterials.js";
50
+ import type { TownMaterials } from "./townMaterials.js";
51
+ import { type BoatPlacement, type VanPlacement, addFishingBoat, addVan } from "./vehicles.js";
52
+
53
+ import {
54
+ A_SITE_MARK,
55
+ A_SITE_PLAZA,
56
+ BACK_PLAT_DECK,
57
+ CATWALK_DECK,
58
+ type DeckFootprint,
59
+ HEAVEN_DECK,
60
+ type ITownSchematic,
61
+ MID_COURTYARD_PLAZA,
62
+ PIER,
63
+ type SchematicRect,
64
+ TOWN_HALF,
65
+ WATER_X,
66
+ townSchematic,
67
+ } from "./town-schematic.js";
68
+
69
+ // The map data lives beside this file rather than in it, so the UI layer can read it without the
70
+ // renderer. Re-exported because the rest of the game imports these from `town.js`.
71
+ export {
72
+ type DeckFootprint,
73
+ type ITownSchematic,
74
+ type SchematicRect,
75
+ TOWN_HALF,
76
+ WATER_X,
77
+ townSchematic,
78
+ };
79
+
80
+ export const TOWN = 84;
81
+ /** Slab thickness of the raised decks. */
82
+ const DECK_THICKNESS = 0.4;
83
+
84
+ export type TownCollider = {
85
+ readonly min: readonly [number, number, number];
86
+ readonly max: readonly [number, number, number];
87
+ };
88
+
89
+ export type TownSpawn = { x: number; z: number; yaw: number };
90
+ export type TownRoute = readonly Vector3[];
91
+
92
+ export type Town = {
93
+ readonly group: Group;
94
+ /** Every solid the round and the sight lines meet. */
95
+ readonly hittable: Mesh[];
96
+ readonly colliders: TownCollider[];
97
+ readonly spawn: TownSpawn;
98
+ readonly targets: TargetSpec[];
99
+ /** Ground-level patrol loops, one per soldier. */
100
+ readonly enemyRoutes: readonly TownRoute[];
101
+ /** Raised deck footprints, for the under-the-deck observation. */
102
+ readonly decks: readonly DeckFootprint[];
103
+ /** Overhead-map data traced from the same constants that built the scene. */
104
+ readonly schematic: ITownSchematic;
105
+ };
106
+
107
+ /** Deterministic layout hash: identical across runs, so replays match. */
108
+ const hash = (n: number): number => {
109
+ const s = Math.sin(n * 127.1 + 311.7) * 43758.5453;
110
+ return s - Math.floor(s);
111
+ };
112
+
113
+ /**
114
+ * Building blocks: footprints tile the map except where the lanes, sites and
115
+ * courtyards run; neighbours abut so streets read as continuous walls.
116
+ * Heights 5–9.2 m step between neighbours; `top` adds a setback storey.
117
+ */
118
+ type BuildingSpec = {
119
+ readonly x: readonly [number, number];
120
+ readonly z: readonly [number, number];
121
+ readonly h: number;
122
+ readonly brick?: boolean;
123
+ /** Lane-facing faces that receive doors, shutters, balconies, awnings. */
124
+ readonly j?: readonly Face[];
125
+ readonly tank?: boolean;
126
+ readonly mast?: boolean;
127
+ readonly ac?: boolean;
128
+ /** Setback upper storey: `i` metres inset each side, `h` extra height. */
129
+ readonly top?: { readonly i: number; readonly h: number };
130
+ };
131
+
132
+ const BUILDINGS: readonly BuildingSpec[] = [
133
+ // North band (z −42…−30): CT yard stays open at x −4…14.
134
+ { x: [-42, -27], z: [-42, -30], h: 7.2 },
135
+ { x: [-27, -16], z: [-42, -30], h: 6.2, brick: true },
136
+ { x: [-16, -4], z: [-42, -30], h: 8.8, j: ["s"], tank: true, top: { i: 2, h: 1.6 } },
137
+ { x: [14, 29], z: [-42, -30], h: 6.4, j: ["w", "s"] },
138
+ { x: [29, 42], z: [-42, -30], h: 7.6, tank: true, top: { i: 2.5, h: 1.8 } },
139
+
140
+ // Band z −30…−22: CT-ramp stair apron stays open around x 1.4…4.6.
141
+ { x: [-42, -24], z: [-30, -22], h: 5.6, j: ["e"] },
142
+ { x: [-24, -14], z: [-30, -22], h: 6.8, brick: true, j: ["e"] },
143
+ { x: [-14, -4], z: [-30, -22], h: 5.2, j: ["e"] },
144
+ { x: [12, 20], z: [-30, -22], h: 6.8, j: ["n", "w", "e"], ac: true, top: { i: 2, h: 1.5 } },
145
+
146
+ // Back-plat row z −22…−10: the plat itself rides overhead at x 0…12.
147
+ { x: [-42, -36], z: [-22, -10], h: 6.4, j: ["e"] },
148
+ { x: [-36, -20], z: [-22, -10], h: 5.4, brick: true, j: ["e"], tank: true },
149
+ { x: [12, 20], z: [-20, -10], h: 6.8, j: ["n", "w", "e"], ac: true, top: { i: 2, h: 1.5 } },
150
+ { x: [10, 16], z: [-8, -1], h: 5.4, j: ["n", "s", "w"] },
151
+ // South and east faces both front the B-site plaza beside the catwalk stair,
152
+ // so they carry joinery; an undressed face here reads as greybox from the site.
153
+ { x: [16, 20], z: [-8, -1], h: 7.5, j: ["s", "e"], mast: true },
154
+
155
+ // Mid-west wall between A site and mid, passage z 0…6 stays open.
156
+ { x: [-20, -8], z: [-8, 0], h: 5, j: ["n", "s", "e"] },
157
+
158
+ // West perimeter behind A site, with the tall corner tower.
159
+ { x: [-42, -36], z: [-10, -4], h: 9.2, j: ["e"], mast: true },
160
+ { x: [-42, -36], z: [-4, 10], h: 5.8, brick: true, j: ["e"] },
161
+ { x: [-42, -36], z: [10, 26], h: 6.2, j: ["e"] },
162
+ { x: [-36, -20], z: [10, 16], h: 5.6, j: ["n"] },
163
+ { x: [-36, -20], z: [16, 28], h: 5.8, j: ["e"] },
164
+
165
+ // South-central: T main flows between TW and TE to the junction square.
166
+ // Both flank the player's opening view, so they stay whitewashed plaster —
167
+ // the reference frame is white walls with only rare exposed-brick accents.
168
+ { x: [2, 10], z: [13, 24], h: 6.5, j: ["n", "w"], tank: true, top: { i: 1.6, h: 1.8 } },
169
+ { x: [-20, -12], z: [16, 28], h: 6, j: ["n", "e"], top: { i: 1.5, h: 1.7 } },
170
+
171
+ // East flank of mid and the connector's street walls.
172
+ { x: [15, 30], z: [10, 26], h: 6.2, j: ["n", "w", "e"], ac: true },
173
+ // The west face at x=15 is the whole right-hand wall of the T-spawn courtyard —
174
+ // the wall beside the player on spawn, and the most-looked-at surface in the game.
175
+ { x: [15, 30], z: [32, 42], h: 5.6, j: ["n", "e", "w"] },
176
+ { x: [30, 42], z: [28, 42], h: 7, j: ["n", "w"], tank: true, mast: true },
177
+ { x: [37, 42], z: [4, 30], h: 5.8, j: ["w"], top: { i: 1.8, h: 1.6 } },
178
+
179
+ // Waterfront rows: promenade and dock plaza stay open at x 30…42.
180
+ { x: [34, 42], z: [-16, -10], h: 5.4, j: ["w"] },
181
+ { x: [34, 42], z: [-2, 4], h: 6, j: ["w"], ac: true },
182
+ { x: [30, 42], z: [-30, -16], h: 6, tank: true },
183
+
184
+ // South band (z 26…42): T spawn courtyard x −9…9 stays open.
185
+ { x: [-42, -12], z: [28, 42], h: 6.4, j: ["e"] },
186
+ { x: [-9, 16], z: [38, 42], h: 5.5, j: ["n"] },
187
+ ];
188
+
189
+ /** The A site and mid-courtyard slabs are named because the minimap schematic
190
+ * traces these exact rectangles; the rest of the plazas stay anonymous. */
191
+
192
+ /** Site plazas, mid courtyard, T spawn and the dock read a shade apart. */
193
+ const PLAZAS: readonly {
194
+ readonly x: readonly [number, number];
195
+ readonly z: readonly [number, number];
196
+ readonly finish: "plazaWarm" | "plazaCool" | "plazaPale";
197
+ }[] = [
198
+ A_SITE_PLAZA,
199
+ { x: [16, 33], z: [-8, 11], finish: "plazaCool" }, // B site
200
+ MID_COURTYARD_PLAZA,
201
+ { x: [-9, 9], z: [26, 40], finish: "plazaWarm" }, // T spawn
202
+ { x: [33, 42], z: [-10, -1], finish: "plazaPale" }, // dock plaza
203
+ { x: [30, 34], z: [-16, 4], finish: "plazaCool" }, // promenade strip
204
+ ];
205
+
206
+ /** Crate stacks: [x, z], tiers of 0.72 m cubes; clusters hug walls and sites. */
207
+ const CRATES: readonly (readonly [number, number, number])[] = [
208
+ [-35.1, -6.6, 2], // A site, against the west perimeter wall
209
+ [-25.6, -6.0, 2], // A site, behind the standing plate
210
+ [-19.2, 1.6, 1], // A↔mid passage mouth
211
+ [-18.4, 2.6, 1],
212
+ [30.5, -0.5, 2], // B site anchor stack
213
+ [31.7, -1.2, 1],
214
+ [19, -13.5, 2], // quay-north pocket, against BE's east face
215
+ [22.5, 9.3, 2], // B site, against SE's north face
216
+ [-6.5, -6.4, 1], // mid north-west
217
+ [7.4, 6.6, 2], // mid south-east
218
+ [-7.4, 30.2, 1], // T spawn west
219
+ [-13, 14.6, 2], // junction square, against TW's north face
220
+ [-3, 15.6, 1],
221
+ [35.6, 8.2, 1], // outside long, against EW's west face
222
+ [36.4, 9.0, 1],
223
+ [36.2, -6.6, 1], // dock plaza
224
+ [3.4, -17.6, 1], // on the back plat
225
+ [26, -24.5, 1], // on heaven
226
+ ];
227
+
228
+ const BARRELS: readonly (readonly [number, number])[] = [
229
+ [-33.2, -6.4],
230
+ [-34.2, -4.9],
231
+ [33, 0.2],
232
+ [32.6, -2.4],
233
+ [20.4, -12.6],
234
+ [7.2, 7.9],
235
+ [-6.6, 29.4],
236
+ [-5.5, 30.2],
237
+ [34.7, 7.4],
238
+ [-4.3, -19.4], // back plat edge
239
+ [26.6, -23.2], // heaven
240
+ [36.2, -6.8],
241
+ ];
242
+
243
+ /**
244
+ * Palms, re-audited against the reference sheet and against playability.
245
+ *
246
+ * In the references the palms sit at the map's edges: the dock plaza, a plaza
247
+ * corner, the back of a spawn — never mid-lane. The previous table had two
248
+ * trees standing more than two metres INSIDE a building, one in the middle of
249
+ * the six-metre south corridor, one 0.8 m off a patrol line and 3 m from the
250
+ * plate the player shoots first, and one at the mouth of the A↔short-A route
251
+ * where it filled the centre of the screen. A palm in a sightline on a bomb
252
+ * map is a bug, so every entry here now hugs a building face or a plaza
253
+ * corner, clears every wall, and stays out of the lanes.
254
+ *
255
+ * Palms carry no collider and are not `hittable`, unchanged from before: the
256
+ * enemy nav grid and every committed ballistics scenario are written against
257
+ * the solids, and a trunk is too slim to be worth changing that for.
258
+ */
259
+ const PALMS: readonly PalmPlacement[] = [
260
+ [39.5, -8.6], // dock plaza, north end of the quay walk
261
+ [39.6, -3.6], // dock plaza, south end of the quay walk
262
+ [33.1, -8.9], // dock plaza west corner, clear of the promenade mouth
263
+ [35.9, 6.2], // outside long, tight into the north-east corner
264
+ [21.6, -14.6], // quay-north pocket behind the catwalk
265
+ [17.2, 30.6], // south corridor, hard against the north street wall
266
+ [-34.3, 8.6], // A site south-west corner
267
+ [-21.9, -7.5], // A site north-east corner, in the building return
268
+ [-10.6, 27.2], // T main, tucked behind TW's south-east corner
269
+ [-7.6, 36.6], // T spawn south-west corner, behind the player
270
+ [7.4, 36.4], // T spawn south-east corner, behind the player
271
+ [-2.7, -38.4], // CT spawn, back corner
272
+ [12.6, -38.6], // CT spawn, back corner
273
+ ];
274
+
275
+ /**
276
+ * The yellow panel van, parked against a T MAIN street wall.
277
+ *
278
+ * Placement is not a matter of taste here, so the reasoning is written down.
279
+ * The reference frame has the van against the lane's right-hand wall, which on
280
+ * this map is TE's west face at x = 2 — and that is the one wall it cannot
281
+ * have. The T-spawn opening view is a straight shot up x = 0 to the mid plate
282
+ * at (0, 9.9); a 1.9 m van hugging x = 2 leaves five centimetres of that
283
+ * sightline, which is a bug on a bomb map, not a prop. So it parks on the
284
+ * lane's other continuous wall, TW's east face at x = −12, where:
285
+ *
286
+ * * the body clears the wall by 0.47 m and the mirrors by 0.30 m, which is
287
+ * more than the 0.22 m a facade door surround stands proud;
288
+ * * the east flank stops at x = −9.2, so the mid-plate sightline is clear by
289
+ * over nine metres;
290
+ * * the T-main plate at (−11.9, 22) stays 1.2 m clear to the south, and the
291
+ * approach to it from T spawn never crosses the van;
292
+ * * the palm at (−10.6, 27.2) is four metres further south — the previous
293
+ * candidate spot was straight through it;
294
+ * * the nearest patrol leg, the west rover's (−16, 10) → (−7, 18), passes
295
+ * 2.5 m from the van's centre and about 1.3 m from its nearest corner.
296
+ *
297
+ * Nose points +z, at the player walking up from T spawn, like the reference.
298
+ */
299
+ const VANS: readonly VanPlacement[] = [{ x: -10.25, z: 18.4, yaw: -Math.PI / 2 + 0.05 }];
300
+
301
+ /**
302
+ * The fishing boat, moored on the north flank of the dock pier's outer half.
303
+ * Out over open water beyond the quay: no collider, nothing to snag, and every
304
+ * committed ballistics scenario is unaffected. Its hull spans z −10.76…−8.65
305
+ * against pier posts whose outer edge is at −8.12, so it clears them by half a
306
+ * metre even at the top of its roll.
307
+ */
308
+ const BOATS: readonly BoatPlacement[] = [
309
+ {
310
+ x: 51.5,
311
+ z: -9.7,
312
+ yaw: 0.1,
313
+ waterY: -1.1,
314
+ moorTo: [53.5, 0.05, -7.9],
315
+ },
316
+ ];
317
+
318
+ function addSolid(
319
+ group: Group,
320
+ colliders: TownCollider[],
321
+ hittable: Mesh[],
322
+ material: Mesh["material"],
323
+ size: readonly [number, number, number],
324
+ at: readonly [number, number, number],
325
+ name?: string,
326
+ ): Mesh {
327
+ // Its own geometry, in world space, with world-metre UVs. A shared unit box
328
+ // scaled per mesh is what let the projection instance these, and a grid cannot
329
+ // ride that: one unit box has one set of UVs, so a 30 m wall and a 0.78 m crate
330
+ // would show the same single tile. `worldGridUVs` needs world positions, so the
331
+ // box is built at size and translated rather than scaled.
332
+ const mesh = new Mesh(gridSolid(size, at), material);
333
+ if (name !== undefined) mesh.name = name;
334
+ mesh.castShadow = true;
335
+ mesh.receiveShadow = true;
336
+ group.add(mesh);
337
+ hittable.push(mesh);
338
+ colliders.push({
339
+ min: [at[0] - size[0] / 2, at[1] - size[1] / 2, at[2] - size[2] / 2],
340
+ max: [at[0] + size[0] / 2, at[1] + size[1] / 2, at[2] + size[2] / 2],
341
+ });
342
+ return mesh;
343
+ }
344
+
345
+ /** Pure decoration: no collider, never a bullet stop nor a sight blocker. */
346
+ function addProp(
347
+ group: Group,
348
+ material: Mesh["material"],
349
+ size: readonly [number, number, number],
350
+ at: readonly [number, number, number],
351
+ name?: string,
352
+ ): Mesh {
353
+ const mesh = new Mesh(gridSolid(size, at), material);
354
+ if (name !== undefined) mesh.name = name;
355
+ mesh.castShadow = false;
356
+ group.add(mesh);
357
+ return mesh;
358
+ }
359
+
360
+ // Frustum cylinders cannot share the unit cylinder's scale form, but the same
361
+ // frustum is built many times (bollards, pier posts), so they cache by shape —
362
+ // identical reasoning to `roundedBox`'s cache, one floor up.
363
+ const frustumCache = new Map<string, CylinderGeometry>();
364
+ function frustumCylinder(
365
+ radiusTop: number,
366
+ radiusBottom: number,
367
+ height: number,
368
+ segments: number,
369
+ ): CylinderGeometry {
370
+ const key = `${radiusTop},${radiusBottom},${height},${segments}`;
371
+ let geometry = frustumCache.get(key);
372
+ if (geometry === undefined) {
373
+ geometry = new CylinderGeometry(radiusTop, radiusBottom, height, segments);
374
+ frustumCache.set(key, geometry);
375
+ }
376
+ return geometry;
377
+ }
378
+
379
+ function addCylinderProp(
380
+ group: Group,
381
+ material: Mesh["material"],
382
+ radiusTop: number,
383
+ radiusBottom: number,
384
+ height: number,
385
+ segments: number,
386
+ at: readonly [number, number, number],
387
+ name?: string,
388
+ castsShadow = false,
389
+ ): Mesh {
390
+ // A straight cylinder is a shared unit cylinder scaled by (r, h, r); a
391
+ // frustum (top radius ≠ bottom) has no scale form and keeps its own geometry.
392
+ const frustum = radiusTop !== radiusBottom;
393
+ const source = frustum
394
+ ? frustumCylinder(radiusTop, radiusBottom, height, segments)
395
+ : unitCylinder(segments);
396
+ const mesh = new Mesh(
397
+ worldGridUVs(frustum ? source : source.clone().scale(radiusTop, height, radiusTop)),
398
+ material,
399
+ );
400
+ if (name !== undefined) mesh.name = name;
401
+ mesh.position.set(at[0], at[1], at[2]);
402
+ mesh.castShadow = castsShadow;
403
+ group.add(mesh);
404
+ return mesh;
405
+ }
406
+
407
+ /** Flat painted ring plus an extruded flat letter, both from box geometry. */
408
+ let siteRingGeometry: RingGeometry | undefined;
409
+ function ringGeometry(): RingGeometry {
410
+ siteRingGeometry ??= new RingGeometry(2.1, 2.75, 48);
411
+ return siteRingGeometry;
412
+ }
413
+
414
+ function addSiteMark(
415
+ group: Group,
416
+ materials: TownMaterials,
417
+ mark: (typeof SITE_MARKS)[number],
418
+ ): void {
419
+ const ring = new Mesh(ringGeometry(), materials.siteMark);
420
+ ring.rotation.x = -Math.PI / 2;
421
+ ring.position.set(mark.at[0], 0.015, mark.at[1]);
422
+ ring.receiveShadow = true;
423
+ group.add(ring);
424
+
425
+ const letter = new Group();
426
+ // Built upright in the XZ plane with up = −z, then turned to face the approach.
427
+ const stroke = (
428
+ size: readonly [number, number],
429
+ at: readonly [number, number],
430
+ tilt = 0,
431
+ ): void => {
432
+ const leg = new Mesh(worldGridUVs(new BoxGeometry(size[0], size[1], 0.03)), materials.siteMark);
433
+ leg.rotation.x = -Math.PI / 2;
434
+ leg.rotation.z = tilt;
435
+ leg.position.set(at[0], 0.026, at[1]);
436
+ letter.add(leg);
437
+ };
438
+ if (mark.letter === "A") {
439
+ stroke([0.34, 1.5], [-0.52, 0.1], 0.36);
440
+ stroke([0.34, 1.5], [0.52, 0.1], -0.36);
441
+ stroke([1.3, 0.3], [0, -0.28]);
442
+ } else {
443
+ stroke([0.3, 1.5], [-0.5, 0]);
444
+ stroke([0.3, 1.5], [0.5, 0]);
445
+ stroke([1.3, 0.3], [0, 0.68]);
446
+ stroke([1.3, 0.3], [0, 0]);
447
+ stroke([1.3, 0.3], [0, -0.68]);
448
+ }
449
+ // Readable from the approach face: the strokes were authored readable from
450
+ // +z (south), so turn by the inverse of the approach azimuth.
451
+ const normal = FACE_NORMAL[mark.approach];
452
+ letter.rotation.y = Math.atan2(normal[0], normal[1]);
453
+ letter.position.set(mark.at[0], 0, mark.at[1]);
454
+ group.add(letter);
455
+ }
456
+
457
+ /**
458
+ * Stepped stairs the character body actually climbs: visual steps plus one
459
+ * collider each. Works for descending flights too — each step is solid from
460
+ * the flight's low end up to that step's walking surface. A descending step
461
+ * landing exactly on its base is skipped so every collider stays positive.
462
+ */
463
+ function addStairs(
464
+ group: Group,
465
+ colliders: TownCollider[],
466
+ hittable: Mesh[],
467
+ material: Mesh["material"],
468
+ width: number,
469
+ from: readonly [number, number, number],
470
+ to: readonly [number, number, number],
471
+ ): void {
472
+ const dx = to[0] - from[0];
473
+ const dz = to[2] - from[2];
474
+ const dy = to[1] - from[1];
475
+ const run = Math.hypot(dx, dz);
476
+ const steps = Math.max(2, Math.ceil(Math.abs(dy) / 0.32));
477
+ const stepRun = run / steps;
478
+ const ux = dx / run;
479
+ const uz = dz / run;
480
+ const baseY = Math.min(from[1], to[1]);
481
+ for (let index = 0; index < steps; index += 1) {
482
+ const topY = from[1] + ((index + 1) / steps) * dy;
483
+ // A descending flight's last step lands exactly on its base: nothing to build.
484
+ if (topY - baseY < 0.01) continue;
485
+ const depth = stepRun + 0.3;
486
+ const centreX = from[0] + ux * stepRun * (index + 0.5);
487
+ const centreZ = from[2] + uz * stepRun * (index + 0.5);
488
+ const height = topY - baseY;
489
+ const size: readonly [number, number, number] = [
490
+ ux !== 0 ? depth : width,
491
+ height,
492
+ uz !== 0 ? depth : width,
493
+ ];
494
+ const mesh = new Mesh(gridSolid(size, [centreX, baseY + height / 2, centreZ]), material);
495
+ mesh.name = "stair-step";
496
+ mesh.castShadow = false;
497
+ mesh.receiveShadow = true;
498
+ group.add(mesh);
499
+ hittable.push(mesh);
500
+ colliders.push({
501
+ min: [centreX - size[0] / 2, baseY, centreZ - size[2] / 2],
502
+ max: [centreX + size[0] / 2, topY, centreZ + size[2] / 2],
503
+ });
504
+ }
505
+ }
506
+
507
+ /** Visual-only guard rail along a deck edge: posts and a top beam. */
508
+ function addRail(
509
+ group: Group,
510
+ material: Mesh["material"],
511
+ from: readonly [number, number],
512
+ to: readonly [number, number],
513
+ baseY: number,
514
+ ): void {
515
+ const ax = from[0];
516
+ const az = from[1];
517
+ const bx = to[0];
518
+ const bz = to[1];
519
+ const length = Math.hypot(bx - ax, bz - az);
520
+ if (length < 0.5) return;
521
+ const posts = Math.max(2, Math.round(length / 3) + 1);
522
+ for (let index = 0; index < posts; index += 1) {
523
+ const t = index / (posts - 1);
524
+ addCylinderProp(group, material, 0.035, 0.035, 0.95, 5, [
525
+ ax + (bx - ax) * t,
526
+ baseY + 0.475,
527
+ az + (bz - az) * t,
528
+ ]);
529
+ }
530
+ addProp(
531
+ group,
532
+ material,
533
+ ax === bx ? [0.07, 0.07, length] : [length, 0.07, 0.07],
534
+ [(ax + bx) / 2, baseY + 0.92, (az + bz) / 2],
535
+ "deck-rail",
536
+ );
537
+ }
538
+
539
+ /** The floor marks are named because the schematic's site letters trace their
540
+ * positions. */
541
+ const B_SITE_MARK = { at: [27, 3], letter: "B", approach: "w" } as const;
542
+
543
+ /** A site plaza, mid courtyard, B site plaza and T spawn stay open. */
544
+ const SITE_MARKS: readonly {
545
+ readonly at: readonly [number, number];
546
+ readonly letter: "A" | "B";
547
+ readonly approach: Face;
548
+ }[] = [A_SITE_MARK, B_SITE_MARK];
549
+
550
+ /** Rooftop power lines: thin dark catenary spans between neighbouring roofs,
551
+ * purely visual — they never block a bullet or a sight line. */
552
+ const WIRES: readonly (readonly [number, number, number, number, number, number])[] = [
553
+ // Across the CT yard: north band's tall setback storey to the north-east corner.
554
+ [-10, 9.4, -26, 20, 7.4, -36],
555
+ // Across mid: back-plat row's setback roof to the mid-west wall.
556
+ [16, 8.4, -15, -13, 6.0, -4],
557
+ // Across T main: the south-west block to TW's roofline.
558
+ [-16, 6.0, 22, 6, 7.5, 18],
559
+ // Across B site: the connector's street wall to outside-long's west face.
560
+ [22, 6.2, 18, 38, 6.8, 17],
561
+ // Along the waterfront: quay-north block to the B-site waterfront row.
562
+ [34, 6.0, -23, 36, 5.4, -13],
563
+ ];
564
+
565
+ /** One sagging wire: a three-point curve dipped below the chord. */
566
+ function addWire(
567
+ group: Group,
568
+ materials: TownMaterials,
569
+ wire: readonly [number, number, number, number, number, number],
570
+ ): void {
571
+ const [ax, ay, az, bx, by, bz] = wire;
572
+ const midX = (ax + bx) / 2;
573
+ const midY = (ay + by) / 2 - Math.hypot(bx - ax, bz - az) * 0.05 - 0.25;
574
+ const midZ = (az + bz) / 2;
575
+ const curve = new CatmullRomCurve3([
576
+ new Vector3(ax, ay, az),
577
+ new Vector3(midX, midY, midZ),
578
+ new Vector3(bx, by, bz),
579
+ ]);
580
+ const points = curve.getPoints(24);
581
+ const geometry = new BufferGeometry();
582
+ geometry.setFromPoints(points);
583
+ const wireLine = new Line(geometry, materials.steelMast);
584
+ wireLine.name = "roof-wire";
585
+ group.add(wireLine);
586
+ }
587
+
588
+ /**
589
+ * Raised-deck footprints, stated once and read three times: the deck meshes
590
+ * place themselves from these, the under-deck observation gets them as
591
+ * `Town.decks`, and the minimap schematic traces them — one edit moves all
592
+ * three. The numbers are the deck's walking surface extents on the ground
593
+ * plane; heights live with the meshes below.
594
+ */
595
+
596
+ export function buildTown(materials: TownMaterials): Town {
597
+ const group = new Group();
598
+ group.name = "town";
599
+ const hittable: Mesh[] = [];
600
+ const colliders: TownCollider[] = [];
601
+
602
+ // Street deck.
603
+ const deck = new Mesh(
604
+ worldGridUVs(new PlaneGeometry(TOWN, TOWN).rotateX(-Math.PI / 2)),
605
+ materials.ground,
606
+ );
607
+ deck.receiveShadow = true;
608
+ // Named "street", not "deck": the wood name rule exists for the pier and catwalk planking and
609
+ // matches any name containing "deck", so calling the stone street deck tagged the whole town
610
+ // floor as wood — wrong impact cue, wrong debris, wrong decal tint, on every ground shot.
611
+ deck.name = "street";
612
+ group.add(deck);
613
+ hittable.push(deck);
614
+
615
+ // Plaza tints read a shade apart from the lanes — kerb-edged slabs, never
616
+ // painted bitmaps (CanvasTexture samples black under WebGPURenderer).
617
+ for (const plaza of PLAZAS) {
618
+ const slab = new Mesh(
619
+ gridSolid(
620
+ [plaza.x[1] - plaza.x[0], 0.03, plaza.z[1] - plaza.z[0]],
621
+ [(plaza.x[0] + plaza.x[1]) / 2, 0.015, (plaza.z[0] + plaza.z[1]) / 2],
622
+ ),
623
+ materials[plaza.finish],
624
+ );
625
+ slab.name = "plaza";
626
+ slab.receiveShadow = true;
627
+ group.add(slab);
628
+ // Hittable, or a round fired at a plaza passes straight through the paving the player can
629
+ // see and registers on the street plane 3 cm below — which put every impact cue, burst and
630
+ // bullet hole on the wrong surface, and buried the hole inside the slab.
631
+ hittable.push(slab);
632
+ }
633
+
634
+ // Sea east of the quay, one huge plane well below street level, with pale
635
+ // shallows hugging the wall.
636
+ const water = new Mesh(new PlaneGeometry(220, 260), materials.water);
637
+ water.rotation.x = -Math.PI / 2;
638
+ water.position.set(WATER_X + 108, -1.1, -10);
639
+ group.add(water);
640
+ const shallows = new Mesh(
641
+ gridSolid([5.5, 0.04, 260], [WATER_X + 2.75, -0.96, -10]),
642
+ materials.shallow,
643
+ );
644
+ group.add(shallows);
645
+
646
+ // Quay wall along the east edge, with the dock gap z −10…−2 left open.
647
+ addSolid(
648
+ group,
649
+ colliders,
650
+ hittable,
651
+ materials.quay,
652
+ [1.4, 1.1, 32],
653
+ [WATER_X - 0.7, 0.55, -26],
654
+ "quay-n",
655
+ );
656
+ addSolid(
657
+ group,
658
+ colliders,
659
+ hittable,
660
+ materials.quay,
661
+ [1.4, 1.1, 44],
662
+ [WATER_X - 0.7, 0.55, 20],
663
+ "quay-s",
664
+ );
665
+ for (const z of [-20, -14, 6, 16, 26]) {
666
+ addCylinderProp(
667
+ group,
668
+ materials.steelPost,
669
+ 0.13,
670
+ 0.16,
671
+ 0.55,
672
+ 8,
673
+ [WATER_X - 0.7, 1.38, z],
674
+ "bollard",
675
+ true,
676
+ );
677
+ }
678
+
679
+ // Dock pier: plank deck on posts, running east into the water at the
680
+ // north-east waterfront from the PIER span above — the same numbers the
681
+ // schematic's centre-line draws.
682
+ const pierDeck = new Mesh(
683
+ gridSolid([PIER.x1 - PIER.x0, 0.24, 4.4], [(PIER.x0 + PIER.x1) / 2, 0.12, PIER.z]),
684
+ materials.deckWood,
685
+ );
686
+ pierDeck.name = "pier-deck";
687
+ pierDeck.castShadow = true;
688
+ pierDeck.receiveShadow = true;
689
+ group.add(pierDeck);
690
+ hittable.push(pierDeck);
691
+ colliders.push({
692
+ min: [PIER.x0, 0, -8.2],
693
+ max: [PIER.x1, 0.24, -3.8],
694
+ });
695
+ for (let index = 0; index < 4; index += 1) {
696
+ for (const side of [-1, 1]) {
697
+ const post = new Mesh(worldGridUVs(frustumCylinder(0.18, 0.22, 2.4, 6)), materials.deckWood);
698
+ post.name = "pier-post";
699
+ post.position.set(PIER.x0 + 2.5 + index * 5, -1.08, PIER.z + side * 1.9);
700
+ post.castShadow = true;
701
+ group.add(post);
702
+ }
703
+ }
704
+ for (const side of [-1, 1]) {
705
+ const railBeam = new Mesh(
706
+ gridSolid(
707
+ [PIER.x1 - PIER.x0, 0.07, 0.07],
708
+ [(PIER.x0 + PIER.x1) / 2, 1.16, PIER.z + side * 2.05],
709
+ ),
710
+ materials.steelMast,
711
+ );
712
+ railBeam.name = "pier-rail";
713
+ group.add(railBeam);
714
+ for (let index = 0; index < 5; index += 1) {
715
+ addCylinderProp(group, materials.steelMast, 0.04, 0.04, 0.95, 5, [
716
+ PIER.x0 + 1.5 + index * 4.25,
717
+ 0.72,
718
+ PIER.z + side * 2.05,
719
+ ]);
720
+ }
721
+ }
722
+
723
+ // Buildings: continuous street walls with parapets, joinery and clutter.
724
+ // Every face piece is accumulated by `facade` and merged per material by
725
+ // `finishFacade` below, so ~900 small meshes cost a few dozen draw calls.
726
+ const facade = createFacade(group, hittable, colliders, materials, BUILDINGS);
727
+ BUILDINGS.forEach((spec, index) => {
728
+ const [x0, x1] = spec.x;
729
+ const [z0, z1] = spec.z;
730
+ const w = x1 - x0;
731
+ const d = z1 - z0;
732
+ const pool = spec.brick === true ? materials.brick : materials.plaster;
733
+ addSolid(
734
+ group,
735
+ colliders,
736
+ hittable,
737
+ pool(spec.brick === true ? d : w),
738
+ [w, spec.h, d],
739
+ [(x0 + x1) / 2, spec.h / 2, (z0 + z1) / 2],
740
+ "building",
741
+ );
742
+ addRoofLife(facade, spec, index);
743
+ // `j` names the faces someone judged lane-facing; `visibleFaces` adds any
744
+ // other face a neighbouring block does not bury, because several walls a
745
+ // player stands right next to were missing from those lists.
746
+ for (const face of visibleFaces(facade, spec, spec.j ?? [])) {
747
+ addDoorsAndShutters(facade, spec, face, index * 8 + FACE_INDEX[face]);
748
+ }
749
+ });
750
+
751
+ // Round-headed passages through a building: the arcade of the CONNECTOR
752
+ // reference frame. Both sit in lanes no patrol route crosses, and only their
753
+ // piers and the mass over the opening carry colliders, so a player and a
754
+ // soldier walk straight through.
755
+ for (const gateway of BAYVIEW_ARCHES) addArchGateway(facade, gateway);
756
+
757
+ // Raised decks: back plat y 2.4, heaven y 4.8, catwalk bridge y 2.4. Each
758
+ // slab places itself from its footprint constant above, which the schematic
759
+ // and the under-deck observation share.
760
+ const backPlat = addSolid(
761
+ group,
762
+ colliders,
763
+ hittable,
764
+ materials.deckWood,
765
+ [
766
+ BACK_PLAT_DECK.maxX - BACK_PLAT_DECK.minX,
767
+ DECK_THICKNESS,
768
+ BACK_PLAT_DECK.maxZ - BACK_PLAT_DECK.minZ,
769
+ ],
770
+ [
771
+ (BACK_PLAT_DECK.minX + BACK_PLAT_DECK.maxX) / 2,
772
+ 2.4 - DECK_THICKNESS / 2,
773
+ (BACK_PLAT_DECK.minZ + BACK_PLAT_DECK.maxZ) / 2,
774
+ ],
775
+ "back-plat",
776
+ );
777
+ void backPlat;
778
+ addStairs(group, colliders, hittable, materials.deckWood, 3.2, [3, 0, -30], [3, 2.4, -22]);
779
+ addStairs(group, colliders, hittable, materials.deckWood, 3.2, [5, 2.4, -10], [5, 0, -8]);
780
+
781
+ const heaven = addSolid(
782
+ group,
783
+ colliders,
784
+ hittable,
785
+ materials.deckWood,
786
+ [HEAVEN_DECK.maxX - HEAVEN_DECK.minX, DECK_THICKNESS, HEAVEN_DECK.maxZ - HEAVEN_DECK.minZ],
787
+ [
788
+ (HEAVEN_DECK.minX + HEAVEN_DECK.maxX) / 2,
789
+ 4.8 - DECK_THICKNESS / 2,
790
+ (HEAVEN_DECK.minZ + HEAVEN_DECK.maxZ) / 2,
791
+ ],
792
+ "heaven",
793
+ );
794
+ void heaven;
795
+ addStairs(group, colliders, hittable, materials.deckWood, 3.2, [17.5, 0, -25], [20, 4.8, -25]);
796
+
797
+ // Catwalk bridge on posts from the back plat's south-east corner to B site.
798
+ const catwalkDeck = new Mesh(
799
+ gridSolid(
800
+ [CATWALK_DECK.maxX - CATWALK_DECK.minX, 0.22, CATWALK_DECK.maxZ - CATWALK_DECK.minZ],
801
+ [
802
+ (CATWALK_DECK.minX + CATWALK_DECK.maxX) / 2,
803
+ 2.29,
804
+ (CATWALK_DECK.minZ + CATWALK_DECK.maxZ) / 2,
805
+ ],
806
+ ),
807
+ materials.deckWood,
808
+ );
809
+ catwalkDeck.name = "catwalk-deck";
810
+ catwalkDeck.castShadow = true;
811
+ catwalkDeck.receiveShadow = true;
812
+ group.add(catwalkDeck);
813
+ hittable.push(catwalkDeck);
814
+ colliders.push({
815
+ min: [CATWALK_DECK.minX, 0, CATWALK_DECK.minZ],
816
+ max: [CATWALK_DECK.maxX, 2.4, CATWALK_DECK.maxZ],
817
+ });
818
+ for (const z of [-14.6, -9, -3.4]) {
819
+ for (const side of [-1, 1]) {
820
+ const post = new Mesh(
821
+ gridSolid([0.22, 2.18, 0.22], [25 + side * 1.1, 1.09, z]),
822
+ materials.steelPost,
823
+ );
824
+ post.name = "catwalk-post";
825
+ post.castShadow = true;
826
+ group.add(post);
827
+ }
828
+ }
829
+ addStairs(group, colliders, hittable, materials.deckWood, 2.6, [25, 4.8, -19.5], [25, 2.4, -16]);
830
+ addStairs(group, colliders, hittable, materials.deckWood, 2.6, [25, 2.4, -2], [25, 0, -4]);
831
+
832
+ // Guard rails ride every open deck edge; purely visual, so traversal and
833
+ // ballistics stay exactly as the playtests know them.
834
+ const RAILS: readonly [readonly [number, number], readonly [number, number], number][] = [
835
+ // Back plat, stair gaps kept clear.
836
+ [[0, -22], [1.4, -22], 2.4],
837
+ [[4.6, -22], [12, -22], 2.4],
838
+ [[0, -22], [0, -10], 2.4],
839
+ [[12, -22], [12, -10], 2.4],
840
+ [[0, -10], [3.4, -10], 2.4],
841
+ [[6.6, -10], [12, -10], 2.4],
842
+ // Heaven, stair gaps kept clear.
843
+ [[20, -30], [30, -30], 4.8],
844
+ [[30, -30], [30, -20], 4.8],
845
+ [[20, -30], [20, -26.6], 4.8],
846
+ [[20, -23.4], [20, -20], 4.8],
847
+ [[20, -20], [23.7, -20], 4.8],
848
+ [[26.3, -20], [30, -20], 4.8],
849
+ // Catwalk sides.
850
+ [[23.7, -16.3], [23.7, -1.7], 2.4],
851
+ [[26.3, -16.3], [26.3, -1.7], 2.4],
852
+ ];
853
+ for (const [from, to, baseY] of RAILS) {
854
+ addRail(group, materials.steelMast, from, to, baseY);
855
+ }
856
+
857
+ // Site markers.
858
+ for (const mark of SITE_MARKS) addSiteMark(group, materials, mark);
859
+
860
+ // Rooftop power lines between neighbouring roofs; visual dressing only.
861
+ for (const wire of WIRES) addWire(group, materials, wire);
862
+
863
+ // Crates and barrels: clusters against walls and on the sites.
864
+ CRATES.forEach(([x, z, tiers], crateIndex) => {
865
+ const rowDir = hash(crateIndex * 3.7) > 0.5 ? 1 : 0;
866
+ for (let tier = 0; tier < tiers; tier += 1) {
867
+ const rows = tier === 0 ? 2 : 1;
868
+ for (let row = 0; row < rows; row += 1) {
869
+ const lateral = tier === 0 ? (row === 0 ? -0.42 : 0.44) : 0;
870
+ addSolid(
871
+ group,
872
+ colliders,
873
+ hittable,
874
+ materials.crate,
875
+ [0.78, 0.78, 0.78],
876
+ [x + (rowDir === 0 ? lateral : 0), 0.39 + tier * 0.8, z + (rowDir === 1 ? lateral : 0)],
877
+ "crate",
878
+ );
879
+ }
880
+ }
881
+ });
882
+ for (const [x, z] of BARRELS) {
883
+ const barrel = new Mesh(
884
+ worldGridUVs(unitCylinder(10).clone().scale(0.32, 0.92, 0.32)),
885
+ materials.barrel,
886
+ );
887
+ barrel.name = "barrel";
888
+ barrel.position.set(x, 0.46, z);
889
+ barrel.castShadow = true;
890
+ barrel.receiveShadow = true;
891
+ group.add(barrel);
892
+ hittable.push(barrel);
893
+ colliders.push({ min: [x - 0.32, 0, z - 0.32], max: [x + 0.32, 0.92, z + 0.32] });
894
+ }
895
+
896
+ // Palms: three prototype trees, instanced across the placement table.
897
+ addPalms(group, materials, PALMS);
898
+
899
+ // Vehicles: no CC0 asset for either exists, so both are sculpted in code.
900
+ // The van is a solid the player can hide behind; the boat is out at sea and
901
+ // gets no collider at all.
902
+ for (const van of VANS) colliders.push(addVan(group, hittable, materials, van));
903
+ for (const boat of BOATS) addFishingBoat(group, materials, boat);
904
+
905
+ // Player spawns T spawn centre facing north into the town.
906
+ const spawn: TownSpawn = { x: 0, z: 32, yaw: 0 };
907
+
908
+ // Scoring plates across the callouts; each faces its lane. The mid plate
909
+ // stands straight north of spawn so the opening view reads like the
910
+ // reference frame: sign ahead, sea down the lanes to the east.
911
+ const targets: TargetSpec[] = [
912
+ { position: new Vector3(-30.5, 1.65, 7.9), value: 250, yaw: Math.PI / 2 }, // A site west
913
+ { position: new Vector3(-25.5, 2.35, -5.6), value: 300, standing: true }, // A site crates
914
+ { position: new Vector3(0, 1.6, 9.9), value: 150, yaw: 0 }, // mid south lane, ahead of spawn
915
+ { position: new Vector3(9.9, 1.55, 4), value: 100, yaw: -Math.PI / 2 }, // mid east edge
916
+ { position: new Vector3(24, 1.65, 9.9), value: 250, yaw: Math.PI }, // B site north wall
917
+ { position: new Vector3(30.5, 2.35, -0.5), value: 300, standing: true }, // B site crates
918
+ { position: new Vector3(25, 3.9, -2.6), value: 250, yaw: 0 }, // catwalk south end, high over B
919
+ { position: new Vector3(36.9, 1.65, 18), value: 150, yaw: -Math.PI / 2 }, // outside long east wall
920
+ { position: new Vector3(35, 1.55, 29.5), value: 100, yaw: Math.PI }, // outside long south end
921
+ { position: new Vector3(-11.9, 1.65, 22), value: 150, yaw: Math.PI / 2 }, // T main west wall
922
+ ];
923
+
924
+ // Patrol loops, one per soldier, all on the ground — five of them, like a
925
+ // full T side holding the town.
926
+ const enemyRoutes: TownRoute[] = [
927
+ // Mid defender: mid courtyard ↔ connector ↔ B site.
928
+ [
929
+ new Vector3(0, 0, 0),
930
+ new Vector3(13, 0, 4),
931
+ new Vector3(26, 0, 2),
932
+ new Vector3(24, 0, 8),
933
+ new Vector3(12, 0, 5),
934
+ ],
935
+ // West rover: A site ↔ short A ↔ T main ↔ T spawn edge.
936
+ [
937
+ new Vector3(-28, 0, 0),
938
+ new Vector3(-16, 0, 10),
939
+ new Vector3(-7, 0, 18),
940
+ new Vector3(0, 0, 26),
941
+ ],
942
+ // Waterfront rover: outside long ↔ B site ↔ quay north.
943
+ [
944
+ new Vector3(35, 0, 26),
945
+ new Vector3(30, 0, 4),
946
+ new Vector3(28, 0, -6),
947
+ new Vector3(24, 0, -12),
948
+ ],
949
+ // North rover: CT yard ↔ beneath the back plat ↔ mid north face.
950
+ [
951
+ new Vector3(7, 0, -27),
952
+ new Vector3(-4, 0, -16),
953
+ new Vector3(-4, 0, -4),
954
+ new Vector3(6, 0, -12),
955
+ ],
956
+ // South rover: T spawn ↔ mid south ↔ connector south.
957
+ [
958
+ new Vector3(0, 0, 29),
959
+ new Vector3(-6, 0, 14),
960
+ new Vector3(4, 0, 9),
961
+ new Vector3(13, 0, 9),
962
+ new Vector3(8, 0, 22),
963
+ ],
964
+ ];
965
+
966
+ // Raised deck footprints, for the under-the-deck observation.
967
+ const decks: DeckFootprint[] = [BACK_PLAT_DECK, HEAVEN_DECK, CATWALK_DECK];
968
+
969
+ // One merge for the whole town's joinery, parapets and rooftop clutter.
970
+ finishFacade(facade);
971
+
972
+ // Every solid now exists carrying its final material — merged facade batches
973
+ // included — so this one walk can tag them all. Must stay after the merge.
974
+ tagSurfaces(hittable, materials);
975
+
976
+ return {
977
+ group,
978
+ hittable,
979
+ colliders,
980
+ spawn,
981
+ targets,
982
+ enemyRoutes,
983
+ decks,
984
+ schematic: townSchematic,
985
+ };
986
+ }