create-threenative 0.2.2 → 0.2.4

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 (588) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +61 -2
  3. package/agent-docs/references/assertion-reference.md +819 -0
  4. package/agent-docs/references/capability-reference.md +4483 -0
  5. package/agent-docs/references/capture-the-frame.md +60 -0
  6. package/agent-docs/references/creating-creatures.md +215 -0
  7. package/agent-docs/references/ctx-cookbook.md +120 -0
  8. package/agent-docs/references/debug-surface.md +68 -0
  9. package/agent-docs/references/dream-loop.md +150 -0
  10. package/agent-docs/references/finding-assets.md +215 -0
  11. package/agent-docs/references/gameplay-recipes.md +54 -0
  12. package/agent-docs/references/menu-screens.md +69 -0
  13. package/agent-docs/references/mobile-memory-budget.md +87 -0
  14. package/agent-docs/references/sculpt-from-a-reference.md +40 -0
  15. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  16. package/agent-docs/references/visual-baseline.md +174 -0
  17. package/agent-docs/references/webview-ui.md +113 -0
  18. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  19. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  20. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  21. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  22. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  23. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  24. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  25. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  26. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  27. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  28. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  29. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  30. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  31. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  32. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  33. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  34. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  35. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  36. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  37. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  38. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  39. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  40. package/agent-files/.threenative/agents/builder.md +32 -0
  41. package/agent-files/.threenative/agents/verifier.md +31 -0
  42. package/agent-files/AGENT-ROLES.md +26 -0
  43. package/agent-files/scripts/reference.mjs +705 -0
  44. package/agent-files/scripts/visual-loop.mjs +382 -0
  45. package/capabilities.json +5292 -0
  46. package/dist/index.d.ts +224 -3
  47. package/dist/index.js +1972 -73
  48. package/dist/threenative.d.ts +9 -2
  49. package/dist/threenative.js +2570 -176
  50. package/package.json +55 -6
  51. package/template-assets/icon.png +0 -0
  52. package/template-assets/loading.ts +325 -0
  53. package/template-assets/patches/three@0.185.1.patch +522 -0
  54. package/template-assets/worldEnvironment.ts +758 -0
  55. package/templates/action-rpg/.codex/config.toml +19 -0
  56. package/templates/action-rpg/.cursor/mcp.json +32 -0
  57. package/templates/action-rpg/.gemini/settings.json +32 -0
  58. package/templates/action-rpg/.mcp.json +18 -2
  59. package/templates/action-rpg/.vscode/mcp.json +36 -0
  60. package/templates/action-rpg/.zed/settings.json +36 -0
  61. package/templates/action-rpg/AGENTS.md +84 -29
  62. package/templates/action-rpg/CLAUDE.md +84 -29
  63. package/templates/action-rpg/index.html +0 -1
  64. package/templates/action-rpg/opencode.json +41 -0
  65. package/templates/action-rpg/package.json +15 -11
  66. package/templates/action-rpg/playtests/combat.playtest.json +32 -9
  67. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  68. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  69. package/templates/action-rpg/playtests/performance.playtest.json +39 -0
  70. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  71. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  72. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  73. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  74. package/templates/action-rpg/src/conventions.ts +35 -0
  75. package/templates/action-rpg/src/entities/Enemy.ts +16 -7
  76. package/templates/action-rpg/src/entities/Player.ts +20 -3
  77. package/templates/action-rpg/src/game.ts +21 -0
  78. package/templates/action-rpg/src/render/camera.ts +7 -2
  79. package/templates/action-rpg/src/render/lighting.ts +11 -4
  80. package/templates/action-rpg/src/render/loading.ts +278 -43
  81. package/templates/action-rpg/src/render/materials.ts +11 -0
  82. package/templates/action-rpg/src/render/palette.ts +10 -3
  83. package/templates/action-rpg/src/render/postprocessing.ts +32 -16
  84. package/templates/action-rpg/src/render/quality.ts +170 -0
  85. package/templates/action-rpg/src/render/shapes.ts +185 -26
  86. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  87. package/templates/action-rpg/src/render/vfx.ts +257 -0
  88. package/templates/action-rpg/src/render/worldEnvironment.ts +758 -0
  89. package/templates/action-rpg/src/scenes/Play.ts +91 -24
  90. package/templates/action-rpg/src/state.ts +4 -0
  91. package/templates/action-rpg/src/style.css +65 -1
  92. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  93. package/templates/action-rpg/src/ui/App.tsx +9 -8
  94. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  95. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  96. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  97. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  98. package/templates/action-rpg/src/ui/main.tsx +14 -0
  99. package/templates/action-rpg/threenative.config.ts +28 -8
  100. package/templates/action-rpg/vite.config.ts +32 -2
  101. package/templates/defense/.codex/config.toml +19 -0
  102. package/templates/defense/.cursor/mcp.json +32 -0
  103. package/templates/defense/.gemini/settings.json +32 -0
  104. package/templates/defense/.mcp.json +18 -2
  105. package/templates/defense/.vscode/mcp.json +36 -0
  106. package/templates/defense/.zed/settings.json +36 -0
  107. package/templates/defense/AGENTS.md +81 -41
  108. package/templates/defense/CLAUDE.md +81 -41
  109. package/templates/defense/README.md +2 -1
  110. package/templates/defense/index.html +0 -1
  111. package/templates/defense/opencode.json +41 -0
  112. package/templates/defense/package.json +16 -12
  113. package/templates/defense/playtests/leak.playtest.json +9 -4
  114. package/templates/defense/playtests/performance.playtest.json +39 -0
  115. package/templates/defense/playtests/placement.playtest.json +5 -5
  116. package/templates/defense/playtests/pointer-placement.playtest.json +156 -0
  117. package/templates/defense/playtests/scan.playtest.json +4 -4
  118. package/templates/defense/playtests/survive.playtest.json +25 -6
  119. package/templates/defense/src/attackers/Attacker.ts +32 -16
  120. package/templates/defense/src/board/Route.ts +22 -8
  121. package/templates/defense/src/conventions.ts +18 -0
  122. package/templates/defense/src/entities/Player.ts +11 -3
  123. package/templates/defense/src/game.ts +25 -4
  124. package/templates/defense/src/physics.ts +9 -39
  125. package/templates/defense/src/placement/Buildable.ts +4 -4
  126. package/templates/defense/src/render/camera.ts +9 -3
  127. package/templates/defense/src/render/lighting.ts +6 -1
  128. package/templates/defense/src/render/loading.ts +274 -38
  129. package/templates/defense/src/render/materials.ts +9 -0
  130. package/templates/defense/src/render/palette.ts +12 -5
  131. package/templates/defense/src/render/postprocessing.ts +32 -12
  132. package/templates/defense/src/render/quality.ts +170 -0
  133. package/templates/defense/src/render/shapes.ts +180 -23
  134. package/templates/defense/src/render/sky.ts +2 -2
  135. package/templates/defense/src/render/worldEnvironment.ts +758 -0
  136. package/templates/defense/src/scenes/Boot.ts +2 -2
  137. package/templates/defense/src/scenes/Defense.ts +122 -56
  138. package/templates/defense/src/state.ts +6 -0
  139. package/templates/defense/src/style.css +65 -1
  140. package/templates/defense/src/towers/Tower.ts +11 -12
  141. package/templates/defense/src/towers/targeting.ts +1 -1
  142. package/templates/defense/src/ui/App.tsx +11 -6
  143. package/templates/defense/src/ui/GameUi.tsx +20 -0
  144. package/templates/defense/src/ui/Hud.tsx +6 -5
  145. package/templates/defense/src/ui/main.tsx +14 -0
  146. package/templates/defense/threenative.config.ts +28 -8
  147. package/templates/defense/vite.config.ts +34 -1
  148. package/templates/minimal/.codex/config.toml +19 -0
  149. package/templates/minimal/.cursor/mcp.json +32 -0
  150. package/templates/minimal/.gemini/settings.json +32 -0
  151. package/templates/minimal/.mcp.json +18 -2
  152. package/templates/minimal/.vscode/mcp.json +36 -0
  153. package/templates/minimal/.zed/settings.json +36 -0
  154. package/templates/minimal/AGENTS.md +78 -382
  155. package/templates/minimal/CLAUDE.md +78 -382
  156. package/templates/minimal/index.html +0 -1
  157. package/templates/minimal/opencode.json +41 -0
  158. package/templates/minimal/package.json +14 -11
  159. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  160. package/templates/minimal/playtests/play.playtest.json +18 -5
  161. package/templates/minimal/playtests/survives.playtest.json +48 -4
  162. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  163. package/templates/minimal/src/conventions.ts +18 -0
  164. package/templates/minimal/src/entities/Player.ts +39 -6
  165. package/templates/minimal/src/game.ts +1 -0
  166. package/templates/minimal/src/main.ts +14 -4
  167. package/templates/minimal/src/render/camera.ts +1 -1
  168. package/templates/minimal/src/render/hud.ts +24 -8
  169. package/templates/minimal/src/render/lighting.ts +23 -2
  170. package/templates/minimal/src/render/loading.ts +23 -103
  171. package/templates/minimal/src/render/materials.ts +7 -0
  172. package/templates/minimal/src/render/palette.ts +3 -3
  173. package/templates/minimal/src/render/postprocessing.ts +55 -16
  174. package/templates/minimal/src/render/quality.ts +162 -0
  175. package/templates/minimal/src/render/sky.ts +51 -32
  176. package/templates/minimal/src/render/touch-controls.ts +165 -0
  177. package/templates/minimal/src/render/worldEnvironment.ts +758 -0
  178. package/templates/minimal/src/scenes/Play.ts +128 -14
  179. package/templates/minimal/src/state.ts +8 -1
  180. package/templates/minimal/src/style.css +20 -0
  181. package/templates/minimal/threenative.config.ts +22 -10
  182. package/templates/minimal/vite.config.ts +28 -1
  183. package/templates/platformer/.codex/config.toml +19 -0
  184. package/templates/platformer/.cursor/mcp.json +32 -0
  185. package/templates/platformer/.gemini/settings.json +32 -0
  186. package/templates/platformer/.mcp.json +18 -2
  187. package/templates/platformer/.vscode/mcp.json +36 -0
  188. package/templates/platformer/.zed/settings.json +36 -0
  189. package/templates/platformer/AGENTS.md +81 -186
  190. package/templates/platformer/CLAUDE.md +81 -186
  191. package/templates/platformer/index.html +0 -1
  192. package/templates/platformer/opencode.json +41 -0
  193. package/templates/platformer/package.json +17 -14
  194. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  195. package/templates/platformer/playtests/branding.playtest.json +29 -0
  196. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  197. package/templates/platformer/playtests/collect.playtest.json +1 -1
  198. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  199. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  200. package/templates/platformer/playtests/damage.playtest.json +4 -1
  201. package/templates/platformer/playtests/dash.playtest.json +2 -2
  202. package/templates/platformer/playtests/jump.playtest.json +2 -3
  203. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  204. package/templates/platformer/playtests/oneway.playtest.json +30 -3
  205. package/templates/platformer/playtests/performance.playtest.json +7 -5
  206. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  207. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  208. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  209. package/templates/platformer/playtests/survives.playtest.json +31 -0
  210. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +16 -4
  211. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  212. package/templates/platformer/playtests/touch-controls-web.playtest.json +57 -0
  213. package/templates/platformer/src/conventions.ts +18 -0
  214. package/templates/platformer/src/entities/Character.ts +79 -11
  215. package/templates/platformer/src/entities/Patrol.ts +5 -0
  216. package/templates/platformer/src/game.ts +27 -2
  217. package/templates/platformer/src/level/Platform.ts +13 -1
  218. package/templates/platformer/src/render/lighting.ts +13 -5
  219. package/templates/platformer/src/render/loading.ts +281 -62
  220. package/templates/platformer/src/render/palette.ts +4 -1
  221. package/templates/platformer/src/render/postprocessing.ts +42 -14
  222. package/templates/platformer/src/render/quality.ts +170 -0
  223. package/templates/platformer/src/render/touch-controls.ts +54 -36
  224. package/templates/platformer/src/render/worldEnvironment.ts +758 -0
  225. package/templates/platformer/src/scenes/Level.ts +97 -32
  226. package/templates/platformer/src/state.ts +4 -0
  227. package/templates/platformer/src/style.css +65 -1
  228. package/templates/platformer/src/ui/App.tsx +9 -4
  229. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  230. package/templates/platformer/src/ui/Hud.tsx +6 -5
  231. package/templates/platformer/src/ui/main.tsx +14 -0
  232. package/templates/platformer/threenative.config.ts +27 -10
  233. package/templates/platformer/vite.config.ts +34 -1
  234. package/templates/puzzle/.codex/config.toml +19 -0
  235. package/templates/puzzle/.cursor/mcp.json +32 -0
  236. package/templates/puzzle/.gemini/settings.json +32 -0
  237. package/templates/puzzle/.mcp.json +32 -0
  238. package/templates/puzzle/.vscode/mcp.json +36 -0
  239. package/templates/puzzle/.zed/settings.json +36 -0
  240. package/templates/puzzle/AGENTS.md +96 -0
  241. package/templates/puzzle/CLAUDE.md +98 -0
  242. package/templates/puzzle/README.md +43 -0
  243. package/templates/puzzle/index.html +12 -0
  244. package/templates/puzzle/kit.json +7 -0
  245. package/templates/puzzle/opencode.json +41 -0
  246. package/templates/puzzle/package.json +50 -0
  247. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  248. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  249. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  250. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  251. package/templates/puzzle/public/favicon.svg +5 -0
  252. package/templates/puzzle/src/conventions.ts +25 -0
  253. package/templates/puzzle/src/entities/Ball.ts +70 -0
  254. package/templates/puzzle/src/entities/Crate.ts +76 -0
  255. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  256. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  257. package/templates/puzzle/src/game.ts +48 -0
  258. package/templates/puzzle/src/main.ts +15 -0
  259. package/templates/puzzle/src/physics.ts +19 -0
  260. package/templates/puzzle/src/render/camera.ts +37 -0
  261. package/templates/puzzle/src/render/lighting.ts +55 -0
  262. package/templates/puzzle/src/render/loading.ts +325 -0
  263. package/templates/puzzle/src/render/materials.ts +28 -0
  264. package/templates/puzzle/src/render/palette.ts +31 -0
  265. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  266. package/templates/puzzle/src/render/quality.ts +170 -0
  267. package/templates/puzzle/src/render/shapes.ts +134 -0
  268. package/templates/puzzle/src/render/sky.ts +16 -0
  269. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  270. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  271. package/templates/puzzle/src/room.ts +83 -0
  272. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  273. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  274. package/templates/puzzle/src/state.ts +30 -0
  275. package/templates/puzzle/src/style.css +96 -0
  276. package/templates/puzzle/src/ui/App.tsx +22 -0
  277. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  278. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  279. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  280. package/templates/puzzle/src/ui/main.tsx +14 -0
  281. package/templates/puzzle/tailwind.config.ts +1 -0
  282. package/templates/puzzle/threenative.config.ts +49 -0
  283. package/templates/puzzle/tsconfig.json +17 -0
  284. package/templates/puzzle/vite.config.ts +38 -0
  285. package/templates/racing/.codex/config.toml +19 -0
  286. package/templates/racing/.cursor/mcp.json +32 -0
  287. package/templates/racing/.gemini/settings.json +32 -0
  288. package/templates/racing/.mcp.json +18 -2
  289. package/templates/racing/.vscode/mcp.json +36 -0
  290. package/templates/racing/.zed/settings.json +36 -0
  291. package/templates/racing/AGENTS.md +84 -36
  292. package/templates/racing/CLAUDE.md +84 -36
  293. package/templates/racing/index.html +0 -1
  294. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  295. package/templates/racing/opencode.json +41 -0
  296. package/templates/racing/package.json +17 -12
  297. package/templates/racing/playtests/boost.playtest.json +5 -5
  298. package/templates/racing/playtests/outcome.playtest.json +14 -4
  299. package/templates/racing/playtests/performance.playtest.json +39 -0
  300. package/templates/racing/playtests/ranking.playtest.json +2 -2
  301. package/templates/racing/playtests/rescue.playtest.json +12 -6
  302. package/templates/racing/playtests/reverse.playtest.json +3 -3
  303. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  304. package/templates/racing/playtests/survives.playtest.json +36 -4
  305. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  306. package/templates/racing/src/conventions.ts +6 -0
  307. package/templates/racing/src/entities/RacingCar.ts +16 -4
  308. package/templates/racing/src/entities/Rival.ts +5 -2
  309. package/templates/racing/src/game.ts +24 -1
  310. package/templates/racing/src/render/camera.ts +15 -8
  311. package/templates/racing/src/render/lighting.ts +28 -14
  312. package/templates/racing/src/render/loading.ts +302 -35
  313. package/templates/racing/src/render/materials.ts +54 -4
  314. package/templates/racing/src/render/palette.ts +23 -6
  315. package/templates/racing/src/render/postprocessing.ts +32 -12
  316. package/templates/racing/src/render/quality.ts +170 -0
  317. package/templates/racing/src/render/shapes.ts +537 -26
  318. package/templates/racing/src/render/sky.ts +5 -2
  319. package/templates/racing/src/render/touch-controls.ts +185 -0
  320. package/templates/racing/src/render/worldEnvironment.ts +758 -0
  321. package/templates/racing/src/scenes/Race.ts +84 -37
  322. package/templates/racing/src/state.ts +4 -0
  323. package/templates/racing/src/style.css +65 -1
  324. package/templates/racing/src/track/Lap.ts +20 -9
  325. package/templates/racing/src/track/Ranking.ts +53 -14
  326. package/templates/racing/src/track/Track.ts +284 -32
  327. package/templates/racing/src/track/TrackSector.ts +14 -4
  328. package/templates/racing/src/ui/App.tsx +9 -4
  329. package/templates/racing/src/ui/GameUi.tsx +20 -0
  330. package/templates/racing/src/ui/Hud.tsx +6 -5
  331. package/templates/racing/src/ui/main.tsx +14 -0
  332. package/templates/racing/threenative.config.ts +28 -8
  333. package/templates/racing/vite.config.ts +34 -1
  334. package/templates/runner/.codex/config.toml +19 -0
  335. package/templates/runner/.cursor/mcp.json +32 -0
  336. package/templates/runner/.gemini/settings.json +32 -0
  337. package/templates/runner/.mcp.json +32 -0
  338. package/templates/runner/.vscode/mcp.json +36 -0
  339. package/templates/runner/.zed/settings.json +36 -0
  340. package/templates/runner/AGENTS.md +96 -0
  341. package/templates/runner/CLAUDE.md +98 -0
  342. package/templates/runner/README.md +43 -0
  343. package/templates/runner/index.html +12 -0
  344. package/templates/runner/kit.json +7 -0
  345. package/templates/runner/opencode.json +41 -0
  346. package/templates/runner/package.json +50 -0
  347. package/templates/runner/playtests/performance.playtest.json +23 -0
  348. package/templates/runner/playtests/streams.playtest.json +38 -0
  349. package/templates/runner/playtests/survives.playtest.json +51 -0
  350. package/templates/runner/public/favicon.svg +5 -0
  351. package/templates/runner/src/conventions.ts +24 -0
  352. package/templates/runner/src/entities/Runner.ts +135 -0
  353. package/templates/runner/src/game.ts +50 -0
  354. package/templates/runner/src/main.ts +15 -0
  355. package/templates/runner/src/physics.ts +13 -0
  356. package/templates/runner/src/render/camera.ts +39 -0
  357. package/templates/runner/src/render/dust.ts +131 -0
  358. package/templates/runner/src/render/lighting.ts +57 -0
  359. package/templates/runner/src/render/loading.ts +325 -0
  360. package/templates/runner/src/render/materials.ts +27 -0
  361. package/templates/runner/src/render/palette.ts +30 -0
  362. package/templates/runner/src/render/postprocessing.ts +34 -0
  363. package/templates/runner/src/render/quality.ts +170 -0
  364. package/templates/runner/src/render/shapes.ts +68 -0
  365. package/templates/runner/src/render/sky.ts +51 -0
  366. package/templates/runner/src/render/touch-controls.ts +185 -0
  367. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  368. package/templates/runner/src/scenes/Boot.ts +12 -0
  369. package/templates/runner/src/scenes/Run.ts +142 -0
  370. package/templates/runner/src/state.ts +29 -0
  371. package/templates/runner/src/style.css +96 -0
  372. package/templates/runner/src/track.ts +176 -0
  373. package/templates/runner/src/ui/App.tsx +22 -0
  374. package/templates/runner/src/ui/GameUi.tsx +20 -0
  375. package/templates/runner/src/ui/Hud.tsx +55 -0
  376. package/templates/runner/src/ui/Menu.tsx +7 -0
  377. package/templates/runner/src/ui/main.tsx +14 -0
  378. package/templates/runner/tailwind.config.ts +1 -0
  379. package/templates/runner/threenative.config.ts +49 -0
  380. package/templates/runner/tsconfig.json +17 -0
  381. package/templates/runner/vite.config.ts +38 -0
  382. package/templates/sailing/.codex/config.toml +19 -0
  383. package/templates/sailing/.cursor/mcp.json +32 -0
  384. package/templates/sailing/.gemini/settings.json +32 -0
  385. package/templates/sailing/.mcp.json +32 -0
  386. package/templates/sailing/.vscode/mcp.json +36 -0
  387. package/templates/sailing/.zed/settings.json +36 -0
  388. package/templates/sailing/AGENTS.md +95 -0
  389. package/templates/sailing/CLAUDE.md +97 -0
  390. package/templates/sailing/README.md +28 -0
  391. package/templates/sailing/index.html +12 -0
  392. package/templates/sailing/kit.json +7 -0
  393. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  394. package/templates/sailing/native-playtests/survives.playtest.json +38 -0
  395. package/templates/sailing/opencode.json +41 -0
  396. package/templates/sailing/package.json +52 -0
  397. package/templates/sailing/playtests/fail.playtest.json +24 -0
  398. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  399. package/templates/sailing/playtests/float.playtest.json +59 -0
  400. package/templates/sailing/playtests/performance.playtest.json +36 -0
  401. package/templates/sailing/playtests/survives.playtest.json +46 -0
  402. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  403. package/templates/sailing/playtests/win.playtest.json +31 -0
  404. package/templates/sailing/public/favicon.svg +5 -0
  405. package/templates/sailing/src/conventions.ts +8 -0
  406. package/templates/sailing/src/entities/Ship.ts +233 -0
  407. package/templates/sailing/src/game.ts +40 -0
  408. package/templates/sailing/src/main.ts +15 -0
  409. package/templates/sailing/src/render/camera.ts +28 -0
  410. package/templates/sailing/src/render/lighting.ts +41 -0
  411. package/templates/sailing/src/render/loading.ts +325 -0
  412. package/templates/sailing/src/render/materials.ts +44 -0
  413. package/templates/sailing/src/render/ocean.ts +179 -0
  414. package/templates/sailing/src/render/palette.ts +17 -0
  415. package/templates/sailing/src/render/postprocessing.ts +34 -0
  416. package/templates/sailing/src/render/props.ts +602 -0
  417. package/templates/sailing/src/render/quality.ts +140 -0
  418. package/templates/sailing/src/render/sky.ts +37 -0
  419. package/templates/sailing/src/render/touch-controls.ts +142 -0
  420. package/templates/sailing/src/render/worldEnvironment.ts +758 -0
  421. package/templates/sailing/src/scenes/Boot.ts +12 -0
  422. package/templates/sailing/src/scenes/Sailing.ts +133 -0
  423. package/templates/sailing/src/state.ts +10 -0
  424. package/templates/sailing/src/style.css +81 -0
  425. package/templates/sailing/src/ui/App.tsx +15 -0
  426. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  427. package/templates/sailing/src/ui/Hud.tsx +55 -0
  428. package/templates/sailing/src/ui/Menu.tsx +30 -0
  429. package/templates/sailing/src/ui/main.tsx +7 -0
  430. package/templates/sailing/tailwind.config.ts +2 -0
  431. package/templates/sailing/threenative.config.ts +40 -0
  432. package/templates/sailing/tsconfig.json +17 -0
  433. package/templates/sailing/vite.config.ts +34 -0
  434. package/templates/shooter/.codex/config.toml +19 -0
  435. package/templates/shooter/.cursor/mcp.json +32 -0
  436. package/templates/shooter/.gemini/settings.json +32 -0
  437. package/templates/shooter/.mcp.json +18 -2
  438. package/templates/shooter/.vscode/mcp.json +36 -0
  439. package/templates/shooter/.zed/settings.json +36 -0
  440. package/templates/shooter/AGENTS.md +81 -54
  441. package/templates/shooter/CLAUDE.md +81 -54
  442. package/templates/shooter/index.html +0 -1
  443. package/templates/shooter/kit.json +2 -2
  444. package/templates/shooter/opencode.json +41 -0
  445. package/templates/shooter/package.json +16 -11
  446. package/templates/shooter/playtests/combat.playtest.json +48 -0
  447. package/templates/shooter/playtests/fail.playtest.json +5 -4
  448. package/templates/shooter/playtests/input-control.playtest.json +261 -0
  449. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  450. package/templates/shooter/playtests/performance.playtest.json +39 -0
  451. package/templates/shooter/playtests/shooter.playtest.json +31 -21
  452. package/templates/shooter/playtests/survives.playtest.json +28 -1
  453. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  454. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  455. package/templates/shooter/public/favicon.svg +1 -1
  456. package/templates/shooter/src/combat/damage.ts +1 -2
  457. package/templates/shooter/src/conventions.ts +51 -0
  458. package/templates/shooter/src/entities/Player.ts +235 -18
  459. package/templates/shooter/src/entities/Target.ts +2 -2
  460. package/templates/shooter/src/game.ts +35 -3
  461. package/templates/shooter/src/main.ts +3 -13
  462. package/templates/shooter/src/render/camera.ts +78 -18
  463. package/templates/shooter/src/render/decals.ts +211 -0
  464. package/templates/shooter/src/render/lighting.ts +13 -4
  465. package/templates/shooter/src/render/loading.ts +274 -35
  466. package/templates/shooter/src/render/materials.ts +56 -3
  467. package/templates/shooter/src/render/palette.ts +6 -3
  468. package/templates/shooter/src/render/postprocessing.ts +32 -17
  469. package/templates/shooter/src/render/quality.ts +170 -0
  470. package/templates/shooter/src/render/scale.ts +22 -0
  471. package/templates/shooter/src/render/shapes.ts +519 -60
  472. package/templates/shooter/src/render/sky.ts +5 -1
  473. package/templates/shooter/src/render/touch-controls.ts +305 -0
  474. package/templates/shooter/src/render/ui.css +119 -1
  475. package/templates/shooter/src/render/ui.ts +19 -3
  476. package/templates/shooter/src/render/vfx.ts +215 -0
  477. package/templates/shooter/src/render/worldEnvironment.ts +758 -0
  478. package/templates/shooter/src/scenes/Play.ts +385 -97
  479. package/templates/shooter/src/state.ts +18 -0
  480. package/templates/shooter/src/style.css +46 -0
  481. package/templates/shooter/src/ui/App.tsx +10 -12
  482. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  483. package/templates/shooter/src/ui/GameUi.tsx +22 -0
  484. package/templates/shooter/src/ui/Hud.tsx +14 -10
  485. package/templates/shooter/src/ui/Menu.tsx +24 -9
  486. package/templates/shooter/src/ui/main.tsx +15 -0
  487. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  488. package/templates/shooter/src/weapons/Projectile.ts +29 -13
  489. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  490. package/templates/shooter/threenative.config.ts +28 -8
  491. package/templates/shooter/vite.config.ts +32 -2
  492. package/templates/starter/.codex/config.toml +19 -0
  493. package/templates/starter/.cursor/mcp.json +32 -0
  494. package/templates/starter/.gemini/settings.json +32 -0
  495. package/templates/starter/.mcp.json +18 -2
  496. package/templates/starter/.vscode/mcp.json +36 -0
  497. package/templates/starter/.zed/settings.json +36 -0
  498. package/templates/starter/AGENTS.md +72 -426
  499. package/templates/starter/CLAUDE.md +72 -426
  500. package/templates/starter/assets/pickup.wav +0 -0
  501. package/templates/starter/gitignore +4 -0
  502. package/templates/starter/index.html +0 -1
  503. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  504. package/templates/starter/native-playtests/render-chain.playtest.json +81 -0
  505. package/templates/starter/opencode.json +41 -0
  506. package/templates/starter/package.json +16 -12
  507. package/templates/starter/playtests/assets.playtest.json +65 -0
  508. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  509. package/templates/starter/playtests/buffer.playtest.json +59 -9
  510. package/templates/starter/playtests/cloth.playtest.json +113 -0
  511. package/templates/starter/playtests/coyote.playtest.json +60 -8
  512. package/templates/starter/playtests/forward.playtest.json +29 -4
  513. package/templates/starter/playtests/gameover.playtest.json +66 -0
  514. package/templates/starter/playtests/goal.playtest.json +67 -0
  515. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  516. package/templates/starter/playtests/look.playtest.json +142 -10
  517. package/templates/starter/playtests/models-baseline.png +0 -0
  518. package/templates/starter/playtests/models.playtest.json +74 -0
  519. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  520. package/templates/starter/playtests/odometer.playtest.json +54 -0
  521. package/templates/starter/playtests/pause.playtest.json +27 -4
  522. package/templates/starter/playtests/play.playtest.json +44 -7
  523. package/templates/starter/playtests/respawn.playtest.json +46 -6
  524. package/templates/starter/playtests/restart.playtest.json +65 -10
  525. package/templates/starter/playtests/seed.playtest.json +44 -8
  526. package/templates/starter/playtests/survives.playtest.json +48 -4
  527. package/templates/starter/playtests/textures-baseline.png +0 -0
  528. package/templates/starter/playtests/textures.playtest.json +74 -0
  529. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  530. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  531. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  532. package/templates/starter/src/conventions.ts +18 -0
  533. package/templates/starter/src/entities/Goal.ts +137 -0
  534. package/templates/starter/src/entities/Player.ts +111 -10
  535. package/templates/starter/src/game.ts +27 -0
  536. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  537. package/templates/starter/src/render/camera.ts +31 -5
  538. package/templates/starter/src/render/coast.ts +199 -0
  539. package/templates/starter/src/render/easing.ts +5 -0
  540. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  541. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  542. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  543. package/templates/starter/src/render/hero.ts +88 -0
  544. package/templates/starter/src/render/implicitSurface.ts +199 -0
  545. package/templates/starter/src/render/kuwahara.ts +174 -0
  546. package/templates/starter/src/render/lighting.ts +10 -5
  547. package/templates/starter/src/render/loading.ts +325 -0
  548. package/templates/starter/src/render/materials.ts +39 -4
  549. package/templates/starter/src/render/outline.ts +141 -0
  550. package/templates/starter/src/render/painterly.ts +86 -0
  551. package/templates/starter/src/render/palette.ts +15 -6
  552. package/templates/starter/src/render/pennant.ts +54 -0
  553. package/templates/starter/src/render/postprocessing.ts +97 -15
  554. package/templates/starter/src/render/quality.ts +185 -0
  555. package/templates/starter/src/render/rockRidge.ts +198 -0
  556. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  557. package/templates/starter/src/render/scenery.ts +40 -0
  558. package/templates/starter/src/render/shapes.ts +9 -21
  559. package/templates/starter/src/render/textureLifetime.ts +53 -0
  560. package/templates/starter/src/render/touch-controls.ts +165 -0
  561. package/templates/starter/src/render/water.ts +38 -0
  562. package/templates/starter/src/render/watercolor.ts +85 -0
  563. package/templates/starter/src/render/worldEnvironment.ts +758 -0
  564. package/templates/starter/src/scenes/Play.ts +243 -46
  565. package/templates/starter/src/state.ts +12 -0
  566. package/templates/starter/src/style.css +72 -8
  567. package/templates/starter/src/ui/App.tsx +9 -6
  568. package/templates/starter/src/ui/GameUi.tsx +20 -0
  569. package/templates/starter/src/ui/Hud.tsx +52 -29
  570. package/templates/starter/src/ui/Menu.tsx +25 -23
  571. package/templates/starter/src/ui/main.tsx +14 -0
  572. package/templates/starter/threenative.config.ts +27 -9
  573. package/templates/starter/tools/look.mjs +109 -0
  574. package/templates/starter/vite.config.ts +32 -2
  575. package/templates/action-rpg/src/physics.ts +0 -40
  576. package/templates/minimal/assets/.gitkeep +0 -0
  577. package/templates/minimal/public/.gitkeep +0 -0
  578. package/templates/minimal/public/icon.png +0 -0
  579. package/templates/platformer/assets/.gitkeep +0 -0
  580. package/templates/platformer/public/.gitkeep +0 -0
  581. package/templates/platformer/public/icon.png +0 -0
  582. package/templates/shooter/src/physics.ts +0 -49
  583. package/templates/starter/assets/.gitkeep +0 -0
  584. package/templates/starter/public/.gitkeep +0 -0
  585. package/templates/starter/public/icon.png +0 -0
  586. package/templates/starter/public/pickup.ogg +0 -0
  587. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  588. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -1,20 +1,182 @@
