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,4 +1,4 @@
1
1
  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
2
- <rect width="64" height="64" rx="14" fill="#090d13"/>
2
+ <rect width="64" height="64" rx="14" fill="#101820"/>
3
3
  <path d="M16 16h32v8H24v8h16v8H24v8h24v8H16z" fill="#f6c85f"/>
4
4
  </svg>
@@ -3,7 +3,6 @@ import { CollisionShape3D } from "@threenative/physics";
3
3
  import type { Vector3 } from "three";
4
4
  import { HOSTILE_LAYER } from "../entities/Player.js";
5
5
  import type { Target } from "../entities/Target.js";
6
- import { directSpaceState } from "../physics.js";
7
6
 
8
7
  export function applyDirectDamage(
9
8
  targets: ReadonlyMap<number, Target>,
@@ -21,7 +20,7 @@ export function applyRadiusDamage(
21
20
  amount: number,
22
21
  targets: ReadonlyMap<number, Target>,
23
22
  ): Set<number> {
24
- const hits = directSpaceState(physics).intersectShape({
23
+ const hits = physics.directSpaceState.intersectShape({
25
24
  collisionMask: HOSTILE_LAYER,
26
25
  maxResults: 16,
27
26
  position: centre,
@@ -0,0 +1,51 @@
1
+ import { GroundSnap, attachToBone, normaliseToMetres, skeletonBones } from "@threenative/core";
2
+ import { Bone, type Group } from "three";
3
+ import { scale } from "./render/scale.js";
4
+
5
+ export interface IShooterConventions {
6
+ readonly applyGrounding: (surfaceY: number, dt: number) => void;
7
+ readonly attachedBone: string;
8
+ readonly boneNames: readonly string[];
9
+ readonly groundSnap: GroundSnap;
10
+ readonly normaliseFactor: number;
11
+ }
12
+
13
+ /**
14
+ * The three conventions this kit turns on, in one place.
15
+ *
16
+ * - `normaliseToMetres` sizes the carbine. The viewmodel is authored at whatever size was
17
+ * convenient to lay out; the metre table in `render/scale.ts` decides what it actually is, so a
18
+ * replacement model dropped in from an asset site lands at the same size without a magic number
19
+ * beside it.
20
+ * - `attachToBone` puts the weapon in the hand that holds it. The hand is a real `Bone`, so
21
+ * swapping the procedural arms for a rigged pair keeps the same call.
22
+ * - `GroundSnap` keeps the boots on the floor. In first person you only see them when you look
23
+ * down, which is exactly when a hovering foot is obvious.
24
+ *
25
+ * Every one of them reports honestly when overridden: `groundSnap.enabled = false` keeps measuring
26
+ * and keeps `clearance` truthful.
27
+ */
28
+ export function preparePlayerConventions(viewmodel: Group, legs: Group): IShooterConventions {
29
+ const weapon = viewmodel.getObjectByName("held-rifle");
30
+ if (weapon === undefined) throw new Error("Shooter viewmodel is missing its held rifle.");
31
+
32
+ const normaliseFactor = normaliseToMetres(weapon, { axis: "longest", metres: scale.rifleLength });
33
+ const hand = new Bone();
34
+ hand.name = "RightHand";
35
+ hand.position.copy(weapon.position);
36
+ hand.rotation.copy(weapon.rotation);
37
+ viewmodel.add(hand);
38
+ weapon.position.set(0, 0, 0);
39
+ weapon.rotation.set(0, 0, 0);
40
+
41
+ const boneNames = skeletonBones(viewmodel);
42
+ attachToBone(viewmodel, "RightHand", weapon);
43
+ const groundSnap = new GroundSnap(legs);
44
+ return {
45
+ applyGrounding: (surfaceY, dt) => groundSnap.apply(legs, surfaceY, dt),
46
+ attachedBone: weapon.parent?.name ?? "",
47
+ boneNames,
48
+ groundSnap,
49
+ normaliseFactor,
50
+ };
51
+ }
@@ -1,7 +1,10 @@
1
1
  import type { ICtx } from "@threenative/core";
2
2
  import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
- import { type Group, Vector3 } from "three";
4
- import { createPlayerVisual } from "../render/shapes.js";
3
+ import { Group, MathUtils, type PerspectiveCamera, Vector3 } from "three";
4
+ import { type IShooterConventions, preparePlayerConventions } from "../conventions.js";
5
+ import { scale } from "../render/scale.js";
6
+ import { createLegsVisual, createViewmodelVisual } from "../render/shapes.js";
7
+ import type { ITouchInput } from "../render/touch-controls.js";
5
8
  import type { GameState } from "../state.js";
6
9
 
7
10
  export const WORLD_LAYER = 1;
@@ -12,46 +15,249 @@ export const PROJECTILE_LAYER = 16;
12
15
 
13
16
  type GameCtx = ICtx<GameState, IPhysicsContext>;
14
17
 
15
- const SPAWN = new Vector3(0, 0.85, 5);
16
- const MOVE_SPEED = 4.2;
18
+ const BODY_Y = scale.humanHeight / 2;
19
+ const SPAWN = new Vector3(0, BODY_Y, 5);
20
+ const WALK_SPEED = 4.2;
21
+ const SPRINT_SPEED = 6.6;
22
+ /** Crouched movement. A crouch that only lowers the eye is a camera trick, not a stance. */
23
+ const CROUCH_SPEED = 2.2;
24
+ /** How fast the stance folds and unfolds. Fast enough to peek with, slow enough to see. */
25
+ const CROUCH_RATE = 11;
26
+ const FOV_HIP = 72;
27
+ const FOV_AIM = 34;
28
+ const PITCH_MIN = MathUtils.degToRad(-72);
29
+ const PITCH_MAX = MathUtils.degToRad(72);
30
+ /** Relative pointer pixels to radians. The delta is already per-frame, so nothing scales by dt. */
31
+ const LOOK_RADIANS_PER_PIXEL = 0.005;
32
+ /** Down the sights the same hand movement should cover less angle. */
33
+ const AIM_SENSITIVITY = 0.5;
34
+ const CAPSULE_RADIUS = scale.shoulderWidth / 2;
35
+ const CAPSULE_HALF = (scale.humanHeight - CAPSULE_RADIUS * 2) / 2;
36
+ /** Metres of stride between planted feet, walking. Sprint covers it sooner, so it sounds faster. */
37
+ const STRIDE_METRES = 0.82;
17
38
 
39
+ /**
40
+ * Yaw and pitch, integrated from the `look` action.
41
+ *
42
+ * `look` is bound `pointerRelative`, so `ctx.input.vector("look")` is the pointer delta for this
43
+ * tick in canvas pixels. The framework owns the pointer lock and the native equivalent, so nothing
44
+ * in this game reads `movementX` or touches the DOM.
45
+ */
46
+ class Look {
47
+ yaw = 0;
48
+ pitch = 0;
49
+
50
+ /** Applied by both paths: mouse deltas and the right thumb, which has no lock to earn. */
51
+ applyDelta(dx: number, dy: number, sensitivity: number): void {
52
+ if (dx === 0 && dy === 0) return;
53
+ this.yaw -= dx * LOOK_RADIANS_PER_PIXEL * sensitivity;
54
+ this.pitch = MathUtils.clamp(
55
+ this.pitch - dy * LOOK_RADIANS_PER_PIXEL * sensitivity,
56
+ PITCH_MIN,
57
+ PITCH_MAX,
58
+ );
59
+ }
60
+ }
61
+
62
+ /**
63
+ * The player, seen from behind their own eyes.
64
+ *
65
+ * The body is a capsule the physics solver owns; the camera is placed from it once the solver has
66
+ * written the step (see `syncCamera` and the `afterPhysics` call in `scenes/Play.ts`). The
67
+ * viewmodel hangs off the camera, so the weapon is always in frame no matter how the body is
68
+ * being shoved around.
69
+ */
18
70
  export class Player {
19
71
  readonly mesh: Group;
72
+ /** The weapon and hands, parented to the camera. */
73
+ readonly visual: Group;
74
+ /** The part of the player their own eyes can see, parented to the body. */
75
+ readonly legs: Group;
20
76
  readonly body: CharacterBody3D;
77
+ readonly look = new Look();
21
78
  readonly maxHealth = 100;
22
79
  health = 100;
23
80
  dead = false;
81
+ aiming = false;
82
+ crouching = false;
83
+ sprinting = false;
84
+ /** Metres walked. The scene does not read it; a scenario can, through `debug()`. */
85
+ distanceMoved = 0;
86
+ /** Fired each time a stride completes, so footsteps keep pace with speed rather than time. */
87
+ onFootstep: ((sprinting: boolean) => void) | undefined;
24
88
  #onDamage: (amount: number) => void;
25
89
  #onDeath: () => void;
90
+ #conventions: IShooterConventions;
91
+ #camera: PerspectiveCamera;
92
+ /** 0 standing, 1 fully folded. Eased, so the eye slides rather than teleports. */
93
+ #crouch = 0;
94
+ #fov = FOV_HIP;
95
+ #lastX = SPAWN.x;
96
+ #lastZ = SPAWN.z;
97
+ #strideAccumulated = 0;
98
+ #moving = 0;
26
99
 
27
100
  constructor(
28
101
  ctx: GameCtx,
29
- materials: Parameters<typeof createPlayerVisual>[0],
102
+ camera: PerspectiveCamera,
103
+ materials: Parameters<typeof createViewmodelVisual>[0],
30
104
  spawn: Vector3 = SPAWN,
31
105
  onDamage: (amount: number) => void = () => undefined,
32
106
  onDeath: () => void = () => undefined,
33
107
  ) {
108
+ this.#camera = camera;
34
109
  this.#onDamage = onDamage;
35
110
  this.#onDeath = onDeath;
36
- this.mesh = createPlayerVisual(materials);
111
+ this.mesh = new Group();
112
+ this.mesh.name = "player";
37
113
  this.mesh.position.copy(spawn);
38
114
  ctx.add(this.mesh);
115
+ // Two visuals, in two spaces. The viewmodel hangs off the camera so the weapon is always in
116
+ // frame; the legs hang off the body so looking down shows a person standing on the floor
117
+ // rather than a floating gun.
118
+ this.visual = createViewmodelVisual(materials);
119
+ camera.add(this.visual);
120
+ this.legs = createLegsVisual(materials);
121
+ this.mesh.add(this.legs);
122
+ this.#conventions = preparePlayerConventions(this.visual, this.legs);
39
123
  this.body = new CharacterBody3D({
40
124
  collisionLayer: PLAYER_LAYER,
41
125
  collisionMask: WORLD_LAYER | HOSTILE_LAYER,
42
- autostep: { maxHeight: 0.25, minWidth: 0.18 },
126
+ autostep: { maxHeight: 0.35, minWidth: 0.18 },
43
127
  object: this.mesh,
44
128
  physics: ctx.physics,
45
- shape: CollisionShape3D.capsule(0.45, 0.38),
129
+ shape: CollisionShape3D.capsule(CAPSULE_RADIUS, CAPSULE_HALF),
46
130
  });
131
+ camera.fov = FOV_HIP;
132
+ camera.near = 0.02;
133
+ camera.far = 120;
134
+ camera.updateProjectionMatrix();
135
+ this.syncCamera();
136
+ }
137
+
138
+ /** Where the eye is right now, crouch included. */
139
+ get eyeHeight(): number {
140
+ return scale.eyeHeight - BODY_Y - this.#crouch * scale.crouchDrop;
141
+ }
142
+
143
+ /**
144
+ * Heading, in degrees turned to the right of the spawn facing.
145
+ *
146
+ * Reported rather than `look.yaw` itself because the two have opposite signs: Three turns left
147
+ * for a positive rotation about +y, and a player who moved the mouse right expects a positive
148
+ * number back. The HUD and the scenarios read this one.
149
+ */
150
+ get yawDegrees(): number {
151
+ return -MathUtils.radToDeg(this.look.yaw);
152
+ }
153
+
154
+ /** Elevation, in degrees above the horizon. Positive is up, matching the same expectation. */
155
+ get pitchDegrees(): number {
156
+ return MathUtils.radToDeg(this.look.pitch);
157
+ }
158
+
159
+ /** How hard the player is moving, 0 to 1. The viewmodel reads this for its bob. */
160
+ get moving(): number {
161
+ return this.#moving;
162
+ }
163
+
164
+ /**
165
+ * The camera basis is the single source of aim truth.
166
+ *
167
+ * Every shot starts here rather than from a muzzle offset, because the crosshair is drawn at the
168
+ * centre of this basis: a round that starts anywhere else lands somewhere the player did not aim.
169
+ * The viewmodel's barrel is then converged onto this ray, not the other way round.
170
+ */
171
+ aimRay(): { origin: Vector3; direction: Vector3 } {
172
+ this.#camera.updateMatrixWorld(true);
173
+ return {
174
+ origin: this.#camera.getWorldPosition(new Vector3()),
175
+ direction: this.#camera.getWorldDirection(new Vector3()).normalize(),
176
+ };
47
177
  }
48
178
 
49
- update(ctx: GameCtx, dt: number): void {
179
+ /**
180
+ * Place the camera at the eye.
181
+ *
182
+ * Called from `afterPhysics`, never from `update`: `moveAndSlide` only queues the motion, and the
183
+ * rapier plugin writes the solved transform after the frame callback returns. Reading
184
+ * `mesh.position` inside `update` places the eye one physics step behind the body — invisible on
185
+ * flat ground and a third of a metre low on a step, which is how a shot aimed at a target ends
186
+ * up in the floor underfoot.
187
+ */
188
+ syncCamera(): void {
189
+ this.#camera.position.set(
190
+ this.mesh.position.x,
191
+ this.mesh.position.y + this.eyeHeight,
192
+ this.mesh.position.z,
193
+ );
194
+ this.#camera.rotation.set(this.look.pitch, this.look.yaw, 0, "YXZ");
195
+ }
196
+
197
+ update(ctx: GameCtx, dt: number, touch?: ITouchInput): void {
50
198
  if (this.dead) return;
51
- const move = ctx.input.vector("move");
52
- this.body.velocity.x = move.x * MOVE_SPEED;
53
- this.body.velocity.z = -move.y * MOVE_SPEED;
199
+ this.aiming = ctx.input.pressed("aim") || touch?.aimPressed === true;
200
+ this.crouching = ctx.input.pressed("crouch") || touch?.crouchPressed === true;
201
+ this.#crouch = MathUtils.damp(this.#crouch, this.crouching ? 1 : 0, CROUCH_RATE, dt);
202
+
203
+ const sensitivity = this.aiming ? AIM_SENSITIVITY : 1;
204
+ const look = ctx.input.vector("look");
205
+ this.look.applyDelta(look.x, look.y, sensitivity);
206
+ if (touch !== undefined) this.look.applyDelta(touch.aim.x * 12, touch.aim.y * 12, sensitivity);
207
+
208
+ const keyboard = ctx.input.vector("move");
209
+ const moveX = MathUtils.clamp(keyboard.x + (touch?.move.x ?? 0), -1, 1);
210
+ const moveY = MathUtils.clamp(keyboard.y + (touch?.move.y ?? 0), -1, 1);
211
+ // Sprint arrives as its own flag rather than as a longer move vector, so the two vetoes below
212
+ // apply to a thumb and to Shift alike. Crouch wins: holding both should not sprint at a
213
+ // crouch-walk's silhouette.
214
+ const sprintAsked = ctx.input.pressed("sprint") || touch?.sprintPressed === true;
215
+ this.sprinting = sprintAsked && !this.aiming && !this.crouching;
216
+ const speed = this.crouching ? CROUCH_SPEED : this.sprinting ? SPRINT_SPEED : WALK_SPEED;
217
+
218
+ // `vector().y` is +up on the stick; forward on this ground plane is -z at yaw 0.
219
+ const forwardX = -Math.sin(this.look.yaw);
220
+ const forwardZ = -Math.cos(this.look.yaw);
221
+ const rightX = Math.cos(this.look.yaw);
222
+ const rightZ = -Math.sin(this.look.yaw);
223
+ let vx = forwardX * moveY + rightX * moveX;
224
+ let vz = forwardZ * moveY + rightZ * moveX;
225
+ const length = Math.hypot(vx, vz);
226
+ if (length > 1e-4) {
227
+ vx = (vx / length) * speed;
228
+ vz = (vz / length) * speed;
229
+ } else {
230
+ vx = 0;
231
+ vz = 0;
232
+ }
233
+ this.#moving = length > 1e-4 ? speed / SPRINT_SPEED : 0;
234
+
235
+ // The backend writes the solved transform after the step, so measuring the mesh either side of
236
+ // `moveAndSlide` in one frame always reads zero. Compare against the previous frame instead.
237
+ const stride = Math.hypot(
238
+ this.mesh.position.x - this.#lastX,
239
+ this.mesh.position.z - this.#lastZ,
240
+ );
241
+ this.distanceMoved += stride;
242
+ this.#strideAccumulated += stride;
243
+ if (length > 1e-4 && this.#strideAccumulated >= STRIDE_METRES) {
244
+ this.#strideAccumulated = 0;
245
+ this.onFootstep?.(this.sprinting);
246
+ }
247
+ this.#lastX = this.mesh.position.x;
248
+ this.#lastZ = this.mesh.position.z;
249
+
250
+ this.body.velocity.x = vx;
251
+ this.body.velocity.z = vz;
54
252
  this.body.moveAndSlide(dt);
253
+ this.#conventions.applyGrounding(0, dt);
254
+
255
+ const wanted = this.aiming ? FOV_AIM : FOV_HIP;
256
+ this.#fov = MathUtils.damp(this.#fov, wanted, 14, dt);
257
+ if (Math.abs(this.#camera.fov - this.#fov) > 0.01) {
258
+ this.#camera.fov = this.#fov;
259
+ this.#camera.updateProjectionMatrix();
260
+ }
55
261
  }
56
262
 
57
263
  takeDamage(amount: number): void {
@@ -60,7 +266,8 @@ export class Player {
60
266
  this.#onDamage(amount);
61
267
  if (this.health > 0) return;
62
268
  this.dead = true;
63
- this.mesh.visible = false;
269
+ this.visual.visible = false;
270
+ this.legs.visible = false;
64
271
  this.body.velocity.set(0, 0, 0);
65
272
  this.#onDeath();
66
273
  }
@@ -69,23 +276,33 @@ export class Player {
69
276
  this.body.teleport(spawn);
70
277
  this.health = 40;
71
278
  this.dead = false;
72
- this.mesh.visible = true;
73
- }
74
-
75
- aimOrigin(): Vector3 {
76
- return this.mesh.position.clone().add(new Vector3(0, 0.72, -0.72));
279
+ this.visual.visible = true;
280
+ this.legs.visible = true;
281
+ this.syncCamera();
77
282
  }
78
283
 
79
284
  debug(): Record<string, unknown> {
80
285
  return {
286
+ aiming: this.aiming ? 1 : 0,
287
+ crouching: this.crouching ? 1 : 0,
81
288
  dead: this.dead,
289
+ distanceMoved: this.distanceMoved,
290
+ fov: this.#camera.fov,
291
+ groundClearance: this.#conventions.groundSnap.clearance,
82
292
  health: this.health,
293
+ normaliseFactor: this.#conventions.normaliseFactor,
294
+ pitchDegrees: this.pitchDegrees,
83
295
  position: this.mesh.position.toArray(),
296
+ skeletonBones: this.#conventions.boneNames,
297
+ weaponBone: this.#conventions.attachedBone,
298
+ yawDegrees: this.yawDegrees,
84
299
  };
85
300
  }
86
301
 
87
302
  dispose(): void {
88
303
  this.body.dispose();
304
+ this.visual.removeFromParent();
305
+ this.legs.removeFromParent();
89
306
  this.mesh.removeFromParent();
90
307
  }
91
308
  }
@@ -1,7 +1,7 @@
1
1
  import type { ICtx, ScheduleHandle } from "@threenative/core";
2
2
  import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
3
  import { type Group, Vector3 } from "three";
4
- import { directSpaceState } from "../physics.js";
4
+
5
5
  import { createTargetVisual } from "../render/shapes.js";
6
6
  import type { GameState } from "../state.js";
7
7
  import { HOSTILE_LAYER, PLAYER_LAYER, WORLD_LAYER } from "./Player.js";
@@ -54,7 +54,7 @@ export class Target {
54
54
  const scan = (): void => {
55
55
  if (!this.alive) return;
56
56
  this.scanCount += 1;
57
- const hits = directSpaceState(ctx.physics).intersectShape({
57
+ const hits = ctx.physics.directSpaceState.intersectShape({
58
58
  collisionMask: PLAYER_LAYER,
59
59
  maxResults: 4,
60
60
  position: this.mesh.position,
@@ -18,15 +18,27 @@ const game = defineGame<GameState, IPhysicsContext>({
18
18
  right: ["ArrowRight", "KeyD"],
19
19
  up: ["ArrowUp", "KeyW"],
20
20
  },
21
+ // Down the sights. The right mouse button is the mouse binding every shooter uses; KeyQ is
22
+ // here so a scenario — and a keyboard-only player — can hold it without a pointer.
23
+ aim: { keys: ["KeyQ"], mouseButtons: [2] },
21
24
  blast: { keys: ["KeyE"], buttons: [2] },
25
+ // Ctrl is the conventional crouch and is routinely eaten by the window manager, so KeyC is a
26
+ // second binding rather than a replacement.
27
+ crouch: { keys: ["ControlLeft", "ControlRight", "KeyC"] },
22
28
  damage: { keys: ["KeyH"] },
23
- fire: { buttons: [0], keys: ["KeyF"], pointer: true },
29
+ fire: { buttons: [0], keys: ["KeyF", "Space"], mouseButtons: [0] },
30
+ look: { pointerRelative: true },
24
31
  lethal: { keys: ["KeyX"] },
25
- probe: { keys: ["KeyC"] },
32
+ probe: { keys: ["KeyV"] },
26
33
  projectile: { buttons: [1], keys: ["KeyG"] },
27
- restart: { keys: ["KeyR"] },
34
+ reload: { buttons: [3], keys: ["KeyR"] },
35
+ // Enter, not KeyR: R is the reload key in every shooter, and a player who taps it to top up
36
+ // a magazine should not lose the round.
37
+ restart: { keys: ["Enter", "NumpadEnter"] },
38
+ sprint: { keys: ["ShiftLeft", "ShiftRight"] },
28
39
  },
29
40
  plugins: [rapier(), replay(), playtest({ events: drainPlaytestEvents })],
41
+ display: config.display,
30
42
  render: config.renderer,
31
43
  scenes: { boot: Boot, play: Play },
32
44
  seed: 89089,
@@ -34,3 +46,23 @@ const game = defineGame<GameState, IPhysicsContext>({
34
46
  });
35
47
 
36
48
  export default game;
49
+
50
+ /**
51
+ * What the UI can ask the game to do.
52
+ *
53
+ * Intents are one-way and named by the game: the UI sends `restart`, `pause` or `resume` and the
54
+ * game decides what each means. Nothing comes back this way — the UI reads the game's published
55
+ * state instead, which keeps one source of truth on the side that owns the simulation.
56
+ */
57
+ game.ui.onIntent((intent) => {
58
+ if (intent === "restart") void game.goto("play");
59
+ if (intent === "pause") game.pause();
60
+ if (intent === "resume") game.resume();
61
+ game.state.set({
62
+ // `game.ui.connected` is true only once the UI announced itself, which is what tells an
63
+ // overlay that never came up apart from a game whose HUD is simply empty.
64
+ uiReady: game.ui.connected,
65
+ ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
66
+ });
67
+ game.state.flush();
68
+ });
@@ -1,21 +1,11 @@
1
1
  import { acceptHotUpdate } from "@threenative/core/hot";
2
- import { createElement, useState } from "react";
2
+ import { createElement } from "react";
3
3
  import { createRoot } from "react-dom/client";
4
4
  import game from "./game.js";
5
5
  import { App } from "./ui/App.js";
6
+ import "./style.css";
6
7
  import "./render/ui.css";
7
8
 
8
- function WebApp({ game: currentGame }: { game: typeof game }) {
9
- const [paused, setPaused] = useState(false);
10
- const onTogglePause = () => {
11
- if (paused) currentGame.resume();
12
- else currentGame.pause();
13
- setPaused((value) => !value);
14
- };
15
- const onRestart = () => void currentGame.goto("play");
16
- return createElement(App, { game: currentGame, onRestart, onTogglePause, paused });
17
- }
18
-
19
9
  import.meta.hot?.accept();
20
10
  acceptHotUpdate(game, import.meta.hot);
21
11
  const root = document.getElementById("root");
@@ -23,4 +13,4 @@ if (root === null) throw new Error("Missing #root element.");
23
13
  const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
24
14
  const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
25
15
  appRoot.__threenativeRoot = reactRoot;
26
- reactRoot.render(createElement(WebApp, { game }));
16
+ reactRoot.render(createElement(App, { game }));
@@ -1,29 +1,89 @@
1
1
  // Generated for you. Camera framing is game-owned source; edit it to change the feel.
2
- import type { PerspectiveCamera, Vector3 } from "three";
3
- import { Vector3 as Vec3 } from "three";
2
+ import { type PerspectiveCamera, Vector3 as Vec3, type Vector3 } from "three";
3
+
4
+ export interface ICameraShakeOffset {
5
+ readonly position: Vector3;
6
+ readonly rotation: Vector3;
7
+ }
8
+
9
+ export interface ICameraShakeLike {
10
+ readonly update: (dt: number) => ICameraShakeOffset;
11
+ }
12
+
13
+ export interface ICameraShakeOptions {
14
+ readonly amplitude: Vector3;
15
+ readonly rotationAmplitude: Vector3;
16
+ readonly frequency: number;
17
+ readonly decay: number;
18
+ readonly curve: (phase: number) => number;
19
+ }
20
+
21
+ /** Anything that can put the camera at its own eye. `Player` is the one that does. */
22
+ export interface IEyeSource {
23
+ readonly syncCamera: () => void;
24
+ }
4
25
 
5
26
  export interface ICameraRig {
6
- readonly follow: (target: Vector3, dt: number) => void;
7
- readonly snap: (target: Vector3) => void;
27
+ /** Place the eye for this frame, then add whatever the shake is currently worth. */
28
+ readonly follow: (eye: IEyeSource, dt: number) => void;
29
+ /** Place the eye with no smoothing and no shake — use on spawn and respawn. */
30
+ readonly snap: (eye: IEyeSource) => void;
31
+ }
32
+
33
+ /**
34
+ * These are game-owned feel decisions. `CameraShake` only applies the values and never chooses
35
+ * them. First-person amplitudes are much smaller than a third-person rig's: the whole frame is
36
+ * the shake, so a centimetre reads as a punch where a third-person camera needs ten.
37
+ */
38
+ export function createArenaShakeOptions(): ICameraShakeOptions {
39
+ return {
40
+ amplitude: new Vec3(0.022, 0.016, 0.01),
41
+ rotationAmplitude: new Vec3(0.012, 0.016, 0.02),
42
+ frequency: 21,
43
+ decay: 8.5,
44
+ curve: (phase) => Math.sin(phase) * 0.72 + Math.sin(phase * 0.43) * 0.28,
45
+ };
8
46
  }
9
47
 
10
- export function createArenaCamera(camera: PerspectiveCamera): ICameraRig {
11
- const offset = new Vec3(0, 5.2, 9.2);
12
- const lookAhead = new Vec3(0, 0.4, -4.6);
13
- const desired = new Vec3();
14
- const aim = new Vec3();
48
+ /**
49
+ * Both halves of a shake, in one place.
50
+ *
51
+ * Position and rotation are applied together because applying only the first is the shake bug
52
+ * that reads as the camera sliding rather than being hit.
53
+ */
54
+ function composeCameraShake(camera: PerspectiveCamera, offset: ICameraShakeOffset): void {
55
+ camera.position.add(offset.position);
56
+ camera.rotation.set(
57
+ camera.rotation.x + offset.rotation.x,
58
+ camera.rotation.y + offset.rotation.y,
59
+ camera.rotation.z + offset.rotation.z,
60
+ camera.rotation.order,
61
+ );
62
+ }
15
63
 
16
- const pose = (target: Vector3): void => {
17
- camera.position.copy(target).add(offset);
18
- camera.lookAt(aim.copy(target).add(lookAhead));
64
+ /**
65
+ * The first-person rig.
66
+ *
67
+ * There is no smoothing here on purpose. A third-person camera lerps towards its target because
68
+ * the target is something it is watching; the eye *is* the player, and easing it turns every step
69
+ * into a swim. What does get added is the hit shake, composed on top of the pose the player just
70
+ * wrote, so the shake decays back to exactly where the player is aiming.
71
+ */
72
+ export function createFirstPersonRig(
73
+ camera: PerspectiveCamera,
74
+ shake?: ICameraShakeLike,
75
+ ): ICameraRig {
76
+ const pose = (eye: IEyeSource, dt: number): void => {
77
+ eye.syncCamera();
78
+ // A snap is a respawn, and a respawn should not arrive pre-shaken.
79
+ if (dt === 0) return;
80
+ const shakeOffset = shake?.update(dt);
81
+ if (shakeOffset === undefined) return;
82
+ composeCameraShake(camera, shakeOffset);
19
83
  };
20
84
 
21
85
  return {
22
- follow: (target, dt) => {
23
- desired.copy(target).add(offset);
24
- camera.position.lerp(desired, 1 - Math.exp(-dt / 0.2));
25
- camera.lookAt(aim.copy(target).add(lookAhead));
26
- },
27
- snap: pose,
86
+ follow: (eye, dt) => pose(eye, dt),
87
+ snap: (eye) => pose(eye, 0),
28
88
  };
29
89
  }