create-threenative 0.2.9 → 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 +229 -36
  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 +17 -11
  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 +16 -10
  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 +17 -11
  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 +17 -11
  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 +17 -11
  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 +76 -5
  420. package/templates/racing/src/scenes/Race.ts +53 -42
  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 +16 -10
  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 +16 -10
  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 +17 -11
  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 +17 -11
  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 +17 -11
  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 +17 -11
  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 +17 -11
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +56 -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 +53 -34
  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 +17 -11
  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,12 +1,34 @@
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
- // One sun. The sky image in `sky.ts` is the fill light — its environment reaches every face the
4
+ // One sun. The sky in `sky.ts` is the fill light — its environment reaches every face the
5
5
  // sun misses — so there is no hemisphere or ambient light stacked on top to flatten the frame.
6
6
  // The torch point lights in `dungeon.ts` are the only other sources, and they carry no shadows.
7
7
  import { Color, DirectionalLight, Object3D, PCFSoftShadowMap, type Scene, Vector3 } from "three";
8
+ import {
9
+ SUN_ILLUMINANCE,
10
+ SUN_KELVIN,
11
+ sunLight,
12
+ sunLightTransmittance,
13
+ temperatureColour,
14
+ } from "./atmosphere.js";
8
15
  import { DUNGEON_CENTRE } from "./dungeon.js";
9
- import { SUN_DIRECTION } from "./sky.js";
16
+ import { SKY_OPTIONS, SUN_DIRECTION } from "./sky.js";
17
+
18
+ /** The sun as Unreal's default level has it: 6 lux at 6500 K, tinted by the air it crosses. */
19
+ function atmosphereSun(): DirectionalLight {
20
+ const tint = temperatureColour(SUN_KELVIN);
21
+ const through = sunLightTransmittance(Math.asin(Math.min(1, Math.max(-1, SUN_DIRECTION.y))));
22
+ const colour = new Color().setRGB(
23
+ tint[0] * through[0],
24
+ tint[1] * through[1],
25
+ tint[2] * through[2],
26
+ );
27
+ const key = new DirectionalLight(colour, SUN_ILLUMINANCE);
28
+ // `gpuSky.ts` re-tints it when the sun moves.
29
+ sunLight.current = key;
30
+ return key;
31
+ }
10
32
 
11
33
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
12
34
 
