create-threenative 0.2.10 → 0.2.12

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
@@ -9,15 +9,18 @@
9
9
  //
10
10
  // Conventions: one world unit is one metre, +x is out to sea, -z runs down the coast.
11
11
  import {
12
+ type Camera,
12
13
  DoubleSide,
13
14
  Mesh,
15
+ OrthographicCamera,
14
16
  type PerspectiveCamera,
15
17
  PlaneGeometry,
16
- type Scene,
18
+ Scene,
17
19
  Vector3,
18
20
  } from "three";
19
21
  import { cameraFar, cameraNear, clamp, float, positionGeometry, uv, vec4 } from "three/tsl";
20
- import { MeshBasicNodeMaterial } from "three/webgpu";
22
+ import type { Node } from "three/webgpu";
23
+ import { MeshBasicNodeMaterial, PassNode } from "three/webgpu";
21
24
  import type { QualityName, Weather } from "../state.js";
22
25
  import { type ICloudPass, createCloudPass } from "./clouds.js";
23
26
  import { setupLighting } from "./lighting.js";
@@ -25,12 +28,19 @@ import { setupMaterials } from "./materials.js";
25
28
  import { studyTier } from "./quality.js";
26
29
  import { setupSky } from "./sky.js";
27
30
  import {
31
+ baseTable,
32
+ heightTable,
33
+ setBase,
34
+ setHeight,
28
35
  tempestWorld,
29
36
  uAspect,
37
+ uBaseGrid,
30
38
  uCam,
31
39
  uFlash,
32
40
  uFog,
33
41
  uForward,
42
+ uHeightGrid,
43
+ uHeightMargin,
34
44
  uRain,
35
45
  uReflect,
36
46
  uRight,
@@ -41,6 +51,54 @@ import {
41
51
  uWet,
42
52
  } from "./world-shader.js";
43
53
 
54
+ // terrain() is the march's costliest call and it never changes, so it is cached every frame in two
55
+ // small passes the coast samples instead (see `hillHeight` and `cellBase` in tempest-world.frag).
56
+ // The grids follow the camera and reach as far as the march does (1850 m).
57
+ /** Texels per side of the cached heightmap, and the metres it spans: 3.6 m between samples. */
58
+ const HEIGHT_TEXELS = 1024;
59
+ const HEIGHT_SPAN = 3700;
60
+ /**
61
+ * Metres added to a cached height so it bounds terrain() from above. Between its texels the cache
62
+ * reads at most 2.61 m below the true height (18,000,000 random points at 3.6 m, half-float storage,
63
+ * the road cut and the coast step included), so 4 m keeps every hit on the exact surface.
64
+ */
65
+ const HEIGHT_MARGIN = 4;
66
+ /** Tree cells per side of the base table: 360 cells of 10.5 m, 1890 m each way. */
67
+ const BASE_CELLS = 360;
68
+ /** The tree grid of `treeCell` in tempest-world.frag: 10.5 m cells offset by (2, 1) m. */
69
+ const CELL_SIZE = 10.5;
70
+
71
+ /** A pass whose target keeps one size, whatever the drawing buffer is: a table, not a picture. */
72
+ class TablePass extends PassNode {
73
+ side = 1;
74
+ override setSize(): void {
75
+ super.setSize(this.side ?? 1, this.side ?? 1);
76
+ }
77
+ }
78
+
79
+ function tablePass(fragment: Node, side: number): { pass: TablePass; dispose(): void } {
80
+ const scene = new Scene();
81
+ const camera: Camera = new OrthographicCamera(-1, 1, 1, -1, 0, 1);
82
+ const geometry = new PlaneGeometry(2, 2);
83
+ const material = new MeshBasicNodeMaterial();
84
+ material.side = DoubleSide;
85
+ material.vertexNode = vec4(positionGeometry.xy, 0, 1);
86
+ material.fragmentNode = fragment;
87
+ const quad = new Mesh(geometry, material);
88
+ quad.frustumCulled = false;
89
+ scene.add(quad);
90
+ const pass = new TablePass(PassNode.COLOR, scene, camera, { depthBuffer: false, samples: 0 });
91
+ pass.side = side;
92
+ return {
93
+ pass,
94
+ dispose(): void {
95
+ pass.dispose();
96
+ geometry.dispose();
97
+ material.dispose();
98
+ },
99
+ };
100
+ }
101
+
44
102
  export interface IWeatherWorldOptions {
45
103
  /** Absolute seconds, so the weather phase does not depend on how the frame was scheduled. */
46
104
  readonly elapsed: number;
@@ -75,6 +133,13 @@ export function createWeatherWorld(scene: Scene, camera: PerspectiveCamera): IWe
75
133
  setupLighting();
76
134
  setupMaterials();
77
135
 
136
+ // Bound before the coast's graph is built, the same order as the cloud pass and for the same reason.
137
+ const heights = tablePass(heightTable(uv()), HEIGHT_TEXELS);
138
+ setHeight(heights.pass.getTextureNode());
139
+ const bases = tablePass(baseTable(uv()), BASE_CELLS);
140
+ setBase(bases.pass.getTextureNode());
141
+ uHeightMargin.value = HEIGHT_MARGIN;
142
+
78
143
  const world = tempestWorld(uv());
79
144
  // The shader's own depth is a curve fitted to the source's camera; the closed form is reversible,
80
145
  // so the engine's near/far decide the real clip depth and anything drawn after this quad — rain,
@@ -116,6 +181,8 @@ export function createWeatherWorld(scene: Scene, camera: PerspectiveCamera): IWe
116
181
  geometry.dispose();
117
182
  material.dispose();
118
183
  clouds.dispose();
184
+ heights.dispose();
185
+ bases.dispose();
119
186
  },
120
187
  update({ elapsed, flash, quality, strike, weather }): void {
121
188
  // The camera basis the shader raymarches from: the same three axes the renderer draws with,
@@ -130,6 +197,19 @@ export function createWeatherWorld(scene: Scene, camera: PerspectiveCamera): IWe
130
197
  uAspect.value = camera.aspect;
131
198
  uTan.value = Math.tan((camera.fov * Math.PI) / 360);
132
199
  uTime.value = elapsed;
200
+ // Both caches centre on the camera, snapped to their own grid so a cached value stays put.
201
+ const step = HEIGHT_SPAN / HEIGHT_TEXELS;
202
+ uHeightGrid.value.set(
203
+ Math.floor(camera.position.x / step) * step - HEIGHT_SPAN / 2,
204
+ Math.floor(camera.position.z / step) * step - HEIGHT_SPAN / 2,
205
+ HEIGHT_SPAN,
206
+ HEIGHT_SPAN,
207
+ );
208
+ uBaseGrid.value.set(
209
+ Math.floor((camera.position.x + 2) / CELL_SIZE) - BASE_CELLS / 2,
210
+ Math.floor((camera.position.z + 1) / CELL_SIZE) - BASE_CELLS / 2,
211
+ BASE_CELLS,
212
+ );
133
213
 
134
214
  uRain.value = weather.rain;
135
215
  uFog.value = weather.fog;
@@ -213,7 +213,7 @@ select:focus-visible {
213
213
  transform: translateX(-50%);
214
214
  width: 206px;
215
215
  text-align: center;
216
- color: #c9d6d460;
216
+ color: #c9d6d480;
217
217
  }
218
218
 
219
219
  .compass .letters {
@@ -1,4 +1,4 @@
1
- import { UiLayer, useUiIntent, useUiState } from "@threenative/ui";
1
+ import { UiLayer, useUiIntent, useUiStateDuringStartup } from "@threenative/ui";
2
2
  import { useCallback, useEffect, useRef, useState } from "react";
3
3
  import { type GameState, VISIBILITY_INTENT } from "../state.js";
4
4
  import { Hud, captureScene, toggleFullscreen } from "./Hud.js";
@@ -27,7 +27,11 @@ export function GameUi() {
27
27
  * defaults that have to be applied against a real snapshot rather than guessed at mount.
28
28
  */
29
29
  function RainInterface() {
30
- const state = useUiState<GameState>();
30
+ // The staged TEMPEST curtain below is this page's own loading screen, so it reads state while the
31
+ // engine's cover is up.
32
+ const state = useUiStateDuringStartup<GameState>({
33
+ reason: "draws its own staged loading overlay",
34
+ });
31
35
  const send = useUiIntent();
32
36
  const [toast, setToast] = useState("");
33
37
  const [toastVisible, setToastVisible] = useState(false);
@@ -196,7 +196,7 @@ export function Hud({ send, say, panelOpen, setPanelOpen, state, toast, toastVis
196
196
  aria-label="Save scene image"
197
197
  className="icon-btn desktop"
198
198
  data-tn-interactive
199
- onClick={() => captureScene(say)}
199
+ onClick={() => void captureScene(say)}
200
200
  title="Save scene image [P]"
201
201
  type="button"
202
202
  >
@@ -117,8 +117,8 @@ const SHADERS = [
117
117
  // because a flip on one and not the other would put the reflections somewhere the sky they
118
118
  // mirror is not.
119
119
  what: "the pass-texture sample coordinate",
120
- find: /uSky\.sample\(\s*(\w+)\s*\)/g,
121
- replace: "uSky.sample(vec2($1.x,$1.y.oneMinus()))",
120
+ find: /(uSky|uHeight|uBase)\.sample\(\s*(\w+)\s*\)/g,
121
+ replace: "$1.sample(vec2($2.x,$2.y.oneMinus()))",
122
122
  imports: ["oneMinus"],
123
123
  },
124
124
  ],
@@ -3,12 +3,12 @@
3
3
  //
4
4
  // The whole filmic half of the demo in one pass: twelve animated refractive beads near the lens
5
5
  // edges, a five-tap luma-edge antialias over the warped coordinate, the bloom added, weather
6
- // exposure, the ACES fit, the cool-shadow/warm-highlight grade, the vignette, gamma 1/2.2 and the
7
- // dither. Nothing here is a framework default — every constant is the demo's.
6
+ // exposure, the cool-shadow/warm-highlight grade, the vignette and the dither. The demo's ACES fit and
7
+ // gamma 1/2.2 are gone: the engine's filmic curve and sRGB encode run after this pass.
8
+ // Nothing else here is a framework default — every constant is the demo's.
8
9
  precision highp float;
9
10
  in vec2 vUv;out vec4 fragColor;uniform sampler2D uScene,uBloom;uniform vec2 uRes;uniform float uTime,uExposure,uRain,uLens;
10
11
  float hash(vec2 p){return fract(sin(dot(p,vec2(127.1,311.7)))*43758.5453123);}
11
- vec3 aces(vec3 x){return clamp((x*(2.51*x+.03))/(x*(2.43*x+.59)+.14),0.,1.);}
12
12
  vec3 antialias(vec2 uv){
13
13
  vec2 px=1./uRes;vec3 m=texture(uScene,uv).rgb;
14
14
  vec3 nw=texture(uScene,uv+vec2(-1.,-1.)*px).rgb,ne=texture(uScene,uv+vec2(1.,-1.)*px).rgb;
@@ -37,11 +37,9 @@ void main(){
37
37
  vec3 bloom=vec3(0.);float wt=0.;for(int i=-3;i<=3;i++){float w=exp(-float(i*i)*.26);bloom+=texture(uBloom,uv+vec2(0.,float(i)*3.)/uRes).rgb*w;wt+=w;}
38
38
  col+=bloom/wt*.22;
39
39
  col*=uExposure;
40
- col=aces(col);
41
40
  // Cool shadow / warm practical-light grade, retaining neutral highlights.
42
41
  col=pow(max(col,vec3(0.)),vec3(1.015,1.,.975));
43
42
  float vign=1.-.28*pow(length((uv-.5)*vec2(1.05,1.)),1.65);col*=vign;
44
- col=pow(col,vec3(1./2.2));
45
43
  col+=(hash(gl_FragCoord.xy+floor(uTime*24.))-.5)*.005+dropHighlight;
46
- fragColor=vec4(clamp(col,0.,1.),1.);
44
+ fragColor=vec4(max(col,vec3(0.)),1.); // no upper clamp: the engine's filmic curve rolls the highlights off after this pass
47
45
  }
@@ -38,15 +38,72 @@ float terrain(vec2 p){
38
38
  float sdBox(vec3 p,vec3 b){vec3 q=abs(p)-b;return length(max(q,0.))+min(max(q.x,max(q.y,q.z)),0.);}
39
39
  float capsule(vec3 p,vec3 a,vec3 b,float r){vec3 pa=p-a,ba=b-a;return length(pa-ba*clamp(dot(pa,ba)/dot(ba,ba),0.,1.))-r;}
40
40
  vec2 choose(vec2 a,vec2 b){return a.x<b.x?a:b;}
41
- vec2 sceneMap(vec3 p){
42
- float h=terrain(p.xz);vec2 res=vec2((p.y-(h>1.?h:-3.5))*.58,1.);
43
- // One bounded procedural tree per spatial cell; crowns fit inside their cells.
44
- vec2 cell=floor((p.xz+vec2(2.,1.))/10.5);
45
- float seed=hash12(cell+17.);
46
- vec2 tc=(cell+.5)*10.5-vec2(2.,1.)+vec2(hash12(cell+3.),hash12(cell+7.))*.9-.45;
47
- float th=terrain(tc), rel=tc.x-roadCenter(tc.y);
48
- bool forest=(rel< -9.||tc.y< -175.)&&th>-.2&&th<115.&&seed>.15&&(tc.y< -12.||tc.x< -45.);
49
- if(forest){
41
+ // One bounded procedural tree per spatial cell; crowns fit inside their cells.
42
+ vec2 treeCell(vec2 p){return floor((p+vec2(2.,1.))/10.5);}
43
+ vec2 treeCentre(vec2 cell){return (cell+.5)*10.5-vec2(2.,1.)+vec2(hash12(cell+3.),hash12(cell+7.))*.9-.45;}
44
+ // The ground under a cell's tree, or 1e4 when the cell grows none. terrain() is the costliest call
45
+ // in the march, so it runs only for a cell the cheap tests admit, and trace() asks once per cell.
46
+ float treeBase(vec2 cell){
47
+ float seed=hash12(cell+17.);vec2 tc=treeCentre(cell);
48
+ float rel=tc.x-roadCenter(tc.y),th=1e4;
49
+ if((rel< -9.||tc.y< -175.)&&seed>.15&&(tc.y< -12.||tc.x< -45.)){float g=terrain(tc);if(g>-.2&&g<115.)th=g;}
50
+ return th;
51
+ }
52
+ // The march reads a hill only where it rises above 1 m, else the -3.5 floor. Each hill's weight times
53
+ // its largest height (the noises stay below 1) bounds it, so a point no hill can lift past 1 m skips
54
+ // terrain()'s five noises and gets the same floor it would have.
55
+ // terrain() is static, so src/render/world.ts caches it every frame in two small passes: `uHeight` holds
56
+ // it on a camera-centred grid, and `uBase` holds every nearby tree cell's base. A cached height is
57
+ // only an estimate between its texels, so it stands in for terrain() only as an upper bound,
58
+ // `uHeightMargin` above the sample: a point that bound puts under 1 m gets the floor, a point more
59
+ // than 2 m above it steps as if the hill reached the bound (a shorter step, never through the
60
+ // ground), and any point nearer the ground calls terrain() itself, so every hit and every normal
61
+ // still lands on the exact surface. Only the 148-step coast trace reads the bound (`bounded`): the
62
+ // 36-step reflection march would run out of steps on the shorter ones and reflect sky for hillside.
63
+ uniform sampler2D uHeight;
64
+ uniform vec4 uHeightGrid;
65
+ uniform float uHeightMargin;
66
+ uniform sampler2D uBase;
67
+ uniform vec3 uBaseGrid;
68
+ float heightBound(vec2 p){
69
+ vec2 g=(p-uHeightGrid.xy)/uHeightGrid.zw;
70
+ float bound=1e4;
71
+ if(g.x>.002&&g.y>.002&&g.x<.998&&g.y<.998)bound=texture(uHeight,g).r+uHeightMargin;
72
+ return bound;
73
+ }
74
+ float hillHeight(vec2 p,float y,float bounded){
75
+ vec2 di=(p-vec2(94.,-205.))/vec2(39.,48.);
76
+ float h=-3.5;
77
+ if(smoothstep(13.,155.,-p.x)*183.>1.||smoothstep(280.,670.,-p.y)*223.>1.||smoothstep(190.,430.,p.x)*125.>1.||exp(-dot(di,di))*28.>1.){
78
+ float bound=bounded>.5?heightBound(p):1e4;
79
+ if(bound>1.){
80
+ if(y-bound>2.)h=bound;
81
+ else{float g=terrain(p);if(g>1.)h=g;}
82
+ }
83
+ }
84
+ return h;
85
+ }
86
+ // One texel per tree cell, centred on the camera's cell: r + g is the base (split so a half-float
87
+ // target keeps it to a tenth of a millimetre) and b is 1 where the cell grows a tree.
88
+ vec4 baseTable(vec2 vUv){
89
+ float th=treeBase(uBaseGrid.xy+floor(vUv*uBaseGrid.z));
90
+ float hi=floor(th*4.)/4.;
91
+ vec4 res=vec4(0.,0.,0.,1.);
92
+ if(th<1e3)res=vec4(hi,th-hi,1.,1.);
93
+ return res;
94
+ }
95
+ vec4 heightTable(vec2 vUv){return vec4(terrain(uHeightGrid.xy+vUv*uHeightGrid.zw),0.,0.,1.);}
96
+ float cellBase(vec2 cell){
97
+ vec2 k=cell-uBaseGrid.xy;
98
+ float th=1e4;
99
+ if(k.x>=0.&&k.y>=0.&&k.x<uBaseGrid.z&&k.y<uBaseGrid.z){vec2 bu=(k+.5)/uBaseGrid.z;vec4 v=texture(uBase,bu);if(v.b>.5)th=v.r+v.g;}
100
+ else th=treeBase(cell);
101
+ return th;
102
+ }
103
+ vec2 sceneAt(vec3 p,float th,float bounded){
104
+ vec2 res=vec2((p.y-hillHeight(p.xz,p.y,bounded))*.58,1.);
105
+ if(th<1e3){
106
+ vec2 cell=treeCell(p.xz);float seed=hash12(cell+17.);vec2 tc=treeCentre(cell);
50
107
  vec3 q=p-vec3(tc.x,th,tc.y);float ht=6.+seed*13.;
51
108
  float cy=clamp(q.y/ht,0.,1.);float angle=atan(q.z,q.x);
52
109
  float tier=.77+.23*sin(q.y*3.5+seed*13.);
@@ -83,11 +140,16 @@ vec2 sceneMap(vec3 p){
83
140
  res=choose(res,vec2(capsule(p,vec3(-19.,3.9,-74.),vec3(-19.,13.,-74.),.045),4.));
84
141
  return res;
85
142
  }
143
+ vec2 sceneMap(vec3 p){return sceneAt(p,cellBase(treeCell(p.xz)),0.);}
86
144
  vec2 trace(vec3 ro,vec3 rd,float limit){
87
145
  float t=.25,mat=-1.;
146
+ vec2 lastCell=vec2(1e9);float th=1e4;
88
147
  for(int i=0;i<148;i++){
89
148
  if(t>limit||t>1850.)break;
90
- vec3 p=ro+rd*t;vec2 d=sceneMap(p);
149
+ vec3 p=ro+rd*t;
150
+ vec2 cell=treeCell(p.xz);
151
+ if(cell.x!=lastCell.x||cell.y!=lastCell.y){th=cellBase(cell);lastCell=cell;}
152
+ vec2 d=sceneAt(p,th,1.);
91
153
  float eps=max(.007,t*.00048);
92
154
  if(d.x<eps){mat=d.y;break;}
93
155
  float stepD=max(.05,d.x*.87);
@@ -96,7 +158,9 @@ vec2 trace(vec3 ro,vec3 rd,float limit){
96
158
  }
97
159
  return vec2(t,mat);
98
160
  }
99
- vec3 getNormal(vec3 p,float t){float e=max(.008,t*.00032);vec2 k=vec2(1.,-1.)*.5773;return normalize(k.xyy*sceneMap(p+k.xyy*e).x+k.yyx*sceneMap(p+k.yyx*e).x+k.yxy*sceneMap(p+k.yxy*e).x+k.xxx*sceneMap(p+k.xxx*e).x);}
161
+ // The scene at a normal tap: its cell's tree base is the hit's own unless the tap crossed a cell edge.
162
+ float tapScene(vec3 q,vec2 hitCell,float hitBase){vec2 c=treeCell(q.xz);float th=hitBase;if(c.x!=hitCell.x||c.y!=hitCell.y)th=cellBase(c);return sceneAt(q,th,0.).x;}
163
+ vec3 getNormal(vec3 p,float t){float e=max(.008,t*.00032);vec2 k=vec2(1.,-1.)*.5773;vec2 hc=treeCell(p.xz);float hb=cellBase(hc);return normalize(k.xyy*tapScene(p+k.xyy*e,hc,hb)+k.yyx*tapScene(p+k.yyx*e,hc,hb)+k.yxy*tapScene(p+k.yxy*e,hc,hb)+k.xxx*tapScene(p+k.xxx*e,hc,hb));}
100
164
  vec3 baseColor(vec3 p,float mat,vec3 n){
101
165
  float grit=noise2(p.xz*4.3+p.y)*.2+noise2(p.xz*31.)*.09;
102
166
  // One value, one return. The transpiler turns a GLSL early return into a JavaScript return that
@@ -141,9 +205,13 @@ vec3 reflected(vec3 p,vec3 rd,vec3 sky){
141
205
  vec3 res=sky;
142
206
  if(uReflect!=0){
143
207
  float t=.5;
208
+ vec2 lastCell=vec2(1e9);float th=1e4;
144
209
  for(int i=0;i<36;i++){
145
210
  if(t>280.)break;
146
- vec3 q=p+rd*t;vec2 d=sceneMap(q);
211
+ vec3 q=p+rd*t;
212
+ vec2 cell=treeCell(q.xz);
213
+ if(cell.x!=lastCell.x||cell.y!=lastCell.y){th=cellBase(cell);lastCell=cell;}
214
+ vec2 d=sceneAt(q,th,0.);
147
215
  if(d.x<max(.03,t*.0016)){
148
216
  if(d.y>5.5&&d.y<6.5)res=uLampGlow*.75;
149
217
  else res=mix(baseColor(q,d.y,vec3(0,1,0))*.7,hazeColor(rd),1.-exp(-t*(.0015+uFog*.004)));
@@ -14,6 +14,10 @@ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
14
14
  command = "node"
15
15
  args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
16
16
 
17
- [mcp_servers.threenative-blender]
17
+ [mcp_servers.threenative-animation]
18
18
  command = "node"
19
- args = ["./node_modules/@threenative/core/mcp/blender.mjs"]
19
+ args = ["./node_modules/@threenative/core/mcp/animation.mjs"]
20
+
21
+ [mcp_servers.threenative-devtools]
22
+ command = "node"
23
+ args = ["./node_modules/@threenative/core/mcp/devtools.mjs"]
@@ -22,10 +22,16 @@
22
22
  "./node_modules/@threenative/core/mcp/engine.mjs"
23
23
  ]
24
24
  },
25
- "threenative-blender": {
25
+ "threenative-animation": {
26
26
  "command": "node",
27
27
  "args": [
28
- "./node_modules/@threenative/core/mcp/blender.mjs"
28
+ "./node_modules/@threenative/core/mcp/animation.mjs"
29
+ ]
30
+ },
31
+ "threenative-devtools": {
32
+ "command": "node",
33
+ "args": [
34
+ "./node_modules/@threenative/core/mcp/devtools.mjs"
29
35
  ]
30
36
  }
31
37
  }
@@ -22,10 +22,16 @@
22
22
  "./node_modules/@threenative/core/mcp/engine.mjs"
23
23
  ]
24
24
  },
25
- "threenative-blender": {
25
+ "threenative-animation": {
26
26
  "command": "node",
27
27
  "args": [
28
- "./node_modules/@threenative/core/mcp/blender.mjs"
28
+ "./node_modules/@threenative/core/mcp/animation.mjs"
29
+ ]
30
+ },
31
+ "threenative-devtools": {
32
+ "command": "node",
33
+ "args": [
34
+ "./node_modules/@threenative/core/mcp/devtools.mjs"
29
35
  ]
30
36
  }
31
37
  }
@@ -22,10 +22,16 @@
22
22
  "./node_modules/@threenative/core/mcp/engine.mjs"
23
23
  ]
24
24
  },
25
- "threenative-blender": {
25
+ "threenative-animation": {
26
26
  "command": "node",
27
27
  "args": [
28
- "./node_modules/@threenative/core/mcp/blender.mjs"
28
+ "./node_modules/@threenative/core/mcp/animation.mjs"
29
+ ]
30
+ },
31
+ "threenative-devtools": {
32
+ "command": "node",
33
+ "args": [
34
+ "./node_modules/@threenative/core/mcp/devtools.mjs"
29
35
  ]
30
36
  }
31
37
  }
@@ -25,11 +25,18 @@
25
25
  "./node_modules/@threenative/core/mcp/engine.mjs"
26
26
  ]
27
27
  },
28
- "threenative-blender": {
28
+ "threenative-animation": {
29
29
  "type": "stdio",
30
30
  "command": "node",
31
31
  "args": [
32
- "./node_modules/@threenative/core/mcp/blender.mjs"
32
+ "./node_modules/@threenative/core/mcp/animation.mjs"
33
+ ]
34
+ },
35
+ "threenative-devtools": {
36
+ "type": "stdio",
37
+ "command": "node",
38
+ "args": [
39
+ "./node_modules/@threenative/core/mcp/devtools.mjs"
33
40
  ]
34
41
  }
35
42
  }
@@ -25,11 +25,18 @@
25
25
  "./node_modules/@threenative/core/mcp/engine.mjs"
26
26
  ]
27
27
  },
28
- "threenative-blender": {
28
+ "threenative-animation": {
29
29
  "source": "custom",
30
30
  "command": "node",
31
31
  "args": [
32
- "./node_modules/@threenative/core/mcp/blender.mjs"
32
+ "./node_modules/@threenative/core/mcp/animation.mjs"
33
+ ]
34
+ },
35
+ "threenative-devtools": {
36
+ "source": "custom",
37
+ "command": "node",
38
+ "args": [
39
+ "./node_modules/@threenative/core/mcp/devtools.mjs"
33
40
  ]
34
41
  }
35
42
  }
@@ -7,10 +7,8 @@ ThreeNative owns bootstrap, renderer, fixed-step loop, input, loading, and the s
7
7
  their appearance, and this kit loads no physics plugin: `src/sim/` does its own collision and A*, which is what makes a match replayable and headless-testable. The render camera also skips an object that projects under **0.5 px** in it; `renderer.minimumProjectedPixels` raises that threshold (`false` disables the cut, not the count) and `alwaysRender(object)` exempts an object, while camera-attached objects and shadow casters are kept. The engine also owns the per-frame world-matrix walk, and by default it does not descend into a hidden subtree — so a game that reads a hidden object's `matrixWorld` directly must use `getWorldPosition` (or call `object.updateWorldMatrix(true, false)`) first; `renderer.matrixWorld: "all"` restores three's every-node walk, and `TN_PROJECTION` reports the visited-node count either way. Physics bodies and `ctx.camera` interpolate between fixed ticks by default; `physicsInterpolation: false` disables it globally, `body.interpolate = false` disables one body, `ctx.interpolate(object)` opts in another transform, and `ctx.resetInterpolation(object)` resets game-driven teleports (`TN_PHYSICS_INTERPOLATION` reports the setting and tracked count).
8
8
 
9
9
  ## Start every change
10
- 1. **Critical planning gate:** invoke `threenative-capabilities` before `prd-creator`. Search
11
- `engine_search_capabilities` for the full request and each concrete mechanic, inspect relevant
12
- matches with `engine_capability_detail`, and record a capability or no-match for the plan. Apply the `ponytail` ladder before writing code; never hand-write what the capability search already installs.
13
- 2. Then invoke `prd-creator`. Draft the plan around those capabilities and binding constraints,
10
+ 1. **Critical authoring gate:** invoke `threenative-capabilities` to choose the route. New games: steps 1-8. Existing games: steps 5-7 only, using existing context. Follow the `ponytail` ladder. References borrow mechanics only: no code, level layouts, character names or art. A session started outside this folder has no `mcp__threenative-*` tools: call them with `node node_modules/@threenative/core/mcp/call.mjs <server> <tool> '<json>'`.
11
+ 2. **New game only:** run discovery in `threenative-capabilities` before `prd-creator`. Draft the core-mechanics plan from the kit, both discovery passes and binding constraints,
14
12
  direct the user to review it, and wait for explicit approval plus an instruction to implement it.
15
13
  3. Treat returned constraints as binding. `@threenative/physics/navigation` is browser-only WASM;
16
14
  use portable `ctx`/Three.js for this cross-target template.
@@ -28,14 +26,14 @@ bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report
28
26
  ## Workflow skills
29
27
 
30
28
  - `.agents/skills/prd-creator/SKILL.md` / `.claude/skills/prd-creator/SKILL.md` — game plan and approval gate.
31
- - `.agents/skills/threenative-capabilities/SKILL.md` / `.claude/skills/threenative-capabilities/SKILL.md` — capability search.
29
+ - `.agents/skills/threenative-capabilities/SKILL.md` / `.claude/skills/threenative-capabilities/SKILL.md` — capability search and classic-game mechanics references.
32
30
  - `.agents/skills/threenative-playtest/SKILL.md` / `.claude/skills/threenative-playtest/SKILL.md` — diagnosis and proof.
33
31
  - `.agents/skills/threenative-assets/SKILL.md` / `.claude/skills/threenative-assets/SKILL.md` — assets and sculpting.
34
32
  - `.agents/skills/threenative-visuals/SKILL.md` / `.claude/skills/threenative-visuals/SKILL.md` — captures and look.
35
- - `.agents/skills/threenative-performance/SKILL.md` / `.claude/skills/threenative-performance/SKILL.md` — measured budgets.
33
+ - `.agents/skills/threenative-performance/SKILL.md` / `.claude/skills/threenative-performance/SKILL.md` — measured budgets; read it first when the game is slow or stutters: `playtest trace`, then the `threenative-devtools` MCP server.
36
34
  - `.agents/skills/threenative-ui/SKILL.md` / `.claude/skills/threenative-ui/SKILL.md` — native-safe UI.
37
35
  - `.agents/skills/threenative-context/SKILL.md` / `.claude/skills/threenative-context/SKILL.md` — portable ctx APIs.
38
- - Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro. A game-side `patches/` fix is temporary: once it is settled, it moves into the engine in one PR. Lazy-first: `.agents/skills/ponytail/SKILL.md` / `.claude/skills/ponytail/SKILL.md` — smallest correct change, and its reuse rung is the capability search above. Engine: The owned C++ engine is the default for a new game: the Wasm engine on web and the engine player on desktop. This template pins `engine: "threejs"` in `threenative.config.ts` because the native engine does not take BufferAttribute.updateRanges.push yet. The pin keeps upstream Three.js on web and the legacy host on desktop. Android and iOS use the legacy host.
36
+ - Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro. A game-side `patches/` fix is temporary: once it is settled, it moves into the engine in one PR. Lazy-first: `.agents/skills/ponytail/SKILL.md` / `.claude/skills/ponytail/SKILL.md` — smallest correct change, and its reuse rung is the capability search above. Engine: The owned C++ engine is the default for a new game: the Wasm engine on web and the engine player on desktop. This template runs on it: `threenative.config.ts` names no `engine`. `engine: "threejs"` switches to upstream Three.js only when the user asks for it; it is never a fix for a build error. Android and iOS use the legacy host.
39
37
 
40
38
  ## Commands and map
41
39
 
@@ -43,7 +41,7 @@ bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report
43
41
  pnpm dev
44
42
  pnpm build
45
43
  pnpm build --target desktop
46
- pnpm test
44
+ pnpm test # runs `pnpm check` first: typecheck, ESLint, Biome format
47
45
  ```
48
46
 
49
47
  `src/sim/` is the whole ruleset — terrain, A*, economy, construction, production, combat, vision and a
@@ -53,7 +51,7 @@ every gesture through `ctx.input`; `src/render/` draws it (terrain displaced by
53
51
  `terrainHeight`, instanced models per (type, team), selection rings and health bars, fog of war in the
54
52
  terrain material); `src/ui/` is the HUD, the minimap and the command panel, where every order starts as
55
53
  a named intent the scene resolves. `playtests/survives.playtest.json` is the durable smoke proof;
56
- `rts-orders`, `rts-build`, `rts-train`, `rts-attack`, `rts-ai-attack` and `performance` are the rest.
54
+ `rts-orders`, `rts-build`, `rts-train`, `rts-attack`, `rts-ai-attack`, `rts-pause`, `rts-zoom` and `performance` are the rest.
57
55
 
58
56
  ## Portable authoring contracts
59
57
 
@@ -69,19 +67,20 @@ a frame function `goto` and then `return`; `ctx.state.set({ /* copy this game's
69
67
  is a partial patch. `game.goto("<scene-name>")` also rebuilds the scene, but it resets the game's
70
68
  state. Seeded randomness is deterministic only when `defineGame({ seed })` is configured.
71
69
 
72
- WebGPU reports `TN_GPU_CLASS` once per launch. Automatic `render.resolutionScale` starts at 0.85 for `mobile-low`, otherwise 1; a numeric value pins it. `TN_FRAME_BUDGET` reports the actual scale under both policies. `src/render/sky.ts` makes `assets/sky.jpg` (Poly Haven, CC0) background, environment light and fog
70
+ WebGPU reports `TN_GPU_CLASS` once per launch. This kit authors `renderer.resolutionScale: 1` to keep thin infantry, bars and rings at full resolution; use `"auto"` to restore the engine scaler. This readability policy is not an autoscaler fix or a proven FPS gain. `TN_FRAME_BUDGET` reports the actual scale under both policies. `src/render/sky.ts` makes `assets/sky.jpg` (Poly Haven, CC0) the background and sets the fog
73
71
  colour (re-aim `SUN_DIRECTION` when you swap it, and re-tune the fog density: it is set for a 224 m
74
- map); WebGPU adds a `VirtualShadowNode`. The sky is the light, not the backdrop: the rig is wider than
72
+ map); there is no environment light, AstraCraft lights with a hemisphere, and `lighting.ts` sizes the sun's shadow window to the frame every frame. The rig is wider than
75
73
  the map at its widest zoom, so `terrain.ts` draws a plain under it (grow it with `ZOOM_RANGE.far` or
76
- the horizon goes with it) and `materials.ts` tiles the ground grid every 16 m — a 4 m line, a faint 1 m
77
- one inside each square — because a metre grid crosshatches the map into wireframe. Imported foliage (Fab/Megascans cutouts) draws with its own albedo, normal map and alpha cutoff under the environment light `sky.ts` makes — never tint it, fake its emission or flatten its normals to make up for missing light; `TN_UNLIT_FOLIAGE` names cutout materials drawn with no environment. Every model is a
74
+ the horizon goes with it). The battlefield look follows AstraCraft (PRD-765): `ground.ts` paints roads, aprons and pools into one CPU
75
+ `DataTexture` (no DOM canvas, so it runs native), `environment.ts` puts a mesa on every `game.obstacles` rock plus rubble, scrub and props, one instanced or merged mesh per family. Imported foliage (Fab/Megascans cutouts) draws with its own albedo, normal map and alpha cutoff under the environment light `sky.ts` makes — never tint it, fake its emission or flatten its normals to make up for missing light; `TN_UNLIT_FOLIAGE` names cutout materials drawn with no environment. Every model is a
78
76
  custom TSL material, so an instanced batch's geometry is what you see — change `render/models.ts`, not
79
77
  the material. `src/render/quality.ts` owns `low`, `medium`, `high`; the GPU family from `ctx.renderer.gpuClass` sets the start (`discrete` `high`, `integrated` and `mobile-high` `medium`, other phones `low`); `isMobile()` chooses `low`,
80
78
  otherwise `high` when the family is `unknown`; override with `setupPost(..., { tier: "low" })`. Unknown tiers throw and
81
- `TN_QUALITY_TIER` reports the source. `pnpm test` proves behavior, never the look.
79
+ `TN_QUALITY_TIER` reports the source. The shared look comes from core through `src/render/quality.ts`; this kit overrides it with `tonemapMode: "aces"`, `autoExposureEnabled: false` and `exposure: 1.02`, the AstraCraft reference look; delete those three keys to return to core's filmic curve and metered exposure. The HUD styles live in `src/style.css` under `.astra-hud`; instanced dark ring and bar backing keeps faction cues legible. Like AstraCraft it has no bloom (`bloomEnabled: false`) and no local exposure, a cosine-fourth vignette (`vignetteAmount: 0.4`), and no camera motion blur. AstraCraft colours are legacy linear values: `legacyColor` in `palette.ts` reads them. Anti-aliasing is core's: 4x MSAA on `high`, SMAA on `medium` and `low`, so units stay sharp while the camera pans. `temporalAA: true` and `motionBlurEnabled: true` are the named opt-ins. The grade is neutral and the frame has no film grain. Each stage has a named override: `unrealBloomEnabled: false` returns to Three's `BloomNode` (`bloomStrength`, `bloomRadius`, `bloomThreshold`), and `vignetteAmount: 0` removes the vignette. For a colour grade or grain, add the starter's `grade.ts` and `public/grade.cube`, then set `gradeIntensity` and `grainIntensity`. `pnpm test` proves behavior, never the look.
82
80
 
83
- Two loading conventions come from `@threenative/core`, not from your own loops: `loadAll(items, load)` fetches six at a time and returns results **in the input's order** (a pool that pushes returns completion order, so a positional pick lands a different asset every load), and `addInSlices(objects, (object) => ctx.add(object))` attaches in 8 ms slices so hundreds of objects never land in one long frame; override `concurrency`/`sliceSize`, pass `while: () => alive` to stop a torn-down scene without throwing, and `marker: false` silences `TN_LOAD_ALL`/`TN_ADD_SLICES` but never the measurement. Gate the loading curtain on a measured readiness with `ctx.startup.hold(label, () => ready)`: core polls it every rendered frame, so it settles without a physics step.
81
+ Two loading conventions come from `@threenative/core`, not from your own loops: `loadAll(items, load)` fetches six at a time and returns results **in the input's order** (a pool that pushes returns completion order, so a positional pick lands a different asset every load), and `addInSlices(objects, (object) => ctx.add(object))` attaches in 8 ms slices so hundreds of objects never land in one long frame; override `concurrency`/`sliceSize`, pass `while: () => alive` to stop a torn-down scene without throwing, and `marker: false` silences `TN_LOAD_ALL`/`TN_ADD_SLICES` but never the measurement. Gate the loading curtain on a measured readiness with `ctx.startup.hold(label, () => ready)`: core polls it every rendered frame, so it settles without a physics step. Assets download on demand and stay on disk between web visits: await everything the spawn camera sees before the reveal, and `await ctx.assets.prefetch(["next-level.glb"])` before `ctx.goto` only for what is out of view (a reveal before the visible content loads shows a half-built world); the idle fill downloads the rest after the reveal. Overrides on `defineGame`'s `assets`: `cache: false`, `backgroundFill: false`, both reported on `ctx.assets.cache`; native hosts read installed files.
84
82
 
83
+ `updateRate: "auto"` is the default and follows measured camera policy; `updateRate: 1` is full evaluation, another positive safe integer names a frame interval, and `updateRateReport` shows the effective rate, override status and latest evaluation; one-shots/fades, public mixer listeners/speed overrides, root-motion `AnimationComposer`, automatic camera-ray targets and camera-parented rigs stay full-rate.
85
84
  ## Budget real time for the look
86
85
 
87
86
  Reference-driven authoring starts at `node_modules/create-threenative/agent-docs/references/dream-loop.md`.
@@ -92,4 +91,4 @@ For terrain generation or editing, read `node_modules/create-threenative/agent-d
92
91
  ## Optional multiplayer transport
93
92
  For online play only, import `connect` from `@threenative/core/net` with an HTTPS URL and nonempty identity credential; configure `connectTimeoutMs`, `maxReliableMessageBytes`, `maxQueuedReliableBytes`, and `maxQueuedDatagrams` (10s/65,536/1 MiB/256), use `reliable-ordered` for ordered reliable messages and bounded `unreliable` datagrams that may drop, and keep serialization, replication, prediction, interpolation, snapshots and rejoin in this game's `src/` and server. There is no fallback: unsupported WebTransport/native rejects with `TN_NET_UNAVAILABLE`; reference Go server: `packages/runtime-native/examples/webtransport/server`.
94
93
  Material backlighting lives in `src/render/lighting.ts`: named `rimGain` and `fillGain` controls preserve the authored palette; `materialLighting.ts` reports `TN_ENVIRONMENT_CONTRIBUTION`. Admission is limited to high hardware desktop WebGPU; mobile/software/WebGL/native retain original materials. Existing authored fill stays authoritative.
95
- `src/render/exposure.ts` owns optional adaptation (`enabled: false`); `autoExposure.ts` meters even when disabled. Recipe: `node_modules/create-threenative/agent-docs/references/auto-exposure.md`. Fog is height fog: `HEIGHT_FOG` in `src/render/heightFog.ts` (`density`, `heightFalloff`, `fogHeight`, `maxOpacity`, `startDistance`, `sunExponent`, `sunStartDistance`, `cutoffDistance`) is added to the `FogExp2` distance term on `scene.fogNode` and never replaces it, so a streaming fog `far` still holds.
94
+ `src/render/exposure.ts` supplies the enabled game-owned meter policy through `exposurePolicy` in `quality.ts`. Core owns adaptation and its readback. Recipe: `node_modules/create-threenative/agent-docs/references/auto-exposure.md`. Fog is height fog: `HEIGHT_FOG` in `src/render/heightFog.ts` (`density`, `heightFalloff`, `fogHeight`, `maxOpacity`, `startDistance`, `sunExponent`, `sunStartDistance`, `cutoffDistance`) is added to the `FogExp2` distance term on `scene.fogNode` and never replaces it, so a streaming fog `far` still holds.