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
@@ -19,6 +19,11 @@
19
19
  // probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
20
20
  // in `sky.ts`, not in this file.
21
21
  //
22
+ // **This template runs no SSGI at any tier, and that is a measurement rather than a taste.** Its
23
+ // sky, sun colour and depth haze are a volumetric `Atmosphere`, which already owns most of the
24
+ // frame. With the gather on, `playtests/play.playtest.json` measured **34.2 ms p95 against the
25
+ // 33 ms ceiling**; without it the same scenario passes. Turn it on when you replace the
26
+ // atmosphere with a flat sky, and read the p95 back out of `TN_FRAME_BUDGET`.
22
27
  import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
23
28
 
24
29
  /**
@@ -49,7 +54,7 @@ function isQualityTier(value: string): value is QualityTier {
49
54
  * turned out to have no effect.
50
55
  */
51
56
  export function resolveQualityTier(
52
- request: { readonly mobile?: boolean; readonly tier?: string } = {},
57
+ request: { readonly mobile?: boolean; readonly software?: boolean; readonly tier?: string } = {},
53
58
  ): QualityTier {
54
59
  const requested = request.tier;
55
60
  if (requested !== undefined) {
@@ -60,101 +65,54 @@ export function resolveQualityTier(
60
65
  }
61
66
  return requested;
62
67
  }
68
+ // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
69
+ // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
70
+ // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
71
+ // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
72
+ // `tier` above still wins over it.
73
+ if (request.software === true) return "low";
63
74
  return request.mobile === true ? "low" : "high";
64
75
  }
65
76
 
66
77
  /**
67
- * What a desktop gets: this template's shipped desktop look, unchanged.
78
+ * The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the sun
79
+ * disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey walls and
80
+ * flattens contrast), and a corner falloff. Antialiasing is on in every tier that installs a chain;
81
+ * see `screenSpaceAA` in `worldEnvironment.ts`.
68
82
  *
69
- * The whole chain measured 12.5 ms of a 14.7 ms GPU frame in the reference ablation, and SSGI
70
- * with its denoiser is ~9.2 ms of that.
83
+ * No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
84
+ * captured sky (`sky.ts`), and SSR on rough floors traced speckle into the grid; RCAS then rang the
85
+ * smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
71
86
  */