@@ -21,8 +43,9 @@ export function setupLighting(
21
43
  renderer.shadowMap.enabled = true;
22
44
  renderer.shadowMap.type = PCFSoftShadowMap;
23
45
 
24
- // Warm white, matched by eye to the photographed midday sun against its own sky.
25
- const key = new DirectionalLight(0xfff1e0, 4.5);
46
+ // Warm white, matched by eye to the photographed midday sun against its own sky (owner
47
+ // The photo sky keeps the warm white matched by eye to its photographed midday sun.
48
+ const key = SKY_OPTIONS.sky === "photo" ? new DirectionalLight(0xfff1e0, 4.5) : atmosphereSun();
26
49
  key.name = "key-light";
27
50
  key.position.copy(SUN_DIRECTION).multiplyScalar(40);
28
51
  // A directional light aims at its target, and the default target sits on the world origin — six
@@ -1,15 +1,6 @@
1
1
  // Generated for you. Scene-owned material assignments; no engine appearance hooks.
2
- import {
3
- type Camera,
4
- type DirectionalLight,
5
- Material,
6
- Mesh,
7
- MeshStandardMaterial,
8
- type Object3D,
9
- type Scene,
10
- type Texture,
11
- } from "three";
12
- import { type IBacklightControls, backlightMaterial } from "./backlightMaterial.js";
2
+ import type { Camera, DirectionalLight, Object3D, Scene, Texture } from "three";
3
+ import type { IBacklightControls } from "./backlightMaterial.js";
13
4
  import {
14
5
  type IEnvironmentMeasurement,
15
6
  measureEnvironment,
@@ -2,6 +2,7 @@
2
2
  // Neutral greys carry the light; one saturated blue marks what you can touch.
3
3
  export const palette = {
4
4
  /** Light grid: room floors and the ground the dungeon stands on. */
5
+ // Owner 2026-10-26 prefers the 7b546d6 neutral floor to the darker beige 0x98948e.
5
6
  floor: 0xb4b1ae,
6
7
  /** Dark grid: walls, door lintels, pillars — anything structural. */
7
8
  structure: 0x747578,
@@ -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,
@@ -10,13 +10,7 @@
10
10
  import { BoxGeometry, CylinderGeometry, Group, type Material, Mesh } from "three";
11
11
  import { RoundedBoxGeometry } from "three/addons/geometries/RoundedBoxGeometry.js";
12
12
  import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
13
- import {
14
- bladeMaterial,
15
- flameMaterial,
16
- propMaterial,
17
- structureMaterial,
18
- worldGridUVs,
19
- } from "./materials.js";
13
+ import { bladeMaterial, propMaterial, structureMaterial, worldGridUVs } from "./materials.js";
20
14
 
21
15
  /** The corner radius every solid in this game is cut with. */
22
16
  export const BEVEL = 0.03;
@@ -34,7 +28,9 @@ export function solidBox(
34
28
  material: Material,
35
29
  radius = BEVEL,
36
30
  ): Mesh {
37
- const geometry = new RoundedBoxGeometry(size[0], size[1], size[2], 2, radius);
31
+ // One bevel segment: at 3 cm the second ring of a two-segment round is under a pixel from the
32
+ // top-down camera, and it triples the triangles of every wall in the main and the shadow pass.
33
+ const geometry = new RoundedBoxGeometry(size[0], size[1], size[2], 1, radius);
38
34
  geometry.translate(at[0], at[1] + size[1] / 2 - radius, at[2]);
39
35
  const mesh = new Mesh(worldGridUVs(geometry), material);
40
36
  mesh.castShadow = true;
@@ -80,6 +76,12 @@ export function bakeByMaterial(parts: readonly Mesh[], into: Group, name: string
80
76
  merged.castShadow = meshes[0]?.castShadow ?? true;
81
77
  merged.receiveShadow = true;
82
78
  into.add(merged);
79
+ // The merged mesh replaces its parts. Left in place they draw a second time, in the main and
80
+ // the shadow pass alike.
81
+ for (const mesh of meshes) {
82
+ mesh.removeFromParent();
83
+ mesh.geometry.dispose();
84
+ }
83
85
  }
84
86
  }
85
87
 
@@ -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,123 +41,64 @@ 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";
38
-
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",
64
- };
65
-
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
- }
44
+ export const resolveQualityTier = qualityTiers.resolve;
101
45
 
102
46
  /**
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.
47
+ * Named overrides of core's Unreal look: the owner (2026-10-26) prefers the 7b546d6 neutral look,
48
+ * grey stone and pale floor with no yellow cast. `TN_WORLD_ENVIRONMENT` reports the tone curve and
49
+ * the exposure this runs; delete a line to take core's value back.
111
50
  */
112
- 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,
51
+ export const neutralLook: IWorldEnvironmentOptions = {
52
+ // ACES at a fixed exposure: core's filmic curve and metered exposure read yellowish here.
53
+ tonemapMode: "aces",
118
54
  autoExposureEnabled: false,
119
55
  exposure: 0.62,
120
- tonemapMode: "aces",
121
- vignetteAmount: 0.22,
122
- };
123
-
124
- /**
125
- * What a desktop gets: contact occlusion on top — the dark line where a foot meets the floor and a
126
- * wall meets the ground, most of what separates "objects in a world" from "objects pasted on a
127
- * background". Gathered at full resolution and denoised: at half, the upsample left a grain around
128
- * every foot.
129
- */
130
- const high: IWorldEnvironmentOptions = {
131
- ...shared,
132
- // GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
133
- gtaoEnabled: true,
56
+ // The kit's bloom: a low threshold that lifts the sunlit floor a little.
57
+ bloomRadius: 0.5,
58
+ bloomStrength: 0.7,
59
+ bloomThreshold: 0.2,
60
+ // The kit's contact occlusion: whole-frame, a 0.35 m reach, 16 directions (8 on medium).
61
+ gtaoDistanceExponent: 1,
62
+ gtaoDistanceFalloff: 1,
63
+ gtaoIndirectOnly: false,
134
64
  gtaoRadius: 0.35,
65
+ gtaoSamples: 16,
66
+ // 4x MSAA under the chain on every tier.
67
+ samples: 4,
135
68
  };
136
69
 
137
- /** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
138
- const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8, renderChainTier: "medium" };
139
-
140
- /** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
141
- const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
142
-
143
- const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
70
+ /** The 7b546d6 per-tier values: half the occlusion directions on medium, none of it on a phone. */
71
+ const neutralTiers: Readonly<Record<string, IWorldEnvironmentOptions>> = {
72
+ high: {},
73
+ medium: { gtaoSamples: 8 },
74
+ low: { gtaoEnabled: false, gtaoRadius: 0.25, motionBlurEnabled: false, temporalAA: false },
75
+ };
144
76
 
145
- /** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
77
+ /**
78
+ * The stages and strengths a tier turns on: the core preset, the neutral look above, this game's
79
+ * exposure policy and the named cost override: no gather, no reflections. The volumetric atmosphere already owns most
80
+ * of the frame; the performance scenario measured 39 to 42 ms GPU p95 with them on and about 1.5 ms
81
+ * of frame time without them. Remove the override when the atmosphere is replaced by a flat sky.
82
+ */
146
83
  export function qualityPreset(tier: string): IWorldEnvironmentOptions {
147
- const preset = QUALITY_PRESETS[tier as QualityTier];
148
- if (preset === undefined) {
149
- throw new Error(
150
- `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
151
- );
152
- }
153
- return preset;
84
+ console.info(
85
+ `TN_RENDER_CHAIN_COST_OVERRIDE ${JSON.stringify({
86
+ reason:
87
+ "Action RPG: the volumetric atmosphere owns the frame; the gather and reflections took the performance scenario to 39-42 ms GPU p95",
88
+ finalGatherMethod: "none",
89
+ ssgiEnabled: false,
90
+ ssrEnabled: false,
91
+ })}`,
92
+ );
93
+ return {
94
+ ...coreQualityPreset(tier),
95
+ ...neutralLook,
96
+ ...neutralTiers[tier],
97
+ exposurePolicy: exposureSettings,
98
+ finalGatherMethod: "none",
99
+ ssgiEnabled: false,
100
+ ssrEnabled: false,
101
+ };
154
102
  }
155
103
 
156
104
  /** First admitted material lane: high desktop hardware WebGPU in the browser only. */
@@ -1,5 +1,11 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  //
3
+ // The default sky is Unreal 5.8.3's default level: a Sky Atmosphere with its volumetric cloud layer, a
4
+ // sky light that captures it, a sun tinted by the air it crosses, and an exponential height fog that
5
+ // takes its colour from the sky (`atmosphere.ts`, `clouds.ts`, `gpuSky.ts`). Sun, sky and fog read one
6
+ // illuminance, so moving `SUN_DIRECTION` recolours all three together. `SKY_OPTIONS.sky = "photo"`
7
+ // keeps the photograph below; `clouds: false` keeps a clear sky.
8
+ //
3
9
  // The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
4
10
  // by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
5
11
  // The same image is the background, the environment light every surface reflects and is filled by,
@@ -13,6 +19,7 @@ import {
13
19
  type Texture,
14
20
  Vector3,
15
21
  } from "three";
22
+ import { createGpuSky } from "./gpuSky.js";
16
23
  import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
17
24
  import { palette } from "./palette.js";
18
25
 
@@ -42,10 +49,11 @@ function distanceDensity(p: HeightFogParams = HEIGHT_FOG): number {
42
49
  return Math.sqrt(Math.max(0, old - height)) / distance;
43
50
  }
44
51
 
45
- export function setupSky(scene: Scene, sky: Texture): void {
52
+ function setupPhotoSky(scene: Scene, sky: Texture): void {
46
53
  sky.mapping = EquirectangularReflectionMapping;
47
54
  sky.colorSpace = SRGBColorSpace;
48
55
  scene.background = sky;
56
+ // The full range: owner 2026-10-26 prefers the 7b546d6 neutral look to the dimmed 0.8 / 0.45 sky.
49
57
  scene.backgroundIntensity = SKY_RANGE;
50
58
  // three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
51
59
  // It is what makes a standard material read as a material: sky-blue fill on faces the sun
@@ -59,3 +67,68 @@ export function setupSky(scene: Scene, sky: Texture): void {
59
67
  scene.fog = distanceFog;
60
68
  scene.fogNode = heightFogNode(distanceFog, HEIGHT_FOG, SUN_DIRECTION);
61
69
  }
70
+
71
+ export const SKY_OPTIONS: { sky: "atmosphere" | "photo"; clouds: boolean; ground: boolean } = {
72
+ sky: "atmosphere",
73
+ clouds: true,
74
+ // The sunlit ground below the horizon stands in for Unreal's Lumen floor bounce: it lifts shadow
75
+ // sides and a mirror reflects it. Set false when the game adds its own global illumination.
76
+ ground: true,
77
+ };
78
+
79
+ /**
80
+ * Unreal's default level fog in metres: density and falloff are per 1000 cm (x0.1 per metre), and its
81
+ * line integral carries ln2 against the exact integral `heightFog.ts` evaluates. `fogHeight` sits
82
+ * 68.5 m below the floor, where the default level puts the fog actor. Inscattering is black and the
83
+ * start distance 0, as in Unreal: the colour comes from the sky.
84
+ */
85
+ const ATMOSPHERE_FOG = {
86
+ ...HEIGHT_FOG,
87
+ density: 0.00436 * Math.LN2,
88
+ heightFalloff: 0.02,
89
+ fogHeight: -68.5,
90
+ startDistance: 0,
91
+ };
92
+
93
+ /** White in the 8-bit environment is this much scene radiance (`createGpuSky`). */
94
+ const ENVIRONMENT_RANGE = 4;
95
+
96
+ /**
97
+ * `photo` is only read when `SKY_OPTIONS.sky` is "photo". `fogged` false leaves the sky unfogged;
98
+ * `clouds` false draws the clear atmosphere. A software adapter draws the 64 x 32 bake as the
99
+ * background, with no LUT or cloud passes.
100
+ */
101
+ export function setupSky(
102
+ scene: Scene,
103
+ photo?: Texture,
104
+ software = false,
105
+ fogged = true,
106
+ clouds = SKY_OPTIONS.clouds,
107
+ ): void {
108
+ if (SKY_OPTIONS.sky === "photo") {
109
+ if (photo === undefined) throw new Error('SKY_OPTIONS.sky "photo" needs assets/sky.jpg loaded');
110
+ setupPhotoSky(scene, photo);
111
+ return;
112
+ }
113
+ // Height fog only; FogExp2 holds the colour `heightFogNode` reads, at zero density. `createGpuSky`
114
+ // sets that colour from the sky and again whenever the sun moves.
115
+ const fog = new FogExp2(0xffffff, 0);
116
+ scene.fog = fog;
117
+ scene.fogNode = heightFogNode(fog, { ...ATMOSPHERE_FOG }, SUN_DIRECTION);
118
+ const { node, environment } = createGpuSky(
119
+ scene,
120
+ SUN_DIRECTION,
121
+ fogged,
122
+ clouds,
123
+ ATMOSPHERE_FOG,
124
+ SKY_OPTIONS.ground,
125
+ );
126
+ environment.mapping = EquirectangularReflectionMapping;
127
+ environment.colorSpace = SRGBColorSpace;
128
+ scene.background = environment;
129
+ scene.backgroundNode = software ? null : node.backgroundNode;
130
+ scene.backgroundIntensity = software ? ENVIRONMENT_RANGE : 1;
131
+ // Unreal's sky light: the same sky, so the fill on every shaded face is the sky's colour.
132
+ scene.environment = environment;
133
+ scene.environmentIntensity = ENVIRONMENT_RANGE;
134
+ }
@@ -30,7 +30,7 @@ import {
30
30
  isWebGLFallbackRenderer,
31
31
  materialLightingEnabled,
32
32
  } from "../render/quality.js";
33
- import { setupSky } from "../render/sky.js";
33
+ import { SKY_OPTIONS, setupSky } from "../render/sky.js";
34
34
  import { TouchControls } from "../render/touch-controls.js";
35
35
  import {
36
36
  type IActionRpgVfxOptions,
@@ -107,9 +107,10 @@ export class Play extends Scene<GameState, IPhysicsContext> {
107
107
  // is a constructor call and never a second file to cook.
108
108
  [this.#mannequin, this.#sky] = await Promise.all([
109
109
  ctx.assets.model<IMannequin>("mannequin-combat.glb"),
110
- ctx.assets.texture("sky.jpg"),
110
+ // Only the photo-sky override reads the photograph; the atmosphere sky is computed.
111
+ SKY_OPTIONS.sky === "photo" ? ctx.assets.texture("sky.jpg") : undefined,
111
112
  ]);
112
- setupSky(ctx.scene, this.#sky);
113
+ setupSky(ctx.scene, this.#sky, ctx.renderer.softwareAdapter !== undefined);
113
114
  this.#environmentSample = await sampleEnvironment(ctx.renderer.raw, ctx.scene, {
114
115
  web: getPlatform().runtime === "web",
115
116
  rendererKind: ctx.renderer.kind,
@@ -121,14 +122,14 @@ export class Play extends Scene<GameState, IPhysicsContext> {
121
122
 
122
123
  override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
123
124
  const mannequin = this.#mannequin;
124
- if (mannequin === undefined || this.#sky === undefined)
125
- throw new Error("Play.enter ran before load() loaded mannequin-combat.glb and sky.jpg.");
125
+ if (mannequin === undefined)
126
+ throw new Error("Play.enter ran before load() loaded mannequin-combat.glb.");
126
127
  const restored = loadProgress(Play.initialState);
127
128
  ctx.state.set(restored);
128
129
  ctx.state.flush();
129
130
 
130
131
  const camera = ctx.camera as PerspectiveCamera;
131
- setupSky(ctx.scene, this.#sky);
132
+ setupSky(ctx.scene, this.#sky, ctx.renderer.softwareAdapter !== undefined);
132
133
  const lighting = setupLighting(
133
134
  ctx.scene,
134
135
  ctx.renderer.raw as Parameters<typeof setupLighting>[1],
@@ -187,6 +188,8 @@ export class Play extends Scene<GameState, IPhysicsContext> {
187
188
  inventory.add("rusted-blade", 1);
188
189
  inventory.add("ember-blade", 1);
189
190
  inventory.add("potion", 2);
191
+ // The hero starts with the rusted blade in hand, so the HUD names the sword the figure holds.
192
+ inventory.equip("rusted-blade");
190
193
  }
191
194
 
192
195
  const playerRef: { value?: Player } = {};
@@ -509,13 +512,14 @@ export class Play extends Scene<GameState, IPhysicsContext> {
509
512
  if (frameCtx.input.justPressed("lethal")) player.takeDamage(player.health + 1);
510
513
  if (frameCtx.input.justPressed("damage")) player.takeDamage(18);
511
514
  const touch = touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size);
512
- if (frameCtx.input.justPressed("attack") || touch?.attackPressed === true) {
513
- player.strike();
514
- strike(Math.round(damageStats.value(elapsed)));
515
+ // A fallen hero swings, casts and rolls no more: the run is over, not the input.
516
+ if (!player.dead) {
517
+ if (frameCtx.input.justPressed("attack") || touch?.attackPressed === true)
518
+ player.strike(() => strike(Math.round(damageStats.value(elapsed))));
519
+ if (frameCtx.input.justPressed("ability") || touch?.abilityPressed === true) ability.cast();
520
+ if (frameCtx.input.justPressed("dodge") && player.dodge())
521
+ emitPlaytestEvent({ entity: "player", name: "dodged" });
515
522
  }
516
- if (frameCtx.input.justPressed("ability") || touch?.abilityPressed === true) ability.cast();
517
- if (frameCtx.input.justPressed("dodge") && player.dodge())
518
- emitPlaytestEvent({ entity: "player", name: "dodged" });
519
523
  if (frameCtx.input.justPressed("equip")) {
520
524
  if (inventory.equip("ember-blade")) {
521
525
  syncEquipmentStat();
@@ -1,6 +1,11 @@
1
1
  import { useUiState } from "@threenative/ui";
2
+ import { ITEMS } from "../items/Inventory.js";
2
3
  import type { GameState } from "../state.js";
3
4
 
5
+ function itemLabel(itemId: string): string {
6
+ return Object.values(ITEMS).find((item) => item.id === itemId)?.label ?? "none";
7
+ }
8
+
4
9
  export function CharacterPanel() {
5
10
  const state = useUiState<GameState>();
6
11
  // Nothing to draw until the game publishes its first snapshot, a few milliseconds in.
@@ -15,7 +20,7 @@ export function CharacterPanel() {
15
20
  <div className="text-amber">character</div>
16
21
  <div className="mt-3 flex justify-between text-dim">
17
22
  <span>health</span>
18
- <span className="text-cyan">{Math.round(health)} / 100</span>
23
+ <span className="text-text">{Math.round(health)} / 100</span>
19
24
  </div>
20
25
  <div className="mt-1 h-1 bg-void">
21
26
  <i className="block h-full bg-cyan" style={{ width: `${Math.max(0, health)}%` }} />
@@ -25,7 +30,7 @@ export function CharacterPanel() {
25
30
  <span className="text-text">{Math.round(damage)}</span>
26
31
  </div>
27
32
  <div className="mt-2 border-t border-line pt-2 text-dim">
28
- weapon <span className="text-text">{equipped || "none"}</span>
33
+ weapon <span className="text-text">{itemLabel(equipped)}</span>
29
34
  </div>
30
35
  <div className="mt-1 text-dim">last hit {Math.round(lastDamage)}</div>
31
36
  </aside>
@@ -9,16 +9,14 @@ export function Hud() {
9
9
  const room = state.room;
10
10
  const phase = state.phase;
11
11
  const enemies = state.enemiesDefeated;
12
- const blocked = state.lineOfSightBlocked;
13
12
  return (
14
- <section className="pointer-events-none absolute left-6 top-5 w-72 rounded bg-black/70 p-3 text-[10px] uppercase tracking-[0.16em]">
13
+ <section
14
+ id="run-hud"
15
+ className="pointer-events-none absolute left-6 top-5 w-72 rounded bg-black/70 p-3 text-[10px] uppercase tracking-[0.16em]"
16
+ >
15
17
  <div className="text-dim">grid dungeon / action rpg</div>
16
18
  <div className="mt-2 text-3xl leading-none text-amber">room {room} / 3</div>
17
- <div className="mt-2 text-cyan">three rooms · boss clear · death fails</div>
18
- <div className="mt-2 flex justify-between border-t border-line pt-2 text-dim">
19
- <span>defeated {enemies}</span>
20
- <span>wall ray {blocked === 1 ? "blocked" : "clear"}</span>
21
- </div>
19
+ <div className="mt-2 border-t border-line pt-2 text-dim">defeated {enemies}</div>
22
20
  {phase !== "playing" && (
23
21
  <div
24
22
  className={`mt-4 border px-3 py-2 text-center text-sm tracking-[0.28em] ${phase === "won" ? "border-amber text-amber" : "border-red text-red"}`}
@@ -1,4 +1,5 @@
1
1
  import { useUiState } from "@threenative/ui";
2
+ import { ITEMS } from "../items/Inventory.js";
2
3
  import type { GameState } from "../state.js";
3
4
 
4
5
  export function InventoryPanel() {
@@ -6,27 +7,26 @@ export function InventoryPanel() {
6
7
  // Nothing to draw until the game publishes its first snapshot, a few milliseconds in.
7
8
  // Rendering zeroes instead would put wrong numbers on screen and then correct them.
8
9
  if (state === undefined) return null;
9
- const items = state.inventory;
10
+ const slots = state.inventorySlots;
10
11
  const refused = state.inventoryFullRefused;
11
12
  const pending = state.pendingLoot;
12
- const seen = new Map<string, number>();
13
+ // A stack holds three potions, so four potions fill two slots — but the player owns one kind of
14
+ // item, so the list shows one row per item with its total and the header counts the slots.
15
+ const totals = new Map<string, number>();
16
+ for (const slot of slots) totals.set(slot.itemId, (totals.get(slot.itemId) ?? 0) + slot.quantity);
13
17
  return (
14
18
  <aside className="pointer-events-none absolute bottom-6 right-6 w-64 border border-line bg-panel/90 p-3 text-[10px] uppercase tracking-[0.14em]">
15
19
  <div className="flex justify-between text-amber">
16
20
  <span>inventory</span>
17
- <span className="text-dim">{items.length} / 6</span>
21
+ <span className="text-dim">{slots.length} / 6 slots</span>
18
22
  </div>
19
- <div className="mt-3 space-y-1 text-dim">
20
- {items.length === 0 && <div>empty</div>}
21
- {items.map((item) => {
22
- const occurrence = seen.get(item) ?? 0;
23
- seen.set(item, occurrence + 1);
24
- return (
25
- <div className="border-b border-line/60 pb-1 text-text" key={`${item}-${occurrence}`}>
26
- {item}
27
- </div>
28
- );
29
- })}
23
+ <div id="inventory-items" className="mt-3 space-y-1 text-dim">
24
+ {totals.size === 0 && <div>empty</div>}
25
+ {[...totals].map(([itemId, quantity]) => (
26
+ <div className="border-b border-line/60 pb-1 text-text" key={itemId}>
27
+ {Object.values(ITEMS).find((item) => item.id === itemId)?.label ?? itemId} x{quantity}
28
+ </div>
29
+ ))}
30
30
  </div>
31
31
  {refused === 1 && (
32
32
  <div className="mt-2 border border-red px-2 py-1 text-red">
@@ -43,6 +43,9 @@ const config: IThreeNativeConfig = {
43
43
  // extra pass; set it false for a deliberately hard-edged look. `TN_ALPHA_ANTIALIASING`
44
44
  // reports what it did, and says so when a single-sampled surface leaves it nothing to do.
45
45
  alphaAntialiasing: true,
46
+ // The authored props are unique (geometry, material) pairs; the batching projection measures
47
+ // `notWorthwhile` and falls back, so the game states the opt-out instead of paying its scan.
48
+ projection: false,
46
49
  },
47
50
  // One UI on every target: src/ui/ renders through the platform's own browser-class renderer,
48
51
  // so the same React, Tailwind, CSS and SVG run on web, desktop, Android and iOS alike.
@@ -0,0 +1,23 @@
1
+ [mcp_servers.threenative-assets]
2
+ command = "node"
3
+ args = ["./node_modules/@threenative/core/mcp/assets.mjs"]
4
+
5
+ [mcp_servers.threenative-assets.env]
6
+ ASSET_DOWNLOAD_DIR = "./public/assets"
7
+ AUDIO_DOWNLOAD_DIR = "./public/audio"
8
+
9
+ [mcp_servers.threenative-sculpt]
10
+ command = "node"
11
+ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
12
+
13
+ [mcp_servers.threenative-engine]
14
+ command = "node"
15
+ args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
16
+
17
+ [mcp_servers.threenative-animation]
18
+ command = "node"
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"]