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,131 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // The prototype test arena every engine opens a new project on, and the one shape every platform
5
+ // in it is cut from: a light metre-grid plate on top of a dark-grid body that reaches the ground.
6
+ // Two meshes, so the walking surface reads as floor and the sides read as structure — and two
7
+ // solids, so the player collides with exactly the triangles they can see.
8
+ //
9
+ // Every solid here is **placed in the geometry, not on the mesh**, for one reason: `worldGridUVs`
10
+ // measures UVs in world metres, and a trimesh collider built from that geometry is the exact
11
+ // surface the player sees. Move a solid by rebuilding it here, not by writing `mesh.position` —
12
+ // a collider reads the mesh transform and the shape separately, and the two only agree while the
13
+ // mesh sits at the origin.
14
+ import { type BufferGeometry, CylinderGeometry, Group, Mesh, PlaneGeometry } from "three";
15
+ import { floorMaterial, structureMaterial, worldGridUVs } from "./materials.js";
16
+ import { roundedBox } from "./shapes.js";
17
+
18
+ /**
19
+ * The light grid the arena stands on, six metres below the route. Nothing collides with it, which
20
+ * is what makes the gap between the two platforms a real pit rather than scenery underfoot.
21
+ */
22
+ const GROUND_Y = -6;
23
+ /** The dark-grid walls that close the arena, and how far the route's own ground sits below them. */
24
+ const ARENA = { halfX: 13, halfZ: 11, thickness: 1, wallTop: 4 } as const;
25
+
26
+ const PLATE = 0.2;
27
+
28
+ /** `roundedBox` caches and hands back one instance per size, so a placed copy has to be its own. */
29
+ function placed(geometry: BufferGeometry, at: readonly [number, number, number]): BufferGeometry {
30
+ return worldGridUVs(geometry.clone().translate(...at));
31
+ }
32
+
33
+ function meshOf(
34
+ geometry: BufferGeometry,
35
+ at: readonly [number, number, number],
36
+ material: Mesh["material"],
37
+ ): Mesh {
38
+ const mesh = new Mesh(placed(geometry, at), material);
39
+ mesh.castShadow = true;
40
+ mesh.receiveShadow = true;
41
+ return mesh;
42
+ }
43
+
44
+ /** A rounded box: a wall, a pillar, a platform's plate or its body. */
45
+ function box(
46
+ size: readonly [number, number, number],
47
+ at: readonly [number, number, number],
48
+ material: Mesh["material"],
49
+ radius: number,
50
+ ): Mesh {
51
+ return meshOf(roundedBox(size[0], size[1], size[2], radius), at, material);
52
+ }
53
+
54
+ export interface IPlatform {
55
+ /** The authoritative support surface: its top face is the surface's `y`. */
56
+ readonly plate: Mesh;
57
+ /** The dark-grid body under it, running down to `GROUND_Y`. */
58
+ readonly base: Mesh;
59
+ }
60
+
61
+ /** One platform: a light-grid top at `top`, on a dark-grid body that meets the ground. */
62
+ export function platform(
63
+ width: number,
64
+ depth: number,
65
+ top: number,
66
+ x: number,
67
+ z: number,
68
+ radius = 0.1,
69
+ ): IPlatform {
70
+ const height = top - PLATE - GROUND_Y;
71
+ return {
72
+ base: box([width, height, depth], [x, top - PLATE - height / 2, z], structureMaterial, radius),
73
+ plate: box([width, PLATE, depth], [x, top - PLATE / 2, z], floorMaterial, radius),
74
+ };
75
+ }
76
+
77
+ export interface IArena {
78
+ /** Everything static, added in one call. */
79
+ readonly group: Group;
80
+ /**
81
+ * The meshes that must collide. Give each one `CollisionShape3D.fromMesh(mesh, "trimesh")`:
82
+ * the kind is named rather than inferred, because an inferred box of a geometry whose offset is
83
+ * baked in would collide at the world origin.
84
+ */
85
+ readonly solids: Mesh[];
86
+ }
87
+
88
+ /**
89
+ * The ground, the four walls and one pillar. `platform` is deliberately not in here — the two
90
+ * platforms are the course, and the course is gameplay, so the scene places them itself.
91
+ */
92
+ export function createArena(): IArena {
93
+ const group = new Group();
94
+ // The ground runs out past the walls to the haze line, so the sky over a wall meets ground and
95
+ // not a void. It is decoration, not floor: it has no collider, and that is the pit under the gap.
96
+ const ground = new Mesh(
97
+ worldGridUVs(new PlaneGeometry(12_000, 12_000).rotateX(-Math.PI / 2)),
98
+ floorMaterial,
99
+ );
100
+ ground.position.y = GROUND_Y;
101
+ ground.receiveShadow = true;
102
+ group.add(ground);
103
+ const height = ARENA.wallTop - GROUND_Y;
104
+ const y = GROUND_Y + height / 2;
105
+ const walls = (
106
+ [
107
+ [
108
+ [ARENA.halfX * 2 + ARENA.thickness, height, ARENA.thickness],
109
+ [0, y, -ARENA.halfZ],
110
+ ],
111
+ [
112
+ [ARENA.halfX * 2 + ARENA.thickness, height, ARENA.thickness],
113
+ [0, y, ARENA.halfZ],
114
+ ],
115
+ [
116
+ [ARENA.thickness, height, ARENA.halfZ * 2 - ARENA.thickness],
117
+ [-ARENA.halfX, y, 0],
118
+ ],
119
+ [
120
+ [ARENA.thickness, height, ARENA.halfZ * 2 - ARENA.thickness],
121
+ [ARENA.halfX, y, 0],
122
+ ],
123
+ ] as const
124
+ ).map(([size, at]) => box(size, at, structureMaterial, 0.14));
125
+ // A tall dark mass behind the route: the course is a corridor, and this is what tells the player
126
+ // where the frame stops. A cylinder rather than a box, so its collider has to be a trimesh.
127
+ const pillar = meshOf(new CylinderGeometry(1.6, 1.6, height, 48), [-9, y, -8], structureMaterial);
128
+ const solids = [...walls, pillar];
129
+ for (const solid of solids) group.add(solid);
130
+ return { group, solids };
131
+ }
@@ -1,60 +1,43 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
3
  //
