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,23 +1,168 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
- import { MeshStandardMaterial } from "three";
3
+ //
4
+ // The prototype look every engine ships a new project with: a metre grid on neutral greys, one
5
+ // saturated colour for things you can touch, and a metal figure. It reads as "a real engine" only
6
+ // because `sky.ts` gives every surface an environment to reflect — roughness then decides how much
7
+ // sky a surface mirrors, so keep it varied between neighbours.
8
+ import {
9
+ type BufferGeometry,
10
+ DataTexture,
11
+ Float32BufferAttribute,
12
+ LinearMipmapLinearFilter,
13
+ MeshStandardMaterial,
14
+ RepeatWrapping,
15
+ SRGBColorSpace,
16
+ Vector2,
17
+ Vector3,
18
+ } from "three";
4
19
  import { palette } from "./palette.js";
5
20
 
21
+ /**
22
+ * One metre of grid: a heavy line on the metre, faint lines every 25 cm, a faint per-texel grain so
23
+ * large areas do not band. Built from bytes rather than a canvas so it runs the same in the browser
24
+ * and in the native host.
25
+ */
26
+ function gridTexture(base: number, line: number, size = 256): DataTexture {
27
+ const data = new Uint8Array(size * size * 4);
28
+ const minorEvery = size / 4;
29
+ let seed = 7;
30
+ for (let y = 0; y < size; y += 1) {
31
+ for (let x = 0; x < size; x += 1) {
32
+ const major = x < 3 || y < 3;
33
+ const minor = x % minorEvery < 1 || y % minorEvery < 1;
34
+ const weight = major ? 0.92 : minor ? 0.22 : 0;
35
+ seed = (seed * 16807) % 2147483647;
36
+ const grain = 1 + (seed / 2147483647 - 0.5) * 0.04;
37
+ const index = (y * size + x) * 4;
38
+ for (let channel = 0; channel < 3; channel += 1) {
39
+ const shift = 16 - channel * 8;
40
+ const from = ((base >> shift) & 0xff) * grain;
41
+ const to = (line >> shift) & 0xff;
42
+ data[index + channel] = Math.min(255, Math.round(from * (1 - weight) + to * weight));
43
+ }
44
+ data[index + 3] = 255;
45
+ }
46
+ }
47
+ const texture = new DataTexture(data, size, size);
48
+ texture.colorSpace = SRGBColorSpace;
49
+ texture.wrapS = RepeatWrapping;
50
+ texture.wrapT = RepeatWrapping;
51
+ texture.generateMipmaps = true;
52
+ texture.minFilter = LinearMipmapLinearFilter;
53
+ texture.anisotropy = 16;
54
+ texture.needsUpdate = true;
55
+ return texture;
56
+ }
57
+
58
+ const _normal = new Vector3();
59
+
60
+ /**
61
+ * A faint cast-concrete grain as a tangent-space normal map: two octaves of smoothed value noise,
62
+ * tiling every metre like the grid. It is what stops a large flat face reading as an untextured
63
+ * blockout under a low sun — the light breaks up across it instead of sliding off in one tone.
64
+ * Bytes, not a file, so it costs nothing to ship and runs on every target.
65
+ */
66
+ function grainNormalTexture(size = 128): DataTexture {
67
+ const cells = [8, 32];
68
+ const lattice = cells.map((count) => {
69
+ const values = new Float32Array(count * count);
70
+ let seed = count * 7919;
71
+ for (let index = 0; index < values.length; index += 1) {
72
+ seed = (seed * 16807) % 2147483647;
73
+ values[index] = seed / 2147483647;
74
+ }
75
+ return { count, values };
76
+ });
77
+ const height = (x: number, y: number): number => {
78
+ let total = 0;
79
+ for (const [octave, { count, values }] of lattice.entries()) {
80
+ const u = (x / size) * count;
81
+ const v = (y / size) * count;
82
+ const x0 = Math.floor(u);
83
+ const y0 = Math.floor(v);
84
+ const fx = u - x0;
85
+ const fy = v - y0;
86
+ const sx = fx * fx * (3 - 2 * fx);
87
+ const sy = fy * fy * (3 - 2 * fy);
88
+ const at = (i: number, j: number): number =>
89
+ values[(((j % count) + count) % count) * count + (((i % count) + count) % count)] ?? 0;
90
+ const top = at(x0, y0) + (at(x0 + 1, y0) - at(x0, y0)) * sx;
91
+ const bottom = at(x0, y0 + 1) + (at(x0 + 1, y0 + 1) - at(x0, y0 + 1)) * sx;
92
+ total += (top + (bottom - top) * sy) * (octave === 0 ? 1 : 0.5);
93
+ }
94
+ return total;
95
+ };
96
+ const data = new Uint8Array(size * size * 4);
97
+ for (let y = 0; y < size; y += 1) {
98
+ for (let x = 0; x < size; x += 1) {
99
+ const dx = height(x + 1, y) - height(x - 1, y);
100
+ const dy = height(x, y + 1) - height(x, y - 1);
101
+ _normal.set(-dx * 4, -dy * 4, 1).normalize();
102
+ const index = (y * size + x) * 4;
103
+ data[index] = Math.round((_normal.x * 0.5 + 0.5) * 255);
104
+ data[index + 1] = Math.round((_normal.y * 0.5 + 0.5) * 255);
105
+ data[index + 2] = Math.round((_normal.z * 0.5 + 0.5) * 255);
106
+ data[index + 3] = 255;
107
+ }
108
+ }
109
+ const texture = new DataTexture(data, size, size);
110
+ texture.wrapS = RepeatWrapping;
111
+ texture.wrapT = RepeatWrapping;
112
+ texture.generateMipmaps = true;
113
+ texture.minFilter = LinearMipmapLinearFilter;
114
+ texture.needsUpdate = true;
115
+ return texture;
116
+ }
117
+
118
+ const grain = grainNormalTexture();
119
+
120
+ /**
121
+ * Rewrites a geometry's UVs as world metres, projected along each face's dominant axis, so one grid
122
+ * tile is one metre on every face of every prop regardless of its size. Call it after the geometry
123
+ * is translated into place (merged geometry included), before it is given to a mesh.
124
+ */
125
+ export function worldGridUVs<T extends BufferGeometry>(geometry: T): T {
126
+ const position = geometry.getAttribute("position");
127
+ const normal = geometry.getAttribute("normal");
128
+ const uv = new Float32Array(position.count * 2);
129
+ for (let index = 0; index < position.count; index += 1) {
130
+ _normal.fromBufferAttribute(normal, index);
131
+ const x = position.getX(index);
132
+ const y = position.getY(index);
133
+ const z = position.getZ(index);
134
+ const ax = Math.abs(_normal.x);
135
+ const ay = Math.abs(_normal.y);
136
+ const az = Math.abs(_normal.z);
137
+ const [u, v] = ay >= ax && ay >= az ? [x, z] : ax >= az ? [z, y] : [x, y];
138
+ uv[index * 2] = u;
139
+ uv[index * 2 + 1] = v;
140
+ }
141
+ geometry.setAttribute("uv", new Float32BufferAttribute(uv, 2));
142
+ return geometry;
143
+ }
144
+
145
+ /** Light grid: floors and the ground. */
6
146
  export const floorMaterial = new MeshStandardMaterial({
7
- color: palette.floor,
8
- roughness: 0.78,
9
- metalness: 0.12,
147
+ map: gridTexture(palette.floor, palette.gridLine),
148
+ normalMap: grain,
149
+ normalScale: new Vector2(0.18, 0.18),
150
+ roughness: 0.62,
151
+ metalness: 0,
10
152
  });
