create-threenative 0.2.3 → 0.2.5

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 (447) hide show
  1. package/README.md +53 -2
  2. package/agent-docs/references/assertion-reference.md +173 -6
  3. package/agent-docs/references/capability-reference.md +1303 -99
  4. package/agent-docs/references/capture-the-frame.md +7 -0
  5. package/agent-docs/references/creating-creatures.md +215 -0
  6. package/agent-docs/references/ctx-cookbook.md +69 -0
  7. package/agent-docs/references/debug-surface.md +8 -3
  8. package/agent-docs/references/dream-loop.md +150 -0
  9. package/agent-docs/references/finding-assets.md +70 -2
  10. package/agent-docs/references/sculpt-from-a-reference.md +3 -2
  11. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  12. package/agent-docs/references/visual-baseline.md +41 -0
  13. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  14. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  15. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  16. package/agent-files/.agents/skills/threenative-builder/SKILL.md +1 -1
  17. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  18. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  19. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  20. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  21. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  22. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +1 -1
  23. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  24. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  25. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  26. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  27. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  28. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  29. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  30. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  31. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  32. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  33. package/agent-files/scripts/reference.mjs +705 -0
  34. package/agent-files/scripts/visual-loop.mjs +382 -0
  35. package/capabilities.json +1881 -131
  36. package/dist/index.d.ts +39 -6
  37. package/dist/index.js +297 -32
  38. package/dist/threenative.js +822 -105
  39. package/package.json +30 -5
  40. package/template-assets/loading.ts +12 -2
  41. package/template-assets/patches/three@0.185.1.patch +249 -14
  42. package/template-assets/worldEnvironment.ts +758 -0
  43. package/templates/action-rpg/.codex/config.toml +4 -0
  44. package/templates/action-rpg/.cursor/mcp.json +32 -0
  45. package/templates/action-rpg/.gemini/settings.json +32 -0
  46. package/templates/action-rpg/.mcp.json +15 -3
  47. package/templates/action-rpg/.vscode/mcp.json +36 -0
  48. package/templates/action-rpg/.zed/settings.json +36 -0
  49. package/templates/action-rpg/AGENTS.md +69 -378
  50. package/templates/action-rpg/CLAUDE.md +69 -378
  51. package/templates/action-rpg/opencode.json +41 -0
  52. package/templates/action-rpg/package.json +7 -7
  53. package/templates/action-rpg/playtests/combat.playtest.json +9 -0
  54. package/templates/action-rpg/playtests/performance.playtest.json +24 -7
  55. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  56. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  57. package/templates/action-rpg/src/conventions.ts +35 -0
  58. package/templates/action-rpg/src/entities/Enemy.ts +2 -3
  59. package/templates/action-rpg/src/entities/Player.ts +20 -3
  60. package/templates/action-rpg/src/render/camera.ts +7 -2
  61. package/templates/action-rpg/src/render/lighting.ts +5 -3
  62. package/templates/action-rpg/src/render/loading.ts +12 -2
  63. package/templates/action-rpg/src/render/materials.ts +11 -0
  64. package/templates/action-rpg/src/render/palette.ts +10 -3
  65. package/templates/action-rpg/src/render/postprocessing.ts +21 -58
  66. package/templates/action-rpg/src/render/quality.ts +170 -0
  67. package/templates/action-rpg/src/render/shapes.ts +185 -26
  68. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  69. package/templates/action-rpg/src/render/vfx.ts +257 -0
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +208 -33
  71. package/templates/action-rpg/src/scenes/Play.ts +43 -6
  72. package/templates/action-rpg/src/style.css +20 -0
  73. package/templates/action-rpg/threenative.config.ts +7 -0
  74. package/templates/defense/.codex/config.toml +4 -0
  75. package/templates/defense/.cursor/mcp.json +32 -0
  76. package/templates/defense/.gemini/settings.json +32 -0
  77. package/templates/defense/.mcp.json +15 -3
  78. package/templates/defense/.vscode/mcp.json +36 -0
  79. package/templates/defense/.zed/settings.json +36 -0
  80. package/templates/defense/AGENTS.md +62 -385
  81. package/templates/defense/CLAUDE.md +62 -385
  82. package/templates/defense/opencode.json +41 -0
  83. package/templates/defense/package.json +7 -7
  84. package/templates/defense/playtests/performance.playtest.json +24 -7
  85. package/templates/defense/playtests/pointer-placement.playtest.json +87 -20
  86. package/templates/defense/playtests/scan.playtest.json +1 -1
  87. package/templates/defense/playtests/survive.playtest.json +14 -0
  88. package/templates/defense/src/attackers/Attacker.ts +4 -4
  89. package/templates/defense/src/board/Route.ts +22 -8
  90. package/templates/defense/src/conventions.ts +18 -0
  91. package/templates/defense/src/entities/Player.ts +11 -3
  92. package/templates/defense/src/game.ts +2 -3
  93. package/templates/defense/src/physics.ts +9 -39
  94. package/templates/defense/src/placement/Buildable.ts +4 -4
  95. package/templates/defense/src/render/camera.ts +9 -3
  96. package/templates/defense/src/render/loading.ts +12 -2
  97. package/templates/defense/src/render/materials.ts +9 -0
  98. package/templates/defense/src/render/palette.ts +12 -5
  99. package/templates/defense/src/render/postprocessing.ts +21 -58
  100. package/templates/defense/src/render/quality.ts +170 -0
  101. package/templates/defense/src/render/shapes.ts +142 -23
  102. package/templates/defense/src/render/sky.ts +2 -2
  103. package/templates/defense/src/render/worldEnvironment.ts +208 -33
  104. package/templates/defense/src/scenes/Boot.ts +2 -2
  105. package/templates/defense/src/scenes/Defense.ts +13 -6
  106. package/templates/defense/src/style.css +20 -0
  107. package/templates/defense/src/towers/Tower.ts +11 -12
  108. package/templates/defense/src/towers/targeting.ts +1 -1
  109. package/templates/defense/src/ui/App.tsx +2 -2
  110. package/templates/defense/threenative.config.ts +7 -0
  111. package/templates/minimal/.codex/config.toml +4 -0
  112. package/templates/minimal/.cursor/mcp.json +32 -0
  113. package/templates/minimal/.gemini/settings.json +32 -0
  114. package/templates/minimal/.mcp.json +15 -3
  115. package/templates/minimal/.vscode/mcp.json +36 -0
  116. package/templates/minimal/.zed/settings.json +36 -0
  117. package/templates/minimal/AGENTS.md +76 -485
  118. package/templates/minimal/CLAUDE.md +76 -485
  119. package/templates/minimal/opencode.json +41 -0
  120. package/templates/minimal/package.json +6 -6
  121. package/templates/minimal/playtests/play.playtest.json +2 -1
  122. package/templates/minimal/playtests/survives.playtest.json +48 -4
  123. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  124. package/templates/minimal/src/conventions.ts +18 -0
  125. package/templates/minimal/src/entities/Player.ts +39 -6
  126. package/templates/minimal/src/main.ts +14 -4
  127. package/templates/minimal/src/render/materials.ts +7 -0
  128. package/templates/minimal/src/render/palette.ts +3 -3
  129. package/templates/minimal/src/render/postprocessing.ts +17 -56
  130. package/templates/minimal/src/render/quality.ts +162 -0
  131. package/templates/minimal/src/render/sky.ts +23 -9
  132. package/templates/minimal/src/render/touch-controls.ts +165 -0
  133. package/templates/minimal/src/render/worldEnvironment.ts +208 -33
  134. package/templates/minimal/src/scenes/Play.ts +47 -11
  135. package/templates/minimal/src/style.css +20 -0
  136. package/templates/minimal/threenative.config.ts +7 -0
  137. package/templates/platformer/.codex/config.toml +4 -0
  138. package/templates/platformer/.cursor/mcp.json +32 -0
  139. package/templates/platformer/.gemini/settings.json +32 -0
  140. package/templates/platformer/.mcp.json +15 -3
  141. package/templates/platformer/.vscode/mcp.json +36 -0
  142. package/templates/platformer/.zed/settings.json +36 -0
  143. package/templates/platformer/AGENTS.md +70 -430
  144. package/templates/platformer/CLAUDE.md +70 -430
  145. package/templates/platformer/opencode.json +41 -0
  146. package/templates/platformer/package.json +7 -7
  147. package/templates/platformer/playtests/oneway.playtest.json +29 -2
  148. package/templates/platformer/playtests/performance.playtest.json +2 -1
  149. package/templates/platformer/playtests/survives.playtest.json +31 -0
  150. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +3 -0
  151. package/templates/platformer/playtests/touch-controls-web.playtest.json +15 -4
  152. package/templates/platformer/src/conventions.ts +18 -0
  153. package/templates/platformer/src/entities/Character.ts +63 -1
  154. package/templates/platformer/src/game.ts +3 -1
  155. package/templates/platformer/src/level/Platform.ts +13 -1
  156. package/templates/platformer/src/render/lighting.ts +7 -4
  157. package/templates/platformer/src/render/loading.ts +12 -2
  158. package/templates/platformer/src/render/palette.ts +4 -1
  159. package/templates/platformer/src/render/postprocessing.ts +32 -57
  160. package/templates/platformer/src/render/quality.ts +170 -0
  161. package/templates/platformer/src/render/worldEnvironment.ts +208 -33
  162. package/templates/platformer/src/scenes/Level.ts +52 -12
  163. package/templates/platformer/src/style.css +20 -0
  164. package/templates/platformer/threenative.config.ts +7 -0
  165. package/templates/puzzle/.codex/config.toml +19 -0
  166. package/templates/puzzle/.cursor/mcp.json +32 -0
  167. package/templates/puzzle/.gemini/settings.json +32 -0
  168. package/templates/puzzle/.mcp.json +32 -0
  169. package/templates/puzzle/.vscode/mcp.json +36 -0
  170. package/templates/puzzle/.zed/settings.json +36 -0
  171. package/templates/puzzle/AGENTS.md +96 -0
  172. package/templates/puzzle/CLAUDE.md +98 -0
  173. package/templates/puzzle/README.md +43 -0
  174. package/templates/puzzle/index.html +12 -0
  175. package/templates/puzzle/kit.json +7 -0
  176. package/templates/puzzle/opencode.json +41 -0
  177. package/templates/puzzle/package.json +50 -0
  178. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  179. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  180. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  181. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  182. package/templates/puzzle/public/favicon.svg +5 -0
  183. package/templates/puzzle/src/conventions.ts +25 -0
  184. package/templates/puzzle/src/entities/Ball.ts +70 -0
  185. package/templates/puzzle/src/entities/Crate.ts +76 -0
  186. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  187. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  188. package/templates/puzzle/src/game.ts +48 -0
  189. package/templates/puzzle/src/main.ts +15 -0
  190. package/templates/puzzle/src/physics.ts +19 -0
  191. package/templates/puzzle/src/render/camera.ts +37 -0
  192. package/templates/puzzle/src/render/lighting.ts +55 -0
  193. package/templates/puzzle/src/render/loading.ts +325 -0
  194. package/templates/puzzle/src/render/materials.ts +28 -0
  195. package/templates/puzzle/src/render/palette.ts +31 -0
  196. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  197. package/templates/puzzle/src/render/quality.ts +170 -0
  198. package/templates/puzzle/src/render/shapes.ts +134 -0
  199. package/templates/puzzle/src/render/sky.ts +16 -0
  200. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  201. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  202. package/templates/puzzle/src/room.ts +83 -0
  203. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  204. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  205. package/templates/puzzle/src/state.ts +30 -0
  206. package/templates/puzzle/src/style.css +96 -0
  207. package/templates/puzzle/src/ui/App.tsx +22 -0
  208. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  209. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  210. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  211. package/templates/puzzle/src/ui/main.tsx +14 -0
  212. package/templates/puzzle/tailwind.config.ts +1 -0
  213. package/templates/puzzle/threenative.config.ts +49 -0
  214. package/templates/puzzle/tsconfig.json +17 -0
  215. package/templates/puzzle/vite.config.ts +38 -0
  216. package/templates/racing/.codex/config.toml +4 -0
  217. package/templates/racing/.cursor/mcp.json +32 -0
  218. package/templates/racing/.gemini/settings.json +32 -0
  219. package/templates/racing/.mcp.json +15 -3
  220. package/templates/racing/.vscode/mcp.json +36 -0
  221. package/templates/racing/.zed/settings.json +36 -0
  222. package/templates/racing/AGENTS.md +63 -379
  223. package/templates/racing/CLAUDE.md +63 -379
  224. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  225. package/templates/racing/opencode.json +41 -0
  226. package/templates/racing/package.json +8 -7
  227. package/templates/racing/playtests/performance.playtest.json +24 -7
  228. package/templates/racing/playtests/survives.playtest.json +36 -4
  229. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  230. package/templates/racing/src/conventions.ts +6 -0
  231. package/templates/racing/src/entities/RacingCar.ts +16 -4
  232. package/templates/racing/src/entities/Rival.ts +5 -2
  233. package/templates/racing/src/render/camera.ts +7 -4
  234. package/templates/racing/src/render/lighting.ts +22 -13
  235. package/templates/racing/src/render/loading.ts +12 -2
  236. package/templates/racing/src/render/materials.ts +54 -4
  237. package/templates/racing/src/render/palette.ts +23 -6
  238. package/templates/racing/src/render/postprocessing.ts +21 -58
  239. package/templates/racing/src/render/quality.ts +170 -0
  240. package/templates/racing/src/render/shapes.ts +537 -26
  241. package/templates/racing/src/render/sky.ts +5 -2
  242. package/templates/racing/src/render/touch-controls.ts +185 -0
  243. package/templates/racing/src/render/worldEnvironment.ts +208 -33
  244. package/templates/racing/src/scenes/Race.ts +17 -2
  245. package/templates/racing/src/style.css +20 -0
  246. package/templates/racing/src/track/Track.ts +270 -31
  247. package/templates/racing/threenative.config.ts +7 -0
  248. package/templates/runner/.codex/config.toml +19 -0
  249. package/templates/runner/.cursor/mcp.json +32 -0
  250. package/templates/runner/.gemini/settings.json +32 -0
  251. package/templates/runner/.mcp.json +32 -0
  252. package/templates/runner/.vscode/mcp.json +36 -0
  253. package/templates/runner/.zed/settings.json +36 -0
  254. package/templates/runner/AGENTS.md +96 -0
  255. package/templates/runner/CLAUDE.md +98 -0
  256. package/templates/runner/README.md +43 -0
  257. package/templates/runner/index.html +12 -0
  258. package/templates/runner/kit.json +7 -0
  259. package/templates/runner/opencode.json +41 -0
  260. package/templates/runner/package.json +50 -0
  261. package/templates/runner/playtests/performance.playtest.json +23 -0
  262. package/templates/runner/playtests/streams.playtest.json +38 -0
  263. package/templates/runner/playtests/survives.playtest.json +51 -0
  264. package/templates/runner/public/favicon.svg +5 -0
  265. package/templates/runner/src/conventions.ts +24 -0
  266. package/templates/runner/src/entities/Runner.ts +135 -0
  267. package/templates/runner/src/game.ts +50 -0
  268. package/templates/runner/src/main.ts +15 -0
  269. package/templates/runner/src/physics.ts +13 -0
  270. package/templates/runner/src/render/camera.ts +39 -0
  271. package/templates/runner/src/render/dust.ts +131 -0
  272. package/templates/runner/src/render/lighting.ts +57 -0
  273. package/templates/runner/src/render/loading.ts +325 -0
  274. package/templates/runner/src/render/materials.ts +27 -0
  275. package/templates/runner/src/render/palette.ts +30 -0
  276. package/templates/runner/src/render/postprocessing.ts +34 -0
  277. package/templates/runner/src/render/quality.ts +170 -0
  278. package/templates/runner/src/render/shapes.ts +68 -0
  279. package/templates/runner/src/render/sky.ts +51 -0
  280. package/templates/runner/src/render/touch-controls.ts +185 -0
  281. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  282. package/templates/runner/src/scenes/Boot.ts +12 -0
  283. package/templates/runner/src/scenes/Run.ts +142 -0
  284. package/templates/runner/src/state.ts +29 -0
  285. package/templates/runner/src/style.css +96 -0
  286. package/templates/runner/src/track.ts +176 -0
  287. package/templates/runner/src/ui/App.tsx +22 -0
  288. package/templates/runner/src/ui/GameUi.tsx +20 -0
  289. package/templates/runner/src/ui/Hud.tsx +55 -0
  290. package/templates/runner/src/ui/Menu.tsx +7 -0
  291. package/templates/runner/src/ui/main.tsx +14 -0
  292. package/templates/runner/tailwind.config.ts +1 -0
  293. package/templates/runner/threenative.config.ts +49 -0
  294. package/templates/runner/tsconfig.json +17 -0
  295. package/templates/runner/vite.config.ts +38 -0
  296. package/templates/sailing/.codex/config.toml +4 -0
  297. package/templates/sailing/.cursor/mcp.json +32 -0
  298. package/templates/sailing/.gemini/settings.json +32 -0
  299. package/templates/sailing/.mcp.json +15 -3
  300. package/templates/sailing/.vscode/mcp.json +36 -0
  301. package/templates/sailing/.zed/settings.json +36 -0
  302. package/templates/sailing/AGENTS.md +62 -355
  303. package/templates/sailing/CLAUDE.md +62 -355
  304. package/templates/sailing/README.md +12 -9
  305. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  306. package/templates/sailing/native-playtests/survives.playtest.json +20 -3
  307. package/templates/sailing/opencode.json +41 -0
  308. package/templates/sailing/package.json +8 -8
  309. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  310. package/templates/sailing/playtests/float.playtest.json +59 -0
  311. package/templates/sailing/playtests/performance.playtest.json +21 -6
  312. package/templates/sailing/playtests/survives.playtest.json +8 -0
  313. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  314. package/templates/sailing/src/conventions.ts +8 -0
  315. package/templates/sailing/src/entities/Ship.ts +150 -13
  316. package/templates/sailing/src/render/camera.ts +15 -8
  317. package/templates/sailing/src/render/lighting.ts +10 -5
  318. package/templates/sailing/src/render/loading.ts +12 -2
  319. package/templates/sailing/src/render/materials.ts +24 -8
  320. package/templates/sailing/src/render/ocean.ts +179 -0
  321. package/templates/sailing/src/render/palette.ts +14 -21
  322. package/templates/sailing/src/render/postprocessing.ts +23 -22
  323. package/templates/sailing/src/render/props.ts +584 -34
  324. package/templates/sailing/src/render/quality.ts +140 -0
  325. package/templates/sailing/src/render/sky.ts +8 -3
  326. package/templates/sailing/src/render/touch-controls.ts +142 -0
  327. package/templates/sailing/src/render/worldEnvironment.ts +206 -38
  328. package/templates/sailing/src/scenes/Sailing.ts +43 -16
  329. package/templates/sailing/src/style.css +20 -0
  330. package/templates/sailing/threenative.config.ts +7 -1
  331. package/templates/shooter/.codex/config.toml +4 -0
  332. package/templates/shooter/.cursor/mcp.json +32 -0
  333. package/templates/shooter/.gemini/settings.json +32 -0
  334. package/templates/shooter/.mcp.json +15 -3
  335. package/templates/shooter/.vscode/mcp.json +36 -0
  336. package/templates/shooter/.zed/settings.json +36 -0
  337. package/templates/shooter/AGENTS.md +76 -415
  338. package/templates/shooter/CLAUDE.md +76 -415
  339. package/templates/shooter/kit.json +2 -2
  340. package/templates/shooter/opencode.json +41 -0
  341. package/templates/shooter/package.json +7 -7
  342. package/templates/shooter/playtests/combat.playtest.json +48 -0
  343. package/templates/shooter/playtests/input-control.playtest.json +165 -35
  344. package/templates/shooter/playtests/per-item.playtest.json +3 -3
  345. package/templates/shooter/playtests/performance.playtest.json +24 -7
  346. package/templates/shooter/playtests/shooter.playtest.json +13 -7
  347. package/templates/shooter/playtests/survives.playtest.json +27 -0
  348. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  349. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  350. package/templates/shooter/src/combat/damage.ts +1 -2
  351. package/templates/shooter/src/conventions.ts +51 -0
  352. package/templates/shooter/src/entities/Player.ts +235 -18
  353. package/templates/shooter/src/entities/Target.ts +2 -2
  354. package/templates/shooter/src/game.ts +13 -4
  355. package/templates/shooter/src/render/camera.ts +49 -39
  356. package/templates/shooter/src/render/decals.ts +211 -0
  357. package/templates/shooter/src/render/lighting.ts +7 -3
  358. package/templates/shooter/src/render/loading.ts +12 -2
  359. package/templates/shooter/src/render/materials.ts +56 -3
  360. package/templates/shooter/src/render/palette.ts +6 -3
  361. package/templates/shooter/src/render/postprocessing.ts +21 -58
  362. package/templates/shooter/src/render/quality.ts +170 -0
  363. package/templates/shooter/src/render/scale.ts +22 -0
  364. package/templates/shooter/src/render/shapes.ts +343 -62
  365. package/templates/shooter/src/render/sky.ts +5 -1
  366. package/templates/shooter/src/render/touch-controls.ts +305 -0
  367. package/templates/shooter/src/render/ui.css +85 -0
  368. package/templates/shooter/src/render/ui.ts +19 -3
  369. package/templates/shooter/src/render/vfx.ts +215 -0
  370. package/templates/shooter/src/render/worldEnvironment.ts +208 -33
  371. package/templates/shooter/src/scenes/Play.ts +171 -56
  372. package/templates/shooter/src/state.ts +5 -0
  373. package/templates/shooter/src/style.css +20 -0
  374. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  375. package/templates/shooter/src/ui/GameUi.tsx +2 -0
  376. package/templates/shooter/src/ui/Hud.tsx +7 -1
  377. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  378. package/templates/shooter/src/weapons/Projectile.ts +8 -3
  379. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  380. package/templates/shooter/threenative.config.ts +7 -0
  381. package/templates/starter/.codex/config.toml +4 -0
  382. package/templates/starter/.cursor/mcp.json +32 -0
  383. package/templates/starter/.gemini/settings.json +32 -0
  384. package/templates/starter/.mcp.json +15 -3
  385. package/templates/starter/.vscode/mcp.json +36 -0
  386. package/templates/starter/.zed/settings.json +36 -0
  387. package/templates/starter/AGENTS.md +70 -527
  388. package/templates/starter/CLAUDE.md +70 -527
  389. package/templates/starter/native-playtests/render-chain.playtest.json +73 -4
  390. package/templates/starter/opencode.json +41 -0
  391. package/templates/starter/package.json +7 -7
  392. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  393. package/templates/starter/playtests/look.playtest.json +110 -6
  394. package/templates/starter/playtests/play.playtest.json +3 -2
  395. package/templates/starter/playtests/survives.playtest.json +21 -0
  396. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  397. package/templates/starter/src/conventions.ts +18 -0
  398. package/templates/starter/src/entities/Goal.ts +18 -3
  399. package/templates/starter/src/entities/Player.ts +72 -9
  400. package/templates/starter/src/game.ts +2 -0
  401. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  402. package/templates/starter/src/render/camera.ts +1 -1
  403. package/templates/starter/src/render/coast.ts +199 -0
  404. package/templates/starter/src/render/hero.ts +88 -0
  405. package/templates/starter/src/render/implicitSurface.ts +199 -0
  406. package/templates/starter/src/render/kuwahara.ts +174 -0
  407. package/templates/starter/src/render/lighting.ts +4 -4
  408. package/templates/starter/src/render/loading.ts +12 -2
  409. package/templates/starter/src/render/materials.ts +25 -6
  410. package/templates/starter/src/render/outline.ts +141 -0
  411. package/templates/starter/src/render/painterly.ts +86 -0
  412. package/templates/starter/src/render/palette.ts +15 -6
  413. package/templates/starter/src/render/postprocessing.ts +87 -36
  414. package/templates/starter/src/render/quality.ts +185 -0
  415. package/templates/starter/src/render/rockRidge.ts +198 -0
  416. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  417. package/templates/starter/src/render/scenery.ts +16 -59
  418. package/templates/starter/src/render/textureLifetime.ts +53 -0
  419. package/templates/starter/src/render/touch-controls.ts +165 -0
  420. package/templates/starter/src/render/water.ts +38 -0
  421. package/templates/starter/src/render/watercolor.ts +85 -0
  422. package/templates/starter/src/render/worldEnvironment.ts +208 -33
  423. package/templates/starter/src/scenes/Play.ts +103 -16
  424. package/templates/starter/src/style.css +27 -7
  425. package/templates/starter/threenative.config.ts +7 -7
  426. package/agent-docs/asset-mcp-loop.md +0 -33
  427. package/agent-docs/ctx-surface.md +0 -69
  428. package/agent-docs/engine-capabilities.md +0 -4
  429. package/agent-docs/framework-blocks-you.md +0 -60
  430. package/agent-docs/look-at-it-and-budget-the-look.md +0 -27
  431. package/agent-docs/performance-default.md +0 -42
  432. package/agent-docs/pixel-budget.md +0 -20
  433. package/agent-docs/playtest-fail-closed.md +0 -23
  434. package/agent-docs/sculpt-loop.md +0 -16
  435. package/templates/action-rpg/src/physics.ts +0 -40
  436. package/templates/defense/public/icon.png +0 -0
  437. package/templates/minimal/public/icon.png +0 -0
  438. package/templates/platformer/public/icon.png +0 -0
  439. package/templates/racing/public/icon.png +0 -0
  440. package/templates/sailing/public/icon.png +0 -0
  441. package/templates/sailing/src/render/water-material.ts +0 -14
  442. package/templates/sailing/src/render/water-shaders.ts +0 -12
  443. package/templates/sailing/src/render/wave-nodes.ts +0 -10
  444. package/templates/shooter/public/icon.png +0 -0
  445. package/templates/shooter/src/physics.ts +0 -49
  446. package/templates/starter/public/icon.png +0 -0
  447. /package/{templates/action-rpg/public → template-assets}/icon.png +0 -0