4
- // Four lights, and the fourth is the one people forget: a cool rim from behind
5
- // so silhouettes separate from the background instead of reading as flat
6
- // cut-outs. Key + bounce + ambient gets you a lit scene; the rim is what makes
7
- // it look shaded.
8
- import {
9
- AmbientLight,
10
- DirectionalLight,
11
- HemisphereLight,
12
- PCFSoftShadowMap,
13
- type Scene,
14
- } from "three";
15
- import { palette } from "./palette.js";
4
+ // One sun. The sky image in `sky.ts` is the fill light — its environment reaches every face the
5
+ // sun misses — so there is no hemisphere or ambient light stacked on top to flatten the frame.
6
+ import { DirectionalLight, PCFSoftShadowMap, type Scene } from "three";
7
+ import { SUN_DIRECTION } from "./sky.js";
16
8
 
17
9
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
18
10
 
19
- // Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow
20
- // map, so the scene hands the sun to `setupPost` and a shadowless light is refused by name
21
- // instead of rendering a black pass.
22
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
11
+ export function setupLighting(
12
+ scene: Scene,
13
+ renderer: ShadowRenderer,
14
+ mobile = false,
15
+ ): { key: DirectionalLight } {
23
16
  renderer.shadowMap.enabled = true;
24
17
  renderer.shadowMap.type = PCFSoftShadowMap;
25
18
 
26
- // Sky above, ground bounce below. Tint the second colour toward whatever the
27
- // floor actually is — it is the cheapest realism in the whole rig.
28
- scene.add(new HemisphereLight(palette.skyHigh, palette.skyLow, 1.8));
29
-
30
- const key = new DirectionalLight(palette.accent, 2.4);
31
- key.position.set(4, 7, 3);
19
+ // Warm white, matched by eye to the photographed midday sun against its own sky.
20
+ const key = new DirectionalLight(0xfff1e0, 4.5);
21
+ key.position.copy(SUN_DIRECTION).multiplyScalar(30);
32
22
  key.castShadow = true;
33
- // 1024² is one quarter of a 2048² map's texel storage and fill work while
34
- // retaining enough resolution for this small authored route. Increase it
35
- // only when a larger level makes the 18-unit camera extent visibly soft.
36
- key.shadow.mapSize.set(1024, 1024);
37
- key.shadow.camera.near = 0.5;
38
- key.shadow.camera.far = 60;
39
- // A shadow camera tight enough to stay crisp cannot also cover a big level;
40
- // this extent matches the generated route. Widen it, or move the light with
41
- // the player, when the world grows.
42
- const extent = 18;
23
+ // One map fitted to the 28 m arena: 4096² is under a centimetre a texel, so every shadow has the
24
+ // same softness. Camera-centred cascades (`VirtualShadowNode`) are for open worlds; here their
25
+ // level boundaries showed as shadows that turned sharp halfway along. Phones take 2048².
26
+ const size = mobile ? 2048 : 4096;
27
+ key.shadow.mapSize.set(size, size);
28
+ key.shadow.radius = 2;
29
+ key.shadow.camera.near = 1;
30
+ key.shadow.camera.far = 80;
31
+ const extent = 14;
43
32
  key.shadow.camera.left = -extent;
44
33
  key.shadow.camera.right = extent;
45
34
  key.shadow.camera.top = extent;
46
35
  key.shadow.camera.bottom = -extent;
47
- key.shadow.bias = -0.0008;
48
- // Rounded geometry self-shadows at grazing angles without this, and the bias
49
- // alone would have to grow big enough to detach contact shadows.
50
- key.shadow.normalBias = 0.03;
36
+ // Small biases: a large normal bias is what lifted the mannequin's shadow off its own feet.
37
+ key.shadow.bias = -0.0002;
38
+ key.shadow.normalBias = 0.005;
51
39
  scene.add(key);
52
-
53
- const rim = new DirectionalLight(palette.skyHigh, 0.9);
54
- rim.position.set(-5, 3, -6);
55
- scene.add(rim);
56
-
57
- scene.add(new AmbientLight(palette.skyLow, 0.38));
58
-
59
- return key;
40
+ // The key light is returned because `WorldEnvironment`'s godrays stage raymarches against its
41
+ // shadow map, so `setupPost` needs the light itself.
42
+ return { key };
60
43
  }
