create-threenative 0.2.7 → 0.2.9

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 (541) hide show
  1. package/README.md +3 -1
  2. package/agent-docs/references/assertion-reference.md +87 -35
  3. package/agent-docs/references/auto-exposure.md +57 -0
  4. package/agent-docs/references/capability-reference.md +1306 -62
  5. package/agent-docs/references/debug-surface.md +6 -0
  6. package/agent-docs/references/finding-assets.md +46 -10
  7. package/agent-docs/references/performance-basics.md +5 -4
  8. package/agent-docs/references/terrain-authoring.md +140 -0
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +2 -1
  10. package/capabilities.json +1505 -79
  11. package/dist/index.d.ts +28 -3
  12. package/dist/index.js +402 -167
  13. package/dist/threenative.js +989 -237
  14. package/dist/web-engine-buffer-geometry-utils.js +281 -0
  15. package/dist/web-engine-decal-geometry.js +184 -0
  16. package/dist/web-engine-gltf-loader.js +196 -0
  17. package/dist/web-engine-hdr-loader.js +190 -0
  18. package/dist/web-engine-lut-cube-loader.js +122 -0
  19. package/dist/web-engine-mesh-bvh-webgpu.js +29 -0
  20. package/dist/web-engine-mesh-bvh.js +32 -0
  21. package/dist/web-engine-post-effects.js +168 -0
  22. package/dist/web-engine-runtime.js +42506 -0
  23. package/package.json +11 -8
  24. package/template-assets/autoExposure.ts +225 -0
  25. package/template-assets/exposure.ts +111 -0
  26. package/template-assets/exposureGraph.ts +178 -0
  27. package/template-assets/exposureReadback.ts +79 -0
  28. package/template-assets/patches/@tailwindcss__node@4.3.3.patch +22 -0
  29. package/template-assets/patches/three@0.185.1.patch +6594 -700
  30. package/template-assets/patches/vite@8.2.0.patch +422 -0
  31. package/template-assets/worldEnvironment.ts +433 -30
  32. package/templates/action-rpg/AGENTS.md +11 -10
  33. package/templates/action-rpg/CLAUDE.md +11 -10
  34. package/templates/action-rpg/package.json +11 -9
  35. package/templates/action-rpg/playtests/performance.playtest.json +7 -1
  36. package/templates/action-rpg/src/progress.ts +0 -4
  37. package/templates/action-rpg/src/render/autoExposure.ts +225 -0
  38. package/templates/action-rpg/src/render/backlightControls.ts +66 -0
  39. package/templates/action-rpg/src/render/backlightMaterial.ts +147 -0
  40. package/templates/action-rpg/src/render/environmentContribution.ts +188 -0
  41. package/templates/action-rpg/src/render/environmentRadiance.ts +36 -0
  42. package/templates/action-rpg/src/render/environmentSampleCache.ts +43 -0
  43. package/templates/action-rpg/src/render/environmentSampling.ts +193 -0
  44. package/templates/action-rpg/src/render/environmentSnapshot.ts +53 -0
  45. package/templates/action-rpg/src/render/exposure.ts +111 -0
  46. package/templates/action-rpg/src/render/exposureGraph.ts +178 -0
  47. package/templates/action-rpg/src/render/exposureReadback.ts +79 -0
  48. package/templates/action-rpg/src/render/heightFog.ts +118 -0
  49. package/templates/action-rpg/src/render/lighting.ts +26 -1
  50. package/templates/action-rpg/src/render/materialAssignments.ts +160 -0
  51. package/templates/action-rpg/src/render/materialLighting.ts +155 -0
  52. package/templates/action-rpg/src/render/postprocessing.ts +17 -2
  53. package/templates/action-rpg/src/render/quality.ts +61 -2
  54. package/templates/action-rpg/src/render/sky.ts +21 -1
  55. package/templates/action-rpg/src/render/vfx.ts +133 -58
  56. package/templates/action-rpg/src/render/worldEnvironment.ts +433 -30
  57. package/templates/action-rpg/src/scenes/Play.ts +81 -16
  58. package/templates/action-rpg/threenative.config.ts +3 -0
  59. package/templates/action-rpg/vite.config.ts +10 -2
  60. package/templates/minimal/AGENTS.md +9 -10
  61. package/templates/minimal/CLAUDE.md +9 -10
  62. package/templates/minimal/package.json +9 -8
  63. package/templates/minimal/playtests/play.playtest.json +7 -1
  64. package/templates/minimal/playtests/sky.playtest.json +10 -1
  65. package/templates/minimal/src/render/autoExposure.ts +225 -0
  66. package/templates/minimal/src/render/backlightControls.ts +66 -0
  67. package/templates/minimal/src/render/backlightMaterial.ts +147 -0
  68. package/templates/minimal/src/render/environmentContribution.ts +188 -0
  69. package/templates/minimal/src/render/environmentRadiance.ts +36 -0
  70. package/templates/minimal/src/render/environmentSampleCache.ts +43 -0
  71. package/templates/minimal/src/render/environmentSampling.ts +193 -0
  72. package/templates/minimal/src/render/environmentSnapshot.ts +53 -0
  73. package/templates/minimal/src/render/exposure.ts +111 -0
  74. package/templates/minimal/src/render/exposureGraph.ts +178 -0
  75. package/templates/minimal/src/render/exposureReadback.ts +79 -0
  76. package/templates/minimal/src/render/heightFog.ts +118 -0
  77. package/templates/minimal/src/render/lighting.ts +25 -1
  78. package/templates/minimal/src/render/materialAssignments.ts +102 -0
  79. package/templates/minimal/src/render/materialLighting.ts +146 -0
  80. package/templates/minimal/src/render/postprocessing.ts +16 -2
  81. package/templates/minimal/src/render/quality.ts +60 -2
  82. package/templates/minimal/src/render/sky.ts +21 -1
  83. package/templates/minimal/src/render/worldEnvironment.ts +433 -30
  84. package/templates/minimal/src/scenes/Play.ts +50 -1
  85. package/templates/minimal/vite.config.ts +10 -2
  86. package/templates/platformer/AGENTS.md +7 -5
  87. package/templates/platformer/CLAUDE.md +7 -5
  88. package/templates/platformer/package.json +11 -9
  89. package/templates/platformer/playtests/performance.playtest.json +7 -1
  90. package/templates/platformer/src/render/autoExposure.ts +225 -0
  91. package/templates/platformer/src/render/backlightControls.ts +66 -0
  92. package/templates/platformer/src/render/backlightMaterial.ts +147 -0
  93. package/templates/platformer/src/render/environmentContribution.ts +188 -0
  94. package/templates/platformer/src/render/environmentRadiance.ts +36 -0
  95. package/templates/platformer/src/render/environmentSampleCache.ts +43 -0
  96. package/templates/platformer/src/render/environmentSampling.ts +193 -0
  97. package/templates/platformer/src/render/environmentSnapshot.ts +53 -0
  98. package/templates/platformer/src/render/exposure.ts +111 -0
  99. package/templates/platformer/src/render/exposureGraph.ts +178 -0
  100. package/templates/platformer/src/render/exposureReadback.ts +79 -0
  101. package/templates/platformer/src/render/heightFog.ts +118 -0
  102. package/templates/platformer/src/render/lighting.ts +26 -1
  103. package/templates/platformer/src/render/materialAssignments.ts +160 -0
  104. package/templates/platformer/src/render/materialLighting.ts +155 -0
  105. package/templates/platformer/src/render/materials.ts +7 -2
  106. package/templates/platformer/src/render/palette.ts +3 -3
  107. package/templates/platformer/src/render/postprocessing.ts +17 -2
  108. package/templates/platformer/src/render/quality.ts +61 -2
  109. package/templates/platformer/src/render/sky.ts +72 -23
  110. package/templates/platformer/src/render/skyEnvironment.ts +50 -0
  111. package/templates/platformer/src/render/worldEnvironment.ts +433 -30
  112. package/templates/platformer/src/scenes/Play.ts +70 -6
  113. package/templates/platformer/vite.config.ts +10 -2
  114. package/templates/puzzle/AGENTS.md +10 -9
  115. package/templates/puzzle/CLAUDE.md +10 -9
  116. package/templates/puzzle/package.json +11 -9
  117. package/templates/puzzle/playtests/boot-failure.playtest.json +2 -2
  118. package/templates/puzzle/playtests/lit.playtest.json +7 -1
  119. package/templates/puzzle/playtests/performance.playtest.json +7 -1
  120. package/templates/puzzle/src/render/autoExposure.ts +225 -0
  121. package/templates/puzzle/src/render/backlightControls.ts +66 -0
  122. package/templates/puzzle/src/render/backlightMaterial.ts +147 -0
  123. package/templates/puzzle/src/render/environmentContribution.ts +188 -0
  124. package/templates/puzzle/src/render/environmentRadiance.ts +36 -0
  125. package/templates/puzzle/src/render/environmentSampleCache.ts +43 -0
  126. package/templates/puzzle/src/render/environmentSampling.ts +193 -0
  127. package/templates/puzzle/src/render/environmentSnapshot.ts +53 -0
  128. package/templates/puzzle/src/render/exposure.ts +111 -0
  129. package/templates/puzzle/src/render/exposureGraph.ts +178 -0
  130. package/templates/puzzle/src/render/exposureReadback.ts +79 -0
  131. package/templates/puzzle/src/render/heightFog.ts +118 -0
  132. package/templates/puzzle/src/render/lighting.ts +33 -1
  133. package/templates/puzzle/src/render/materialAssignments.ts +160 -0
  134. package/templates/puzzle/src/render/materialLighting.ts +155 -0
  135. package/templates/puzzle/src/render/materials.ts +1 -1
  136. package/templates/puzzle/src/render/postprocessing.ts +8 -2
  137. package/templates/puzzle/src/render/quality.ts +62 -1
  138. package/templates/puzzle/src/render/sky.ts +20 -1
  139. package/templates/puzzle/src/render/worldEnvironment.ts +433 -30
  140. package/templates/puzzle/src/scenes/Play.ts +51 -2
  141. package/templates/puzzle/vite.config.ts +10 -2
  142. package/templates/racing/AGENTS.md +8 -7
  143. package/templates/racing/CLAUDE.md +8 -7
  144. package/templates/racing/package.json +11 -9
  145. package/templates/racing/playtests/performance.playtest.json +7 -1
  146. package/templates/racing/playtests/survives.playtest.json +6 -0
  147. package/templates/racing/src/render/autoExposure.ts +225 -0
  148. package/templates/racing/src/render/backlightControls.ts +66 -0
  149. package/templates/racing/src/render/backlightMaterial.ts +147 -0
  150. package/templates/racing/src/render/environmentContribution.ts +188 -0
  151. package/templates/racing/src/render/environmentRadiance.ts +36 -0
  152. package/templates/racing/src/render/environmentSampleCache.ts +43 -0
  153. package/templates/racing/src/render/environmentSampling.ts +193 -0
  154. package/templates/racing/src/render/environmentSnapshot.ts +53 -0
  155. package/templates/racing/src/render/exposure.ts +111 -0
  156. package/templates/racing/src/render/exposureGraph.ts +178 -0
  157. package/templates/racing/src/render/exposureReadback.ts +79 -0
  158. package/templates/racing/src/render/heightFog.ts +118 -0
  159. package/templates/racing/src/render/lighting.ts +29 -1
  160. package/templates/racing/src/render/materialAssignments.ts +160 -0
  161. package/templates/racing/src/render/materialLighting.ts +155 -0
  162. package/templates/racing/src/render/palette.ts +1 -10
  163. package/templates/racing/src/render/postprocessing.ts +17 -2
  164. package/templates/racing/src/render/quality.ts +61 -2
  165. package/templates/racing/src/render/shapes.ts +0 -25
  166. package/templates/racing/src/render/sky.ts +21 -1
  167. package/templates/racing/src/render/worldEnvironment.ts +433 -30
  168. package/templates/racing/src/scenes/Race.ts +91 -3
  169. package/templates/racing/src/track/circuit.ts +0 -9
  170. package/templates/racing/vite.config.ts +10 -2
  171. package/templates/rain/.codex/config.toml +19 -0
  172. package/templates/rain/.cursor/mcp.json +32 -0
  173. package/templates/rain/.gemini/settings.json +32 -0
  174. package/templates/rain/.mcp.json +32 -0
  175. package/templates/rain/.vscode/mcp.json +36 -0
  176. package/templates/rain/.zed/settings.json +36 -0
  177. package/templates/rain/AGENTS.md +95 -0
  178. package/templates/rain/CLAUDE.md +97 -0
  179. package/templates/rain/assets/rain-loop.wav +0 -0
  180. package/templates/rain/assets/thunder.wav +0 -0
  181. package/templates/rain/assets/wind-loop.wav +0 -0
  182. package/templates/rain/index.html +18 -0
  183. package/templates/rain/kit.json +7 -0
  184. package/templates/rain/native-playtests/boot.playtest.json +23 -0
  185. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  186. package/templates/rain/opencode.json +41 -0
  187. package/templates/rain/package.json +59 -0
  188. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  189. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  190. package/templates/rain/playtests/automation.playtest.json +133 -0
  191. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  192. package/templates/rain/playtests/flash.playtest.json +27 -0
  193. package/templates/rain/playtests/fly.playtest.json +54 -0
  194. package/templates/rain/playtests/lightning.playtest.json +220 -0
  195. package/templates/rain/playtests/loading.playtest.json +57 -0
  196. package/templates/rain/playtests/paused.playtest.json +59 -0
  197. package/templates/rain/playtests/performance.playtest.json +32 -0
  198. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  199. package/templates/rain/playtests/simulation.playtest.json +20 -0
  200. package/templates/rain/playtests/storm.playtest.json +150 -0
  201. package/templates/rain/playtests/survives.playtest.json +58 -0
  202. package/templates/rain/playtests/tiers.playtest.json +194 -0
  203. package/templates/rain/playtests/weather.playtest.json +77 -0
  204. package/templates/rain/public/favicon.svg +5 -0
  205. package/templates/rain/src/audio/storm.ts +314 -0
  206. package/templates/rain/src/game.ts +81 -0
  207. package/templates/rain/src/main.ts +15 -0
  208. package/templates/rain/src/render/autoExposure.ts +225 -0
  209. package/templates/rain/src/render/bloom-shader.ts +65 -0
  210. package/templates/rain/src/render/camera.ts +160 -0
  211. package/templates/rain/src/render/clouds-shader.ts +242 -0
  212. package/templates/rain/src/render/clouds.ts +142 -0
  213. package/templates/rain/src/render/exposure.ts +111 -0
  214. package/templates/rain/src/render/exposureGraph.ts +178 -0
  215. package/templates/rain/src/render/exposureReadback.ts +79 -0
  216. package/templates/rain/src/render/lighting.ts +39 -0
  217. package/templates/rain/src/render/lightning.ts +360 -0
  218. package/templates/rain/src/render/loading.ts +327 -0
  219. package/templates/rain/src/render/materials.ts +19 -0
  220. package/templates/rain/src/render/noise-volume.ts +159 -0
  221. package/templates/rain/src/render/palette.ts +18 -0
  222. package/templates/rain/src/render/post-shader.ts +178 -0
  223. package/templates/rain/src/render/postprocessing.ts +229 -0
  224. package/templates/rain/src/render/quality.ts +161 -0
  225. package/templates/rain/src/render/rain.ts +299 -0
  226. package/templates/rain/src/render/sky.ts +28 -0
  227. package/templates/rain/src/render/world-shader.ts +680 -0
  228. package/templates/rain/src/render/world.ts +146 -0
  229. package/templates/rain/src/render/worldEnvironment.ts +1212 -0
  230. package/templates/rain/src/scenes/Boot.ts +348 -0
  231. package/templates/rain/src/state.ts +261 -0
  232. package/templates/rain/src/style.css +1160 -0
  233. package/templates/rain/src/ui/App.tsx +29 -0
  234. package/templates/rain/src/ui/GameUi.tsx +187 -0
  235. package/templates/rain/src/ui/Hud.tsx +327 -0
  236. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  237. package/templates/rain/src/ui/Menu.tsx +370 -0
  238. package/templates/rain/src/ui/automation.ts +60 -0
  239. package/templates/rain/src/ui/main.tsx +7 -0
  240. package/templates/rain/src/ui/tempest.ts +149 -0
  241. package/templates/rain/tailwind.config.ts +2 -0
  242. package/templates/rain/threenative.config.ts +66 -0
  243. package/templates/rain/tools/generate-shaders.mjs +656 -0
  244. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  245. package/templates/rain/tools/storm-dsp.mjs +177 -0
  246. package/templates/rain/tools/tempest-bloom.frag +10 -0
  247. package/templates/rain/tools/tempest-clouds.frag +86 -0
  248. package/templates/rain/tools/tempest-post.frag +47 -0
  249. package/templates/rain/tools/tempest-world.frag +210 -0
  250. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  251. package/templates/rain/tsconfig.json +17 -0
  252. package/templates/rain/vite.config.ts +45 -0
  253. package/templates/rts/AGENTS.md +10 -11
  254. package/templates/rts/CLAUDE.md +10 -11
  255. package/templates/rts/package.json +10 -8
  256. package/templates/rts/playtests/performance.playtest.json +7 -1
  257. package/templates/rts/playtests/rts-ai-attack.playtest.json +10 -1
  258. package/templates/rts/playtests/rts-attack.playtest.json +10 -1
  259. package/templates/rts/playtests/rts-build.playtest.json +10 -1
  260. package/templates/rts/playtests/rts-orders.playtest.json +7 -1
  261. package/templates/rts/playtests/rts-train.playtest.json +10 -1
  262. package/templates/rts/src/render/army.ts +10 -2
  263. package/templates/rts/src/render/autoExposure.ts +225 -0
  264. package/templates/rts/src/render/backlightControls.ts +66 -0
  265. package/templates/rts/src/render/backlightMaterial.ts +147 -0
  266. package/templates/rts/src/render/environmentContribution.ts +188 -0
  267. package/templates/rts/src/render/environmentRadiance.ts +36 -0
  268. package/templates/rts/src/render/environmentSampleCache.ts +43 -0
  269. package/templates/rts/src/render/environmentSampling.ts +193 -0
  270. package/templates/rts/src/render/environmentSnapshot.ts +53 -0
  271. package/templates/rts/src/render/exposure.ts +111 -0
  272. package/templates/rts/src/render/exposureGraph.ts +178 -0
  273. package/templates/rts/src/render/exposureReadback.ts +79 -0
  274. package/templates/rts/src/render/heightFog.ts +118 -0
  275. package/templates/rts/src/render/lighting.ts +26 -1
  276. package/templates/rts/src/render/materialAssignments.ts +160 -0
  277. package/templates/rts/src/render/materialLighting.ts +155 -0
  278. package/templates/rts/src/render/postprocessing.ts +8 -2
  279. package/templates/rts/src/render/quality.ts +61 -2
  280. package/templates/rts/src/render/sky.ts +21 -1
  281. package/templates/rts/src/render/worldEnvironment.ts +433 -30
  282. package/templates/rts/src/scenes/Play.ts +54 -3
  283. package/templates/rts/src/sim/ai.ts +0 -1
  284. package/templates/rts/src/sim/terrain.ts +0 -4
  285. package/templates/rts/vite.config.ts +10 -2
  286. package/templates/runner/AGENTS.md +10 -8
  287. package/templates/runner/CLAUDE.md +10 -8
  288. package/templates/runner/package.json +11 -9
  289. package/templates/runner/playtests/performance.playtest.json +10 -1
  290. package/templates/runner/src/physics.ts +0 -1
  291. package/templates/runner/src/render/autoExposure.ts +225 -0
  292. package/templates/runner/src/render/backlightControls.ts +66 -0
  293. package/templates/runner/src/render/backlightMaterial.ts +147 -0
  294. package/templates/runner/src/render/environmentContribution.ts +188 -0
  295. package/templates/runner/src/render/environmentRadiance.ts +36 -0
  296. package/templates/runner/src/render/environmentSampleCache.ts +43 -0
  297. package/templates/runner/src/render/environmentSampling.ts +193 -0
  298. package/templates/runner/src/render/environmentSnapshot.ts +53 -0
  299. package/templates/runner/src/render/exposure.ts +111 -0
  300. package/templates/runner/src/render/exposureGraph.ts +178 -0
  301. package/templates/runner/src/render/exposureReadback.ts +79 -0
  302. package/templates/runner/src/render/heightFog.ts +118 -0
  303. package/templates/runner/src/render/lighting.ts +26 -1
  304. package/templates/runner/src/render/materialAssignments.ts +160 -0
  305. package/templates/runner/src/render/materialLighting.ts +155 -0
  306. package/templates/runner/src/render/postprocessing.ts +17 -2
  307. package/templates/runner/src/render/quality.ts +61 -2
  308. package/templates/runner/src/render/sky.ts +21 -1
  309. package/templates/runner/src/render/worldEnvironment.ts +433 -30
  310. package/templates/runner/src/scenes/Run.ts +67 -2
  311. package/templates/runner/threenative.config.ts +3 -0
  312. package/templates/runner/vite.config.ts +10 -2
  313. package/templates/sailing/AGENTS.md +14 -13
  314. package/templates/sailing/CLAUDE.md +14 -13
  315. package/templates/sailing/native-playtests/survives.playtest.json +7 -0
  316. package/templates/sailing/package.json +11 -9
  317. package/templates/sailing/playtests/live/render-motion.playtest.json +30 -0
  318. package/templates/sailing/src/entities/Ship.ts +38 -18
  319. package/templates/sailing/src/render/autoExposure.ts +225 -0
  320. package/templates/sailing/src/render/backlightControls.ts +66 -0
  321. package/templates/sailing/src/render/backlightMaterial.ts +147 -0
  322. package/templates/sailing/src/render/camera.ts +12 -4
  323. package/templates/sailing/src/render/environmentContribution.ts +188 -0
  324. package/templates/sailing/src/render/environmentRadiance.ts +36 -0
  325. package/templates/sailing/src/render/environmentSampleCache.ts +43 -0
  326. package/templates/sailing/src/render/environmentSampling.ts +193 -0
  327. package/templates/sailing/src/render/environmentSetup.ts +24 -0
  328. package/templates/sailing/src/render/environmentSnapshot.ts +53 -0
  329. package/templates/sailing/src/render/exposure.ts +111 -0
  330. package/templates/sailing/src/render/exposureGraph.ts +178 -0
  331. package/templates/sailing/src/render/exposureReadback.ts +79 -0
  332. package/templates/sailing/src/render/heightFog.ts +118 -0
  333. package/templates/sailing/src/render/lighting.ts +26 -1
  334. package/templates/sailing/src/render/materialAssignments.ts +160 -0
  335. package/templates/sailing/src/render/materialLighting.ts +155 -0
  336. package/templates/sailing/src/render/ocean.ts +71 -53
  337. package/templates/sailing/src/render/postprocessing.ts +16 -2
  338. package/templates/sailing/src/render/props.ts +0 -45
  339. package/templates/sailing/src/render/quality.ts +61 -1
  340. package/templates/sailing/src/render/sky.ts +21 -1
  341. package/templates/sailing/src/render/worldEnvironment.ts +433 -30
  342. package/templates/sailing/src/scenes/Boot.ts +12 -1
  343. package/templates/sailing/src/scenes/Sailing.ts +87 -2
  344. package/templates/sailing/src/scenes/ocean-readiness.ts +68 -0
  345. package/templates/sailing/threenative.config.ts +3 -0
  346. package/templates/sailing/vite.config.ts +10 -2
  347. package/templates/shooter/AGENTS.md +8 -6
  348. package/templates/shooter/CLAUDE.md +8 -6
  349. package/templates/shooter/package.json +11 -9
  350. package/templates/shooter/playtests/performance.playtest.json +7 -1
  351. package/templates/shooter/src/entities/Enemy.ts +0 -15
  352. package/templates/shooter/src/entities/Rifle.ts +38 -1
  353. package/templates/shooter/src/render/autoExposure.ts +225 -0
  354. package/templates/shooter/src/render/backlightControls.ts +66 -0
  355. package/templates/shooter/src/render/backlightMaterial.ts +147 -0
  356. package/templates/shooter/src/render/camera.ts +1 -12
  357. package/templates/shooter/src/render/decals.ts +299 -5
  358. package/templates/shooter/src/render/environmentContribution.ts +188 -0
  359. package/templates/shooter/src/render/environmentRadiance.ts +36 -0
  360. package/templates/shooter/src/render/environmentSampleCache.ts +43 -0
  361. package/templates/shooter/src/render/environmentSampling.ts +193 -0
  362. package/templates/shooter/src/render/environmentSnapshot.ts +53 -0
  363. package/templates/shooter/src/render/exposure.ts +111 -0
  364. package/templates/shooter/src/render/exposureGraph.ts +178 -0
  365. package/templates/shooter/src/render/exposureReadback.ts +79 -0
  366. package/templates/shooter/src/render/gunfx.ts +0 -1
  367. package/templates/shooter/src/render/heightFog.ts +118 -0
  368. package/templates/shooter/src/render/lighting.ts +26 -1
  369. package/templates/shooter/src/render/materialAssignments.ts +160 -0
  370. package/templates/shooter/src/render/materialLighting.ts +155 -0
  371. package/templates/shooter/src/render/postprocessing.ts +17 -2
  372. package/templates/shooter/src/render/quality.ts +61 -2
  373. package/templates/shooter/src/render/scale.ts +2 -93
  374. package/templates/shooter/src/render/sky.ts +21 -1
  375. package/templates/shooter/src/render/vehicles.ts +0 -17
  376. package/templates/shooter/src/render/worldEnvironment.ts +433 -30
  377. package/templates/shooter/src/scenes/Play.ts +64 -2
  378. package/templates/shooter/vite.config.ts +10 -2
  379. package/templates/snow/.codex/config.toml +19 -0
  380. package/templates/snow/.cursor/mcp.json +32 -0
  381. package/templates/snow/.gemini/settings.json +32 -0
  382. package/templates/snow/.mcp.json +32 -0
  383. package/templates/snow/.vscode/mcp.json +36 -0
  384. package/templates/snow/.zed/settings.json +36 -0
  385. package/templates/snow/AGENTS.md +90 -0
  386. package/templates/snow/CLAUDE.md +92 -0
  387. package/templates/snow/README.md +26 -0
  388. package/templates/snow/assets/crunch.wav +0 -0
  389. package/templates/snow/assets/wind.wav +0 -0
  390. package/templates/snow/index.html +12 -0
  391. package/templates/snow/kit.json +7 -0
  392. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  393. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  394. package/templates/snow/opencode.json +41 -0
  395. package/templates/snow/package.json +60 -0
  396. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  397. package/templates/snow/playtests/performance.playtest.json +36 -0
  398. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  399. package/templates/snow/playtests/survives.playtest.json +56 -0
  400. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  401. package/templates/snow/playtests/weather.playtest.json +119 -0
  402. package/templates/snow/public/favicon.svg +5 -0
  403. package/templates/snow/src/audio.ts +58 -0
  404. package/templates/snow/src/commands.ts +8 -0
  405. package/templates/snow/src/entities/Explorer.ts +279 -0
  406. package/templates/snow/src/game.ts +69 -0
  407. package/templates/snow/src/main.ts +15 -0
  408. package/templates/snow/src/render/autoExposure.ts +225 -0
  409. package/templates/snow/src/render/backlightControls.ts +66 -0
  410. package/templates/snow/src/render/backlightMaterial.ts +147 -0
  411. package/templates/snow/src/render/bootPrint.ts +50 -0
  412. package/templates/snow/src/render/camera.ts +84 -0
  413. package/templates/snow/src/render/environmentContribution.ts +188 -0
  414. package/templates/snow/src/render/environmentRadiance.ts +36 -0
  415. package/templates/snow/src/render/environmentSampleCache.ts +43 -0
  416. package/templates/snow/src/render/environmentSampling.ts +193 -0
  417. package/templates/snow/src/render/environmentSnapshot.ts +53 -0
  418. package/templates/snow/src/render/explorer.ts +321 -0
  419. package/templates/snow/src/render/exposure.ts +111 -0
  420. package/templates/snow/src/render/exposureGraph.ts +178 -0
  421. package/templates/snow/src/render/exposureReadback.ts +79 -0
  422. package/templates/snow/src/render/heightFog.ts +118 -0
  423. package/templates/snow/src/render/lighting.ts +82 -0
  424. package/templates/snow/src/render/loading.ts +325 -0
  425. package/templates/snow/src/render/materialAssignments.ts +160 -0
  426. package/templates/snow/src/render/materialLighting.ts +155 -0
  427. package/templates/snow/src/render/materials.ts +36 -0
  428. package/templates/snow/src/render/palette.ts +17 -0
  429. package/templates/snow/src/render/postprocessing.ts +58 -0
  430. package/templates/snow/src/render/props.ts +42 -0
  431. package/templates/snow/src/render/quality.ts +193 -0
  432. package/templates/snow/src/render/scenery.ts +244 -0
  433. package/templates/snow/src/render/sky.ts +76 -0
  434. package/templates/snow/src/render/snowSurface.ts +259 -0
  435. package/templates/snow/src/render/touch-controls.ts +143 -0
  436. package/templates/snow/src/render/weather.ts +279 -0
  437. package/templates/snow/src/render/worldEnvironment.ts +1212 -0
  438. package/templates/snow/src/scenes/Boot.ts +12 -0
  439. package/templates/snow/src/scenes/Snow.ts +663 -0
  440. package/templates/snow/src/state.ts +46 -0
  441. package/templates/snow/src/style.css +143 -0
  442. package/templates/snow/src/terrain.ts +64 -0
  443. package/templates/snow/src/ui/App.tsx +15 -0
  444. package/templates/snow/src/ui/Controls.tsx +322 -0
  445. package/templates/snow/src/ui/GameUi.tsx +354 -0
  446. package/templates/snow/src/ui/icons.tsx +54 -0
  447. package/templates/snow/src/ui/main.tsx +7 -0
  448. package/templates/snow/tailwind.config.ts +2 -0
  449. package/templates/snow/threenative.config.ts +54 -0
  450. package/templates/snow/tsconfig.json +17 -0
  451. package/templates/snow/vite.config.ts +45 -0
  452. package/templates/starter/AGENTS.md +11 -16
  453. package/templates/starter/CLAUDE.md +11 -16
  454. package/templates/starter/native-playtests/react-hud.playtest.json +1 -1
  455. package/templates/starter/native-playtests/render-chain.playtest.json +51 -8
  456. package/templates/starter/native-playtests/smooth-motion.playtest.json +64 -0
  457. package/templates/starter/package.json +11 -9
  458. package/templates/starter/playtests/live/smooth-motion.playtest.json +63 -0
  459. package/templates/starter/playtests/movement.playtest.json +192 -0
  460. package/templates/starter/playtests/play.playtest.json +18 -2
  461. package/templates/starter/playtests/production-readiness.playtest.json +1 -1
  462. package/templates/starter/public/grade.cube +735 -0
  463. package/templates/starter/src/entities/Crate.ts +4 -0
  464. package/templates/starter/src/entities/Player.ts +79 -18
  465. package/templates/starter/src/game.ts +1 -0
  466. package/templates/starter/src/render/adaptiveQuality.ts +28 -41
  467. package/templates/starter/src/render/autoExposure.ts +225 -0
  468. package/templates/starter/src/render/backlightControls.ts +66 -0
  469. package/templates/starter/src/render/backlightMaterial.ts +147 -0
  470. package/templates/starter/src/render/environmentContribution.ts +188 -0
  471. package/templates/starter/src/render/environmentRadiance.ts +36 -0
  472. package/templates/starter/src/render/environmentSampleCache.ts +43 -0
  473. package/templates/starter/src/render/environmentSampling.ts +193 -0
  474. package/templates/starter/src/render/environmentSnapshot.ts +53 -0
  475. package/templates/starter/src/render/exposure.ts +111 -0
  476. package/templates/starter/src/render/exposureGraph.ts +178 -0
  477. package/templates/starter/src/render/exposureReadback.ts +79 -0
  478. package/templates/starter/src/render/grade.ts +157 -0
  479. package/templates/starter/src/render/heightFog.ts +118 -0
  480. package/templates/starter/src/render/lighting.ts +26 -1
  481. package/templates/starter/src/render/materialAssignments.ts +160 -0
  482. package/templates/starter/src/render/materialLighting.ts +155 -0
  483. package/templates/starter/src/render/postprocessing.ts +84 -4
  484. package/templates/starter/src/render/quality.ts +80 -8
  485. package/templates/starter/src/render/qualityPolicy.ts +54 -0
  486. package/templates/starter/src/render/rendererGate.ts +36 -0
  487. package/templates/starter/src/render/sky.ts +23 -1
  488. package/templates/starter/src/render/temporalAA.ts +197 -0
  489. package/templates/starter/src/render/temporalAAFrame.ts +179 -0
  490. package/templates/starter/src/render/temporalAAHooks.ts +101 -0
  491. package/templates/starter/src/render/temporalAAInput.ts +56 -0
  492. package/templates/starter/src/render/temporalAAResolve.ts +65 -0
  493. package/templates/starter/src/render/temporalAAStage.ts +76 -0
  494. package/templates/starter/src/render/temporalCurrentArea.ts +31 -0
  495. package/templates/starter/src/render/temporalCurrentFootprint.ts +198 -0
  496. package/templates/starter/src/render/temporalCurrentFootprintMath.ts +41 -0
  497. package/templates/starter/src/render/temporalCurrentProducer.ts +161 -0
  498. package/templates/starter/src/render/temporalCurrentReplay.ts +160 -0
  499. package/templates/starter/src/render/temporalCurrentSelection.ts +89 -0
  500. package/templates/starter/src/render/temporalCurrentVisibility.ts +170 -0
  501. package/templates/starter/src/render/temporalDepthSamples.ts +34 -0
  502. package/templates/starter/src/render/temporalRejectionCounter.ts +179 -0
  503. package/templates/starter/src/render/temporalResolve.ts +139 -0
  504. package/templates/starter/src/render/temporalResolveDepth.ts +193 -0
  505. package/templates/starter/src/render/temporalResolveMath.ts +196 -0
  506. package/templates/starter/src/render/volumetricFog.ts +124 -0
  507. package/templates/starter/src/render/volumetricFogOptions.ts +96 -0
  508. package/templates/starter/src/render/volumetricFogTransport.ts +176 -0
  509. package/templates/starter/src/render/volumetricFogVolume.ts +139 -0
  510. package/templates/starter/src/render/worldEnvironment.ts +433 -30
  511. package/templates/starter/src/scenes/Play.ts +110 -1
  512. package/templates/starter/src/state.ts +1 -0
  513. package/templates/starter/src/ui/Hud.tsx +1 -1
  514. package/templates/starter/src/ui/Menu.tsx +1 -1
  515. package/templates/starter/tools/make-grade-lut.mjs +101 -0
  516. package/templates/starter/vite.config.ts +10 -2
  517. package/templates/tower-defense/AGENTS.md +10 -9
  518. package/templates/tower-defense/CLAUDE.md +10 -9
  519. package/templates/tower-defense/package.json +11 -9
  520. package/templates/tower-defense/playtests/performance.playtest.json +7 -1
  521. package/templates/tower-defense/src/render/autoExposure.ts +225 -0
  522. package/templates/tower-defense/src/render/backlightControls.ts +66 -0
  523. package/templates/tower-defense/src/render/backlightMaterial.ts +147 -0
  524. package/templates/tower-defense/src/render/environmentContribution.ts +188 -0
  525. package/templates/tower-defense/src/render/environmentRadiance.ts +36 -0
  526. package/templates/tower-defense/src/render/environmentSampleCache.ts +43 -0
  527. package/templates/tower-defense/src/render/environmentSampling.ts +193 -0
  528. package/templates/tower-defense/src/render/environmentSnapshot.ts +53 -0
  529. package/templates/tower-defense/src/render/exposure.ts +111 -0
  530. package/templates/tower-defense/src/render/exposureGraph.ts +178 -0
  531. package/templates/tower-defense/src/render/exposureReadback.ts +79 -0
  532. package/templates/tower-defense/src/render/lighting.ts +33 -1
  533. package/templates/tower-defense/src/render/materialAssignments.ts +160 -0
  534. package/templates/tower-defense/src/render/materialLighting.ts +155 -0
  535. package/templates/tower-defense/src/render/postprocessing.ts +8 -2
  536. package/templates/tower-defense/src/render/quality.ts +61 -2
  537. package/templates/tower-defense/src/render/shapes.ts +0 -3
  538. package/templates/tower-defense/src/render/worldEnvironment.ts +433 -30
  539. package/templates/tower-defense/src/scenes/Battle.ts +65 -2
  540. package/templates/tower-defense/vite.config.ts +10 -2
  541. package/templates/minimal/src/scenes/Boot.ts +0 -5