1
1
  // Generated for you. All arena silhouettes and gameplay visuals start here.
2
2
  import {
3
+ BoxGeometry,
3
4
  BufferAttribute,
4
5
  BufferGeometry,
6
+ ClampToEdgeWrapping,
5
7
  CylinderGeometry,
8
+ DataTexture,
9
+ DoubleSide,
6
10
  Group,
7
11
  type Material,
8
12
  Mesh,
13
+ MeshBasicMaterial,
14
+ NearestFilter,
15
+ PlaneGeometry,
16
+ RGBAFormat,
9
17
  SphereGeometry,
18
+ UnsignedByteType,
10
19
  } from "three";
11
20
 
21
+ import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
12
22
  import type { ReturnTypeOfMaterials } from "./types.js";
13
23
 
14
24
  const roundedCache = new Map<string, BufferGeometry>();
15
25
 
16
26
  export type ShooterMaterials = ReturnTypeOfMaterials;
17
27
 
28
+ export const PICKUP_SPRITE_FRAMES = [
29
+ { x: 0, y: 0, width: 8, height: 8, duration: 0.07 },
30
+ { x: 8, y: 0, width: 12, height: 10, duration: 0.11 },
31
+ { x: 20, y: 2, width: 12, height: 8, duration: 0.15 },
32
+ ] as const;
33
+
34
+ const PICKUP_ATLAS_WIDTH = 32;
35
+ const PICKUP_ATLAS_HEIGHT = 16;
36
+
37
+ function setPixel(
38
+ data: Uint8Array,
39
+ width: number,
40
+ height: number,
41
+ x: number,
42
+ y: number,
43
+ colour: readonly [number, number, number, number],
44
+ ): void {
45
+ if (x < 0 || y < 0 || x >= width || y >= height) return;
46
+ const row = height - 1 - y;
47
+ const index = (row * width + x) * 4;
48
+ data[index] = colour[0];
49
+ data[index + 1] = colour[1];
50
+ data[index + 2] = colour[2];
51
+ data[index + 3] = colour[3];
52
+ }
53
+
54
+ function createPickupAtlas(): DataTexture {
55
+ const data = new Uint8Array(PICKUP_ATLAS_WIDTH * PICKUP_ATLAS_HEIGHT * 4);
56
+ for (let y = 0; y < PICKUP_ATLAS_HEIGHT; y += 1) {
57
+ for (let x = 0; x < PICKUP_ATLAS_WIDTH; x += 1) {
58
+ const frame = PICKUP_SPRITE_FRAMES.find(
59
+ ({ x: left, y: top, width, height }) =>
60
+ x >= left && x < left + width && y >= top && y < top + height,
61
+ );
62
+ if (frame === undefined) continue;
63
+ const localX = x - frame.x - (frame.width - 1) / 2;
64
+ const localY = y - frame.y - (frame.height - 1) / 2;
65
+ const radius = Math.min(frame.width, frame.height) * 0.42;
66
+ if (Math.hypot(localX, localY) > radius) continue;
67
+ const colour: readonly [number, number, number, number] = [
68
+ 100 + Math.round((frame.width / 12) * 100),
69
+ 225,
70
+ 255,
71
+ 255,
72
+ ];
73
+ setPixel(data, PICKUP_ATLAS_WIDTH, PICKUP_ATLAS_HEIGHT, x, y, colour);
74
+ }
75
+ }
76
+ const texture = new DataTexture(
77
+ data,
78
+ PICKUP_ATLAS_WIDTH,
79
+ PICKUP_ATLAS_HEIGHT,
80
+ RGBAFormat,
81
+ UnsignedByteType,
82
+ );
83
+ texture.magFilter = NearestFilter;
84
+ texture.minFilter = NearestFilter;
85
+ texture.wrapS = ClampToEdgeWrapping;
86
+ texture.wrapT = ClampToEdgeWrapping;
87
+ texture.needsUpdate = true;
88
+ return texture;
89
+ }
90
+
91
+ const NAMEPLATE_GLYPHS: Readonly<Record<string, readonly string[]>> = {
92
+ A: ["01110", "10001", "10001", "11111", "10001", "10001", "10001"],
93
+ E: ["11111", "10000", "10000", "11110", "10000", "10000", "11111"],
94
+ G: ["01110", "10001", "10000", "10111", "10001", "10001", "01110"],
95
+ R: ["11110", "10001", "10001", "11110", "10100", "10010", "10001"],
96
+ T: ["11111", "00100", "00100", "00100", "00100", "00100", "00100"],
97
+ };
98
+
99
+ const NAMEPLATE_WIDTH = 48;
100
+ const NAMEPLATE_HEIGHT = 12;
101
+ const NAMEPLATE_BACKGROUND: readonly [number, number, number, number] = [7, 18, 27, 240];
102
+ const NAMEPLATE_INK: readonly [number, number, number, number] = [138, 239, 255, 255];
103
+ const NAMEPLATE_BORDER: readonly [number, number, number, number] = [53, 128, 154, 255];
104
+
105
+ function fillNameplate(data: Uint8Array): void {
106
+ for (let y = 0; y < NAMEPLATE_HEIGHT; y += 1) {
107
+ for (let x = 0; x < NAMEPLATE_WIDTH; x += 1)
108
+ setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, x, y, NAMEPLATE_BACKGROUND);
109
+ }
110
+ }
111
+
112
+ function drawNameplateBorder(data: Uint8Array): void {
113
+ for (let x = 0; x < NAMEPLATE_WIDTH; x += 1) {
114
+ setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, x, 0, NAMEPLATE_BORDER);
115
+ setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, x, NAMEPLATE_HEIGHT - 1, NAMEPLATE_BORDER);
116
+ }
117
+ for (let y = 0; y < NAMEPLATE_HEIGHT; y += 1) {
118
+ setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, 0, y, NAMEPLATE_BORDER);
119
+ setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, NAMEPLATE_WIDTH - 1, y, NAMEPLATE_BORDER);
120
+ }
121
+ }
122
+
123
+ function drawNameplateText(data: Uint8Array): void {
124
+ for (const [index, character] of [..."TARGET"].entries()) {
125
+ const glyph = NAMEPLATE_GLYPHS[character];
126
+ if (glyph === undefined) continue;
127
+ for (const [row, line] of glyph.entries()) {
128
+ for (const [column, lit] of [...line].entries()) {
129
+ if (lit === "1")
130
+ setPixel(
131
+ data,
132
+ NAMEPLATE_WIDTH,
133
+ NAMEPLATE_HEIGHT,
134
+ 6 + index * 7 + column,
135
+ 2 + row,
136
+ NAMEPLATE_INK,
137
+ );
138
+ }
139
+ }
140
+ }
141
+ }
142
+
143
+ function createNameplateTexture(): DataTexture {
144
+ const data = new Uint8Array(NAMEPLATE_WIDTH * NAMEPLATE_HEIGHT * 4);
145
+ fillNameplate(data);
146
+ drawNameplateBorder(data);
147
+ drawNameplateText(data);
148
+ const texture = new DataTexture(
149
+ data,
150
+ NAMEPLATE_WIDTH,
151
+ NAMEPLATE_HEIGHT,
152
+ RGBAFormat,
153
+ UnsignedByteType,
154
+ );
155
+ texture.magFilter = NearestFilter;
156
+ texture.minFilter = NearestFilter;
157
+ texture.wrapS = ClampToEdgeWrapping;
158
+ texture.wrapT = ClampToEdgeWrapping;
159
+ texture.needsUpdate = true;
160
+ return texture;
161
+ }
162
+
163
+ function createTargetNameplate(): Group {
164
+ const group = new Group();
165
+ group.name = "target-nameplate";
166
+ const mesh = new Mesh(
167
+ new PlaneGeometry(1.05, 0.26),
168
+ new MeshBasicMaterial({
169
+ depthWrite: false,
170
+ map: createNameplateTexture(),
171
+ side: DoubleSide,
172
+ transparent: true,
173
+ }),
174
+ );
175
+ mesh.name = "target-nameplate-surface";
176
+ group.add(mesh);
177
+ return group;
178
+ }
179
+
18
180
  function compactBox(width: number, height: number, depth: number): BufferGeometry {
19
181
  const halfX = width / 2;
20
182
  const halfY = height / 2;
@@ -65,21 +227,67 @@ function compactBox(width: number, height: number, depth: number): BufferGeometr
65
227
  return geometry;
66
228
  }
