create-threenative 0.2.10 → 0.2.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +227 -34
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +15 -10
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +14 -9
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +15 -10
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +15 -10
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +15 -10
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +72 -1
  420. package/templates/racing/src/scenes/Race.ts +9 -7
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +14 -9
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +14 -9
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +15 -10
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +15 -10
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +15 -10
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +15 -10
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +15 -10
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +14 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +27 -14
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +15 -10
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -0,0 +1,590 @@
1
+ import { WaveField } from "@threenative/core";
2
+ import {
3
+ Box3,
4
+ BoxGeometry,
5
+ type BufferGeometry,
6
+ CylinderGeometry,
7
+ Group,
8
+ IcosahedronGeometry,
9
+ InstancedMesh,
10
+ type Material,
11
+ MathUtils,
12
+ Matrix4,
13
+ Mesh,
14
+ type Object3D,
15
+ PlaneGeometry,
16
+ RingGeometry,
17
+ Vector3,
18
+ } from "three";
19
+ import { HERO_FEEL } from "../entities/Hero.js";
20
+ import type { WalkerKind } from "../entities/Walker.js";
21
+ import { buildCastle, buildSignpost, planarUv, wrapUv } from "../render/castle.js";
22
+ import { type IMeadow, plantIsland } from "../render/foliage.js";
23
+ import { farHills, paintGround } from "../render/ground.js";
24
+ import { mottle, patches } from "../render/materials.js";
25
+ import {
26
+ type ISurfaces,
27
+ groundMaterial,
28
+ lawnMaterial,
29
+ masonryMaterial,
30
+ rockMaterial,
31
+ texturedMaterial,
32
+ } from "../render/surface.js";
33
+ import { seaMaterial } from "../render/water.js";
34
+ import { TERRAIN_BOUNDS, buildTerrain } from "./terrain.js";
35
+
36
+ type Point = readonly [number, number, number];
37
+
38
+ /**
39
+ * The sea's swell, in metres and seconds: wavelengths with no common multiple so the pattern never
40
+ * repeats, each at the deep-water speed for its length (sqrt(g λ / 2π)). The two short ones are
41
+ * detail and fade out where a pixel covers more sea than they are long.
42
+ */
43
+ const SWELL = new WaveField({
44
+ waves: [
45
+ { amplitude: 0.09, direction: [0.8, 0.6], speed: 5.2, wavelength: 17.1 },
46
+ { amplitude: 0.07, direction: [0.3, 0.95], speed: 4.3, wavelength: 11.9 },
47
+ { amplitude: 0.05, direction: [0.95, -0.3], speed: 3.4, wavelength: 7.3 },
48
+ { amplitude: 0.035, direction: [-0.4, 0.9], speed: 2.9, wavelength: 5.3 },
49
+ { amplitude: 0.02, detail: true, direction: [0.6, -0.8], speed: 2.1, wavelength: 2.9 },
50
+ { amplitude: 0.012, detail: true, direction: [-0.9, -0.45], speed: 1.6, wavelength: 1.7 },
51
+ ],
52
+ });
53
+
54
+ /**
55
+ * One island course, laid out from `HERO_FEEL` rather than tuned the other way round. At full run a
56
+ * single jump rises about 3.1 m and carries 6.4 m; a double 3.4 m; a triple 6 m and 8.9 m; a long
57
+ * jump 14 m. So the summit's steps are 2.5 m (a single jump) and 3.5 m (a double or a ledge grab),
58
+ * the east islet sits 8.5 m off the shore (a long or a triple jump, never a single), and the shaft's
59
+ * walls stand 4 m apart, which one wall kick (18.6 m/s up, 7.2 m/s across) crosses 4.7 m higher.
60
+ */
61
+ export const COURSE = {
62
+ islandRadius: 36,
63
+ seaLevel: -2.5,
64
+ spawn: [0, 0, 14] as Point,
65
+ /** Facing at spawn: -Z, toward the summit. */
66
+ spawnYaw: 0,
67
+ summit: {
68
+ at: [-14, -22] as const,
69
+ tiers: [
70
+ [10, 2.5],
71
+ [6.5, 5],
72
+ [3.5, 8.5],
73
+ ] as const,
74
+ },
75
+ islet: { at: [50, 6] as const, radius: 6 },
76
+ /** The wall-kick shaft: a high slab you run under, a block you kick off, 4 m apart. */
77
+ shaft: { slabX: 8, blockX: 13, blockTop: 11, z: [-30, -22] as const },
78
+ pillar: { at: [-28, 18] as const, radius: 2.2, top: 7 },
79
+ /** The orbiting platform circles the pillar and climbs from 0.6 m to 7.2 m once a lap. */
80
+ platform: { radius: 5.5, low: 0.6, high: 7.2, period: 12, size: [3, 0.5, 3] as const },
81
+ /** The practice yard: a grabbable 3 m ledge and a 4.5 m wall, 1.5 m higher, that is not. */
82
+ yard: { ledge: [-20, 4] as const, wall: [-20, -6] as const, ledgeTop: 3, wallTop: 4.5 },
83
+ /** The castle's plateau on the northern headland, x, z, radius, height; the door faces south. */
84
+ castle: { pad: [2, -64, 14, 5] as const, door: [2, -56] as const },
85
+ /**
86
+ * Level ground, [x min, x max, z min, z max]: every scenario route runs on one of these, so the
87
+ * terrain keeps them flat at y = 0 and the jumps measured in `HERO_FEEL` keep their meaning.
88
+ */
89
+ routes: [
90
+ // The test lane, spawn to the summit's foot: the move, collect and combat scenarios.
91
+ [-6, 6, -20, 34],
92
+ // The shaft and the ground its camera watches from.
93
+ [-2, 19, -34, -15],
94
+ // The practice yard.
95
+ [-25, -14, -10, 8],
96
+ // The run-up to the islet gap.
97
+ [24, 40, 0, 12],
98
+ ] as const,
99
+ } as const;
100
+
101
+ export interface ICourse {
102
+ readonly group: Group;
103
+ /** Terrain height at (x, z): what pickups, walkers, checkpoints and a placed hero stand on. */
104
+ ground(x: number, z: number): number;
105
+ readonly spawn: Vector3;
106
+ readonly checkpoints: readonly Vector3[];
107
+ readonly coins: readonly Point[];
108
+ readonly gems: readonly Point[];
109
+ readonly seeds: Readonly<Record<"summit" | "shaft", Point>>;
110
+ /** Walker homes by kind, each far enough off every scenario's route that it never wanders onto one. */
111
+ readonly walkers: Readonly<Record<WalkerKind, readonly Point[]>>;
112
+ /** The orbiting platform's mesh, its origin at the deck's centre. */
113
+ readonly platform: Mesh;
114
+ /** The grass's distance thinning; the scene calls `meadow.update` with the camera each frame. */
115
+ readonly meadow: IMeadow;
116
+ /** Where the platform is at `time` seconds. */
117
+ platformAt(time: number, target: Vector3): Vector3;
118
+ /**
119
+ * Layout self-checks, read by `playtests/survives.playtest.json`: solids that neither stand on the
120
+ * ground nor touch a solid that does, pickups within 1 m of a tree, rock, bush or hedge, and the
121
+ * world's shape and landmarks (relief, slope shares, castle, grass, pebbles, signpost).
122
+ */
123
+ readonly audit: { readonly floating: number; readonly crowded: number } & Readonly<
124
+ Record<
125
+ | "castleParts"
126
+ | "grassTufts"
127
+ | "levelShare"
128
+ | "pathPebbles"
129
+ | "reliefMetres"
130
+ | "signposts"
131
+ | "steepShare",
132
+ number
133
+ >
134
+ >;
135
+ }
136
+
137
+ /** Counts floating solids and crowded pickups in a built course group (see `ICourse.audit`). */
138
+ function auditCourse(
139
+ group: Group,
140
+ pickups: readonly Point[],
141
+ ground: (x: number, z: number) => number,
142
+ ): { floating: number; crowded: number } {
143
+ group.updateMatrixWorld(true);
144
+ // The terrain is the ground itself; every other solid must reach it, or a solid that does.
145
+ const solids: Object3D[] = [];
146
+ group.traverse((object) => {
147
+ if (object.userData.solid === true && object.name !== "terrain") solids.push(object);
148
+ });
149
+ const boxes = solids.map((object) => new Box3().setFromObject(object).expandByScalar(0.02));
150
+ const centre = new Vector3();
151
+ const grounded = boxes.map((box) => {
152
+ box.getCenter(centre);
153
+ return box.min.y <= ground(centre.x, centre.z) + 0.05;
154
+ });
155
+ for (let changed = true; changed; ) {
156
+ changed = false;
157
+ boxes.forEach((box, i) => {
158
+ if (grounded[i] || !boxes.some((other, j) => grounded[j] && other.intersectsBox(box))) return;
159
+ grounded[i] = true;
160
+ changed = true;
161
+ });
162
+ }
163
+ // Props are the shadow casters nobody walks on; the orbiting platform moves, so it is skipped.
164
+ const props: Box3[] = [];
165
+ const matrix = new Matrix4();
166
+ group.traverse((object) => {
167
+ if (!(object instanceof Mesh) || !object.castShadow || object.userData.solid === true) return;
168
+ if (object.name === "orbiting-platform") return;
169
+ if (!(object instanceof InstancedMesh)) {
170
+ props.push(new Box3().setFromObject(object));
171
+ return;
172
+ }
173
+ // `new Box3().copy`, not `clone`: the owned engine's Box3 has no `clone` (2026-10-24).
174
+ object.geometry.computeBoundingBox();
175
+ const local = object.geometry.boundingBox;
176
+ if (local === null) return;
177
+ for (let i = 0; i < object.count; i += 1) {
178
+ object.getMatrixAt(i, matrix);
179
+ matrix.premultiply(object.matrixWorld);
180
+ props.push(new Box3().copy(local).applyMatrix4(matrix));
181
+ }
182
+ });
183
+ const point = new Vector3();
184
+ const crowded = pickups.filter((at) =>
185
+ props.some((box) => box.distanceToPoint(point.set(...at)) < 1),
186
+ ).length;
187
+ return { crowded, floating: grounded.filter((g) => !g).length };
188
+ }
189
+
190
+ /**
191
+ * A boulder `size` metres across its middle: an icosphere pushed in and out by a few seeded waves and
192
+ * flattened a little, smooth-shaded, so it reads as weathered rock and not as a faceted gem.
193
+ */
194
+ function boulderGeometry(size: number, rng: () => number): BufferGeometry {
195
+ const geometry = new IcosahedronGeometry(size, 2);
196
+ const position = geometry.attributes.position;
197
+ const waves = Array.from({ length: 4 }, () => [rng() * 6, rng() * 6, rng() * 6, 1.5 + rng() * 2]);
198
+ for (let i = 0; i < (position?.count ?? 0); i += 1) {
199
+ const x = (position?.getX(i) ?? 0) / size;
200
+ const y = (position?.getY(i) ?? 0) / size;
201
+ const z = (position?.getZ(i) ?? 0) / size;
202
+ let k = 1;
203
+ for (const [a = 0, b = 0, c = 0, f = 2] of waves)
204
+ k += 0.07 * Math.sin(x * f + a) * Math.sin(y * f + b) * Math.sin(z * f + c) * 2;
205
+ position?.setXYZ(i, x * size * k, y * size * k * 0.72, z * size * k);
206
+ }
207
+ geometry.computeVertexNormals();
208
+ return geometry;
209
+ }
210
+
211
+ export function makeRng(seed: number): () => number {
212
+ let state = seed >>> 0;
213
+ return () => {
214
+ state = (state * 1664525 + 1013904223) >>> 0;
215
+ return state / 0x1_0000_0000;
216
+ };
217
+ }
218
+
219
+ /**
220
+ * `surfaces` are the loaded textures (`loadSurfaces` in surface.ts); `grassShare` is the share of
221
+ * grass tufts the quality tier draws (`GRASS_SHARE` in `quality.ts`).
222
+ */
223
+ export function buildCourse(rng: () => number, surfaces: ISurfaces, grassShare = 1): ICourse {
224
+ const group = new Group();
225
+ group.name = "course";
226
+ const [doorX, doorZ] = COURSE.castle.door;
227
+ const [sx, sz] = COURSE.summit.at;
228
+ const [px, pz] = COURSE.pillar.at;
229
+ // The dirt paths: spawn along the coin line to the summit's ramp, and a branch up to the castle.
230
+ const paths = [
231
+ [
232
+ [0, 33],
233
+ [0, 12],
234
+ [-2.5, 2],
235
+ [-5.6, -7.6],
236
+ ],
237
+ [
238
+ [-2.5, 2],
239
+ [-1, -12],
240
+ [2.5, -24],
241
+ [3, -36],
242
+ [3, -46],
243
+ [doorX, doorZ + 1],
244
+ ],
245
+ ] as const;
246
+ const terrain = buildTerrain({
247
+ level: [
248
+ ...COURSE.routes,
249
+ // The pillar with the platform's orbit, and the summit's foot with its ramp.
250
+ [px, pz, COURSE.pillar.radius + COURSE.platform.radius + 1.5],
251
+ [sx, sz, COURSE.summit.tiers[0][0] + 2],
252
+ ],
253
+ pad: COURSE.castle.pad,
254
+ paths,
255
+ seaLevel: COURSE.seaLevel,
256
+ });
257
+ const ground = (x: number, z: number): number => terrain.ground(x, z);
258
+ /** A point `above` metres over the ground at (x, z). */
259
+ const onGround = (x: number, above: number, z: number): Point => [x, ground(x, z) + above, z];
260
+ const grass = lawnMaterial(surfaces);
261
+ // Blocks and drum cliffs are the castle's coursed stone, so the whole course is one masonry; its
262
+ // grime band sits on the level ground at y = 0.
263
+ const rock = masonryMaterial(surfaces, 0);
264
+ const boulder = rockMaterial(surfaces);
265
+ const wood = texturedMaterial(surfaces, "planks");
266
+ // A drum's turf edge is vertical: the lawn's top-down sampling would smear it into stripes.
267
+ const turfEdge = texturedMaterial(surfaces, "grass", { roughness: 0.94 });
268
+ /** Walkable: `Play.ts` builds a fixed trimesh body from every mesh tagged `solid`. */
269
+ const solid = (
270
+ geometry: BufferGeometry,
271
+ material: Material,
272
+ variance = 0.12,
273
+ courses = 0,
274
+ ): Mesh => {
275
+ const mesh = new Mesh(
276
+ material === grass
277
+ ? patches(geometry)
278
+ : mottle(geometry, variance, rng, material === rock, courses),
279
+ material,
280
+ );
281
+ mesh.castShadow = true;
282
+ mesh.receiveShadow = true;
283
+ mesh.userData.solid = true;
284
+ group.add(mesh);
285
+ return mesh;
286
+ };
287
+ /**
288
+ * A stone block cut into 1 m courses, each its own tint, with a faint per-block jitter, so a tower
289
+ * reads as masonry rows (a strong per-block tint read as a checkerboard).
290
+ */
291
+ const box = (min: Point, max: Point, material: Material = rock): Mesh => {
292
+ const size = [max[0] - min[0], max[1] - min[1], max[2] - min[2]] as const;
293
+ const geometry = new BoxGeometry(
294
+ size[0],
295
+ size[1],
296
+ size[2],
297
+ Math.ceil(size[0]),
298
+ Math.ceil(size[1]),
299
+ Math.ceil(size[2]),
300
+ );
301
+ geometry.translate((min[0] + max[0]) / 2, (min[1] + max[1]) / 2, (min[2] + max[2]) / 2);
302
+ return solid(planarUv(geometry, 4), material, 0.06);
303
+ };
304
+ /** A grass-capped rock drum: the shape of every tier, islet and pillar. */
305
+ const drum = (x: number, z: number, radius: number, top: number, bottom: number): void => {
306
+ const segments = Math.max(16, Math.round(radius * 4));
307
+ const cliff = new CylinderGeometry(
308
+ radius,
309
+ radius * 0.92,
310
+ top - bottom - 0.3,
311
+ segments,
312
+ 3,
313
+ true,
314
+ );
315
+ cliff.translate(x, (top - 0.3 + bottom) / 2, z);
316
+ solid(wrapUv(cliff, radius, 4), rock, 0.12);
317
+ const lip = new CylinderGeometry(radius + 0.15, radius + 0.15, 0.4, segments, 1, true);
318
+ lip.translate(x, top - 0.2, z);
319
+ solid(wrapUv(lip, radius, 2), turfEdge, 0);
320
+ // The lawn is a disc of concentric rings, not a cylinder's cap: a cap is one fan of long
321
+ // triangles from the centre, and any per-vertex tint on it reads as radial streaks.
322
+ const lawn = new RingGeometry(0, radius + 0.15, segments, Math.ceil(radius / 2.5));
323
+ lawn.rotateX(-Math.PI / 2);
324
+ lawn.translate(x, top, z);
325
+ solid(lawn, grass, 0);
326
+ };
327
+
328
+ // The island: one terrain mesh, walkable, painted grass, path, sand and rock. Then the sea.
329
+ const land = new Mesh(
330
+ paintGround(
331
+ terrain.field.toGeometry().translate(terrain.field.origin.x, 0, terrain.field.origin.z),
332
+ { ...terrain, seaLevel: COURSE.seaLevel },
333
+ ),
334
+ groundMaterial(surfaces),
335
+ );
336
+ land.name = "terrain";
337
+ land.receiveShadow = true;
338
+ land.castShadow = true;
339
+ land.userData.solid = true;
340
+ group.add(land);
341
+ // The sea's depth map covers the island and the islet; a drum rising from the sea is land in it.
342
+ // The terrain stops at its bounds with the beach shelf still shallow, so the bed slopes down to
343
+ // the open sea's floor over the last 12 m or the shallows end on a straight line. The islet's
344
+ // beach rings reach 2 m past its cliff, and a shelf falls 1 m in 2 past them.
345
+ const [ix, iz] = COURSE.islet.at;
346
+ const { minX, maxX, minZ, maxZ } = TERRAIN_BOUNDS;
347
+ const openSea = ground(maxX + 1, 0);
348
+ const sea = new Mesh(
349
+ new PlaneGeometry(1600, 1600).rotateX(-Math.PI / 2),
350
+ seaMaterial(
351
+ {
352
+ height: (x, z) => {
353
+ const beach = Math.hypot(x - ix, z - iz) - COURSE.islet.radius - 2;
354
+ if (beach <= 0) return COURSE.seaLevel + 1;
355
+ const edge = Math.min(x - minX, maxX - x, z - minZ, maxZ - z);
356
+ const bed = MathUtils.lerp(openSea, ground(x, z), MathUtils.smoothstep(edge, 0, 12));
357
+ return Math.max(bed, COURSE.seaLevel - beach * 0.5);
358
+ },
359
+ minX: -80,
360
+ minZ: -110,
361
+ seaLevel: COURSE.seaLevel,
362
+ size: 180,
363
+ },
364
+ SWELL,
365
+ ),
366
+ );
367
+ sea.position.y = COURSE.seaLevel;
368
+ group.add(farHills(COURSE.seaLevel));
369
+ sea.receiveShadow = true;
370
+ group.add(sea);
371
+
372
+ // The summit: three tiers, then the Sunseed on top.
373
+ for (const [radius, top] of COURSE.summit.tiers) drum(sx, sz, radius, top, -0.5);
374
+ // A plank ramp onto the first tier, so the climb has a walking start: planar UVs before the tilt
375
+ // lay the boards across it, 0.3 m each.
376
+ const ramp = planarUv(new BoxGeometry(3, 0.5, 8, 2, 1, 4), 2.4);
377
+ ramp.rotateX(Math.atan2(2.5, 7.5));
378
+ ramp.translate(sx + 8, 1.15, sz + 9.5);
379
+ solid(ramp, wood);
380
+
381
+ // The east islet, past a gap only a long jump or a triple jump crosses.
382
+ drum(COURSE.islet.at[0], COURSE.islet.at[1], COURSE.islet.radius, 0, -10);
383
+
384
+ // The wall-kick shaft. Run in under the slab, kick off the block, kick off the slab, and the third
385
+ // kick carries you over the block's top. The slab starts 5 m up: a running single jump's head
386
+ // (3 m apex + 1.6 m of hero) passes under it.
387
+ const { slabX, blockX, blockTop, z } = COURSE.shaft;
388
+ box([slabX, 5, z[0]], [slabX + 1, 16, z[1]]);
389
+ box([blockX, 0, z[0]], [blockX + 4, blockTop, z[1]]);
390
+ // Its ends are 3 m kerbs, not walls: the open sides are where the camera watches the climb from.
391
+ box([slabX, 0, z[0] - 0.6], [blockX, 3, z[0]]);
392
+ box([slabX, 0, z[1]], [blockX, 3, z[1] + 0.6]);
393
+ // Two piers carry the slab down to the ground at its ends, an arch you run through.
394
+ box([slabX, 0, z[0] - 0.6], [slabX + 1, 16, z[0]]);
395
+ box([slabX, 0, z[1]], [slabX + 1, 16, z[1] + 0.6]);
396
+
397
+ // The pillar the orbiting platform rises to.
398
+ drum(px, pz, COURSE.pillar.radius, COURSE.pillar.top, -0.5);
399
+ const deck = planarUv(new BoxGeometry(...COURSE.platform.size), 2.4);
400
+ const platform = new Mesh(deck, wood);
401
+ platform.castShadow = true;
402
+ platform.receiveShadow = true;
403
+ platform.name = "orbiting-platform";
404
+ group.add(platform);
405
+ const { radius, low, high, period } = COURSE.platform;
406
+ const platformAt = (time: number, target: Vector3): Vector3 => {
407
+ const angle = (time / period) * Math.PI * 2;
408
+ return target.set(
409
+ px + Math.cos(angle) * radius,
410
+ low + ((high - low) * (1 - Math.cos(angle))) / 2,
411
+ pz + Math.sin(angle) * radius,
412
+ );
413
+ };
414
+ platformAt(0, platform.position);
415
+
416
+ // The practice yard.
417
+ const { ledge, wall, ledgeTop, wallTop } = COURSE.yard;
418
+ box([ledge[0] - 2, 0, ledge[1] - 3], [ledge[0] + 2, ledgeTop, ledge[1] + 3]);
419
+ box([wall[0] - 2, 0, wall[1] - 3], [wall[0] + 2, wallTop, wall[1] + 3]);
420
+
421
+ const coins: Point[] = [];
422
+ // A line from spawn to the summit's ramp, an arc over the islet gap, a ring round the pillar.
423
+ for (let i = 0; i < 10; i += 1) coins.push(onGround(-1 - i * 0.6, 1, 10 - i * 2));
424
+ for (let i = 0; i < 8; i += 1) {
425
+ const t = (i + 1) / 9;
426
+ coins.push([35.5 + t * 8.5, 1.2 + Math.sin(t * Math.PI) * 3.2, 6]);
427
+ }
428
+ for (let i = 0; i < 10; i += 1) {
429
+ const a = (i / 10) * Math.PI * 2;
430
+ coins.push(onGround(px + Math.cos(a) * 3.5, 1, pz + Math.sin(a) * 3.5));
431
+ }
432
+ for (let i = 0; i < 6; i += 1) coins.push(onGround(2 + i * 1.2, 1, -26));
433
+ for (let i = 0; i < 6; i += 1) {
434
+ const a = (i / 6) * Math.PI * 2;
435
+ coins.push([sx + Math.cos(a) * 8.2, 3.5, sz + Math.sin(a) * 8.2]);
436
+ }
437
+ const gems: Point[] = [
438
+ [48, 1.2, 4],
439
+ [52, 1.2, 8],
440
+ [50, 1.2, 6],
441
+ [px, COURSE.pillar.top + 1.2, pz],
442
+ [px - 4, COURSE.platform.high + 1.5, pz],
443
+ [sx + 5, COURSE.summit.tiers[1][1] + 1.2, sz],
444
+ [ledge[0], ledgeTop + 1.2, ledge[1]],
445
+ onGround(-6, 1.2, 28),
446
+ ];
447
+ const seeds = {
448
+ shaft: [blockX + 2, blockTop + 1.4, (z[0] + z[1]) / 2] as Point,
449
+ summit: [sx, COURSE.summit.tiers[2][1] + 1.4, sz] as Point,
450
+ };
451
+ /** Every pickup: scenery keeps a clear metre round each, so none hangs inside a tree or a rock. */
452
+ const pickups = [...coins, ...gems, ...Object.values(seeds)];
453
+ const nearPickup = (x: number, zz: number, reach: number): boolean =>
454
+ pickups.some(([kx, , kz]) => Math.hypot(x - kx, zz - kz) < reach);
455
+
456
+ // Scenery: boulders where the ground breaks into a slope, never on a route and never inside a
457
+ // landmark (a rock through the shaft's wall, under the pillar's coin ring or in the castle).
458
+ const keepOut = [
459
+ [px, pz, COURSE.pillar.radius + 5],
460
+ [(slabX + blockX + 4) / 2, (z[0] + z[1]) / 2, 8],
461
+ [ledge[0], ledge[1], 5],
462
+ [wall[0], wall[1], 5],
463
+ [COURSE.castle.pad[0], COURSE.castle.pad[1], COURSE.castle.pad[2] + 2],
464
+ [sx, sz, COURSE.summit.tiers[0][0] + 1],
465
+ ] as const;
466
+ const onRoute = (x: number, zz: number, w: number): boolean =>
467
+ COURSE.routes.some(
468
+ ([x0, x1, z0, z1]) => x > x0 - w && x < x1 + w && zz > z0 - w && zz < z1 + w,
469
+ );
470
+ const boulders: [number, number, number][] = [];
471
+ for (let i = 0; i < 60 && boulders.length < 16; i += 1) {
472
+ const x = TERRAIN_BOUNDS.minX + rng() * (TERRAIN_BOUNDS.maxX - TERRAIN_BOUNDS.minX);
473
+ const zz = TERRAIN_BOUNDS.minZ + rng() * (TERRAIN_BOUNDS.maxZ - TERRAIN_BOUNDS.minZ);
474
+ const size = 0.7 + rng() * 1.1;
475
+ const slope = terrain.flatness(x, zz);
476
+ // A rock is up to 2 m across its middle: 3.5 m keeps a metre clear of every pickup.
477
+ if (slope > 0.93 || slope < 0.6 || ground(x, zz) < COURSE.seaLevel + 1) continue;
478
+ if (keepOut.some(([kx, kz, kr]) => Math.hypot(x - kx, zz - kz) < kr) || nearPickup(x, zz, 3.5))
479
+ continue;
480
+ if (onRoute(x, zz, 2) || terrain.pathDistance(x, zz) < size + 1.5) continue;
481
+ const stone = new Mesh(boulderGeometry(size, rng), boulder);
482
+ stone.position.set(x, ground(x, zz) + size * 0.2, zz);
483
+ stone.rotation.set(rng() * 3, rng() * 3, rng() * 3);
484
+ stone.castShadow = true;
485
+ stone.receiveShadow = true;
486
+ group.add(stone);
487
+ boulders.push([x, zz, size + 0.3]);
488
+ }
489
+
490
+ // The castle on its plateau, its door at the end of the castle path; its stone is walkable.
491
+ const castle = buildCastle(surfaces, COURSE.castle.pad[3]);
492
+ castle.group.position.set(doorX, COURSE.castle.pad[3], doorZ);
493
+ castle.stone.userData.solid = true;
494
+ group.add(castle.group);
495
+ // The arrow sign beside the path near spawn, its board broadside to a camera behind the hero.
496
+ const sign = buildSignpost(surfaces);
497
+ sign.position.set(-4.2, ground(-4.2, 9.5), 9.5);
498
+ group.add(sign);
499
+
500
+ // Planting (`render/foliage.ts`): never on a route a scenario runs, a landmark or a boulder.
501
+ const taken = [...keepOut, ...boulders] as const;
502
+ const planting = plantIsland({
503
+ bounds: TERRAIN_BOUNDS,
504
+ clear: (x, zz, w) =>
505
+ !onRoute(x, zz, w) &&
506
+ !taken.some(([kx, kz, kr]) => Math.hypot(x - kx, zz - kz) < kr + w) &&
507
+ !nearPickup(x, zz, w + 1),
508
+ flatness: terrain.flatness,
509
+ grassShare,
510
+ ground,
511
+ pathDistance: terrain.pathDistance,
512
+ lawns: [
513
+ ...COURSE.summit.tiers.map(([r, top]) => [sx, sz, r, top] as const),
514
+ [px, pz, COURSE.pillar.radius, COURSE.pillar.top] as const,
515
+ [COURSE.islet.at[0], COURSE.islet.at[1], COURSE.islet.radius, 0] as const,
516
+ ],
517
+ rng,
518
+ seaLevel: COURSE.seaLevel,
519
+ surfaces,
520
+ // The islet's drum cliff radius at the waterline: it narrows to 92% over its height.
521
+ shores: [[COURSE.islet.at[0], COURSE.islet.at[1], COURSE.islet.radius * 0.98]],
522
+ });
523
+ group.add(planting.group);
524
+
525
+ // The world's shape on a 1 m grid of land: the climb from the shore to the top, the share of
526
+ // ground too steep to walk, and the share left dead level for the routes.
527
+ let landCells = 0;
528
+ let steep = 0;
529
+ let level = 0;
530
+ let bottom = Number.POSITIVE_INFINITY;
531
+ let top = Number.NEGATIVE_INFINITY;
532
+ for (let zz = TERRAIN_BOUNDS.minZ + 0.5; zz < TERRAIN_BOUNDS.maxZ; zz += 1) {
533
+ for (let x = TERRAIN_BOUNDS.minX + 0.5; x < TERRAIN_BOUNDS.maxX; x += 1) {
534
+ const y = ground(x, zz);
535
+ if (y < COURSE.seaLevel) continue;
536
+ landCells += 1;
537
+ bottom = Math.min(bottom, y);
538
+ top = Math.max(top, y);
539
+ if (terrain.flatness(x, zz) < 0.7) steep += 1;
540
+ if (Math.abs(y) < 0.02) level += 1;
541
+ }
542
+ }
543
+ let castleParts = 0;
544
+ castle.group.traverse((object) => {
545
+ if (object instanceof Mesh) castleParts += 1;
546
+ });
547
+ const pebbles = planting.group.getObjectByName("path-pebbles");
548
+ const world = {
549
+ castleParts,
550
+ grassTufts: planting.meadow.total,
551
+ levelShare: level / landCells,
552
+ pathPebbles: pebbles instanceof InstancedMesh ? pebbles.count : 0,
553
+ reliefMetres: top - bottom,
554
+ signposts: group.getObjectByName("signpost") === undefined ? 0 : 1,
555
+ steepShare: steep / landCells,
556
+ };
557
+
558
+ return {
559
+ audit: { ...auditCourse(group, pickups, ground), ...world },
560
+ checkpoints: [
561
+ new Vector3(...COURSE.spawn),
562
+ new Vector3(...onGround(sx + 9, 0, sz + 13)),
563
+ new Vector3(...onGround(slabX - 6, 0, -26)),
564
+ new Vector3(COURSE.islet.at[0], 0, COURSE.islet.at[1]),
565
+ ],
566
+ coins,
567
+ gems,
568
+ ground,
569
+ group,
570
+ meadow: planting.meadow,
571
+ platform,
572
+ platformAt,
573
+ seeds,
574
+ spawn: new Vector3(...onGround(COURSE.spawn[0], 0.85, COURSE.spawn[2])),
575
+ walkers: {
576
+ bumblet: [
577
+ onGround(6, 0, 2),
578
+ onGround(-8, 0, -4),
579
+ [sx + 2, COURSE.summit.tiers[0][1], sz + 7],
580
+ [50, 0, 4],
581
+ onGround(-12, 0, 12),
582
+ ],
583
+ hopper: [onGround(20, 0, 18), onGround(24, 0, -12)],
584
+ thornback: [onGround(-30, 0, -2), onGround(13, 0, 26)],
585
+ },
586
+ };
587
+ }
588
+
589
+ /** The fall that ends in the sea, from `HERO_FEEL`, for the scene's respawn test. */
590
+ export const KILL_PLANE = HERO_FEEL.killPlane;