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,321 @@
1
+ // Generated for you. The explorer's look and its procedural pose: every part is a primitive built
2
+ // here, so the character can be restyled — or swapped for a rigged model — without touching the
3
+ // movement or the footsteps in `src/entities/Explorer.ts`.
4
+ import {
5
+ BoxGeometry,
6
+ type BufferGeometry,
7
+ CapsuleGeometry,
8
+ CatmullRomCurve3,
9
+ CylinderGeometry,
10
+ Group,
11
+ type Material,
12
+ Mesh,
13
+ SphereGeometry,
14
+ TorusGeometry,
15
+ TubeGeometry,
16
+ Vector3,
17
+ } from "three";
18
+ import { mergeGeometries } from "three/examples/jsm/utils/BufferGeometryUtils.js";
19
+ import type { SnowMaterials } from "./materials.js";
20
+
21
+ type Point = { x: number; y: number; z: number };
22
+
23
+ /** Where each boot is, in world space, and whether it is in the air. */
24
+ export interface IFootPose {
25
+ readonly side: number;
26
+ readonly x: number;
27
+ readonly y: number;
28
+ readonly z: number;
29
+ readonly angle: number;
30
+ readonly swing: boolean;
31
+ readonly progress: number;
32
+ }
33
+
34
+ interface ISegment {
35
+ readonly mesh: Mesh;
36
+ readonly length: number;
37
+ }
38
+
39
+ interface ILimb {
40
+ readonly side: number;
41
+ readonly upper: ISegment;
42
+ readonly lower: ISegment;
43
+ readonly end: Object3DLike;
44
+ }
45
+
46
+ type Object3DLike = Group | Mesh;
47
+
48
+ /** Bake a group's direct child meshes into one mesh per material, keeping child groups. */
49
+ function mergeRigid(group: Group): void {
50
+ const byMaterial = new Map<Material, BufferGeometry[]>();
51
+ for (const child of [...group.children]) {
52
+ if (!(child instanceof Mesh) || Array.isArray(child.material)) continue;
53
+ child.updateMatrix();
54
+ const geometry = child.geometry.clone().applyMatrix4(child.matrix);
55
+ const list = byMaterial.get(child.material) ?? [];
56
+ list.push(geometry);
57
+ byMaterial.set(child.material, list);
58
+ group.remove(child);
59
+ }
60
+ for (const [material, geometries] of byMaterial) {
61
+ const merged = mergeGeometries(geometries);
62
+ for (const geometry of geometries) geometry.dispose();
63
+ if (merged === null) throw new Error("ExplorerModel could not merge a rigid part.");
64
+ const mesh = new Mesh(merged, material);
65
+ mesh.castShadow = true;
66
+ mesh.receiveShadow = true;
67
+ group.add(mesh);
68
+ }
69
+ }
70
+
71
+ const UP = new Vector3(0, 1, 0);
72
+ const scratchA = new Vector3();
73
+ const scratchB = new Vector3();
74
+
75
+ /** Two-bone IK: the knee that keeps both bones at length, bent towards `bend`. */
76
+ function solveKnee(hip: Point, ankle: Point, upper: number, lower: number, bend: Point): Point {
77
+ let dx = ankle.x - hip.x;
78
+ let dy = ankle.y - hip.y;
79
+ let dz = ankle.z - hip.z;
80
+ let distance = Math.hypot(dx, dy, dz);
81
+ if (distance < 1e-7) {
82
+ dx = 0;
83
+ dy = -1;
84
+ dz = 0;
85
+ distance = 1;
86
+ } else {
87
+ dx /= distance;
88
+ dy /= distance;
89
+ dz /= distance;
90
+ }
91
+ const reach = Math.max(Math.abs(upper - lower) + 1e-6, Math.min(upper + lower - 1e-6, distance));
92
+ const along = (upper * upper - lower * lower + reach * reach) / (2 * reach);
93
+ const across = Math.sqrt(Math.max(0, upper * upper - along * along));
94
+ const dot = bend.x * dx + bend.y * dy + bend.z * dz;
95
+ let bx = bend.x - dx * dot;
96
+ let by = bend.y - dy * dot;
97
+ let bz = bend.z - dz * dot;
98
+ const length = Math.hypot(bx, by, bz) || 1;
99
+ bx /= length;
100
+ by /= length;
101
+ bz /= length;
102
+ return {
103
+ x: hip.x + dx * along + bx * across,
104
+ y: hip.y + dy * along + by * across,
105
+ z: hip.z + dz * along + bz * across,
106
+ };
107
+ }
108
+
109
+ export class ExplorerModel {
110
+ readonly root = new Group();
111
+ readonly #torso = new Group();
112
+ readonly #head = new Group();
113
+ readonly #arms: ILimb[] = [];
114
+ readonly #legs: ILimb[] = [];
115
+ readonly #sphere = new SphereGeometry(1, 20, 14);
116
+
117
+ constructor(materials: SnowMaterials) {
118
+ const m = materials;
119
+ const torso = this.#torso;
120
+ const head = this.#head;
121
+ this.root.add(torso);
122
+ torso.add(head);
123
+ const blob = (material: Material, p: Point, s: Point, parent: Group = this.root) => {
124
+ const mesh = new Mesh(this.#sphere, material);
125
+ mesh.position.set(p.x, p.y, p.z);
126
+ mesh.scale.set(s.x, s.y, s.z);
127
+ mesh.castShadow = true;
128
+ mesh.receiveShadow = true;
129
+ parent.add(mesh);
130
+ return mesh;
131
+ };
132
+ const box = (material: Material, p: Point, s: Point, parent: Group) => {
133
+ const mesh = new Mesh(new BoxGeometry(s.x, s.y, s.z), material);
134
+ mesh.position.set(p.x, p.y, p.z);
135
+ mesh.castShadow = true;
136
+ parent.add(mesh);
137
+ return mesh;
138
+ };
139
+ const tube = (material: Material, points: number[][], radius: number, parent: Group) => {
140
+ const curve = new CatmullRomCurve3(points.map(([x, y, z]) => new Vector3(x, y, z)));
141
+ const mesh = new Mesh(new TubeGeometry(curve, 16, radius, 6, false), material);
142
+ mesh.castShadow = true;
143
+ parent.add(mesh);
144
+ };
145
+ const v = (x: number, y: number, z: number): Point => ({ x, y, z });
146
+
147
+ // Quilted coat, waist and hips.
148
+ blob(m.coat, v(0, 1.29, 0), v(0.292, 0.365, 0.188), torso);
149
+ blob(m.coat, v(0, 1.045, 0), v(0.29, 0.13, 0.193), torso);
150
+ blob(m.pants, v(0, 0.95, 0), v(0.238, 0.135, 0.145));
151
+ for (let quilt = 0; quilt < 5; quilt += 1) {
152
+ const y = 1.07 + quilt * 0.11;
153
+ const profile = Math.sqrt(Math.max(0.3, 1 - ((y - 1.29) / 0.41) ** 2));
154
+ const seam = new Mesh(new TorusGeometry(1, 0.011, 4, 36), m.seam);
155
+ seam.rotation.x = Math.PI / 2;
156
+ seam.scale.set(0.297 * profile, 0.192 * profile, 0.35);
157
+ seam.position.y = y;
158
+ torso.add(seam);
159
+ }
160
+ tube(
161
+ m.rubber,
162
+ [
163
+ [0, 1.02, 0.196],
164
+ [0, 1.3, 0.191],
165
+ [0, 1.56, 0.143],
166
+ ],
167
+ 0.009,
168
+ torso,
169
+ );
170
+ box(m.seam, v(-0.14, 1.4, 0.179), v(0.105, 0.12, 0.019), torso);
171
+ blob(m.seam, v(-0.225, 1.1, 0.1), v(0.067, 0.081, 0.055), torso);
172
+ blob(m.seam, v(0.225, 1.1, 0.1), v(0.067, 0.081, 0.055), torso);
173
+ blob(m.coat, v(0, 1.595, 0), v(0.205, 0.13, 0.17), torso);
174
+
175
+ // Fur-lined hood, goggles and a dusting of snow on top.
176
+ blob(m.coat, v(0, 1.765, -0.015), v(0.229, 0.249, 0.205), head);
177
+ blob(m.skin, v(0, 1.763, 0.16), v(0.143, 0.171, 0.086), head);
178
+ blob(m.gaiter, v(0, 1.683, 0.222), v(0.146, 0.096, 0.045), head);
179
+ for (let tuft = 0; tuft < 28; tuft += 1) {
180
+ const a = (tuft / 28) * Math.PI * 2;
181
+ blob(
182
+ m.fur,
183
+ v(Math.sin(a) * 0.179, 1.766 + Math.cos(a) * 0.213, 0.17 + Math.sin(tuft * 2.3) * 0.008),
184
+ v(0.038, 0.043, 0.043),
185
+ head,
186
+ );
187
+ }
188
+ blob(m.rubber, v(0, 1.823, 0.244), v(0.174, 0.077, 0.043), head);
189
+ blob(m.lens, v(0, 1.825, 0.274), v(0.154, 0.054, 0.027), head);
190
+ blob(m.snowCap, v(-0.015, 1.96, -0.033), v(0.158, 0.036, 0.143), head);
191
+
192
+ // Expedition pack, bedroll and straps.
193
+ blob(m.gaiter, v(0, 1.31, -0.248), v(0.235, 0.3, 0.137), torso);
194
+ blob(m.pants, v(0, 1.49, -0.286), v(0.211, 0.107, 0.124), torso);
195
+ blob(m.coat, v(0, 1.3, -0.373), v(0.124, 0.149, 0.037), torso);
196
+ for (const side of [-1, 1]) {
197
+ tube(
198
+ m.gaiter,
199
+ [
200
+ [side * 0.15, 1.03, 0.175],
201
+ [side * 0.197, 1.4, 0.173],
202
+ [side * 0.17, 1.61, -0.04],
203
+ [side * 0.14, 1.45, -0.32],
204
+ ],
205
+ 0.025,
206
+ torso,
207
+ );
208
+ box(m.metal, v(side * 0.191, 1.34, 0.198), v(0.034, 0.048, 0.012), torso);
209
+ blob(m.pants, v(side * 0.222, 1.25, -0.246), v(0.075, 0.135, 0.087), torso);
210
+ }
211
+ const bedroll = new Mesh(new CylinderGeometry(0.095, 0.095, 0.43, 16), m.pants);
212
+ bedroll.rotation.z = Math.PI / 2;
213
+ bedroll.position.set(0, 1, -0.255);
214
+ bedroll.castShadow = true;
215
+ torso.add(bedroll);
216
+ blob(m.snowCap, v(0, 1.592, -0.289), v(0.172, 0.025, 0.086), torso);
217
+
218
+ const segment = (material: Material, radius: number, length: number): ISegment => {
219
+ const mesh = new Mesh(
220
+ new CapsuleGeometry(radius, Math.max(0.02, length - radius * 2), 6, 12),
221
+ material,
222
+ );
223
+ mesh.castShadow = true;
224
+ mesh.receiveShadow = true;
225
+ this.root.add(mesh);
226
+ return { length, mesh };
227
+ };
228
+ for (const side of [-1, 1]) {
229
+ const hand = blob(m.gaiter, v(0, 0, 0), v(0.069, 0.09, 0.065));
230
+ this.#arms.push({
231
+ end: hand,
232
+ lower: segment(m.coat, 0.084, 0.3),
233
+ side,
234
+ upper: segment(m.coat, 0.105, 0.32),
235
+ });
236
+ const boot = new Group();
237
+ this.root.add(boot);
238
+ blob(m.rubber, v(0, -0.09, 0), v(0.145, 0.047, 0.259), boot);
239
+ blob(m.boot, v(0, -0.025, 0.048), v(0.138, 0.086, 0.202), boot);
240
+ blob(m.boot, v(0, 0.038, -0.09), v(0.118, 0.145, 0.142), boot);
241
+ blob(m.rubber, v(0, -0.015, 0.183), v(0.132, 0.064, 0.073), boot);
242
+ const cuff = new Mesh(new CylinderGeometry(0.095, 0.117, 0.18, 16), m.gaiter);
243
+ cuff.position.set(0, 0.143, -0.066);
244
+ cuff.castShadow = true;
245
+ boot.add(cuff);
246
+ blob(m.snowCap, v(0.02, 0.055, 0.16), v(0.074, 0.015, 0.046), boot);
247
+ this.#legs.push({
248
+ end: boot,
249
+ lower: segment(m.pants, 0.092, 0.475),
250
+ side,
251
+ upper: segment(m.pants, 0.113, 0.475),
252
+ });
253
+ }
254
+ // The torso, hood and boots never bend internally, so each becomes one mesh per material:
255
+ // dozens of primitives as separate draws cost more than the whole snowfield.
256
+ for (const group of [torso, head, ...this.#legs.map((leg) => leg.end as Group)])
257
+ mergeRigid(group);
258
+ }
259
+
260
+ #place(segment: ISegment, from: Point, to: Point): void {
261
+ scratchA.set(from.x, from.y, from.z);
262
+ scratchB.set(to.x - from.x, to.y - from.y, to.z - from.z);
263
+ const length = scratchB.length();
264
+ segment.mesh.position.copy(scratchA).addScaledVector(scratchB, 0.5);
265
+ segment.mesh.quaternion.setFromUnitVectors(UP, scratchB.normalize());
266
+ segment.mesh.scale.y = length / segment.length;
267
+ }
268
+
269
+ /**
270
+ * Pose the body at `position` facing `heading`, with each boot where the gait put it.
271
+ * `cycle` drives the arm swing and torso sway; `speed` scales them.
272
+ */
273
+ pose(
274
+ position: Point,
275
+ heading: number,
276
+ feet: readonly IFootPose[],
277
+ cycle: number,
278
+ speed: number,
279
+ elapsed: number,
280
+ ): void {
281
+ this.root.position.set(position.x, position.y, position.z);
282
+ this.root.rotation.y = heading;
283
+ const gait = Math.sin(cycle * Math.PI * 2);
284
+ const motion = Math.min(1, speed);
285
+ this.#torso.rotation.z = gait * 0.022 * motion;
286
+ this.#torso.rotation.x = speed * 0.022;
287
+ this.#head.rotation.y = Math.sin(elapsed * 0.45) * 0.055 * (1 - motion * 0.6);
288
+ const cos = Math.cos(heading);
289
+ const sin = Math.sin(heading);
290
+ for (const [index, leg] of this.#legs.entries()) {
291
+ const foot = feet[index];
292
+ if (foot === undefined) continue;
293
+ const dx = foot.x - position.x;
294
+ const dz = foot.z - position.z;
295
+ const ankle = { x: dx * cos - dz * sin, y: foot.y - position.y, z: dx * sin + dz * cos };
296
+ const hip = { x: leg.side * 0.145, y: 0.935, z: -0.014 };
297
+ const knee = solveKnee(hip, ankle, 0.475, 0.475, { x: leg.side * 0.08, y: 0, z: 1 });
298
+ this.#place(leg.upper, hip, knee);
299
+ this.#place(leg.lower, knee, ankle);
300
+ leg.end.position.set(ankle.x, ankle.y, ankle.z);
301
+ leg.end.rotation.set(
302
+ foot.swing ? Math.sin(foot.progress * Math.PI * 2) * 0.2 : 0,
303
+ foot.angle - heading,
304
+ 0,
305
+ );
306
+ }
307
+ for (const arm of this.#arms) {
308
+ const swing = gait * arm.side * motion;
309
+ const shoulder = { x: arm.side * 0.287, y: 1.49, z: 0 };
310
+ const elbow = { x: arm.side * 0.376, y: 1.215, z: swing * 0.13 - 0.035 };
311
+ const hand = {
312
+ x: arm.side * 0.397,
313
+ y: 0.976 + Math.abs(swing) * 0.027,
314
+ z: swing * 0.23 + 0.055,
315
+ };
316
+ this.#place(arm.upper, shoulder, elbow);
317
+ this.#place(arm.lower, elbow, hand);
318
+ arm.end.position.set(hand.x, hand.y - 0.031, hand.z);
319
+ }
320
+ }
321
+ }
@@ -0,0 +1,50 @@
1
+ // Generated for you. This is ordinary Three.js; tune the sun and fill for your snow.
2
+ import { DirectionalLight, HemisphereLight, PCFSoftShadowMap, type Scene } from "three";
3
+ import { palette } from "./palette.js";
4
+
5
+ type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
6
+
7
+ export interface ISnowLights {
8
+ /** Follow `target` with the shadow frustum and dim everything for a storm. */
9
+ update(target: { readonly x: number; readonly z: number }, storm: number): void;
10
+ readonly sun: DirectionalLight;
11
+ }
12
+
13
+ export function setupLighting(scene: Scene, renderer: ShadowRenderer): ISnowLights {
14
+ renderer.shadowMap.enabled = true;
15
+ renderer.shadowMap.type = PCFSoftShadowMap;
16
+ // Bright sky above, a cool grey bounce from the snow below.
17
+ const sky = new HemisphereLight(0xdbeeff, 0x7d8e9c, 2.2);
18
+ scene.add(sky);
19
+
20
+ // A low warm sun, so footprints throw shadows into their own floors.
21
+ const sun = new DirectionalLight(0xffead1, 3.3);
22
+ sun.position.set(-22, 30, -20);
23
+ sun.castShadow = true;
24
+ sun.shadow.mapSize.set(2048, 2048);
25
+ sun.shadow.camera.left = -19;
26
+ sun.shadow.camera.right = 19;
27
+ sun.shadow.camera.top = 19;
28
+ sun.shadow.camera.bottom = -19;
29
+ sun.shadow.camera.near = 0.1;
30
+ sun.shadow.camera.far = 100;
31
+ sun.shadow.bias = -0.0002;
32
+ sun.shadow.normalBias = 0.028;
33
+ scene.add(sun, sun.target);
34
+
35
+ // A cool fill from the camera side keeps the shadowed faces of the forest from going black.
36
+ const fill = new DirectionalLight(palette.skyLow, 0.45);
37
+ fill.position.set(8, 6, 15);
38
+ scene.add(fill);
39
+
40
+ return {
41
+ sun,
42
+ update(target, storm) {
43
+ sun.position.set(target.x - 22, 30, target.z - 20);
44
+ sun.target.position.set(target.x, 0, target.z);
45
+ sun.target.updateMatrixWorld();
46
+ sun.intensity = 3.3 - storm * 2.9;
47
+ sky.intensity = 2.2 - storm * 0.55;
48
+ },
49
+ };
50
+ }
@@ -0,0 +1,325 @@
1
+ import {
2
+ type Camera,
3
+ CanvasTexture,
4
+ ClampToEdgeWrapping,
5
+ Mesh,
6
+ MeshBasicMaterial,
7
+ type OrthographicCamera,
8
+ PlaneGeometry,
9
+ type Scene,
10
+ type Texture,
11
+ } from "three";
12
+ import { palette } from "./palette.js";
13
+
14
+ /* BEGIN THREENATIVE LOADING APPEARANCE */
15
+ /** Sailing keeps its own sea composition; all behavior is authored here. */
16
+ export const loading = {
17
+ backgroundColor: palette.skyLow,
18
+ backgroundImage: undefined as string | undefined,
19
+ enabled: true,
20
+ fillImage: undefined as string | undefined,
21
+ logoImage: undefined as string | undefined,
22
+ progressColor: palette.accent,
23
+ showStatus: false,
24
+ trackColor: palette.skyHigh,
25
+ bar: { anchorX: 0.5, anchorY: 0.7, height: 9, maxWidth: 560, minWidth: 1, width: 0.64 },
26
+ } as const;
27
+ /* END THREENATIVE LOADING APPEARANCE */
28
+
29
+ interface ILoadingHost {
30
+ readonly assets?: { texture(path: string): Promise<Texture> };
31
+ readonly camera: Camera;
32
+ readonly canvasLayer: {
33
+ readonly camera: OrthographicCamera;
34
+ readonly scene: Scene;
35
+ opaque: boolean;
36
+ };
37
+ readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
38
+ readonly scene: Scene;
39
+ readonly startup: {
40
+ readonly progress: number;
41
+ readonly warmup?: { readonly status: "complete" | "incomplete" | "unavailable" };
42
+ whenReady(): Promise<void>;
43
+ };
44
+ readonly viewport?: {
45
+ readonly safeArea: { height: number; width: number; x: number; y: number };
46
+ };
47
+ }
48
+
49
+ interface ILoadingController {
50
+ update(): void;
51
+ finish(): void;
52
+ }
53
+
54
+ function noOp(layer: ILoadingHost["canvasLayer"]): ILoadingController {
55
+ layer.opaque = false;
56
+ return { finish: () => undefined, update: () => undefined };
57
+ }
58
+
59
+ function meshFor(
60
+ layer: ILoadingHost["canvasLayer"],
61
+ material: MeshBasicMaterial,
62
+ renderOrder: number,
63
+ ): Mesh<PlaneGeometry, MeshBasicMaterial> {
64
+ const mesh = new Mesh(new PlaneGeometry(1, 1), material);
65
+ mesh.frustumCulled = false;
66
+ mesh.renderOrder = renderOrder;
67
+ layer.scene.add(mesh);
68
+ return mesh;
69
+ }
70
+
71
+ function imageAspect(texture: Texture | null | undefined): number {
72
+ const image = texture?.image as { height?: number; width?: number } | undefined;
73
+ const width = image?.width ?? 1;
74
+ const height = image?.height ?? 1;
75
+ return width > 0 && height > 0 ? width / height : 1;
76
+ }
77
+
78
+ function configureTexture(texture: Texture): void {
79
+ texture.wrapS = ClampToEdgeWrapping;
80
+ texture.wrapT = ClampToEdgeWrapping;
81
+ texture.needsUpdate = true;
82
+ }
83
+
84
+ function setFillUv(geometry: PlaneGeometry, progress: number, base: readonly number[]): void {
85
+ const uv = geometry.getAttribute("uv");
86
+ for (let index = 0; index < uv.count; index += 1) uv.setX(index, (base[index] ?? 0) * progress);
87
+ uv.needsUpdate = true;
88
+ }
89
+
90
+ function coverUv(
91
+ geometry: PlaneGeometry,
92
+ texture: Texture,
93
+ width: number,
94
+ height: number,
95
+ baseU: readonly number[],
96
+ baseV: readonly number[],
97
+ ): void {
98
+ const imageRatio = imageAspect(texture);
99
+ const boxRatio = width / Math.max(1, height);
100
+ const visibleU = imageRatio > boxRatio ? boxRatio / imageRatio : 1;
101
+ const visibleV = imageRatio < boxRatio ? imageRatio / boxRatio : 1;
102
+ const offsetU = (1 - visibleU) / 2;
103
+ const offsetV = (1 - visibleV) / 2;
104
+ const uv = geometry.getAttribute("uv");
105
+ for (let index = 0; index < uv.count; index += 1) {
106
+ uv.setX(index, offsetU + (baseU[index] ?? 0) * visibleU);
107
+ uv.setY(index, offsetV + (baseV[index] ?? 0) * visibleV);
108
+ }
109
+ uv.needsUpdate = true;
110
+ }
111
+
112
+ function statusMesh(
113
+ layer: ILoadingHost["canvasLayer"],
114
+ ):
115
+ | { mesh: Mesh<PlaneGeometry, MeshBasicMaterial>; texture: Texture; update(value: number): void }
116
+ | undefined {
117
+ if (!loading.showStatus || typeof document === "undefined") return undefined;
118
+ const canvas = document.createElement("canvas");
119
+ canvas.width = 180;
120
+ canvas.height = 48;
121
+ const context = canvas.getContext("2d");
122
+ if (context === null) return undefined;
123
+ const texture = new CanvasTexture(canvas);
124
+ const mesh = meshFor(
125
+ layer,
126
+ new MeshBasicMaterial({ depthTest: false, depthWrite: false, map: texture, transparent: true }),
127
+ 4,
128
+ );
129
+ const update = (value: number): void => {
130
+ context.clearRect(0, 0, canvas.width, canvas.height);
131
+ context.fillStyle = "#ffffff";
132
+ context.font = "700 20px monospace";
133
+ context.textAlign = "center";
134
+ context.textBaseline = "middle";
135
+ context.fillText(`${Math.round(value * 100)}%`, canvas.width / 2, canvas.height / 2);
136
+ texture.needsUpdate = true;
137
+ };
138
+ update(0);
139
+ return { mesh, texture, update };
140
+ }
141
+
142
+ export function createLoadingScreen(host: ILoadingHost): ILoadingController {
143
+ const layer = host.canvasLayer;
144
+ if (!loading.enabled) return noOp(layer);
145
+ const camera = layer.camera;
146
+ const backdrop = meshFor(
147
+ layer,
148
+ new MeshBasicMaterial({ color: loading.backgroundColor, depthTest: false, depthWrite: false }),
149
+ 0,
150
+ );
151
+ const track = meshFor(
152
+ layer,
153
+ new MeshBasicMaterial({ color: loading.trackColor, depthTest: false, depthWrite: false }),
154
+ 1,
155
+ );
156
+ const fill = meshFor(
157
+ layer,
158
+ new MeshBasicMaterial({ color: loading.progressColor, depthTest: false, depthWrite: false }),
159
+ 2,
160
+ );
161
+ const fillBaseU = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
162
+ fill.geometry.getAttribute("uv").getX(index),
163
+ );
164
+ const fillBaseV = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
165
+ fill.geometry.getAttribute("uv").getY(index),
166
+ );
167
+ const logo =
168
+ loading.logoImage === undefined
169
+ ? undefined
170
+ : meshFor(
171
+ layer,
172
+ new MeshBasicMaterial({
173
+ color: 0xffffff,
174
+ depthTest: false,
175
+ depthWrite: false,
176
+ transparent: true,
177
+ }),
178
+ 3,
179
+ );
180
+ const status = statusMesh(layer);
181
+ const parts = [
182
+ backdrop,
183
+ track,
184
+ fill,
185
+ ...(logo === undefined ? [] : [logo]),
186
+ ...(status === undefined ? [] : [status.mesh]),
187
+ ];
188
+ const ownedTextures = new Set<Texture>(status === undefined ? [] : [status.texture]);
189
+ let width = 1;
190
+ let height = 1;
191
+ let barWidth = 1;
192
+ let barHeight: number = loading.bar.height;
193
+ let barX = 0;
194
+ let barY = 0;
195
+ let progress = 0;
196
+ let done = false;
197
+ let backdropTexture: Texture | undefined;
198
+
199
+ const layout = (): void => {
200
+ width = Math.max(1, camera.right - camera.left);
201
+ height = Math.max(1, camera.top - camera.bottom);
202
+ const safe = host.viewport?.safeArea ?? { height, width, x: 0, y: 0 };
203
+ const safeWidth = Math.max(1, Math.min(width, safe.width));
204
+ const safeHeight = Math.max(1, Math.min(height, safe.height));
205
+ const safeX = Math.max(0, Math.min(width - safeWidth, safe.x));
206
+ const safeY = Math.max(0, Math.min(height - safeHeight, safe.y));
207
+ barWidth = Math.max(2, Math.min(loading.bar.maxWidth, safeWidth * loading.bar.width));
208
+ barHeight = Math.max(2, Math.min(loading.bar.height, safeHeight * 0.05));
209
+ barX = safeX + safeWidth * loading.bar.anchorX;
210
+ barY = safeY + safeHeight * loading.bar.anchorY;
211
+ const worldX = (screenX: number): number => camera.left + screenX;
212
+ const worldY = (screenY: number): number => camera.top - screenY;
213
+ const visibleWidth = Math.max(loading.bar.minWidth, barWidth * progress);
214
+ backdrop.scale.set(width, height, 1);
215
+ backdrop.position.set(worldX(width / 2), worldY(height / 2), 0);
216
+ track.scale.set(barWidth, barHeight, 1);
217
+ track.position.set(worldX(barX), worldY(barY), 0);
218
+ fill.scale.set(visibleWidth, barHeight, 1);
219
+ fill.position.set(worldX(barX - barWidth / 2 + visibleWidth / 2), worldY(barY), 0);
220
+ if (logo?.visible) {
221
+ const logoWidth = Math.min(safeWidth * 0.42, 280);
222
+ logo.scale.set(
223
+ logoWidth,
224
+ Math.min(logoWidth / imageAspect(logo.material.map), safeHeight * 0.22),
225
+ 1,
226
+ );
227
+ logo.position.set(worldX(barX), worldY(Math.max(safeY, barY - safeHeight * 0.2)), 0);
228
+ }
229
+ if (status !== undefined) {
230
+ status.mesh.scale.set(Math.min(180, safeWidth * 0.32), 48, 1);
231
+ status.mesh.position.set(worldX(barX), worldY(Math.min(height, barY + barHeight * 2.5)), 0);
232
+ }
233
+ if (backdropTexture !== undefined)
234
+ coverUv(backdrop.geometry, backdropTexture, width, height, fillBaseU, fillBaseV);
235
+ };
236
+
237
+ const updateProgress = (value: number): void => {
238
+ const bounded = Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
239
+ // A missing or incomplete backend observation cannot prove that all first-use work is done.
240
+ // Keep the bar visibly indeterminate until readiness removes the cover; never turn unknown
241
+ // coverage into a false 100% claim.
242
+ const observationUnknown =
243
+ host.startup.warmup !== undefined && host.startup.warmup.status !== "complete";
244
+ progress = observationUnknown ? Math.min(0.9, bounded) : bounded;
245
+ setFillUv(fill.geometry, progress, fillBaseU);
246
+ status?.update(progress);
247
+ layout();
248
+ };
249
+
250
+ const attachTexture = (mesh: Mesh<PlaneGeometry, MeshBasicMaterial>, texture: Texture): void => {
251
+ if (done) return;
252
+ configureTexture(texture);
253
+ mesh.material.map = texture;
254
+ mesh.material.color.set(0xffffff);
255
+ mesh.material.needsUpdate = true;
256
+ ownedTextures.add(texture);
257
+ if (mesh === backdrop) backdropTexture = texture;
258
+ layout();
259
+ updateProgress(progress);
260
+ };
261
+
262
+ const load = (source: string | undefined, mesh: Mesh<PlaneGeometry, MeshBasicMaterial>): void => {
263
+ if (source === undefined || host.assets === undefined) return;
264
+ void host.assets
265
+ .texture(source)
266
+ .then((texture) => attachTexture(mesh, texture))
267
+ .catch(() => undefined);
268
+ };
269
+ load(loading.backgroundImage, backdrop);
270
+ load(loading.fillImage, fill);
271
+ if (logo !== undefined && loading.logoImage !== undefined && host.assets !== undefined) {
272
+ void host.assets
273
+ .texture(loading.logoImage)
274
+ .then((texture) => {
275
+ if (done) return;
276
+ configureTexture(texture);
277
+ logo.material.map = texture;
278
+ logo.material.needsUpdate = true;
279
+ logo.visible = true;
280
+ ownedTextures.add(texture);
281
+ layout();
282
+ })
283
+ .catch(() => undefined);
284
+ }
285
+
286
+ layer.opaque = true;
287
+ layout();
288
+ updateProgress(0);
289
+
290
+ const finish = (): void => {
291
+ if (done) return;
292
+ done = true;
293
+ for (const mesh of parts) {
294
+ mesh.removeFromParent();
295
+ mesh.geometry.dispose();
296
+ mesh.material.dispose();
297
+ }
298
+ for (const texture of ownedTextures) texture.dispose();
299
+ layer.opaque = false;
300
+ };
301
+
302
+ void (async () => {
303
+ await host.startup.whenReady();
304
+ if (done) return;
305
+ // Prewarm the world's shaders, but do not wait for them here. `whenReady()` already means the
306
+ // world is safe to show, and compiling a lit, post-processed scene takes far longer than the
307
+ // launch window: hold the screen for it and a playtest — which advances a fixed step as fast
308
+ // as the machine allows — runs an entire scenario behind the launch screen, so every capture
309
+ // photographs the loading bar instead of the game. The prewarm still happens; it no longer
310
+ // decides when the player sees the world.
311
+ try {
312
+ void host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
313
+ } catch {
314
+ // A renderer without compileAsync is not a reason to keep the world hidden.
315
+ }
316
+ finish();
317
+ })();
318
+
319
+ return {
320
+ finish,
321
+ update(): void {
322
+ if (!done) updateProgress(host.startup.progress);
323
+ },
324
+ };
325
+ }