create-threenative 0.2.6 → 0.2.8

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 (756) hide show
  1. package/README.md +5 -3
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +607 -26
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +801 -24
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +300 -56
  19. package/dist/threenative.js +717 -156
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rain/AGENTS.md +96 -0
  218. package/templates/rain/CLAUDE.md +98 -0
  219. package/templates/rain/assets/rain-loop.wav +0 -0
  220. package/templates/rain/assets/thunder.wav +0 -0
  221. package/templates/rain/assets/wind-loop.wav +0 -0
  222. package/templates/rain/index.html +18 -0
  223. package/templates/rain/kit.json +7 -0
  224. package/templates/rain/native-playtests/boot.playtest.json +13 -0
  225. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  226. package/templates/rain/package.json +56 -0
  227. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  228. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  229. package/templates/rain/playtests/automation.playtest.json +133 -0
  230. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  231. package/templates/rain/playtests/flash.playtest.json +27 -0
  232. package/templates/rain/playtests/fly.playtest.json +54 -0
  233. package/templates/rain/playtests/lightning.playtest.json +220 -0
  234. package/templates/rain/playtests/loading.playtest.json +57 -0
  235. package/templates/rain/playtests/paused.playtest.json +59 -0
  236. package/templates/rain/playtests/performance.playtest.json +22 -0
  237. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  238. package/templates/rain/playtests/simulation.playtest.json +20 -0
  239. package/templates/rain/playtests/storm.playtest.json +150 -0
  240. package/templates/rain/playtests/survives.playtest.json +58 -0
  241. package/templates/rain/playtests/tiers.playtest.json +179 -0
  242. package/templates/rain/playtests/weather.playtest.json +77 -0
  243. package/templates/rain/public/favicon.svg +5 -0
  244. package/templates/rain/src/audio/storm.ts +314 -0
  245. package/templates/rain/src/game.ts +114 -0
  246. package/templates/rain/src/render/bloom-shader.ts +65 -0
  247. package/templates/rain/src/render/camera.ts +160 -0
  248. package/templates/rain/src/render/clouds-shader.ts +242 -0
  249. package/templates/rain/src/render/clouds.ts +142 -0
  250. package/templates/rain/src/render/lighting.ts +39 -0
  251. package/templates/rain/src/render/lightning.ts +360 -0
  252. package/templates/rain/src/render/loading.ts +327 -0
  253. package/templates/rain/src/render/materials.ts +19 -0
  254. package/templates/rain/src/render/noise-volume.ts +159 -0
  255. package/templates/rain/src/render/palette.ts +18 -0
  256. package/templates/rain/src/render/post-shader.ts +178 -0
  257. package/templates/rain/src/render/postprocessing.ts +226 -0
  258. package/templates/rain/src/render/quality.ts +135 -0
  259. package/templates/rain/src/render/rain.ts +299 -0
  260. package/templates/rain/src/render/sky.ts +28 -0
  261. package/templates/rain/src/render/world-shader.ts +680 -0
  262. package/templates/rain/src/render/world.ts +146 -0
  263. package/templates/{defense → rain}/src/render/worldEnvironment.ts +52 -1
  264. package/templates/rain/src/scenes/Boot.ts +334 -0
  265. package/templates/rain/src/state.ts +257 -0
  266. package/templates/rain/src/style.css +1160 -0
  267. package/templates/rain/src/ui/App.tsx +29 -0
  268. package/templates/rain/src/ui/GameUi.tsx +187 -0
  269. package/templates/rain/src/ui/Hud.tsx +327 -0
  270. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  271. package/templates/rain/src/ui/Menu.tsx +370 -0
  272. package/templates/rain/src/ui/automation.ts +60 -0
  273. package/templates/rain/src/ui/main.tsx +7 -0
  274. package/templates/rain/src/ui/tempest.ts +149 -0
  275. package/templates/rain/tailwind.config.ts +2 -0
  276. package/templates/rain/threenative.config.ts +66 -0
  277. package/templates/rain/tools/generate-shaders.mjs +656 -0
  278. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  279. package/templates/rain/tools/storm-dsp.mjs +177 -0
  280. package/templates/rain/tools/tempest-bloom.frag +10 -0
  281. package/templates/rain/tools/tempest-clouds.frag +86 -0
  282. package/templates/rain/tools/tempest-post.frag +47 -0
  283. package/templates/rain/tools/tempest-world.frag +210 -0
  284. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  285. package/templates/rain/tsconfig.json +17 -0
  286. package/templates/rain/vite.config.ts +37 -0
  287. package/templates/rts/.codex/config.toml +19 -0
  288. package/templates/rts/.cursor/mcp.json +32 -0
  289. package/templates/rts/.gemini/settings.json +32 -0
  290. package/templates/rts/.mcp.json +32 -0
  291. package/templates/rts/.vscode/mcp.json +36 -0
  292. package/templates/rts/.zed/settings.json +36 -0
  293. package/templates/rts/AGENTS.md +96 -0
  294. package/templates/rts/CLAUDE.md +98 -0
  295. package/templates/rts/kit.json +7 -0
  296. package/templates/rts/opencode.json +41 -0
  297. package/templates/{defense → rts}/package.json +13 -7
  298. package/templates/rts/playtests/performance.playtest.json +41 -0
  299. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  300. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  301. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  302. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  303. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  304. package/templates/rts/playtests/survives.playtest.json +58 -0
  305. package/templates/rts/public/favicon.svg +4 -0
  306. package/templates/rts/src/game.ts +64 -0
  307. package/templates/rts/src/main.ts +15 -0
  308. package/templates/rts/src/orders.ts +22 -0
  309. package/templates/rts/src/render/army.ts +346 -0
  310. package/templates/rts/src/render/camera.ts +123 -0
  311. package/templates/rts/src/render/lighting.ts +61 -0
  312. package/templates/rts/src/render/loading.ts +33 -0
  313. package/templates/rts/src/render/materials.ts +152 -0
  314. package/templates/rts/src/render/models.ts +705 -0
  315. package/templates/rts/src/render/palette.ts +17 -0
  316. package/templates/rts/src/render/picking.ts +93 -0
  317. package/templates/rts/src/render/postprocessing.ts +46 -0
  318. package/templates/rts/src/render/quality.ts +128 -0
  319. package/templates/rts/src/render/resources.ts +141 -0
  320. package/templates/rts/src/render/sky.ts +44 -0
  321. package/templates/rts/src/render/terrain.ts +116 -0
  322. package/templates/rts/src/render/worldEnvironment.ts +809 -0
  323. package/templates/rts/src/scenes/Play.ts +650 -0
  324. package/templates/rts/src/sim/ai.ts +1140 -0
  325. package/templates/rts/src/sim/combat.ts +416 -0
  326. package/templates/rts/src/sim/construction.ts +374 -0
  327. package/templates/rts/src/sim/economy.ts +167 -0
  328. package/templates/rts/src/sim/game.ts +1082 -0
  329. package/templates/rts/src/sim/movement.ts +371 -0
  330. package/templates/rts/src/sim/nav.ts +276 -0
  331. package/templates/rts/src/sim/production.ts +180 -0
  332. package/templates/rts/src/sim/terrain.ts +170 -0
  333. package/templates/rts/src/sim/types.ts +647 -0
  334. package/templates/rts/src/sim/vision.ts +46 -0
  335. package/templates/rts/src/state.ts +100 -0
  336. package/templates/{defense → rts}/src/style.css +21 -8
  337. package/templates/rts/src/ui/App.tsx +21 -0
  338. package/templates/rts/src/ui/Commands.tsx +129 -0
  339. package/templates/rts/src/ui/GameUi.tsx +22 -0
  340. package/templates/rts/src/ui/Hud.tsx +165 -0
  341. package/templates/rts/src/ui/Minimap.tsx +84 -0
  342. package/templates/rts/tailwind.config.ts +2 -0
  343. package/templates/rts/threenative.config.ts +56 -0
  344. package/templates/rts/tsconfig.json +17 -0
  345. package/templates/{defense → rts}/vite.config.ts +4 -1
  346. package/templates/runner/AGENTS.md +6 -10
  347. package/templates/runner/CLAUDE.md +6 -10
  348. package/templates/runner/README.md +3 -3
  349. package/templates/runner/package.json +13 -7
  350. package/templates/runner/playtests/performance.playtest.json +2 -2
  351. package/templates/runner/src/conventions.ts +4 -3
  352. package/templates/runner/src/entities/Runner.ts +54 -7
  353. package/templates/runner/src/game.ts +2 -0
  354. package/templates/runner/src/render/camera.ts +4 -2
  355. package/templates/runner/src/render/dust.ts +5 -2
  356. package/templates/runner/src/render/lighting.ts +41 -45
  357. package/templates/runner/src/render/loading.ts +2 -2
  358. package/templates/runner/src/render/materials.ts +165 -25
  359. package/templates/runner/src/render/palette.ts +17 -28
  360. package/templates/runner/src/render/postprocessing.ts +12 -2
  361. package/templates/runner/src/render/quality.ts +42 -96
  362. package/templates/runner/src/render/shapes.ts +59 -37
  363. package/templates/runner/src/render/sky.ts +32 -41
  364. package/templates/runner/src/render/touch-controls.ts +1 -1
  365. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  366. package/templates/runner/src/scenes/Run.ts +26 -6
  367. package/templates/runner/src/track.ts +6 -1
  368. package/templates/runner/threenative.config.ts +14 -1
  369. package/templates/runner/vite.config.ts +4 -1
  370. package/templates/sailing/AGENTS.md +12 -12
  371. package/templates/sailing/CLAUDE.md +12 -12
  372. package/templates/sailing/assets/ship.glb +0 -0
  373. package/templates/sailing/package.json +13 -7
  374. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  375. package/templates/sailing/playtests/sails.playtest.json +33 -0
  376. package/templates/sailing/playtests/win.playtest.json +156 -8
  377. package/templates/sailing/src/conventions.ts +29 -2
  378. package/templates/sailing/src/entities/Ship.ts +381 -57
  379. package/templates/sailing/src/game.ts +14 -0
  380. package/templates/sailing/src/render/camera.ts +63 -9
  381. package/templates/sailing/src/render/lighting.ts +49 -27
  382. package/templates/sailing/src/render/materials.ts +50 -15
  383. package/templates/sailing/src/render/ocean.ts +647 -60
  384. package/templates/sailing/src/render/palette.ts +16 -12
  385. package/templates/sailing/src/render/postprocessing.ts +12 -2
  386. package/templates/sailing/src/render/props.ts +316 -442
  387. package/templates/sailing/src/render/quality.ts +14 -4
  388. package/templates/sailing/src/render/sky.ts +116 -23
  389. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  390. package/templates/sailing/src/scenes/Boot.ts +21 -0
  391. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  392. package/templates/sailing/src/state.ts +6 -0
  393. package/templates/sailing/src/ui/Hud.tsx +41 -9
  394. package/templates/sailing/threenative.config.ts +14 -1
  395. package/templates/sailing/vite.config.ts +4 -1
  396. package/templates/shooter/AGENTS.md +27 -42
  397. package/templates/shooter/CLAUDE.md +27 -42
  398. package/templates/shooter/index.html +1 -0
  399. package/templates/shooter/package.json +13 -7
  400. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  401. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  402. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  403. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  404. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  405. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  406. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  407. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  408. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  409. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  410. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  411. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  412. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  413. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  414. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  415. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  416. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  417. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  418. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  419. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  420. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  421. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  422. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  423. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  424. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  425. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  426. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  427. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  428. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  429. package/templates/shooter/playtests/performance.playtest.json +62 -26
  430. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  431. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  432. package/templates/shooter/playtests/survives.playtest.json +36 -30
  433. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  434. package/templates/shooter/src/entities/Breakables.ts +412 -0
  435. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  436. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  437. package/templates/shooter/src/entities/Rifle.ts +442 -0
  438. package/templates/shooter/src/entities/Target.ts +199 -83
  439. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  440. package/templates/shooter/src/game.ts +75 -41
  441. package/templates/shooter/src/main.ts +0 -1
  442. package/templates/shooter/src/postPhysics.ts +36 -0
  443. package/templates/shooter/src/render/camera.ts +78 -74
  444. package/templates/shooter/src/render/decals.ts +142 -82
  445. package/templates/shooter/src/render/facade.ts +1373 -0
  446. package/templates/shooter/src/render/gunfx.ts +704 -0
  447. package/templates/shooter/src/render/lighting.ts +52 -38
  448. package/templates/shooter/src/render/loading.ts +2 -2
  449. package/templates/shooter/src/render/materials.ts +100 -88
  450. package/templates/shooter/src/render/occlusion.ts +108 -0
  451. package/templates/shooter/src/render/palette.ts +10 -10
  452. package/templates/shooter/src/render/palm.ts +455 -0
  453. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  454. package/templates/shooter/src/render/postprocessing.ts +15 -3
  455. package/templates/shooter/src/render/quality.ts +40 -82
  456. package/templates/shooter/src/render/scale.ts +148 -15
  457. package/templates/shooter/src/render/shapes.ts +138 -613
  458. package/templates/shooter/src/render/sky.ts +35 -35
  459. package/templates/shooter/src/render/town-schematic.ts +120 -0
  460. package/templates/shooter/src/render/town.ts +986 -0
  461. package/templates/shooter/src/render/townMaterials.ts +160 -0
  462. package/templates/shooter/src/render/vehicles.ts +741 -0
  463. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  464. package/templates/shooter/src/scenes/Play.ts +727 -650
  465. package/templates/shooter/src/state.ts +26 -41
  466. package/templates/shooter/src/style.css +207 -11
  467. package/templates/shooter/src/surfaces.ts +131 -0
  468. package/templates/shooter/src/ui/App.tsx +9 -10
  469. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  470. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  471. package/templates/shooter/src/ui/Hud.tsx +428 -39
  472. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  473. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  474. package/templates/shooter/src/ui/main.tsx +2 -3
  475. package/templates/shooter/threenative.config.ts +14 -1
  476. package/templates/shooter/vite.config.ts +4 -1
  477. package/templates/snow/.codex/config.toml +19 -0
  478. package/templates/snow/.cursor/mcp.json +32 -0
  479. package/templates/snow/.gemini/settings.json +32 -0
  480. package/templates/snow/.mcp.json +32 -0
  481. package/templates/snow/.vscode/mcp.json +36 -0
  482. package/templates/snow/.zed/settings.json +36 -0
  483. package/templates/snow/AGENTS.md +88 -0
  484. package/templates/snow/CLAUDE.md +90 -0
  485. package/templates/snow/README.md +26 -0
  486. package/templates/snow/assets/crunch.wav +0 -0
  487. package/templates/snow/assets/wind.wav +0 -0
  488. package/templates/snow/index.html +12 -0
  489. package/templates/snow/kit.json +7 -0
  490. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  491. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  492. package/templates/snow/opencode.json +41 -0
  493. package/templates/snow/package.json +58 -0
  494. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  495. package/templates/{defense → snow}/playtests/performance.playtest.json +4 -7
  496. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  497. package/templates/{defense → snow}/playtests/survives.playtest.json +26 -6
  498. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  499. package/templates/snow/playtests/weather.playtest.json +119 -0
  500. package/templates/snow/public/favicon.svg +5 -0
  501. package/templates/snow/src/audio.ts +58 -0
  502. package/templates/snow/src/commands.ts +8 -0
  503. package/templates/snow/src/entities/Explorer.ts +279 -0
  504. package/templates/snow/src/game.ts +69 -0
  505. package/templates/snow/src/main.ts +15 -0
  506. package/templates/snow/src/render/bootPrint.ts +50 -0
  507. package/templates/snow/src/render/camera.ts +84 -0
  508. package/templates/snow/src/render/explorer.ts +321 -0
  509. package/templates/snow/src/render/lighting.ts +50 -0
  510. package/templates/snow/src/render/loading.ts +325 -0
  511. package/templates/snow/src/render/materials.ts +36 -0
  512. package/templates/snow/src/render/palette.ts +17 -0
  513. package/templates/{defense → snow}/src/render/postprocessing.ts +12 -2
  514. package/templates/snow/src/render/props.ts +42 -0
  515. package/templates/{defense → snow}/src/render/quality.ts +37 -72
  516. package/templates/snow/src/render/scenery.ts +244 -0
  517. package/templates/snow/src/render/sky.ts +57 -0
  518. package/templates/snow/src/render/snowSurface.ts +259 -0
  519. package/templates/snow/src/render/touch-controls.ts +143 -0
  520. package/templates/snow/src/render/weather.ts +279 -0
  521. package/templates/snow/src/render/worldEnvironment.ts +809 -0
  522. package/templates/{defense → snow}/src/scenes/Boot.ts +4 -4
  523. package/templates/snow/src/scenes/Snow.ts +635 -0
  524. package/templates/snow/src/state.ts +46 -0
  525. package/templates/snow/src/style.css +143 -0
  526. package/templates/snow/src/terrain.ts +64 -0
  527. package/templates/snow/src/ui/App.tsx +15 -0
  528. package/templates/snow/src/ui/Controls.tsx +322 -0
  529. package/templates/snow/src/ui/GameUi.tsx +354 -0
  530. package/templates/snow/src/ui/icons.tsx +54 -0
  531. package/templates/snow/src/ui/main.tsx +7 -0
  532. package/templates/snow/tailwind.config.ts +2 -0
  533. package/templates/snow/threenative.config.ts +51 -0
  534. package/templates/snow/tsconfig.json +17 -0
  535. package/templates/snow/vite.config.ts +37 -0
  536. package/templates/starter/AGENTS.md +17 -17
  537. package/templates/starter/CLAUDE.md +17 -17
  538. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  539. package/templates/starter/package.json +13 -7
  540. package/templates/starter/playtests/play.playtest.json +2 -1
  541. package/templates/starter/playtests/survives.playtest.json +1 -1
  542. package/templates/starter/src/conventions.ts +6 -3
  543. package/templates/starter/src/entities/Goal.ts +35 -42
  544. package/templates/starter/src/entities/Player.ts +99 -16
  545. package/templates/starter/src/render/arena.ts +131 -0
  546. package/templates/starter/src/render/lighting.ts +27 -44
  547. package/templates/starter/src/render/materials.ts +164 -35
  548. package/templates/starter/src/render/palette.ts +16 -16
  549. package/templates/starter/src/render/postprocessing.ts +6 -7
  550. package/templates/starter/src/render/quality.ts +43 -101
  551. package/templates/starter/src/render/shapes.ts +1 -1
  552. package/templates/starter/src/render/sky.ts +39 -45
  553. package/templates/starter/src/render/touch-controls.ts +3 -1
  554. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  555. package/templates/starter/src/scenes/Play.ts +82 -81
  556. package/templates/starter/threenative.config.ts +14 -1
  557. package/templates/starter/vite.config.ts +4 -1
  558. package/templates/tower-defense/.codex/config.toml +19 -0
  559. package/templates/tower-defense/.cursor/mcp.json +32 -0
  560. package/templates/tower-defense/.gemini/settings.json +32 -0
  561. package/templates/tower-defense/.mcp.json +32 -0
  562. package/templates/tower-defense/.vscode/mcp.json +36 -0
  563. package/templates/tower-defense/.zed/settings.json +36 -0
  564. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  565. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  566. package/templates/tower-defense/README.md +16 -0
  567. package/templates/tower-defense/index.html +12 -0
  568. package/templates/tower-defense/kit.json +7 -0
  569. package/templates/tower-defense/opencode.json +41 -0
  570. package/templates/tower-defense/package.json +56 -0
  571. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  572. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  573. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  574. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  575. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  576. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  577. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  578. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  579. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  580. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  581. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  582. package/templates/tower-defense/src/balance.ts +187 -0
  583. package/templates/tower-defense/src/board/Board.ts +100 -0
  584. package/templates/tower-defense/src/board/Route.ts +84 -0
  585. package/templates/tower-defense/src/camera-rig.ts +62 -0
  586. package/templates/tower-defense/src/economy.ts +64 -0
  587. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  588. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  589. package/templates/tower-defense/src/game.ts +72 -0
  590. package/templates/tower-defense/src/intents.ts +21 -0
  591. package/templates/tower-defense/src/main.ts +15 -0
  592. package/templates/tower-defense/src/physics.ts +6 -0
  593. package/templates/tower-defense/src/render/camera.ts +38 -0
  594. package/templates/tower-defense/src/render/lighting.ts +42 -0
  595. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  596. package/templates/tower-defense/src/render/materials.ts +103 -0
  597. package/templates/tower-defense/src/render/palette.ts +58 -0
  598. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  599. package/templates/tower-defense/src/render/quality.ts +128 -0
  600. package/templates/tower-defense/src/render/shapes.ts +550 -0
  601. package/templates/tower-defense/src/render/sky.ts +27 -0
  602. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  603. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  604. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  605. package/templates/tower-defense/src/state.ts +88 -0
  606. package/templates/tower-defense/src/style.css +137 -0
  607. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  608. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  609. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  610. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  611. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  612. package/templates/tower-defense/src/ui/main.tsx +14 -0
  613. package/templates/tower-defense/src/waves.ts +90 -0
  614. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  615. package/templates/tower-defense/vite.config.ts +41 -0
  616. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  617. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  618. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  619. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  620. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  621. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  622. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  623. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  624. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  625. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  626. package/agent-files/AGENT-ROLES.md +0 -26
  627. package/templates/action-rpg/src/render/shapes.ts +0 -269
  628. package/templates/action-rpg/src/render/types.ts +0 -3
  629. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  630. package/templates/defense/README.md +0 -10
  631. package/templates/defense/kit.json +0 -7
  632. package/templates/defense/playtests/leak.playtest.json +0 -23
  633. package/templates/defense/playtests/placement.playtest.json +0 -40
  634. package/templates/defense/playtests/scan.playtest.json +0 -20
  635. package/templates/defense/playtests/survive.playtest.json +0 -45
  636. package/templates/defense/src/attackers/Attacker.ts +0 -120
  637. package/templates/defense/src/board/Route.ts +0 -94
  638. package/templates/defense/src/conventions.ts +0 -18
  639. package/templates/defense/src/economy.ts +0 -36
  640. package/templates/defense/src/entities/Player.ts +0 -52
  641. package/templates/defense/src/game.ts +0 -51
  642. package/templates/defense/src/physics.ts +0 -13
  643. package/templates/defense/src/placement/Buildable.ts +0 -49
  644. package/templates/defense/src/render/camera.ts +0 -16
  645. package/templates/defense/src/render/lighting.ts +0 -37
  646. package/templates/defense/src/render/materials.ts +0 -22
  647. package/templates/defense/src/render/palette.ts +0 -28
  648. package/templates/defense/src/render/shapes.ts +0 -246
  649. package/templates/defense/src/render/sky.ts +0 -45
  650. package/templates/defense/src/scenes/Defense.ts +0 -231
  651. package/templates/defense/src/state.ts +0 -56
  652. package/templates/defense/src/towers/Tower.ts +0 -95
  653. package/templates/defense/src/towers/targeting.ts +0 -53
  654. package/templates/defense/src/ui/Hud.tsx +0 -62
  655. package/templates/defense/src/ui/Menu.tsx +0 -7
  656. package/templates/defense/src/waves.ts +0 -40
  657. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  658. package/templates/minimal/src/render/hud.ts +0 -69
  659. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  660. package/templates/platformer/playtests/chase.playtest.json +0 -21
  661. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  662. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  663. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  664. package/templates/platformer/playtests/physics.playtest.json +0 -14
  665. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  666. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  667. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  668. package/templates/platformer/src/conventions.ts +0 -18
  669. package/templates/platformer/src/entities/Character.ts +0 -286
  670. package/templates/platformer/src/entities/Chaser.ts +0 -118
  671. package/templates/platformer/src/entities/Patrol.ts +0 -93
  672. package/templates/platformer/src/level/Platform.ts +0 -46
  673. package/templates/platformer/src/render/rig.ts +0 -60
  674. package/templates/platformer/src/render/terrain.ts +0 -31
  675. package/templates/platformer/src/scenes/Level.ts +0 -241
  676. package/templates/puzzle/README.md +0 -43
  677. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  678. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  679. package/templates/puzzle/src/conventions.ts +0 -25
  680. package/templates/puzzle/src/entities/Ball.ts +0 -70
  681. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  682. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  683. package/templates/puzzle/src/physics.ts +0 -19
  684. package/templates/puzzle/src/room.ts +0 -83
  685. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  686. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  687. package/templates/shooter/playtests/combat.playtest.json +0 -48
  688. package/templates/shooter/playtests/fail.playtest.json +0 -31
  689. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  690. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  691. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  692. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  693. package/templates/shooter/src/combat/damage.ts +0 -40
  694. package/templates/shooter/src/conventions.ts +0 -51
  695. package/templates/shooter/src/entities/Pickup.ts +0 -70
  696. package/templates/shooter/src/entities/Player.ts +0 -310
  697. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  698. package/templates/shooter/src/playtest-events.ts +0 -15
  699. package/templates/shooter/src/render/touch-controls.ts +0 -305
  700. package/templates/shooter/src/render/types.ts +0 -3
  701. package/templates/shooter/src/render/ui.css +0 -330
  702. package/templates/shooter/src/render/ui.ts +0 -75
  703. package/templates/shooter/src/render/vfx.ts +0 -215
  704. package/templates/shooter/src/ui/Menu.tsx +0 -41
  705. package/templates/shooter/src/waves.ts +0 -50
  706. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  707. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  708. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  709. package/templates/starter/playtests/assets.playtest.json +0 -65
  710. package/templates/starter/playtests/buffer.playtest.json +0 -79
  711. package/templates/starter/playtests/cloth.playtest.json +0 -113
  712. package/templates/starter/playtests/coyote.playtest.json +0 -87
  713. package/templates/starter/playtests/gameover.playtest.json +0 -66
  714. package/templates/starter/playtests/goal.playtest.json +0 -67
  715. package/templates/starter/playtests/look.playtest.json +0 -175
  716. package/templates/starter/playtests/models-baseline.png +0 -0
  717. package/templates/starter/playtests/models.playtest.json +0 -74
  718. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  719. package/templates/starter/playtests/odometer.playtest.json +0 -54
  720. package/templates/starter/playtests/restart.playtest.json +0 -91
  721. package/templates/starter/playtests/seed.playtest.json +0 -54
  722. package/templates/starter/playtests/textures-baseline.png +0 -0
  723. package/templates/starter/playtests/textures.playtest.json +0 -74
  724. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  725. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  726. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  727. package/templates/starter/src/render/coast.ts +0 -199
  728. package/templates/starter/src/render/hero.ts +0 -88
  729. package/templates/starter/src/render/implicitSurface.ts +0 -199
  730. package/templates/starter/src/render/kuwahara.ts +0 -174
  731. package/templates/starter/src/render/outline.ts +0 -141
  732. package/templates/starter/src/render/painterly.ts +0 -86
  733. package/templates/starter/src/render/rockRidge.ts +0 -198
  734. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  735. package/templates/starter/src/render/scenery.ts +0 -40
  736. package/templates/starter/src/render/textureLifetime.ts +0 -53
  737. package/templates/starter/src/render/water.ts +0 -38
  738. package/templates/starter/src/render/watercolor.ts +0 -85
  739. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  740. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  741. /package/templates/{defense → rain}/.codex/config.toml +0 -0
  742. /package/templates/{defense → rain}/.cursor/mcp.json +0 -0
  743. /package/templates/{defense → rain}/.gemini/settings.json +0 -0
  744. /package/templates/{defense → rain}/.mcp.json +0 -0
  745. /package/templates/{defense → rain}/.vscode/mcp.json +0 -0
  746. /package/templates/{defense → rain}/.zed/settings.json +0 -0
  747. /package/templates/{defense → rain}/opencode.json +0 -0
  748. /package/templates/{defense → rain}/src/main.ts +0 -0
  749. /package/templates/{defense → rts}/index.html +0 -0
  750. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  751. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  752. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  753. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  754. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  755. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  756. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -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 }));