@@ -0,0 +1,71 @@
1
+ {
2
+ "name": "snow-touch-controls",
3
+ "schemaVersion": 1,
4
+ "target": "web",
5
+ "viewport": {
6
+ "width": 390,
7
+ "height": 844
8
+ },
9
+ "warmupFrames": 10,
10
+ "subject": "player",
11
+ "steps": [
12
+ {
13
+ "kind": "input",
14
+ "label": "movement-anchor",
15
+ "pointers": [
16
+ {
17
+ "id": 7,
18
+ "x": 0.25,
19
+ "y": 0.82
20
+ }
21
+ ],
22
+ "holdTicks": 2,
23
+ "release": false
24
+ },
25
+ {
26
+ "kind": "input",
27
+ "label": "walk-forward",
28
+ "pointers": [
29
+ {
30
+ "id": 7,
31
+ "x": 0.25,
32
+ "y": 0.72
33
+ }
34
+ ],
35
+ "holdTicks": 120,
36
+ "release": true
37
+ },
38
+ {
39
+ "kind": "wait",
40
+ "label": "settled",
41
+ "waitTicks": 10,
42
+ "release": true
43
+ }
44
+ ],
45
+ "assert": {
46
+ "diagnostics": {
47
+ "noConsoleErrors": true,
48
+ "noNetworkErrors": true,
49
+ "noRuntimeDiagnostics": true,
50
+ "runtimeReady": true
51
+ },
52
+ "movement": {
53
+ "entity": "player",
54
+ "minDistance": 0.5
55
+ },
56
+ "resources": [
57
+ {
58
+ "id": "state",
59
+ "path": "autoExplore",
60
+ "equals": false
61
+ }
62
+ ],
63
+ "visibility": [
64
+ {
65
+ "entity": "touch-controls",
66
+ "present": true,
67
+ "allowTrivial": "Touch-primary lanes keep the movement stick visible while the walk proves it is live."
68
+ }
69
+ ]
70
+ }
71
+ }
@@ -0,0 +1,119 @@
1
+ {
2
+ "name": "snow-weather",
3
+ "schemaVersion": 1,
4
+ "target": "web",
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
9
+ "warmupFrames": 20,
10
+ "subject": "player",
11
+ "steps": [
12
+ {
13
+ "kind": "input",
14
+ "label": "hands-off",
15
+ "press": "KeyP",
16
+ "holdTicks": 2,
17
+ "release": true
18
+ },
19
+ {
20
+ "kind": "wait",
21
+ "label": "calm",
22
+ "waitTicks": 20,
23
+ "release": true
24
+ },
25
+ {
26
+ "kind": "input",
27
+ "label": "blizzard",
28
+ "press": "KeyB",
29
+ "holdTicks": 1,
30
+ "release": true
31
+ },
32
+ {
33
+ "kind": "wait",
34
+ "label": "storm",
35
+ "waitTicks": 300,
36
+ "release": true
37
+ },
38
+ {
39
+ "kind": "input",
40
+ "label": "compaction",
41
+ "press": "KeyV",
42
+ "holdTicks": 1,
43
+ "release": true
44
+ },
45
+ {
46
+ "kind": "input",
47
+ "label": "reset",
48
+ "press": "KeyR",
49
+ "holdTicks": 1,
50
+ "release": true
51
+ },
52
+ {
53
+ "kind": "wait",
54
+ "label": "fresh",
55
+ "waitTicks": 20,
56
+ "release": true
57
+ }
58
+ ],
59
+ "assert": {
60
+ "diagnostics": {
61
+ "noConsoleErrors": true,
62
+ "noNetworkErrors": true,
63
+ "noRuntimeDiagnostics": true,
64
+ "runtimeReady": true
65
+ },
66
+ "components": [
67
+ {
68
+ "entity": "weather",
69
+ "component": "storm",
70
+ "gte": 0.6,
71
+ "allowTrivial": "Five seconds after B the blizzard has mostly built: the eased storm level passes 0.6."
72
+ },
73
+ {
74
+ "entity": "weather",
75
+ "component": "wind",
76
+ "gte": 4,
77
+ "allowTrivial": "A blizzard blows at several metres a second, gusts included."
78
+ },
79
+ {
80
+ "entity": "snow",
81
+ "component": "trailPressed",
82
+ "atSteps": [
83
+ {
84
+ "label": "calm",
85
+ "equals": true
86
+ },
87
+ {
88
+ "label": "fresh",
89
+ "equals": false
90
+ }
91
+ ],
92
+ "allowTrivial": "The arrival trail is in the snow at the start and gone after R clears every footprint."
93
+ }
94
+ ],
95
+ "resources": [
96
+ {
97
+ "id": "state",
98
+ "path": "blizzard",
99
+ "equals": true
100
+ },
101
+ {
102
+ "id": "state",
103
+ "path": "compaction",
104
+ "equals": true
105
+ }
106
+ ],
107
+ "visual": [
108
+ {
109
+ "region": {
110
+ "x": 0,
111
+ "y": 0,
112
+ "width": 1280,
113
+ "height": 720,
114
+ "minNonblankPixelRatio": 0.01
115
+ }
116
+ }
117
+ ]
118
+ }
119
+ }
@@ -0,0 +1,5 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
2
+ <rect width="64" height="64" rx="14" fill="#061b2b"/>
3
+ <path d="M10 45h44M17 45l16-30 14 30M25 30h17" fill="none" stroke="#ffd27a" stroke-linecap="round" stroke-linejoin="round" stroke-width="5"/>
4
+ <path d="M12 51c8-4 16 4 24 0s16 4 16 0" fill="none" stroke="#6fe8ff" stroke-linecap="round" stroke-width="4"/>
5
+ </svg>
@@ -0,0 +1,58 @@
1
+ import { AudioBus } from "@threenative/core";
2
+ import type { Audio, Object3D } from "three";
3
+ import type { IFootstep } from "./entities/Explorer.js";
4
+
5
+ /**
6
+ * Boot crunch and a wind bed through one `AudioBus`. Both clips in `assets/` are generated
7
+ * noise — a bandpass sweep for the crunch, filtered brown noise for the wind — so swap either
8
+ * file for a recording without touching this code. Muted means the bus level is zero; the wind
9
+ * keeps looping underneath so unmuting never restarts it mid-gust.
10
+ */
11
+ export class SnowAudio {
12
+ readonly bus: AudioBus;
13
+ #crunch: AudioBuffer | undefined;
14
+ #wind: Audio | undefined;
15
+ #muted = true;
16
+
17
+ constructor(camera: Object3D, load: (name: string) => Promise<AudioBuffer>) {
18
+ this.bus = new AudioBus({ camera });
19
+ this.bus.setVolume(0);
20
+ void load("crunch.wav")
21
+ .then((buffer) => {
22
+ this.#crunch = buffer;
23
+ })
24
+ .catch(() => undefined);
25
+ void load("wind.wav")
26
+ .then((buffer) => {
27
+ this.#wind = this.bus.play(buffer, { cue: "wind", loop: true, volume: 0 });
28
+ })
29
+ .catch(() => undefined);
30
+ }
31
+
32
+ get muted(): boolean {
33
+ return this.#muted;
34
+ }
35
+
36
+ setMuted(muted: boolean): void {
37
+ this.#muted = muted;
38
+ this.bus.setVolume(muted ? 0 : 1, 0.2);
39
+ }
40
+
41
+ footstep(step: IFootstep): void {
42
+ if (this.#muted || this.#crunch === undefined || step.penetration <= 0) return;
43
+ this.bus.play(this.#crunch, {
44
+ cue: "crunch",
45
+ detune: (Math.random() - 0.5) * 400,
46
+ volume: Math.min(1, 0.42 + step.penetration * 2),
47
+ });
48
+ }
49
+
50
+ /** The wind bed follows the live wind and swells with the storm. */
51
+ update(wind: number, storm: number): void {
52
+ this.#wind?.setVolume(Math.min(1, 0.12 + storm * 0.55 + wind * 0.01));
53
+ }
54
+
55
+ dispose(): void {
56
+ this.bus.dispose();
57
+ }
58
+ }
@@ -0,0 +1,8 @@
1
+ /**
2
+ * One-shot actions from the HUD. Sliders and toggles are state; these are verbs, so the UI pushes
3
+ * them here and the scene drains the queue on its next fixed step — the same functions a key
4
+ * press calls, so the keyboard and the panel can never disagree.
5
+ */
6
+ export type Command = "reset" | "drop" | "kick" | "view" | "auto" | "blizzard" | "mute";
7
+
8
+ export const commands: Command[] = [];
@@ -0,0 +1,279 @@
1
+ import type { SnowField } from "@threenative/core/world";
2
+ import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
+ import { Object3D } from "three";
4
+ import { BOOT_AREA, bootPrint } from "../render/bootPrint.js";
5
+ import { ExplorerModel, type IFootPose } from "../render/explorer.js";
6
+ import type { SnowMaterials } from "../render/materials.js";
7
+ import { EXPLORER_LAYER, SNOW_LAYER, terrainHeight } from "../terrain.js";
8
+
9
+ /** One planted boot: where, how it was turned, and how far it sank. */
10
+ export interface IFootstep {
11
+ readonly x: number;
12
+ readonly y: number;
13
+ readonly z: number;
14
+ readonly angle: number;
15
+ readonly penetration: number;
16
+ readonly speed: number;
17
+ readonly side: number;
18
+ }
19
+
20
+ interface IFoot extends IFootPose {
21
+ side: number;
22
+ x: number;
23
+ y: number;
24
+ z: number;
25
+ angle: number;
26
+ swing: boolean;
27
+ progress: number;
28
+ stop: number;
29
+ from: { x: number; z: number };
30
+ to: { x: number; z: number };
31
+ }
32
+
33
+ /** The explorer's weight, which every planted boot presses into the snow. */
34
+ const MASS = 80;
35
+ const GRAVITY = 9.81;
36
+ /** Capsule straight half-length and radius: 1.7 m tall, origin at the waist. */
37
+ const HALF_HEIGHT = 0.55;
38
+ const RADIUS = 0.3;
39
+ const WAIST = HALF_HEIGHT + RADIUS;
40
+ /**
41
+ * How far each boot lands from the line of travel. Wide enough that the left and right prints
42
+ * stay two rows with snow between them rather than merging into one trench.
43
+ */
44
+ export const STANCE = 0.2;
45
+
46
+ const clamp = (value: number, low: number, high: number) => Math.max(low, Math.min(high, value));
47
+ const lerp = (a: number, b: number, t: number) => a + (b - a) * t;
48
+ const damp = (a: number, b: number, rate: number, dt: number) =>
49
+ lerp(a, b, 1 - Math.exp(-rate * Math.max(0, dt)));
50
+ const smoothstep = (edge0: number, edge1: number, value: number) => {
51
+ const t = clamp((value - edge0) / (edge1 - edge0), 0, 1);
52
+ return t * t * (3 - 2 * t);
53
+ };
54
+
55
+ /** Walking pace through powder: deeper, softer snow is slower; packed snow is faster. */
56
+ function paceThrough(depth: number, compaction: number, running: boolean): number {
57
+ const resistance = clamp(depth, 0, 0.6) * (1 - clamp(compaction, 0, 1) * 0.75);
58
+ return (running ? 3.25 : 1.65) / (1 + resistance * 3.5);
59
+ }
60
+
61
+ /**
62
+ * The procedural explorer. Movement goes through a `CharacterBody3D`, so trees, rocks and the
63
+ * ball stop or get pushed by real collision; each boot is planted by the walk cycle, and only a
64
+ * grounded body plants one. A planted boot presses `bootPrint` into the snow with the explorer's
65
+ * own weight over the sole's area — the snow decides how deep that goes.
66
+ */
67
+ export class Explorer {
68
+ readonly body: CharacterBody3D;
69
+ readonly model: ExplorerModel;
70
+ /** What a playtest or camera tracks: the drawn explorer, not the collision capsule. */
71
+ readonly object: Object3D;
72
+ readonly position = { x: 0, y: 0, z: 0 };
73
+ heading = Math.PI;
74
+ speed = 0;
75
+ steps = 0;
76
+ #velocity = { x: 0, z: 0 };
77
+ #cycle = 0.1;
78
+ #elapsed = 0;
79
+ #last = { x: 0, z: 0 };
80
+ readonly #feet: IFoot[] = [];
81
+ readonly #snow: SnowField;
82
+ readonly #onStep: (step: IFootstep) => void;
83
+
84
+ constructor(
85
+ physics: IPhysicsContext,
86
+ snow: SnowField,
87
+ materials: SnowMaterials,
88
+ start: { x: number; z: number },
89
+ onStep: (step: IFootstep) => void,
90
+ ) {
91
+ this.#snow = snow;
92
+ this.#onStep = onStep;
93
+ const anchor = new Object3D();
94
+ anchor.position.set(start.x, snow.heightAt(start.x, start.z) + WAIST + 0.05, start.z);
95
+ this.body = new CharacterBody3D({
96
+ autostep: { maxHeight: 0.25, minWidth: 0.1 },
97
+ maxSlopeClimbAngle: 0.8,
98
+ object: anchor,
99
+ physics,
100
+ // Stands on the coarse walk surface, never the 6 cm snow collider (see `WALK_SAMPLES`).
101
+ collisionLayer: EXPLORER_LAYER,
102
+ collisionMask: 0xffff & ~SNOW_LAYER,
103
+ pushesDynamicBodies: true,
104
+ shape: CollisionShape3D.capsule(HALF_HEIGHT, RADIUS),
105
+ snapToGround: 0.3,
106
+ });
107
+ this.model = new ExplorerModel(materials);
108
+ this.object = this.model.root;
109
+ this.position.x = start.x;
110
+ this.position.z = start.z;
111
+ this.position.y = snow.heightAt(start.x, start.z) - 0.07;
112
+ this.#last = { x: start.x, z: start.z };
113
+ for (const side of [-1, 1]) {
114
+ const x = start.x + side * STANCE * Math.cos(this.heading);
115
+ const z = start.z - side * STANCE * Math.sin(this.heading);
116
+ this.#feet.push({
117
+ angle: this.heading,
118
+ from: { x, z },
119
+ progress: 0,
120
+ side,
121
+ stop: 0,
122
+ swing: false,
123
+ to: { x, z },
124
+ x,
125
+ y: snow.heightAt(x, z) + 0.14,
126
+ z,
127
+ });
128
+ }
129
+ this.model.pose(this.position, this.heading, this.#feet, this.#cycle, 0, 0);
130
+ }
131
+
132
+ /** Steer towards `move` (a world-space direction, length up to 1) for one fixed step. */
133
+ update(dt: number, move: { x: number; z: number }, running: boolean, hardness: number): void {
134
+ this.#elapsed += dt;
135
+ const snow = this.#snow;
136
+ const anchor = this.body.object.position;
137
+ // The walk cycle advances by the ground the body actually covered, so a blocked explorer
138
+ // treads in place instead of skating.
139
+ const travelled = Math.hypot(anchor.x - this.#last.x, anchor.z - this.#last.z);
140
+ this.speed = travelled / Math.max(1e-4, dt);
141
+ this.#last = { x: anchor.x, z: anchor.z };
142
+ this.position.x = anchor.x;
143
+ this.position.z = anchor.z;
144
+
145
+ const pace = paceThrough(snow.depth, snow.sample(anchor.x, anchor.z).compaction, running);
146
+ const length = Math.hypot(move.x, move.z);
147
+ const scale = length > 1 ? 1 / length : 1;
148
+ const moving = length > 0.01;
149
+ this.#velocity.x = damp(this.#velocity.x, move.x * scale * pace, moving ? 5 : 8, dt);
150
+ this.#velocity.z = damp(this.#velocity.z, move.z * scale * pace, moving ? 5 : 8, dt);
151
+ if (!moving && Math.hypot(this.#velocity.x, this.#velocity.z) < 0.025) {
152
+ this.#velocity.x = 0;
153
+ this.#velocity.z = 0;
154
+ }
155
+ this.body.velocity.x = this.#velocity.x;
156
+ this.body.velocity.z = this.#velocity.z;
157
+ this.body.moveAndSlide(dt);
158
+
159
+ if (this.speed > 0.05) {
160
+ const desired = Math.atan2(this.#velocity.x, this.#velocity.z);
161
+ const turn = Math.atan2(Math.sin(desired - this.heading), Math.cos(desired - this.heading));
162
+ this.heading += turn * (1 - Math.exp(-7 * dt));
163
+ }
164
+ this.#cycle += travelled / (running ? 1.22 : 1.04);
165
+ this.#stepFeet(dt, running, hardness);
166
+
167
+ const sink = this.#sinkDepth(hardness) * 0.6;
168
+ const bob =
169
+ this.speed > 0.02
170
+ ? Math.cos(this.#cycle * Math.PI * 4) * 0.016
171
+ : Math.sin(this.#elapsed * 1.8) * 0.003;
172
+ this.position.y = damp(
173
+ this.position.y,
174
+ terrainHeight(anchor.x, anchor.z) + snow.depth - sink + bob,
175
+ 14,
176
+ dt,
177
+ );
178
+ this.model.pose(
179
+ this.position,
180
+ this.heading,
181
+ this.#feet,
182
+ this.#cycle,
183
+ this.speed,
184
+ this.#elapsed,
185
+ );
186
+ }
187
+
188
+ /** How far an 80 kg boot sinks in this snow, for the body's visual height. */
189
+ #sinkDepth(hardness: number): number {
190
+ const pressure = (MASS * GRAVITY) / BOOT_AREA;
191
+ const resistance = 18_000 + clamp(hardness, 0, 1) ** 1.5 * 140_000;
192
+ return clamp(this.#snow.depth * (0.16 + pressure / resistance), 0, this.#snow.depth * 0.82);
193
+ }
194
+
195
+ #stepFeet(dt: number, running: boolean, hardness: number): void {
196
+ const snow = this.#snow;
197
+ const forward = { x: Math.sin(this.heading), z: Math.cos(this.heading) };
198
+ const right = { x: Math.cos(this.heading), z: -Math.sin(this.heading) };
199
+ for (const foot of this.#feet) {
200
+ const phase = (this.#cycle + (foot.side > 0 ? 0.5 : 0)) % 1;
201
+ if (!foot.swing && phase >= 0.58 && this.speed > 0.08) {
202
+ foot.swing = true;
203
+ foot.progress = 0;
204
+ foot.stop = 0;
205
+ foot.from = { x: foot.x, z: foot.z };
206
+ foot.angle = this.heading;
207
+ const reach = running ? 0.64 : 0.49;
208
+ foot.to = {
209
+ x: this.position.x + forward.x * reach + right.x * foot.side * STANCE,
210
+ z: this.position.z + forward.z * reach + right.z * foot.side * STANCE,
211
+ };
212
+ }
213
+ if (foot.swing) {
214
+ if (phase < 0.58 && this.speed > 0.08) {
215
+ this.#plant(foot, running, hardness);
216
+ continue;
217
+ }
218
+ let progress = clamp((phase - 0.58) / 0.42, 0, 1);
219
+ if (this.speed < 0.08) {
220
+ foot.stop += dt * 3.2;
221
+ progress = Math.max(foot.progress, clamp(foot.progress + foot.stop, 0, 1));
222
+ }
223
+ foot.progress = progress;
224
+ const eased = smoothstep(0, 1, progress);
225
+ foot.x = lerp(foot.from.x, foot.to.x, eased);
226
+ foot.z = lerp(foot.from.z, foot.to.z, eased);
227
+ const lift =
228
+ Math.sin(progress * Math.PI) * (0.15 + snow.depth * 0.3 + (running ? 0.07 : 0));
229
+ foot.y = this.#surface(foot.x, foot.z) + 0.14 + lift;
230
+ if (progress >= 0.999) this.#plant(foot, running, hardness);
231
+ } else foot.y = this.#surface(foot.x, foot.z) + 0.14;
232
+ }
233
+ }
234
+
235
+ #surface(x: number, z: number): number {
236
+ const half = this.#snow.field.width / 2 - 1e-3;
237
+ return this.#snow.heightAt(clamp(x, -half, half), clamp(z, -half, half));
238
+ }
239
+
240
+ #plant(foot: IFoot, running: boolean, hardness: number): void {
241
+ foot.x = foot.to.x;
242
+ foot.z = foot.to.z;
243
+ foot.swing = false;
244
+ foot.stop = 0;
245
+ // A boot only presses snow when the body is standing on it: a jump or a fall plants nothing.
246
+ const penetration = this.body.grounded
247
+ ? this.#snow.stamp({
248
+ area: BOOT_AREA,
249
+ footprint: bootPrint,
250
+ hardness,
251
+ load: MASS * GRAVITY * (running ? 1.2 : 1),
252
+ rotation: foot.angle,
253
+ x: foot.x,
254
+ z: foot.z,
255
+ })
256
+ : 0;
257
+ if (penetration > 0) this.steps += 1;
258
+ foot.y = this.#surface(foot.x, foot.z) + 0.14;
259
+ this.#onStep({
260
+ angle: foot.angle,
261
+ penetration,
262
+ side: foot.side,
263
+ speed: this.speed,
264
+ x: foot.x,
265
+ y: foot.y - 0.12,
266
+ z: foot.z,
267
+ });
268
+ }
269
+
270
+ debug(): Record<string, unknown> {
271
+ return {
272
+ grounded: this.body.grounded,
273
+ heading: this.heading,
274
+ position: [this.position.x, this.position.y, this.position.z],
275
+ speed: this.speed,
276
+ steps: this.steps,
277
+ };
278
+ }
279
+ }
@@ -0,0 +1,69 @@
1
+ import { defineGame } from "@threenative/core";
2
+ import { playtest } from "@threenative/core/playtest";
3
+ import type { IPhysicsContext } from "@threenative/physics";
4
+ import { rapier } from "@threenative/physics";
5
+ import config from "../threenative.config.js";
6
+ import { type Command, commands } from "./commands.js";
7
+ import { Boot } from "./scenes/Boot.js";
8
+ import { Snow } from "./scenes/Snow.js";
9
+ import type { GameState } from "./state.js";
10
+
11
+ const game = defineGame<GameState, IPhysicsContext>({
12
+ input: {
13
+ move: {
14
+ down: ["ArrowDown", "KeyS"],
15
+ left: ["ArrowLeft", "KeyA"],
16
+ right: ["ArrowRight", "KeyD"],
17
+ up: ["ArrowUp", "KeyW"],
18
+ },
19
+ run: { keys: ["ShiftLeft", "ShiftRight"] },
20
+ auto: { keys: ["KeyP"] },
21
+ blizzard: { keys: ["KeyB"] },
22
+ compaction: { keys: ["KeyV"] },
23
+ drop: { keys: ["KeyF"] },
24
+ kick: { keys: ["KeyG"] },
25
+ mute: { keys: ["KeyM"] },
26
+ reset: { keys: ["KeyR"] },
27
+ view: { keys: ["KeyC"] },
28
+ zoom: { pinch: true, scroll: true },
29
+ },
30
+ plugins: [rapier({ gravity: { x: 0, y: -9.81, z: 0 } }), playtest()],
31
+ display: config.display,
32
+ render: config.renderer,
33
+ scenes: { boot: Boot, snow: Snow },
34
+ seed: 2_024,
35
+ start: "boot",
36
+ });
37
+
38
+ export default game;
39
+
40
+ /** Settings the panel may change directly. Anything else in a `set` intent is ignored. */
41
+ const SETTINGS = new Set<keyof GameState>([
42
+ "snowfall",
43
+ "depth",
44
+ "fallSpeed",
45
+ "hardness",
46
+ "wind",
47
+ "recovery",
48
+ "compaction",
49
+ ]);
50
+ const COMMANDS = new Set<Command>(["reset", "drop", "kick", "view", "auto", "blizzard", "mute"]);
51
+
52
+ game.ui.onIntent((intent, payload) => {
53
+ if (intent === "pause") game.pause();
54
+ if (intent === "resume") game.resume();
55
+ if (intent === "set" && typeof payload === "object" && payload !== null) {
56
+ const { key, value } = payload as { key?: string; value?: unknown };
57
+ if (
58
+ SETTINGS.has(key as keyof GameState) &&
59
+ (typeof value === "number" || typeof value === "boolean")
60
+ )
61
+ game.state.set({ [key as string]: value } as Partial<GameState>);
62
+ }
63
+ if (COMMANDS.has(intent as Command)) commands.push(intent as Command);
64
+ game.state.set({
65
+ uiReady: game.ui.connected,
66
+ ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
67
+ } as Partial<GameState>);
68
+ game.state.flush();
69
+ });
@@ -0,0 +1,15 @@
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
+
8
+ import.meta.hot?.accept();
9
+ acceptHotUpdate(game, import.meta.hot);
10
+ const root = document.getElementById("root");
11
+ if (root === null) throw new Error("Missing #root element.");
12
+ const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
13
+ const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
14
+ appRoot.__threenativeRoot = reactRoot;
15
+ reactRoot.render(createElement(App, { game }));