11
153
 
12
- /** The player's visor and boots: the one warm note against a cool morning. */
13
- export const accentMaterial = new MeshStandardMaterial({
14
- color: palette.accent,
15
- roughness: 0.6,
16
- metalness: 0.05,
154
+ /** Dark grid: walls, pillars, anything structural. */
155
+ export const structureMaterial = new MeshStandardMaterial({
156
+ map: gridTexture(palette.structure, palette.gridLine),
157
+ normalMap: grain,
158
+ normalScale: new Vector2(0.18, 0.18),
159
+ roughness: 0.7,
160
+ metalness: 0,
17
161
  });
18
162
 
19
- export const defaultMaterial = new MeshStandardMaterial({
20
- color: palette.player,
21
- roughness: 0.52,
22
- metalness: 0.08,
163
+ /** The one saturated colour: things you can push, pick up or stand on. */
164
+ export const propMaterial = new MeshStandardMaterial({
165
+ color: palette.prop,
166
+ roughness: 0.45,
167
+ metalness: 0,
23
168
  });
@@ -1,9 +1,12 @@
1
- // Generated for you. Keep these six roles coherent when you change the look.
1
+ // Generated for you. Keep these roles coherent when you change the look.
2
+ // Neutral greys carry the light; one saturated blue marks what you can touch.
2
3
  export const palette = {
3
- skyHigh: 0x14516e,
4
- skyLow: 0x1b3a4e,
5
- floor: 0x27566b,
6
- player: 0x6fe8ff,
7
- accent: 0xffd27a,
8
- shadow: 0x24414f,
4
+ floor: 0xb4b1ae,
5
+ structure: 0x747578,
6
+ gridLine: 0x3a3a3c,
7
+ prop: 0x2a6cf0,
8
+ /** Touch-control highlight. */
9
+ accent: 0xffffff,
10
+ /** The sky photograph's own horizon, measured from its HDR: distance fades into this. */
11
+ horizon: 0xacb1c1,
9
12
  } as const;
@@ -11,49 +11,36 @@
11
11
  // `setupPost(renderer, scene, camera, { tier: "low" })`. Overriding does not silence the report:
12
12
  // `TN_QUALITY_TIER` names the tier that ran either way.
13
13
  import type { Camera, DirectionalLight, Scene } from "three";
14
- import { vec3 } from "three/tsl";
15
- import type { Node } from "three/webgpu";
16
14
  import { type QualityTier, qualityPreset, resolveQualityTier } from "./quality.js";
17
15
  import type { OutputRenderer } from "./worldEnvironment.js";
18
16
  import { WorldEnvironment } from "./worldEnvironment.js";
19
17
 
20
- type AtmosphereLike = {
21
- aerialPerspective(scenePass: unknown, depth: unknown, inScatteredRadiance?: unknown): unknown;
22
- radiance(direction: unknown): unknown;
23
- };
24
-
25
18
  export function setupPost(
26
19
  renderer: OutputRenderer,
27
20
  scene: Scene,
28
21
  camera: Camera,
29
22
  environment: {
30
- atmosphere?: AtmosphereLike;
31
23
  godraysLight?: DirectionalLight;
32
24
  mobile?: boolean;
25
+ /** The renderer named a software adapter; this game's answer is its `low` tier. */
26
+ software?: boolean;
33
27
  /** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
34
28
  tier?: QualityTier;
35
29
  } = {},
36
30
  ): void {
37
- 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
+ });
38
36
  const source = environment.tier === undefined ? "platform" : "override";
39
- 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
+ );
40
42
  const world = new WorldEnvironment(qualityPreset(tier));
41
- const atmosphere = environment.atmosphere;
42
43
  world.apply(renderer, scene, camera, {
43
- // The chain builds the scene pass, so aerial perspective — which needs that pass and its
44
- // view-Z — is composed here, first, before exposure and before any stage. Delete this
45
- // property to drop aerial perspective while keeping the sky and the rest of the chain.
46
- baseColour:
47
- atmosphere === undefined
48
- ? undefined
49
- : (scenePass) =>
50
- atmosphere.aerialPerspective(
51
- scenePass,
52
- scenePass.getViewZNode(),
53
- // Same scale as the dome in sky.ts, and for the same reason: this radiance is
54
- // mixed into every pixel by the haze term, so at 24 it lifted the whole frame.
55
- (atmosphere.radiance(vec3(0, 0, 1)) as Node<"vec3">).mul(1.5),
56
- ) as Node<"vec4">,
57
44
  godraysLight: environment.godraysLight,
58
45
  });
59
46
  }
@@ -54,7 +54,7 @@ function isQualityTier(value: string): value is QualityTier {
54
54
  * turned out to have no effect.
55
55
  */
56
56
  export function resolveQualityTier(
57
- request: { readonly mobile?: boolean; readonly tier?: string } = {},
57
+ request: { readonly mobile?: boolean; readonly software?: boolean; readonly tier?: string } = {},
58
58
  ): QualityTier {
59
59
  const requested = request.tier;
60
60
  if (requested !== undefined) {
@@ -65,88 +65,54 @@ export function resolveQualityTier(
65
65
  }
66
66
  return requested;
67
67
  }
68
+ // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
69
+ // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
70
+ // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
71
+ // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
72
+ // `tier` above still wins over it.
73
+ if (request.software === true) return "low";
68
74
  return request.mobile === true ? "low" : "high";
69
75
  }
70
76
 
71
77
  /**
72
- * What a desktop gets: this template's shipped desktop look, unchanged.
78
+ * The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the sun
79
+ * disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey walls and
80
+ * flattens contrast), and a corner falloff. Antialiasing is on in every tier that installs a chain;
81
+ * see `screenSpaceAA` in `worldEnvironment.ts`.
73
82
  *
74
- * The whole chain measured 12.5 ms of a 14.7 ms GPU frame in the reference ablation, and SSGI
75
- * with its denoiser is ~9.2 ms of that.
83
+ * No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
84
+ * captured sky (`sky.ts`), and SSR on rough floors traced speckle into the grid; RCAS then rang the
85
+ * smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
76
86
  */
77
- const high: IWorldEnvironmentOptions = {
78
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
79
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
80
- // to be.
87
+ const shared: IWorldEnvironmentOptions = {
88
+ // Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
81
89
  bloomEnabled: true,
82
- bloomRadius: 0.5,
83
- bloomStrength: 0.5,
84
- bloomThreshold: 0.2,
85
- exposure: 1.15,
86
- // Screen-space reflections: ~4.1 ms.
87
- ssrEnabled: true,
88
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
89
- // are on and do nothing" — the ray dies a metre from where it started.
90
- ssrMaxDistance: 20,
91
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
92
- // the rays and is very hard to see in the result.
93
- ssrResolutionScale: 0.5,
94
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
95
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
96
- // that runs one of them.
97
- sharpenEnabled: true,
98
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
99
- sharpenStrength: 0.3,
90
+ bloomRadius: 0.6,
91
+ bloomStrength: 0.22,
92
+ bloomThreshold: 1,
93
+ exposure: 0.62,
100
94
  tonemapMode: "aces",
95
+ vignetteAmount: 0.22,
101
96
  };
102
97
 
103
98
  /**
104
- * The rung in between. With no SSGI to drop, the reflection is the only stage large enough to be
105
- * worth halving, so `medium` traces it at a quarter resolution instead of a half — a quarter of
106
- * the rays. The saving is **unmeasured**: the ablation measured SSR on and off, not SSR at two
107
- * scales.
99
+ * What a desktop gets: contact occlusion on top — the dark line where a foot meets the floor and a
100
+ * wall meets the ground, most of what separates "objects in a world" from "objects pasted on a
101
+ * background". Gathered at full resolution and denoised: at half, the upsample left a grain around
102
+ * every foot.
108
103
  */
109
- const medium: IWorldEnvironmentOptions = {
110
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
111
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
112
- // to be.
113
- bloomEnabled: true,
114
- bloomRadius: 0.5,
115
- bloomStrength: 0.5,
116
- bloomThreshold: 0.2,
117
- exposure: 1.15,
118
- // Screen-space reflections: ~4.1 ms.
119
- ssrEnabled: true,
120
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
121
- // are on and do nothing" — the ray dies a metre from where it started.
122
- ssrMaxDistance: 20,
123
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
124
- // the rays and is very hard to see in the result.
125
- ssrResolutionScale: 0.25,
126
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
127
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
128
- // that runs one of them.
129
- sharpenEnabled: true,
130
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
131
- sharpenStrength: 0.3,
132
- tonemapMode: "aces",
104
+ const high: IWorldEnvironmentOptions = {
105
+ ...shared,
106
+ // GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
107
+ gtaoEnabled: true,
108
+ gtaoRadius: 0.35,
133
109
  };
134
110
 
135
- /**
136
- * What a phone gets: this template's shipped mobile look, unchanged. Bloom and the tone curve,
137
- * nothing screen-space. The ablation's floor — every stage off — was 2.2 ms.
138
- */
139
- const low: IWorldEnvironmentOptions = {
140
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
141
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
142
- // to be.
143
- bloomEnabled: true,
144
- bloomRadius: 0.5,
145
- bloomStrength: 0.5,
146
- bloomThreshold: 0.2,
147
- exposure: 1.15,
148
- tonemapMode: "aces",
149
- };
111
+ /** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
112
+ const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8 };
113
+
114
+ /** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
115
+ const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
150
116
 
151
117
  const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
152
118
 
@@ -1,60 +1,41 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
- // The atmosphere object is mechanism; this file owns the mesh, material, and exposure.
3
- import { BackSide, Color, Mesh, type Scene, SphereGeometry } from "three";
4
- import { cameraPosition, normalize, positionWorld } from "three/tsl";
5
- import { MeshBasicNodeMaterial } from "three/webgpu";
6
- import type { Node } from "three/webgpu";
2
+ //
3
+ // The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
4
+ // by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
5
+ // The same image is the background, the environment light every surface reflects and is filled by,
6
+ // and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
7
+ // equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
8
+ import {
9
+ EquirectangularReflectionMapping,
10
+ FogExp2,
11
+ SRGBColorSpace,
12
+ type Scene,
13
+ type Texture,
14
+ Vector3,
15
+ } from "three";
7
16
  import { palette } from "./palette.js";
8
17
 
9
- type AtmosphereLike = {
10
- radiance(direction: unknown): unknown;
11
- };
18
+ /**
19
+ * How the JPEG was made from the 4k HDR: linear radiance × 0.4, clipped, sRGB-encoded — so white
20
+ * in the file is 2.5 in the sky. Multiplying back restores the HDR brightness of the clouds; the sun
21
+ * disk itself is clipped, which is why the sun is a light (`lighting.ts`) and not a texel.
22
+ */
23
+ const SKY_RANGE = 2.5;
12
24
 
13
- export function setupSky(scene: Scene, atmosphere?: AtmosphereLike): void {
14
- const top = new Color(palette.skyHigh);
15
- if (atmosphere === undefined) {
16
- scene.background = top;
17
- scene.fog = null;
18
- return;
19
- }
25
+ /** Unit vector toward the photographed sun: 47.9° up, measured from the source HDR. */
26
+ export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
20
27
 
21
- // Outside the deliberately kilometre-scale atmosphere probe in Play.ts, and **inside** the
22
- // camera's far plane. The view-space depth remains metres, so the package can apply its
23
- // supplied 1/km coefficients.
24
- //
25
- // The radius was 20 000 against `camera.far = 20_000`, which leaves the `BackSide` hemisphere
26
- // sitting exactly on the far plane. Pulled in to 16 000 it has room; measured, this was not
27
- // what was making the sky black — see the multiplier below — but a dome flush with the far
28
- // plane is one renderer tolerance away from being clipped, so it stays pulled in.
29
- const geometry = new SphereGeometry(16_000, 24, 12);
30
- const material = new MeshBasicNodeMaterial({
31
- fog: false,
32
- side: BackSide,
33
- toneMapped: false,
34
- });
35
- const viewDirection = normalize(positionWorld.sub(cameraPosition));
36
- // Exposure for the dome alone.
37
- //
38
- // 24 was authored when this template had no post chain, so the dome's radiance landed straight
39
- // in the frame; the chain now exposes the pass at 1.15 and tone-maps it with ACES. A previous
40
- // pass measured 203 of 255 at 24 and 25 at 1.5, and chose 1.5 because it matched "this
41
- // template's last good baseline" of 22. That baseline was the problem: **22 of 255 is not a
42
- // sky**, it is a black rectangle above the horizon, and it is what the smallest template showed
43
- // a new project on its first frame with a sun fifty degrees up and a correctly-scattering
44
- // atmosphere behind it.
45
- //
46
- // 8 lands the daytime sky around a hundred, which is a sky. Raising it further starts to blow
47
- // the horizon out under ACES. This multiplier scales the dome and nothing else — the
48
- // in-scattering `aerialPerspective` receives in postprocessing.ts comes from its own call and
49
- // is unaffected, so this cannot double-count the way the old note feared.
50
- material.colorNode = (atmosphere.radiance(viewDirection) as Node<"vec3">).mul(8);
51
- const dome = new Mesh(geometry, material);
52
- // The dome is authored at the origin and never moves; freeze only this known-static render
53
- // object, leaving gameplay transforms under user control.
54
- dome.updateMatrix();
55
- dome.matrixAutoUpdate = false;
56
- dome.frustumCulled = false;
57
- scene.background = null;
58
- scene.fog = null;
59
- scene.add(dome);
28
+ export function setupSky(scene: Scene, sky: Texture): void {
29
+ sky.mapping = EquirectangularReflectionMapping;
30
+ sky.colorSpace = SRGBColorSpace;
31
+ scene.background = sky;
32
+ scene.backgroundIntensity = SKY_RANGE;
33
+ // three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
34
+ // It is what makes a standard material read as a material: sky-blue fill on faces the sun
35
+ // misses, and a sky to reflect, sharper as roughness drops.
36
+ scene.environment = sky;
37
+ scene.environmentIntensity = SKY_RANGE;
38
+ // Almost nothing inside the arena (1.4% at 30 m), and the ground plane gone into the horizon by
39
+ // a kilometre — so the floor meets the sky instead of ending at a line.
40
+ scene.fog = new FogExp2(palette.horizon, 0.003);
60
41
  }
@@ -75,7 +75,7 @@ export class TouchControls {
75
75
 
76
76
  constructor(camera: PerspectiveCamera) {
77
77
  this.#camera = camera;
78
- this.#idleMaterial = overlayMaterial(palette.shadow, 0.34);
78
+ this.#idleMaterial = overlayMaterial(palette.gridLine, 0.34);
79
79
  this.#activeMaterial = overlayMaterial(palette.accent, 0.6);
80
80
  this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
81
81
  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,