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
@@ -17,7 +17,7 @@ function Legend() {
17
17
  <div className="desktop-only pointer-events-none flex items-center gap-3 bg-black/45 px-4 py-2 text-[13px] font-semibold tracking-wide">
18
18
  {KEYS.map(([key, label], index) => (
19
19
  <span className="flex items-center gap-2" key={key}>
20
- {index > 0 ? <i className="mr-1 not-italic text-white/25">|</i> : null}
20
+ {index > 0 ? <i className="mr-1 not-italic text-white/50">|</i> : null}
21
21
  <b className="font-bold text-[#ffa63d]">{key}</b>
22
22
  <span className="font-normal text-white/85">{label}</span>
23
23
  </span>
@@ -205,145 +205,283 @@ function TouchAction({
205
205
  );
206
206
  }
207
207
 
208
- export function Hud() {
209
- const state = useUiState<GameState>();
210
- // An intent, not a state write: on native this component runs in the platform's web view, in a
211
- // different realm from the game, so it cannot reach `game` at all. The game owns what "restart"
212
- // means and does the same two things the keyboard's Enter path does.
208
+ /**
209
+ * The round minimap, and the only HUD part that moves every tick.
210
+ *
211
+ * `blips`, the player position and the yaw are published on every frame so the map can follow
212
+ * them. Reading the whole state with `useUiState<GameState>()` re-rendered every line of this
213
+ * file at that cadence; each part below subscribes to its own fields, so a frame publish renders
214
+ * this component and leaves the roster, clock and wallet alone.
215
+ */
216
+ function MinimapPanel() {
217
+ const playerX = useUiState<GameState, number>((state) => state.playerX);
218
+ const playerZ = useUiState<GameState, number>((state) => state.playerZ);
219
+ const playerYaw = useUiState<GameState, number>((state) => state.playerYaw);
220
+ const blips = useUiState<GameState, GameState["blips"]>((state) => state.blips);
221
+ if (
222
+ playerX === undefined ||
223
+ playerZ === undefined ||
224
+ playerYaw === undefined ||
225
+ blips === undefined
226
+ ) {
227
+ return null;
228
+ }
229
+ return (
230
+ <Minimap
231
+ schematic={townSchematic}
232
+ playerX={playerX}
233
+ playerZ={playerZ}
234
+ playerYaw={playerYaw}
235
+ blips={blips}
236
+ />
237
+ );
238
+ }
239
+
240
+ /**
241
+ * The header clock, to the whole second the header prints.
242
+ *
243
+ * `timeRemaining` changes every frame. Rounded inside the selector, the component re-renders once
244
+ * a second, which is the only rate its text can change.
245
+ */
246
+ function RoundClock() {
247
+ const seconds = useUiState<GameState, number>((state) =>
248
+ Math.max(0, Math.floor(state.timeRemaining)),
249
+ );
250
+ if (seconds === undefined) return null;
251
+ const minutes = Math.floor(seconds / 60);
252
+ const part = String(seconds % 60).padStart(2, "0");
253
+ return (
254
+ <div className="min-w-[86px] rounded-[3px] border border-white/15 bg-black/60 px-3 py-0.5 text-center">
255
+ <div className="text-[26px] font-bold leading-tight tabular-nums text-white">
256
+ {minutes}
257
+ <span className="text-[#ffa63d]">:</span>
258
+ {part}
259
+ </div>
260
+ </div>
261
+ );
262
+ }
263
+
264
+ /**
265
+ * Team rosters flanking the round clock, score beneath — five defenders in blue against five
266
+ * attackers in gold, like the reference's 5-vs-5 header.
267
+ *
268
+ * The roster only changes when a soldier falls, so the selector reads the dead set as a bit mask
269
+ * rather than the blips array the minimap needs every frame.
270
+ */
271
+ function TopCentre() {
272
+ const downMask = useUiState<GameState, number>((state) =>
273
+ state.blips.reduce((mask, blip, index) => (blip.alive ? mask : mask | (1 << index)), 0),
274
+ );
275
+ const playerDown = useUiState<GameState, boolean>((state) => state.health <= 0);
276
+ const playing = useUiState<GameState, boolean>((state) => state.phase === "playing");
277
+ const targetsHit = useUiState<GameState, number>((state) => state.targetsHit);
278
+ const down = downMask ?? 0;
279
+ let soldiersDown = 0;
280
+ for (const index of ROSTER) {
281
+ if ((down & (1 << index)) !== 0) soldiersDown += 1;
282
+ }
283
+ const soldiersStanding = Math.max(0, ROSTER.length - soldiersDown);
284
+ return (
285
+ <div className="hud-top absolute left-1/2 top-2 flex -translate-x-1/2 flex-col items-center drop-shadow-[0_1px_3px_rgba(0,0,0,0.7)]">
286
+ <div className="flex items-start gap-2">
287
+ <div className="flex items-center gap-[3px] pt-1">
288
+ {ROSTER.map((index) => (
289
+ <PortraitChip
290
+ key={`ct-${index}`}
291
+ tone="ct"
292
+ // Slot 0 is the player; the rest of the side is unfilled, and
293
+ // showing it greyed is honest about a roster nobody occupies.
294
+ down={index === 0 ? playerDown === true : true}
295
+ />
296
+ ))}
297
+ </div>
298
+ <RoundClock />
299
+ <div className="flex items-center gap-[3px] pt-1">
300
+ {ROSTER.map((index) => (
301
+ <PortraitChip
302
+ key={`t-${index}`}
303
+ tone="t"
304
+ // A blip that has not been reported yet counts as standing, so
305
+ // the row reads full during the asset-loading window.
306
+ down={(down & (1 << index)) !== 0}
307
+ />
308
+ ))}
309
+ </div>
310
+ </div>
311
+ <div className="mt-0.5 text-[19px] font-bold leading-none tabular-nums tracking-[0.08em] text-white">
312
+ {soldiersDown}
313
+ <span className="mx-1.5 text-white/45">:</span>
314
+ {soldiersStanding}
315
+ </div>
316
+ <div className="mt-[3px] text-[12px] font-semibold leading-none tracking-[0.04em] text-white/60">
317
+ {ROSTER.length} vs {ROSTER.length}
318
+ </div>
319
+ {playing === true ? (
320
+ <div className="mt-1 text-[13px] font-bold tracking-[0.05em] text-white/85">
321
+ CLEAR THE TOWN · HIT {Math.max(0, TARGET_GOAL - (targetsHit ?? 0))} TARGETS
322
+ </div>
323
+ ) : null}
324
+ </div>
325
+ );
326
+ }
327
+
328
+ /** Armour badge, health readout, rank emblem and ammo on one shared baseline. */
329
+ function BottomCentre() {
330
+ const health = useUiState<GameState, number>((state) => state.health) ?? 0;
331
+ const ammo = useUiState<GameState, number>((state) => state.ammo) ?? 0;
332
+ const reserve = useUiState<GameState, number>((state) => state.reserve) ?? 0;
333
+ const lowHealth = health < 35;
334
+ return (
335
+ <div className="hud-bottom absolute bottom-4 left-1/2 flex -translate-x-1/2 items-end gap-9">
336
+ <div className="flex items-end gap-3">
337
+ <span className="relative inline-block h-[34px] w-[30px]">
338
+ <ShieldGlyph className="h-full w-full fill-[#274a68] stroke-[#7fb3e8] stroke-[1.4]" />
339
+ <span className="absolute inset-x-0 top-[11px] text-center text-[12px] font-bold leading-none tabular-nums text-white">
340
+ 100
341
+ </span>
342
+ </span>
343
+ <span>
344
+ <span
345
+ className={`block text-[36px] font-bold leading-none tabular-nums drop-shadow-[0_1px_2px_rgba(0,0,0,0.6)] ${
346
+ lowHealth ? "text-[#ff5f4d]" : "text-white"
347
+ }`}
348
+ >
349
+ {Math.round(health)}
350
+ </span>
351
+ <i
352
+ className={`mt-[3px] block h-[3px] w-[74px] ${lowHealth ? "bg-[#ff5f4d]" : "bg-[#e8c66f]"}`}
353
+ style={{ transformOrigin: "left" }}
354
+ >
355
+ <i
356
+ className={`block h-full ${lowHealth ? "bg-[#ff5f4d]" : "bg-[#ffd166]"}`}
357
+ style={{ width: `${Math.min(100, Math.max(0, health))}%` }}
358
+ />
359
+ </i>
360
+ </span>
361
+ </div>
362
+ <RankEmblem />
363
+ <div className="flex items-baseline gap-2 tabular-nums drop-shadow-[0_1px_2px_rgba(0,0,0,0.6)]">
364
+ <span className="text-[38px] font-bold leading-none text-white">{ammo}</span>
365
+ <span className="text-[19px] font-semibold text-white/55">| {reserve}</span>
366
+ <BulletsGlyph />
367
+ </div>
368
+ </div>
369
+ );
370
+ }
371
+
372
+ /**
373
+ * Crosshair, with a hit marker that blooms outward on a scoring hit.
374
+ *
375
+ * It is hidden while aiming down the sights. The weapon's own optic is the aim reference there,
376
+ * and a second reticle floating beside the red dot reads as a misaligned sight.
377
+ */
378
+ function Reticle() {
379
+ const aiming = useUiState<GameState, boolean>((state) => state.aiming) ?? false;
380
+ const hitFlash = useUiState<GameState, number>((state) => state.hitFlash) ?? 0;
381
+ return (
382
+ <>
383
+ <Crosshair aiming={aiming} hitFlash={hitFlash} Primitive={WebCrosshairPrimitive} />
384
+ {hitFlash > 0 ? (
385
+ <div
386
+ className="absolute left-1/2 top-1/2 h-[26px] w-[26px] -translate-x-1/2 -translate-y-1/2 rotate-45"
387
+ style={{ opacity: Math.min(1, hitFlash * 1.6) }}
388
+ >
389
+ <i className="absolute left-1/2 top-0 h-full w-[2px] -translate-x-1/2 bg-[#ffd166]" />
390
+ <i className="absolute left-0 top-1/2 h-[2px] w-full -translate-y-1/2 bg-[#ffd166]" />
391
+ </div>
392
+ ) : null}
393
+ </>
394
+ );
395
+ }
396
+
397
+ /**
398
+ * Red only while a round is landing. It used to be driven by `health < 45`, which is a
399
+ * low-health indicator wearing a damage vignette's clothes: a soldier at 40 with nobody
400
+ * shooting him got a permanently red screen, and the 70 rounds it takes to walk from 100
401
+ * to 30 produced no feedback at all. The health bar and the health number already say
402
+ * "you are nearly dead".
403
+ */
404
+ function DamageVignette() {
405
+ const hurtFlash = useUiState<GameState, number>((state) => state.hurtFlash) ?? 0;
406
+ if (hurtFlash <= 0) return null;
407
+ return (
408
+ <div
409
+ className="absolute inset-0"
410
+ style={{
411
+ background:
412
+ "radial-gradient(circle at 50% 55%, rgba(0,0,0,0) 42%, rgba(190,26,20,0.5) 100%)",
413
+ opacity: Math.min(1, hurtFlash),
414
+ }}
415
+ />
416
+ );
417
+ }
418
+
419
+ /** End-of-round card. An intent, not a state write: the game owns what "restart" means. */
420
+ function EndCard() {
421
+ const phase = useUiState<GameState, GameState["phase"]>((state) => state.phase);
422
+ const score = useUiState<GameState, number>((state) => state.score) ?? 0;
423
+ const targetsHit = useUiState<GameState, number>((state) => state.targetsHit) ?? 0;
213
424
  const sendIntent = useUiIntent();
214
- // Nothing to draw until the game has published a frame. The web view loads this page before the
215
- // game has run a tick, so an empty first paint is the normal path here, not a failure.
216
- if (state === undefined) return null;
217
- const {
218
- score,
219
- health,
220
- ammo,
221
- reserve,
222
- targetsHit,
223
- timeRemaining,
224
- hitFlash,
225
- phase,
226
- aiming,
227
- playerX,
228
- playerZ,
229
- playerYaw,
230
- blips,
231
- hurtFlash,
232
- } = state;
425
+ if (phase === undefined || phase === "playing") return null;
233
426
  // The same two lines the keyboard's Enter path runs in `Play.update`. A phone has no Enter key,
234
427
  // and until this existed a mobile player who ran out of time had no way to start another round —
235
428
  // the end card told them to press a key their device does not have.
236
429
  const restart = () => sendIntent("restart");
430
+ return (
431
+ <div className="pointer-events-none absolute inset-0 flex flex-col items-center justify-center bg-black/45">
432
+ <div
433
+ className={`text-[42px] font-bold tracking-[0.08em] ${
434
+ phase === "complete" ? "text-[#3ddc6b]" : "text-[#ff5f4d]"
435
+ }`}
436
+ >
437
+ {phase === "complete" ? "TOWN CLEAR" : "RUN OVER"}
438
+ </div>
439
+ <div className="mt-2 text-[18px] font-bold tracking-[0.06em] text-white">
440
+ SCORE {String(score).padStart(4, "0")} · {targetsHit} HITS
441
+ </div>
442
+ <div className="desktop-only mt-6 text-[15px] font-bold tracking-[0.14em] text-[#ffa63d]">
443
+ PRESS ENTER TO RUN IT AGAIN
444
+ </div>
445
+ <div className="touch-show mt-6">
446
+ <TouchAction
447
+ onPress={restart}
448
+ className="rounded-[4px] border-2 border-[#ffa63d] bg-[#ffa63d]/15 px-8 py-3 text-[16px] font-bold tracking-[0.16em] text-[#ffa63d] active:bg-[#ffa63d]/35"
449
+ >
450
+ RUN IT AGAIN
451
+ </TouchAction>
452
+ </div>
453
+ {/* Poly Haven's licence requires a visible credit wherever its API was
454
+ used to source assets, and "visible" means a player has to be able
455
+ to see it — CREDITS.md alone does not discharge that. The sky,
456
+ barrel, gutter, wall lamp and buoy all came from there. ambientCG
457
+ (the plaster, brick, flagstone, concrete, quaystone and steel) is
458
+ CC0 and asks for nothing; it is named here as courtesy, not duty. */}
459
+ <div className="mt-10 text-center text-[11px] leading-relaxed tracking-[0.06em] text-white/40">
460
+ Environment textures and props: Poly Haven (CC0) · ambientCG (CC0)
461
+ <br />
462
+ Audio: Kenney (CC0) · Sonniss
463
+ </div>
464
+ </div>
465
+ );
466
+ }
237
467
 
238
- const lowHealth = health < 35;
239
- // The header score is the round's real tally, not a placeholder: soldiers
240
- // down on the left, soldiers still standing on the right.
241
- const soldiersDown = blips.reduce((total, blip) => total + (blip.alive ? 0 : 1), 0);
242
- const soldiersStanding = Math.max(0, ROSTER.length - soldiersDown);
243
- const clockSeconds = Math.max(0, Math.floor(timeRemaining));
244
- const clockMinutes = Math.floor(clockSeconds / 60);
245
- const clockPart = String(clockSeconds % 60).padStart(2, "0");
468
+ export function Hud() {
469
+ // Nothing to draw until the game has published a frame. The web view loads this page before the
470
+ // game has run a tick, so an empty first paint is the normal path here, not a failure.
471
+ const ready = useUiState<GameState, boolean>(() => true);
472
+ if (ready !== true) return null;
246
473
 
247
474
  return (
248
475
  <div className="pointer-events-none absolute inset-0 select-none font-sans">
249
476
  {/* Top left: the round minimap, north-up. It renders the plain map data
250
477
  the town builder emits — no scene objects cross into the HUD. */}
251
- <Minimap
252
- schematic={townSchematic}
253
- playerX={playerX}
254
- playerZ={playerZ}
255
- playerYaw={playerYaw}
256
- blips={blips}
257
- />
478
+ <MinimapPanel />
258
479
 
259
- {/* Top centre: team rosters flanking the round clock, score beneath —
260
- five defenders in blue against five attackers in gold, like the
261
- reference's 5-vs-5 header. Both rows are live: the gold chips are the
262
- five patrolling soldiers and grey out as they fall, and the leading
263
- blue chip is the player. */}
264
- <div className="hud-top absolute left-1/2 top-2 flex -translate-x-1/2 flex-col items-center drop-shadow-[0_1px_3px_rgba(0,0,0,0.7)]">
265
- <div className="flex items-start gap-2">
266
- <div className="flex items-center gap-[3px] pt-1">
267
- {ROSTER.map((index) => (
268
- <PortraitChip
269
- key={`ct-${index}`}
270
- tone="ct"
271
- // Slot 0 is the player; the rest of the side is unfilled, and
272
- // showing it greyed is honest about a roster nobody occupies.
273
- down={index === 0 ? health <= 0 : true}
274
- />
275
- ))}
276
- </div>
277
- <div className="min-w-[86px] rounded-[3px] border border-white/15 bg-black/60 px-3 py-0.5 text-center">
278
- <div className="text-[26px] font-bold leading-tight tabular-nums text-white">
279
- {clockMinutes}
280
- <span className="text-[#ffa63d]">:</span>
281
- {clockPart}
282
- </div>
283
- </div>
284
- <div className="flex items-center gap-[3px] pt-1">
285
- {ROSTER.map((index) => (
286
- <PortraitChip
287
- key={`t-${index}`}
288
- tone="t"
289
- // A blip that has not been reported yet counts as standing, so
290
- // the row reads full during the asset-loading window.
291
- down={blips[index]?.alive === false}
292
- />
293
- ))}
294
- </div>
295
- </div>
296
- <div className="mt-0.5 text-[19px] font-bold leading-none tabular-nums tracking-[0.08em] text-white">
297
- {soldiersDown}
298
- <span className="mx-1.5 text-white/45">:</span>
299
- {soldiersStanding}
300
- </div>
301
- <div className="mt-[3px] text-[12px] font-semibold leading-none tracking-[0.04em] text-white/60">
302
- {ROSTER.length} vs {ROSTER.length}
303
- </div>
304
- {phase === "playing" ? (
305
- <div className="mt-1 text-[13px] font-bold tracking-[0.05em] text-white/85">
306
- CLEAR THE TOWN · HIT {Math.max(0, TARGET_GOAL - targetsHit)} TARGETS
307
- </div>
308
- ) : null}
309
- </div>
480
+ {/* Top centre: the 5-vs-5 header. */}
481
+ <TopCentre />
310
482
 
311
- {/* Bottom centre: armour badge, health readout, rank emblem and ammo on
312
- one shared baseline, like the reference's lower cluster. */}
313
- <div className="hud-bottom absolute bottom-4 left-1/2 flex -translate-x-1/2 items-end gap-9">
314
- <div className="flex items-end gap-3">
315
- <span className="relative inline-block h-[34px] w-[30px]">
316
- <ShieldGlyph className="h-full w-full fill-[#274a68] stroke-[#7fb3e8] stroke-[1.4]" />
317
- <span className="absolute inset-x-0 top-[11px] text-center text-[12px] font-bold leading-none tabular-nums text-white">
318
- 100
319
- </span>
320
- </span>
321
- <span>
322
- <span
323
- className={`block text-[36px] font-bold leading-none tabular-nums drop-shadow-[0_1px_2px_rgba(0,0,0,0.6)] ${
324
- lowHealth ? "text-[#ff5f4d]" : "text-white"
325
- }`}
326
- >
327
- {Math.round(health)}
328
- </span>
329
- <i
330
- className={`mt-[3px] block h-[3px] w-[74px] ${lowHealth ? "bg-[#ff5f4d]" : "bg-[#e8c66f]"}`}
331
- style={{ transformOrigin: "left" }}
332
- >
333
- <i
334
- className={`block h-full ${lowHealth ? "bg-[#ff5f4d]" : "bg-[#ffd166]"}`}
335
- style={{ width: `${Math.min(100, Math.max(0, health))}%` }}
336
- />
337
- </i>
338
- </span>
339
- </div>
340
- <RankEmblem />
341
- <div className="flex items-baseline gap-2 tabular-nums drop-shadow-[0_1px_2px_rgba(0,0,0,0.6)]">
342
- <span className="text-[38px] font-bold leading-none text-white">{ammo}</span>
343
- <span className="text-[19px] font-semibold text-white/55">| {reserve}</span>
344
- <BulletsGlyph />
345
- </div>
346
- </div>
483
+ {/* Bottom centre: the armour, health, rank and ammo cluster. */}
484
+ <BottomCentre />
347
485
 
348
486
  {/* Top right: one tap to full screen and landscape. Placed opposite the minimap and above
349
487
  the right thumb's look band, so it is reachable but never under a finger that is aiming. */}
@@ -371,72 +509,9 @@ export function Hud() {
371
509
  <Legend />
372
510
  </div>
373
511
 
374
- {/* Crosshair, with a hit marker that blooms outward on a scoring hit.
375
-
376
- It is hidden while aiming down the sights. The weapon's own optic is the aim reference
377
- there, and a second reticle floating beside the red dot reads as a misaligned sight. */}
378
- <Crosshair aiming={aiming} hitFlash={hitFlash} Primitive={WebCrosshairPrimitive} />
379
- {hitFlash > 0 ? (
380
- <div
381
- className="absolute left-1/2 top-1/2 h-[26px] w-[26px] -translate-x-1/2 -translate-y-1/2 rotate-45"
382
- style={{ opacity: Math.min(1, hitFlash * 1.6) }}
383
- >
384
- <i className="absolute left-1/2 top-0 h-full w-[2px] -translate-x-1/2 bg-[#ffd166]" />
385
- <i className="absolute left-0 top-1/2 h-[2px] w-full -translate-y-1/2 bg-[#ffd166]" />
386
- </div>
387
- ) : null}
388
- {/* Red only while a round is landing. It used to be driven by `health < 45`, which is a
389
- low-health indicator wearing a damage vignette's clothes: a soldier at 40 with nobody
390
- shooting him got a permanently red screen, and the 70 rounds it takes to walk from 100
391
- to 30 produced no feedback at all. The health bar and the health number already say
392
- "you are nearly dead". */}
393
- {hurtFlash > 0 ? (
394
- <div
395
- className="absolute inset-0"
396
- style={{
397
- background:
398
- "radial-gradient(circle at 50% 55%, rgba(0,0,0,0) 42%, rgba(190,26,20,0.5) 100%)",
399
- opacity: Math.min(1, hurtFlash),
400
- }}
401
- />
402
- ) : null}
403
-
404
- {phase !== "playing" ? (
405
- <div className="pointer-events-none absolute inset-0 flex flex-col items-center justify-center bg-black/45">
406
- <div
407
- className={`text-[42px] font-bold tracking-[0.08em] ${
408
- phase === "complete" ? "text-[#3ddc6b]" : "text-[#ff5f4d]"
409
- }`}
410
- >
411
- {phase === "complete" ? "TOWN CLEAR" : "RUN OVER"}
412
- </div>
413
- <div className="mt-2 text-[18px] font-bold tracking-[0.06em] text-white">
414
- SCORE {String(score).padStart(4, "0")} · {targetsHit} HITS
415
- </div>
416
- <div className="desktop-only mt-6 text-[15px] font-bold tracking-[0.14em] text-[#ffa63d]">
417
- PRESS ENTER TO RUN IT AGAIN
418
- </div>
419
- <div className="touch-show mt-6">
420
- <TouchAction
421
- onPress={restart}
422
- className="rounded-[4px] border-2 border-[#ffa63d] bg-[#ffa63d]/15 px-8 py-3 text-[16px] font-bold tracking-[0.16em] text-[#ffa63d] active:bg-[#ffa63d]/35"
423
- >
424
- RUN IT AGAIN
425
- </TouchAction>
426
- </div>
427
- {/* Poly Haven's licence requires a visible credit wherever its API was
428
- used to source assets, and "visible" means a player has to be able
429
- to see it — CREDITS.md alone does not discharge that. The sky,
430
- barrel, gutter, wall lamp and buoy all came from there. ambientCG
431
- (the plaster, brick, flagstone, concrete, quaystone and steel) is
432
- CC0 and asks for nothing; it is named here as courtesy, not duty. */}
433
- <div className="mt-10 text-center text-[11px] leading-relaxed tracking-[0.06em] text-white/40">
434
- Environment textures and props: Poly Haven (CC0) · ambientCG (CC0)
435
- <br />
436
- Audio: Kenney (CC0) · Sonniss
437
- </div>
438
- </div>
439
- ) : null}
512
+ <Reticle />
513
+ <DamageVignette />
514
+ <EndCard />
440
515
  </div>
441
516
  );
442
517
  }
@@ -0,0 +1,29 @@
1
+ import { startWorkerGame } from "@threenative/core/worker";
2
+ import { createElement } from "react";
3
+ import { createRoot } from "react-dom/client";
4
+ import { GameUi } from "./ui/GameUi.js";
5
+ import "./style.css";
6
+
7
+ /**
8
+ * `index.html`, the default: the game runs in `src/worker.ts`, off the page's thread, so a busy
9
+ * page cannot stall its frames. This page keeps the canvas, the input and the HUD; `main.html` runs
10
+ * the same game on the page itself.
11
+ */
12
+ const root = document.getElementById("root");
13
+ if (root === null) throw new Error("Missing #root element.");
14
+ root.className = "relative h-full w-full overflow-hidden bg-ink";
15
+ const stage = document.createElement("div");
16
+ stage.className = "absolute inset-0";
17
+ root.append(stage);
18
+ const ui = document.createElement("div");
19
+ root.append(ui);
20
+ // Before the UI mounts: the HUD finds the worker's bridge from its first render.
21
+ const game = startWorkerGame(
22
+ new Worker(new URL("./worker.ts", import.meta.url), { type: "module" }),
23
+ stage,
24
+ );
25
+ createRoot(ui).render(createElement(GameUi));
26
+ game.ready.catch((error: unknown) => {
27
+ stage.textContent = error instanceof Error ? error.message : String(error);
28
+ stage.setAttribute("role", "alert");
29
+ });
@@ -0,0 +1,5 @@
1
+ import { serveWorkerGame } from "@threenative/core/worker";
2
+ import game from "./game.js";
3
+
4
+ // The worker side of `index.html`: the same portable game, on its own thread.
5
+ serveWorkerGame(game);
@@ -40,6 +40,9 @@ const config: IThreeNativeConfig = {
40
40
  // extra pass; set it false for a deliberately hard-edged look. `TN_ALPHA_ANTIALIASING`
41
41
  // reports what it did, and says so when a single-sampled surface leaves it nothing to do.
42
42
  alphaAntialiasing: true,
43
+ // The town's authored meshes are unique (geometry, material) pairs; the batching projection
44
+ // measures `notWorthwhile` and falls back, so the game states the opt-out.
45
+ projection: false,
43
46
  },
44
47
  // One UI on every target: src/ui/ renders through the platform's own browser-class renderer,
45
48
  // so the same React, Tailwind, CSS and SVG run on web, desktop, Android and iOS alike.
@@ -40,6 +40,8 @@ export default defineConfig({
40
40
  tailwindcss(),
41
41
  assetsWatchPlugin(),
42
42
  ],
43
+ // `index.html` runs the game in a worker (the default); `main.html` runs it on the page thread.
44
+ build: { rollupOptions: { input: { index: "index.html", main: "main.html" } } },
43
45
  server: {
44
46
  watch: {
45
47
  ignored: ["**/artifacts/**", "**/screenshots/**", "**/playtests/**"],
@@ -14,6 +14,10 @@ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
14
14
  command = "node"
15
15
  args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
16
16
 
17
- [mcp_servers.threenative-blender]
17
+ [mcp_servers.threenative-animation]
18
18
  command = "node"
19
- args = ["./node_modules/@threenative/core/mcp/blender.mjs"]
19
+ args = ["./node_modules/@threenative/core/mcp/animation.mjs"]
20
+
21
+ [mcp_servers.threenative-devtools]
22
+ command = "node"
23
+ args = ["./node_modules/@threenative/core/mcp/devtools.mjs"]
@@ -22,10 +22,16 @@
22
22
  "./node_modules/@threenative/core/mcp/engine.mjs"
23
23
  ]
24
24
  },
25
- "threenative-blender": {
25
+ "threenative-animation": {
26
26
  "command": "node",
27
27
  "args": [
28
- "./node_modules/@threenative/core/mcp/blender.mjs"
28
+ "./node_modules/@threenative/core/mcp/animation.mjs"
29
+ ]
30
+ },
31
+ "threenative-devtools": {
32
+ "command": "node",
33
+ "args": [
34
+ "./node_modules/@threenative/core/mcp/devtools.mjs"
29
35
  ]
30
36
  }
31
37
  }
@@ -22,10 +22,16 @@
22
22
  "./node_modules/@threenative/core/mcp/engine.mjs"
23
23
  ]
24
24
  },
25
- "threenative-blender": {
25
+ "threenative-animation": {
26
26
  "command": "node",
27
27
  "args": [
28
- "./node_modules/@threenative/core/mcp/blender.mjs"
28
+ "./node_modules/@threenative/core/mcp/animation.mjs"
29
+ ]
30
+ },
31
+ "threenative-devtools": {
32
+ "command": "node",
33
+ "args": [
34
+ "./node_modules/@threenative/core/mcp/devtools.mjs"
29
35
  ]
30
36
  }
31
37
  }
@@ -22,10 +22,16 @@
22
22
  "./node_modules/@threenative/core/mcp/engine.mjs"
23
23
  ]
24
24
  },
25
- "threenative-blender": {
25
+ "threenative-animation": {
26
26
  "command": "node",
27
27
  "args": [
28
- "./node_modules/@threenative/core/mcp/blender.mjs"
28
+ "./node_modules/@threenative/core/mcp/animation.mjs"
29
+ ]
30
+ },
31
+ "threenative-devtools": {
32
+ "command": "node",
33
+ "args": [
34
+ "./node_modules/@threenative/core/mcp/devtools.mjs"
29
35
  ]
30
36
  }
31
37
  }
@@ -25,11 +25,18 @@
25
25
  "./node_modules/@threenative/core/mcp/engine.mjs"
26
26
  ]
27
27
  },
28
- "threenative-blender": {
28
+ "threenative-animation": {
29
29
  "type": "stdio",
30
30
  "command": "node",
31
31
  "args": [
32
- "./node_modules/@threenative/core/mcp/blender.mjs"
32
+ "./node_modules/@threenative/core/mcp/animation.mjs"
33
+ ]
34
+ },
35
+ "threenative-devtools": {
36
+ "type": "stdio",
37
+ "command": "node",
38
+ "args": [
39
+ "./node_modules/@threenative/core/mcp/devtools.mjs"
33
40
  ]
34
41
  }
35
42
  }
@@ -25,11 +25,18 @@
25
25
  "./node_modules/@threenative/core/mcp/engine.mjs"
26
26
  ]
27
27
  },
28
- "threenative-blender": {
28
+ "threenative-animation": {
29
29
  "source": "custom",
30
30
  "command": "node",
31
31
  "args": [
32
- "./node_modules/@threenative/core/mcp/blender.mjs"
32
+ "./node_modules/@threenative/core/mcp/animation.mjs"
33
+ ]
34
+ },
35
+ "threenative-devtools": {
36
+ "source": "custom",
37
+ "command": "node",
38
+ "args": [
39
+ "./node_modules/@threenative/core/mcp/devtools.mjs"
33
40
  ]
34
41
  }
35
42
  }