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,48 +1,56 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
5
+ // by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
6
+ // The same image is the background, the environment light every surface reflects and is filled by,
7
+ // and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
8
+ // equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
1
9
  import {
2
- BackSide,
3
- BufferAttribute,
4
10
  Color,
5
- Fog,
6
- MathUtils,
7
- Mesh,
8
- MeshBasicMaterial,
11
+ EquirectangularReflectionMapping,
12
+ FogExp2,
13
+ SRGBColorSpace,
9
14
  type Scene,
10
- SphereGeometry,
15
+ type Texture,
16
+ Vector3,
11
17
  } from "three";
12
18
  import { palette } from "./palette.js";
13
19
 
14
- export function setupSky(scene: Scene): void {
15
- const top = new Color(palette.skyHigh);
16
- const bottom = new Color(palette.skyLow);
17
- scene.background = top;
18
- // Fog starts well past the trackside furniture. At the old `36` the grandstands on the far side
19
- // of the circuit were already half dissolved, which is why the infield read as one flat wash
20
- // instead of a place with things in it.
21
- scene.fog = new Fog(bottom, 70, 230);
20
+ /**
21
+ * How the JPEG was made from the 4k HDR: linear radiance × 0.4, clipped, sRGB-encoded — so white
22
+ * in the file is 2.5 in the sky. Multiplying back restores the HDR brightness of the clouds; the sun
23
+ * disk itself is clipped, which is why the sun is a light (`lighting.ts`) and not a texel.
24
+ */
25
+ const SKY_RANGE = 2.5;
22
26
 
23
- // A vertical gradient, not a flat fill. This dome used to be one solid colour, and a blind score
24
- // of the first frame read it as exactly that: the sky sampled CEE6EA byte-identical at four
25
- // different heights.
26
- // Sky is most of the frame, so a flat one costs more than anything else here. Edit or delete
27
- // this — it is your file.
28
- const radius = 260;
29
- const geometry = new SphereGeometry(radius, 24, 12);
30
- const positions = geometry.getAttribute("position");
31
- const colors = new Float32Array(positions.count * 3);
32
- const color = new Color();
33
- for (let index = 0; index < positions.count; index += 1) {
34
- const height = MathUtils.clamp((positions.getY(index) / radius + 0.2) / 0.65, 0, 1);
35
- color.copy(bottom).lerp(top, height);
36
- colors.set([color.r, color.g, color.b], index * 3);
37
- }
38
- geometry.setAttribute("color", new BufferAttribute(colors, 3));
27
+ /** Unit vector toward the photographed sun: 47.9° up, measured from the source HDR. */
28
+ export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
39
29
 
40
- const dome = new Mesh(
41
- geometry,
42
- // `fog: false` because the dome is the horizon; fogging it collapses the gradient above back
43
- // into the single wash this replaced.
44
- new MeshBasicMaterial({ fog: false, side: BackSide, toneMapped: false, vertexColors: true }),
45
- );
46
- dome.frustumCulled = false;
47
- scene.add(dome);
30
+ /**
31
+ * Puts the sky on the scene, or a plain gradient if the photograph has not decoded yet.
32
+ *
33
+ * The second argument is optional because `Race.load()` does not wait for the JPEG: the scene has
34
+ * to enter on the first frame or the playtest bridge describes nothing. Passing `undefined` here is
35
+ * the fallback the scene starts in, and calling it again with the texture is the swap.
36
+ */
37
+ export function setupSky(scene: Scene, sky?: Texture): void {
38
+ if (sky === undefined) {
39
+ scene.background = new Color(palette.skyHigh);
40
+ scene.environment = null;
41
+ scene.environmentIntensity = 0;
42
+ } else {
43
+ sky.mapping = EquirectangularReflectionMapping;
44
+ sky.colorSpace = SRGBColorSpace;
45
+ scene.background = sky;
46
+ scene.backgroundIntensity = SKY_RANGE;
47
+ // three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
48
+ // It is what makes a standard material read as a material: sky-blue fill on faces the sun
49
+ // misses, and a sky to reflect, sharper as roughness drops.
50
+ scene.environment = sky;
51
+ scene.environmentIntensity = SKY_RANGE;
52
+ }
53
+ // Nothing inside the circuit (2.4% at 40 m), and the ground gone into the horizon by a kilometre
54
+ // — so the treeline meets the sky instead of ending at a line.
55
+ scene.fog = new FogExp2(palette.horizon, 0.0024);
48
56
  }
@@ -84,7 +84,7 @@ export class TouchControls {
84
84
 
85
85
  constructor(camera: PerspectiveCamera) {
86
86
  this.#camera = camera;
87
- this.#idleMaterial = overlayMaterial(palette.shadow, 0.35);
87
+ this.#idleMaterial = overlayMaterial(palette.structure, 0.35);
88
88
  this.#activeMaterial = overlayMaterial(palette.accent, 0.62);
89
89
  this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
90
90
  this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);
@@ -24,8 +24,10 @@ import {
24
24
  } from "three";
25
25
  import { bloom } from "three/addons/tsl/display/BloomNode.js";
26
26
  import { denoise } from "three/addons/tsl/display/DenoiseNode.js";
27
+ import { fxaa } from "three/addons/tsl/display/FXAANode.js";
27
28
  import { ao } from "three/addons/tsl/display/GTAONode.js";
28
29
  import { godrays } from "three/addons/tsl/display/GodraysNode.js";
30
+ import { smaa } from "three/addons/tsl/display/SMAANode.js";
29
31
  import { ssgi } from "three/addons/tsl/display/SSGINode.js";
30
32
  import { ssr } from "three/addons/tsl/display/SSRNode.js";
31
33
  import { sharpen } from "three/addons/tsl/display/SharpenNode.js";
@@ -33,6 +35,7 @@ import {
33
35
  color,
34
36
  convertToTexture,
35
37
  float,
38
+ max,
36
39
  metalness,
37
40
  mrt,
38
41
  normalView,
@@ -45,6 +48,9 @@ import {
45
48
  } from "three/tsl";
46
49
  import type { Node } from "three/webgpu";
47
50
 
51
+ /** Godot's `Viewport.screen_space_aa`: which post-process antialiasing smooths the frame's edges. */
52
+ export type ScreenSpaceAA = "smaa" | "fxaa" | "disabled";
53
+
48
54
  /** Godot's `Environment.tonemap_mode`, with the modes Three.js actually ships. */
49
55
  export type TonemapMode = "aces" | "agx" | "neutral";
50
56
 
@@ -184,6 +190,16 @@ export interface IWorldEnvironmentOptions {
184
190
  readonly sharpenStrength?: number;
185
191
  /** Corner darkening, as a fraction removed at the extreme corner. Zero disables it. */
186
192
  readonly vignetteAmount?: number;
193
+ /**
194
+ * Post-process antialiasing, run last. Godot's `Viewport.screen_space_aa`. Default `"smaa"`.
195
+ *
196
+ * Not optional in practice: the chain renders `pass(scene, camera)` single-sampled, so the moment
197
+ * any stage runs, the renderer's own multisampling no longer reaches the frame and every edge
198
+ * stairsteps — the single loudest "this is a prototype" signal in a frame. It is requested only
199
+ * when some other stage (or a `baseColour`) installs a chain; with nothing installed the renderer
200
+ * draws straight to the canvas with its own MSAA and this would be paying twice.
201
+ */
202
+ readonly screenSpaceAA?: ScreenSpaceAA;
187
203
  /** Godot's `glow_enabled`. */
188
204
  readonly bloomEnabled?: boolean;
189
205
  readonly bloomStrength?: number;
@@ -391,6 +407,7 @@ export class WorldEnvironment {
391
407
  sharpenEnabled: options.sharpenEnabled ?? false,
392
408
  sharpenStrength: options.sharpenStrength ?? 0.2,
393
409
  vignetteAmount: options.vignetteAmount ?? 0,
410
+ screenSpaceAA: options.screenSpaceAA ?? "smaa",
394
411
  bloomEnabled: options.bloomEnabled ?? true,
395
412
  bloomStrength: options.bloomStrength ?? 0.7,
396
413
  bloomRadius: options.bloomRadius ?? 0.5,
@@ -432,6 +449,11 @@ export class WorldEnvironment {
432
449
  (name === "vignette" && options.vignetteAmount > 0),
433
450
  );
434
451
  requested.push(...options.authoredStageNames);
452
+ if (
453
+ options.screenSpaceAA !== "disabled" &&
454
+ (requested.length > 0 || target.baseColour !== undefined)
455
+ )
456
+ requested.push("antialias");
435
457
 
436
458
  // With no stage running there is no node graph to install — the renderer's own
437
459
  // tone-mapping path renders the frame, and the exposure scalar is live there (measured:
@@ -542,7 +564,14 @@ export class WorldEnvironment {
542
564
  // Applied before SSGI by the chain's canonical order; composing it after the GI
543
565
  // combine instead darkens crevices the gather re-lit — that is a look choice, and
544
566
  // this file is where you make it.
545
- return input.mul(contact.r);
567
+ //
568
+ // Denoised with the same depth-aware filter as the GI gather: GTAO's interleaved
569
+ // sampling otherwise reads as a speckled halo around every contact — around feet on a
570
+ // plain floor most of all — which is exactly the "not smooth" a player notices first.
571
+ const occlusion = options.denoiseEnabled
572
+ ? denoised(denoise(contact.getTextureNode(), depth(), normal(), view))
573
+ : contact;
574
+ return input.mul(occlusion.r);
546
575
  },
547
576
  }),
548
577
  stage({
@@ -668,6 +697,26 @@ export class WorldEnvironment {
668
697
  return input.mul(fall.oneMinus());
669
698
  },
670
699
  }),
700
+ {
701
+ // Last, after every built-in: antialiasing is defined on the finished picture, and any
702
+ // stage after it would put the stairsteps back.
703
+ name: "antialias",
704
+ after: "gradualBackground",
705
+ build: (input) => {
706
+ const colour = input as ChainNode;
707
+ // SMAA and FXAA find edges by local contrast and expect display-range colour, but this is
708
+ // the linear HDR frame before the tone curve — a sun-lit edge at 20 against sky at 3
709
+ // would blend into a bright halo. The reversible Karis weighting squeezes it into [0, 1)
710
+ // for the filter and expands it back afterwards, so edges resolve without the halo.
711
+ const peak = max(colour.r, max(colour.g, colour.b));
712
+ const squeezed = colour.div(peak.add(1));
713
+ const filtered = (options.screenSpaceAA === "fxaa"
714
+ ? fxaa(squeezed)
715
+ : smaa(squeezed)) as unknown as ChainNode;
716
+ const back = max(filtered.r, max(filtered.g, filtered.b));
717
+ return filtered.div(float(1).sub(back).max(1e-4));
718
+ },
719
+ },
671
720
  ];
672
721
 
673
722
  // The kit's own stages, composed after the built-ins. The factory is called with the two
@@ -723,6 +772,7 @@ export class WorldEnvironment {
723
772
  const options = this.#options;
724
773
  const off: Record<string, string> = {
725
774
  ambientOcclusion: "gtaoEnabled is false",
775
+ antialias: 'screenSpaceAA is "disabled", or no other stage installed a chain',
726
776
  bloom: "bloomEnabled is false",
727
777
  godRays: "godraysEnabled is false",
728
778
  sharpen: "sharpenEnabled is false",
@@ -745,6 +795,7 @@ export class WorldEnvironment {
745
795
  denoise: options.denoiseEnabled,
746
796
  exposure: options.exposure,
747
797
  marker: "TN_WORLD_ENVIRONMENT",
798
+ screenSpaceAA: options.screenSpaceAA,
748
799
  ssgiQuality: options.ssgiQuality,
749
800
  stages,
750
801
  tonemapMode: options.tonemapMode,
@@ -2,32 +2,46 @@ import {
2
2
  type ICtx,
3
3
  Scene,
4
4
  type SceneFrame,
5
+ afterPhysics,
5
6
  isMobile,
6
7
  isTouchscreenAvailable,
7
8
  } from "@threenative/core";
8
9
  import type { IPhysicsContext } from "@threenative/physics";
9
- import { type PerspectiveCamera, Vector3 } from "three";
10
- import { RACING_FEEL, RacingCar } from "../entities/RacingCar.js";
10
+ import { type PerspectiveCamera, type Texture, Vector3 } from "three";
11
+ import { type CarCtx, FEEL } from "../entities/CarBody.js";
12
+ import { RacingCar } from "../entities/RacingCar.js";
11
13
  import { Rival } from "../entities/Rival.js";
12
14
  import { emitPlaytestEvent } from "../playtest-events.js";
13
- import { cameraRoll, chaseCamera, setupCamera } from "../render/camera.js";
15
+ import { cameraBank, chaseCamera, setupCamera } from "../render/camera.js";
14
16
  import { setupLighting } from "../render/lighting.js";
15
17
  import { createLoadingScreen } from "../render/loading.js";
16
- import { createMaterials } from "../render/materials.js";
17
18
  import { setupPost } from "../render/postprocessing.js";
18
- import { flag } from "../render/shapes.js";
19
- import { setupSky } from "../render/sky.js";
19
+ import { SUN_DIRECTION, setupSky } from "../render/sky.js";
20
20
  import { TouchControls } from "../render/touch-controls.js";
21
21
  import { type GameState, type RaceStatus, resolveRaceStatus } from "../state.js";
22
22
  import { Lap } from "../track/Lap.js";
23
23
  import { type IRankedRacer, type IRankedRacerScratch, rankRacers } from "../track/Ranking.js";
24
- import { TOTAL_LAPS, buildTrack, intersectRay, roadRayProbe } from "../track/Track.js";
24
+ import {
25
+ TOTAL_LAPS,
26
+ buildTrack,
27
+ gridHeading,
28
+ gridPosition,
29
+ intersectRay,
30
+ roadRayProbe,
31
+ } from "../track/Track.js";
25
32
  import { TrackSector } from "../track/TrackSector.js";
33
+ import { CIRCUIT, GRID_DISTANCE } from "../track/circuit.js";
26
34
 
27
- export type GameCtx = ICtx<GameState, IPhysicsContext>;
35
+ export type GameCtx = CarCtx;
28
36
 
29
- const SPAWN = new Vector3(2, 0.55, -18);
30
- const TIME_LIMIT = 90;
37
+ /** The player starts on the second grid slot, one ride height above the tarmac. */
38
+ const SPAWN = gridPosition("player", new Vector3());
39
+ SPAWN.y = CIRCUIT.at(GRID_DISTANCE.player, CIRCUIT.createSample()).point.y + 0.22;
40
+ /**
41
+ * The race is three laps of 55-60 s, so a time limit under four minutes is a limit nobody reaches
42
+ * and one that only fires on a car that has already been rescued four times.
43
+ */
44
+ const TIME_LIMIT = 260;
31
45
 
32
46
  function playerRanking(ranked: readonly IRankedRacer[]): IRankedRacer | undefined {
33
47
  for (let index = 0; index < ranked.length; index += 1) {
@@ -45,6 +59,7 @@ export class Race extends Scene<GameState, IPhysicsContext> {
45
59
  static override readonly initialState: GameState = {
46
60
  paused: false,
47
61
  uiReady: false,
62
+ autopilot: false,
48
63
  boostActive: false,
49
64
  boostPeakSpeed: 0,
50
65
  boostUses: 0,
@@ -55,8 +70,11 @@ export class Race extends Scene<GameState, IPhysicsContext> {
55
70
  position: "P1",
56
71
  raceStatus: "RACING",
57
72
  rescueHeading: 0,
58
- rescueHeadingError: -1,
59
- rescuePositionError: -1,
73
+ // Before any rescue, both errors are the worst they could be: the car is facing the wrong way
74
+ // and it is a whole lap from where it belongs. A sentinel of -1 satisfies an "at most 0.05 rad"
75
+ // assertion before the game has done anything, which is how a bound stops being a bound.
76
+ rescueHeadingError: Math.PI,
77
+ rescuePositionError: Math.PI,
60
78
  rescues: 0,
61
79
  shortcutRejects: 0,
62
80
  speed: 0,
@@ -68,12 +86,40 @@ export class Race extends Scene<GameState, IPhysicsContext> {
68
86
  reverseRejects: 0,
69
87
  };
70
88
 
89
+ #sky: Texture | undefined;
90
+
91
+ /**
92
+ * The sky photograph, fetched but **not awaited**.
93
+ *
94
+ * `await`ing it here held the scene's first frame for the length of a texture decode, and the
95
+ * playtest bridge describes the scene before the runtime enters it: `survives` failed
96
+ * `TN_PLAYTEST_CAPABILITY_MISSING` on `runtime.components` because there was no `player` entity
97
+ * yet to describe. The scene now enters on the fallback colour and the photograph is swapped in
98
+ * the moment it decodes, which is also what a player sees — a sky that arrives rather than a
99
+ * black screen that waits.
100
+ */
101
+ override load(ctx: GameCtx): void {
102
+ void ctx.assets.texture("sky.jpg").then((texture) => {
103
+ this.#sky = texture;
104
+ const scene = ctx.scene;
105
+ if (scene !== undefined) setupSky(scene, texture);
106
+ });
107
+ }
108
+
71
109
  override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
72
- setupSky(ctx.scene);
73
- const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
110
+ if (this.#sky === undefined) setupSky(ctx.scene, undefined);
111
+ const lighting = setupLighting(
112
+ ctx.scene,
113
+ ctx.renderer.raw as Parameters<typeof setupLighting>[1],
114
+ isMobile(),
115
+ );
74
116
  // isMobile() arrives as an argument because src/render/ imports no framework package: the
75
117
  // platform decision is made here, in portable game code, exactly like createRandom.
76
- setupPost(ctx.renderer, ctx.scene, ctx.camera, { godraysLight: sun, mobile: isMobile() });
118
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, {
119
+ godraysLight: lighting.key,
120
+ mobile: isMobile(),
121
+ software: ctx.renderer.softwareAdapter !== undefined,
122
+ });
77
123
  const loading = createLoadingScreen(ctx);
78
124
  const camera = ctx.camera as PerspectiveCamera;
79
125
  setupCamera(camera);
@@ -83,46 +129,43 @@ export class Race extends Scene<GameState, IPhysicsContext> {
83
129
  ? ctx.entities.add("touch-controls", new TouchControls(camera))
84
130
  : undefined;
85
131
  const track = buildTrack(ctx);
86
- const car = new RacingCar(ctx, SPAWN);
87
- const spawnDistance = track.route.project(SPAWN).distanceFromStart % track.route.totalLength;
88
- const rival = new Rival(track.route, spawnDistance + track.route.totalLength);
89
- rival.update(0);
90
- rival.mesh.position.copy(car.mesh.position);
91
- ctx.add(rival.mesh);
132
+ const car = new RacingCar(ctx, SPAWN, gridHeading("player"));
133
+ // The rival's own grid slot, projected onto the circuit it drives: on pole, four metres up the
134
+ // road and 4.4 m to the other side, facing the same way. It used to be placed a whole lap
135
+ // ahead and then copied onto the player's position, so the two cars were the same point in
136
+ // space and the player drove through a rival that had no body.
137
+ const rival = new Rival(ctx, GRID_DISTANCE.rival);
92
138
  ctx.entities.add("player", car);
93
139
  ctx.entities.add("rival", rival);
94
- const flagMaterial = createMaterials().boost;
95
- for (const point of [new Vector3(14, 0, -18), new Vector3(-14, 0, 18)]) {
96
- const marker = flag(flagMaterial);
97
- marker.position.copy(point);
98
- ctx.add(marker);
99
- }
100
140
 
141
+ // `travelDirection` is the car's **measured** velocity, not the heading it was asked for: a
142
+ // car that is sliding through a corner is travelling somewhere other than where it points, and
143
+ // a lap counted on the intent is a lap counted on a wish.
101
144
  const lap = new Lap(
102
- { body: car.body, forward: car.travelDirection },
145
+ { body: car.body.body, forward: car.travelDirection },
103
146
  track.gates,
104
147
  TOTAL_LAPS,
105
148
  (completed) => emitPlaytestEvent({ entity: "player", lap: completed, name: "lap-completed" }),
106
149
  );
107
- const playerRankingInput = { id: "player", lap: lap.completed, position: car.mesh.position };
150
+ const playerRankingInput = { id: "player", lap: lap.completed, position: car.body.position };
108
151
  const rivalRankingInput = { id: "rival", lap: rival.lap, position: rival.mesh.position };
109
152
  const rankingInputs = [playerRankingInput, rivalRankingInput];
110
153
  const rankingBuffer: IRankedRacerScratch[] = [];
111
154
  const rankRace = () => {
112
155
  playerRankingInput.lap = lap.completed;
113
156
  rivalRankingInput.lap = rival.lap;
114
- return rankRacers(track.route, rankingInputs, undefined, rankingBuffer);
157
+ return rankRacers(CIRCUIT, rankingInputs, undefined, rankingBuffer);
115
158
  };
116
159
  const initialRanked = rankRace();
117
160
  const initialPlayer = playerRanking(initialRanked);
118
161
  if (initialPlayer === undefined) throw new Error("Race ranking lost the player at spawn.");
119
162
  const fallbackProbe = roadRayProbe(track.roadMeshes);
120
163
  const sector = new TrackSector({
121
- route: track.route,
164
+ route: CIRCUIT,
122
165
  intersectRay: intersectRay(ctx.physics, fallbackProbe),
123
166
  });
124
167
  track.boostArea.on("bodyEntered", (body) => {
125
- if (body === car.body) {
168
+ if (body === car.body.body) {
126
169
  car.boost.activate();
127
170
  emitPlaytestEvent({ entity: "player", name: "boost-applied" });
128
171
  }
@@ -131,33 +174,34 @@ export class Race extends Scene<GameState, IPhysicsContext> {
131
174
  let elapsed = 0;
132
175
  let status: RaceStatus = "RACING";
133
176
  let rescues = 0;
134
- let rescueHeadingError = -1;
135
- let rescuePositionError = -1;
136
- let speedAfterBoost = 0;
137
- let boostSettled = false;
177
+ // Before any rescue, both are the worst they can be: a car facing the wrong way, a whole lap
178
+ // from where it belongs. A sentinel of -1 satisfies an "at most 0.05 rad" bound before the game
179
+ // has done anything, which is how a bound stops being a bound.
180
+ let rescueHeadingError = Math.PI;
181
+ let rescuePositionError = Math.PI;
138
182
  let sameDistanceRanking = initialRanked[0]?.id === "rival" ? "lap-ahead" : "lap-behind";
139
183
  let place = initialPlayer.place;
140
184
  let positionLabel = `P${place}`;
141
185
  const lastOnRoad: [number, number, number] = [SPAWN.x, SPAWN.y, SPAWN.z];
142
186
  const observedPosition = SPAWN.clone();
143
- sector.update(SPAWN, car.forward, 0);
144
- chaseCamera(camera, car.mesh.position, car.forward, 1);
187
+ sector.update(SPAWN, car.forward, 0, 0);
188
+ chaseCamera(camera, car.body.position, car.forward, 1, undefined);
145
189
 
146
190
  const advanceRace = (frameCtx: GameCtx, dt: number): void => {
147
191
  if (status !== "RACING") return;
148
- lap.observe(observedPosition, car.mesh.position);
149
- observedPosition.copy(car.mesh.position);
192
+ lap.observe(observedPosition, car.body.position);
193
+ observedPosition.copy(car.body.position);
150
194
  car.update(
151
195
  frameCtx,
152
196
  dt,
153
197
  touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
154
198
  );
155
199
  rival.update(dt);
156
- sector.update(car.mesh.position, car.forward, dt);
200
+ sector.update(car.body.position, car.forward, dt, car.speed);
157
201
  if (sector.rescue(car)) {
158
202
  rescues += 1;
159
203
  rescuePositionError = quantize(
160
- car.mesh.position.distanceTo(sector.lastOnRoadPosition),
204
+ car.body.position.distanceTo(sector.lastOnRoadPosition),
161
205
  10_000,
162
206
  );
163
207
  rescueHeadingError = quantize(car.forward.angleTo(sector.lastOnRoadHeading), 10_000);
@@ -168,6 +212,23 @@ export class Race extends Scene<GameState, IPhysicsContext> {
168
212
 
169
213
  const statePatch: Partial<GameState> = {};
170
214
 
215
+ // The suspension and the camera both read the **solved** chassis, so they run in the
216
+ // afterPhysics phase rather than in the scene frame: a wheel's spin angle and a car's velocity
217
+ // are last step's numbers until the step after this one.
218
+ //
219
+ // The sun's shadow camera follows the car. It used to be a fixed 30 m box around the origin,
220
+ // which on an 830 m circuit put every shadow on the grass and left the car's own shadow — the
221
+ // speed cue a driver actually reads — somewhere else entirely.
222
+ afterPhysics(ctx, (dt) => {
223
+ car.body.settleVisuals();
224
+ rival.car.settleVisuals();
225
+ lighting.key.target.position.copy(car.body.position);
226
+ lighting.key.position.copy(car.body.position).addScaledVector(SUN_DIRECTION, 90);
227
+ const solved = car.body.body.linearVelocity;
228
+ chaseCamera(camera, car.body.position, car.travelDirection, dt, solved);
229
+ camera.rotateZ(cameraBank(car.lateralLoad, FEEL.lateral));
230
+ });
231
+
171
232
  return (frameCtx, dt) => {
172
233
  loading.update();
173
234
  if (frameCtx.input.justPressed("restart")) {
@@ -178,13 +239,6 @@ export class Race extends Scene<GameState, IPhysicsContext> {
178
239
  }
179
240
  elapsed += dt;
180
241
  advanceRace(frameCtx, dt);
181
- if (!car.boost.active && car.boost.uses > 0 && !boostSettled) {
182
- const settledSpeed = car.speedAfterBoost();
183
- if (Math.abs(settledSpeed - RACING_FEEL.maxSpeed) < 0.001) {
184
- speedAfterBoost = settledSpeed;
185
- boostSettled = true;
186
- }
187
- }
188
242
  const ranked = rankRace();
189
243
  const player = playerRanking(ranked);
190
244
  if (player === undefined) throw new Error("Race ranking lost the player.");
@@ -195,11 +249,12 @@ export class Race extends Scene<GameState, IPhysicsContext> {
195
249
  positionLabel = `P${place}`;
196
250
  }
197
251
  const previous = frameCtx.state.getState();
198
- const boostPeakSpeed = Math.max(previous.boostPeakSpeed, car.boost.active ? car.speed : 0);
252
+ const boostPeakSpeed = Math.max(previous.boostPeakSpeed, car.boosting ? car.speed : 0);
199
253
  lastOnRoad[0] = sector.lastOnRoadPosition.x;
200
254
  lastOnRoad[1] = sector.lastOnRoadPosition.y;
201
255
  lastOnRoad[2] = sector.lastOnRoadPosition.z;
202
- statePatch.boostActive = car.boost.active;
256
+ statePatch.autopilot = car.autopilotEngaged;
257
+ statePatch.boostActive = car.boosting;
203
258
  statePatch.boostPeakSpeed = boostPeakSpeed;
204
259
  statePatch.boostUses = car.boost.uses;
205
260
  statePatch.completedLaps = lap.completed;
@@ -214,14 +269,12 @@ export class Race extends Scene<GameState, IPhysicsContext> {
214
269
  statePatch.rescues = rescues;
215
270
  statePatch.shortcutRejects = lap.shortcutRejects;
216
271
  statePatch.speed = car.speed;
217
- statePatch.speedAfterBoost = speedAfterBoost;
272
+ statePatch.speedAfterBoost = car.speedAfterBoost();
218
273
  statePatch.sameDistanceRanking = sameDistanceRanking;
219
274
  statePatch.topSpeed = Math.max(previous.topSpeed, car.topSpeed);
220
275
  statePatch.trackProgress = player.routeProgress;
221
276
  statePatch.reverseRejects = lap.reverseRejects;
222
277
  frameCtx.state.set(statePatch);
223
- chaseCamera(camera, car.mesh.position, car.forward, dt);
224
- cameraRoll(camera, car.forward);
225
278
  };
226
279
  }
227
280
  }
@@ -11,6 +11,8 @@ export function resolveRaceStatus(
11
11
  }
12
12
 
13
13
  export type GameState = {
14
+ /** True while the closed-loop demo driver has the wheel. A scenario asserts it drove. */
15
+ autopilot: boolean;
14
16
  /** Set from the UI\'s pause and resume intents, and read back by the menu. */
15
17
  paused: boolean;
16
18
  /** True once the UI layer has rendered and published its interactive rectangles. */
@@ -1,19 +1,34 @@
1
- import type { Area3D } from "@threenative/physics";
2
- import type { Vector3 } from "three";
1
+ import { Vector3 } from "three";
3
2
 
4
- export type ChecklineId = "finish" | "mid";
3
+ export type ChecklineId = "finish" | "sector-1" | "sector-2";
5
4
 
6
- /** An ordered crossing plane used by Lap to reject shortcuts. */
5
+ /**
6
+ * A line drawn across the road, and where the car crossed it.
7
+ *
8
+ * `at` and `forward` describe the line; `across` and `halfWidth` are what stop it being an infinite
9
+ * plane. The sector-2 gate's plane is `x = 117`, and the main straight runs along `x` from 25 to
10
+ * 195, so an unbounded test rejects the main straight for crossing a gate that is three hundred
11
+ * metres away up the circuit. Measured: that one false crossing was the reverse rejection the
12
+ * `reverse` playtest used to read on a car driving forwards.
13
+ *
14
+ * There is no sensor here. `Lap` counts a crossing by sweeping the car's transform between frames,
15
+ * which sees every crossing exactly once, and an `Area3D` reports the same crossing a second time
16
+ * as the car's collider touches the gate's box — most of a metre before the plane. Two mechanisms
17
+ * counting one event is how a clean lap raised a `shortcutReject` at every gate.
18
+ */
7
19
  export class Checkline {
8
20
  readonly at: Vector3;
9
- readonly area: Area3D;
10
21
  readonly forward: Vector3;
22
+ /** The direction across the road, so a crossing is only a crossing where the line is drawn. */
23
+ readonly across: Vector3;
24
+ readonly halfWidth: number;
11
25
  readonly id: ChecklineId;
12
26
 
13
- constructor(id: ChecklineId, at: Vector3, forward: Vector3, area: Area3D) {
27
+ constructor(id: ChecklineId, at: Vector3, forward: Vector3, halfWidth: number) {
14
28
  this.id = id;
15
29
  this.at = at.clone();
16
30
  this.forward = forward.clone().setY(0).normalize();
17
- this.area = area;
31
+ this.across = new Vector3(-this.forward.z, 0, this.forward.x);
32
+ this.halfWidth = halfWidth;
18
33
  }
19
34
  }