@@ -1,46 +1,175 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
- import { Color, DoubleSide, MeshBasicMaterial, MeshStandardMaterial, type Texture } from "three";
3
+ //
4
+ // The prototype look every engine ships a new project with: a metre grid on neutral greys, one
5
+ // saturated colour for things you can touch, and a metal figure. It reads as "a real engine" only
6
+ // because `sky.ts` gives every surface an environment to reflect — roughness then decides how much
7
+ // sky a surface mirrors, so keep it varied between neighbours.
8
+ import {
9
+ type BufferGeometry,
10
+ DataTexture,
11
+ DoubleSide,
12
+ Float32BufferAttribute,
13
+ LinearMipmapLinearFilter,
14
+ MeshStandardMaterial,
15
+ RepeatWrapping,
16
+ SRGBColorSpace,
17
+ type Texture,
18
+ Vector2,
19
+ Vector3,
20
+ } from "three";
4
21
  import { MeshBasicNodeMaterial } from "three/webgpu";
5
22
  import { palette } from "./palette.js";
6
23
 
7
- export function createMaterials() {
8
- return {
9
- floor: new MeshStandardMaterial({ color: palette.floor, roughness: 0.9, metalness: 0 }),
10
- player: new MeshStandardMaterial({ color: palette.player, roughness: 0.48, metalness: 0.04 }),
11
- crate: new MeshStandardMaterial({ color: palette.crate, roughness: 0.76, metalness: 0 }),
12
- /** The hero's hat, scarf and boots: the one warm accent on a cool coast. */
13
- heroAccent: new MeshStandardMaterial({
14
- color: palette.crate,
15
- roughness: 0.6,
16
- metalness: 0.02,
17
- }),
18
- /** The hero's pack, gloves, legs and visor. Reads as leather at this size. */
19
- heroDark: new MeshStandardMaterial({ color: 0x4a4038, roughness: 0.8, metalness: 0.02 }),
20
- // The flagpole only. The island under it is `floor`, so the far side reads as more of
21
- // the same ground and the gap between them stays legible as a gap.
22
- goal: new MeshStandardMaterial({ color: palette.accent, roughness: 0.45, metalness: 0.04 }),
23
- // The columns under the ledge: lit, matte, near-black, so the drop has a below.
24
- rock: new MeshStandardMaterial({ color: palette.skyLow, roughness: 0.98, metalness: 0 }),
25
- // The ridge on the horizon is unlit on purpose. A standard material there takes the
26
- // warm key like everything else and the backdrop stops being a backdrop; a flat colour
27
- // between the two sky stops stays a silhouette from every light angle, and the scene's
28
- // fog still fades it with distance.
29
- ridge: new MeshBasicMaterial({ color: new Color(palette.skyLow).multiplyScalar(0.72) }),
30
- flower: new MeshStandardMaterial({ color: palette.crate, roughness: 0.6, metalness: 0 }),
31
- grass: new MeshStandardMaterial({ color: palette.floor, roughness: 0.95, metalness: 0 }),
32
- grassDark: new MeshStandardMaterial({
33
- color: new Color(palette.floor).multiplyScalar(0.58),
34
- roughness: 0.98,
35
- metalness: 0,
36
- }),
37
- sand: new MeshStandardMaterial({ color: palette.accent, roughness: 0.96, metalness: 0 }),
38
- /** The far sandbar's beach rim: the same sand as the main island's shore. */
39
- shore: new MeshStandardMaterial({ color: palette.accent, roughness: 0.96, metalness: 0 }),
40
- shoreline: new MeshStandardMaterial({ color: palette.player, roughness: 0.9, metalness: 0 }),
24
+ /**
25
+ * One metre of grid: a heavy line on the metre, faint lines every 25 cm, a faint per-texel grain so
26
+ * large areas do not band. Built from bytes rather than a canvas so it runs the same in the browser
27
+ * and in the native host.
28
+ */
29
+ function gridTexture(base: number, line: number, size = 256): DataTexture {
30
+ const data = new Uint8Array(size * size * 4);
31
+ const minorEvery = size / 4;
32
+ let seed = 7;
33
+ for (let y = 0; y < size; y += 1) {
34
+ for (let x = 0; x < size; x += 1) {
35
+ const major = x < 3 || y < 3;
36
+ const minor = x % minorEvery < 1 || y % minorEvery < 1;
37
+ const weight = major ? 0.92 : minor ? 0.22 : 0;
38
+ seed = (seed * 16807) % 2147483647;
39
+ const grain = 1 + (seed / 2147483647 - 0.5) * 0.04;
40
+ const index = (y * size + x) * 4;
41
+ for (let channel = 0; channel < 3; channel += 1) {
42
+ const shift = 16 - channel * 8;
43
+ const from = ((base >> shift) & 0xff) * grain;
44
+ const to = (line >> shift) & 0xff;
45
+ data[index + channel] = Math.min(255, Math.round(from * (1 - weight) + to * weight));
46
+ }
47
+ data[index + 3] = 255;
48
+ }
49
+ }
50
+ const texture = new DataTexture(data, size, size);
51
+ texture.colorSpace = SRGBColorSpace;
52
+ texture.wrapS = RepeatWrapping;
53
+ texture.wrapT = RepeatWrapping;
54
+ texture.generateMipmaps = true;
55
+ texture.minFilter = LinearMipmapLinearFilter;
56
+ texture.anisotropy = 16;
57
+ texture.needsUpdate = true;
58
+ return texture;
59
+ }
60
+
61
+ const _normal = new Vector3();
62
+
63
+ /**
64
+ * A faint cast-concrete grain as a tangent-space normal map: two octaves of smoothed value noise,
65
+ * tiling every metre like the grid. It is what stops a large flat face reading as an untextured
66
+ * blockout under a low sun — the light breaks up across it instead of sliding off in one tone.
67
+ * Bytes, not a file, so it costs nothing to ship and runs on every target.
68
+ */
69
+ function grainNormalTexture(size = 128): DataTexture {
70
+ const cells = [8, 32];
71
+ const lattice = cells.map((count) => {
72
+ const values = new Float32Array(count * count);
73
+ let seed = count * 7919;
74
+ for (let index = 0; index < values.length; index += 1) {
75
+ seed = (seed * 16807) % 2147483647;
76
+ values[index] = seed / 2147483647;
77
+ }
78
+ return { count, values };
79
+ });
80
+ const height = (x: number, y: number): number => {
81
+ let total = 0;
82
+ for (const [octave, { count, values }] of lattice.entries()) {
83
+ const u = (x / size) * count;
84
+ const v = (y / size) * count;
85
+ const x0 = Math.floor(u);
86
+ const y0 = Math.floor(v);
87
+ const fx = u - x0;
88
+ const fy = v - y0;
89
+ const sx = fx * fx * (3 - 2 * fx);
90
+ const sy = fy * fy * (3 - 2 * fy);
91
+ const at = (i: number, j: number): number =>
92
+ values[(((j % count) + count) % count) * count + (((i % count) + count) % count)] ?? 0;
93
+ const top = at(x0, y0) + (at(x0 + 1, y0) - at(x0, y0)) * sx;
94
+ const bottom = at(x0, y0 + 1) + (at(x0 + 1, y0 + 1) - at(x0, y0 + 1)) * sx;
95
+ total += (top + (bottom - top) * sy) * (octave === 0 ? 1 : 0.5);
96
+ }
97
+ return total;
41
98
  };
99
+ const data = new Uint8Array(size * size * 4);
100
+ for (let y = 0; y < size; y += 1) {
101
+ for (let x = 0; x < size; x += 1) {
102
+ const dx = height(x + 1, y) - height(x - 1, y);
103
+ const dy = height(x, y + 1) - height(x, y - 1);
104
+ _normal.set(-dx * 4, -dy * 4, 1).normalize();
105
+ const index = (y * size + x) * 4;
106
+ data[index] = Math.round((_normal.x * 0.5 + 0.5) * 255);
107
+ data[index + 1] = Math.round((_normal.y * 0.5 + 0.5) * 255);
108
+ data[index + 2] = Math.round((_normal.z * 0.5 + 0.5) * 255);
109
+ data[index + 3] = 255;
110
+ }
111
+ }
112
+ const texture = new DataTexture(data, size, size);
113
+ texture.wrapS = RepeatWrapping;
114
+ texture.wrapT = RepeatWrapping;
115
+ texture.generateMipmaps = true;
116
+ texture.minFilter = LinearMipmapLinearFilter;
117
+ texture.needsUpdate = true;
118
+ return texture;
42
119
  }
43
120
 
121
+ const grain = grainNormalTexture();
122
+
123
+ /**
124
+ * Rewrites a geometry's UVs as world metres, projected along each face's dominant axis, so one grid
125
+ * tile is one metre on every face of every prop regardless of its size. Call it after the geometry
126
+ * is translated into place (merged geometry included), before it is given to a mesh.
127
+ */
128
+ export function worldGridUVs<T extends BufferGeometry>(geometry: T): T {
129
+ const position = geometry.getAttribute("position");
130
+ const normal = geometry.getAttribute("normal");
131
+ const uv = new Float32Array(position.count * 2);
132
+ for (let index = 0; index < position.count; index += 1) {
133
+ _normal.fromBufferAttribute(normal, index);
134
+ const x = position.getX(index);
135
+ const y = position.getY(index);
136
+ const z = position.getZ(index);
137
+ const ax = Math.abs(_normal.x);
138
+ const ay = Math.abs(_normal.y);
139
+ const az = Math.abs(_normal.z);
140
+ const [u, v] = ay >= ax && ay >= az ? [x, z] : ax >= az ? [z, y] : [x, y];
141
+ uv[index * 2] = u;
142
+ uv[index * 2 + 1] = v;
143
+ }
144
+ geometry.setAttribute("uv", new Float32BufferAttribute(uv, 2));
145
+ return geometry;
146
+ }
147
+
148
+ /** Light grid: platform tops and the ground. */
149
+ export const floorMaterial = new MeshStandardMaterial({
150
+ map: gridTexture(palette.floor, palette.gridLine),
151
+ normalMap: grain,
152
+ normalScale: new Vector2(0.18, 0.18),
153
+ roughness: 0.62,
154
+ metalness: 0,
155
+ });
156
+
157
+ /** Dark grid: walls, pillars, platform flanks — anything structural. */
158
+ export const structureMaterial = new MeshStandardMaterial({
159
+ map: gridTexture(palette.structure, palette.gridLine),
160
+ normalMap: grain,
161
+ normalScale: new Vector2(0.18, 0.18),
162
+ roughness: 0.7,
163
+ metalness: 0,
164
+ });
165
+
166
+ /** The one saturated colour: the crate, the pickup and the flagpole — what you can touch. */
167
+ export const propMaterial = new MeshStandardMaterial({
168
+ color: palette.accent,
169
+ roughness: 0.45,
170
+ metalness: 0,
171
+ });
172
+
44
173
  /** The finish flag owns its sampled, double-sided look; SoftBody3D only drives its positions. */
45
174
  export function createPennantMaterial(texture: Texture): MeshBasicNodeMaterial {
46
175
  return new MeshBasicNodeMaterial({ map: texture, side: DoubleSide });
@@ -1,18 +1,18 @@
1
- // Generated for you. Keep the six palette roles coherent when you change the look.
1
+ // Generated for you. Keep these six palette roles coherent when you change the look.
2
+ // Neutral greys carry the light; one saturated blue marks what you can touch.
3
+ // `skyLow`/`skyHigh` are the sky photograph's own two tones, sampled from the HDR it was made
4
+ // from, so the horizon the fog fades into is the horizon the frame actually shows.
2
5
  export const palette = {
3
- skyHigh: 0x8fd5cf,
4
- skyLow: 0x28556a,
5
- floor: 0x67c878,
6
- player: 0xfff0b0,
7
- crate: 0xd86f55,
8
- accent: 0xe6c58d,
6
+ /** Light grid: platform tops and the ground the arena stands on. */
7
+ floor: 0xb4b1ae,
8
+ /** Dark grid: platform sides, walls, pillars — anything structural. */
9
+ structure: 0x747578,
10
+ /** The metre line both grids are drawn in. */
11
+ gridLine: 0x3a3a3c,
12
+ /** The one saturated colour: anything you can push, pick up or stand on. */
13
+ accent: 0x2a6cf0,
14
+ /** The sky photograph's horizon — the fog colour, and the loading screen behind the bar. */
15
+ skyLow: 0xacb1c1,
16
+ /** One stop brighter: the zenith, and the loading track. */
17
+ skyHigh: 0xc3d2e4,
9
18
  } as const;
10
-
11
- export const COAST_WAVES = [
12
- { amplitude: 0.12, direction: [1, 0.2] as const, speed: 0.52, wavelength: 7.2 },
13
- { amplitude: 0.055, detail: true, direction: [-0.35, 1] as const, speed: 0.3, wavelength: 3.3 },
14
- ] as const;
15
-
16
- export const COAST_DOMAIN_WARP = [
17
- { amplitude: 0.12, direction: [0.65, -0.35] as const, speed: 0.18, wavelength: 11 },
18
- ] as const;
@@ -17,7 +17,6 @@ import {
17
17
  createAdaptiveQuality,
18
18
  formatQualityAdaptation,
19
19
  } from "./adaptiveQuality.js";
20
- import { painterlyStageNames, painterlyStages } from "./painterly.js";
21
20
  import { type QualityTier, qualityPreset } from "./quality.js";
22
21
  import { type OutputRenderer, WorldEnvironment } from "./worldEnvironment.js";
23
22
 
@@ -41,6 +40,8 @@ export function setupPost(
41
40
  environment: IAdaptiveQualityOptions & {
42
41
  godraysLight?: DirectionalLight;
43
42
  mobile?: boolean;
43
+ /** The renderer named a software adapter; this game's answer is its `low` tier. */
44
+ software?: boolean;
44
45
  /** Forces a tier while keeping its costs observed. Unknown names throw. */
45
46
  tier?: QualityTier;
46
47
  } = {},
@@ -57,11 +58,7 @@ export function setupPost(
57
58
  // Replacement is serialized: no old graph or subscription remains alive beside the new one.
58
59
  disposeGraph?.();
59
60
  const settings = qualityPreset(policy.tier);
60
- const world = new WorldEnvironment({
61
- ...settings,
62
- authoredStageNames: painterlyStageNames(settings),
63
- authoredStages: painterlyStages(settings),
64
- });
61
+ const world = new WorldEnvironment(settings);
65
62
  const applied = world.apply(renderer, scene, camera, {
66
63
  godraysLight: environment.godraysLight,
67
64
  });
@@ -71,7 +68,9 @@ export function setupPost(
71
68
  apply();
72
69
  const source = environment.tier === undefined ? "platform" : "override";
73
70
  console.info(
74
- `TN_QUALITY_TIER ${policy.tier} mobile=${environment.mobile === true} source=${source}`,
71
+ `TN_QUALITY_TIER ${policy.tier} mobile=${environment.mobile === true} software=${
72
+ environment.software === true
73
+ } source=${source}`,
75
74
  );
76
75
  const controller = {
77
76
  debug: () => observation,