create-threenative 0.2.10 → 0.2.13

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 (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +227 -34
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +15 -10
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +14 -9
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +15 -10
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +15 -10
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +15 -10
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +72 -1
  420. package/templates/racing/src/scenes/Race.ts +9 -7
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +14 -9
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +14 -9
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +15 -10
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +15 -10
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +15 -10
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +15 -10
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +15 -10
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +14 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +27 -14
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +15 -10
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -1,151 +1,80 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
3
  //
4
- // The look, in one place: the grid the ground is measured against and the two node materials that
5
- // tint it. `terrain.ts` builds the ground; everything that decides what the ground *is* lives here,
4
+ // The look, in one place: the node materials that draw the painted ground and the water. `terrain.ts` builds the ground; everything that decides what the ground *is* lives here,
6
5
  // so a rebalance is one file rather than a hunt through the scene.
7
- import {
8
- type BufferGeometry,
9
- CircleGeometry,
10
- DataTexture,
11
- Float32BufferAttribute,
12
- LinearFilter,
13
- LinearMipmapLinearFilter,
14
- RepeatWrapping,
15
- SRGBColorSpace,
16
- Vector3,
17
- } from "three";
6
+ import { type BufferGeometry, CircleGeometry, type DataTexture } from "three";
18
7
  import {
19
8
  color,
20
9
  float,
21
10
  length,
11
+ max,
22
12
  mix,
23
- normalWorld,
24
13
  oneMinus,
25
14
  positionWorld,
15
+ pow,
16
+ sin,
26
17
  smoothstep,
27
18
  texture,
19
+ time,
28
20
  uv,
21
+ vec3,
29
22
  } from "three/tsl";
30
- import { MeshStandardNodeMaterial } from "three/webgpu";
23
+ import { MeshBasicNodeMaterial, MeshStandardNodeMaterial } from "three/webgpu";
31
24
  import { HALF, WORLD } from "../sim/terrain.js";
32
- import { palette } from "./palette.js";
33
-
34
- /**
35
- * How many metres one grid tile covers.
36
- *
37
- * Sixteen, not four, and the number is measured at the rig's own zoom rather than picked. The tile
38
- * holds four major lines and sixteen minor ones, so this is a 4 m grid with a 1 m line inside each
39
- * square: at a 30 m tactical zoom a major line lands every 48 px and the minor one every 12 px,
40
- * where the 1 m major grid this file started with put a crosshatch every 12 px on *both* axes and
41
- * the whole battlefield read as wireframe mesh rather than as ground. A metre is still a metre —
42
- * the minor line is what keeps the grid honest — but the ground now reads as ground.
43
- */
44
- const TILE = 16;
45
- const MAJOR_EVERY = 4;
46
- const MINOR_EVERY = 16;
47
-
48
- /**
49
- * One tile of grid: a heavy line every four metres, a faint one every metre, and nothing else.
50
- * White where there is no line, so the terrain material can tint the same tile light ground and
51
- * dark cliff — the grid is the look, the tint is the terrain's. The minor line darkens its tile by
52
- * less than a quarter, which is what "faint" has to mean when a metre is a dozen pixels wide.
53
- */
54
- function gridTexture(size = 256): DataTexture {
55
- const LINE = 64; // The line darkens its tile to a quarter: a grid, not a stain.
56
- const heavy = Math.round((size / MAJOR_EVERY) * 0.045);
57
- const light = Math.max(2, Math.round(heavy / 3));
58
- const data = new Uint8Array(size * size * 4);
59
- for (let y = 0; y < size; y += 1) {
60
- for (let x = 0; x < size; x += 1) {
61
- const major = x % (size / MAJOR_EVERY) < heavy || y % (size / MAJOR_EVERY) < heavy;
62
- const minor = x % MINOR_EVERY < light || y % MINOR_EVERY < light;
63
- const weight = major ? 0.95 : minor ? 0.22 : 0;
64
- const value = Math.round(255 * (1 - weight) + LINE * weight);
65
- const index = (y * size + x) * 4;
66
- data[index] = value;
67
- data[index + 1] = value;
68
- data[index + 2] = value;
69
- data[index + 3] = 255;
70
- }
71
- }
72
- const grid = new DataTexture(data, size, size);
73
- grid.colorSpace = SRGBColorSpace;
74
- grid.wrapS = RepeatWrapping;
75
- grid.wrapT = RepeatWrapping;
76
- grid.generateMipmaps = true;
77
- grid.minFilter = LinearMipmapLinearFilter;
78
- grid.needsUpdate = true;
79
- return grid;
80
- }
25
+ import { paintGround } from "./ground.js";
26
+ import { channels, palette } from "./palette.js";
81
27
 
82
28
  /**
83
- * Rewrites a geometry's UVs as world metres, projected along each face's dominant axis, so a tile
84
- * covers the same ground on a slope as on the flat. Call it after the geometry has been displaced
85
- * and its normals recomputed.
29
+ * AstraCraft's fog of war is rgba(5, 14, 22) over the ground, read as linear light like its canvas.
30
+ * This blend reaches it by another road (lit in the material, tone-mapped after), so the sheet is
31
+ * set where the frames meet: 2, 10, 22 read the reference's slate blue in unseen ground, headed in
32
+ * Brave beside it (PRD-765); 5, 14, 22 read olive grey once the vignette that darkened it was gone.
86
33
  */
87
- export function worldMetreUVs<T extends BufferGeometry>(geometry: T): T {
88
- const position = geometry.getAttribute("position");
89
- const normal = geometry.getAttribute("normal");
90
- const metres = new Float32Array(position.count * 2);
91
- const face = new Vector3();
92
- for (let index = 0; index < position.count; index += 1) {
93
- face.fromBufferAttribute(normal, index);
94
- const x = position.getX(index);
95
- const y = position.getY(index);
96
- const z = position.getZ(index);
97
- const ax = Math.abs(face.x);
98
- const ay = Math.abs(face.y);
99
- const az = Math.abs(face.z);
100
- const [u, v] = ay >= ax && ay >= az ? [x, z] : ax >= az ? [z, y] : [x, y];
101
- metres[index * 2] = u;
102
- metres[index * 2 + 1] = v;
103
- }
104
- geometry.setAttribute("uv", new Float32BufferAttribute(metres, 2));
105
- return geometry;
106
- }
34
+ const FOG_OF_WAR = vec3(...channels(palette.fogOfWar));
35
+ /** WebGL blends after the sRGB encode, so AstraCraft's sheet mixes in display space: about gamma 2.2. */
36
+ const GAMMA = 2.2;
37
+ /** What open ground's albedo is multiplied by under the sun, sky and fill of `lighting.ts`. */
38
+ const OPEN_GROUND_LIGHT = 2;
107
39
 
108
40
  /**
109
- * The ground: minimal's metre grid, tilted to the terrain, with the fog of war sampled in the same
41
+ * The ground: the painted battlefield from `ground.ts`, with the fog of war sampled in the same
110
42
  * material rather than painted over it.
111
43
  *
112
- * An overlay plane is one more full-map draw, and it cannot be depth-tested against the very slope
113
- * it is drawn on without z-fighting it. One material, one texture, one draw — and the fog is lit
114
- * with the ground, so a shadow crossing unexplored ground darkens both together.
44
+ * AstraCraft lays an unlit dark-blue sheet over the lit ground, blended on screen in gamma space; a
45
+ * linear blend kept unseen ground yellow and light. The material scales the albedo by the share
46
+ * that shows through, raised to the gamma, and adds the rest of that blend as emissive, worked out
47
+ * on the open ground's lit colour. One draw, no overlay plane to z-fight the slope it covers.
48
+ * The fog texture holds how much of the ground shows through: 1 in sight, 0.76 remembered, 0.41 never seen.
115
49
  */
116
50
  export function createTerrainMaterial(fog: DataTexture): MeshStandardNodeMaterial {
117
- const grid = gridTexture();
118
- // `worldMetreUVs` writes metres; the tile is `TILE` of them.
119
- const tile = uv().div(TILE);
120
- // A slope is a cliff: the same grid, a long way darker, decided by the surface normal rather
121
- // than by a second painted texture, so it follows any height the simulation grows.
122
- const stone = mix(
123
- color(palette.cliff),
124
- color(palette.ground),
125
- smoothstep(0.55, 0.92, normalWorld.y),
126
- ).mul(texture(grid, tile).rgb);
127
- const material = new MeshStandardNodeMaterial({ metalness: 0, roughness: 0.9 });
128
- material.colorNode = mix(
129
- color(palette.unseen).mul(2.2),
130
- stone,
131
- texture(fog, positionWorld.xz.add(HALF).div(WORLD)).r,
132
- );
51
+ const mapUv = positionWorld.xz.add(HALF).div(WORLD);
52
+ const material = new MeshStandardNodeMaterial({ metalness: 0.025, roughness: 0.94 });
53
+ const albedo = texture(paintGround(), mapUv).rgb;
54
+ const through = texture(fog, mapUv).r;
55
+ const kept = pow(through, float(GAMMA));
56
+ const lit = albedo.mul(OPEN_GROUND_LIGHT);
57
+ const sheet = pow(FOG_OF_WAR, vec3(1 / GAMMA));
58
+ const blended = pow(mix(sheet, pow(lit, vec3(1 / GAMMA)), through), vec3(GAMMA));
59
+ material.colorNode = albedo.mul(kept);
60
+ material.emissiveNode = max(blended.sub(lit.mul(kept)), vec3(0));
133
61
  return material;
134
62
  }
135
63
 
136
- /** The pools the simulation refuses to path across, faded at their own rim so they meet a bank. */
137
- export function createWaterMaterial(): MeshStandardNodeMaterial {
138
- const water = new MeshStandardNodeMaterial({
139
- depthWrite: false,
140
- metalness: 0.1,
141
- roughness: 0.14,
142
- transparent: true,
143
- });
144
- water.colorNode = color(0x2b5f5c);
145
- water.opacityNode = float(0.88).mul(oneMinus(smoothstep(0.43, 0.5, length(uv().sub(0.5)))));
64
+ /** The pools the simulation refuses to path across: two greens that ripple, faded at the rim. */
65
+ export function createWaterMaterial(): MeshBasicNodeMaterial {
66
+ const water = new MeshBasicNodeMaterial({ depthWrite: false, transparent: true });
67
+ const p = positionWorld.xz;
68
+ const wave = sin(p.x.mul(2.4).add(p.y.mul(0.7)).add(time)).mul(
69
+ sin(p.y.mul(2.2).sub(p.x.mul(0.3)).sub(time.mul(0.7))),
70
+ );
71
+ const ripple = pow(max(wave, 0), 10);
72
+ water.colorNode = mix(color(0x183e3c), color(0x2b5e57), wave.mul(0.5).add(0.5)).add(
73
+ color(0x363d2e).mul(ripple.mul(0.4)),
74
+ );
75
+ water.opacityNode = float(0.87).mul(oneMinus(smoothstep(0.43, 0.5, length(uv().sub(0.5)))));
146
76
  return water;
147
77
  }
148
-
149
78
  /** The unit disc the water instances: a circle, already flat, already facing up. */
150
79
  export function waterDisc(): BufferGeometry {
151
80
  return new CircleGeometry(1, 48).rotateX(-Math.PI / 2);
@@ -1,17 +1,34 @@
1
1
  // Generated for you. Keep these roles coherent when you change the look.
2
- // A lit grid over rock: one light ground, one dark ground for the slopes a tank cannot climb, and
3
- // the three faction colours the simulation already owns (`STARTS` in src/sim/terrain.ts).
2
+ import { Color, LinearSRGBColorSpace } from "three";
3
+ // The AstraCraft battlefield: the painted ground lives in `ground.ts`; these are the few colours
4
+ // other files share, plus the three faction colours the simulation owns (`STARTS` in src/sim/terrain.ts).
4
5
  export const palette = {
5
- /** Buildable ground: the light grid. */
6
- ground: 0x6f6a55,
7
- /** Cliffs, ramps and the map edge: the same grid, far darker. */
8
- cliff: 0x35322b,
9
- /** The grid line both grounds share, and every route ring's outline. */
10
- gridLine: 0x24231f,
11
- /** Ground nobody has ever seen. */
12
- unseen: 0x0b1a20,
13
- /** The sky photograph's own horizon, measured from its HDR: distance fades into this. */
14
- horizon: 0xacb1c1,
15
- /** The one saturated colour: what the player can touch. */
6
+ /** The skirt under the map edge: the plain a wide zoom sees past the mesas. */
7
+ cliff: 0x353f38,
8
+ /** Ground nobody has ever seen, and the dark backing behind rings and bars. */
9
+ unseen: 0x060f16,
10
+ /** Distance haze: the fog colour the far battlefield fades into. */
11
+ horizon: 0x31464a,
12
+ /** The order marker ring: the one saturated colour, what the player just touched. */
16
13
  accent: 0xffffff,
14
+ /** The fog-of-war sheet `materials.ts` blends over that unseen ground, read as linear light. */
15
+ fogOfWar: 0x020a16,
17
16
  } as const;
17
+
18
+ /**
19
+ * An AstraCraft colour as AstraCraft drew it. It ran three r140, whose legacy colour handling used a
20
+ * hex value as linear light; three today decodes hex as sRGB, which turns the same number warmer,
21
+ * darker and more saturated (the sun's 0xffe7c4 became orange). Lights, fog and flat materials taken
22
+ * from the reference go through this; painted textures stay sRGB, as they were there.
23
+ */
24
+ export function legacyColor(hex: number): Color {
25
+ return new Color().setHex(hex, LinearSRGBColorSpace);
26
+ }
27
+
28
+ /**
29
+ * A hex colour's three channels as 0–1 numbers, undecoded: a shader node takes numbers rather than a
30
+ * `Color`, and the fog-of-war sheet is linear light the way AstraCraft's canvas wrote it.
31
+ */
32
+ export function channels(hex: number): [number, number, number] {
33
+ return [((hex >> 16) & 0xff) / 255, ((hex >> 8) & 0xff) / 255, (hex & 0xff) / 255];
34
+ }
@@ -15,6 +15,24 @@ export interface IPoint2 {
15
15
  readonly y: number;
16
16
  }
17
17
 
18
+ /** A drag shorter than this is a click, not a box. */
19
+ export const DRAG_SLOP = 4;
20
+
21
+ /**
22
+ * The rubber band, in client pixels: `[left, top, width, height]` from a press and its pointer.
23
+ *
24
+ * Dragging in any direction gives the same rectangle — the top-left corner is the smaller of the
25
+ * two coordinates and the size is the gap — and a press that has not travelled past `DRAG_SLOP` is
26
+ * `null` rather than a two-pixel band: under it the gesture is a click, and a band that flashes on
27
+ * every press is a selection the player did not make.
28
+ */
29
+ export function dragBoxRect(from: IPoint2, to: IPoint2): [number, number, number, number] | null {
30
+ const width = Math.abs(to.x - from.x);
31
+ const height = Math.abs(to.y - from.y);
32
+ if (Math.hypot(width, height) <= DRAG_SLOP) return null;
33
+ return [Math.min(from.x, to.x), Math.min(from.y, to.y), width, height];
34
+ }
35
+
18
36
  /** What a click landed on: a unit or a building, or nothing. */
19
37
  export type PickTarget = IEntity | undefined;
20
38
 
@@ -1,8 +1,10 @@
1
+ import type { OutputRenderer } from "@threenative/core";
2
+ import { WorldEnvironment } from "@threenative/core";
1
3
  // Generated for you: ordinary Three.js; ThreeNative does not read this file.
2
4
  //
3
5
  // This file wires two things together and decides nothing itself. `quality.ts`, in this folder,
4
- // owns which stages run at which tier and records what each one measured. `WorldEnvironment`,
5
- // also in this folder, builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
6
+ // owns which stages run at which tier and records what each one measured. `WorldEnvironment` from
7
+ // the core package builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
6
8
  // applied or refused **with a reason**, so a stage that silently no-op'd is never mistaken for
7
9
  // one you turned off.
8
10
  //
@@ -12,8 +14,6 @@
12
14
  // `TN_QUALITY_TIER` names the tier that ran either way.
13
15
  import type { Camera, DirectionalLight, Scene } from "three";
14
16
  import { type QualityTier, qualityPreset, resolveQualityTier } from "./quality.js";
15
- import type { OutputRenderer } from "./worldEnvironment.js";
16
- import { WorldEnvironment } from "./worldEnvironment.js";
17
17
 
18
18
  export function setupPost(
19
19
  renderer: OutputRenderer,
@@ -24,7 +24,14 @@
24
24
  // frame. With the gather on, `playtests/play.playtest.json` measured **34.2 ms p95 against the
25
25
  // 33 ms ceiling**; without it the same scenario passes. Turn it on when you replace the
26
26
  // atmosphere with a flat sky, and read the p95 back out of `TN_FRAME_BUDGET`.
27
- import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
27
+ import {
28
+ type IWorldEnvironmentOptions,
29
+ qualityPreset as coreQualityPreset,
30
+ qualityTiers,
31
+ } from "@threenative/core";
32
+ import { exposureSettings } from "./exposure.js";
33
+ export type { QualityTier } from "@threenative/core";
34
+ import type { QualityTier } from "@threenative/core";
28
35
 
29
36
  /**
30
37
  * The three names this game's look comes in.
@@ -34,91 +41,50 @@ import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
34
41
  * laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
35
42
  * what any of them mean.
36
43
  */
37
- export type QualityTier = "low" | "medium" | "high";
44
+ export const resolveQualityTier = qualityTiers.resolve;
38
45
 
39
- const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
40
-
41
- /**
42
- * Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
43
- * `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
44
- */
45
- function isQualityTier(value: string): value is QualityTier {
46
- return (QUALITY_TIERS as readonly string[]).includes(value);
47
- }
48
-
49
- /**
50
- * Where each GPU family starts, from `ctx.renderer.gpuClass`.
51
- *
52
- * A start, not a ceiling: the measured frame-budget windows move the look from here, and an
53
- * explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
54
- * family rule matched — falls back to the `mobile` flag, exactly as before families existed.
55
- * Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
56
- */
57
- const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
58
- software: "low",
59
- "mobile-low": "low",
60
- "mobile-mid": "low",
61
- "mobile-high": "medium",
62
- integrated: "medium",
63
- discrete: "high",
46
+ const legacyDefaults: IWorldEnvironmentOptions = {
47
+ // PRD-723: retain authored costs under the approved core filmic curve and meter.
48
+ // Bloom cost: unmeasured; retain the authored stage and quality choices.
49
+ bloomEnabled: true,
50
+ bloomRadius: 0.5,
51
+ bloomStrength: 0.7,
52
+ bloomThreshold: 0.2,
53
+ exposure: 1,
54
+ finalGatherMethod: "none",
55
+ gtaoEnabled: false,
56
+ gtaoRadius: 0.25,
57
+ gtaoSamples: 16,
58
+ gtaoDistanceExponent: 1,
59
+ gtaoDistanceFalloff: 1,
60
+ gtaoIndirectOnly: false,
61
+ localExposureEnabled: false,
62
+ motionBlurEnabled: false,
63
+ ssgiEnabled: false,
64
+ ssgiRadius: 12,
65
+ ssgiResolutionScale: 0.5,
66
+ ssrEnabled: false,
67
+ ssrResolutionScale: 0.5,
68
+ temporalAA: false,
69
+ unrealBloomEnabled: false,
70
+ vignetteAmount: 0,
64
71
  };
65
72
 
66
- /**
67
- * Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
68
- *
69
- * Fails closed. An unrecognised tier name throws with the value it was handed rather than
70
- * quietly rendering the default, because a silent fallback here looks exactly like a tier that
71
- * turned out to have no effect.
72
- */
73
- export function resolveQualityTier(
74
- request: {
75
- readonly gpuClass?: string;
76
- readonly mobile?: boolean;
77
- readonly software?: boolean;
78
- readonly tier?: string;
79
- } = {},
80
- ): QualityTier {
81
- const requested = request.tier;
82
- if (requested !== undefined) {
83
- if (!isQualityTier(requested)) {
84
- throw new Error(
85
- `Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
86
- );
87
- }
88
- return requested;
89
- }
90
- // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
91
- // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
92
- // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
93
- // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
94
- // `tier` above still wins over it.
95
- if (request.software === true) return "low";
96
- const family =
97
- request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
98
- if (family !== undefined) return family;
99
- return request.mobile === true ? "low" : "high";
100
- }
101
-
102
- /**
103
- * The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the sun
104
- * disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey walls and
105
- * flattens contrast), and a corner falloff. Antialiasing is on in every tier that installs a chain;
106
- * see `screenSpaceAA` in `worldEnvironment.ts`.
107
- *
108
- * No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
109
- * captured sky (`sky.ts`), and SSR on rough floors traced speckle into the grid; RCAS then rang the
110
- * smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
111
- */
112
73
  const shared: IWorldEnvironmentOptions = {
113
- // Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
114
- bloomEnabled: true,
115
- bloomRadius: 0.6,
116
- bloomStrength: 0.22,
117
- bloomThreshold: 1,
118
- autoExposureEnabled: false,
119
- exposure: 0.62,
74
+ // Override: AstraCraft draws no bloom; a bloom with no threshold lifted the sand 0.1 lighter
75
+ // than the reference (PRD-765, measured against its frame).
76
+ bloomEnabled: false,
77
+ // Override: the AstraCraft reference look (owner, 2026-10-28, PRD-765) is ACES at a fixed
78
+ // 1.02 exposure under a hemisphere, a warm key and a cool fill; a metered exposure brightened
79
+ // the concrete aprons to white.
120
80
  tonemapMode: "aces",
121
- vignetteAmount: 0.22,
81
+ autoExposureEnabled: false,
82
+ exposure: 1.02,
83
+ // The Unreal bloom is the one `bloomEnabled` runs. Cost: unmeasured.
84
+ unrealBloomEnabled: true,
85
+ // AstraCraft draws no vignette: one darkened the fog at the frame's edges to an olive grey where
86
+ // the reference reads slate blue (PRD-765, headed Brave beside it).
87
+ vignetteAmount: 0,
122
88
  };
123
89
 
124
90
  /**
@@ -132,12 +98,19 @@ const high: IWorldEnvironmentOptions = {
132
98
  // GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
133
99
  gtaoEnabled: true,
134
100
  gtaoRadius: 0.35,
101
+ // Override: AstraCraft has no local exposure; it lifted the shaded sand off the reference.
102
+ localExposureEnabled: false,
135
103
  };
136
104
 
137
105
  /** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
138
- const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8, renderChainTier: "medium" };
106
+ const medium: IWorldEnvironmentOptions = {
107
+ ...high,
108
+ gtaoSamples: 8,
109
+ motionBlurEnabled: false,
110
+ renderChainTier: "medium",
111
+ };
139
112
 
140
- /** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
113
+ /** What a phone gets: bloom, vignette and the tone curve. Unreal's mobile profile has no local exposure. */
141
114
  const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
142
115
 
143
116
  const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
@@ -147,10 +120,16 @@ export function qualityPreset(tier: string): IWorldEnvironmentOptions {
147
120
  const preset = QUALITY_PRESETS[tier as QualityTier];
148
121
  if (preset === undefined) {
149
122
  throw new Error(
150
- `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
123
+ `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${["low", "medium", "high"].join(", ")}.`,
151
124
  );
152
125
  }
153
- return preset;
126
+ return {
127
+ ...coreQualityPreset(tier),
128
+ ...legacyDefaults,
129
+ ...preset,
130
+ exposurePolicy: exposureSettings,
131
+ samples: preset.samples ?? 4,
132
+ };
154
133
  }
155
134
 
156
135
  /** First admitted material lane: high desktop hardware WebGPU in the browser only. */
@@ -5,7 +5,6 @@
5
5
  // ore field visibly shortens as the Surveyors empty it, so the economy is legible from the field
6
6
  // alone without opening a panel.
7
7
  import {
8
- Color,
9
8
  ConeGeometry,
10
9
  CylinderGeometry,
11
10
  IcosahedronGeometry,
@@ -20,8 +19,6 @@ import { HALF, RESOURCE_SITES, terrainHeight } from "../sim/terrain.js";
20
19
  * deposit rather than as seven unrelated props. */
21
20
  const CRYSTALS = 7;
22
21
  const ROCKS = 5;
23
- const CRYSTAL_TINT = new Color(0x8ae5f1);
24
- const CRYSTAL_BASE = new Color(0xffffff);
25
22
  const CRYSTAL_HEIGHT = [1.05, 1.6, 2.15, 2.7, 3.25] as const;
26
23
 
27
24
  const _dummy = new Object3D();
@@ -35,16 +32,17 @@ export interface IResources {
35
32
  export function createResources(): IResources {
36
33
  const root = new Object3D();
37
34
  const sites = RESOURCE_SITES.length;
38
- const crystals = new InstancedMesh(
39
- new ConeGeometry(0.55, 1, 5),
40
- new MeshStandardMaterial({
41
- color: 0x38a5c5,
42
- emissive: 0x065572,
43
- metalness: 0.5,
44
- roughness: 0.2,
45
- }),
46
- sites * CRYSTALS * 7,
47
- );
35
+ // AstraCraft's unit cone, scaled 0.46-0.74 wide, in its two crystal materials: one crystal in
36
+ // three is the pale, less metallic one that catches the sun (PRD-765 judge round 2).
37
+ const cone = new ConeGeometry(1, 1, 5);
38
+ const crystal = (color: number, emissive: number, metalness: number, roughness: number) =>
39
+ new InstancedMesh(
40
+ cone,
41
+ new MeshStandardMaterial({ color, emissive, emissiveIntensity: 1.5, metalness, roughness }),
42
+ sites * CRYSTALS,
43
+ );
44
+ const crystals = crystal(0x38a5c5, 0x065572, 0.5, 0.2);
45
+ const pale = crystal(0x8ae5f1, 0x166984, 0.25, 0.21);
48
46
  const vents = new InstancedMesh(
49
47
  new CylinderGeometry(2.5, 2.7, 0.35, 6),
50
48
  new MeshStandardMaterial({ color: 0x314b39, roughness: 0.9 }),
@@ -56,7 +54,7 @@ export function createResources(): IResources {
56
54
  sites * ROCKS,
57
55
  );
58
56
  // Listed once: the sync below walks this every frame, and a literal here is an array a frame.
59
- const meshes = [crystals, vents, rubble];
57
+ const meshes = [crystals, pale, vents, rubble];
60
58
  for (const mesh of meshes) {
61
59
  mesh.castShadow = true;
62
60
  mesh.receiveShadow = true;
@@ -67,7 +65,8 @@ export function createResources(): IResources {
67
65
  return {
68
66
  root,
69
67
  sync: (game) => {
70
- let crystal = 0;
68
+ let dark = 0;
69
+ let light = 0;
71
70
  let vent = 0;
72
71
  let rock = 0;
73
72
  for (const node of game.nodes) {
@@ -78,7 +77,8 @@ export function createResources(): IResources {
78
77
  const left = 0.4 + 0.6 * Math.min(1, node.amount / 2100);
79
78
  for (let index = 0; index < CRYSTALS; index += 1) {
80
79
  const angle = 0.15 + (index / CRYSTALS) * Math.PI * 1.8;
81
- const spread = (node.r * 0.78 * (1 + (index % 3))) / 3;
80
+ // Within 1.25 m of the node, as AstraCraft packs them: one deposit, not a ring of spikes.
81
+ const spread = (1.25 * (1 + (index % 3))) / 3;
82
82
  const height = (CRYSTAL_HEIGHT[index % CRYSTAL_HEIGHT.length] ?? 1) * left;
83
83
  _dummy.position.set(
84
84
  node.x + Math.cos(angle) * spread,
@@ -88,9 +88,8 @@ export function createResources(): IResources {
88
88
  _dummy.rotation.set(((index % 5) - 2) * 0.08, angle, ((index % 3) - 1) * 0.16);
89
89
  _dummy.scale.set(0.46 + (index % 3) * 0.14, height, 0.5 + (index % 2) * 0.2);
90
90
  _dummy.updateMatrix();
91
- crystals.setMatrixAt(crystal, _dummy.matrix);
92
- crystals.setColorAt(crystal, index % 3 === 0 ? CRYSTAL_TINT : CRYSTAL_BASE);
93
- crystal += 1;
91
+ if (index % 3 === 0) pale.setMatrixAt(light++, _dummy.matrix);
92
+ else crystals.setMatrixAt(dark++, _dummy.matrix);
94
93
  }
95
94
  } else {
96
95
  _dummy.position.set(node.x, ground + 0.18, node.z);
@@ -114,13 +113,13 @@ export function createResources(): IResources {
114
113
  }
115
114
  }
116
115
  }
117
- crystals.count = crystal;
116
+ crystals.count = dark;
117
+ pale.count = light;
118
118
  vents.count = vent;
119
119
  rubble.count = rock;
120
120
  for (const mesh of meshes) {
121
+ // No bound: every batch is `frustumCulled = false`, so nothing reads one.
121
122
  mesh.instanceMatrix.needsUpdate = true;
122
- if (mesh.instanceColor !== null) mesh.instanceColor.needsUpdate = true;
123
- if (mesh.count > 0) mesh.computeBoundingSphere();
124
123
  }
125
124
  },
126
125
  dispose: () => {
@@ -2,8 +2,8 @@
2
2
  //
3
3
  // The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
4
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
5
+ // The same image is the background and — through `SUN_DIRECTION` — the direction the sun's shadows
6
+ // fall. It is not the environment light: AstraCraft lights with a hemisphere (`lighting.ts`). Swap the file for any
7
7
  // equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
8
8
  import {
9
9
  EquirectangularReflectionMapping,
@@ -14,7 +14,7 @@ import {
14
14
  Vector3,
15
15
  } from "three";
16
16
  import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
17
- import { palette } from "./palette.js";
17
+ import { legacyColor, palette } from "./palette.js";
18
18
 
19
19
  /**
20
20
  * How the JPEG was made from the 4k HDR: linear radiance × 0.4, clipped, sRGB-encoded — so white
@@ -23,11 +23,11 @@ import { palette } from "./palette.js";
23
23
  */
24
24
  const SKY_RANGE = 2.5;
25
25
 
26
- /** Unit vector toward the photographed sun: 47.9° up, measured from the source HDR. */
27
- export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
26
+ /** Unit vector toward the sun: high and from the north-west, so mesas throw their shadow toward the camera's right. */
27
+ export const SUN_DIRECTION = new Vector3(-35, 70, -20).normalize();
28
28
 
29
29
  /** The look this fog replaced: FogExp2 at 0.0035, measured at 150 m from 20 m up. */
30
- const EYE_LEVEL = { density: 0.0035, distance: 150, cameraHeight: 20 };
30
+ const EYE_LEVEL = { density: 0.0021, distance: 150, cameraHeight: 20 };
31
31
 
32
32
  /**
33
33
  * The distance term's density that, with the height term, keeps the old eye-level haze: at
@@ -47,18 +47,15 @@ export function setupSky(scene: Scene, sky: Texture): void {
47
47
  sky.colorSpace = SRGBColorSpace;
48
48
  scene.background = sky;
49
49
  scene.backgroundIntensity = SKY_RANGE;
50
- // three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
51
- // It is what makes a standard material read as a material: sky-blue fill on faces the sun
52
- // misses, and a sky to reflect, sharper as roughness drops.
53
- scene.environment = sky;
54
- scene.environmentIntensity = SKY_RANGE;
50
+ // No `scene.environment`: AstraCraft has none, and the photograph's fill lifted the ground 0.03
51
+ // to 0.06 lighter and warmer than the reference frame (PRD-765). Set it back to light with the sky.
55
52
  // Tuned for a 224 m battlefield rather than a 36 m arena, and then tuned again: the first
56
53
  // value meant to hide the map's far edge (0.0075) hazed the fog of war away with it, because a
57
54
  // cell the player has never seen is 60 m away and a distant cell is 150. At 0.0035 the far corner
58
55
  // is a quarter hazed and an unexplored cell next to the camera is 4% — the haze stays a horizon
59
56
  // instead of becoming the map.
60
57
  // `scene.fog` stays the distance term; `scene.fogNode` is what three applies and adds the height term.
61
- const distanceFog = new FogExp2(palette.horizon, distanceDensity());
58
+ const distanceFog = new FogExp2(legacyColor(palette.horizon), distanceDensity());
62
59
  scene.fog = distanceFog;
63
60
  scene.fogNode = heightFogNode(distanceFog, HEIGHT_FOG, SUN_DIRECTION);
64
61
  }