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
@@ -85,7 +85,7 @@
85
85
  "pointerPosition": {
86
86
  "buttons": 2,
87
87
  "x": 0.68,
88
- "y": 0.7
88
+ "y": 0.55
89
89
  },
90
90
  "holdTicks": 4,
91
91
  "release": true
@@ -0,0 +1,112 @@
1
+ {
2
+ "name": "rts-pause",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
9
+ "warmupFrames": 20,
10
+ "subject": "selection",
11
+ "steps": [
12
+ {
13
+ "kind": "wait",
14
+ "label": "settle",
15
+ "waitTicks": 60,
16
+ "release": true
17
+ },
18
+ {
19
+ "kind": "click",
20
+ "label": "pause",
21
+ "at": {
22
+ "element": {
23
+ "selector": "[data-testid=pause-toggle]"
24
+ }
25
+ },
26
+ "waitTicks": 6
27
+ },
28
+ {
29
+ "kind": "click",
30
+ "label": "base-while-paused",
31
+ "at": {
32
+ "element": {
33
+ "selector": "[data-testid=order-base]"
34
+ }
35
+ },
36
+ "waitTicks": 6
37
+ },
38
+ {
39
+ "kind": "click",
40
+ "label": "army-while-paused",
41
+ "at": {
42
+ "element": {
43
+ "selector": "[data-testid=order-army]"
44
+ }
45
+ },
46
+ "waitTicks": 6
47
+ },
48
+ {
49
+ "kind": "wait",
50
+ "label": "held",
51
+ "waitTicks": 60,
52
+ "release": true
53
+ },
54
+ {
55
+ "kind": "click",
56
+ "label": "resume",
57
+ "at": {
58
+ "element": {
59
+ "selector": "[data-testid=pause-toggle]"
60
+ }
61
+ },
62
+ "waitTicks": 6
63
+ },
64
+ {
65
+ "kind": "wait",
66
+ "label": "running",
67
+ "waitTicks": 60,
68
+ "release": true
69
+ }
70
+ ],
71
+ "assert": {
72
+ "diagnostics": {
73
+ "noConsoleErrors": true,
74
+ "noNetworkErrors": true,
75
+ "noRuntimeDiagnostics": true,
76
+ "runtimeReady": true
77
+ },
78
+ "resources": [
79
+ {
80
+ "id": "state",
81
+ "path": "paused",
82
+ "atSteps": [
83
+ {
84
+ "label": "pause",
85
+ "equals": true
86
+ },
87
+ {
88
+ "label": "base-while-paused",
89
+ "equals": true
90
+ },
91
+ {
92
+ "label": "army-while-paused",
93
+ "equals": true
94
+ },
95
+ {
96
+ "label": "held",
97
+ "equals": true
98
+ },
99
+ {
100
+ "label": "running",
101
+ "equals": false
102
+ }
103
+ ]
104
+ },
105
+ {
106
+ "id": "state",
107
+ "path": "simTime",
108
+ "changed": true
109
+ }
110
+ ]
111
+ }
112
+ }
@@ -16,7 +16,7 @@
16
16
  {
17
17
  "kind": "click",
18
18
  "label": "train",
19
- "at": { "x": 1232, "y": 460 },
19
+ "at": { "element": { "selector": "[data-testid=train-worker]" } },
20
20
  "waitTicks": 8
21
21
  },
22
22
  { "kind": "wait", "label": "queued", "waitTicks": 20, "release": true },