@@ -1,8 +1,46 @@
1
1
  import { BoxGeometry, CylinderGeometry, Group, type Material, Mesh, SphereGeometry } from "three";
2
+ import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
2
3
  import type { ReturnTypeOfMaterials } from "./types.js";
3
4
 
4
5
  export type RpgMaterials = ReturnTypeOfMaterials;
5
6
 
7
+ /**
8
+ * Bake rigid pieces down to one mesh per material.
9
+ *
10
+ * Flagstones, wall caps, torch brackets and the bedrock outside the room are a hundred-odd meshes
11
+ * that never move relative to the dungeon; authored one at a time they are a hundred-odd draw
12
+ * calls, and with the shadow pass that doubles. Everything a playtest looks up by name — the
13
+ * floor, the walls, the pillars, the line-of-sight wall — stays its own object.
14
+ */
15
+ function bake(parts: readonly Mesh[], root: Group): void {
16
+ const byMaterial = new Map<Material, Mesh[]>();
17
+ for (const mesh of parts) {
18
+ const bucket = byMaterial.get(mesh.material as Material);
19
+ if (bucket === undefined) byMaterial.set(mesh.material as Material, [mesh]);
20
+ else bucket.push(mesh);
21
+ }
22
+ for (const [material, meshes] of byMaterial) {
23
+ const geometry = mergeGeometries(
24
+ meshes.map((mesh) => {
25
+ mesh.updateMatrix();
26
+ const placed = mesh.geometry.clone().applyMatrix4(mesh.matrix);
27
+ const cloned = placed.index === null ? placed : placed.toNonIndexed();
28
+ for (const name of Object.keys(cloned.attributes)) {
29
+ if (name !== "position") cloned.deleteAttribute(name);
30
+ }
31
+ return cloned;
32
+ }),
33
+ false,
34
+ );
35
+ if (geometry === null) throw new Error("mergeGeometries returned null baking the dungeon.");
36
+ geometry.computeVertexNormals();
37
+ const merged = new Mesh(geometry, material);
38
+ merged.castShadow = meshes[0]?.castShadow ?? true;
39
+ merged.receiveShadow = true;
40
+ root.add(merged);
41
+ }
42
+ }
43
+
6
44
  function block(
7
45
  width: number,
8
46
  height: number,
@@ -19,24 +57,73 @@ function block(
19
57
  export function createDungeon(materials: RpgMaterials) {
20
58
  const group = new Group();
21
59
  group.name = "three-room-dungeon";
60
+ const dressing: Mesh[] = [];
22
61
  const floor = block(36, 0.3, 12, materials.stone, false);
23
62
  floor.name = "dungeon-floor";
24
63
  floor.position.set(6, -0.15, 0);
25
64
  group.add(floor);
26
65
 
66
+ // Floor courses: alternating flagstones, so the deck is masonry rather than one flat value.
67
+ for (let index = 0; index < 12; index += 1) {
68
+ const slab = block(2.8, 0.06, 11.4, materials.stoneDark, false);
69
+ slab.position.set(-10.6 + index * 3, 0.02, 0);
70
+ dressing.push(slab);
71
+ }
72
+
73
+ // Walls tall enough to close the shot. At 2.8 the camera — 8.4 up — looked clean over them into
74
+ // the empty sky, and the frame was half black void; a dungeon should be bounded by its walls.
75
+ //
76
+ // The **south** wall is the exception, and stays low. The camera sits behind it, so at full
77
+ // height its inner face filled the bottom-left of every frame and the room was behind it. A
78
+ // near wall you can see over is the oldest trick in an isometric dungeon and it costs one row
79
+ // of this table.
27
80
  const walls = [
28
- { name: "north-wall", size: [36, 2.8, 0.35] as const, position: [6, 1.4, -6] as const },
29
- { name: "south-wall", size: [36, 2.8, 0.35] as const, position: [6, 1.4, 6] as const },
30
- { name: "west-wall", size: [0.35, 2.8, 12] as const, position: [-12, 1.4, 0] as const },
31
- { name: "east-wall", size: [0.35, 2.8, 12] as const, position: [24, 1.4, 0] as const },
81
+ { name: "north-wall", size: [36, 5.2, 0.5] as const, position: [6, 2.6, -6] as const },
82
+ { name: "south-wall", size: [36, 2.2, 0.5] as const, position: [6, 1.1, 6] as const },
83
+ { name: "west-wall", size: [0.5, 5.2, 12] as const, position: [-12, 2.6, 0] as const },
84
+ { name: "east-wall", size: [0.5, 5.2, 12] as const, position: [24, 2.6, 0] as const },
32
85
  ].map(({ name, position, size }) => {
33
86
  const wall = block(size[0], size[1], size[2], materials.stone);
34
87
  wall.name = name;
35
88
  wall.position.set(position[0], position[1], position[2]);
36
89
  group.add(wall);
90
+ // A darker cap course along the top of every wall: one line that turns a slab into masonry.
91
+ const cap = block(size[0] + 0.24, 0.34, size[2] + 0.24, materials.stoneDark);
92
+ cap.position.set(position[0], position[1] + size[1] / 2 + 0.1, position[2]);
93
+ dressing.push(cap);
37
94
  return wall;
38
95
  });
39
96
 
97
+ // Bedrock: a thick mass outside every wall, level with its cap. A dungeon is *cut into* rock,
98
+ // and without this the frame showed black void wherever the follow camera drifted close enough
99
+ // to a wall to see past it — which is most of the level, since the hero starts beside one.
100
+ for (const [width, depth, x, z] of [
101
+ [52, 9, 6, -11.2],
102
+ [52, 9, 6, 11.6],
103
+ [9, 34, -17, 0],
104
+ [9, 34, 29, 0],
105
+ ] as const) {
106
+ const mass = block(width, 6.4, depth, materials.stoneDark);
107
+ mass.position.set(x, 2.9, z);
108
+ dressing.push(mass);
109
+ }
110
+
111
+ // Torches down both long walls. The one warm light source a dungeon needs to be a dungeon, and
112
+ // on one wall only the near half of every room sat in the dark.
113
+ for (const side of [-1, 1] as const) {
114
+ for (const x of [-8, -2, 4, 10, 16, 22]) {
115
+ const bracket = new Mesh(new CylinderGeometry(0.06, 0.08, 0.5, 5), materials.stoneDark);
116
+ bracket.position.set(x, 2.2, side * 5.6);
117
+ bracket.rotation.x = side * -0.4;
118
+ bracket.castShadow = true;
119
+ dressing.push(bracket);
120
+ const flame = new Mesh(new SphereGeometry(0.2, 7, 5), materials.flame);
121
+ flame.scale.y = 1.5;
122
+ flame.position.set(x, 2.6, side * 5.35);
123
+ dressing.push(flame);
124
+ }
125
+ }
126
+
40
127
  const roomPillars: Mesh[] = [];
41
128
  for (const x of [0, 12]) {
42
129
  for (const z of [-4.5, 4.5]) {
@@ -54,56 +141,128 @@ export function createDungeon(materials: RpgMaterials) {
54
141
  for (const x of [-6, 6, 18]) {
55
142
  const rune = block(3.2, 0.04, 0.08, materials.trim, false);
56
143
  rune.position.set(x, 0.025, 0);
57
- group.add(rune);
144
+ dressing.push(rune);
58
145
  }
146
+ bake(dressing, group);
59
147
  return { floor, group, lineOfSightWall, roomPillars, walls };
60
148
  }
61
149
 
150
+ /**
151
+ * The hero: a cloaked figure with a helm, a shield arm and a sword that has a hilt.
152
+ *
153
+ * A 0.72-cube torso with a sphere on top and a thin box beside it is what shipped, and from the
154
+ * dungeon camera it read as a teal box with a stick. The blade keeps the name `held-blade`
155
+ * because the equip playtest looks it up.
156
+ */
62
157
  export function createPlayerVisual(materials: RpgMaterials): Group {
63
158
  const group = new Group();
64
159
  group.name = "hero-visual";
65
- const body = block(0.72, 1.25, 0.72, materials.player);
66
- body.position.y = 0.65;
67
- group.add(body);
68
- const head = new Mesh(new SphereGeometry(0.32, 8, 6), materials.player);
69
- head.position.y = 1.42;
160
+ const torso = block(0.6, 0.7, 0.44, materials.player);
161
+ torso.position.y = 0.92;
162
+ group.add(torso);
163
+ const cloak = block(0.7, 0.9, 0.18, materials.stoneDark);
164
+ cloak.position.set(0, 0.86, 0.24);
165
+ group.add(cloak);
166
+ const belt = block(0.64, 0.12, 0.48, materials.accent);
167
+ belt.position.y = 0.6;
168
+ group.add(belt);
169
+ const head = new Mesh(new SphereGeometry(0.26, 8, 6), materials.player);
170
+ head.position.y = 1.44;
70
171
  head.castShadow = true;
71
172
  group.add(head);
72
- const blade = new Mesh(new BoxGeometry(0.08, 0.75, 0.16), materials.accent);
73
- blade.position.set(0.52, 0.66, -0.1);
74
- blade.rotation.z = -0.32;
173
+ const helm = block(0.34, 0.18, 0.36, materials.accent);
174
+ helm.position.y = 1.6;
175
+ group.add(helm);
176
+ for (const side of [-1, 1]) {
177
+ const leg = block(0.2, 0.56, 0.24, materials.stoneDark);
178
+ leg.position.set(side * 0.16, 0.28, 0);
179
+ group.add(leg);
180
+ const arm = block(0.16, 0.5, 0.2, materials.player);
181
+ arm.position.set(side * 0.38, 0.94, 0);
182
+ group.add(arm);
183
+ }
184
+ const shield = block(0.1, 0.6, 0.46, materials.accent);
185
+ shield.position.set(-0.48, 0.9, 0.04);
186
+ shield.rotation.z = 0.12;
187
+ group.add(shield);
188
+
189
+ const blade = new Mesh(new BoxGeometry(0.07, 0.86, 0.16), materials.accent);
190
+ blade.name = "held-blade";
191
+ blade.position.set(0.52, 1.06, -0.12);
192
+ blade.rotation.z = -0.28;
75
193
  blade.castShadow = true;
76
194
  group.add(blade);
195
+ const hilt = block(0.06, 0.14, 0.3, materials.stoneDark);
196
+ hilt.position.set(0.45, 0.68, -0.06);
197
+ hilt.rotation.z = -0.28;
198
+ group.add(hilt);
77
199
  return group;
78
200
  }
79
201
 
202
+ /** The hostiles: a hunched brute, and a taller crowned one for the boss. */
80
203
  export function createEnemyVisual(materials: RpgMaterials, boss: boolean): Group {
81
204
  const group = new Group();
82
205
  group.name = boss ? "boss-visual" : "enemy-visual";
83
- const size = boss ? 1.2 : 0.82;
84
- const body = block(size, boss ? 1.9 : 1.35, size, materials.enemy);
85
- body.position.y = boss ? 0.95 : 0.67;
86
- group.add(body);
87
- const eye = new Mesh(new SphereGeometry(boss ? 0.18 : 0.12, 6, 4), materials.trim);
88
- eye.position.set(0, boss ? 1.45 : 1.08, -size / 2 - 0.03);
206
+ const scale = boss ? 1.4 : 1;
207
+ const chest = block(0.86 * scale, 0.66 * scale, 0.6 * scale, materials.enemy);
208
+ chest.position.y = 0.94 * scale;
209
+ group.add(chest);
210
+ const hips = block(0.6 * scale, 0.4 * scale, 0.48 * scale, materials.stoneDark);
211
+ hips.position.y = 0.48 * scale;
212
+ group.add(hips);
213
+ const head = block(0.44 * scale, 0.34 * scale, 0.42 * scale, materials.enemy);
214
+ head.position.set(0, 1.36 * scale, -0.1 * scale);
215
+ group.add(head);
216
+ const eye = new Mesh(new SphereGeometry(0.11 * scale, 6, 4), materials.trim);
217
+ eye.position.set(0, 1.36 * scale, -0.34 * scale);
89
218
  eye.castShadow = true;
90
219
  group.add(eye);
220
+ for (const side of [-1, 1]) {
221
+ // Horns: the cheapest read that separates a hostile from a crate at dungeon-camera distance.
222
+ const horn = new Mesh(
223
+ new CylinderGeometry(0.02 * scale, 0.09 * scale, 0.4 * scale, 5),
224
+ materials.stoneDark,
225
+ );
226
+ horn.position.set(side * 0.2 * scale, 1.6 * scale, -0.06 * scale);
227
+ horn.rotation.z = side * 0.5;
228
+ horn.castShadow = true;
229
+ group.add(horn);
230
+ const arm = block(0.2 * scale, 0.62 * scale, 0.22 * scale, materials.enemy);
231
+ arm.position.set(side * 0.56 * scale, 0.9 * scale, 0);
232
+ arm.rotation.z = side * -0.16;
233
+ group.add(arm);
234
+ const leg = block(0.24 * scale, 0.44 * scale, 0.28 * scale, materials.stoneDark);
235
+ leg.position.set(side * 0.18 * scale, 0.22 * scale, 0);
236
+ group.add(leg);
237
+ }
91
238
  if (boss) {
92
- const crown = new Mesh(new CylinderGeometry(0.48, 0.24, 0.42, 6), materials.accent);
93
- crown.position.y = 2.0;
239
+ const crown = new Mesh(new CylinderGeometry(0.52, 0.3, 0.36, 6), materials.accent);
240
+ crown.position.y = 2.02;
94
241
  crown.castShadow = true;
95
242
  group.add(crown);
243
+ const mantle = block(1.3, 0.16, 0.9, materials.accent);
244
+ mantle.position.y = 1.78;
245
+ group.add(mantle);
96
246
  }
97
247
  return group;
98
248
  }
99
249
 
250
+ /** Loot: a banded chest with a lit gem in its lid. A plinth with a marble on it read as neither. */
100
251
  export function createLootVisual(materials: RpgMaterials): Group {
101
252
  const group = new Group();
102
- const base = block(0.55, 0.12, 0.55, materials.accent);
103
- base.position.y = 0.06;
104
- group.add(base);
105
- const gem = new Mesh(new SphereGeometry(0.2, 6, 4), materials.player);
106
- gem.position.y = 0.36;
253
+ const body = block(0.66, 0.36, 0.46, materials.stoneDark);
254
+ body.position.y = 0.18;
255
+ group.add(body);
256
+ const lid = block(0.7, 0.16, 0.5, materials.accent);
257
+ lid.position.y = 0.44;
258
+ group.add(lid);
259
+ for (const x of [-0.22, 0.22]) {
260
+ const band = block(0.07, 0.5, 0.52, materials.accent);
261
+ band.position.set(x, 0.24, 0);
262
+ group.add(band);
263
+ }
264
+ const gem = new Mesh(new SphereGeometry(0.13, 7, 5), materials.player);
265
+ gem.position.y = 0.58;
107
266
  gem.castShadow = true;
108
267
  group.add(gem);
109
268
  return group;
@@ -0,0 +1,185 @@
1
+ import {
2
+ CircleGeometry,
3
+ type ColorRepresentation,
4
+ Group,
5
+ MathUtils,
6
+ Mesh,
7
+ MeshBasicMaterial,
8
+ type PerspectiveCamera,
9
+ RingGeometry,
10
+ Vector2,
11
+ } from "three";
12
+ import { palette } from "./palette.js";
13
+
14
+ const MOVE_RADIUS = 72;
15
+ const BUTTON_RADIUS = 58;
16
+ const EDGE = 36;
17
+
18
+ export interface ITouchPointer {
19
+ readonly position: Vector2;
20
+ }
21
+
22
+ export interface ITouchViewport {
23
+ readonly height: number;
24
+ readonly width: number;
25
+ }
26
+
27
+ export interface ITouchInput {
28
+ readonly abilityPressed: boolean;
29
+ readonly attackPressed: boolean;
30
+ readonly move: Vector2;
31
+ }
32
+
33
+ function overlayMaterial(color: ColorRepresentation, opacity: number): MeshBasicMaterial {
34
+ return new MeshBasicMaterial({
35
+ color,
36
+ depthTest: false,
37
+ depthWrite: false,
38
+ opacity,
39
+ transparent: true,
40
+ });
41
+ }
42
+
43
+ function ringMesh(radius: number, material: MeshBasicMaterial): Mesh {
44
+ return new Mesh(new RingGeometry(radius - 5, radius, 32), material);
45
+ }
46
+
47
+ function place(mesh: Mesh, point: Vector2): void {
48
+ mesh.position.set(point.x, point.y, 0);
49
+ }
50
+
51
+ function controlPoint(size: ITouchViewport, name: "ability" | "attack" | "move"): Vector2 {
52
+ if (name === "move") return new Vector2(MOVE_RADIUS + EDGE, size.height - MOVE_RADIUS - EDGE);
53
+ const yOffset = name === "ability" ? BUTTON_RADIUS * 2 + EDGE : 0;
54
+ return new Vector2(
55
+ size.width - BUTTON_RADIUS - EDGE,
56
+ size.height - BUTTON_RADIUS - EDGE - yOffset,
57
+ );
58
+ }
59
+
60
+ export class TouchControls {
61
+ readonly root = new Group();
62
+ readonly object = this.root;
63
+ #camera: PerspectiveCamera;
64
+ #input: { abilityPressed: boolean; attackPressed: boolean; move: Vector2 } = {
65
+ abilityPressed: false,
66
+ attackPressed: false,
67
+ move: new Vector2(),
68
+ };
69
+ #wasAbility = false;
70
+ #wasAttack = false;
71
+ #moveAnchor = new Vector2();
72
+ #resting = new Vector2();
73
+ #abilityCenter = new Vector2();
74
+ #attackCenter = new Vector2();
75
+ #hasMoveAnchor = false;
76
+ #lastWidth = -1;
77
+ #lastHeight = -1;
78
+ #moveBase: Mesh;
79
+ #moveKnob: Mesh;
80
+ #ability: Mesh;
81
+ #attack: Mesh;
82
+ #idleMaterial: MeshBasicMaterial;
83
+ #activeMaterial: MeshBasicMaterial;
84
+
85
+ constructor(camera: PerspectiveCamera) {
86
+ this.#camera = camera;
87
+ this.#idleMaterial = overlayMaterial(palette.stone, 0.35);
88
+ this.#activeMaterial = overlayMaterial(palette.accent, 0.6);
89
+ this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
90
+ this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);
91
+ this.#ability = ringMesh(BUTTON_RADIUS, this.#idleMaterial);
92
+ this.#attack = ringMesh(BUTTON_RADIUS, this.#idleMaterial);
93
+ this.root.add(this.#moveBase, this.#moveKnob, this.#ability, this.#attack);
94
+ this.root.renderOrder = 10_001;
95
+ camera.add(this.root);
96
+ }
97
+
98
+ update(pointers: ReadonlyMap<number, ITouchPointer>, size: ITouchViewport): ITouchInput {
99
+ this.#ensureLayout(size);
100
+ const attack = this.#at(pointers, this.#attackCenter, BUTTON_RADIUS);
101
+ const ability = this.#at(pointers, this.#abilityCenter, BUTTON_RADIUS);
102
+ let movement: ITouchPointer | undefined;
103
+ for (const pointer of pointers.values()) {
104
+ if (pointer.position.x < size.width * 0.5) {
105
+ movement = pointer;
106
+ break;
107
+ }
108
+ }
109
+
110
+ if (movement === undefined) {
111
+ this.#hasMoveAnchor = false;
112
+ this.#input.move.set(0, 0);
113
+ } else {
114
+ if (!this.#hasMoveAnchor) {
115
+ this.#moveAnchor.copy(movement.position);
116
+ this.#hasMoveAnchor = true;
117
+ }
118
+ this.#input.move.set(
119
+ MathUtils.clamp((movement.position.x - this.#moveAnchor.x) / MOVE_RADIUS, -1, 1),
120
+ MathUtils.clamp((this.#moveAnchor.y - movement.position.y) / MOVE_RADIUS, -1, 1),
121
+ );
122
+ }
123
+
124
+ const center = this.#hasMoveAnchor ? this.#moveAnchor : this.#resting;
125
+ place(
126
+ this.#moveKnob,
127
+ new Vector2(
128
+ center.x + this.#input.move.x * MOVE_RADIUS,
129
+ center.y - this.#input.move.y * MOVE_RADIUS,
130
+ ),
131
+ );
132
+ this.#ability.material = ability ? this.#activeMaterial : this.#idleMaterial;
133
+ this.#attack.material = attack ? this.#activeMaterial : this.#idleMaterial;
134
+ this.#input.abilityPressed = ability && !this.#wasAbility;
135
+ this.#input.attackPressed = attack && !this.#wasAttack;
136
+ this.#wasAbility = ability;
137
+ this.#wasAttack = attack;
138
+ this.#layout(size);
139
+ return this.#input;
140
+ }
141
+
142
+ debug(): Record<string, unknown> {
143
+ return {
144
+ ability: this.#wasAbility,
145
+ attack: this.#wasAttack,
146
+ move: this.#input.move.toArray(),
147
+ };
148
+ }
149
+
150
+ dispose(): void {
151
+ this.root.removeFromParent();
152
+ for (const child of this.root.children) {
153
+ if (child instanceof Mesh) child.geometry.dispose();
154
+ }
155
+ this.#idleMaterial.dispose();
156
+ this.#activeMaterial.dispose();
157
+ }
158
+
159
+ #ensureLayout(size: ITouchViewport): void {
160
+ if (size.width === this.#lastWidth && size.height === this.#lastHeight) return;
161
+ this.#lastWidth = size.width;
162
+ this.#lastHeight = size.height;
163
+ this.#resting.copy(controlPoint(size, "move"));
164
+ this.#abilityCenter.copy(controlPoint(size, "ability"));
165
+ this.#attackCenter.copy(controlPoint(size, "attack"));
166
+ }
167
+
168
+ #layout(size: ITouchViewport): void {
169
+ const worldHeight = 2 * Math.tan(MathUtils.degToRad(this.#camera.fov / 2));
170
+ const pixels = worldHeight / Math.max(1, size.height);
171
+ this.root.position.set(-(size.width * pixels) / 2, worldHeight / 2, -1);
172
+ this.root.scale.set(pixels, -pixels, 1);
173
+ place(this.#moveBase, this.#hasMoveAnchor ? this.#moveAnchor : this.#resting);
174
+ place(this.#ability, this.#abilityCenter);
175
+ place(this.#attack, this.#attackCenter);
176
+ }
177
+
178
+ #at(pointers: ReadonlyMap<number, ITouchPointer>, center: Vector2, radius: number): boolean {
179
+ const radiusSquared = radius * radius;
180
+ for (const pointer of pointers.values()) {
181
+ if (pointer.position.distanceToSquared(center) <= radiusSquared) return true;
182
+ }
183
+ return false;
184
+ }
185
+ }