67
229
 
68
- function roundedBox(
69
- width: number,
70
- height: number,
71
- depth: number,
72
- radius = 0.12,
73
- segments = 1,
74
- ): BufferGeometry {
75
- const key = `${width},${height},${depth},${radius},${segments}`;
230
+ /**
231
+ * A box with **face** normals, cached by size.
232
+ *
233
+ * `compactBox` above shares eight vertices between all six faces and derives each normal by
234
+ * normalising the vertex position. That is fine for something roughly cubic, and wrong for
235
+ * anything long and thin: for the arena's 22 x 4.2 x 0.4 back wall every normal comes out pointing
236
+ * along +/-X, so the inner face is shaded as though it faced sideways and an overhead key misses
237
+ * it completely. The wall rendered as a black band straight across the middle of the frame at
238
+ * exactly the height the targets stand — and no palette or light change could lift it, because the
239
+ * surface was not facing the light.
240
+ *
241
+ * A `BoxGeometry` has twenty-four vertices and the **same twelve triangles**, so this costs
242
+ * nothing against the triangle budget. `compactBox` stays for the flat trim strips and decals,
243
+ * where the geometry really is a thin quad and the shading does not matter.
244
+ */
245
+ function roundedBox(width: number, height: number, depth: number): BufferGeometry {
246
+ const key = `${width},${height},${depth}`;
76
247
  const cached = roundedCache.get(key);
77
248
  if (cached !== undefined) return cached;
78
- const geometry = compactBox(width, height, depth);
249
+ const geometry = new BoxGeometry(width, height, depth);
79
250
  roundedCache.set(key, geometry);
80
251
  return geometry;
81
252
  }
82
253
 
254
+ /**
255
+ * Bake a group of rigid meshes down to one mesh per material.
256
+ *
257
+ * The arena's floor panels, its skirting and each drone are all static relative to their parent,
258
+ * and authored one mesh at a time they cost one draw each. With five hostiles on the field that
259
+ * put `production-performance` at five hundred draws. Merging keeps every material separate and
260
+ * separately editable and costs no triangles at all.
261
+ */
262
+ function bakeByMaterial(parts: readonly Mesh[], root: Group): void {
263
+ const byMaterial = new Map<Material, Mesh[]>();
264
+ for (const mesh of parts) {
265
+ const bucket = byMaterial.get(mesh.material as Material);
266
+ if (bucket === undefined) byMaterial.set(mesh.material as Material, [mesh]);
267
+ else bucket.push(mesh);
268
+ }
269
+ for (const [material, meshes] of byMaterial) {
270
+ const geometry = mergeGeometries(
271
+ meshes.map((mesh) => {
272
+ mesh.updateMatrix();
273
+ const placed = mesh.geometry.clone().applyMatrix4(mesh.matrix);
274
+ const cloned = placed.index === null ? placed : placed.toNonIndexed();
275
+ for (const name of Object.keys(cloned.attributes)) {
276
+ if (name !== "position") cloned.deleteAttribute(name);
277
+ }
278
+ return cloned;
279
+ }),
280
+ false,
281
+ );
282
+ if (geometry === null) throw new Error("mergeGeometries returned null baking a visual.");
283
+ geometry.computeVertexNormals();
284
+ const merged = new Mesh(geometry, material);
285
+ merged.castShadow = meshes[0]?.castShadow ?? true;
286
+ merged.receiveShadow = true;
287
+ root.add(merged);
288
+ }
289
+ }
290
+
83
291
  function shadowed(mesh: Mesh, cast = true): Mesh {
84
292
  mesh.castShadow = cast;
85
293
  mesh.receiveShadow = true;
@@ -93,83 +301,322 @@ function block(width: number, height: number, depth: number, material: Material)
93
301
  export function createArena(materials: ShooterMaterials) {
94
302
  const group = new Group();
95
303
  group.name = "arena";
96
- const floor = block(22, 0.4, 20, materials.arena);
304
+ // Everything static and non-interactive: floor panels, skirting, boundary lines, cover lips.
305
+ // Baked into one mesh per material at the end of this function.
306
+ const decoration: Mesh[] = [];
307
+ const floor = block(22, 0.4, 24, materials.arena);
97
308
  floor.name = "arena-floor";
98
- floor.position.set(0, -0.2, -2);
309
+ floor.position.set(0, -0.2, -1);
99
310
  group.add(floor);
311
+ // Four walls, not three. In first person the player turns around, and an arena open at the back
312
+ // shows the void the third-person camera never pointed at.
100
313
  const walls = [
101
- { depth: 20, position: [-11, 1.7, -2] as const, width: 0.4 },
102
- { depth: 20, position: [11, 1.7, -2] as const, width: 0.4 },
103
- { depth: 0.4, position: [0, 1.7, -12] as const, width: 22 },
314
+ { depth: 24, position: [-11, 1.9, -1] as const, width: 0.4 },
315
+ { depth: 24, position: [11, 1.9, -1] as const, width: 0.4 },
316
+ { depth: 0.4, position: [0, 1.9, -13] as const, width: 22 },
317
+ { depth: 0.4, position: [0, 1.9, 11] as const, width: 22 },
104
318
  ].map(({ depth, position, width }, index) => {
105
- const wall = block(width, 3.8, depth, materials.shadow);
319
+ const wall = block(width, 4.2, depth, materials.shadow);
106
320
  wall.name = `arena-wall-${index}`;
107
321
  wall.position.set(position[0], position[1], position[2]);
108
322
  group.add(wall);
323
+ // A lit skirting strip where the wall meets the deck. Without one the join is the darkest
324
+ // value in the arena and reads as a black band cut across the middle of the frame, which is
325
+ // exactly where the targets stand.
326
+ const skirting = new Mesh(
327
+ compactBox(width < 1 ? width + 0.12 : width, 0.14, depth < 1 ? depth + 0.12 : depth),
328
+ materials.trim,
329
+ );
330
+ skirting.position.set(position[0], 0.12, position[2]);
331
+ skirting.castShadow = false;
332
+ decoration.push(skirting);
109
333
  return wall;
110
334
  });
111
- for (let x = -9; x <= 9; x += 3) {
112
- const strip = new Mesh(compactBox(0.035, 0.012, 19), materials.trim);
113
- strip.position.set(x, 0.012, -2);
114
- strip.castShadow = false;
115
- strip.receiveShadow = false;
116
- group.add(strip);
335
+ // Cover. An arena with a flat floor is a shooting gallery: these are what turns "walk forward
336
+ // and hold fire" into peeking, and they are what the crouch is for.
337
+ const cover = [
338
+ { height: 1.15, position: [-4.6, 0, -3.2] as const, size: [2.4, 1.2] as const },
339
+ { height: 1.15, position: [4.6, 0, -3.2] as const, size: [2.4, 1.2] as const },
340
+ { height: 0.95, position: [0, 0, -7.4] as const, size: [3.6, 1.1] as const },
341
+ { height: 2.6, position: [-7.4, 0, -8.6] as const, size: [1.5, 1.5] as const },
342
+ { height: 2.6, position: [7.4, 0, -8.6] as const, size: [1.5, 1.5] as const },
343
+ { height: 0.9, position: [-2.4, 0, 2.4] as const, size: [1.4, 1.4] as const },
344
+ { height: 0.9, position: [2.4, 0, 2.4] as const, size: [1.4, 1.4] as const },
345
+ ].map(({ height, position, size }, index) => {
346
+ const crate = block(size[0], height, size[1], materials.cover);
347
+ crate.name = `arena-wall-cover-${index}`;
348
+ crate.position.set(position[0], height / 2, position[2]);
349
+ group.add(crate);
350
+ // A lit lip along the top edge, so cover reads as cover at a glance in a dim arena.
351
+ const lip = new Mesh(compactBox(size[0] + 0.06, 0.05, size[1] + 0.06), materials.edge);
352
+ lip.position.set(position[0], height + 0.02, position[2]);
353
+ lip.castShadow = false;
354
+ lip.receiveShadow = false;
355
+ decoration.push(lip);
356
+ return crate;
357
+ });
358
+ // Floor panels, then a boundary line. A full accent grid every three metres across the whole
359
+ // floor is what shipped, and it photographed as a debug overlay switched on by mistake: bright
360
+ // yellow rules over everything, drawing the eye away from the targets standing on them.
361
+ for (let x = -8; x <= 8; x += 5.4) {
362
+ for (let z = -11; z <= 9; z += 5) {
363
+ const panel = new Mesh(compactBox(4.9, 0.02, 4.5), materials.floorPanel);
364
+ panel.position.set(x, 0.011, z);
365
+ panel.castShadow = false;
366
+ panel.receiveShadow = true;
367
+ decoration.push(panel);
368
+ }
117
369
  }
118
- for (let z = -11; z <= 7; z += 3) {
119
- const strip = new Mesh(compactBox(21, 0.012, 0.035), materials.trim);
120
- strip.position.set(0, 0.014, z);
121
- strip.castShadow = false;
122
- strip.receiveShadow = false;
123
- group.add(strip);
370
+ for (const [width, depth, z] of [
371
+ [21.4, 0.06, -12.6],
372
+ [21.4, 0.06, 10.6],
373
+ ] as const) {
374
+ const line = new Mesh(compactBox(width, 0.014, depth), materials.trim);
375
+ line.position.set(0, 0.02, z);
376
+ line.castShadow = false;
377
+ decoration.push(line);
124
378
  }
125
- return { floor, group, walls };
379
+ for (const side of [-1, 1]) {
380
+ const line = new Mesh(compactBox(0.06, 0.014, 23.2), materials.trim);
381
+ line.position.set(side * 10.6, 0.02, -1);
382
+ line.castShadow = false;
383
+ decoration.push(line);
384
+ }
385
+ bakeByMaterial(decoration, group);
386
+ return { cover, floor, group, walls };
126
387
  }
127
388
 
128
- export function createPlayerVisual(materials: ShooterMaterials): Group {
389
+ /**
390
+ * The carbine and the hands that hold it, authored pointing -z.
391
+ *
392
+ * Deliberately built from primitives rather than loaded from a `.glb`: a kit that ships a
393
+ * 12 MB weapon model teaches an agent to reach for one, and this reads as a weapon at a
394
+ * fraction of the download. Swap it for a real model by loading a `.glb` in `Scene.load()` and
395
+ * handing it to `preparePlayerConventions` instead — `normaliseToMetres` sizes either one.
396
+ *
397
+ * It is authored at roughly 0.55 m so `normaliseToMetres` has real work to do: the size that
398
+ * ships is the one in `render/scale.ts`, never the one that happened to be convenient here.
399
+ */
400
+ export function createViewmodelVisual(materials: ShooterMaterials): Group {
129
401
  const group = new Group();
130
- group.name = "player-visual";
131
- const body = block(0.76, 1.35, 0.76, materials.player);
132
- body.position.y = 0.62;
133
- group.add(body);
134
- const visor = new Mesh(compactBox(0.56, 0.22, 0.08), materials.trim);
135
- visor.position.set(0, 0.88, -0.4);
136
- visor.castShadow = true;
137
- group.add(visor);
138
- const muzzle = new Mesh(
139
- new CylinderGeometry(0.08, 0.1, 0.5, 6).rotateX(Math.PI / 2),
140
- materials.shadow,
402
+ group.name = "viewmodel";
403
+
404
+ const rifle = new Group();
405
+ rifle.name = "held-rifle";
406
+
407
+ const part = (
408
+ geometry: BufferGeometry,
409
+ material: Material,
410
+ x: number,
411
+ y: number,
412
+ z: number,
413
+ ): Mesh => {
414
+ const mesh = new Mesh(geometry, material);
415
+ mesh.position.set(x, y, z);
416
+ // The viewmodel is drawn over the arena and never casts into it: a weapon held at the eye
417
+ // throws a shadow the size of the room.
418
+ mesh.castShadow = false;
419
+ mesh.receiveShadow = false;
420
+ mesh.frustumCulled = false;
421
+ rifle.add(mesh);
422
+ return mesh;
423
+ };
424
+
425
+ part(compactBox(0.062, 0.072, 0.24), materials.gunmetal, 0, 0, -0.02);
426
+ part(compactBox(0.05, 0.052, 0.15), materials.polymer, 0, -0.002, -0.2);
427
+ part(
428
+ new CylinderGeometry(0.011, 0.011, 0.2, 6).rotateX(Math.PI / 2),
429
+ materials.gunmetal,
430
+ 0,
431
+ 0.012,
432
+ -0.31,
433
+ );
434
+ part(
435
+ new CylinderGeometry(0.021, 0.019, 0.07, 6).rotateX(Math.PI / 2),
436
+ materials.gunmetal,
437
+ 0,
438
+ 0.012,
439
+ -0.43,
141
440
  );
142
- muzzle.position.set(0, 0.52, -0.55);
143
- muzzle.castShadow = true;
144
- group.add(muzzle);
441
+ // Magazine and pistol grip, both raked back the way a real one sits in the hand.
442
+ const magazine = part(compactBox(0.04, 0.13, 0.062), materials.polymer, 0, -0.09, -0.04);
443
+ magazine.rotation.x = -0.16;
444
+ const grip = part(compactBox(0.038, 0.1, 0.05), materials.polymer, 0, -0.075, 0.07);
445
+ grip.rotation.x = 0.3;
446
+ part(compactBox(0.055, 0.062, 0.13), materials.polymer, 0, -0.006, 0.13);
447
+ // The optic. `preparePlayerConventions` does not look for it by name, but a rigged replacement
448
+ // usually ships one called this, and the aiming pose is authored against its position.
449
+ const optic = part(compactBox(0.036, 0.038, 0.07), materials.gunmetal, 0, 0.057, -0.01);
450
+ optic.name = "optic";
451
+ part(compactBox(0.008, 0.008, 0.008), materials.sight, 0, 0.058, -0.045);
452
+ part(compactBox(0.044, 0.012, 0.09), materials.gunmetal, 0, 0.04, -0.02);
453
+
454
+ group.add(rifle);
455
+
456
+ // Two gloved forearms. They live outside `held-rifle` so `normaliseToMetres` measures the
457
+ // weapon and not the person carrying it.
458
+ const arms = new Group();
459
+ arms.name = "viewmodel-arms";
460
+ const forearm = (x: number, y: number, z: number, pitch: number, yaw: number): void => {
461
+ const mesh = new Mesh(compactBox(0.048, 0.046, 0.3), materials.glove);
462
+ mesh.position.set(x, y, z);
463
+ mesh.rotation.set(pitch, yaw, 0);
464
+ mesh.castShadow = false;
465
+ mesh.receiveShadow = false;
466
+ mesh.frustumCulled = false;
467
+ arms.add(mesh);
468
+ };
469
+ forearm(0.075, -0.15, 0.02, 0.5, -0.26);
470
+ forearm(-0.055, -0.12, -0.2, 0.36, 0.32);
471
+ group.add(arms);
145
472
  return group;
146
473
  }
147
474
 
475
+ /**
476
+ * What the player sees when they look down: hips, thighs, shins, boots.
477
+ *
478
+ * Nothing above the waist, because a chest at eye height fills the frame and clips through the
479
+ * near plane. `GroundSnap` measures this group, so the boots are what meets the floor.
480
+ */
481
+ export function createLegsVisual(materials: ShooterMaterials): Group {
482
+ const group = new Group();
483
+ group.name = "player-legs";
484
+ const leg = (side: number): void => {
485
+ const thigh = block(0.19, 0.44, 0.21, materials.player);
486
+ thigh.position.set(side * 0.13, -0.24, 0);
487
+ group.add(thigh);
488
+ const shin = block(0.15, 0.4, 0.17, materials.shadow);
489
+ shin.position.set(side * 0.13, -0.64, 0.01);
490
+ group.add(shin);
491
+ const boot = block(0.17, 0.11, 0.3, materials.trim);
492
+ boot.position.set(side * 0.13, -0.855, -0.04);
493
+ group.add(boot);
494
+ };
495
+ leg(-1);
496
+ leg(1);
497
+ const hips = block(0.42, 0.2, 0.24, materials.player);
498
+ hips.position.y = -0.02;
499
+ group.add(hips);
500
+ return group;
501
+ }
502
+
503
+ /**
504
+ * The hostile: a hovering combat drone.
505
+ *
506
+ * What shipped here was a 1.2 x 1.8 box in hostile pink with two thin bars crossed over it, and
507
+ * the first frame read exactly like that — a sheet of pink card with a plus drawn on it, in
508
+ * triplicate. A drone made of nine boxes is barely more geometry (this template's `compactBox` is
509
+ * twelve triangles) and it has a front, a top and a silhouette, which is what tells the player
510
+ * which way a thing is facing and whether they have hit it.
511
+ *
512
+ * The collision box in `Target.ts` is unchanged at 1.2 x 1.8 x 1: this fills that volume rather
513
+ * than redefining it.
514
+ */
148
515
  export function createTargetVisual(materials: ShooterMaterials): Group {
149
516
  const group = new Group();
150
517
  group.name = "target-visual";
151
- const body = block(1.2, 1.8, 1, materials.hostile);
152
- body.position.y = 0.9;
153
- group.add(body);
154
- const ring = new Mesh(compactBox(1.4, 0.08, 0.08), materials.trim);
155
- ring.position.y = 0.9;
156
- ring.castShadow = true;
157
- group.add(ring);
158
- const crossbar = new Mesh(compactBox(0.08, 0.08, 1.4), materials.trim);
159
- crossbar.position.y = 0.9;
160
- crossbar.castShadow = true;
161
- group.add(crossbar);
518
+ // Keep a non-zero parent rotation in the stock scene so the nameplate demonstrates world-space
519
+ // billboarding instead of accidentally passing only in the unparented case.
520
+ group.rotation.y = 0.22;
521
+ const parts: Mesh[] = [];
522
+
523
+ // Core: a chest that tapers to a narrower waist, so the thing has a top and a bottom.
524
+ const chest = block(0.94, 0.72, 0.62, materials.hostile);
525
+ chest.position.y = 1.24;
526
+ parts.push(chest);
527
+ const waist = block(0.6, 0.44, 0.46, materials.shadow);
528
+ waist.position.y = 0.78;
529
+ parts.push(waist);
530
+ const skirt = block(0.78, 0.26, 0.56, materials.hostile);
531
+ skirt.position.y = 0.5;
532
+ parts.push(skirt);
533
+
534
+ // Head and the single lit eye: the read that says which way it is looking.
535
+ const head = block(0.4, 0.3, 0.34, materials.shadow);
536
+ head.position.y = 1.72;
537
+ parts.push(head);
538
+ const eye = new Mesh(compactBox(0.26, 0.09, 0.06), materials.sight);
539
+ eye.position.set(0, 1.74, -0.2);
540
+ eye.castShadow = false;
541
+ parts.push(eye);
542
+
543
+ // Shoulder pods, canted outward. Most of the silhouette at range comes from these.
544
+ for (const side of [-1, 1]) {
545
+ const pod = block(0.28, 0.34, 0.46, materials.shadow);
546
+ pod.position.set(side * 0.62, 1.32, 0);
547
+ pod.rotation.z = side * -0.22;
548
+ parts.push(pod);
549
+ const muzzle = new Mesh(compactBox(0.1, 0.1, 0.34), materials.trim);
550
+ muzzle.position.set(side * 0.66, 1.28, -0.34);
551
+ muzzle.castShadow = false;
552
+ parts.push(muzzle);
553
+ // Trailing legs. A hovering thing with nothing below it reads as a floating box.
554
+ const leg = block(0.1, 0.5, 0.12, materials.shadow);
555
+ leg.position.set(side * 0.24, 0.2, 0.06);
556
+ leg.rotation.x = -0.24;
557
+ parts.push(leg);
558
+ }
559
+
560
+ // A lit band around the chest, so a hit registers against something bright.
561
+ const band = new Mesh(compactBox(0.98, 0.07, 0.66), materials.trim);
562
+ band.position.y = 1.44;
563
+ band.castShadow = false;
564
+ parts.push(band);
565
+
566
+ bakeByMaterial(parts, group);
567
+ const nameplate = createTargetNameplate();
568
+ nameplate.position.y = 2.2;
569
+ group.add(nameplate);
162
570
  return group;
163
571
  }
164
572
 
573
+ /**
574
+ * The friendly: a hovering escort drone.
575
+ *
576
+ * `Play.ts` places this at y = 1 — it is a *drone*, and it hovers. Authored as an upright figure
577
+ * it read as a teal fencepost standing in mid-air right down the player's sightline, which is the
578
+ * worst possible shape for the one object in the arena they must not shoot. Wider than it is tall,
579
+ * with a lit ring, it reads as friendly kit at a glance.
580
+ *
581
+ * It stays narrow across the beam: it has to stand in the player's line of fire for the
582
+ * friendly-layer proof to mean anything, and at 0.9 m across that put a cyan wall two metres in
583
+ * front of the eye.
584
+ */
165
585
  export function createFriendlyVisual(materials: ShooterMaterials): Group {
166
586
  const group = new Group();
167
- const body = block(0.9, 1.4, 0.9, materials.player);
168
- body.position.y = 0.7;
169
- group.add(body);
170
- const antenna = new Mesh(new CylinderGeometry(0.04, 0.04, 0.5, 8), materials.trim);
171
- antenna.position.y = 1.65;
172
- group.add(antenna);
587
+ const parts: Mesh[] = [];
588
+ const hull = block(0.42, 0.24, 0.36, materials.player);
589
+ parts.push(hull);
590
+ const belly = block(0.26, 0.16, 0.22, materials.shadow);
591
+ belly.position.y = -0.18;
592
+ parts.push(belly);
593
+ const visor = new Mesh(compactBox(0.3, 0.08, 0.05), materials.trim);
594
+ visor.position.set(0, 0.02, -0.2);
595
+ visor.castShadow = false;
596
+ parts.push(visor);
597
+ // Four rotor arms and a lit ring, so it reads as a drone and not as a floating brick.
598
+ for (const [x, z] of [
599
+ [-1, -1],
600
+ [1, -1],
601
+ [-1, 1],
602
+ [1, 1],
603
+ ] as const) {
604
+ const arm = block(0.2, 0.05, 0.2, materials.shadow);
605
+ arm.position.set(x * 0.26, 0.06, z * 0.24);
606
+ parts.push(arm);
607
+ const rotor = new Mesh(compactBox(0.3, 0.02, 0.3), materials.player);
608
+ rotor.position.set(x * 0.34, 0.12, z * 0.3);
609
+ rotor.castShadow = false;
610
+ parts.push(rotor);
611
+ }
612
+ const ring = new Mesh(compactBox(0.56, 0.03, 0.5), materials.trim);
613
+ ring.position.y = -0.12;
614
+ ring.castShadow = false;
615
+ parts.push(ring);
616
+ const beacon = new Mesh(new CylinderGeometry(0.02, 0.02, 0.22, 5), materials.trim);
617
+ beacon.position.y = 0.22;
618
+ parts.push(beacon);
619
+ bakeByMaterial(parts, group);
173
620
  return group;
174
621
  }
175
622
 
@@ -186,6 +633,18 @@ export function createPickupVisual(materials: ShooterMaterials): Group {
186
633
  orb.position.y = 0.45;
187
634
  orb.castShadow = true;
188
635
  group.add(orb);
636
+ const animated = new Mesh(
637
+ new PlaneGeometry(0.9, 0.9),
638
+ new MeshBasicMaterial({
639
+ depthWrite: false,
640
+ map: createPickupAtlas(),
641
+ side: DoubleSide,
642
+ transparent: true,
643
+ }),
644
+ );
645
+ animated.name = "pickup-animation";
646
+ animated.position.y = 0.7;
647
+ group.add(animated);
189
648
  return group;
190
649
  }
191
650
 
@@ -14,7 +14,11 @@ import { palette } from "./palette.js";
14
14
 
15
15
  export function setupSky(scene: Scene): void {
16
16
  const radius = 90;
17
- const geometry = new SphereGeometry(radius, 4, 3);
17
+ // 4 x 3 segments is an eight-triangle blob, and a vertical gradient painted into its vertices
18
+ // interpolates across faces that span sixty degrees of sky: the frame showed a black wedge cut
19
+ // straight across the middle of the arena and green corners, both of which read as broken
20
+ // geometry rather than as a sky. 16 x 8 is 256 triangles and the gradient is smooth.
21
+ const geometry = new SphereGeometry(radius, 16, 8);
18
22
  const positions = geometry.getAttribute("position");
19
23
  const colors = new Float32Array(positions.count * 3);
20
24
  const high = new Color(palette.skyHigh);