@@ -0,0 +1,50 @@
1
+ // Generated for you. The boot is a look decision: this profile is what a footprint looks like.
2
+ // Change the sole, the tread or the rim here; `SnowField` only presses whatever shape it is given.
3
+
4
+ /** One sample of a contact profile, in the shape `SnowField.stamp` reads. */
5
+ interface IPrintSample {
6
+ readonly bank: number;
7
+ readonly coverage: number;
8
+ readonly disturbance: number;
9
+ readonly relief: number;
10
+ readonly shape: number;
11
+ }
12
+
13
+ const NOTHING: IPrintSample = { bank: 0, coverage: 0, disturbance: 0, relief: 0, shape: 0 };
14
+
15
+ function smoothstep(edge0: number, edge1: number, value: number): number {
16
+ const t = Math.max(0, Math.min(1, (value - edge0) / (edge1 - edge0)));
17
+ return t * t * (3 - 2 * t);
18
+ }
19
+
20
+ /** The sole's area, m². Load over this is the pressure a planted boot puts on the snow. */
21
+ export const BOOT_AREA = 0.074;
22
+
23
+ /**
24
+ * A rounded boot sole — a slightly wider toe than heel — with raised chevrons, a centre groove,
25
+ * and a rim of displaced snow around it. Local z runs heel to toe.
26
+ */
27
+ export const bootPrint: {
28
+ readonly extent: number;
29
+ readonly sample: (x: number, z: number) => IPrintSample;
30
+ } = {
31
+ extent: 0.48,
32
+ sample: (x, z) => {
33
+ const width = 0.13 + smoothstep(-0.22, 0.15, z) * 0.013;
34
+ const qx = Math.abs(x) - (width - 0.052);
35
+ const qz = Math.abs(z) - (0.255 - 0.052);
36
+ const sdf =
37
+ Math.hypot(Math.max(qx, 0), Math.max(qz, 0)) + Math.min(Math.max(qx, qz), 0) - 0.052;
38
+ if (sdf > 0.105) return NOTHING;
39
+ const tread = Math.max(0, Math.cos(z * 83 + Math.abs(x) * 30)) ** 8;
40
+ const groove = (1 - smoothstep(0.009, 0.023, Math.abs(x))) * 0.004;
41
+ const rim = sdf > 0 ? Math.exp(-(((sdf - 0.027) / 0.027) ** 2)) : 0;
42
+ return {
43
+ bank: rim * (0.78 + 0.22 * Math.sin(x * 94 + z * 63)),
44
+ coverage: 1 - smoothstep(-0.038, 0.008, sdf),
45
+ disturbance: rim * 0.5,
46
+ relief: 0.012 * tread + groove,
47
+ shape: 0.9 + 0.1 * smoothstep(-0.2, 0.15, z),
48
+ };
49
+ },
50
+ };
@@ -0,0 +1,84 @@
1
+ // Generated for you. Framing is a game-owned decision.
2
+ import type { PerspectiveCamera } from "three";
3
+ import type { CameraView } from "../state.js";
4
+
5
+ export function setupCamera(camera: PerspectiveCamera): void {
6
+ camera.fov = fieldOfView(camera.aspect);
7
+ camera.near = 0.075;
8
+ camera.far = 500;
9
+ camera.updateProjectionMatrix();
10
+ }
11
+
12
+ /**
13
+ * Vertical field of view for an aspect ratio. A portrait phone keeps the landscape view's
14
+ * horizontal reach rather than its vertical angle, or the explorer fills the screen.
15
+ */
16
+ export function fieldOfView(aspect: number): number {
17
+ if (aspect >= 1) return 43;
18
+ const horizontal = 2 * Math.atan(Math.tan((43 * Math.PI) / 360) * 1.25);
19
+ const vertical = 2 * Math.atan(Math.tan(horizontal / 2) / aspect);
20
+ return Math.min(70, (vertical * 180) / Math.PI);
21
+ }
22
+
23
+ /** Orbit distance and elevation (radians from straight down) for each view. */
24
+ const VIEWS: Record<CameraView, { readonly radius: number; readonly polar: number }> = {
25
+ // Over the shoulder, high enough that the trail behind the explorer reads.
26
+ follow: { polar: 1.1, radius: 11.6 },
27
+ // Low and close on the last footprint: the tread, the rim and the compaction.
28
+ surface: { polar: 1.22, radius: 3.1 },
29
+ overhead: { polar: 0.23, radius: 19 },
30
+ };
31
+
32
+ /**
33
+ * A damped orbit around a target. Drag and the zoom axis move the goal; the camera eases to it,
34
+ * and never dips under the snow it is looking at.
35
+ */
36
+ export class OrbitFollow {
37
+ yaw = 0.68;
38
+ #polar = VIEWS.follow.polar;
39
+ #radius = VIEWS.follow.radius;
40
+ #goalPolar = VIEWS.follow.polar;
41
+ #goalRadius = VIEWS.follow.radius;
42
+ readonly #target = { x: 0, y: 0.95, z: 0 };
43
+
44
+ setView(view: CameraView): void {
45
+ this.#goalRadius = VIEWS[view].radius;
46
+ this.#goalPolar = VIEWS[view].polar;
47
+ }
48
+
49
+ /** Drag by pixels: sideways turns, vertical tilts. */
50
+ drag(dx: number, dy: number): void {
51
+ this.yaw -= dx * 0.005;
52
+ this.#goalPolar = Math.max(0.12, Math.min(1.43, this.#goalPolar + dy * 0.004));
53
+ }
54
+
55
+ zoom(amount: number): void {
56
+ this.#goalRadius = Math.max(1.65, Math.min(30, this.#goalRadius * Math.exp(-amount * 0.001)));
57
+ }
58
+
59
+ update(
60
+ camera: PerspectiveCamera,
61
+ goal: { readonly x: number; readonly y: number; readonly z: number },
62
+ ground: (x: number, z: number) => number,
63
+ dt: number,
64
+ ): void {
65
+ const ease = 1 - Math.exp(-dt * 4.5);
66
+ const settle = 1 - Math.exp(-dt * 5);
67
+ this.#target.x += (goal.x - this.#target.x) * ease;
68
+ this.#target.y += (goal.y - this.#target.y) * ease;
69
+ this.#target.z += (goal.z - this.#target.z) * ease;
70
+ this.#radius += (this.#goalRadius - this.#radius) * settle;
71
+ this.#polar += (this.#goalPolar - this.#polar) * settle;
72
+ const sine = Math.sin(this.#polar);
73
+ const x = this.#target.x + Math.sin(this.yaw) * sine * this.#radius;
74
+ const z = this.#target.z + Math.cos(this.yaw) * sine * this.#radius;
75
+ const y = this.#target.y + Math.cos(this.#polar) * this.#radius;
76
+ const fov = fieldOfView(camera.aspect);
77
+ if (Math.abs(fov - camera.fov) > 0.01) {
78
+ camera.fov = fov;
79
+ camera.updateProjectionMatrix();
80
+ }
81
+ camera.position.set(x, Math.max(y, ground(x, z) + 0.3), z);
82
+ camera.lookAt(this.#target.x, this.#target.y, this.#target.z);
83
+ }
84
+ }