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
@@ -0,0 +1,20 @@
1
+ // Generated for you. The starter kits share this meter; `pnpm stamp:template-render` copies it into
2
+ // each kit that ships it. Override it for one game in `exposure.ts`, not here.
3
+ //
4
+ // Core's meter is stock Unreal 5.8.3, exposure compensation +1 EV (key 0.36,
5
+ // r.DefaultFeature.AutoExposure.Bias 1.0, UE 5.8.3: Engine/Source/Runtime/Engine/Private/SceneView.cpp:196-199).
6
+ // The kits use 0 EV (key 0.18) instead. Their bright stylised scenes read pastel and veiled at
7
+ // +1 EV. At 0 EV a fresh Opus judge read IMPROVEMENT on 9 of 9 kits (PRD-747, 2026-10-26).
8
+ // The range keeps Unreal's -10..+20 EV100 window around the new key.
9
+ import {
10
+ type IExposureSettings,
11
+ exposureSettings as coreExposureSettings,
12
+ } from "@threenative/core";
13
+
14
+ const KEY = 0.18;
15
+ export const kitExposureSettings: Readonly<IExposureSettings> = {
16
+ ...coreExposureSettings,
17
+ key: KEY,
18
+ minStops: Math.log2(KEY) - 20,
19
+ maxStops: Math.log2(KEY) + 10,
20
+ };
@@ -0,0 +1,58 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // One sun, and the sky in `sky.ts` is the fill — a fresh Unreal level's directional light and sky
5
+ // light, and nothing stacked on top. A hemisphere or ambient light next to an image-based
6
+ // environment fills the same faces twice and flattens the shadow side the sun is there to make.
7
+ // The shadow is one map fitted to the road round the player's kart and travelling with it.
8
+ import { DirectionalLight, PCFShadowMap, type Scene, type Vector3 } from "three";
9
+ import { SUN_DIRECTION } from "./sky.js";
10
+
11
+ type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
12
+
13
+ export interface ILighting {
14
+ readonly key: DirectionalLight;
15
+ /** Keeps the sun's target on the player, so its direction is the same wherever the kart is. */
16
+ follow(target: Vector3): void;
17
+ }
18
+
19
+ export function setupLighting(
20
+ scene: Scene,
21
+ renderer: ShadowRenderer,
22
+ castShadows: boolean,
23
+ ): ILighting {
24
+ // No caster draws until the renderer's own shadow map is on.
25
+ renderer.shadowMap.enabled = castShadows;
26
+ // PCF with a radius: three's soft variant ignores `shadow.radius` and leaves a hard edge.
27
+ renderer.shadowMap.type = PCFShadowMap;
28
+ // A 5,500 K late-morning sun. The level is the meter's: auto exposure scales the frame, so this
29
+ // number sets the sun against the sky, not how bright the picture is.
30
+ const key = new DirectionalLight(0xffe4c4, 3.2);
31
+ key.castShadow = castShadows;
32
+ // Small biases: a large normal bias lifts the shadow off the tyres of whatever casts it.
33
+ key.shadow.bias = -0.0002;
34
+ key.shadow.normalBias = 0.02;
35
+ // The chase camera sees about 30 m of road behind and ahead of the kart; the map is fitted to
36
+ // that and travels. 2048² over 60 m is a 3 cm texel. A course-wide virtual shadow measured a
37
+ // 30-50 ms render phase on the Wasm engine here, slowing the fixed-step race below real time.
38
+ const extent = 30;
39
+ key.shadow.mapSize.set(2048, 2048);
40
+ key.shadow.radius = 3;
41
+ key.shadow.camera.near = 1;
42
+ key.shadow.camera.far = 140;
43
+ key.shadow.camera.left = -extent;
44
+ key.shadow.camera.right = extent;
45
+ key.shadow.camera.top = extent;
46
+ key.shadow.camera.bottom = -extent;
47
+ scene.add(key);
48
+ scene.add(key.target);
49
+ const offset = SUN_DIRECTION.clone().multiplyScalar(60);
50
+ return {
51
+ follow(target: Vector3): void {
52
+ key.position.set(target.x + offset.x, target.y + offset.y, target.z + offset.z);
53
+ key.target.position.copy(target);
54
+ key.target.updateMatrixWorld();
55
+ },
56
+ key,
57
+ };
58
+ }
@@ -0,0 +1,332 @@
1
+ import {
2
+ type Camera,
3
+ CanvasTexture,
4
+ ClampToEdgeWrapping,
5
+ Mesh,
6
+ MeshBasicMaterial,
7
+ type OrthographicCamera,
8
+ PlaneGeometry,
9
+ type Scene,
10
+ type Texture,
11
+ } from "three";
12
+ import { palette } from "./palette.js";
13
+
14
+ /* BEGIN THREENATIVE LOADING APPEARANCE */
15
+ /** The five authoring points for this screen stay in this generated file. */
16
+ export const loading = {
17
+ backgroundColor: palette.skyLow,
18
+ backgroundImage: undefined as string | undefined,
19
+ enabled: true,
20
+ fillImage: undefined as string | undefined,
21
+ logoImage: undefined as string | undefined,
22
+ progressColor: palette.accent,
23
+ showStatus: false,
24
+ trackColor: palette.skyHigh,
25
+ bar: {
26
+ anchorX: 0.5,
27
+ anchorY: 0.72,
28
+ height: 12,
29
+ maxWidth: 1200,
30
+ minWidth: 2,
31
+ width: 0.62,
32
+ },
33
+ } as const;
34
+ /* END THREENATIVE LOADING APPEARANCE */
35
+
36
+ interface ILoadingHost {
37
+ readonly assets?: { texture(path: string): Promise<Texture> };
38
+ readonly camera: Camera;
39
+ readonly canvasLayer: {
40
+ readonly camera: OrthographicCamera;
41
+ readonly scene: Scene;
42
+ opaque: boolean;
43
+ };
44
+ readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
45
+ readonly scene: Scene;
46
+ readonly startup: {
47
+ readonly progress: number;
48
+ readonly warmup?: { readonly status: "complete" | "incomplete" | "unavailable" };
49
+ whenReady(): Promise<void>;
50
+ };
51
+ readonly viewport?: {
52
+ readonly safeArea: { height: number; width: number; x: number; y: number };
53
+ };
54
+ }
55
+
56
+ interface ILoadingController {
57
+ update(): void;
58
+ finish(): void;
59
+ }
60
+
61
+ function noOp(layer: ILoadingHost["canvasLayer"]): ILoadingController {
62
+ layer.opaque = false;
63
+ return { finish: () => undefined, update: () => undefined };
64
+ }
65
+
66
+ function meshFor(
67
+ layer: ILoadingHost["canvasLayer"],
68
+ material: MeshBasicMaterial,
69
+ renderOrder: number,
70
+ ): Mesh<PlaneGeometry, MeshBasicMaterial> {
71
+ const mesh = new Mesh(new PlaneGeometry(1, 1), material);
72
+ mesh.frustumCulled = false;
73
+ mesh.renderOrder = renderOrder;
74
+ layer.scene.add(mesh);
75
+ return mesh;
76
+ }
77
+
78
+ function imageAspect(texture: Texture | null | undefined): number {
79
+ const image = texture?.image as { height?: number; width?: number } | undefined;
80
+ const width = image?.width ?? 1;
81
+ const height = image?.height ?? 1;
82
+ return width > 0 && height > 0 ? width / height : 1;
83
+ }
84
+
85
+ function configureTexture(texture: Texture): void {
86
+ texture.wrapS = ClampToEdgeWrapping;
87
+ texture.wrapT = ClampToEdgeWrapping;
88
+ texture.needsUpdate = true;
89
+ }
90
+
91
+ function setFillUv(geometry: PlaneGeometry, progress: number, base: readonly number[]): void {
92
+ const uv = geometry.getAttribute("uv");
93
+ for (let index = 0; index < uv.count; index += 1) uv.setX(index, (base[index] ?? 0) * progress);
94
+ uv.needsUpdate = true;
95
+ }
96
+
97
+ function coverUv(
98
+ geometry: PlaneGeometry,
99
+ texture: Texture,
100
+ width: number,
101
+ height: number,
102
+ baseU: readonly number[],
103
+ baseV: readonly number[],
104
+ ): void {
105
+ const imageRatio = imageAspect(texture);
106
+ const boxRatio = width / Math.max(1, height);
107
+ const visibleU = imageRatio > boxRatio ? boxRatio / imageRatio : 1;
108
+ const visibleV = imageRatio < boxRatio ? imageRatio / boxRatio : 1;
109
+ const offsetU = (1 - visibleU) / 2;
110
+ const offsetV = (1 - visibleV) / 2;
111
+ const uv = geometry.getAttribute("uv");
112
+ for (let index = 0; index < uv.count; index += 1) {
113
+ uv.setX(index, offsetU + (baseU[index] ?? 0) * visibleU);
114
+ uv.setY(index, offsetV + (baseV[index] ?? 0) * visibleV);
115
+ }
116
+ uv.needsUpdate = true;
117
+ }
118
+
119
+ function statusMesh(
120
+ layer: ILoadingHost["canvasLayer"],
121
+ ):
122
+ | { mesh: Mesh<PlaneGeometry, MeshBasicMaterial>; texture: Texture; update(value: number): void }
123
+ | undefined {
124
+ if (!loading.showStatus || typeof document === "undefined") return undefined;
125
+ const canvas = document.createElement("canvas");
126
+ canvas.width = 180;
127
+ canvas.height = 48;
128
+ const context = canvas.getContext("2d");
129
+ if (context === null) return undefined;
130
+ const texture = new CanvasTexture(canvas);
131
+ const mesh = meshFor(
132
+ layer,
133
+ new MeshBasicMaterial({ depthTest: false, depthWrite: false, map: texture, transparent: true }),
134
+ 4,
135
+ );
136
+ const update = (value: number): void => {
137
+ context.clearRect(0, 0, canvas.width, canvas.height);
138
+ context.fillStyle = "#ffffff";
139
+ context.font = "700 20px monospace";
140
+ context.textAlign = "center";
141
+ context.textBaseline = "middle";
142
+ context.fillText(`${Math.round(value * 100)}%`, canvas.width / 2, canvas.height / 2);
143
+ texture.needsUpdate = true;
144
+ };
145
+ update(0);
146
+ return { mesh, texture, update };
147
+ }
148
+
149
+ export function createLoadingScreen(host: ILoadingHost): ILoadingController {
150
+ const layer = host.canvasLayer;
151
+ if (!loading.enabled) return noOp(layer);
152
+ const camera = layer.camera;
153
+ const backdrop = meshFor(
154
+ layer,
155
+ new MeshBasicMaterial({ color: loading.backgroundColor, depthTest: false, depthWrite: false }),
156
+ 0,
157
+ );
158
+ const track = meshFor(
159
+ layer,
160
+ new MeshBasicMaterial({ color: loading.trackColor, depthTest: false, depthWrite: false }),
161
+ 1,
162
+ );
163
+ const fill = meshFor(
164
+ layer,
165
+ new MeshBasicMaterial({ color: loading.progressColor, depthTest: false, depthWrite: false }),
166
+ 2,
167
+ );
168
+ const fillBaseU = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
169
+ fill.geometry.getAttribute("uv").getX(index),
170
+ );
171
+ const fillBaseV = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
172
+ fill.geometry.getAttribute("uv").getY(index),
173
+ );
174
+ const logo =
175
+ loading.logoImage === undefined
176
+ ? undefined
177
+ : meshFor(
178
+ layer,
179
+ new MeshBasicMaterial({
180
+ color: 0xffffff,
181
+ depthTest: false,
182
+ depthWrite: false,
183
+ transparent: true,
184
+ }),
185
+ 3,
186
+ );
187
+ const status = statusMesh(layer);
188
+ const parts = [
189
+ backdrop,
190
+ track,
191
+ fill,
192
+ ...(logo === undefined ? [] : [logo]),
193
+ ...(status === undefined ? [] : [status.mesh]),
194
+ ];
195
+ const ownedTextures = new Set<Texture>(status === undefined ? [] : [status.texture]);
196
+ let width = 1;
197
+ let height = 1;
198
+ let barWidth = 1;
199
+ let barHeight: number = loading.bar.height;
200
+ let barX = 0;
201
+ let barY = 0;
202
+ let progress = 0;
203
+ let done = false;
204
+ let backdropTexture: Texture | undefined;
205
+
206
+ const layout = (): void => {
207
+ width = Math.max(1, camera.right - camera.left);
208
+ height = Math.max(1, camera.top - camera.bottom);
209
+ const safe = host.viewport?.safeArea ?? { height, width, x: 0, y: 0 };
210
+ const safeWidth = Math.max(1, Math.min(width, safe.width));
211
+ const safeHeight = Math.max(1, Math.min(height, safe.height));
212
+ const safeX = Math.max(0, Math.min(width - safeWidth, safe.x));
213
+ const safeY = Math.max(0, Math.min(height - safeHeight, safe.y));
214
+ barWidth = Math.max(2, Math.min(loading.bar.maxWidth, safeWidth * loading.bar.width));
215
+ barHeight = Math.max(2, Math.min(loading.bar.height, safeHeight * 0.05));
216
+ barX = safeX + safeWidth * loading.bar.anchorX;
217
+ barY = safeY + safeHeight * loading.bar.anchorY;
218
+ const worldX = (screenX: number): number => camera.left + screenX;
219
+ const worldY = (screenY: number): number => camera.top - screenY;
220
+ const visibleWidth = Math.max(loading.bar.minWidth, barWidth * progress);
221
+ backdrop.scale.set(width, height, 1);
222
+ backdrop.position.set(worldX(width / 2), worldY(height / 2), 0);
223
+ track.scale.set(barWidth, barHeight, 1);
224
+ track.position.set(worldX(barX), worldY(barY), 0);
225
+ fill.scale.set(visibleWidth, barHeight, 1);
226
+ fill.position.set(worldX(barX - barWidth / 2 + visibleWidth / 2), worldY(barY), 0);
227
+ if (logo?.visible) {
228
+ const logoWidth = Math.min(safeWidth * 0.42, 280);
229
+ logo.scale.set(
230
+ logoWidth,
231
+ Math.min(logoWidth / imageAspect(logo.material.map), safeHeight * 0.22),
232
+ 1,
233
+ );
234
+ logo.position.set(worldX(barX), worldY(Math.max(safeY, barY - safeHeight * 0.2)), 0);
235
+ }
236
+ if (status !== undefined) {
237
+ status.mesh.scale.set(Math.min(180, safeWidth * 0.32), 48, 1);
238
+ status.mesh.position.set(worldX(barX), worldY(Math.min(height, barY + barHeight * 2.5)), 0);
239
+ }
240
+ if (backdropTexture !== undefined)
241
+ coverUv(backdrop.geometry, backdropTexture, width, height, fillBaseU, fillBaseV);
242
+ };
243
+
244
+ const updateProgress = (value: number): void => {
245
+ const bounded = Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
246
+ // A missing or incomplete backend observation cannot prove that all first-use work is done.
247
+ // Keep the bar visibly indeterminate until readiness removes the cover; never turn unknown
248
+ // coverage into a false 100% claim.
249
+ const observationUnknown =
250
+ host.startup.warmup !== undefined && host.startup.warmup.status !== "complete";
251
+ progress = observationUnknown ? Math.min(0.9, bounded) : bounded;
252
+ setFillUv(fill.geometry, progress, fillBaseU);
253
+ status?.update(progress);
254
+ layout();
255
+ };
256
+
257
+ const attachTexture = (mesh: Mesh<PlaneGeometry, MeshBasicMaterial>, texture: Texture): void => {
258
+ if (done) return;
259
+ configureTexture(texture);
260
+ mesh.material.map = texture;
261
+ mesh.material.color.set(0xffffff);
262
+ mesh.material.needsUpdate = true;
263
+ ownedTextures.add(texture);
264
+ if (mesh === backdrop) backdropTexture = texture;
265
+ layout();
266
+ updateProgress(progress);
267
+ };
268
+
269
+ const load = (source: string | undefined, mesh: Mesh<PlaneGeometry, MeshBasicMaterial>): void => {
270
+ if (source === undefined || host.assets === undefined) return;
271
+ void host.assets
272
+ .texture(source)
273
+ .then((texture) => attachTexture(mesh, texture))
274
+ .catch(() => undefined);
275
+ };
276
+ load(loading.backgroundImage, backdrop);
277
+ load(loading.fillImage, fill);
278
+ if (logo !== undefined && loading.logoImage !== undefined && host.assets !== undefined) {
279
+ void host.assets
280
+ .texture(loading.logoImage)
281
+ .then((texture) => {
282
+ if (done) return;
283
+ configureTexture(texture);
284
+ logo.material.map = texture;
285
+ logo.material.needsUpdate = true;
286
+ logo.visible = true;
287
+ ownedTextures.add(texture);
288
+ layout();
289
+ })
290
+ .catch(() => undefined);
291
+ }
292
+
293
+ layer.opaque = true;
294
+ layout();
295
+ updateProgress(0);
296
+
297
+ const finish = (): void => {
298
+ if (done) return;
299
+ done = true;
300
+ for (const mesh of parts) {
301
+ mesh.removeFromParent();
302
+ mesh.geometry.dispose();
303
+ mesh.material.dispose();
304
+ }
305
+ for (const texture of ownedTextures) texture.dispose();
306
+ layer.opaque = false;
307
+ };
308
+
309
+ void (async () => {
310
+ await host.startup.whenReady();
311
+ if (done) return;
312
+ // Prewarm the world's shaders, but do not wait for them here. `whenReady()` already means the
313
+ // world is safe to show, and compiling a lit, post-processed scene takes far longer than the
314
+ // launch window: hold the screen for it and a playtest — which advances a fixed step as fast
315
+ // as the machine allows — runs an entire scenario behind the launch screen, so every capture
316
+ // photographs the loading bar instead of the game. The prewarm still happens; it no longer
317
+ // decides when the player sees the world.
318
+ try {
319
+ void host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
320
+ } catch {
321
+ // A renderer without compileAsync is not a reason to keep the world hidden.
322
+ }
323
+ finish();
324
+ })();
325
+
326
+ return {
327
+ finish,
328
+ update(): void {
329
+ if (!done) updateProgress(host.startup.progress);
330
+ },
331
+ };
332
+ }
@@ -0,0 +1,119 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // The course and the karts are built from primitives painted with vertex colours and merged, so a
5
+ // kart is a handful of draw calls instead of forty. `paint` colours one primitive, `merge` joins a
6
+ // list into one geometry, and `lit` is the one cached physically based material per look: rough
7
+ // and non-metal like the stock Unreal default material, so the meter sees albedos, not glints.
8
+ import {
9
+ BufferAttribute,
10
+ type BufferGeometry,
11
+ Color,
12
+ type ColorRepresentation,
13
+ Euler,
14
+ type Material,
15
+ Matrix4,
16
+ MeshStandardMaterial,
17
+ Quaternion,
18
+ Vector3,
19
+ } from "three";
20
+ import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
21
+ import { C } from "./palette.js";
22
+
23
+ const cache = new Map<string, Material>();
24
+
25
+ /** One shared material per option set; `vertexColors` is the default for merged parts. */
26
+ export function lit(
27
+ options: {
28
+ color?: ColorRepresentation;
29
+ roughness?: number;
30
+ metalness?: number;
31
+ emissive?: ColorRepresentation;
32
+ emissiveIntensity?: number;
33
+ vertexColors?: boolean;
34
+ transparent?: boolean;
35
+ opacity?: number;
36
+ flatShading?: boolean;
37
+ } = {},
38
+ ): MeshStandardMaterial {
39
+ const key = JSON.stringify(options);
40
+ const hit = cache.get(key);
41
+ if (hit !== undefined) return hit as MeshStandardMaterial;
42
+ const material = new MeshStandardMaterial({
43
+ color: options.color ?? C.white,
44
+ depthWrite: options.transparent !== true,
45
+ emissive: options.emissive ?? 0x000000,
46
+ emissiveIntensity: options.emissiveIntensity ?? 0,
47
+ flatShading: options.flatShading ?? false,
48
+ metalness: options.metalness ?? 0,
49
+ opacity: options.opacity ?? 1,
50
+ roughness: options.roughness ?? 0.75,
51
+ transparent: options.transparent ?? false,
52
+ vertexColors: options.vertexColors ?? true,
53
+ });
54
+ cache.set(key, material);
55
+ return material;
56
+ }
57
+
58
+ const scratch = new Color();
59
+
60
+ /**
61
+ * Colours every vertex of `geometry` and bakes `transform` (position, rotation, scale) into it.
62
+ * `shade` varies the colour by height in the part, 0 for none: a gentle top-light that keeps a
63
+ * merged lump from reading as one flat colour.
64
+ */
65
+ export function paint(
66
+ geometry: BufferGeometry,
67
+ color: ColorRepresentation,
68
+ transform?: Matrix4,
69
+ shade = 0,
70
+ ): BufferGeometry {
71
+ const part = geometry.index === null ? geometry : geometry.toNonIndexed();
72
+ if (transform !== undefined) part.applyMatrix4(transform);
73
+ const position = part.getAttribute("position");
74
+ const colors = new Float32Array(position.count * 3);
75
+ scratch.set(color);
76
+ let low = Number.POSITIVE_INFINITY;
77
+ let high = Number.NEGATIVE_INFINITY;
78
+ for (let i = 0; i < position.count; i += 1) {
79
+ low = Math.min(low, position.getY(i));
80
+ high = Math.max(high, position.getY(i));
81
+ }
82
+ for (let i = 0; i < position.count; i += 1) {
83
+ const t = high > low ? (position.getY(i) - low) / (high - low) : 1;
84
+ const k = 1 - shade * (1 - t);
85
+ colors.set([scratch.r * k, scratch.g * k, scratch.b * k], i * 3);
86
+ }
87
+ part.setAttribute("color", new BufferAttribute(colors, 3));
88
+ if (part.getAttribute("uv") === undefined)
89
+ part.setAttribute("uv", new BufferAttribute(new Float32Array(position.count * 2), 2));
90
+ return part;
91
+ }
92
+
93
+ /** Joins painted parts into one geometry; throws rather than drawing nothing. */
94
+ export function merge(parts: readonly BufferGeometry[]): BufferGeometry {
95
+ const merged = mergeGeometries([...parts], false);
96
+ if (merged === null) throw new Error("merge: parts do not share the same attributes.");
97
+ for (const part of parts) part.dispose();
98
+ merged.computeBoundingSphere();
99
+ return merged;
100
+ }
101
+
102
+ /** A transform from position, Euler angles (radians, XYZ) and scale. */
103
+ export function at(
104
+ x: number,
105
+ y: number,
106
+ z: number,
107
+ rx = 0,
108
+ ry = 0,
109
+ rz = 0,
110
+ sx = 1,
111
+ sy = sx,
112
+ sz = sx,
113
+ ): Matrix4 {
114
+ return new Matrix4().compose(
115
+ new Vector3(x, y, z),
116
+ new Quaternion().setFromEuler(new Euler(rx, ry, rz)),
117
+ new Vector3(sx, sy, sz),
118
+ );
119
+ }
@@ -0,0 +1,74 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // `palette` is the roles the render layer shares: the two sky bands (also the loading screen's
5
+ // track), the horizon distance fades into, the grass, and one saturated `accent`. `C` is the
6
+ // per-part colour table for the procedural course, karts and items. Albedo, not light: the sun,
7
+ // the sky and the meter bring the brightness.
8
+
9
+ export const palette = {
10
+ grass: 0x58b03a,
11
+ /** Distance fades into this; also the loading screen's background. */
12
+ horizon: 0xbcdcf0,
13
+ /** The loading screen's progress track. */
14
+ skyHigh: 0x1d62cf,
15
+ skyLow: 0x63a6e8,
16
+ /** The one saturated role: boost pads, the countdown, the HUD's place. */
17
+ accent: 0xffb21f,
18
+ } as const;
19
+
20
+ /** Colours by part. */
21
+ export const C = {
22
+ ink: 0x1a1410,
23
+ white: 0xffffff,
24
+
25
+ // The course.
26
+ asphalt: 0x56585e,
27
+ asphaltDark: 0x45474c,
28
+ line: 0xf4f1e8,
29
+ kerbRed: 0xd8302a,
30
+ kerbWhite: 0xf2efe6,
31
+ grass: 0x5aae38,
32
+ grassDark: 0x3f8d2a,
33
+ grassLight: 0x7cc548,
34
+ dirt: 0xb48a58,
35
+ sand: 0xdcc48e,
36
+ rock: 0x9a8a78,
37
+ water: 0x2a8cc4,
38
+ bridge: 0xc9b89a,
39
+ bridgeDark: 0x8e7f68,
40
+ pillar: 0xb3a58e,
41
+ // The wall's blocks, in MK64's toy colours (red, yellow, blue, white); the kit's own order.
42
+ blockA: 0xe0412f,
43
+ blockB: 0xf3c32c,
44
+ blockC: 0x2f74d8,
45
+ blockD: 0xf2efe6,
46
+ bark: 0x7e5734,
47
+ canopy: 0x3f9e33,
48
+ canopyLight: 0x62bb3e,
49
+ bloomPink: 0xff8fb8,
50
+ bloomYellow: 0xffd84a,
51
+ banner: 0xe8402e,
52
+ check: 0x161616,
53
+
54
+ // Items.
55
+ boxA: 0xff5fa8,
56
+ boxB: 0x4fd0ff,
57
+ boxC: 0xffe14a,
58
+ burr: 0x8a5a2b,
59
+ burrTip: 0xf2df92,
60
+ acorn: 0xc98a43,
61
+ acornCap: 0x5b3a1c,
62
+ pad: 0xff8a14,
63
+ padGlow: 0xffd23a,
64
+
65
+ // Karts and drivers.
66
+ tyre: 0x1d1d20,
67
+ hub: 0xd8d8d8,
68
+ seat: 0x2a2a30,
69
+ metal: 0xa8acb4,
70
+ exhaust: 0x50525a,
71
+ skin: 0xf0b48a,
72
+ visor: 0x14202e,
73
+ glove: 0xf6f2ea,
74
+ } as const;
@@ -0,0 +1,79 @@
1
+ // Generated for you. This file wires two things together and decides nothing itself.
2
+ //
3
+ // `quality.ts`, in this folder, owns which overrides each tier adds to the engine's look.
4
+ // `WorldEnvironment` from ThreeNative core builds the chain and prints `TN_RENDER_CHAIN` and
5
+ // `TN_WORLD_ENVIRONMENT`, naming every stage as applied or refused **with a reason**, so a stage
6
+ // that silently no-op'd is never mistaken for one you turned off.
7
+ //
8
+ // To force one tier for one run — a desktop that is dropping frames, a capture you want to
9
+ // compare — pass it: `setupPost(renderer, scene, camera, { tier: "low" })`. Overriding does not
10
+ // silence the report: `TN_QUALITY_TIER` names the tier that ran either way.
11
+ import { type OutputRenderer, WorldEnvironment } from "@threenative/core";
12
+ import type { Camera, DirectionalLight, Scene } from "three";
13
+ import { type QualityTier, qualityPreset, resolveQualityTier } from "./quality.js";
14
+
15
+ import { temporalDetailRequested, temporalDetailStages } from "./temporalDetailStage.js";
16
+
17
+ type ProfileGlobals = typeof globalThis & {
18
+ __THREENATIVE_PROFILE__?: { hostedSoftware?: unknown };
19
+ };
20
+
21
+ interface IPostEnvironment {
22
+ godraysLight?: DirectionalLight;
23
+ mobile?: boolean;
24
+ /** The renderer named a software adapter; this game's answer is its `low` tier. */
25
+ software?: boolean;
26
+ /** The renderer's GPU family (`ctx.renderer.gpuClass?.class`); it picks the start tier. */
27
+ gpuClass?: string;
28
+ /** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
29
+ tier?: QualityTier;
30
+ }
31
+
32
+ /** The tier `setupPost` will run, for scenery that scales with it (the meadow's grass). */
33
+ export function postTier(environment: IPostEnvironment = {}): QualityTier {
34
+ // The native production collector explicitly marks a software-only hosted smoke run; that run
35
+ // takes the `low` look so its screenshot settles on a CPU adapter. An ordinary desktop is `high`.
36
+ const hostedSoftware =
37
+ (globalThis as ProfileGlobals).__THREENATIVE_PROFILE__?.hostedSoftware === true;
38
+ return resolveQualityTier({
39
+ mobile: environment.mobile,
40
+ gpuClass: environment.gpuClass,
41
+ software: environment.software,
42
+ tier: environment.tier ?? (hostedSoftware ? "low" : undefined),
43
+ });
44
+ }
45
+
46
+ export function setupPost(
47
+ renderer: OutputRenderer,
48
+ scene: Scene,
49
+ camera: Camera,
50
+ environment: IPostEnvironment = {},
51
+ ): { readonly tier: QualityTier; dispose(): void } {
52
+ const hostedSoftware =
53
+ (globalThis as ProfileGlobals).__THREENATIVE_PROFILE__?.hostedSoftware === true;
54
+ const tier = postTier(environment);
55
+ const source =
56
+ environment.tier !== undefined ? "override" : hostedSoftware ? "hosted-software" : "platform";
57
+ console.info(
58
+ `TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} software=${
59
+ environment.software === true
60
+ } source=${source}`,
61
+ );
62
+ const settings = qualityPreset(tier);
63
+ const detail = temporalDetailRequested(renderer, settings) ? temporalDetailStages() : [];
64
+ const world = new WorldEnvironment({
65
+ ...settings,
66
+ authoredStageNames: [...(settings.authoredStageNames ?? []), ...detail.map(({ name }) => name)],
67
+ authoredStages: () => detail,
68
+ });
69
+ const applied = world.apply(renderer, scene, camera, { godraysLight: environment.godraysLight });
70
+ let disposed = false;
71
+ return {
72
+ tier,
73
+ dispose(): void {
74
+ if (disposed) return;
75
+ disposed = true;
76
+ applied.dispose?.();
77
+ },
78
+ };
79
+ }