@@ -0,0 +1,81 @@
1
+ {
2
+ "name": "rts-zoom",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
9
+ "warmupFrames": 20,
10
+ "subject": "selection",
11
+ "steps": [
12
+ {
13
+ "kind": "wait",
14
+ "label": "settle",
15
+ "waitTicks": 60,
16
+ "release": true
17
+ },
18
+ {
19
+ "kind": "input",
20
+ "label": "wheel-up",
21
+ "wheel": {
22
+ "deltaY": -100,
23
+ "x": 0.5,
24
+ "y": 0.5
25
+ },
26
+ "holdTicks": 4,
27
+ "release": true
28
+ },
29
+ {
30
+ "kind": "wait",
31
+ "label": "closer",
32
+ "waitTicks": 90,
33
+ "release": true
34
+ },
35
+ {
36
+ "kind": "input",
37
+ "label": "wheel-down",
38
+ "wheel": {
39
+ "deltaY": 100,
40
+ "x": 0.5,
41
+ "y": 0.5
42
+ },
43
+ "holdTicks": 4,
44
+ "release": true
45
+ },
46
+ {
47
+ "kind": "wait",
48
+ "label": "farther",
49
+ "waitTicks": 90,
50
+ "release": true
51
+ }
52
+ ],
53
+ "assert": {
54
+ "diagnostics": {
55
+ "noConsoleErrors": true,
56
+ "noNetworkErrors": true,
57
+ "noRuntimeDiagnostics": true,
58
+ "runtimeReady": true
59
+ },
60
+ "resources": [
61
+ {
62
+ "id": "state",
63
+ "path": "cameraZoom",
64
+ "atSteps": [
65
+ {
66
+ "label": "settle",
67
+ "equals": 30
68
+ },
69
+ {
70
+ "label": "closer",
71
+ "equals": 27.6
72
+ },
73
+ {
74
+ "label": "farther",
75
+ "equals": 30
76
+ }
77
+ ]
78
+ }
79
+ ]
80
+ }
81
+ }
@@ -13,12 +13,14 @@ const game = defineGame<GameState, undefined>({
13
13
  input: {
14
14
  // The four directions of `input.vector("move")`, which pan the camera. Declared rather than
15
15
  // inherited from the default binding, so the axis the scene reads is visible where the game is
16
- // defined — and so nothing else can quietly claim a key this camera already owns.
16
+ // defined — and so nothing else can quietly claim a key this camera already owns. Arrows only,
17
+ // as in the genre: the letter keys are orders (A attacks), and a key that both orders and pans
18
+ // slides the view out from under the click it was arming.
17
19
  move: {
18
- down: ["ArrowDown", "KeyS"],
19
- left: ["ArrowLeft", "KeyA"],
20
- right: ["ArrowRight", "KeyD"],
21
- up: ["ArrowUp", "KeyW"],
20
+ down: ["ArrowDown"],
21
+ left: ["ArrowLeft"],
22
+ right: ["ArrowRight"],
23
+ up: ["ArrowUp"],
22
24
  },
23
25
  // Wheel, pinch and the right stick share one portable camera intent. Negative DOM deltaY
24
26
  // (toward the user) is positive scroll intent on browser and native.
@@ -29,8 +31,12 @@ const game = defineGame<GameState, undefined>({
29
31
  base: { keys: ["Space"] },
30
32
  cancel: { keys: ["Escape"] },
31
33
  hold: { keys: ["KeyH"] },
34
+ // The two buttons the quick bar shows with a key in AstraCraft and this bar used to show bare:
35
+ // the key is the label's source of truth, so `V` and `F4` are bound or they are not printed.
36
+ idle: { keys: ["F4"] },
32
37
  moveOrder: { keys: ["KeyM"] },
33
- stopOrder: { keys: ["KeyX"] },
38
+ retreat: { keys: ["KeyV"] },
39
+ stopOrder: { keys: ["KeyS"] },
34
40
  },
35
41
  // `playtest()` installs the bridge a scenario needs to observe entities and state. Without it,
36
42
  // semantic assertions fail closed with TN_PLAYTEST_BRIDGE_MISSING rather than passing.
@@ -41,6 +47,12 @@ const game = defineGame<GameState, undefined>({
41
47
  // Seeded worldgen: one number makes the whole match — the map, the rocks, the AI — reproducible.
42
48
  seed: 471,
43
49
  start: "play",
50
+ // The HUD reads whole numbers off a 20 Hz clock, and the scene republishes the camera and the
51
+ // selection's centroid every frame, so the publisher's byte-compare never skips one: left on the
52
+ // rendered-frame default, every frame paid a JSON serialization and a React render inside the
53
+ // frame task for a HUD that had nothing new to show. Named, the store publishes 20 times a second
54
+ // and an idle frame publishes nothing. The playtests read the same fields, on the same clock.
55
+ stateFlushMs: 50,
44
56
  });
45
57
 
46
58
  export default game;
@@ -53,12 +65,22 @@ export default game;
53
65
  * instead, which keeps one source of truth on the side that owns the simulation.
54
66
  */
55
67
  game.ui.onIntent((intent, payload) => {
68
+ // A new match: `game.goto` rebuilds the scene and resets the state to its initial shape.
69
+ if (intent === "restart") {
70
+ game.resume();
71
+ void game.goto("play");
72
+ return;
73
+ }
56
74
  if (intent === "pause") {
57
75
  game.pause();
58
76
  sendSceneIntent("cancel");
59
77
  }
60
78
  if (intent === "resume") game.resume();
61
- game.state.set({ paused: intent === "pause", uiReady: game.ui.connected });
79
+ // Only the pause and resume intents move the flag: an order sent while paused leaves it held.
80
+ game.state.set({
81
+ uiReady: game.ui.connected,
82
+ ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
83
+ });
62
84
  game.state.flush();
63
85
  if (intent !== "pause" && intent !== "resume") sendSceneIntent(intent, payload);
64
86
  });
@@ -17,22 +17,41 @@ import {
17
17
  InstancedMesh,
18
18
  MeshBasicMaterial,
19
19
  Object3D,
20
+ type OrthographicCamera,
20
21
  PlaneGeometry,
21
22
  RingGeometry,
23
+ Vector3,
22
24
  } from "three";
23
25
  import type { Game } from "../sim/game.js";
24
26
  import { HALF, STARTS, terrainHeight } from "../sim/terrain.js";
25
27
  import { type IEntity, TYPES } from "../sim/types.js";
26
28
  import type { IUnitModels } from "./models.js";
27
- import { palette } from "./palette.js";
29
+ import { legacyColor, palette } from "./palette.js";
28
30
 
29
31
  /** Copies one (type, team) can be on screen at once. The supply cap is 120 for the whole map. */
30
32
  const CAPACITY = 128;
31
33
  /** Order markers alive at once, oldest released first. */
32
34
  const MARKERS = 24;
33
- /** Bar thickness, in metres. Enough to read at the closest zoom, thin enough not to crowd. */
34
- const BAR = 0.34;
35
+ /**
36
+ * Bar sizes in screen pixels, not metres, as AstraCraft draws them: a 3 px fill inside a 1 px dark
37
+ * frame, 30 px over a unit and 60 px over a building, and a 2 px build or queue line 6 px below.
38
+ * A readout keeps one size on screen at every zoom, as in every strategy game.
39
+ */
40
+ const BAR_HEIGHT = 3;
41
+ const BAR_BORDER = 1;
42
+ const BAR_WIDTH = { building: 60, unit: 30 } as const;
43
+ const WORK_HEIGHT = 2;
44
+ const WORK_DROP = 6;
35
45
  const MARKER_LIFE = 0.8;
46
+ /**
47
+ * Where an entity was before the latest rules step: `id, x, z, angle, altitude` per slot, slot =
48
+ * `id % POSE_SLOTS`. The rules move units 20 times a second and the screen shows 60, so a unit
49
+ * drawn where the rules left it moves on one frame in three; drawn between its last two poses, it
50
+ * moves on every frame. ponytail: a slot shared by two live ids (ids 4096 apart) draws the newer
51
+ * one unblended for that step; key by entity if a match ever holds that many at once.
52
+ */
53
+ const POSE_SLOTS = 4096;
54
+ const POSE = 5;
36
55
 
37
56
  interface IBatch {
38
57
  readonly list: IEntity[];
@@ -49,12 +68,21 @@ export interface IArmy {
49
68
  /** An expanding ring where an order landed, so a click has a visible consequence. */
50
69
  readonly marker: (x: number, z: number, hostile: boolean) => void;
51
70
  readonly root: Object3D;
71
+ /** Record every entity's pose. Call it just before each rules step. */
72
+ readonly step: (game: Game) => void;
73
+ /** Once per drawn frame: write every transform this frame shows. */
52
74
  readonly sync: (
53
75
  game: Game,
54
76
  selected: ReadonlySet<number>,
55
77
  time: number,
56
78
  dt: number,
57
79
  camera: Camera,
80
+ /** Screen pixels per metre at depth 1, measured by the scene: a render file imports no package. */
81
+ pixelsPerMetre: number,
82
+ /** How far the frame is into the latest rules step, 0 (the pose before it) to 1 (its result). */
83
+ blend: number,
84
+ /** Where the camera draws this frame from, so a bar's edges land on whole pixels. */
85
+ eye: Vector3,
58
86
  ) => void;
59
87
  readonly dispose: () => void;
60
88
  }
@@ -63,10 +91,14 @@ const _dummy = new Object3D();
63
91
  const _tint = new Color();
64
92
  const _friendly = new Color(0x9be6bb);
65
93
  const _hurt = new Color(0xddad71);
66
- const _hostile = new Color(0xff8756);
94
+ /** A rival's bar is its faction colour, as in AstraCraft. */
95
+ const _teamFill = STARTS.map((start) => new Color(start.css));
67
96
  const _work = new Color(0x77eddf);
68
97
  const _queue = new Color(0x77cddd);
69
- const _backing = new Color(palette.gridLine);
98
+ const _backing = new Color(0x08151e);
99
+ const _right = new Vector3();
100
+ const _at = { altitude: 0, angle: 0, x: 0, z: 0 };
101
+ const _offset = new Vector3();
70
102
 
71
103
  export function createArmy(
72
104
  models: IUnitModels,
@@ -78,15 +110,16 @@ export function createArmy(
78
110
  for (let index = 0; index < MARKERS; index += 1) markers.push({ life: 0, x: 0, z: 0 });
79
111
 
80
112
  // One ring per faction, because the ring's colour *is* the faction: a single mesh would need a
81
- // per-instance colour, and three draws are cheaper than the bookkeeping.
113
+ // per-instance colour, and three draws are cheaper than the bookkeeping. AstraCraft's thin ring:
114
+ // its legacy-linear faction colour at 0.75 opacity, no dark underlay (PRD-765 judge round 2).
82
115
  const rings = STARTS.map(
83
116
  (start) =>
84
117
  new InstancedMesh(
85
- new RingGeometry(1, 1.075, 40).rotateX(-Math.PI / 2),
118
+ new RingGeometry(1, 1.095, 40).rotateX(-Math.PI / 2),
86
119
  new MeshBasicMaterial({
87
- color: start.color,
120
+ color: legacyColor(start.color),
88
121
  depthWrite: false,
89
- opacity: 0.85,
122
+ opacity: 0.75,
90
123
  transparent: true,
91
124
  }),
92
125
  CAPACITY,
@@ -102,6 +135,18 @@ export function createArmy(
102
135
  // array for every ring, every frame.
103
136
  const ringTeams = STARTS.map((start, index) => start.team ?? index);
104
137
 
138
+ // A dark border keeps the order marker readable on bright ground.
139
+ const backingMaterial = new MeshBasicMaterial({ color: palette.unseen, depthWrite: false });
140
+ const markerBackings = new InstancedMesh(
141
+ new RingGeometry(0.47, 0.69, 24).rotateX(-Math.PI / 2),
142
+ backingMaterial,
143
+ MARKERS,
144
+ );
145
+ markerBackings.instanceMatrix.setUsage(DynamicDrawUsage);
146
+ markerBackings.frustumCulled = false;
147
+ markerBackings.renderOrder = 1;
148
+ root.add(markerBackings);
149
+
105
150
  // Two quads per readout — a coloured fill over the dark backdrop ring that frames it — so a bar
106
151
  // reads against any ground. `toneMapped: false` keeps them at the colour they were authored.
107
152
  const bars = new InstancedMesh(
@@ -112,6 +157,9 @@ export function createArmy(
112
157
  bars.instanceMatrix.setUsage(DynamicDrawUsage);
113
158
  bars.frustumCulled = false;
114
159
  bars.renderOrder = 3;
160
+ // The colour attribute exists before the first draw: three.js compiles the material once, and a
161
+ // batch first drawn without `instanceColor` stays white on that engine (PRD-765 A/B).
162
+ bars.setColorAt(0, _backing);
115
163
  root.add(bars);
116
164
 
117
165
  const markerRings = new InstancedMesh(
@@ -127,6 +175,7 @@ export function createArmy(
127
175
  markerRings.instanceMatrix.setUsage(DynamicDrawUsage);
128
176
  markerRings.frustumCulled = false;
129
177
  markerRings.renderOrder = 2;
178
+ markerRings.setColorAt(0, _backing);
130
179
  root.add(markerRings);
131
180
 
132
181
  const batch = (type: string, team: number): IBatch => {
@@ -149,31 +198,89 @@ export function createArmy(
149
198
  };
150
199
 
151
200
  let barCount = 0;
201
+ /** Screen pixels per metre this frame (orthographic: the same at every depth). */
202
+ let pixels = 1;
203
+ /** Half the viewport in pixels, and the camera's up axis in world space this frame. */
204
+ let halfWidth = 0;
205
+ let halfHeight = 0;
206
+ const up = new Vector3();
207
+ /** The camera position this frame draws from, and how far it is into the latest rules step. */
208
+ let eye: Vector3 = up;
209
+ let blend = 1;
210
+ const poses = new Float64Array(POSE_SLOTS * POSE).fill(-1);
152
211
 
153
- /**
154
- * One readout: a fill over its own backdrop, both camera-facing quads, the fill growing from
155
- * the left so a half-full bar reads as "half" rather than as "small".
156
- */
157
- const pushBar = (entity: IEntity, width: number, fraction: number, y: number, colour: Color) => {
158
- const height = terrainHeight(entity.x, entity.z) + y;
212
+ /** The pose this frame draws `entity` at, between its last two rules steps, written into `_at`. */
213
+ const pose = (entity: IEntity): typeof _at => {
214
+ const slot = (entity.id % POSE_SLOTS) * POSE;
215
+ const altitude = entity.altitude || 0;
216
+ if (poses[slot] !== entity.id) {
217
+ _at.x = entity.x;
218
+ _at.z = entity.z;
219
+ _at.angle = entity.angle;
220
+ _at.altitude = altitude;
221
+ return _at;
222
+ }
223
+ const x = poses[slot + 1] as number;
224
+ const z = poses[slot + 2] as number;
225
+ const angle = poses[slot + 3] as number;
226
+ const height = poses[slot + 4] as number;
227
+ // The short way round, so a unit turning through ±π does not spin the long way.
228
+ let turn = entity.angle - angle;
229
+ turn -= Math.round(turn / (2 * Math.PI)) * 2 * Math.PI;
230
+ _at.x = x + (entity.x - x) * blend;
231
+ _at.z = z + (entity.z - z) * blend;
232
+ _at.angle = angle + turn * blend;
233
+ _at.altitude = height + (altitude - height) * blend;
234
+ return _at;
235
+ };
236
+
237
+ /** The bar's anchor in world space and on screen, in pixels from the top-left. */
238
+ const _base = new Vector3();
239
+ let anchorX = 0;
240
+ let anchorY = 0;
241
+ /** One camera-facing quad covering the screen rectangle `x, y, w, h`, in whole pixels. */
242
+ const quad = (x: number, y: number, w: number, h: number, colour: Color) => {
243
+ _dummy.position
244
+ .copy(_base)
245
+ .addScaledVector(_right, (x + w / 2 - anchorX) / pixels)
246
+ .addScaledVector(up, (anchorY - y - h / 2) / pixels);
159
247
  _dummy.quaternion.copy(camera.quaternion);
160
- _dummy.position.set(entity.x, height, entity.z);
161
- _dummy.scale.set(width, BAR, 1);
162
- _dummy.updateMatrix();
163
- bars.setMatrixAt(barCount, _dummy.matrix);
164
- bars.setColorAt(barCount, _backing);
165
- barCount += 1;
166
- const fill = width * Math.max(0, Math.min(1, fraction));
167
- if (fill <= 0) return;
168
- _dummy.scale.set(fill, BAR * 0.7, 1);
169
- _dummy.updateMatrix();
170
- _dummy.translateX((fill - width) / 2);
248
+ _dummy.scale.set(w / pixels, h / pixels, 1);
171
249
  _dummy.updateMatrix();
172
250
  bars.setMatrixAt(barCount, _dummy.matrix);
173
251
  bars.setColorAt(barCount, colour);
174
252
  barCount += 1;
175
253
  };
176
254
 
255
+ /**
256
+ * One readout, AstraCraft's: a fill growing from the left inside a 1 px dark frame, hung from a
257
+ * point above the model, and an unframed build or queue line under it. Every edge sits on a whole
258
+ * pixel: a frame on a fractional position is shared by two pixel rows that trade coverage as the
259
+ * unit moves, which reads as a border that shimmers.
260
+ */
261
+ const pushBar = (entity: IEntity, fraction: number, colour: Color, work: number, tone: Color) => {
262
+ const at = pose(entity);
263
+ const lift = entity.building ? TYPES[entity.type].r + 1.3 : entity.air ? 2.1 : 3.1;
264
+ _base.set(at.x, terrainHeight(at.x, at.z) + at.altitude + lift, at.z);
265
+ _offset.copy(_base).sub(eye);
266
+ anchorX = halfWidth + _offset.dot(_right) * pixels;
267
+ anchorY = halfHeight - _offset.dot(up) * pixels;
268
+ const width = entity.building ? BAR_WIDTH.building : BAR_WIDTH.unit;
269
+ const left = Math.round(anchorX - width / 2);
270
+ const top = Math.round(anchorY);
271
+ quad(
272
+ left - BAR_BORDER,
273
+ top - BAR_BORDER,
274
+ width + 2 * BAR_BORDER,
275
+ BAR_HEIGHT + 2 * BAR_BORDER,
276
+ _backing,
277
+ );
278
+ const fill = Math.round(width * Math.max(0, Math.min(1, fraction)));
279
+ if (fill > 0) quad(left, top, fill, BAR_HEIGHT, colour);
280
+ const done = Math.round(width * Math.max(0, Math.min(1, work)));
281
+ if (done > 0) quad(left, top + WORK_DROP, done, WORK_HEIGHT, tone);
282
+ };
283
+
177
284
  let camera: Camera;
178
285
 
179
286
  return {
@@ -187,8 +294,26 @@ export function createArmy(
187
294
  slot.z = z;
188
295
  markerRings.setColorAt(index, _tint.set(hostile ? 0xff775a : 0x6cfbe2));
189
296
  },
190
- sync: (game, selected, time, dt, view) => {
297
+ step: (game) => {
298
+ for (const entity of game.entities) {
299
+ const slot = (entity.id % POSE_SLOTS) * POSE;
300
+ poses[slot] = entity.id;
301
+ poses[slot + 1] = entity.x;
302
+ poses[slot + 2] = entity.z;
303
+ poses[slot + 3] = entity.angle;
304
+ poses[slot + 4] = entity.altitude || 0;
305
+ }
306
+ },
307
+ sync: (game, selected, time, dt, view, pixelsPerMetre, share, from) => {
191
308
  camera = view;
309
+ pixels = pixelsPerMetre;
310
+ blend = Math.max(0, Math.min(1, share));
311
+ eye = from;
312
+ up.set(0, 1, 0).applyQuaternion(view.quaternion);
313
+ _right.set(1, 0, 0).applyQuaternion(view.quaternion);
314
+ const frame = view as OrthographicCamera;
315
+ halfWidth = (((frame.right - frame.left) / frame.zoom) * pixels) / 2;
316
+ halfHeight = (((frame.top - frame.bottom) / frame.zoom) * pixels) / 2;
192
317
  for (const entry of batches.values()) entry.list.length = 0;
193
318
  for (const entity of game.entities) {
194
319
  if (entity.garrisonId !== null) continue;
@@ -201,14 +326,15 @@ export function createArmy(
201
326
  for (let index = 0; index < list.length; index++) {
202
327
  const entity = list[index];
203
328
  if (entity === undefined) continue;
329
+ const at = pose(entity);
204
330
  _dummy.position.set(
205
- entity.x,
206
- terrainHeight(entity.x, entity.z) + (entity.altitude || 0) + bob(entity, time),
207
- entity.z,
331
+ at.x,
332
+ terrainHeight(at.x, at.z) + at.altitude + bob(entity, time),
333
+ at.z,
208
334
  );
209
335
  _dummy.rotation.set(
210
336
  0,
211
- entity.angle,
337
+ at.angle,
212
338
  entity.air && entity.moving ? Math.sin(time + entity.id) * 0.025 : 0,
213
339
  );
214
340
  // A site under construction grows out of the ground instead of appearing whole, which
@@ -221,10 +347,10 @@ export function createArmy(
221
347
  for (const part of entry.parts) {
222
348
  part.count = list.length;
223
349
  if (part.count === 0) continue;
350
+ // No bound is recomputed here: every part mesh is `frustumCulled = false`, so nothing
351
+ // reads one — and on the native engine the call crosses the bridge and walks every
352
+ // instance in the batch.
224
353
  upload(part.instanceMatrix, part.count);
225
- // The instance-aware bound, or the batch is culled by its own geometry's origin-sized
226
- // sphere and half the battlefield silently disappears.
227
- part.computeBoundingSphere();
228
354
  }
229
355
  }
230
356
 
@@ -236,9 +362,11 @@ export function createArmy(
236
362
  for (const entity of game.entities) {
237
363
  if (entity.garrisonId !== null || entity.team !== team) continue;
238
364
  if (team !== 0 && !game.visibleAt(entity.x, entity.z)) continue;
239
- if (!entity.building && !selected.has(entity.id)) continue;
240
- const radius = entity.r + 0.4;
241
- _dummy.position.set(entity.x, terrainHeight(entity.x, entity.z) + 0.13, entity.z);
365
+ // Only the selection is ringed: the painted apron already frames every building.
366
+ if (!selected.has(entity.id)) continue;
367
+ const radius = entity.r + 0.3;
368
+ const at = pose(entity);
369
+ _dummy.position.set(at.x, terrainHeight(at.x, at.z) + 0.13, at.z);
242
370
  _dummy.rotation.set(0, 0, 0);
243
371
  _dummy.scale.set(radius, 1, radius);
244
372
  _dummy.updateMatrix();
@@ -257,21 +385,19 @@ export function createArmy(
257
385
  // A unit earns a bar once something has happened to it, or once it is selected; a building
258
386
  // always has one, because its queue and its build site are the numbers being watched.
259
387
  if (!entity.building && !hurt && !selected.has(entity.id)) continue;
260
- const width = entity.building ? 6 : 3;
261
- const y =
262
- (entity.altitude || 0) +
263
- (entity.air ? 2.1 : entity.building ? TYPES[entity.type].r + 1.3 : 3.1);
388
+ const health = entity.maxHp > 0 ? entity.hp / entity.maxHp : 0;
389
+ const building = entity.building && !entity.built;
264
390
  pushBar(
265
391
  entity,
266
- width,
267
- entity.maxHp > 0 ? entity.hp / entity.maxHp : 0,
268
- y,
269
- entity.team > 0 ? _hostile : hurt ? _hurt : _friendly,
392
+ health,
393
+ entity.team > 0
394
+ ? (_teamFill[entity.team] ?? _friendly)
395
+ : health < 0.3
396
+ ? _hurt
397
+ : _friendly,
398
+ !entity.building ? 0 : building ? entity.progress : (entity.queue[0]?.progress ?? 0),
399
+ building ? _work : _queue,
270
400
  );
271
- if (entity.building && !entity.built)
272
- pushBar(entity, width, entity.progress, y - 0.9, _work);
273
- else if (entity.queue.length > 0)
274
- pushBar(entity, width, entity.queue[0]?.progress ?? 0, y - 0.9, _queue);
275
401
  }
276
402
  bars.count = barCount;
277
403
  upload(bars.instanceMatrix, barCount);
@@ -286,10 +412,13 @@ export function createArmy(
286
412
  _dummy.scale.setScalar(1 + (1 - slot.life / MARKER_LIFE) * 3);
287
413
  _dummy.updateMatrix();
288
414
  markerRings.setMatrixAt(live, _dummy.matrix);
415
+ markerBackings.setMatrixAt(live, _dummy.matrix);
289
416
  live += 1;
290
417
  }
291
418
  markerRings.count = live;
419
+ markerBackings.count = live;
292
420
  upload(markerRings.instanceMatrix, live);
421
+ upload(markerBackings.instanceMatrix, live);
293
422
  },
294
423
  dispose: () => {
295
424
  // The model geometries belong to `models`, which frees them; the materials are shared by
@@ -308,6 +437,9 @@ export function createArmy(
308
437
  (bars.material as MeshBasicMaterial).dispose();
309
438
  markerRings.geometry.dispose();
310
439
  (markerRings.material as MeshBasicMaterial).dispose();
440
+ markerBackings.geometry.dispose();
441
+ backingMaterial.dispose();
442
+ root.remove(markerBackings);
311
443
  },
312
444
  };
313
445
  }