create-threenative 0.2.6 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (622) hide show
  1. package/README.md +2 -2
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +431 -20
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +555 -21
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +294 -55
  19. package/dist/threenative.js +714 -154
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rts/AGENTS.md +96 -0
  218. package/templates/rts/CLAUDE.md +98 -0
  219. package/templates/rts/kit.json +7 -0
  220. package/templates/{defense → rts}/package.json +13 -7
  221. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  222. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  223. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  224. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  225. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  226. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  227. package/templates/rts/playtests/survives.playtest.json +58 -0
  228. package/templates/rts/public/favicon.svg +4 -0
  229. package/templates/rts/src/game.ts +64 -0
  230. package/templates/rts/src/orders.ts +22 -0
  231. package/templates/rts/src/render/army.ts +346 -0
  232. package/templates/rts/src/render/camera.ts +123 -0
  233. package/templates/rts/src/render/lighting.ts +61 -0
  234. package/templates/rts/src/render/loading.ts +33 -0
  235. package/templates/rts/src/render/materials.ts +152 -0
  236. package/templates/rts/src/render/models.ts +705 -0
  237. package/templates/rts/src/render/palette.ts +17 -0
  238. package/templates/rts/src/render/picking.ts +93 -0
  239. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  240. package/templates/rts/src/render/quality.ts +128 -0
  241. package/templates/rts/src/render/resources.ts +141 -0
  242. package/templates/rts/src/render/sky.ts +44 -0
  243. package/templates/rts/src/render/terrain.ts +116 -0
  244. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  245. package/templates/rts/src/scenes/Play.ts +650 -0
  246. package/templates/rts/src/sim/ai.ts +1140 -0
  247. package/templates/rts/src/sim/combat.ts +416 -0
  248. package/templates/rts/src/sim/construction.ts +374 -0
  249. package/templates/rts/src/sim/economy.ts +167 -0
  250. package/templates/rts/src/sim/game.ts +1082 -0
  251. package/templates/rts/src/sim/movement.ts +371 -0
  252. package/templates/rts/src/sim/nav.ts +276 -0
  253. package/templates/rts/src/sim/production.ts +180 -0
  254. package/templates/rts/src/sim/terrain.ts +170 -0
  255. package/templates/rts/src/sim/types.ts +647 -0
  256. package/templates/rts/src/sim/vision.ts +46 -0
  257. package/templates/rts/src/state.ts +100 -0
  258. package/templates/{defense → rts}/src/style.css +21 -8
  259. package/templates/rts/src/ui/App.tsx +21 -0
  260. package/templates/rts/src/ui/Commands.tsx +129 -0
  261. package/templates/rts/src/ui/GameUi.tsx +22 -0
  262. package/templates/rts/src/ui/Hud.tsx +165 -0
  263. package/templates/rts/src/ui/Minimap.tsx +84 -0
  264. package/templates/rts/tailwind.config.ts +2 -0
  265. package/templates/rts/threenative.config.ts +56 -0
  266. package/templates/rts/tsconfig.json +17 -0
  267. package/templates/{defense → rts}/vite.config.ts +4 -1
  268. package/templates/runner/AGENTS.md +6 -10
  269. package/templates/runner/CLAUDE.md +6 -10
  270. package/templates/runner/README.md +3 -3
  271. package/templates/runner/package.json +13 -7
  272. package/templates/runner/playtests/performance.playtest.json +2 -2
  273. package/templates/runner/src/conventions.ts +4 -3
  274. package/templates/runner/src/entities/Runner.ts +54 -7
  275. package/templates/runner/src/game.ts +2 -0
  276. package/templates/runner/src/render/camera.ts +4 -2
  277. package/templates/runner/src/render/dust.ts +5 -2
  278. package/templates/runner/src/render/lighting.ts +41 -45
  279. package/templates/runner/src/render/loading.ts +2 -2
  280. package/templates/runner/src/render/materials.ts +165 -25
  281. package/templates/runner/src/render/palette.ts +17 -28
  282. package/templates/runner/src/render/postprocessing.ts +12 -2
  283. package/templates/runner/src/render/quality.ts +42 -96
  284. package/templates/runner/src/render/shapes.ts +59 -37
  285. package/templates/runner/src/render/sky.ts +32 -41
  286. package/templates/runner/src/render/touch-controls.ts +1 -1
  287. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  288. package/templates/runner/src/scenes/Run.ts +26 -6
  289. package/templates/runner/src/track.ts +6 -1
  290. package/templates/runner/threenative.config.ts +14 -1
  291. package/templates/runner/vite.config.ts +4 -1
  292. package/templates/sailing/AGENTS.md +12 -12
  293. package/templates/sailing/CLAUDE.md +12 -12
  294. package/templates/sailing/assets/ship.glb +0 -0
  295. package/templates/sailing/package.json +13 -7
  296. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  297. package/templates/sailing/playtests/sails.playtest.json +33 -0
  298. package/templates/sailing/playtests/win.playtest.json +156 -8
  299. package/templates/sailing/src/conventions.ts +29 -2
  300. package/templates/sailing/src/entities/Ship.ts +381 -57
  301. package/templates/sailing/src/game.ts +14 -0
  302. package/templates/sailing/src/render/camera.ts +63 -9
  303. package/templates/sailing/src/render/lighting.ts +49 -27
  304. package/templates/sailing/src/render/materials.ts +50 -15
  305. package/templates/sailing/src/render/ocean.ts +647 -60
  306. package/templates/sailing/src/render/palette.ts +16 -12
  307. package/templates/sailing/src/render/postprocessing.ts +12 -2
  308. package/templates/sailing/src/render/props.ts +316 -442
  309. package/templates/sailing/src/render/quality.ts +14 -4
  310. package/templates/sailing/src/render/sky.ts +116 -23
  311. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  312. package/templates/sailing/src/scenes/Boot.ts +21 -0
  313. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  314. package/templates/sailing/src/state.ts +6 -0
  315. package/templates/sailing/src/ui/Hud.tsx +41 -9
  316. package/templates/sailing/threenative.config.ts +14 -1
  317. package/templates/sailing/vite.config.ts +4 -1
  318. package/templates/shooter/AGENTS.md +27 -42
  319. package/templates/shooter/CLAUDE.md +27 -42
  320. package/templates/shooter/index.html +1 -0
  321. package/templates/shooter/package.json +13 -7
  322. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  323. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  324. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  325. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  326. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  327. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  328. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  329. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  330. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  331. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  332. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  333. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  334. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  335. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  336. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  337. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  338. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  339. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  340. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  341. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  342. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  343. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  344. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  345. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  346. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  347. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  348. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  349. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  350. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  351. package/templates/shooter/playtests/performance.playtest.json +62 -26
  352. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  353. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  354. package/templates/shooter/playtests/survives.playtest.json +36 -30
  355. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  356. package/templates/shooter/src/entities/Breakables.ts +412 -0
  357. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  358. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  359. package/templates/shooter/src/entities/Rifle.ts +442 -0
  360. package/templates/shooter/src/entities/Target.ts +199 -83
  361. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  362. package/templates/shooter/src/game.ts +75 -41
  363. package/templates/shooter/src/main.ts +0 -1
  364. package/templates/shooter/src/postPhysics.ts +36 -0
  365. package/templates/shooter/src/render/camera.ts +78 -74
  366. package/templates/shooter/src/render/decals.ts +142 -82
  367. package/templates/shooter/src/render/facade.ts +1373 -0
  368. package/templates/shooter/src/render/gunfx.ts +704 -0
  369. package/templates/shooter/src/render/lighting.ts +52 -38
  370. package/templates/shooter/src/render/loading.ts +2 -2
  371. package/templates/shooter/src/render/materials.ts +100 -88
  372. package/templates/shooter/src/render/occlusion.ts +108 -0
  373. package/templates/shooter/src/render/palette.ts +10 -10
  374. package/templates/shooter/src/render/palm.ts +455 -0
  375. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  376. package/templates/shooter/src/render/postprocessing.ts +15 -3
  377. package/templates/shooter/src/render/quality.ts +40 -82
  378. package/templates/shooter/src/render/scale.ts +148 -15
  379. package/templates/shooter/src/render/shapes.ts +138 -613
  380. package/templates/shooter/src/render/sky.ts +35 -35
  381. package/templates/shooter/src/render/town-schematic.ts +120 -0
  382. package/templates/shooter/src/render/town.ts +986 -0
  383. package/templates/shooter/src/render/townMaterials.ts +160 -0
  384. package/templates/shooter/src/render/vehicles.ts +741 -0
  385. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  386. package/templates/shooter/src/scenes/Play.ts +727 -650
  387. package/templates/shooter/src/state.ts +26 -41
  388. package/templates/shooter/src/style.css +207 -11
  389. package/templates/shooter/src/surfaces.ts +131 -0
  390. package/templates/shooter/src/ui/App.tsx +9 -10
  391. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  392. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  393. package/templates/shooter/src/ui/Hud.tsx +428 -39
  394. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  395. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  396. package/templates/shooter/src/ui/main.tsx +2 -3
  397. package/templates/shooter/threenative.config.ts +14 -1
  398. package/templates/shooter/vite.config.ts +4 -1
  399. package/templates/starter/AGENTS.md +17 -17
  400. package/templates/starter/CLAUDE.md +17 -17
  401. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  402. package/templates/starter/package.json +13 -7
  403. package/templates/starter/playtests/play.playtest.json +2 -1
  404. package/templates/starter/playtests/survives.playtest.json +1 -1
  405. package/templates/starter/src/conventions.ts +6 -3
  406. package/templates/starter/src/entities/Goal.ts +35 -42
  407. package/templates/starter/src/entities/Player.ts +99 -16
  408. package/templates/starter/src/render/arena.ts +131 -0
  409. package/templates/starter/src/render/lighting.ts +27 -44
  410. package/templates/starter/src/render/materials.ts +164 -35
  411. package/templates/starter/src/render/palette.ts +16 -16
  412. package/templates/starter/src/render/postprocessing.ts +6 -7
  413. package/templates/starter/src/render/quality.ts +43 -101
  414. package/templates/starter/src/render/shapes.ts +1 -1
  415. package/templates/starter/src/render/sky.ts +39 -45
  416. package/templates/starter/src/render/touch-controls.ts +3 -1
  417. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  418. package/templates/starter/src/scenes/Play.ts +82 -81
  419. package/templates/starter/threenative.config.ts +14 -1
  420. package/templates/starter/vite.config.ts +4 -1
  421. package/templates/tower-defense/.codex/config.toml +19 -0
  422. package/templates/tower-defense/.cursor/mcp.json +32 -0
  423. package/templates/tower-defense/.gemini/settings.json +32 -0
  424. package/templates/tower-defense/.mcp.json +32 -0
  425. package/templates/tower-defense/.vscode/mcp.json +36 -0
  426. package/templates/tower-defense/.zed/settings.json +36 -0
  427. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  428. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  429. package/templates/tower-defense/README.md +16 -0
  430. package/templates/tower-defense/index.html +12 -0
  431. package/templates/tower-defense/kit.json +7 -0
  432. package/templates/tower-defense/opencode.json +41 -0
  433. package/templates/tower-defense/package.json +56 -0
  434. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  435. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  436. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  437. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  438. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  439. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  440. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  441. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  442. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  443. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  444. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  445. package/templates/tower-defense/src/balance.ts +187 -0
  446. package/templates/tower-defense/src/board/Board.ts +100 -0
  447. package/templates/tower-defense/src/board/Route.ts +84 -0
  448. package/templates/tower-defense/src/camera-rig.ts +62 -0
  449. package/templates/tower-defense/src/economy.ts +64 -0
  450. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  451. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  452. package/templates/tower-defense/src/game.ts +72 -0
  453. package/templates/tower-defense/src/intents.ts +21 -0
  454. package/templates/tower-defense/src/main.ts +15 -0
  455. package/templates/tower-defense/src/physics.ts +6 -0
  456. package/templates/tower-defense/src/render/camera.ts +38 -0
  457. package/templates/tower-defense/src/render/lighting.ts +42 -0
  458. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  459. package/templates/tower-defense/src/render/materials.ts +103 -0
  460. package/templates/tower-defense/src/render/palette.ts +58 -0
  461. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  462. package/templates/tower-defense/src/render/quality.ts +128 -0
  463. package/templates/tower-defense/src/render/shapes.ts +550 -0
  464. package/templates/tower-defense/src/render/sky.ts +27 -0
  465. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  466. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  467. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  468. package/templates/tower-defense/src/state.ts +88 -0
  469. package/templates/tower-defense/src/style.css +137 -0
  470. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  471. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  472. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  473. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  474. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  475. package/templates/tower-defense/src/ui/main.tsx +14 -0
  476. package/templates/tower-defense/src/waves.ts +90 -0
  477. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  478. package/templates/tower-defense/vite.config.ts +41 -0
  479. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  480. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  481. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  482. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  483. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  484. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  485. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  486. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  487. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  488. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  489. package/agent-files/AGENT-ROLES.md +0 -26
  490. package/templates/action-rpg/src/render/shapes.ts +0 -269
  491. package/templates/action-rpg/src/render/types.ts +0 -3
  492. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  493. package/templates/defense/README.md +0 -10
  494. package/templates/defense/kit.json +0 -7
  495. package/templates/defense/playtests/leak.playtest.json +0 -23
  496. package/templates/defense/playtests/placement.playtest.json +0 -40
  497. package/templates/defense/playtests/scan.playtest.json +0 -20
  498. package/templates/defense/playtests/survive.playtest.json +0 -45
  499. package/templates/defense/playtests/survives.playtest.json +0 -36
  500. package/templates/defense/src/attackers/Attacker.ts +0 -120
  501. package/templates/defense/src/board/Route.ts +0 -94
  502. package/templates/defense/src/conventions.ts +0 -18
  503. package/templates/defense/src/economy.ts +0 -36
  504. package/templates/defense/src/entities/Player.ts +0 -52
  505. package/templates/defense/src/game.ts +0 -51
  506. package/templates/defense/src/physics.ts +0 -13
  507. package/templates/defense/src/placement/Buildable.ts +0 -49
  508. package/templates/defense/src/render/camera.ts +0 -16
  509. package/templates/defense/src/render/lighting.ts +0 -37
  510. package/templates/defense/src/render/materials.ts +0 -22
  511. package/templates/defense/src/render/palette.ts +0 -28
  512. package/templates/defense/src/render/quality.ts +0 -170
  513. package/templates/defense/src/render/shapes.ts +0 -246
  514. package/templates/defense/src/render/sky.ts +0 -45
  515. package/templates/defense/src/scenes/Boot.ts +0 -12
  516. package/templates/defense/src/scenes/Defense.ts +0 -231
  517. package/templates/defense/src/state.ts +0 -56
  518. package/templates/defense/src/towers/Tower.ts +0 -95
  519. package/templates/defense/src/towers/targeting.ts +0 -53
  520. package/templates/defense/src/ui/Hud.tsx +0 -62
  521. package/templates/defense/src/ui/Menu.tsx +0 -7
  522. package/templates/defense/src/waves.ts +0 -40
  523. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  524. package/templates/minimal/src/render/hud.ts +0 -69
  525. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  526. package/templates/platformer/playtests/chase.playtest.json +0 -21
  527. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  528. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  529. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  530. package/templates/platformer/playtests/physics.playtest.json +0 -14
  531. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  532. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  533. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  534. package/templates/platformer/src/conventions.ts +0 -18
  535. package/templates/platformer/src/entities/Character.ts +0 -286
  536. package/templates/platformer/src/entities/Chaser.ts +0 -118
  537. package/templates/platformer/src/entities/Patrol.ts +0 -93
  538. package/templates/platformer/src/level/Platform.ts +0 -46
  539. package/templates/platformer/src/render/rig.ts +0 -60
  540. package/templates/platformer/src/render/terrain.ts +0 -31
  541. package/templates/platformer/src/scenes/Level.ts +0 -241
  542. package/templates/puzzle/README.md +0 -43
  543. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  544. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  545. package/templates/puzzle/src/conventions.ts +0 -25
  546. package/templates/puzzle/src/entities/Ball.ts +0 -70
  547. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  548. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  549. package/templates/puzzle/src/physics.ts +0 -19
  550. package/templates/puzzle/src/room.ts +0 -83
  551. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  552. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  553. package/templates/shooter/playtests/combat.playtest.json +0 -48
  554. package/templates/shooter/playtests/fail.playtest.json +0 -31
  555. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  556. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  557. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  558. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  559. package/templates/shooter/src/combat/damage.ts +0 -40
  560. package/templates/shooter/src/conventions.ts +0 -51
  561. package/templates/shooter/src/entities/Pickup.ts +0 -70
  562. package/templates/shooter/src/entities/Player.ts +0 -310
  563. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  564. package/templates/shooter/src/playtest-events.ts +0 -15
  565. package/templates/shooter/src/render/touch-controls.ts +0 -305
  566. package/templates/shooter/src/render/types.ts +0 -3
  567. package/templates/shooter/src/render/ui.css +0 -330
  568. package/templates/shooter/src/render/ui.ts +0 -75
  569. package/templates/shooter/src/render/vfx.ts +0 -215
  570. package/templates/shooter/src/ui/Menu.tsx +0 -41
  571. package/templates/shooter/src/waves.ts +0 -50
  572. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  573. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  574. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  575. package/templates/starter/playtests/assets.playtest.json +0 -65
  576. package/templates/starter/playtests/buffer.playtest.json +0 -79
  577. package/templates/starter/playtests/cloth.playtest.json +0 -113
  578. package/templates/starter/playtests/coyote.playtest.json +0 -87
  579. package/templates/starter/playtests/gameover.playtest.json +0 -66
  580. package/templates/starter/playtests/goal.playtest.json +0 -67
  581. package/templates/starter/playtests/look.playtest.json +0 -175
  582. package/templates/starter/playtests/models-baseline.png +0 -0
  583. package/templates/starter/playtests/models.playtest.json +0 -74
  584. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  585. package/templates/starter/playtests/odometer.playtest.json +0 -54
  586. package/templates/starter/playtests/restart.playtest.json +0 -91
  587. package/templates/starter/playtests/seed.playtest.json +0 -54
  588. package/templates/starter/playtests/textures-baseline.png +0 -0
  589. package/templates/starter/playtests/textures.playtest.json +0 -74
  590. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  591. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  592. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  593. package/templates/starter/src/render/coast.ts +0 -199
  594. package/templates/starter/src/render/hero.ts +0 -88
  595. package/templates/starter/src/render/implicitSurface.ts +0 -199
  596. package/templates/starter/src/render/kuwahara.ts +0 -174
  597. package/templates/starter/src/render/outline.ts +0 -141
  598. package/templates/starter/src/render/painterly.ts +0 -86
  599. package/templates/starter/src/render/rockRidge.ts +0 -198
  600. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  601. package/templates/starter/src/render/scenery.ts +0 -40
  602. package/templates/starter/src/render/textureLifetime.ts +0 -53
  603. package/templates/starter/src/render/water.ts +0 -38
  604. package/templates/starter/src/render/watercolor.ts +0 -85
  605. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  606. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  607. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  608. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  609. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  610. /package/templates/{defense → rts}/.mcp.json +0 -0
  611. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  612. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  613. /package/templates/{defense → rts}/index.html +0 -0
  614. /package/templates/{defense → rts}/opencode.json +0 -0
  615. /package/templates/{defense → rts}/src/main.ts +0 -0
  616. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  617. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  618. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  619. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  620. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  621. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  622. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -1,28 +1,249 @@
