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
@@ -0,0 +1,240 @@
1
+ import { BoxGeometry, Group, IcosahedronGeometry, Mesh, type PointLight, Vector3 } from "three";
2
+ import { instanced } from "../render/foliage.js";
3
+ import { torch } from "../render/lighting.js";
4
+ import { lit, mottle, worldMaterials } from "../render/materials.js";
5
+ import { C } from "../render/palette.js";
6
+ import { createTorch } from "../render/props.js";
7
+ import { surfaced } from "../render/surface.js";
8
+
9
+ /** The Hollow is built 100 m east of the clearing; the cave mouth carries Wren between them. */
10
+ export const HOLLOW_X = 100;
11
+
12
+ export interface IHollow {
13
+ readonly group: Group;
14
+ readonly torches: readonly PointLight[];
15
+ /** Where Wren arrives from the cave mouth, and respawns until she passes the locked door. */
16
+ readonly entry: Vector3;
17
+ /** Walking into this point leads back out to the clearing. */
18
+ readonly exit: Vector3;
19
+ readonly guards: readonly Vector3[];
20
+ readonly flickers: readonly Vector3[];
21
+ readonly thornbacks: readonly { readonly at: Vector3; readonly yaw: number }[];
22
+ readonly block: Vector3;
23
+ readonly switchAt: Vector3;
24
+ readonly grate: { readonly at: Vector3; readonly yaw: number; readonly width: number };
25
+ readonly keyChest: { readonly at: Vector3; readonly yaw: number };
26
+ readonly lockedDoor: { readonly at: Vector3; readonly width: number };
27
+ /** Where Wren respawns once the locked door is behind her. */
28
+ readonly bossCheckpoint: Vector3;
29
+ readonly warden: Vector3;
30
+ /** True when a point is inside the Hollow's footprint (the zone the slower run speed covers). */
31
+ contains(point: Vector3): boolean;
32
+ }
33
+
34
+ /**
35
+ * The Moss Hollow: three rooms in a line running north, under one ceiling.
36
+ *
37
+ * - Guard room (z 0 to -12): a Mossling, a Flicker and a Thornback.
38
+ * - Block room (z -12 to -26): the push block two cells south of the floor switch, which sits
39
+ * against the north wall; the grate on the east wall over the alcove with the small-key chest;
40
+ * the locked door in the north wall.
41
+ * - Warden room (z -26 to -44): 16 m by 18 m of open floor for the Stone Warden to charge across.
42
+ *
43
+ * Grid cells are 1 m with integer centres, so the block lands exactly on the switch.
44
+ */
45
+ export function buildHollow(rng: () => number): IHollow {
46
+ const X = HOLLOW_X;
47
+ const group = new Group();
48
+ group.name = "hollow";
49
+ const materials = worldMaterials();
50
+ const wallMaterial = surfaced(C.stoneDark, "stone-wall", {
51
+ flat: true,
52
+ vertexColors: true,
53
+ strength: 0.75,
54
+ });
55
+ const box = (
56
+ x0: number,
57
+ x1: number,
58
+ z0: number,
59
+ z1: number,
60
+ y0: number,
61
+ y1: number,
62
+ material = wallMaterial,
63
+ ): Mesh => {
64
+ const w = x1 - x0;
65
+ const h = y1 - y0;
66
+ const d = z1 - z0;
67
+ const segments = (n: number): number => Math.max(1, Math.min(10, Math.round(n / 1.2)));
68
+ const geometry = mottle(
69
+ new BoxGeometry(w, h, d, segments(w), segments(h), segments(d)),
70
+ 0.24,
71
+ rng,
72
+ );
73
+ geometry.translate(X + (x0 + x1) / 2, (y0 + y1) / 2, (z0 + z1) / 2);
74
+ const mesh = new Mesh(geometry, material);
75
+ mesh.userData.solid = true;
76
+ mesh.castShadow = true;
77
+ mesh.receiveShadow = true;
78
+ group.add(mesh);
79
+ return mesh;
80
+ };
81
+ const H = 5;
82
+ /** Walls run up into the ceiling slab, so no seam between them lets light through. */
83
+ const TOP = H + 0.3;
84
+ // Floor and ceiling. Coordinates below are relative to X. The floor slab is the collider; what
85
+ // Wren sees is a bed of flagstones (below) on dark grout just under it.
86
+ box(-10, 12, -46, 4, -1, 0, materials.stone).visible = false;
87
+ box(-10, 12, -46, 4, H, H + 0.6);
88
+ // Entrance tunnel, and the guard room's south wall around its doorway.
89
+ box(-2.5, -1.5, 0, 3.5, 0, TOP);
90
+ box(1.5, 2.5, 0, 3.5, 0, TOP);
91
+ box(-2.5, 2.5, 3.5, 4.5, 0, TOP);
92
+ box(-7, -1.5, -0.5, 0.5, 0, TOP);
93
+ box(1.5, 7, -0.5, 0.5, 0, TOP);
94
+ // Guard room sides.
95
+ box(-7, -6, -12.5, 0.5, 0, TOP);
96
+ box(6, 7, -12.5, 0.5, 0, TOP);
97
+ // Wall between the guard room and the block room, open in the middle.
98
+ box(-7, -1.5, -12.5, -11.5, 0, TOP);
99
+ box(1.5, 7, -12.5, -11.5, 0, TOP);
100
+ // Block room sides; the east side is open over the alcove (z -20 to -16).
101
+ box(-7, -6, -26.5, -12.5, 0, TOP);
102
+ box(6, 7, -16, -12.5, 0, TOP);
103
+ box(6, 7, -26.5, -20, 0, TOP);
104
+ // The alcove behind the grate.
105
+ box(7, 11, -16, -15, 0, TOP);
106
+ box(7, 11, -21, -20, 0, TOP);
107
+ box(10, 11, -20, -16, 0, TOP);
108
+ box(6, 7, -20, -16, 3, TOP);
109
+ // North wall of the block room, the locked door's frame in it (x 0 to 2), and its lintel.
110
+ box(-9, 0, -26.5, -25.5, 0, TOP);
111
+ box(2, 9, -26.5, -25.5, 0, TOP);
112
+ box(0, 2, -26.5, -25.5, 3, TOP);
113
+ // Warden room.
114
+ box(-9, -8, -45, -26.5, 0, TOP);
115
+ box(8, 9, -45, -26.5, 0, TOP);
116
+ box(-9, 9, -45, -44, 0, TOP);
117
+
118
+ // Torches: each a flame mesh and a short-range point light.
119
+ const torches: PointLight[] = [];
120
+ const sconce = (x: number, z: number, yaw: number): void => {
121
+ const flame = createTorch();
122
+ flame.position.set(X + x, 2.4, z);
123
+ flame.rotation.z = yaw;
124
+ group.add(flame);
125
+ const light = torch();
126
+ light.position.set(X + x, 2.9, z);
127
+ group.add(light);
128
+ torches.push(light);
129
+ };
130
+ sconce(-5.6, -6, 0);
131
+ sconce(5.6, -6, 0);
132
+ sconce(-5.6, -19, 0);
133
+ sconce(5.6, -23, 0);
134
+ sconce(9.6, -18, 0);
135
+ sconce(-2, -25, 0);
136
+ sconce(4, -25, 0);
137
+ sconce(-7.6, -33, 0);
138
+ sconce(7.6, -33, 0);
139
+ sconce(-7.6, -41, 0);
140
+ sconce(7.6, -41, 0);
141
+
142
+ // The flagstone floor: 1 m slabs in three shades, each a little off the grid, on dark grout,
143
+ // and hairline cracks across some of them. Four draws for the whole Hollow.
144
+ const grout = new Mesh(new BoxGeometry(22, 0.1, 50).translate(X + 1, -0.052, -21), lit(C.grout));
145
+ grout.receiveShadow = true;
146
+ group.add(grout);
147
+ const shades: [number, number, number, number, number, number, number, number, number][][] = [
148
+ [],
149
+ [],
150
+ [],
151
+ ];
152
+ const cracks: [number, number, number, number, number, number, number, number, number][] = [];
153
+ for (let x = -10; x < 12; x += 1) {
154
+ for (let z = -46; z < 4; z += 1) {
155
+ const cx = X + x + 0.5 + (rng() - 0.5) * 0.04;
156
+ const cz = z + 0.5 + (rng() - 0.5) * 0.04;
157
+ shades[Math.floor(rng() * 3)]?.push([
158
+ cx,
159
+ -0.012,
160
+ cz,
161
+ 0.94,
162
+ 1,
163
+ 0.94,
164
+ 0,
165
+ (rng() - 0.5) * 0.04,
166
+ 0,
167
+ ]);
168
+ if (rng() < 0.12)
169
+ cracks.push([
170
+ cx + (rng() - 0.5) * 0.4,
171
+ 0.0135,
172
+ cz + (rng() - 0.5) * 0.4,
173
+ 1,
174
+ 1,
175
+ 0.3 + rng() * 0.5,
176
+ 0,
177
+ rng() * Math.PI,
178
+ 0,
179
+ ]);
180
+ }
181
+ }
182
+ const slab = new BoxGeometry(1, 0.05, 1);
183
+ [C.flagstone, C.flagstoneDark, C.flagstoneLight].forEach((shade, i) => {
184
+ group.add(
185
+ instanced(
186
+ slab,
187
+ surfaced(shade, "rock", { flat: true, strength: 0.35 }),
188
+ shades[i] ?? [],
189
+ false,
190
+ ),
191
+ );
192
+ });
193
+ group.add(instanced(new BoxGeometry(0.025, 0.004, 1), lit(C.grout), cracks, false));
194
+
195
+ // Moss mounds at the foot of the walls: soft raised cushions in two greens, not flat paint.
196
+ const mounds: [number, number, number, number, number, number, number, number, number][][] = [
197
+ [],
198
+ [],
199
+ ];
200
+ for (let i = 0; i < 46; i += 1) {
201
+ const room = rng();
202
+ const z = -1 - room * 42;
203
+ const wall = z < -26.5 ? 7.4 : 5.4;
204
+ const s = 0.35 + rng() * 0.5;
205
+ mounds[i % 2]?.push([
206
+ X + (rng() < 0.5 ? -wall : wall) + (rng() - 0.5) * 0.5,
207
+ 0,
208
+ z,
209
+ s * (1.2 + rng()),
210
+ s * (0.3 + rng() * 0.25),
211
+ s * (0.9 + rng() * 0.6),
212
+ 0,
213
+ rng() * Math.PI,
214
+ 0,
215
+ ]);
216
+ }
217
+ const cushion = new IcosahedronGeometry(1, 1);
218
+ group.add(
219
+ instanced(cushion, lit(C.moss, { flat: true }), mounds[0] ?? [], false),
220
+ instanced(cushion, lit(C.mossLight, { flat: true }), mounds[1] ?? [], false),
221
+ );
222
+
223
+ return {
224
+ block: new Vector3(X - 3, 0, -23),
225
+ bossCheckpoint: new Vector3(X + 1, 0, -28),
226
+ contains: (point) => point.x > X - 15 && point.x < X + 15,
227
+ entry: new Vector3(X, 0, -2),
228
+ exit: new Vector3(X, 0, 2.6),
229
+ grate: { at: new Vector3(X + 6.5, 0, -18), width: 4, yaw: Math.PI / 2 },
230
+ group,
231
+ guards: [new Vector3(X + 2, 0, -8)],
232
+ flickers: [new Vector3(X - 4, 0, -5)],
233
+ thornbacks: [{ at: new Vector3(X + 4, 0, -9), yaw: -Math.PI / 2 }],
234
+ keyChest: { at: new Vector3(X + 8.6, 0, -18), yaw: -Math.PI / 2 },
235
+ lockedDoor: { at: new Vector3(X + 1, 0, -26), width: 2 },
236
+ switchAt: new Vector3(X - 3, 0, -25),
237
+ torches,
238
+ warden: new Vector3(X, 0, -38),
239
+ };
240
+ }
@@ -0,0 +1,383 @@
1
+ import {
2
+ BoxGeometry,
3
+ CylinderGeometry,
4
+ Group,
5
+ Mesh,
6
+ type Object3D,
7
+ PlaneGeometry,
8
+ Vector3,
9
+ } from "three";
10
+ import { type IValeSite, plantVale, valeGround } from "../render/foliage.js";
11
+ import { flat, mottle } from "../render/materials.js";
12
+ import { C } from "../render/palette.js";
13
+ import { createHut, createPitcherLantern, createSign } from "../render/props.js";
14
+ import { surfaced } from "../render/surface.js";
15
+
16
+ /** A small seeded generator, so the clearing is the same clearing every run. */
17
+ export function makeRng(seed: number): () => number {
18
+ let state = seed >>> 0;
19
+ return () => {
20
+ state = (state + 0x6d2b79f5) >>> 0;
21
+ let t = state;
22
+ t = Math.imul(t ^ (t >>> 15), t | 1);
23
+ t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
24
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
25
+ };
26
+ }
27
+
28
+ export interface IVale {
29
+ /** Everything the clearing draws. Meshes with `userData.solid` become fixed colliders. */
30
+ readonly group: Group;
31
+ readonly spawn: Vector3;
32
+ readonly spawnYaw: number;
33
+ readonly dummies: readonly Vector3[];
34
+ readonly mosslings: readonly Vector3[];
35
+ readonly flickers: readonly Vector3[];
36
+ readonly thornbacks: readonly { readonly at: Vector3; readonly yaw: number }[];
37
+ readonly swordChest: { readonly at: Vector3; readonly yaw: number };
38
+ readonly sign: { readonly at: Vector3; readonly text: string };
39
+ /** Walking into this point enters the Hollow. */
40
+ readonly caveMouth: Vector3;
41
+ /** Where Wren stands when she comes back out of the Hollow. */
42
+ readonly caveExit: Vector3;
43
+ /** The lantern-keeper's hut: where it stands and how many lanterns hang from it. */
44
+ readonly hut: { readonly at: Vector3; readonly lanterns: number };
45
+ /** Flagstones laid along the path, and the share of the path's centre line they cover. */
46
+ readonly path: { readonly stones: number; readonly cover: number };
47
+ }
48
+
49
+ // ------------------------------------------------------------------------------------ the ground
50
+ // One height function is the whole landform: the floor Wren walks (a trimesh collider), the floor
51
+ // she sees, and the height every plant, prop, entity and playtest placement stands at. Metres, y up.
52
+
53
+ const smooth = (a: number, b: number, t: number): number => {
54
+ const u = Math.min(1, Math.max(0, (t - a) / (b - a)));
55
+ return u * u * (3 - 2 * u);
56
+ };
57
+ /** 0..1 rolling noise from two crossed sine sheets. */
58
+ const wave = (x: number, z: number, f: number): number =>
59
+ 0.5 + 0.25 * (Math.sin(x * f + z * f * 0.55) + Math.sin(z * f * 1.4 - x * f * 0.37 + 1.3));
60
+
61
+ /** The path's centre line, x at a given z: it winds from Wren's start to the cave mouth at x = 0. */
62
+ export const pathX = (z: number): number =>
63
+ Math.sin((9 - z) * 0.3) * 1.4 * Math.min(1, Math.max(0, (z + 20) / 5));
64
+
65
+ /** The clearing's walkable box: x from -HALF to HALF, z from NORTH to SOUTH. */
66
+ const CLEARING = { half: 20, north: -20, south: 16.5 };
67
+ /**
68
+ * Flat play spaces, x, z, radius: the playtests and the fights stand here, so the ground under them
69
+ * is level and every placement's height is the clearing floor's. The start yard (the chest, the
70
+ * dummies, the sign), the ruin lane the Mosslings walk round, the Thornback lane, the Flicker's
71
+ * circle, the second Mossling's post, and the hut's ledge.
72
+ */
73
+ const PADS: readonly (readonly [number, number, number])[] = [
74
+ [0.4, 6.6, 4.6],
75
+ [-6, -6, 6.5],
76
+ [-6, -2.5, 4],
77
+ [-13, 1.5, 3.5],
78
+ [-13, 6, 3.5],
79
+ [-13, 10.5, 3.5],
80
+ [12, -2, 5.5],
81
+ [7, -9, 2.5],
82
+ ];
83
+ /** The lantern-keeper's hut on its ledge, north-east of the path: x, z, ledge radius, ledge height. */
84
+ const HUT = { x: 10.5, z: -13.5, radius: 3.6, lift: 0.6 };
85
+ /** Steep mossy outcrops, x, z, radius, height: their sides pass the walk limit, so they are walls. */
86
+ const OUTCROPS: readonly (readonly [number, number, number, number])[] = [
87
+ [-16.5, -14, 3.4, 2.8],
88
+ [16, -17.5, 3, 2.4],
89
+ [-17, 14.5, 3, 2.2],
90
+ [-17.5, -4.5, 2.4, 2.2],
91
+ [-9.5, -17.5, 2.6, 2],
92
+ [14.5, -9.5, 1.8, 1.5],
93
+ ];
94
+ /** A stream bed in the south-east corner, as a polyline; its water sits at `STREAM.water`. */
95
+ export const STREAM = {
96
+ points: [
97
+ [6, 18.5],
98
+ [12, 12.5],
99
+ [17, 9.5],
100
+ [23, 8],
101
+ ] as readonly (readonly [number, number])[],
102
+ bed: -0.55,
103
+ water: -0.3,
104
+ };
105
+
106
+ const distanceToSegment = (
107
+ x: number,
108
+ z: number,
109
+ [ax, az]: readonly [number, number],
110
+ [bx, bz]: readonly [number, number],
111
+ ): number => {
112
+ const dx = bx - ax;
113
+ const dz = bz - az;
114
+ const t = Math.min(1, Math.max(0, ((x - ax) * dx + (z - az) * dz) / (dx * dx + dz * dz)));
115
+ return Math.hypot(x - ax - t * dx, z - az - t * dz);
116
+ };
117
+
118
+ /** Metres from the stream's centre line. */
119
+ export function streamDistance(x: number, z: number): number {
120
+ let best = Number.POSITIVE_INFINITY;
121
+ for (let i = 1; i < STREAM.points.length; i += 1) {
122
+ const a = STREAM.points[i - 1];
123
+ const b = STREAM.points[i];
124
+ if (a !== undefined && b !== undefined) best = Math.min(best, distanceToSegment(x, z, a, b));
125
+ }
126
+ return best;
127
+ }
128
+
129
+ /** 1 on a play space, the path or the cave approach, easing to 0 over a few metres round them. */
130
+ function flatness(x: number, z: number): number {
131
+ let f = 1 - smooth(2.2, 4.4, Math.abs(x - pathX(z)));
132
+ if (z < -15) f = Math.max(f, 1 - smooth(3.5, 5.5, Math.abs(x)));
133
+ f = Math.max(f, 1 - smooth(HUT.radius, HUT.radius + 1.6, Math.hypot(x - HUT.x, z - HUT.z)));
134
+ for (const [px, pz, r] of PADS)
135
+ f = Math.max(f, 1 - smooth(r, r + 3.2, Math.hypot(x - px, z - pz)));
136
+ return f;
137
+ }
138
+
139
+ /** The ground's height at (x, z): the one landform every system reads. */
140
+ export function valeHeight(x: number, z: number): number {
141
+ // The rise to the cave mouth: the clearing's north end climbs 1.2 m to the cliff.
142
+ const rise = 1.2 * smooth(-11, -17, z);
143
+ const ledge =
144
+ HUT.lift * (1 - smooth(HUT.radius, HUT.radius + 1.6, Math.hypot(x - HUT.x, z - HUT.z)));
145
+ // Inside the walls: rolling banks, higher toward the walls, and the outcrops.
146
+ const edge = Math.min(CLEARING.half - Math.abs(x), z - CLEARING.north, CLEARING.south - z);
147
+ const tunnel = Math.abs(x) < 3.5 && z < CLEARING.north + 1;
148
+ let relief = 0.35 + 1.3 * wave(x, z, 0.23) + 0.45 * wave(x + 7, z - 3, 0.61);
149
+ if (edge > 0) relief += 1.4 * (1 - smooth(0, 4.5, edge));
150
+ for (const [ox, oz, r, h] of OUTCROPS)
151
+ relief += h * (1 - smooth(r * 0.5, r, Math.hypot(x - ox, z - oz)));
152
+ // Outside them: a steep rocky bank, then wooded hills.
153
+ if (edge < 0 && !tunnel)
154
+ relief += 2.2 * smooth(0, 3, -edge) + (0.8 + 3.4 * wave(x, z, 0.09)) * smooth(2, 14, -edge);
155
+ let h = rise + ledge + relief * (1 - flatness(x, z));
156
+ // The stream cuts its bed through whatever stands there.
157
+ const cut = 1 - smooth(0.7, 2.4, streamDistance(x, z));
158
+ h += (Math.min(h, STREAM.bed) - h) * cut;
159
+ return h;
160
+ }
161
+
162
+ /**
163
+ * The clearing's landform on a 0.5 m grid: its height range, the share steeper than `walkLimit`
164
+ * (radians; the character controller's climb limit) and the share under 6°, which the fights need.
165
+ */
166
+ export function measureRelief(walkLimit = Math.PI / 4): {
167
+ readonly range: number;
168
+ readonly steepShare: number;
169
+ readonly levelShare: number;
170
+ } {
171
+ let low = Number.POSITIVE_INFINITY;
172
+ let high = Number.NEGATIVE_INFINITY;
173
+ let steep = 0;
174
+ let level = 0;
175
+ let samples = 0;
176
+ const step = 0.5;
177
+ for (let x = -CLEARING.half + step; x < CLEARING.half; x += step)
178
+ for (let z = CLEARING.north + step; z < CLEARING.south; z += step) {
179
+ const h = valeHeight(x, z);
180
+ const slope = Math.atan(
181
+ Math.hypot(valeHeight(x + 0.1, z) - h, valeHeight(x, z + 0.1) - h) / 0.1,
182
+ );
183
+ low = Math.min(low, h);
184
+ high = Math.max(high, h);
185
+ samples += 1;
186
+ if (slope > walkLimit) steep += 1;
187
+ if (slope < (6 * Math.PI) / 180) level += 1;
188
+ }
189
+ return { levelShare: level / samples, range: high - low, steepShare: steep / samples };
190
+ }
191
+
192
+ /**
193
+ * The clearing: a forest glade under old trees, a winding flagstone path from Wren's start to the
194
+ * cave mouth in the north cliff, banks and mossy outcrops between the play spaces, a stream bed, the
195
+ * lantern-keeper's hut on its ledge, a ruined wall the Mosslings must go around, two practice
196
+ * dummies, the sword chest, signposts, a Flicker and a Thornback. Coordinates are metres; north is
197
+ * -Z. The planting and the floor's look are `render/foliage.ts`; this file decides what blocks.
198
+ */
199
+ export function buildVale(rng: () => number): IVale {
200
+ const group = new Group();
201
+ group.name = "vale";
202
+ const solid = (mesh: Mesh): Mesh => {
203
+ mesh.userData.solid = true;
204
+ mesh.castShadow = true;
205
+ mesh.receiveShadow = true;
206
+ group.add(mesh);
207
+ return mesh;
208
+ };
209
+ const hidden = (mesh: Mesh): void => {
210
+ solid(mesh).visible = false;
211
+ };
212
+ const at = (x: number, z: number, lift = 0): Vector3 =>
213
+ new Vector3(x, valeHeight(x, z) + lift, z);
214
+ const stoneBox = (
215
+ w: number,
216
+ h: number,
217
+ d: number,
218
+ x: number,
219
+ z: number,
220
+ y = 0,
221
+ variance = 0.22,
222
+ ): Mesh => {
223
+ const segments = (n: number): number => Math.max(1, Math.min(8, Math.round(n / 1.5)));
224
+ const geometry = mottle(
225
+ new BoxGeometry(w, h, d, segments(w), segments(h), segments(d)),
226
+ variance,
227
+ rng,
228
+ );
229
+ geometry.translate(x, y + h / 2, z);
230
+ return solid(new Mesh(geometry, surfaced(C.cliff, "rock", { flat: true, vertexColors: true })));
231
+ };
232
+
233
+ // The north cliff with the cave mouth at x = 0: buttresses of uneven height and depth, so its
234
+ // skyline and its face break up, and two ledges. Their feet sink into the rise.
235
+ const top = valeHeight(0, -19);
236
+ for (const side of [-1, 1]) {
237
+ for (let i = 0; i < 4; i += 1) {
238
+ const w = 7 + rng() * 0.6;
239
+ const h = 7.4 + rng() * 3.2;
240
+ const d = 3 + rng() * 1.4;
241
+ stoneBox(w, h, d, side * (1.7 + 3.5 + i * 7), -20 - d / 2, top - 1, 0.32);
242
+ }
243
+ stoneBox(3.2, 0.7, 1.1, side * (6 + rng() * 3), -20.1, top + 3.4 + rng(), 0.3);
244
+ stoneBox(2.4, 0.6, 0.9, side * (13 + rng() * 3), -20.1, top + 5.2 + rng(), 0.3);
245
+ }
246
+ stoneBox(3.4, 5.4, 3, 0, -21.5, top + 3.6);
247
+ // The walls that close the clearing stand where the banks steepen into the woods: they hold Wren
248
+ // in, but the bank, the rocks and the trees are what she sees.
249
+ hidden(new Mesh(new BoxGeometry(2, 6, 40).translate(-21, 3, -2)));
250
+ hidden(new Mesh(new BoxGeometry(2, 6, 40).translate(21, 3, -2)));
251
+ hidden(new Mesh(new BoxGeometry(44, 6, 2).translate(0, 3, 17.5)));
252
+ // The tunnel behind the mouth: dark walls, a dark back so the mouth reads as a way in.
253
+ stoneBox(1, 3.6, 6, -2.1, -26, top);
254
+ stoneBox(1, 3.6, 6, 2.1, -26, top);
255
+ const back = new Mesh(new PlaneGeometry(4, 4), flat(0x050605));
256
+ back.position.set(0, top + 2, -28.8);
257
+ group.add(back);
258
+ const roof = new Mesh(
259
+ new BoxGeometry(5, 1, 6).translate(0, top + 4.1, -26),
260
+ surfaced(C.stoneDark, "rock", { flat: true }),
261
+ );
262
+ roof.castShadow = true;
263
+ group.add(roof);
264
+
265
+ // The ruin the Mosslings have to walk around.
266
+ stoneBox(6, 1.6, 0.6, -6, -6);
267
+ stoneBox(1.2, 0.5, 0.9, -2.4, -6.4);
268
+
269
+ // Old trees: a few giants inside the clearing that frame the path, and two rings of woods on the
270
+ // hills round it. `giant` trees carry roots and the full crown; the far rings a lighter cut.
271
+ const trees: [number, number, number, "giant" | "far"][] = [
272
+ [-11, 12, 1.25, "giant"],
273
+ [-16, -9, 1.35, "giant"],
274
+ [-13.5, -15.5, 1.5, "giant"],
275
+ [15.5, -12.5, 1.4, "giant"],
276
+ [9, 6.5, 1.15, "giant"],
277
+ [-4.3, -12.8, 1.15, "giant"],
278
+ [4.4, -13.2, 1.2, "giant"],
279
+ [6, 13.5, 1.25, "giant"],
280
+ [-6.5, 15, 1.05, "giant"],
281
+ [16.5, 2.5, 1.1, "giant"],
282
+ ];
283
+ for (let i = 0; i < 22; i += 1) {
284
+ const a = (i / 22) * Math.PI * 2 + rng() * 0.15;
285
+ trees.push([
286
+ Math.cos(a) * (25 + rng() * 5),
287
+ Math.sin(a) * (23 + rng() * 5) - 2,
288
+ 1.1 + rng() * 0.5,
289
+ "far",
290
+ ]);
291
+ }
292
+ for (let i = 0; i < 18; i += 1) {
293
+ const a = (i / 18) * Math.PI * 2 + 0.17;
294
+ trees.push([
295
+ Math.cos(a) * (36 + rng() * 8),
296
+ Math.sin(a) * (33 + rng() * 8) - 2,
297
+ 1.3 + rng() * 0.6,
298
+ "far",
299
+ ]);
300
+ }
301
+ for (const [x, z, s, kind] of trees) {
302
+ if (kind !== "giant") continue;
303
+ // A giant is solid at the trunk; its roots are scenery Wren walks over.
304
+ const w = 1.2 * s;
305
+ hidden(new Mesh(new BoxGeometry(w, 4, w).translate(x, valeHeight(x, z) + 1.5, z)));
306
+ }
307
+
308
+ // The lantern-keeper's hut on its ledge, its round door to the path; solid at the trunk-house.
309
+ const hutAt = at(HUT.x, HUT.z);
310
+ const hut = createHut();
311
+ hut.group.position.copy(hutAt);
312
+ hut.group.rotation.y = Math.atan2(pathX(HUT.z) - HUT.x, 2) + Math.PI / 2;
313
+ group.add(hut.group);
314
+ hidden(new Mesh(new CylinderGeometry(2.2, 2.4, 4, 10).translate(hutAt.x, hutAt.y + 2, hutAt.z)));
315
+
316
+ const sign = createSign();
317
+ sign.position.copy(at(3.5, 9.5));
318
+ sign.rotation.y = -0.4;
319
+ group.add(sign);
320
+ const hutSign = createSign();
321
+ hutSign.position.copy(at(5.4, -11.2));
322
+ hutSign.rotation.y = -0.9;
323
+ group.add(hutSign);
324
+ const pitcher = createPitcherLantern();
325
+ pitcher.position.copy(at(4.3, 3));
326
+ group.add(pitcher);
327
+
328
+ // Planting and the floor. The open spaces: the path, the spawn yard with the dummies and the
329
+ // chest, the ruin's lane, the cave mouth and the hut's door.
330
+ const open: [number, number, number][] = [
331
+ [0, 6, 4.5],
332
+ [-6, -6, 3.5],
333
+ [-6, -2.5, 3],
334
+ [0, -19, 3],
335
+ [HUT.x, HUT.z, HUT.radius],
336
+ ];
337
+ const site: IValeSite = {
338
+ clear: (x, z, width) =>
339
+ Math.abs(x - pathX(z)) > 1.8 + width / 2 &&
340
+ open.every(([ox, oz, r]) => Math.hypot(x - ox, z - oz) > r + width / 2),
341
+ clearing: CLEARING,
342
+ height: valeHeight,
343
+ pathX,
344
+ rng,
345
+ stream: { ...STREAM, distance: streamDistance },
346
+ trees,
347
+ walls: [
348
+ [-14, top + 4.5, -19.95, 12, 7, 0],
349
+ [14, top + 4.5, -19.95, 12, 7, 0],
350
+ [-6, 0.8, -5.65, 6, 1.6, 0],
351
+ [-6, 0.8, -6.35, 6, 1.6, Math.PI],
352
+ ],
353
+ };
354
+ const planting = plantVale(site);
355
+ const ground = valeGround(site, planting.shade);
356
+ // The floor Wren sees is the floor she stands on: its inner, detailed part is the collider.
357
+ ground.inner.userData.solid = true;
358
+ group.add(planting.group, ground.inner, ground.outer);
359
+
360
+ return {
361
+ caveExit: at(0, -17),
362
+ caveMouth: at(0, -23),
363
+ dummies: [at(-1.6, 4), at(1.8, 4.5)],
364
+ group,
365
+ hut: { at: hutAt, lanterns: hut.lanterns },
366
+ mosslings: [at(-6, -10), at(7, -9)],
367
+ flickers: [at(12, -6)],
368
+ path: planting.path,
369
+ thornbacks: [{ at: at(-13, 5), yaw: Math.PI / 2 }],
370
+ sign: {
371
+ at: at(3.5, 9.5),
372
+ text: "LANTERN VALE — The Moss Hollow lies north. Mind the Warden.",
373
+ },
374
+ spawn: at(0, 8),
375
+ spawnYaw: Math.PI,
376
+ swordChest: { at: at(-1.6, 8.4), yaw: Math.PI / 2 },
377
+ };
378
+ }
379
+
380
+ /** True for the meshes `buildStaticColliders` should turn into fixed bodies. */
381
+ export function isSolid(object: Object3D): boolean {
382
+ return object.userData.solid === true;
383
+ }
@@ -0,0 +1,18 @@
1
+ import { acceptHotUpdate } from "@threenative/core/hot";
2
+ import { createElement } from "react";
3
+ import { createRoot } from "react-dom/client";
4
+ import game from "./game.js";
5
+ import { App } from "./ui/App.js";
6
+ import "./style.css";
7
+ import.meta.hot?.accept();
8
+ acceptHotUpdate(game, import.meta.hot);
9
+ // Tab is the lock-on key: keep it from moving browser focus off the canvas.
10
+ window.addEventListener("keydown", (event) => {
11
+ if (event.code === "Tab") event.preventDefault();
12
+ });
13
+ const root = document.getElementById("root");
14
+ if (root === null) throw new Error("Missing #root element.");
15
+ const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
16
+ const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
17
+ appRoot.__threenativeRoot = reactRoot;
18
+ reactRoot.render(createElement(App, { game }));