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,36 @@
1
+ // Generated for you. This file owns every surface the snow kit draws apart from the snow itself
2
+ // (`snowSurface.ts`): change the forest, the explorer's kit or the test bodies entirely from here.
3
+ import { LineBasicMaterial, MeshStandardMaterial } from "three";
4
+ import { palette } from "./palette.js";
5
+
6
+ const matte = (color: number, roughness = 0.92, metalness = 0) =>
7
+ new MeshStandardMaterial({ color, metalness, roughness });
8
+
9
+ export function createMaterials() {
10
+ return {
11
+ trunk: matte(0x5c514a, 1),
12
+ needles: matte(palette.floor, 0.94),
13
+ /** Snow lying on boughs and rock tops: a touch greyer than the field so it reads as separate. */
14
+ bough: matte(0xe2edf3, 0.91),
15
+ rock: matte(0x717d86, 0.94),
16
+ stem: new LineBasicMaterial({ color: 0x877f70, opacity: 0.7, transparent: true }),
17
+ ridge: new MeshStandardMaterial({ roughness: 1, vertexColors: true }),
18
+ coat: matte(palette.accent, 0.86),
19
+ seam: matte(0x995124, 0.98),
20
+ pants: matte(0x35454d, 0.94),
21
+ gaiter: matte(0x25373e, 0.9),
22
+ boot: matte(0x66523c, 0.91),
23
+ rubber: matte(0x25313a, 0.97),
24
+ fur: matte(0xdad7c8, 1),
25
+ skin: matte(0xbc947c, 0.85),
26
+ lens: matte(0x263d47, 0.13, 0.5),
27
+ metal: matte(0xb0b8b5, 0.34, 0.6),
28
+ snowCap: matte(0xe9f1f5, 0.92),
29
+ /** The ball: a slick, dark sphere, so its track reads against white powder. */
30
+ ball: matte(0x2b4352, 0.35, 0.1),
31
+ crate: matte(0x8a6a4a, 0.82),
32
+ log: matte(0x6e5b48, 0.9),
33
+ };
34
+ }
35
+
36
+ export type SnowMaterials = ReturnType<typeof createMaterials>;
@@ -0,0 +1,17 @@
1
+ // Generated for you. These six roles are the snow kit's editable visual vocabulary.
2
+ // A bright overcast glade: the snow is the lightest value in the frame, the sky one step darker
3
+ // and bluer above it, so the horizon still reads. The explorer's coat is the only warm colour.
4
+ export const palette = {
5
+ /** Zenith. */
6
+ skyHigh: 0x5a86a4,
7
+ /** Horizon haze and the fog colour. */
8
+ skyLow: 0xc3d6e3,
9
+ /** Untouched powder. */
10
+ snow: 0xf6f8fc,
11
+ /** Pressed and shadowed snow: the blue a footprint's floor takes. */
12
+ shadow: 0x8aa6c2,
13
+ /** The explorer's coat — the one saturated colour, so the eye finds the character first. */
14
+ accent: 0xc77337,
15
+ /** Conifer needles and the darkest value in the scene. */
16
+ floor: 0x294744,
17
+ } as const;
@@ -22,13 +22,23 @@ export function setupPost(
22
22
  environment: {
23
23
  godraysLight?: DirectionalLight;
24
24
  mobile?: boolean;
25
+ /** The renderer named a software adapter; this game's answer is its `low` tier. */
26
+ software?: boolean;
25
27
  /** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
26
28
  tier?: QualityTier;
27
29
  } = {},
28
30
  ): void {
29
- const tier = resolveQualityTier({ mobile: environment.mobile, tier: environment.tier });
31
+ const tier = resolveQualityTier({
32
+ mobile: environment.mobile,
33
+ software: environment.software,
34
+ tier: environment.tier,
35
+ });
30
36
  const source = environment.tier === undefined ? "platform" : "override";
31
- console.info(`TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} source=${source}`);
37
+ console.info(
38
+ `TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} software=${
39
+ environment.software === true
40
+ } source=${source}`,
41
+ );
32
42
  const world = new WorldEnvironment(qualityPreset(tier));
33
43
  world.apply(renderer, scene, camera, { godraysLight: environment.godraysLight });
34
44
  }
@@ -0,0 +1,42 @@
1
+ // Generated for you. How the test bodies look. Their size comes from their collision shapes in
2
+ // `src/scenes/Snow.ts`; change the look here without touching the physics.
3
+ import { BoxGeometry, CapsuleGeometry, Group, Mesh, SphereGeometry, TorusGeometry } from "three";
4
+ import type { SnowMaterials } from "./materials.js";
5
+
6
+ function shadowed<T extends Mesh>(mesh: T): T {
7
+ mesh.castShadow = true;
8
+ mesh.receiveShadow = true;
9
+ return mesh;
10
+ }
11
+
12
+ /** A dark ball with a pale band, so its roll is visible as it carves. */
13
+ export function createBall(materials: SnowMaterials, radius: number): Group {
14
+ const ball = new Group();
15
+ ball.add(shadowed(new Mesh(new SphereGeometry(radius, 32, 20), materials.ball)));
16
+ ball.add(
17
+ shadowed(new Mesh(new TorusGeometry(radius * 0.995, radius * 0.08, 8, 48), materials.bough)),
18
+ );
19
+ return ball;
20
+ }
21
+
22
+ export function createCrate(
23
+ materials: SnowMaterials,
24
+ size: { readonly x: number; readonly y: number; readonly z: number },
25
+ ): Group {
26
+ const crate = new Group();
27
+ crate.add(shadowed(new Mesh(new BoxGeometry(size.x, size.y, size.z), materials.crate)));
28
+ // A drift of snow on the lid.
29
+ const lid = shadowed(
30
+ new Mesh(new BoxGeometry(size.x * 0.92, 0.03, size.z * 0.9), materials.bough),
31
+ );
32
+ lid.position.y = size.y / 2 + 0.012;
33
+ crate.add(lid);
34
+ return crate;
35
+ }
36
+
37
+ /** A felled log: a capsule lying along its spine. */
38
+ export function createLog(materials: SnowMaterials, halfHeight: number, radius: number): Group {
39
+ const log = new Group();
40
+ log.add(shadowed(new Mesh(new CapsuleGeometry(radius, halfHeight * 2, 6, 16), materials.log)));
41
+ return log;
42
+ }
@@ -19,6 +19,10 @@
19
19
  // probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
20
20
  // in `sky.ts`, not in this file.
21
21
  //
22
+ // **This template runs neither SSGI nor SSR at any tier.** Its frame cost is the snow — a dense
23
+ // deforming heightfield mesh and tens of thousands of flakes — not the post chain, and snow is
24
+ // already the brightest thing on screen, so the chain is tonemapping alone at every tier and the
25
+ // sun glints come from the snow material.
22
26
  import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
23
27
 
24
28
  /**
@@ -49,7 +53,7 @@ function isQualityTier(value: string): value is QualityTier {
49
53
  * turned out to have no effect.
50
54
  */
51
55
  export function resolveQualityTier(
52
- request: { readonly mobile?: boolean; readonly tier?: string } = {},
56
+ request: { readonly mobile?: boolean; readonly software?: boolean; readonly tier?: string } = {},
53
57
  ): QualityTier {
54
58
  const requested = request.tier;
55
59
  if (requested !== undefined) {
@@ -60,99 +64,60 @@ export function resolveQualityTier(
60
64
  }
61
65
  return requested;
62
66
  }
67
+ // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
68
+ // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
69
+ // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
70
+ // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
71
+ // `tier` above still wins over it.
72
+ if (request.software === true) return "low";
63
73
  return request.mobile === true ? "low" : "high";
64
74
  }
65
75
 
66
76
  /**
67
77
  * What a desktop gets: this template's shipped desktop look, unchanged.
68
- *
69
- * The whole chain measured 12.5 ms of a 14.7 ms GPU frame in the reference ablation, and SSGI
70
- * with its denoiser is ~9.2 ms of that.
71
78
  */
72
79
  const high: IWorldEnvironmentOptions = {
73
80
  // Strength, radius and threshold are a look decision already tuned to this scene's palette.
74
81
  // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
75
82
  // to be.
76
- bloomEnabled: true,
77
- bloomRadius: 0.5,
78
- bloomStrength: 0.42,
79
- bloomThreshold: 0.2,
80
- exposure: 1.15,
81
- // The two full-resolution denoise passes over the AO and GI terms: ~1.9 ms. Only worth running
82
- // when SSGI is on — its noise is what they clean up.
83
- denoiseEnabled: true,
84
- // SSGI, the screen-space indirect-light gather: ~7.3 ms alone, ~9.2 ms with the two denoise
85
- // passes it feeds. The largest stage in the chain by a factor of two, of a 14.7 ms frame.
86
- // Dropping this pair is what `medium` is.
87
- ssgiEnabled: true,
88
- ssgiRadius: 18,
89
- ssgiQuality: "medium",
90
- // Half the frame in each axis, so a quarter of the pixels. Full-res SSGI cost 14.4 ms
91
- // of a 39.7 ms frame on an RTX 2080; this is the same gather over a quarter of the work,
92
- // and it measured *sharper* because the scaler spends what it hands back on resolution.
93
- // `worldEnvironment.ts` explains why it takes a wrapper instead of a property.
94
- ssgiResolutionScale: 0.5,
95
- // Screen-space reflections: ~4.1 ms.
96
- ssrEnabled: true,
97
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
98
- // are on and do nothing" — the ray dies a metre from where it started.
99
- ssrMaxDistance: 44,
100
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
101
- // the rays and is very hard to see in the result.
102
- ssrResolutionScale: 0.5,
103
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
104
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
105
- // that runs one of them.
106
- sharpenEnabled: true,
107
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
108
- sharpenStrength: 0.3,
83
+ // Off. Snow is the brightest thing on screen, and at the default 0.2 threshold every lit
84
+ // pixel blooms and the glade sinks into a white haze. A 0.92 threshold kept only the glints on
85
+ // the web but left the native desktop frame blank behind the HUD (Dawn/Vulkan, 2026-10-01), so
86
+ // the glints live in the snow material's emissive term instead. Turn it back on here.
87
+ bloomEnabled: false,
88
+ // No SSGI runs here, so there is nothing for the denoiser to clean up. Off, explicitly.
89
+ denoiseEnabled: false,
90
+ exposure: 0.95,
91
+ // Off at every tier — see the note at the top of this file.
92
+ ssgiEnabled: false,
93
+ // Off at every tier — see the note at the top of this file.
94
+ ssrEnabled: false,
109
95
  tonemapMode: "aces",
110
96
  };
111
97
 
112
98
  /**
113
- * `high` minus the gather and its denoiser — the single change in this chain measured to give
114
- * back most of the frame: **14.7 ms -> 5.5 ms of GPU** in the reference ablation. Reflections,
115
- * bloom and the sharpener stay, so it is recognisably the same look.
99
+ * The rung in between. With no screen-space stage and no bloom at any tier, the post chain is the
100
+ * same everywhere; the tier only reaches the measured chain as `renderChainTier`. What a phone
101
+ * saves is decided in `src/scenes/Snow.ts` (fewer flakes), and the snow mesh resolution in
102
+ * `src/terrain.ts` is where the frame actually goes.
116
103
  */
117
- const medium: IWorldEnvironmentOptions = {
118
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
119
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
120
- // to be.
121
- bloomEnabled: true,
122
- bloomRadius: 0.5,
123
- bloomStrength: 0.42,
124
- bloomThreshold: 0.2,
125
- exposure: 1.15,
126
- // Screen-space reflections: ~4.1 ms.
127
- ssrEnabled: true,
128
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
129
- // are on and do nothing" — the ray dies a metre from where it started.
130
- ssrMaxDistance: 44,
131
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
132
- // the rays and is very hard to see in the result.
133
- ssrResolutionScale: 0.5,
134
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
135
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
136
- // that runs one of them.
137
- sharpenEnabled: true,
138
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
139
- sharpenStrength: 0.3,
140
- tonemapMode: "aces",
141
- };
104
+ const medium: IWorldEnvironmentOptions = { ...high, renderChainTier: "medium" };
142
105
 
143
106
  /**
144
- * What a phone gets: this template's shipped mobile look, unchanged. Bloom and the tone curve,
145
- * nothing screen-space. The ablation's floor — every stage off — was 2.2 ms.
107
+ * What a phone gets: this template's shipped mobile look, unchanged.
146
108
  */
147
109
  const low: IWorldEnvironmentOptions = {
148
110
  // Strength, radius and threshold are a look decision already tuned to this scene's palette.
149
111
  // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
150
112
  // to be.
151
- bloomEnabled: true,
152
- bloomRadius: 0.5,
153
- bloomStrength: 0.42,
154
- bloomThreshold: 0.2,
155
- exposure: 1.15,
113
+ // Off, as at the high tier.
114
+ bloomEnabled: false,
115
+ exposure: 0.95,
116
+ // Off at every tier — see the note at the top of this file.
117
+ ssgiEnabled: false,
118
+ // Off at every tier — see the note at the top of this file.
119
+ ssrEnabled: false,
120
+ renderChainTier: "low",
156
121
  tonemapMode: "aces",
157
122
  };
158
123
 
@@ -0,0 +1,244 @@
1
+ // Generated for you. The forest, rocks, grass stems and the far ridge are this game's look.
2
+ // Everything here is ordinary Three.js built from code; nothing is loaded.
3
+ import {
4
+ BufferGeometry,
5
+ Color,
6
+ ConeGeometry,
7
+ CylinderGeometry,
8
+ Float32BufferAttribute,
9
+ Group,
10
+ InstancedMesh,
11
+ LineSegments,
12
+ Mesh,
13
+ Object3D,
14
+ PlaneGeometry,
15
+ SphereGeometry,
16
+ Vector3,
17
+ } from "three";
18
+ import { terrainHeight } from "../terrain.js";
19
+ import type { SnowMaterials } from "./materials.js";
20
+
21
+ /** A round obstacle the explorer walks around: centre and radius on the ground plane. */
22
+ export interface IObstacle {
23
+ readonly x: number;
24
+ readonly z: number;
25
+ readonly radius: number;
26
+ readonly height: number;
27
+ }
28
+
29
+ function seededRandom(seed: number): () => number {
30
+ let state = seed;
31
+ return () => {
32
+ state = (state * 1664525 + 1013904223) >>> 0;
33
+ return state / 4294967296;
34
+ };
35
+ }
36
+
37
+ const smoothstep = (edge0: number, edge1: number, value: number) => {
38
+ const t = Math.max(0, Math.min(1, (value - edge0) / (edge1 - edge0)));
39
+ return t * t * (3 - 2 * t);
40
+ };
41
+
42
+ /** Glade-edge pines by hand, then a ring of forest further out. `[x, z, height]`. */
43
+ function treePlacements(random: () => number): Array<[number, number, number]> {
44
+ const trees: Array<[number, number, number]> = [
45
+ [-9, -6, 6.3],
46
+ [9, -5, 7.5],
47
+ [-11.5, 4, 8.2],
48
+ [10.5, 8, 6.4],
49
+ [-7, -14, 7.8],
50
+ [4, -17, 9],
51
+ [-17, -4, 6],
52
+ [16, -9, 9],
53
+ ];
54
+ for (let index = 0; index < 80; index += 1) {
55
+ const angle = random() * Math.PI * 2;
56
+ const radius = 20 + random() * 52;
57
+ trees.push([Math.sin(angle) * radius, Math.cos(angle) * radius, 4.5 + random() * 6.7]);
58
+ }
59
+ return trees;
60
+ }
61
+
62
+ /** Pines within this radius cast shadows; the shadow map only covers the glade anyway. */
63
+ const SHADOW_RADIUS = 26;
64
+
65
+ function forest(materials: SnowMaterials, random: () => number, obstacles: IObstacle[]): Group {
66
+ const placements = treePlacements(random);
67
+ const levels = 15;
68
+ const trunkGeometry = new CylinderGeometry(0.07, 0.14, 1, 9);
69
+ const branchGeometry = new ConeGeometry(1, 1, 7, 1);
70
+ const boughGeometry = new SphereGeometry(1, 6, 4);
71
+ // Two batches: the trees round the glade cast shadows, the far forest does not. One batch of
72
+ // every bough would put the whole forest — most of a million triangles — into the shadow pass.
73
+ const batches = [true, false].map((near) => {
74
+ const count = placements.filter(([x, z]) => Math.hypot(x, z) < SHADOW_RADIUS === near).length;
75
+ const capacity = count * levels * 6;
76
+ return {
77
+ boughs: new InstancedMesh(boughGeometry, materials.bough, capacity),
78
+ branches: new InstancedMesh(branchGeometry, materials.needles, capacity),
79
+ count: 0,
80
+ near,
81
+ trees: 0,
82
+ trunks: new InstancedMesh(trunkGeometry, materials.trunk, count),
83
+ };
84
+ });
85
+ const dummy = new Object3D();
86
+ const up = new Vector3(0, 1, 0);
87
+ const direction = new Vector3();
88
+ placements.forEach(([x, z, height], tree) => {
89
+ const batch = batches[Math.hypot(x, z) < SHADOW_RADIUS ? 0 : 1];
90
+ if (batch === undefined) return;
91
+ const root = terrainHeight(x, z);
92
+ const scale = height / 7;
93
+ dummy.position.set(x, root + height * 0.48, z);
94
+ dummy.rotation.set(0, 0, 0);
95
+ dummy.scale.set(scale, height, scale);
96
+ dummy.updateMatrix();
97
+ batch.trunks.setMatrixAt(batch.trees, dummy.matrix);
98
+ batch.trees += 1;
99
+ if (Math.hypot(x, z) < 20) obstacles.push({ height, radius: 0.23 * scale, x, z });
100
+ for (let level = 0; level < levels; level += 1) {
101
+ const t = level / levels;
102
+ const y = root + 0.75 + t * (height - 0.65);
103
+ const radius = (1 - t) * height * 0.23 + 0.055;
104
+ // A far tree keeps every tier, so its silhouette holds, with fewer and wider boughs per tier.
105
+ const around = level > 12 || !batch.near ? 4 : 6;
106
+ for (let index = 0; index < around; index += 1) {
107
+ const angle = (index / around) * Math.PI * 2 + level * 0.72 + tree * 1.37;
108
+ const reach = radius * (0.8 + random() * 0.3) * (batch.near ? 1 : 1.2);
109
+ const dx = Math.cos(angle);
110
+ const dz = Math.sin(angle);
111
+ dummy.position.set(x + dx * reach * 0.53, y - 0.06, z + dz * reach * 0.53);
112
+ dummy.quaternion.setFromUnitVectors(up, direction.set(dx, -0.2, dz).normalize());
113
+ dummy.scale.set(reach * 0.27, reach * 1.5, reach * 0.3);
114
+ dummy.updateMatrix();
115
+ batch.branches.setMatrixAt(batch.count, dummy.matrix);
116
+ dummy.position.set(x + dx * reach * 0.54, y + 0.11 * scale, z + dz * reach * 0.54);
117
+ dummy.rotation.set(0, -angle, 0);
118
+ dummy.scale.set(reach * 0.78, 0.13 * scale + reach * 0.09, reach * 0.32);
119
+ dummy.updateMatrix();
120
+ batch.boughs.setMatrixAt(batch.count, dummy.matrix);
121
+ batch.count += 1;
122
+ }
123
+ }
124
+ });
125
+ const group = new Group();
126
+ for (const batch of batches) {
127
+ batch.branches.count = batch.count;
128
+ batch.boughs.count = batch.count;
129
+ for (const mesh of [batch.trunks, batch.branches, batch.boughs]) {
130
+ mesh.castShadow = batch.near;
131
+ mesh.receiveShadow = true;
132
+ mesh.computeBoundingSphere();
133
+ group.add(mesh);
134
+ }
135
+ }
136
+ return group;
137
+ }
138
+
139
+ const ROCKS: ReadonlyArray<[number, number, number]> = [
140
+ [-5, 7, 1.15],
141
+ [-6.7, 7.8, 0.55],
142
+ [7, -8, 1.25],
143
+ [7.8, -7, 0.45],
144
+ [10, 1, 1.4],
145
+ [-10, -3, 0.85],
146
+ [-3, -10.5, 0.6],
147
+ [3, 10, 0.55],
148
+ ];
149
+
150
+ function rocks(materials: SnowMaterials, obstacles: IObstacle[]): Group {
151
+ const group = new Group();
152
+ ROCKS.forEach(([x, z, radius], index) => {
153
+ const geometry = new SphereGeometry(1, 15, 11);
154
+ const position = geometry.getAttribute("position");
155
+ for (let vertex = 0; vertex < position.count; vertex += 1) {
156
+ const px = position.getX(vertex);
157
+ const py = position.getY(vertex);
158
+ const pz = position.getZ(vertex);
159
+ const bump = 1 + 0.085 * Math.sin(px * 13 + py * 8) + 0.065 * Math.sin(pz * 15 + index);
160
+ position.setXYZ(vertex, px * bump, py * bump, pz * bump);
161
+ }
162
+ geometry.computeVertexNormals();
163
+ const y = terrainHeight(x, z) + radius * 0.25;
164
+ const rock = new Mesh(geometry, materials.rock);
165
+ rock.position.set(x, y, z);
166
+ rock.scale.set(radius, radius * 0.7, radius * 0.82);
167
+ rock.rotation.y = index * 1.7;
168
+ const cap = new Mesh(geometry, materials.bough);
169
+ cap.position.set(x, y + radius * 0.39, z);
170
+ cap.scale.set(radius * 0.98, radius * 0.36, radius * 0.84);
171
+ cap.rotation.y = rock.rotation.y;
172
+ for (const mesh of [rock, cap]) {
173
+ mesh.castShadow = true;
174
+ mesh.receiveShadow = true;
175
+ group.add(mesh);
176
+ }
177
+ obstacles.push({ height: radius * 1.1, radius: radius * 0.9, x, z });
178
+ });
179
+ return group;
180
+ }
181
+
182
+ /** Bare stems poking through the powder near the rocks show how deep the snow is. */
183
+ function stems(materials: SnowMaterials, random: () => number, depth: number): LineSegments {
184
+ const points: number[] = [];
185
+ for (let index = 0; index < 140; index += 1) {
186
+ const [rx, rz, radius] = ROCKS[index % ROCKS.length] as [number, number, number];
187
+ const angle = random() * Math.PI * 2;
188
+ const distance = radius + random() * 0.9;
189
+ const x = rx + Math.cos(angle) * distance;
190
+ const z = rz + Math.sin(angle) * distance;
191
+ const y = terrainHeight(x, z) + depth - 0.03;
192
+ const height = 0.14 + random() * 0.36;
193
+ points.push(x, y, z, x + (random() - 0.5) * 0.15, y + height, z + (random() - 0.5) * 0.15);
194
+ }
195
+ const geometry = new BufferGeometry();
196
+ geometry.setAttribute("position", new Float32BufferAttribute(points, 3));
197
+ return new LineSegments(geometry, materials.stem);
198
+ }
199
+
200
+ /** A continuous ridgeline behind the forest rather than repeated cone mountains. */
201
+ function ridge(materials: SnowMaterials): Mesh {
202
+ const geometry = new PlaneGeometry(240, 80, 240, 90);
203
+ geometry.rotateX(-Math.PI / 2);
204
+ geometry.translate(0, 0, -91);
205
+ const position = geometry.getAttribute("position");
206
+ for (let index = 0; index < position.count; index += 1) {
207
+ const x = position.getX(index);
208
+ const z = position.getZ(index);
209
+ const v = (z + 131) / 80;
210
+ const peaks =
211
+ 18 + 10 * Math.sin(x * 0.047 + 1) + 7 * Math.sin(x * 0.1 - 1) + 5 * Math.cos(x * 0.19);
212
+ const envelope = Math.sin(Math.max(0, Math.min(1, v)) * Math.PI) ** 1.65;
213
+ const ridges =
214
+ Math.abs(Math.sin(x * 0.31 + z * 0.27)) * 2.2 + Math.sin(x * 0.82 - z * 0.51) * 0.75;
215
+ position.setY(index, -1 + envelope * (peaks + ridges));
216
+ }
217
+ geometry.computeVertexNormals();
218
+ const normal = geometry.getAttribute("normal");
219
+ const colors: number[] = [];
220
+ const snowy = new Color(0xdce6ed);
221
+ const rockFace = new Color(0x536571);
222
+ const colour = new Color();
223
+ for (let index = 0; index < position.count; index += 1) {
224
+ const exposed = smoothstep(0.5, 0.88, 1 - normal.getY(index)) * 0.66;
225
+ const variation = 0.9 + 0.1 * Math.sin(position.getX(index) * 1.7 + position.getZ(index));
226
+ colour.copy(snowy).lerp(rockFace, exposed).multiplyScalar(variation);
227
+ colors.push(colour.r, colour.g, colour.b);
228
+ }
229
+ geometry.setAttribute("color", new Float32BufferAttribute(colors, 3));
230
+ return new Mesh(geometry, materials.ridge);
231
+ }
232
+
233
+ /** Builds the scenery and reports the obstacles in it, so collision follows what is drawn. */
234
+ export function createScenery(
235
+ materials: SnowMaterials,
236
+ depth: number,
237
+ ): { readonly root: Group; readonly obstacles: readonly IObstacle[] } {
238
+ const random = seededRandom(224);
239
+ const obstacles: IObstacle[] = [];
240
+ const root = new Group();
241
+ root.add(forest(materials, random, obstacles), rocks(materials, obstacles));
242
+ root.add(stems(materials, random, depth), ridge(materials));
243
+ return { obstacles, root };
244
+ }
@@ -0,0 +1,57 @@
1
+ // Generated for you. The sky is game-owned source, not an engine preset.
2
+ import {
3
+ BackSide,
4
+ BufferAttribute,
5
+ Color,
6
+ FogExp2,
7
+ Mesh,
8
+ MeshBasicMaterial,
9
+ type Scene,
10
+ SphereGeometry,
11
+ } from "three";
12
+ import { palette } from "./palette.js";
13
+
14
+ const CLEAR_FOG = new Color(palette.skyLow);
15
+ const STORM_FOG = new Color(0xafc3d1);
16
+
17
+ /** A graded dome with a warm sun glow, plus the haze; returns how to darken both for a storm. */
18
+ export function setupSky(scene: Scene): (storm: number) => void {
19
+ const RADIUS = 450;
20
+ const geometry = new SphereGeometry(RADIUS, 40, 24);
21
+ const positions = geometry.getAttribute("position");
22
+ const colors = new Float32Array(positions.count * 3);
23
+ const top = new Color(palette.skyHigh);
24
+ const bottom = new Color(0xd6e2ea);
25
+ const sunGlow = new Color(0xffeedd);
26
+ const sun = { x: -0.6, y: 0.57, z: -0.56 };
27
+ const current = new Color();
28
+ for (let index = 0; index < positions.count; index += 1) {
29
+ const x = positions.getX(index) / RADIUS;
30
+ const y = Math.max(0, positions.getY(index) / RADIUS);
31
+ const z = positions.getZ(index) / RADIUS;
32
+ current.copy(bottom).lerp(top, y ** 0.58);
33
+ const toward = Math.max(0, x * sun.x + y * sun.y + z * sun.z);
34
+ current.lerp(sunGlow, toward ** 20 * 0.35);
35
+ colors.set([current.r, current.g, current.b], index * 3);
36
+ }
37
+ geometry.setAttribute("color", new BufferAttribute(colors, 3));
38
+ const material = new MeshBasicMaterial({
39
+ fog: false,
40
+ side: BackSide,
41
+ toneMapped: false,
42
+ vertexColors: true,
43
+ });
44
+ const dome = new Mesh(geometry, material);
45
+ dome.frustumCulled = false;
46
+ dome.renderOrder = -100;
47
+ scene.background = bottom;
48
+ scene.add(dome);
49
+ const fog = new FogExp2(CLEAR_FOG.getHex(), 0.016);
50
+ scene.fog = fog;
51
+ return (storm) => {
52
+ fog.color.copy(CLEAR_FOG).lerp(STORM_FOG, storm);
53
+ // Thick enough to swallow the far forest, thin enough that the explorer stays readable.
54
+ fog.density = 0.016 + storm * 0.05;
55
+ material.color.setScalar(1 - storm * 0.3);
56
+ };
57
+ }