72
- const high: IWorldEnvironmentOptions = {
73
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
74
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
75
- // to be.
87
+ const shared: IWorldEnvironmentOptions = {
88
+ // Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
76
89
  bloomEnabled: true,
77
- bloomRadius: 0.42,
78
- bloomStrength: 0.72,
79
- bloomThreshold: 0.18,
80
- exposure: 1.08,
81
- // The two full-resolution denoise passes over the AO and GI terms: ~1.9 ms. Only worth running
82
- // when SSGI is on — its noise is what they clean up.
83
- denoiseEnabled: true,
84
- // SSGI, the screen-space indirect-light gather: ~7.3 ms alone, ~9.2 ms with the two denoise
85
- // passes it feeds. The largest stage in the chain by a factor of two, of a 14.7 ms frame.
86
- // Dropping this pair is what `medium` is.
87
- ssgiEnabled: true,
88
- ssgiRadius: 16,
89
- ssgiQuality: "medium",
90
- // Half the frame in each axis, so a quarter of the pixels. Full-res SSGI cost 14.4 ms
91
- // of a 39.7 ms frame on an RTX 2080; this is the same gather over a quarter of the work,
92
- // and it measured *sharper* because the scaler spends what it hands back on resolution.
93
- // `worldEnvironment.ts` explains why it takes a wrapper instead of a property.
94
- ssgiResolutionScale: 0.5,
95
- // Screen-space reflections: ~4.1 ms.
96
- ssrEnabled: true,
97
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
98
- // are on and do nothing" — the ray dies a metre from where it started.
99
- ssrMaxDistance: 40,
100
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
101
- // the rays and is very hard to see in the result.
102
- ssrResolutionScale: 0.5,
103
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
104
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
105
- // that runs one of them.
106
- sharpenEnabled: true,
107
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
108
- sharpenStrength: 0.3,
90
+ bloomRadius: 0.6,
91
+ bloomStrength: 0.22,
92
+ bloomThreshold: 1,
93
+ exposure: 0.62,
109
94
  tonemapMode: "aces",
95
+ vignetteAmount: 0.22,
110
96
  };
111
97
 
112
98
  /**
113
- * `high` minus the gather and its denoiser — the single change in this chain measured to give
114
- * back most of the frame: **14.7 ms -> 5.5 ms of GPU** in the reference ablation. Reflections,
115
- * bloom and the sharpener stay, so it is recognisably the same look.
99
+ * What a desktop gets: contact occlusion on top — the dark line where a foot meets the floor and a
100
+ * wall meets the ground, most of what separates "objects in a world" from "objects pasted on a
101
+ * background". Gathered at full resolution and denoised: at half, the upsample left a grain around
102
+ * every foot.
116
103
  */
117
- const medium: IWorldEnvironmentOptions = {
118
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
119
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
120
- // to be.
121
- bloomEnabled: true,
122
- bloomRadius: 0.42,
123
- bloomStrength: 0.72,
124
- bloomThreshold: 0.18,
125
- exposure: 1.08,
126
- // Screen-space reflections: ~4.1 ms.
127
- ssrEnabled: true,
128
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
129
- // are on and do nothing" — the ray dies a metre from where it started.
130
- ssrMaxDistance: 40,
131
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
132
- // the rays and is very hard to see in the result.
133
- ssrResolutionScale: 0.5,
134
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
135
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
136
- // that runs one of them.
137
- sharpenEnabled: true,
138
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
139
- sharpenStrength: 0.3,
140
- tonemapMode: "aces",
104
+ const high: IWorldEnvironmentOptions = {
105
+ ...shared,
106
+ // GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
107
+ gtaoEnabled: true,
108
+ gtaoRadius: 0.35,
141
109
  };
142
110
 
143
- /**
144
- * What a phone gets: this template's shipped mobile look, unchanged. Bloom and the tone curve,
145
- * nothing screen-space. The ablation's floor — every stage off — was 2.2 ms.
146
- */
147
- const low: IWorldEnvironmentOptions = {
148
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
149
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
150
- // to be.
151
- bloomEnabled: true,
152
- bloomRadius: 0.42,
153
- bloomStrength: 0.72,
154
- bloomThreshold: 0.18,
155
- exposure: 1.08,
156
- tonemapMode: "aces",
157
- };
111
+ /** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
112
+ const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8 };
113
+
114
+ /** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
115
+ const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
158
116
 
159
117
  const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
160
118
 
@@ -1,18 +1,41 @@
1
- import { BackSide, Color, Fog, Mesh, MeshBasicMaterial, type Scene, SphereGeometry } from "three";
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
4
+ // by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
5
+ // The same image is the background, the environment light every surface reflects and is filled by,
6
+ // and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
7
+ // equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
8
+ import {
9
+ EquirectangularReflectionMapping,
10
+ FogExp2,
11
+ SRGBColorSpace,
12
+ type Scene,
13
+ type Texture,
14
+ Vector3,
15
+ } from "three";
2
16
  import { palette } from "./palette.js";
3
17
 
4
18
  /**
5
- * The dungeon has no visible sky. This dome is the dark ambient envelope and fog colour;
6
- * the interior's key, rim, and fill lights do the actual work on the stone.
19
+ * How the JPEG was made from the 4k HDR: linear radiance × 0.4, clipped, sRGB-encoded — so white
20
+ * in the file is 2.5 in the sky. Multiplying back restores the HDR brightness of the clouds; the sun
21
+ * disk itself is clipped, which is why the sun is a light (`lighting.ts`) and not a texel.
7
22
  */
8
- export function setupSky(scene: Scene): void {
9
- const dome = new Mesh(
10
- new SphereGeometry(80, 8, 4),
11
- new MeshBasicMaterial({ color: palette.skyLow, fog: false, side: BackSide, toneMapped: false }),
12
- );
13
- dome.frustumCulled = false;
14
- dome.name = "dungeon-ambient-dome";
15
- scene.background = new Color(palette.skyLow);
16
- scene.fog = new Fog(palette.skyLow, 18, 58);
17
- scene.add(dome);
23
+ const SKY_RANGE = 2.5;
24
+
25
+ /** Unit vector toward the photographed sun: 47.9° up, measured from the source HDR. */
26
+ export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
27
+
28
+ export function setupSky(scene: Scene, sky: Texture): void {
29
+ sky.mapping = EquirectangularReflectionMapping;
30
+ sky.colorSpace = SRGBColorSpace;
31
+ scene.background = sky;
32
+ scene.backgroundIntensity = SKY_RANGE;
33
+ // three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
34
+ // It is what makes a standard material read as a material: sky-blue fill on faces the sun
35
+ // misses, and a sky to reflect, sharper as roughness drops.
36
+ scene.environment = sky;
37
+ scene.environmentIntensity = SKY_RANGE;
38
+ // Almost nothing inside the arena (1.4% at 30 m), and the ground plane gone into the horizon by
39
+ // a kilometre — so the floor meets the sky instead of ending at a line.
40
+ scene.fog = new FogExp2(palette.horizon, 0.003);
18
41
  }
@@ -84,7 +84,7 @@ export class TouchControls {
84
84
 
85
85
  constructor(camera: PerspectiveCamera) {
86
86
  this.#camera = camera;
87
- this.#idleMaterial = overlayMaterial(palette.stone, 0.35);
87
+ this.#idleMaterial = overlayMaterial(palette.structure, 0.35);
88
88
  this.#activeMaterial = overlayMaterial(palette.accent, 0.6);
89
89
  this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
90
90
  this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);
@@ -24,8 +24,10 @@ import {
24
24
  } from "three";
25
25
  import { bloom } from "three/addons/tsl/display/BloomNode.js";
26
26
  import { denoise } from "three/addons/tsl/display/DenoiseNode.js";
27
+ import { fxaa } from "three/addons/tsl/display/FXAANode.js";
27
28
  import { ao } from "three/addons/tsl/display/GTAONode.js";
28
29
  import { godrays } from "three/addons/tsl/display/GodraysNode.js";
30
+ import { smaa } from "three/addons/tsl/display/SMAANode.js";
29
31
  import { ssgi } from "three/addons/tsl/display/SSGINode.js";
30
32
  import { ssr } from "three/addons/tsl/display/SSRNode.js";
31
33
  import { sharpen } from "three/addons/tsl/display/SharpenNode.js";
@@ -33,6 +35,7 @@ import {
33
35
  color,
34
36
  convertToTexture,
35
37
  float,
38
+ max,
36
39
  metalness,
37
40
  mrt,
38
41
  normalView,
@@ -45,6 +48,9 @@ import {
45
48
  } from "three/tsl";
46
49
  import type { Node } from "three/webgpu";
47
50
 
51
+ /** Godot's `Viewport.screen_space_aa`: which post-process antialiasing smooths the frame's edges. */
52
+ export type ScreenSpaceAA = "smaa" | "fxaa" | "disabled";
53
+
48
54
  /** Godot's `Environment.tonemap_mode`, with the modes Three.js actually ships. */
49
55
  export type TonemapMode = "aces" | "agx" | "neutral";
50
56
 
@@ -184,6 +190,16 @@ export interface IWorldEnvironmentOptions {
184
190
  readonly sharpenStrength?: number;
185
191
  /** Corner darkening, as a fraction removed at the extreme corner. Zero disables it. */
186
192
  readonly vignetteAmount?: number;
193
+ /**
194
+ * Post-process antialiasing, run last. Godot's `Viewport.screen_space_aa`. Default `"smaa"`.
195
+ *
196
+ * Not optional in practice: the chain renders `pass(scene, camera)` single-sampled, so the moment
197
+ * any stage runs, the renderer's own multisampling no longer reaches the frame and every edge
198
+ * stairsteps — the single loudest "this is a prototype" signal in a frame. It is requested only
199
+ * when some other stage (or a `baseColour`) installs a chain; with nothing installed the renderer
200
+ * draws straight to the canvas with its own MSAA and this would be paying twice.
201
+ */
202
+ readonly screenSpaceAA?: ScreenSpaceAA;
187
203
  /** Godot's `glow_enabled`. */
188
204
  readonly bloomEnabled?: boolean;
189
205
  readonly bloomStrength?: number;
@@ -391,6 +407,7 @@ export class WorldEnvironment {
391
407
  sharpenEnabled: options.sharpenEnabled ?? false,
392
408
  sharpenStrength: options.sharpenStrength ?? 0.2,
393
409
  vignetteAmount: options.vignetteAmount ?? 0,
410
+ screenSpaceAA: options.screenSpaceAA ?? "smaa",
394
411
  bloomEnabled: options.bloomEnabled ?? true,
395
412
  bloomStrength: options.bloomStrength ?? 0.7,
396
413
  bloomRadius: options.bloomRadius ?? 0.5,
@@ -432,6 +449,11 @@ export class WorldEnvironment {
432
449
  (name === "vignette" && options.vignetteAmount > 0),
433
450
  );
434
451
  requested.push(...options.authoredStageNames);
452
+ if (
453
+ options.screenSpaceAA !== "disabled" &&
454
+ (requested.length > 0 || target.baseColour !== undefined)
455
+ )
456
+ requested.push("antialias");
435
457
 
436
458
  // With no stage running there is no node graph to install — the renderer's own
437
459
  // tone-mapping path renders the frame, and the exposure scalar is live there (measured:
@@ -542,7 +564,14 @@ export class WorldEnvironment {
542
564
  // Applied before SSGI by the chain's canonical order; composing it after the GI
543
565
  // combine instead darkens crevices the gather re-lit — that is a look choice, and
544
566
  // this file is where you make it.
545
- return input.mul(contact.r);
567
+ //
568
+ // Denoised with the same depth-aware filter as the GI gather: GTAO's interleaved
569
+ // sampling otherwise reads as a speckled halo around every contact — around feet on a
570
+ // plain floor most of all — which is exactly the "not smooth" a player notices first.
571
+ const occlusion = options.denoiseEnabled
572
+ ? denoised(denoise(contact.getTextureNode(), depth(), normal(), view))
573
+ : contact;
574
+ return input.mul(occlusion.r);
546
575
  },
547
576
  }),
548
577
  stage({
@@ -668,6 +697,26 @@ export class WorldEnvironment {
668
697
  return input.mul(fall.oneMinus());
669
698
  },
670
699
  }),
700
+ {
701
+ // Last, after every built-in: antialiasing is defined on the finished picture, and any
702
+ // stage after it would put the stairsteps back.
703
+ name: "antialias",
704
+ after: "gradualBackground",
705
+ build: (input) => {
706
+ const colour = input as ChainNode;
707
+ // SMAA and FXAA find edges by local contrast and expect display-range colour, but this is
708
+ // the linear HDR frame before the tone curve — a sun-lit edge at 20 against sky at 3
709
+ // would blend into a bright halo. The reversible Karis weighting squeezes it into [0, 1)
710
+ // for the filter and expands it back afterwards, so edges resolve without the halo.
711
+ const peak = max(colour.r, max(colour.g, colour.b));
712
+ const squeezed = colour.div(peak.add(1));
713
+ const filtered = (options.screenSpaceAA === "fxaa"
714
+ ? fxaa(squeezed)
715
+ : smaa(squeezed)) as unknown as ChainNode;
716
+ const back = max(filtered.r, max(filtered.g, filtered.b));
717
+ return filtered.div(float(1).sub(back).max(1e-4));
718
+ },
719
+ },
671
720
  ];
672
721
 
673
722
  // The kit's own stages, composed after the built-ins. The factory is called with the two
@@ -723,6 +772,7 @@ export class WorldEnvironment {
723
772
  const options = this.#options;
724
773
  const off: Record<string, string> = {
725
774
  ambientOcclusion: "gtaoEnabled is false",
775
+ antialias: 'screenSpaceAA is "disabled", or no other stage installed a chain',
726
776
  bloom: "bloomEnabled is false",
727
777
  godRays: "godraysEnabled is false",
728
778
  sharpen: "sharpenEnabled is false",
@@ -745,6 +795,7 @@ export class WorldEnvironment {
745
795
  denoise: options.denoiseEnabled,
746
796
  exposure: options.exposure,
747
797
  marker: "TN_WORLD_ENVIRONMENT",
798
+ screenSpaceAA: options.screenSpaceAA,
748
799
  ssgiQuality: options.ssgiQuality,
749
800
  stages,
750
801
  tonemapMode: options.tonemapMode,
@@ -1,34 +1,33 @@
1
1
  import {
2
2
  GPUParticles3D,
3
- type ICtx,
4
3
  Scene,
5
4
  type SceneFrame,
5
+ afterPhysics,
6
6
  isMobile,
7
7
  isTouchscreenAvailable,
8
8
  } from "@threenative/core";
9
- import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
10
- import { type Object3D, type PerspectiveCamera, Vector3 } from "three";
9
+ import { CollisionShape3D, type IPhysicsContext, buildStaticColliders } from "@threenative/physics";
10
+ import { type PerspectiveCamera, type Texture, Vector3 } from "three";
11
11
  import { Ability } from "../abilities/Ability.js";
12
12
  import { Enemy } from "../entities/Enemy.js";
13
+ import type { GameCtx, IMannequin } from "../entities/Fighter.js";
13
14
  import { HOSTILE_LAYER, PLAYER_LAYER, Player, WORLD_LAYER } from "../entities/Player.js";
14
15
  import { ITEMS, Inventory, type ItemId, type ItemStack } from "../items/Inventory.js";
15
16
  import { describeDrops, rollDrops } from "../loot/drops.js";
16
17
  import { emitPlaytestEvent } from "../playtest-events.js";
17
18
  import { loadProgress, saveProgress } from "../progress.js";
18
19
  import { createDungeonCamera } from "../render/camera.js";
20
+ import { createDungeon, isSolid } from "../render/dungeon.js";
19
21
  import { setupLighting } from "../render/lighting.js";
20
22
  import { createLoadingScreen } from "../render/loading.js";
21
- import { createMaterials } from "../render/materials.js";
22
23
  import { setupPost } from "../render/postprocessing.js";
23
- import { createDungeon, createLootVisual } from "../render/shapes.js";
24
+ import { createLootVisual } from "../render/props.js";
24
25
  import { setupSky } from "../render/sky.js";
25
26
  import { TouchControls } from "../render/touch-controls.js";
26
27
  import { createArcaneSurge, createAttackArc, createHitBurst } from "../render/vfx.js";
27
28
  import type { GameState } from "../state.js";
28
29
  import { StatBlock } from "../stats/StatBlock.js";
29
30
 
30
- export type GameCtx = ICtx<GameState, IPhysicsContext>;
31
-
32
31
  const SPAWN = new Vector3(-8, 0.78, 0);
33
32
  const ATTACK_SHAPE = CollisionShape3D.sphere(2.2);
34
33
  const DROP_SEED = 93_093;
@@ -82,18 +81,41 @@ export class Play extends Scene<GameState, IPhysicsContext> {
82
81
  wallEnemyAggro: 0,
83
82
  };
84
83
 
84
+ #mannequin: IMannequin | undefined;
85
+ #sky: Texture | undefined;
86
+
87
+ override async load(ctx: GameCtx): Promise<void> {
88
+ // One rig, five instances. Quaternius' Universal Animation Library combat mannequin (CC0) is
89
+ // the shared figure: the hero, the raiders and the boss are the same asset, so "add an enemy"
90
+ // is a constructor call and never a second file to cook.
91
+ [this.#mannequin, this.#sky] = await Promise.all([
92
+ ctx.assets.model<IMannequin>("mannequin-combat.glb"),
93
+ ctx.assets.texture("sky.jpg"),
94
+ ]);
95
+ }
96
+
85
97
  override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
98
+ const mannequin = this.#mannequin;
99
+ if (mannequin === undefined || this.#sky === undefined)
100
+ throw new Error("Play.enter ran before load() loaded mannequin-combat.glb and sky.jpg.");
86
101
  const restored = loadProgress(Play.initialState);
87
102
  ctx.state.set(restored);
88
103
  ctx.state.flush();
89
104
 
90
105
  const camera = ctx.camera as PerspectiveCamera;
91
- const materials = createMaterials();
92
- setupSky(ctx.scene);
93
- const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
106
+ setupSky(ctx.scene, this.#sky);
107
+ const lighting = setupLighting(
108
+ ctx.scene,
109
+ ctx.renderer.raw as Parameters<typeof setupLighting>[1],
110
+ isMobile(),
111
+ );
94
112
  // isMobile() arrives as an argument because src/render/ imports no framework package: the
95
113
  // platform decision is made here, in portable game code, exactly like createRandom.
96
- setupPost(ctx.renderer, ctx.scene, camera, { godraysLight: sun, mobile: isMobile() });
114
+ setupPost(ctx.renderer, ctx.scene, camera, {
115
+ godraysLight: lighting.key,
116
+ mobile: isMobile(),
117
+ software: ctx.renderer.softwareAdapter !== undefined,
118
+ });
97
119
  const loading = createLoadingScreen(ctx);
98
120
  ctx.add(camera);
99
121
  const cameraRig = createDungeonCamera(camera);
@@ -103,26 +125,17 @@ export class Play extends Scene<GameState, IPhysicsContext> {
103
125
  ? ctx.entities.add("touch-controls", new TouchControls(camera))
104
126
  : undefined;
105
127
 
106
- const dungeon = createDungeon(materials);
128
+ const dungeon = createDungeon();
107
129
  ctx.add(dungeon.group);
108
- const fixed = (object: Object3D, shape: CollisionShape3D) =>
109
- new RigidBody3D({
130
+ // One call per room, and a room is one group: the collision follows the masonry the same way
131
+ // the look does, so cutting a wall here cuts the collider with it. The predicate keeps the
132
+ // torch dressing and the painted threshold out of the world.
133
+ for (const room of dungeon.rooms)
134
+ buildStaticColliders(ctx, room, {
110
135
  collisionLayer: WORLD_LAYER,
111
136
  collisionMask: PLAYER_LAYER | HOSTILE_LAYER,
112
- object,
113
- physics: ctx.physics,
114
- shape,
115
- type: "fixed",
137
+ predicate: isSolid,
116
138
  });
117
- fixed(dungeon.floor, CollisionShape3D.box(36, 0.3, 12));
118
- for (const [index, wall] of dungeon.walls.entries()) {
119
- fixed(
120
- wall,
121
- index < 2 ? CollisionShape3D.box(36, 2.8, 0.35) : CollisionShape3D.box(0.35, 2.8, 12),
122
- );
123
- }
124
- for (const pillar of dungeon.roomPillars) fixed(pillar, CollisionShape3D.box(0.7, 3.6, 1.2));
125
- fixed(dungeon.lineOfSightWall, CollisionShape3D.box(2.4, 2.1, 0.5));
126
139
 
127
140
  const inventory = new Inventory(6);
128
141
  const savedSlots = restored.inventorySlots.filter(
@@ -141,7 +154,7 @@ export class Play extends Scene<GameState, IPhysicsContext> {
141
154
  const playerRef: { value?: Player } = {};
142
155
  const player = new Player(
143
156
  ctx,
144
- materials,
157
+ mannequin,
145
158
  new Vector3(restored.playerX, restored.playerY, restored.playerZ),
146
159
  restored.health,
147
160
  (amount) => {
@@ -185,7 +198,6 @@ export class Play extends Scene<GameState, IPhysicsContext> {
185
198
  };
186
199
 
187
200
  const enemies = new Map<number, Enemy>();
188
- const enemyIds = new Map<number, string>();
189
201
  const damageStats = new StatBlock(Play.initialState.baseDamage);
190
202
  let elapsed = 0;
191
203
  let saveRequested = false;
@@ -215,7 +227,7 @@ export class Play extends Scene<GameState, IPhysicsContext> {
215
227
  };
216
228
 
217
229
  const retainLoot = (stack: ItemStack): void => {
218
- const visual = createLootVisual(materials);
230
+ const visual = createLootVisual();
219
231
  visual.name = `pending-loot-${stack.itemId}`;
220
232
  visual.position
221
233
  .copy(player.mesh.position)
@@ -259,6 +271,9 @@ export class Play extends Scene<GameState, IPhysicsContext> {
259
271
  changed = true;
260
272
  }
261
273
  if (changed) {
274
+ // A chest that actually closes is the one loot moment in this game, so it is the one the
275
+ // figure bends down for.
276
+ player.pickup();
262
277
  syncInventory();
263
278
  syncPendingLoot();
264
279
  }
@@ -284,10 +299,9 @@ export class Play extends Scene<GameState, IPhysicsContext> {
284
299
  syncEquipmentStat();
285
300
 
286
301
  const onEnemyDeath = (enemy: Enemy): void => {
287
- const id = enemyIds.get(enemy.body.body.id);
288
- enemies.delete(enemy.body.body.id);
289
- enemyIds.delete(enemy.body.body.id);
290
- if (id !== undefined && ctx.entities.get(id) !== undefined) ctx.entities.remove(id);
302
+ // The entity stays registered so the body keeps animating its death clip and answering
303
+ // `debug()`; only the AI stops, which is what `alive` is for. Freeing it here would delete
304
+ // the corpse on the same frame the player earned it.
291
305
  const seed = DROP_SEED + enemyIndex++;
292
306
  lastDropSeed = seed;
293
307
  const drops = rollDrops(seed);
@@ -319,13 +333,12 @@ export class Play extends Scene<GameState, IPhysicsContext> {
319
333
  position: Vector3,
320
334
  options: { readonly boss?: boolean; readonly health?: number } = {},
321
335
  ): Enemy => {
322
- const enemy = new Enemy(ctx, materials, position, player.body.body, {
336
+ const enemy = new Enemy(ctx, mannequin, position, player.body.body, {
323
337
  ...options,
324
338
  onAttack: (amount) => player.takeDamage(amount),
325
339
  onDeath: onEnemyDeath,
326
340
  });
327
- enemies.set(enemy.body.body.id, enemy);
328
- enemyIds.set(enemy.body.body.id, id);
341
+ enemies.set(enemy.id, enemy);
329
342
  ctx.entities.add(id, enemy);
330
343
  return enemy;
331
344
  };
@@ -336,6 +349,8 @@ export class Play extends Scene<GameState, IPhysicsContext> {
336
349
  addEnemy("enemy.room-three", new Vector3(11.5, 0.78, 0), { health: 30 });
337
350
  const boss = addEnemy("boss", new Vector3(16, 0.78, 0), { boss: true, health: 64 });
338
351
 
352
+ /** The damage half of a swing. The clip is the caller's: a spell and a sword do not play the
353
+ * same animation, and both of them reach this function. */
339
354
  const strike = (amount: number): void => {
340
355
  burst(attackVfx, player.attackOrigin(), "vfx-attack");
341
356
  const hits = ctx.physics.directSpaceState.intersectShape({
@@ -373,6 +388,7 @@ export class Play extends Scene<GameState, IPhysicsContext> {
373
388
  damageStats.apply({ add: 6, duration: 1, source: "arcane-surge" }, elapsed);
374
389
  ctx.state.set({ abilityUses: ctx.state.getState().abilityUses + 1, modifierActive: 1 });
375
390
  strike(20);
391
+ player.cast();
376
392
  emitPlaytestEvent({ entity: "player", name: "ability" });
377
393
  },
378
394
  });
@@ -422,6 +438,9 @@ export class Play extends Scene<GameState, IPhysicsContext> {
422
438
  };
423
439
 
424
440
  cameraRig.snap(player.mesh.position);
441
+ // After physics, never inside the frame: the body has moved by then, and a camera that follows
442
+ // a body from the previous frame trails it by a whole step at this speed.
443
+ afterPhysics(ctx, (dt) => cameraRig.follow(player.mesh.position, dt));
425
444
  let lastSavedRoom = currentRoom;
426
445
  const frameState: Partial<GameState> = {};
427
446
  return (frameCtx, dt) => {
@@ -434,9 +453,13 @@ export class Play extends Scene<GameState, IPhysicsContext> {
434
453
  if (frameCtx.input.justPressed("lethal")) player.takeDamage(player.health + 1);
435
454
  if (frameCtx.input.justPressed("damage")) player.takeDamage(18);
436
455
  const touch = touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size);
437
- if (frameCtx.input.justPressed("attack") || touch?.attackPressed === true)
456
+ if (frameCtx.input.justPressed("attack") || touch?.attackPressed === true) {
457
+ player.strike();
438
458
  strike(Math.round(damageStats.value(elapsed)));
459
+ }
439
460
  if (frameCtx.input.justPressed("ability") || touch?.abilityPressed === true) ability.cast();
461
+ if (frameCtx.input.justPressed("dodge") && player.dodge())
462
+ emitPlaytestEvent({ entity: "player", name: "dodged" });
440
463
  if (frameCtx.input.justPressed("equip")) {
441
464
  if (inventory.equip("ember-blade")) {
442
465
  syncEquipmentStat();
@@ -508,7 +531,6 @@ export class Play extends Scene<GameState, IPhysicsContext> {
508
531
  saveProgress(frameCtx.state);
509
532
  saveRequested = false;
510
533
  }
511
- cameraRig.follow(player.mesh.position, dt);
512
534
  if (boss.alive === false) frameCtx.state.set({ gameWon: 1, phase: "won" });
513
535
  if (player.dead) frameCtx.state.set({ gameOver: 1, phase: "lost" });
514
536
  };
@@ -3,15 +3,17 @@
3
3
  @source "../index.html";
4
4
  @source "./";
5
5
 
6
+ /* The same roles as `src/render/palette.ts`, in the two places the UI can reach: the HUD is a
7
+ web view, so it cannot import a Three.js palette. Keep the two lists in step when you repaint. */
6
8
  @theme {
7
- --color-void: #080b12;
8
- --color-panel: #111a25;
9
- --color-line: #2b3a4b;
9
+ --color-void: #3a3a3c;
10
+ --color-panel: #4b4c4f;
11
+ --color-line: #6d6e71;
10
12
  --color-amber: #e8b86a;
11
- --color-cyan: #71d1c4;
12
- --color-red: #d96572;
13
- --color-text: #dce5e8;
14
- --color-dim: #7d8b99;
13
+ --color-cyan: #2a6cf0;
14
+ --color-red: #d0532a;
15
+ --color-text: #e6e4e1;
16
+ --color-dim: #9a9997;
15
17
  --font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
16
18
  }
17
19
 
@@ -24,7 +24,9 @@ export function AbilityBar() {
24
24
  style={{ width: `${Math.max(0, Math.min(100, (1 - cooldown / 3) * 100))}%` }}
25
25
  />
26
26
  </div>
27
- <div className="mt-2 text-dim">E cast · Q equip · U unequip · C save · uses {uses}</div>
27
+ <div className="mt-2 text-dim">
28
+ Shift roll · E cast · Q equip · U unequip · C save · uses {uses}
29
+ </div>
28
30
  </footer>
29
31
  );
30
32
  }
@@ -11,10 +11,10 @@ export function Hud() {
11
11
  const enemies = state.enemiesDefeated;
12
12
  const blocked = state.lineOfSightBlocked;
13
13
  return (
14
- <section className="pointer-events-none absolute left-6 top-5 w-72 text-[10px] uppercase tracking-[0.16em]">
15
- <div className="text-dim">dungeon / action rpg</div>
14
+ <section className="pointer-events-none absolute left-6 top-5 w-72 rounded bg-black/70 p-3 text-[10px] uppercase tracking-[0.16em]">
15
+ <div className="text-dim">grid dungeon / action rpg</div>
16
16
  <div className="mt-2 text-3xl leading-none text-amber">room {room} / 3</div>
17
- <div className="mt-2 text-cyan">boss clear · death fails</div>
17
+ <div className="mt-2 text-cyan">three rooms · boss clear · death fails</div>
18
18
  <div className="mt-2 flex justify-between border-t border-line pt-2 text-dim">
19
19
  <span>defeated {enemies}</span>
20
20
  <span>wall ray {blocked === 1 ? "blocked" : "clear"}</span>