1
- // Generated for you: the car's livery and the circuit's surfaces. ThreeNative does not read this
1
+ // Generated for you. The car's livery and the circuit's surfaces. ThreeNative does not read this
2
2
  // file, and nothing in `shapes.ts` names a colour — it only names these slots. Re-livery the car,
3
3
  // or repaint the circuit, entirely from here.
4
- import { MeshStandardMaterial } from "three";
4
+ //
5
+ // The look is a real circuit's: dark grey asphalt with a fine grain and a darker rubber band down
6
+ // the racing line, white edge lines, red and white kerbing, green grass with a slow variation, and
7
+ // one saturated colour for the things a driver is meant to react to. The asphalt and the grass are
8
+ // built from bytes rather than shipped as files, so they cost nothing to load and run the same in
9
+ // the browser and in the native host.
10
+ import {
11
+ type BufferGeometry,
12
+ DataTexture,
13
+ Float32BufferAttribute,
14
+ LinearMipmapLinearFilter,
15
+ MeshStandardMaterial,
16
+ RepeatWrapping,
17
+ SRGBColorSpace,
18
+ Vector2,
19
+ Vector3,
20
+ } from "three";
5
21
  import { palette, toon } from "./palette.js";
6
22
 
23
+ /** Deterministic per-texel noise, so two captures of the same build look the same. */
24
+ function noise(x: number, y: number, seed: number): number {
25
+ let state = (x * 73856093) ^ (y * 19349663) ^ (seed * 83492791);
26
+ state = (state ^ (state >>> 13)) >>> 0;
27
+ state = (state * 1274126177) >>> 0;
28
+ return ((state ^ (state >>> 16)) >>> 0) / 4294967295;
29
+ }
30
+
31
+ /** Smoothstep, so the rubber band has a soft edge instead of a stripe painted across the road. */
32
+ function falloff(value: number, edge: number): number {
33
+ const t = Math.min(Math.max((Math.abs(value) - edge) / 0.28, 0), 1);
34
+ return t * t * (3 - 2 * t);
35
+ }
36
+
37
+ function rgbaTexture(
38
+ size: number,
39
+ shade: (x: number, y: number) => [number, number, number],
40
+ ): DataTexture {
41
+ const data = new Uint8Array(size * size * 4);
42
+ for (let y = 0; y < size; y += 1) {
43
+ for (let x = 0; x < size; x += 1) {
44
+ const [r, g, b] = shade(x / size, y / size);
45
+ const at = (y * size + x) * 4;
46
+ data[at] = r;
47
+ data[at + 1] = g;
48
+ data[at + 2] = b;
49
+ data[at + 3] = 255;
50
+ }
51
+ }
52
+ const texture = new DataTexture(data, size, size);
53
+ texture.colorSpace = SRGBColorSpace;
54
+ texture.wrapS = RepeatWrapping;
55
+ texture.wrapT = RepeatWrapping;
56
+ texture.generateMipmaps = true;
57
+ texture.minFilter = LinearMipmapLinearFilter;
58
+ texture.anisotropy = 16;
59
+ texture.needsUpdate = true;
60
+ return texture;
61
+ }
62
+
63
+ /**
64
+ * Asphalt: mid-dark grey, a fine per-texel grain, and a darker band down the middle where every
65
+ * car lays rubber. The band is the thing that makes a road read as a **racing** surface rather
66
+ * than a grey plane — it also tells the player where the line is without a single word of UI.
67
+ */
68
+ const asphalt = rgbaTexture(256, (u, v) => {
69
+ const grain = (noise(Math.floor(u * 256), Math.floor(v * 256), 11) - 0.5) * 26;
70
+ const rubber = 1 - 0.34 * falloff(u - 0.5, 0.16);
71
+ const shoulder = 1 + 0.1 * falloff(u - 0.5, 0.42);
72
+ // No term here may depend on `v` except through `grain`: the road tiles this image every 8 m of
73
+ // travel, and a v-dependent brightness curve (there used to be one, `sin(u*9.1+v*3.7)`) does not
74
+ // return to its own start at v=1, so every tile boundary was a visible seam — a hard band across
75
+ // the whole road width, every 8 m, the length of the circuit. `grain` is safe: it is per-texel
76
+ // hashed noise with no trend across the tile, so its wrap seam is invisible in the noise floor.
77
+ const base = 74 * rubber * shoulder + grain;
78
+ return [base, base * 1.01, base * 1.05];
79
+ });
80
+
81
+ /** The run-off: the same asphalt, laid down lighter and dustier, and coarser. */
82
+ const apron = rgbaTexture(128, (u, v) => {
83
+ const grain = (noise(Math.floor(u * 128), Math.floor(v * 128), 29) - 0.5) * 34;
84
+ const base = 116 + grain;
85
+ return [base, base * 0.99, base * 0.96];
86
+ });
87
+
88
+ /** Grass: two greens mottled over a slow noise, so a hillside is not one flat colour. */
89
+ const turf = rgbaTexture(128, (u, v) => {
90
+ const coarse = noise(Math.floor(u * 9), Math.floor(v * 9), 5);
91
+ const fine = (noise(Math.floor(u * 128), Math.floor(v * 128), 7) - 0.5) * 20;
92
+ const base = 0.7 + coarse * 0.5;
93
+ return [52 * base + fine, 92 * base + fine * 1.4, 46 * base + fine];
94
+ });
95
+
96
+ /** Red and white, one stripe per 1.2 m of kerb. Two texels wide, so it tiles in both axes. */
97
+ const kerbStripe = rgbaTexture(2, (u) => (u < 0.5 ? [216, 58, 48] : [242, 240, 230]));
98
+
99
+ /** Black and white, a 4x2 checker. The one transverse mark the road is meant to carry. */
100
+ const checker = rgbaTexture(8, (u, v) => {
101
+ const on = (Math.floor(u * 4) + Math.floor(v * 2)) % 2 === 0;
102
+ return on ? [235, 233, 224] : [18, 18, 20];
103
+ });
104
+
105
+ /** A faint cast-concrete grain as a tangent-space normal map, tiling every metre. */
106
+ function grainNormalTexture(size = 128): DataTexture {
107
+ const cells = [8, 32];
108
+ const lattice = cells.map((count) => {
109
+ const values = new Float32Array(count * count);
110
+ for (let index = 0; index < values.length; index += 1)
111
+ values[index] = noise(index, count, count);
112
+ return { count, values };
113
+ });
114
+ const height = (x: number, y: number): number => {
115
+ let total = 0;
116
+ for (const [octave, { count, values }] of lattice.entries()) {
117
+ const u = (x / size) * count;
118
+ const v = (y / size) * count;
119
+ const x0 = Math.floor(u);
120
+ const y0 = Math.floor(v);
121
+ const fx = u - x0;
122
+ const fy = v - y0;
123
+ const sx = fx * fx * (3 - 2 * fx);
124
+ const sy = fy * fy * (3 - 2 * fy);
125
+ const at = (i: number, j: number): number =>
126
+ values[(((j % count) + count) % count) * count + (((i % count) + count) % count)] ?? 0;
127
+ const top = at(x0, y0) + (at(x0 + 1, y0) - at(x0, y0)) * sx;
128
+ const bottom = at(x0, y0 + 1) + (at(x0 + 1, y0 + 1) - at(x0, y0 + 1)) * sx;
129
+ total += (top + (bottom - top) * sy) * (octave === 0 ? 1 : 0.5);
130
+ }
131
+ return total;
132
+ };
133
+ const data = new Uint8Array(size * size * 4);
134
+ const normal = new Vector3();
135
+ for (let y = 0; y < size; y += 1) {
136
+ for (let x = 0; x < size; x += 1) {
137
+ const dx = height(x + 1, y) - height(x - 1, y);
138
+ const dy = height(x, y + 1) - height(x, y - 1);
139
+ normal.set(-dx * 4, -dy * 4, 1).normalize();
140
+ const at = (y * size + x) * 4;
141
+ data[at] = Math.round((normal.x * 0.5 + 0.5) * 255);
142
+ data[at + 1] = Math.round((normal.y * 0.5 + 0.5) * 255);
143
+ data[at + 2] = Math.round((normal.z * 0.5 + 0.5) * 255);
144
+ data[at + 3] = 255;
145
+ }
146
+ }
147
+ const texture = new DataTexture(data, size, size);
148
+ texture.wrapS = RepeatWrapping;
149
+ texture.wrapT = RepeatWrapping;
150
+ texture.generateMipmaps = true;
151
+ texture.minFilter = LinearMipmapLinearFilter;
152
+ texture.needsUpdate = true;
153
+ return texture;
154
+ }
155
+
156
+ const grain = grainNormalTexture();
157
+
158
+ /**
159
+ * Rewrites a geometry's UVs as world metres, projected along each face's dominant axis.
160
+ * Call it after the geometry is translated into place (merged geometry included).
161
+ */
162
+ export function worldGridUVs<T extends BufferGeometry>(geometry: T): T {
163
+ const position = geometry.getAttribute("position");
164
+ const normal = geometry.getAttribute("normal");
165
+ const uv = new Float32Array(position.count * 2);
166
+ const axis = new Vector3();
167
+ for (let index = 0; index < position.count; index += 1) {
168
+ axis.fromBufferAttribute(normal, index);
169
+ const x = position.getX(index);
170
+ const y = position.getY(index);
171
+ const z = position.getZ(index);
172
+ const ax = Math.abs(axis.x);
173
+ const ay = Math.abs(axis.y);
174
+ const az = Math.abs(axis.z);
175
+ const [u, v] = ay >= ax && ay >= az ? [x, z] : ax >= az ? [z, y] : [x, y];
176
+ uv[index * 2] = u;
177
+ uv[index * 2 + 1] = v;
178
+ }
179
+ geometry.setAttribute("uv", new Float32BufferAttribute(uv, 2));
180
+ return geometry;
181
+ }
182
+
7
183
  export function createMaterials() {
8
184
  return {
9
- /** Boost chevrons and the kerb's yellow stripe. */
185
+ /** Boost chevrons and the start lights' housing. */
10
186
  boost: toon(palette.accent, 0.4),
11
- curb: toon(0xf3f0dc, 0.55),
12
- /** The kerb's red stripe, and the paint on the pit wall. */
13
- kerbAlt: toon(0xe8443a, 0.55),
14
- field: toon(palette.field, 0.95),
15
- /** Dry grass on the run-off, so the two greens read as two surfaces. */
16
- runoff: toon(0x8a9b52, 0.98),
17
- road: toon(palette.road, 0.86),
18
- shadow: new MeshStandardMaterial({ color: palette.shadow, roughness: 1 }),
187
+ /** Painted white: the edge lines, the pit-lane line, the grandstand seats. */
188
+ line: new MeshStandardMaterial({ color: 0xf1efe6, roughness: 0.7, metalness: 0 }),
189
+ /** The kerb's red stripe. */
190
+ kerbAlt: toon(0xd8453c, 0.5),
191
+ /** The kerb's white stripe, and the one place the tarmac is allowed to be bright. */
192
+ curb: toon(0xf2f0e6, 0.5),
193
+ /** The finish line and the grid-slot marks: the one transverse pattern the road carries. */
194
+ checker: new MeshStandardMaterial({ map: checker, roughness: 0.75, metalness: 0 }),
195
+ /** Red and white, striped by its own texture, so the whole circuit's kerbing is one draw. */
196
+ kerb: new MeshStandardMaterial({
197
+ map: kerbStripe,
198
+ normalMap: grain,
199
+ normalScale: new Vector2(0.1, 0.1),
200
+ roughness: 0.62,
201
+ metalness: 0.02,
202
+ }),
203
+ /** The infield and everything beyond the run-off. */
204
+ grass: new MeshStandardMaterial({
205
+ map: turf,
206
+ normalMap: grain,
207
+ normalScale: new Vector2(0.35, 0.35),
208
+ roughness: 0.95,
209
+ metalness: 0,
210
+ }),
211
+ /** The paved run-off past the white line, and the pit lane. */
212
+ runoff: new MeshStandardMaterial({
213
+ map: apron,
214
+ normalMap: grain,
215
+ normalScale: new Vector2(0.16, 0.16),
216
+ roughness: 0.88,
217
+ metalness: 0.03,
218
+ }),
219
+ /** Grandstands, hoardings, gantries, garages, marshal posts. */
220
+ structure: new MeshStandardMaterial({
221
+ map: apron,
222
+ normalMap: grain,
223
+ normalScale: new Vector2(0.18, 0.18),
224
+ color: 0x9aa0a6,
225
+ roughness: 0.72,
226
+ metalness: 0.05,
227
+ }),
228
+ /** Armco and the pit wall: galvanised steel, so they catch the sun and read as metal. */
229
+ armco: new MeshStandardMaterial({
230
+ color: 0xb4bcc4,
231
+ metalness: 0.72,
232
+ roughness: 0.42,
233
+ }),
234
+ road: new MeshStandardMaterial({
235
+ color: 0x4a4a4a,
236
+ roughness: 0.86,
237
+ metalness: 0.04,
238
+ }),
239
+ shadow: new MeshStandardMaterial({ color: 0x4a4f55, roughness: 1 }),
19
240
  tire: new MeshStandardMaterial({ color: 0x1a1d22, roughness: 0.94 }),
20
241
 
21
242
  /** The car. `body` is the one a game is most likely to change. */
22
243
  body: new MeshStandardMaterial({ color: 0xd93a3a, metalness: 0.18, roughness: 0.3 }),
23
244
  /** Kept as an alias so a game that already referred to the old slot still compiles. */
24
245
  vehicle: new MeshStandardMaterial({ color: 0xd93a3a, metalness: 0.18, roughness: 0.3 }),
25
- rivalBody: new MeshStandardMaterial({ color: 0x2f6fd0, metalness: 0.18, roughness: 0.3 }),
246
+ rivalBody: new MeshStandardMaterial({ color: palette.accent, metalness: 0.18, roughness: 0.3 }),
26
247
  glass: new MeshStandardMaterial({
27
248
  color: 0x3f5a70,
28
249
  metalness: 0.55,
@@ -53,13 +274,12 @@ export function createMaterials() {
53
274
  roughness: 0.34,
54
275
  }),
55
276
 
56
- /** Trackside furniture. */
57
- structure: toon(0xd8dbe0, 0.7),
58
- crowd: toon(0x3d4a63, 0.9),
59
- trunk: toon(0x6b4a33, 0.9),
60
- canopy: toon(0x3f7a44, 0.92),
277
+ /** Trackside furniture that is instanced, so it takes a flat value rather than a mapped grid. */
278
+ crowd: toon(0x6f7681, 0.9),
279
+ trunk: toon(0x5b4a3c, 0.9),
280
+ canopy: toon(0x3f6a45, 0.92),
61
281
  /** The hills past the treeline. */
62
- distant: toon(0x4a6f57, 0.98),
63
- hoardingBoard: toon(0x2f6fd0, 0.6),
282
+ distant: toon(0x6d7a80, 0.98),
283
+ hoardingBoard: toon(palette.accent, 0.6),
64
284
  };
65
285
  }
@@ -1,31 +1,29 @@
1
1
  // Generated for you: every colour the race uses, in one place. ThreeNative does not read this file.
2
2
  //
3
- // These are afternoon-daylight values on purpose. The first version of this palette used a
4
- // near-black road (`0x202936`) lit by a strongly yellow key light, and the blind score of the first
5
- // frame called it a black strip in a swamp: the tarmac never came up off the shadow floor and the
6
- // grass went olive. Tarmac is a *mid* grey — brighter than intuition says — and grass only reads as
7
- // grass when the sun on it is close to white.
3
+ // Six named roles, and only one of them is saturated. That is the whole rule: a track read at
4
+ // speed is a grey circuit, a grey sky and one colour that means *this is the thing you are here
5
+ // for* — the rival's nose, the boost chevrons, the finish banner. Every other surface is a value
6
+ // on the same neutral ramp, so the eye goes to the racing, not to the paint job.
7
+ //
8
+ // The two `sky*` roles are the loading screen's backdrop and progress track (`loading.ts` reads
9
+ // them by name); `horizon` is the photographed sky's own haze, which is what distance fades into.
8
10
  import { BoxGeometry, Group, Mesh, MeshStandardMaterial } from "three";
9
11
 
10
12
  export const palette = {
11
- /** Zenith. Deep enough to give the dome a gradient worth having. */
12
- skyHigh: 0x2c6cae,
13
- /** Horizon haze, and the fog colour, so distance dissolves into the sky instead of into grey. */
14
- skyLow: 0xbcd6e4,
15
- /** Tarmac. Mid grey with a blue cast; anything darker eats the car's own shadow. */
16
- road: 0x51565f,
17
- /** Freshly cut infield. */
18
- field: 0x5c8f45,
19
- /** Kerbing, race numbers, boost chevrons. */
20
- accent: 0xffc233,
21
- /** Ambient fill and the underside of everything. Not black — black flattens. */
22
- shadow: 0x35414f,
13
+ /** Loading screen backdrop. */
14
+ skyLow: 0xb8bcc2,
15
+ /** Loading screen progress track. */
16
+ skyHigh: 0x2f3640,
17
+ /** The sky photograph's own horizon: distance fades into this rather than into grey. */
18
+ horizon: 0xacb1c1,
19
+ /** Light grid: the run-off apron and the infield, so the ground reads as a measured surface. */
20
+ floor: 0xb4b1ae,
21
+ /** Dark grid: grandstands, hoardings, tyre walls, the treeline. */
22
+ structure: 0x747578,
23
+ /** The one saturated colour: the rival, the boost, the finish banner, a held touch control. */
24
+ accent: 0x2a6cf0,
23
25
  } as const;
24
26
 
25
- // The circuit's other surfaces are shades of the six roles above rather than roles of their own:
26
- // the palette stays six named colours, and anything derived belongs beside the material that uses
27
- // it. `materials.ts` owns them.
28
-
29
27
  const materials = new Map<string, MeshStandardMaterial>();
30
28
 
31
29
  export function toon(color: number, roughness = 0.72): MeshStandardMaterial {
@@ -22,13 +22,23 @@ export function setupPost(
22
22
  environment: {
23
23
  godraysLight?: DirectionalLight;
24
24
  mobile?: boolean;
25
+ /** The renderer named a software adapter; this game's answer is its `low` tier. */
26
+ software?: boolean;
25
27
  /** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
26
28
  tier?: QualityTier;
27
29
  } = {},
28
30
  ): void {
29
- const tier = resolveQualityTier({ mobile: environment.mobile, tier: environment.tier });
31
+ const tier = resolveQualityTier({
32
+ mobile: environment.mobile,
33
+ software: environment.software,
34
+ tier: environment.tier,
35
+ });
30
36
  const source = environment.tier === undefined ? "platform" : "override";
31
- console.info(`TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} source=${source}`);
37
+ console.info(
38
+ `TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} software=${
39
+ environment.software === true
40
+ } source=${source}`,
41
+ );
32
42
  const world = new WorldEnvironment(qualityPreset(tier));
33
43
  world.apply(renderer, scene, camera, { godraysLight: environment.godraysLight });
34
44
  }
@@ -19,6 +19,15 @@
19
19
  // probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
20
20
  // in `sky.ts`, not in this file.
21
21
  //
22
+ // **This template runs no SSGI, SSR or sharpen at any tier, and that is a measurement rather than
23
+ // a taste.** A race is a moving camera over grey tarmac: nothing in the frame is glossy enough for
24
+ // a reflection to read as one, and a gather this large only pays off on surfaces that bounce light
25
+ // into each other — of which a circuit has none. What a track does need is occlusion (the dark
26
+ // line where a tyre meets tarmac is most of what says the car is *on* the road) and bloom for the
27
+ // sun and the tail lights. The bounded proof is `playtests/performance.playtest.json`: it holds the
28
+ // frame at 33 ms p95 and 30 fps, so if you turn a stage on, that scenario is what tells you it was
29
+ // worth it. Both are one line to turn back on.
30
+
22
31
  import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
23
32
 
24
33
  /**
@@ -49,7 +58,7 @@ function isQualityTier(value: string): value is QualityTier {
49
58
  * turned out to have no effect.
50
59
  */
51
60
  export function resolveQualityTier(
52
- request: { readonly mobile?: boolean; readonly tier?: string } = {},
61
+ request: { readonly mobile?: boolean; readonly software?: boolean; readonly tier?: string } = {},
53
62
  ): QualityTier {
54
63
  const requested = request.tier;
55
64
  if (requested !== undefined) {
@@ -60,101 +69,53 @@ export function resolveQualityTier(
60
69
  }
61
70
  return requested;
62
71
  }
72
+ // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
73
+ // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
74
+ // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
75
+ // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
76
+ // `tier` above still wins over it.
77
+ if (request.software === true) return "low";
63
78
  return request.mobile === true ? "low" : "high";
64
79
  }
65
80
 
66
81
  /**
67
- * What a desktop gets: this template's shipped desktop look, unchanged.
82
+ * The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the sun
83
+ * disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey walls and
84
+ * flattens contrast), and a corner falloff. Antialiasing is on in every tier that installs a chain;
85
+ * see `screenSpaceAA` in `worldEnvironment.ts`.
68
86
  *
69
- * The whole chain measured 12.5 ms of a 14.7 ms GPU frame in the reference ablation, and SSGI
70
- * with its denoiser is ~9.2 ms of that.
87
+ * No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
88
+ * captured sky (`sky.ts`), and SSR on rough tarmac traced speckle into the road; RCAS then rang the
89
+ * smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
71
90
  */
72
- const high: IWorldEnvironmentOptions = {
73
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
74
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
75
- // to be.
91
+ const shared: IWorldEnvironmentOptions = {
92
+ // Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
76
93
  bloomEnabled: true,
77
- bloomRadius: 0.5,
78
- bloomStrength: 0.35,
79
- bloomThreshold: 0.2,
80
- exposure: 1.18,
81
- // The two full-resolution denoise passes over the AO and GI terms: ~1.9 ms. Only worth running
82
- // when SSGI is on — its noise is what they clean up.
83
- denoiseEnabled: true,
84
- // SSGI, the screen-space indirect-light gather: ~7.3 ms alone, ~9.2 ms with the two denoise
85
- // passes it feeds. The largest stage in the chain by a factor of two, of a 14.7 ms frame.
86
- // Dropping this pair is what `medium` is.
87
- ssgiEnabled: true,
88
- ssgiRadius: 30,
89
- ssgiQuality: "medium",
90
- // Half the frame in each axis, so a quarter of the pixels. Full-res SSGI cost 14.4 ms
91
- // of a 39.7 ms frame on an RTX 2080; this is the same gather over a quarter of the work,
92
- // and it measured *sharper* because the scaler spends what it hands back on resolution.
93
- // `worldEnvironment.ts` explains why it takes a wrapper instead of a property.
94
- ssgiResolutionScale: 0.5,
95
- // Screen-space reflections: ~4.1 ms.
96
- ssrEnabled: true,
97
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
98
- // are on and do nothing" — the ray dies a metre from where it started.
99
- ssrMaxDistance: 75,
100
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
101
- // the rays and is very hard to see in the result.
102
- ssrResolutionScale: 0.5,
103
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
104
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
105
- // that runs one of them.
106
- sharpenEnabled: true,
107
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
108
- sharpenStrength: 0.3,
94
+ bloomRadius: 0.55,
95
+ bloomStrength: 0.26,
96
+ bloomThreshold: 1,
97
+ exposure: 0.66,
109
98
  tonemapMode: "aces",
99
+ vignetteAmount: 0.26,
110
100
  };
111
101
 
112
102
  /**
113
- * `high` minus the gather and its denoiser — the single change in this chain measured to give
114
- * back most of the frame: **14.7 ms -> 5.5 ms of GPU** in the reference ablation. Reflections,
115
- * bloom and the sharpener stay, so it is recognisably the same look.
103
+ * What a desktop gets: contact occlusion on top — the dark line where a tyre meets the tarmac and a
104
+ * wing meets its own shadow, most of what separates "a car on a road" from "a car over a picture".
105
+ * Gathered at full resolution and denoised: at half, the upsample left a grain around every wheel.
116
106
  */
117
- const medium: IWorldEnvironmentOptions = {
118
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
119
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
120
- // to be.
121
- bloomEnabled: true,
122
- bloomRadius: 0.5,
123
- bloomStrength: 0.35,
124
- bloomThreshold: 0.2,
125
- exposure: 1.18,
126
- // Screen-space reflections: ~4.1 ms.
127
- ssrEnabled: true,
128
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
129
- // are on and do nothing" — the ray dies a metre from where it started.
130
- ssrMaxDistance: 75,
131
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
132
- // the rays and is very hard to see in the result.
133
- ssrResolutionScale: 0.5,
134
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
135
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
136
- // that runs one of them.
137
- sharpenEnabled: true,
138
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
139
- sharpenStrength: 0.3,
140
- tonemapMode: "aces",
107
+ const high: IWorldEnvironmentOptions = {
108
+ ...shared,
109
+ // GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
110
+ gtaoEnabled: true,
111
+ gtaoRadius: 0.35,
141
112
  };
142
113
 
143
- /**
144
- * What a phone gets: this template's shipped mobile look, unchanged. Bloom and the tone curve,
145
- * nothing screen-space. The ablation's floor — every stage off — was 2.2 ms.
146
- */
147
- const low: IWorldEnvironmentOptions = {
148
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
149
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
150
- // to be.
151
- bloomEnabled: true,
152
- bloomRadius: 0.5,
153
- bloomStrength: 0.35,
154
- bloomThreshold: 0.2,
155
- exposure: 1.18,
156
- tonemapMode: "aces",
157
- };
114
+ /** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
115
+ const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8 };
116
+
117
+ /** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
118
+ const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
158
119
 
159
120
  const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
160
121
 
@@ -388,7 +388,11 @@ export function vehicle(materials: Materials): Group {
388
388
  }
389
389
 
390
390
  // Running gear. Rear tyres are larger, which is both true of the class and the cheapest way to
391
- // make the tail read as the driven end.
391
+ // make the tail read as the driven end. The four groups are **named and kept as direct children
392
+ // of the returned root**, because they are the suspension's only handle on the visual: a car's
393
+ // physics reads their own names to build `VehicleBody3D`'s wheel list (so the physics and the
394
+ // mesh can never disagree about which wheel is the steered one) and writes spin and steer back
395
+ // into them each frame.
392
396
  for (const [x, radius] of [
393
397
  [1.28, 0.33],
394
398
  [-1.42, 0.37],
@@ -401,7 +405,13 @@ export function vehicle(materials: Materials): Group {
401
405
  root.add(group);
402
406
  }
403
407
  }
404
- shell.attachTo(root);
408
+ // The shell goes in a group of its own so the **body can lean on its suspension** while the
409
+ // wheels stay planted: rotating the whole root would tilt the contact patches off the road.
410
+ // `body.rotation` is the car's own roll and pitch; nothing else in the scene writes it.
411
+ const body = new Group();
412
+ body.name = "body";
413
+ shell.attachTo(body);
414
+ root.add(body);
405
415
  return root;
406
416
  }
407
417
 
@@ -485,8 +495,8 @@ export function hoardingGeometry(width = 5): {
485
495
  } {
486
496
  const frame: Mesh[] = [];
487
497
  for (const side of [-1, 1]) {
488
- const post = new Mesh(new CylinderGeometry(0.06, 0.06, 1.1, 5));
489
- post.position.set(0, 0.55, (side * width) / 2.6);
498
+ const post = new Mesh(new CylinderGeometry(0.06, 0.06, 1.3, 5));
499
+ post.position.set(0, 0.65, (side * width) / 2.6);
490
500
  frame.push(post);
491
501
  }
492
502
  const rail = new Mesh(new BoxGeometry(0.12, 0.08, width));
@@ -494,8 +504,12 @@ export function hoardingGeometry(width = 5): {
494
504
  frame.push(rail);
495
505
  // Upright, not raked. A tilt looked like a fallen board once the row was rotated to face the
496
506
  // road, because the tilt is applied in the board's own frame and turns into a lean.
497
- const panel = new Mesh(new BoxGeometry(0.08, 0.72, width));
498
- panel.position.y = 0.94;
507
+ //
508
+ // The panel reaches the **tarmac**. It used to float 580 mm above it, which read as a fence on
509
+ // legs and was worse than that: the board is the barrier's collider, so the gap underneath was a
510
+ // gap a car drove straight through and out of the circuit.
511
+ const panel = new Mesh(new BoxGeometry(0.08, 1.3, width));
512
+ panel.position.y = 0.65;
499
513
  return { board: merged([panel]), frame: merged(frame) };
500
514
  }
501
515