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,8 +1,20 @@
1
1
  export type GamePhase = "playing" | "dead" | "won" | "lost";
2
2
 
3
3
  export type GameState = {
4
+ /** Set from the UI\'s pause and resume intents, and read back by the menu. */
5
+ paused: boolean;
6
+ /** True once the UI layer has rendered and published its interactive rectangles. */
7
+ uiReady: boolean;
8
+ aimedShots: number;
9
+ aiming: number;
10
+ /** Rounds in the magazine, and in reserve. The HUD reads both; a scenario asserts them. */
11
+ ammo: number;
12
+ reserve: number;
13
+ reloading: number;
4
14
  armor: number;
15
+ cameraShakes: number;
5
16
  deaths: number;
17
+ demoDamage: number;
6
18
  demoTargetAlive: number;
7
19
  friendlyPassed: number;
8
20
  gameOver: number;
@@ -13,7 +25,11 @@ export type GameState = {
13
25
  hitNormalYPercent: number;
14
26
  hitNormalZPercent: number;
15
27
  lives: number;
28
+ nameplateFacingCamera: number;
29
+ pickupFrame: number;
30
+ pickupFrameChanges: number;
16
31
  pickups: number;
32
+ pitchDegrees: number;
17
33
  radiusInsideDeaths: number;
18
34
  radiusMidAlive: number;
19
35
  radiusNearAlive: number;
@@ -21,9 +37,11 @@ export type GameState = {
21
37
  respawns: number;
22
38
  scanCount: number;
23
39
  score: number;
40
+ shotsFired: number;
24
41
  targetsRemaining: number;
25
42
  wave: number;
26
43
  wavesCleared: number;
27
44
  wallBlocked: number;
45
+ yawDegrees: number;
28
46
  phase: GamePhase;
29
47
  };
@@ -0,0 +1,46 @@
1
+ html,
2
+ body,
3
+ #root {
4
+ width: 100%;
5
+ height: 100%;
6
+ margin: 0;
7
+ overflow: hidden;
8
+ }
9
+
10
+ body {
11
+ color: #dce5e8;
12
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
13
+ -webkit-font-smoothing: antialiased;
14
+ }
15
+
16
+ /*
17
+ * The page's backdrop belongs to the web document's own mount point, never to `body`.
18
+ * `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
19
+ * transparent web view loads over the game: a `body` background there paints an opaque sheet over
20
+ * the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
21
+ * in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
22
+ */
23
+
24
+ #root {
25
+ background: #263449;
26
+ }
27
+
28
+ /* Boot failures are a page state, so the generated game owns their presentation. */
29
+ [data-threenative-canvas-error="true"] {
30
+ position: fixed;
31
+ inset: 0;
32
+ z-index: 1000;
33
+ display: grid;
34
+ place-items: center;
35
+ box-sizing: border-box;
36
+ padding: clamp(1.5rem, 8vw, 6rem);
37
+ overflow: auto;
38
+ background: #fff7ed;
39
+ color: #263449;
40
+ font-family: inherit;
41
+ font-size: clamp(1rem, 2vw, 1.5rem);
42
+ line-height: 1.5;
43
+ text-align: center;
44
+ white-space: pre-wrap;
45
+ overflow-wrap: anywhere;
46
+ }
@@ -3,22 +3,20 @@ import type { IPhysicsContext } from "@threenative/physics";
3
3
  import { DebugOverlay, GameCanvas } from "@threenative/ui";
4
4
  import { shooterUi } from "../render/ui.js";
5
5
  import type { GameState } from "../state.js";
6
- import { Hud } from "./Hud.js";
7
- import { Menu } from "./Menu.js";
6
+ import { GameUi } from "./GameUi.js";
8
7
 
9
- type AppProps = {
10
- game: IGame<GameState, IPhysicsContext>;
11
- onRestart: () => void;
12
- onTogglePause: () => void;
13
- paused: boolean;
14
- };
15
-
16
- export function App({ game, onRestart, onTogglePause, paused }: AppProps) {
8
+ /**
9
+ * The web target's page: the canvas, then the same UI every other target renders.
10
+ *
11
+ * `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first.
12
+ * The UI itself comes from `GameUi`, unchanged — this file exists only because the web build also
13
+ * has to put a canvas on the page.
14
+ */
15
+ export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
17
16
  return (
18
17
  <main className={shooterUi.app.root}>
19
18
  <GameCanvas className={shooterUi.app.canvas} game={game} />
20
- <Hud game={game} />
21
- <Menu onRestart={onRestart} onTogglePause={onTogglePause} paused={paused} />
19
+ <GameUi />
22
20
  <DebugOverlay />
23
21
  </main>
24
22
  );
@@ -0,0 +1,25 @@
1
+ import { useUiState } from "@threenative/ui";
2
+ import { shooterUi } from "../render/ui.js";
3
+ import type { GameState } from "../state.js";
4
+
5
+ /**
6
+ * The reticle.
7
+ *
8
+ * Two bars with a gap, not a dot: the gap is where the round goes, and it is the only part of a
9
+ * first-person HUD the player actually looks at. It disappears down the sights, because the optic
10
+ * on the weapon is the sight at that point and two reticles read as a bug.
11
+ *
12
+ * It is DOM rather than a mesh because it must sit at the exact centre of the *window*, which is
13
+ * where a viewport-space element already is. A world-space quad in front of the camera moves with
14
+ * the field of view and drifts off centre the moment ADS changes it.
15
+ */
16
+ export function Crosshair() {
17
+ const state = useUiState<GameState>();
18
+ if (state === undefined || state.phase !== "playing") return null;
19
+ return (
20
+ <div className={state.aiming === 1 ? shooterUi.crosshair.rootAiming : shooterUi.crosshair.root}>
21
+ <i className={shooterUi.crosshair.vertical} />
22
+ <i className={shooterUi.crosshair.horizontal} />
23
+ </div>
24
+ );
25
+ }
@@ -0,0 +1,22 @@
1
+ import { UiLayer } from "@threenative/ui";
2
+ import { Crosshair } from "./Crosshair.js";
3
+ import { Hud } from "./Hud.js";
4
+ import { Menu } from "./Menu.js";
5
+
6
+ /**
7
+ * Everything the player sees that is not the scene.
8
+ *
9
+ * One component, mounted twice by two entries that differ only in what else is on the page:
10
+ * `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
11
+ * page the native web view loads. Keeping both entries pointed at this file is what makes "the
12
+ * same UI on every target" a fact rather than an intention.
13
+ */
14
+ export function GameUi() {
15
+ return (
16
+ <UiLayer>
17
+ <Crosshair />
18
+ <Hud />
19
+ <Menu />
20
+ </UiLayer>
21
+ );
22
+ }
@@ -1,6 +1,4 @@
1
- import type { IGame } from "@threenative/core";
2
- import type { IPhysicsContext } from "@threenative/physics";
3
- import { useGameState } from "@threenative/ui";
1
+ import { useUiState } from "@threenative/ui";
4
2
  import { shooterUi } from "../render/ui.js";
5
3
  import type { GameState } from "../state.js";
6
4
 
@@ -23,13 +21,13 @@ function Meter({ label, value, tone }: { label: string; tone: MeterTone; value:
23
21
  );
24
22
  }
25
23
 
26
- export function Hud({ game }: { game: IGame<GameState, IPhysicsContext> }) {
27
- const health = useGameState(game, (state) => state.health);
28
- const lives = useGameState(game, (state) => state.lives);
29
- const wave = useGameState(game, (state) => state.wave);
30
- const wavesCleared = useGameState(game, (state) => state.wavesCleared);
31
- const targets = useGameState(game, (state) => state.targetsRemaining);
32
- const phase = useGameState(game, (state) => state.phase);
24
+ export function Hud() {
25
+ const state = useUiState<GameState>();
26
+ // Nothing to draw until the game publishes its first snapshot, a few milliseconds in. Rendering
27
+ // zeroes instead would put wrong numbers on screen and then correct them.
28
+ if (state === undefined) return null;
29
+ const { ammo, health, lives, reloading, reserve, wave, wavesCleared, phase } = state;
30
+ const targets = state.targetsRemaining;
33
31
  return (
34
32
  <section className={shooterUi.hud.root}>
35
33
  <div className={shooterUi.hud.eyebrow}>{shooterUi.hud.copy.eyebrow}</div>
@@ -41,6 +39,12 @@ export function Hud({ game }: { game: IGame<GameState, IPhysicsContext> }) {
41
39
  <span>{shooterUi.hud.copy.targets(targets)}</span>
42
40
  <span>{shooterUi.hud.copy.clear(wavesCleared)}</span>
43
41
  </div>
42
+ <div className={shooterUi.hud.ammo.root}>
43
+ <b className={shooterUi.hud.ammo.count}>{shooterUi.hud.copy.ammo(ammo, reserve)}</b>
44
+ {reloading === 1 && (
45
+ <span className={shooterUi.hud.ammo.reloading}>{shooterUi.hud.copy.reloading}</span>
46
+ )}
47
+ </div>
44
48
  {phase !== "playing" && (
45
49
  <div className={shooterUi.hud.phase[phase]}>{shooterUi.hud.phaseCopy[phase]}</div>
46
50
  )}
@@ -1,12 +1,17 @@
1
+ import { useUiIntent, useUiState } from "@threenative/ui";
1
2
  import { shooterUi } from "../render/ui.js";
3
+ import type { GameState } from "../state.js";
2
4
 
3
- type MenuProps = {
4
- onRestart: () => void;
5
- onTogglePause: () => void;
6
- paused: boolean;
7
- };
8
-
9
- export function Menu({ onRestart, onTogglePause, paused }: MenuProps) {
5
+ /**
6
+ * `data-tn-interactive` marks the two controls the player touches. The native input host publishes
7
+ * those rectangles and decides, on pointer-down, whether a touch belongs to the UI or to the game
8
+ * underneath; everything unmarked is scenery a touch passes straight through.
9
+ */
10
+ export function Menu() {
11
+ const send = useUiIntent();
12
+ const paused = useUiState<GameState, boolean>((state) => state.paused) ?? false;
13
+ const onTogglePause = () => send(paused ? "resume" : "pause");
14
+ const onRestart = () => send("restart");
10
15
  return (
11
16
  <footer className={shooterUi.menu.root}>
12
17
  <div className={shooterUi.menu.help}>
@@ -14,10 +19,20 @@ export function Menu({ onRestart, onTogglePause, paused }: MenuProps) {
14
19
  <div className={shooterUi.menu.helpSecondary}>{shooterUi.menu.copy.secondary}</div>
15
20
  </div>
16
21
  <div className={shooterUi.menu.actions}>
17
- <button className={shooterUi.menu.button} onClick={onTogglePause} type="button">
22
+ <button
23
+ className={shooterUi.menu.button}
24
+ data-tn-interactive
25
+ onClick={onTogglePause}
26
+ type="button"
27
+ >
18
28
  {paused ? shooterUi.menu.copy.resume : shooterUi.menu.copy.pause}
19
29
  </button>
20
- <button className={shooterUi.menu.button} onClick={onRestart} type="button">
30
+ <button
31
+ className={shooterUi.menu.button}
32
+ data-tn-interactive
33
+ onClick={onRestart}
34
+ type="button"
35
+ >
21
36
  {shooterUi.menu.copy.restart}
22
37
  </button>
23
38
  </div>
@@ -0,0 +1,15 @@
1
+ import { createRoot } from "react-dom/client";
2
+ import { GameUi } from "./GameUi.js";
3
+ import "../style.css";
4
+ import "../render/ui.css";
5
+
6
+ /**
7
+ * The UI entry the native web view loads.
8
+ *
9
+ * It mounts the UI and nothing else — no scene, no simulation, no renderer. The game runs beside
10
+ * it in the native runtime and reaches it only through published state and intents, which is why
11
+ * this file imports no game code at all.
12
+ */
13
+ const root = document.getElementById("tn-ui");
14
+ if (root === null) throw new Error("Missing #tn-ui element.");
15
+ createRoot(root).render(<GameUi />);
@@ -1,6 +1,5 @@
1
- import type { IPhysicsContext } from "@threenative/physics";
1
+ import type { IPhysicsContext, IRayHit } from "@threenative/physics";
2
2
  import type { Vector3 } from "three";
3
- import { type IRayHit, directSpaceState } from "../physics.js";
4
3
 
5
4
  export class Hitscan {
6
5
  readonly range: number;
@@ -25,7 +24,7 @@ export class Hitscan {
25
24
  if (this.#cooldown > 0) return undefined;
26
25
  this.#cooldown = this.cooldown;
27
26
  const to = from.clone().add(direction.clone().normalize().multiplyScalar(this.range));
28
- return directSpaceState(physics).intersectRay({
27
+ return physics.directSpaceState.intersectRay({
29
28
  collisionMask,
30
29
  from,
31
30
  to,
@@ -38,6 +37,6 @@ export class Hitscan {
38
37
  to: Vector3,
39
38
  collisionMask: number,
40
39
  ): IRayHit | undefined {
41
- return directSpaceState(physics).intersectRay({ collisionMask, from, to });
40
+ return physics.directSpaceState.intersectRay({ collisionMask, from, to });
42
41
  }
43
42
  }
@@ -1,8 +1,13 @@
1
1
  import type { ICtx } from "@threenative/core";
2
- import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
- import type { Mesh, Vector3 } from "three";
2
+ import {
3
+ CollisionShape3D,
4
+ type IPhysicsContext,
5
+ type IRayHit,
6
+ RigidBody3D,
7
+ } from "@threenative/physics";
8
+ import { type Mesh, Vector3 } from "three";
4
9
  import { PROJECTILE_LAYER } from "../entities/Player.js";
5
- import { type IRayHit, directSpaceState } from "../physics.js";
10
+
6
11
  import { createProjectileVisual } from "../render/shapes.js";
7
12
  import type { GameState } from "../state.js";
8
13
 
@@ -12,11 +17,13 @@ export class Projectile {
12
17
  readonly mesh: Mesh;
13
18
  readonly body: RigidBody3D;
14
19
  readonly tags = ["projectile"];
15
- #direction: Vector3;
20
+ #direction = new Vector3();
21
+ #from = new Vector3();
22
+ #to = new Vector3();
16
23
  #life = 2.4;
17
- #speed = 10;
18
- #collisionMask: number;
19
- #onHit: (hit: IRayHit) => void;
24
+ readonly #speed = 10;
25
+ readonly #collisionMask: number;
26
+ #onHit: (hit: IRayHit) => void = () => undefined;
20
27
  #dead = false;
21
28
 
22
29
  constructor(
@@ -28,10 +35,8 @@ export class Projectile {
28
35
  onHit: (hit: IRayHit) => void,
29
36
  ) {
30
37
  this.#collisionMask = collisionMask;
31
- this.#direction = direction.clone().normalize();
32
- this.#onHit = onHit;
33
38
  this.mesh = createProjectileVisual(materials);
34
- this.mesh.position.copy(origin);
39
+ this.reset(origin, direction, onHit);
35
40
  ctx.add(this.mesh);
36
41
  this.body = new RigidBody3D({
37
42
  collisionLayer: PROJECTILE_LAYER,
@@ -47,22 +52,33 @@ export class Projectile {
47
52
  return this.#dead;
48
53
  }
49
54
 
55
+ reset(origin: Vector3, direction: Vector3, onHit: (hit: IRayHit) => void): void {
56
+ this.#life = 2.4;
57
+ this.#dead = false;
58
+ this.#onHit = onHit;
59
+ this.#direction.copy(direction).normalize();
60
+ this.mesh.position.copy(origin);
61
+ this.mesh.visible = true;
62
+ }
63
+
50
64
  update(ctx: GameCtx, dt: number): void {
51
65
  if (this.#dead) return;
52
66
  this.#life -= dt;
53
67
  if (this.#life <= 0) {
54
68
  this.#dead = true;
69
+ this.mesh.visible = false;
55
70
  return;
56
71
  }
57
- const from = this.mesh.position.clone();
58
- const to = from.clone().addScaledVector(this.#direction, this.#speed * dt);
59
- const hit = directSpaceState(ctx.physics).intersectRay({
72
+ const from = this.#from.copy(this.mesh.position);
73
+ const to = this.#to.copy(from).addScaledVector(this.#direction, this.#speed * dt);
74
+ const hit = ctx.physics.directSpaceState.intersectRay({
60
75
  collisionMask: this.#collisionMask,
61
76
  from,
62
77
  to,
63
78
  });
64
79
  if (hit !== undefined) {
65
80
  this.#dead = true;
81
+ this.mesh.visible = false;
66
82
  this.#onHit(hit);
67
83
  return;
68
84
  }
@@ -0,0 +1,275 @@
1
+ import type { ICtx } from "@threenative/core";
2
+ import type { IPhysicsContext } from "@threenative/physics";
3
+ import {
4
+ AdditiveBlending,
5
+ Box3,
6
+ ConeGeometry,
7
+ type Group,
8
+ MathUtils,
9
+ Mesh,
10
+ MeshBasicMaterial,
11
+ PointLight,
12
+ Quaternion,
13
+ Vector3,
14
+ } from "three";
15
+ import { scale } from "../render/scale.js";
16
+ import type { GameState } from "../state.js";
17
+
18
+ type GameCtx = ICtx<GameState, IPhysicsContext>;
19
+
20
+ export const MAGAZINE = 30;
21
+ export const RESERVE = 120;
22
+ const RELOAD_SECONDS = 1.1;
23
+ /** 600 rounds a minute. The trigger is held, not tapped; this cooldown is what makes a cadence. */
24
+ const CYCLIC_SECONDS = 0.1;
25
+
26
+ /**
27
+ * Rest poses in camera space. Hip is offset to the right hand; aim brings the optic to centre.
28
+ *
29
+ * `z` is the number to touch first if the weapon reads wrong. At 72 degrees of vertical field of
30
+ * view the frame is only 0.41 m tall a quarter of a metre out, so a life-size carbine parked there
31
+ * covers half the screen as one dark slab. Held where a shouldered weapon actually sits — the
32
+ * receiver a bit over half a metre from the eye — the same model reads as a weapon.
33
+ */
34
+ const HIP = { x: 0.2, y: -0.21, z: -0.72, pitch: -0.02, yaw: 0.09, roll: 0.03 };
35
+ const AIM_Z = -0.56;
36
+ /** Where the shot is zeroed. Closer than this the barrel and the crosshair disagree slightly. */
37
+ const ZERO_DISTANCE = 22;
38
+ /** The barrel is allowed to lean this far to meet the crosshair before the pose gives up. */
39
+ const MAX_CONVERGENCE_DEGREES = 7;
40
+ const UP = new Vector3(0, 1, 0);
41
+
42
+ /**
43
+ * The weapon in the player's hands: how it sits, how it kicks, and how many rounds are left.
44
+ *
45
+ * The mechanism the framework owns is elsewhere — particles, pooling, animation. What lives here
46
+ * is the *feel*: where the weapon rests at the hip and down the sights, how far a shot throws it,
47
+ * how fast it comes back, and how long a magazine change takes. Change any of those numbers and
48
+ * the gun changes character; nothing in `packages/` has an opinion about them.
49
+ */
50
+ export class Viewmodel {
51
+ ammo = MAGAZINE;
52
+ reserve = RESERVE;
53
+ shots = 0;
54
+ reloads = 0;
55
+ reloading = false;
56
+ readonly group: Group;
57
+ #flash: Mesh;
58
+ #flashLife = 0;
59
+ #light: PointLight;
60
+ #muzzleLocal = new Vector3();
61
+ #barrelAxisLocal = new Vector3(0, 0, -1);
62
+ #opticLocal = new Vector3();
63
+ #kick = 0;
64
+ #cooldown = 0;
65
+ #blend = 0;
66
+ #sway = 0;
67
+ #lowered = 0;
68
+ #aimOrigin = new Vector3();
69
+ #aimDirection = new Vector3(0, 0, -1);
70
+ #hasAimRay = false;
71
+
72
+ constructor(viewmodel: Group) {
73
+ this.group = viewmodel;
74
+ const rifle = viewmodel.getObjectByName("held-rifle");
75
+ if (rifle === undefined) throw new Error("Shooter viewmodel is missing its held rifle.");
76
+ // Measure the weapon after `normaliseToMetres` has sized it, so the muzzle is where the
77
+ // geometry actually ends rather than where it was authored.
78
+ viewmodel.updateWorldMatrix(true, true);
79
+ const bounds = new Box3().setFromObject(rifle);
80
+ const inverse = viewmodel.matrixWorld.clone().invert();
81
+ const local = new Box3();
82
+ for (const x of [bounds.min.x, bounds.max.x])
83
+ for (const y of [bounds.min.y, bounds.max.y])
84
+ for (const z of [bounds.min.z, bounds.max.z])
85
+ local.expandByPoint(new Vector3(x, y, z).applyMatrix4(inverse));
86
+ const centre = local.getCenter(new Vector3());
87
+ this.#muzzleLocal.set(centre.x, centre.y, local.min.z);
88
+ const optic = rifle.getObjectByName("optic");
89
+ this.#opticLocal.copy(
90
+ optic === undefined
91
+ ? new Vector3(centre.x, local.max.y - 0.02, centre.z)
92
+ : viewmodel.worldToLocal(optic.getWorldPosition(new Vector3())),
93
+ );
94
+
95
+ // A short forward cone at the muzzle, not a camera-facing card: a card that big briefly
96
+ // covers most of the frame and reads as a rendering fault rather than a flash.
97
+ this.#flash = new Mesh(
98
+ new ConeGeometry(scale.muzzleFlash * 0.18, scale.muzzleFlash, 6, 1, true),
99
+ new MeshBasicMaterial({
100
+ blending: AdditiveBlending,
101
+ color: 0xffd9a0,
102
+ depthWrite: false,
103
+ opacity: 0,
104
+ transparent: true,
105
+ }),
106
+ );
107
+ this.#flash.position.copy(this.#muzzleLocal);
108
+ this.#flash.quaternion.setFromUnitVectors(UP, this.#barrelAxisLocal);
109
+ // Kept in the render list at zero opacity so WebGPU compiles this material during loading
110
+ // instead of stalling for a frame on the first trigger pull.
111
+ this.#flash.visible = true;
112
+ this.#flash.frustumCulled = false;
113
+ viewmodel.add(this.#flash);
114
+
115
+ // The flash has to light the hands, not just draw over them. The light stays in the scene for
116
+ // the whole run with its intensity driven to zero: toggling `visible` changes the lighting
117
+ // setup, which makes the renderer rebuild every material pipeline that uses it.
118
+ this.#light = new PointLight(0xffc46a, 0, 4, 2);
119
+ this.#light.position.copy(this.#muzzleLocal);
120
+ viewmodel.add(this.#light);
121
+ this.#apply(0);
122
+ }
123
+
124
+ /**
125
+ * What a scenario points a visibility assertion at.
126
+ *
127
+ * `entityObject` in the playtest bridge reads `mesh`, then `object`. In first person the
128
+ * weapon is the player's on-screen body, so this is the object a "can the player see
129
+ * themselves" row should measure — the capsule is invisible by design.
130
+ */
131
+ get object(): Group {
132
+ return this.group;
133
+ }
134
+
135
+ get ready(): boolean {
136
+ return !this.reloading && this.ammo > 0 && this.#cooldown <= 0;
137
+ }
138
+
139
+ /** Peak opacity of the muzzle cone. A playtest reads this to prove the flash retires. */
140
+ get flashOpacity(): number {
141
+ return (this.#flash.material as MeshBasicMaterial).opacity;
142
+ }
143
+
144
+ /** World-space muzzle point, for the particle burst and the tracer. */
145
+ muzzlePoint(): Vector3 {
146
+ this.group.updateWorldMatrix(true, false);
147
+ return this.group.localToWorld(this.#muzzleLocal.clone());
148
+ }
149
+
150
+ /**
151
+ * One round, if the action is cycled.
152
+ *
153
+ * The scene calls this every frame the trigger is held; the cyclic cooldown decides which of
154
+ * those frames sends a round, so hold-to-fire and a single tap run the same path.
155
+ */
156
+ fire(): boolean {
157
+ if (!this.ready) return false;
158
+ this.#cooldown = CYCLIC_SECONDS;
159
+ this.ammo -= 1;
160
+ this.shots += 1;
161
+ this.#kick = 1;
162
+ this.#flashLife = 0.045;
163
+ (this.#flash.material as MeshBasicMaterial).opacity = 1;
164
+ this.#flash.rotateOnAxis(this.#barrelAxisLocal, this.shots * 1.7);
165
+ this.#flash.scale.setScalar(0.8 + ((this.shots * 37) % 10) / 25);
166
+ this.#light.intensity = 3.2;
167
+ return true;
168
+ }
169
+
170
+ reload(ctx: GameCtx): void {
171
+ if (this.reloading || this.reserve <= 0 || this.ammo >= MAGAZINE) return;
172
+ this.reloading = true;
173
+ ctx.after(RELOAD_SECONDS, () => {
174
+ const moved = Math.min(MAGAZINE - this.ammo, this.reserve);
175
+ this.ammo += moved;
176
+ this.reserve -= moved;
177
+ this.reloads += 1;
178
+ this.reloading = false;
179
+ });
180
+ }
181
+
182
+ /** Point the barrel at whatever the crosshair is on, within `MAX_CONVERGENCE_DEGREES`. */
183
+ converge(origin: Vector3, direction: Vector3): void {
184
+ this.#aimOrigin.copy(origin);
185
+ this.#aimDirection.copy(direction).normalize();
186
+ this.#hasAimRay = true;
187
+ }
188
+
189
+ /**
190
+ * Retire the visible effects of a shot.
191
+ *
192
+ * Separate from `update` because it must run on frames the game is not being played — an end
193
+ * card, a pause. A round fired on the frame the round ended used to leave the cone and its light
194
+ * burning on screen for as long as the card was up.
195
+ */
196
+ decay(dt: number): void {
197
+ this.#cooldown = Math.max(0, this.#cooldown - dt);
198
+ this.#flashLife = Math.max(0, this.#flashLife - dt);
199
+ (this.#flash.material as MeshBasicMaterial).opacity = Math.min(1, this.#flashLife / 0.025);
200
+ this.#light.intensity = Math.max(0, this.#light.intensity - dt * 80);
201
+ this.#kick = Math.max(0, this.#kick - dt * 7);
202
+ }
203
+
204
+ update(dt: number, aiming: boolean, moving: number): void {
205
+ this.decay(dt);
206
+ // The sights drop while the magazine is out and come back up after.
207
+ this.#lowered += ((this.reloading ? 1 : 0) - this.#lowered) * Math.min(1, dt * 9);
208
+ this.#blend += ((aiming && !this.reloading ? 1 : 0) - this.#blend) * Math.min(1, dt * 12);
209
+ this.#sway += dt * (2.6 + moving * 4.4);
210
+ this.#apply(moving);
211
+ }
212
+
213
+ #apply(moving: number): void {
214
+ const t = this.#blend;
215
+ const hipMotion = 1 - t;
216
+ const bob = Math.sin(this.#sway) * 0.008 * (0.35 + moving) * hipMotion;
217
+ const bobY = Math.abs(Math.cos(this.#sway)) * 0.01 * (0.25 + moving) * hipMotion;
218
+ const kick = this.#kick * this.#kick;
219
+ this.group.position.set(
220
+ HIP.x + (-this.#opticLocal.x - HIP.x) * t + bob,
221
+ HIP.y + (-this.#opticLocal.y - HIP.y) * t + bobY - this.#lowered * 0.26,
222
+ HIP.z + (AIM_Z - HIP.z) * t + kick * 0.04,
223
+ );
224
+ this.group.rotation.set(
225
+ HIP.pitch - kick * 0.05 + this.#lowered * 0.5,
226
+ HIP.yaw * (1 - t),
227
+ HIP.roll * (1 - t) + this.#lowered * 0.18,
228
+ );
229
+ if (!this.#hasAimRay) return;
230
+
231
+ // Lean the whole weapon so its barrel meets the crosshair's ray at the zero distance. Without
232
+ // this the muzzle flash appears beside a target the round passes through, which reads as the
233
+ // shot missing.
234
+ const target = this.#aimOrigin.clone().addScaledVector(this.#aimDirection, ZERO_DISTANCE);
235
+ this.group.updateWorldMatrix(true, false);
236
+ const muzzle = this.group.localToWorld(this.#muzzleLocal.clone());
237
+ const desired = target.sub(muzzle).normalize();
238
+ const parent = this.group.parent?.getWorldQuaternion(new Quaternion()) ?? new Quaternion();
239
+ const desiredParent = desired.applyQuaternion(parent.clone().invert());
240
+ const currentParent = this.#barrelAxisLocal.clone().applyQuaternion(this.group.quaternion);
241
+ const correction = new Quaternion().setFromUnitVectors(currentParent, desiredParent);
242
+ const maxAngle = MathUtils.degToRad(MAX_CONVERGENCE_DEGREES);
243
+ const angle = 2 * Math.acos(MathUtils.clamp(correction.w, -1, 1));
244
+ if (angle > maxAngle) correction.slerp(new Quaternion(), maxAngle / angle);
245
+ this.group.quaternion.premultiply(correction);
246
+ }
247
+
248
+ /**
249
+ * Called by the entity registry when the scene exits.
250
+ *
251
+ * The cone and its light are children of the viewmodel group, which `Player.dispose` removes —
252
+ * but removing an object does not free the geometry and material behind it, and a kit whose
253
+ * restart key is on the keyboard gets restarted a lot.
254
+ */
255
+ dispose(): void {
256
+ this.#flash.geometry.dispose();
257
+ (this.#flash.material as MeshBasicMaterial).dispose();
258
+ this.#flash.removeFromParent();
259
+ this.#light.dispose();
260
+ this.#light.removeFromParent();
261
+ }
262
+
263
+ debug(): Record<string, unknown> {
264
+ return {
265
+ ammo: this.ammo,
266
+ // Zero once the shot has retired. A non-zero reading long after the last round is the
267
+ // stuck-flash bug, and it is the only way a gate can see it.
268
+ flashOpacity: this.flashOpacity,
269
+ reloading: this.reloading ? 1 : 0,
270
+ reloads: this.reloads,
271
+ reserve: this.reserve,
272
+ shots: this.shots,
273
+ };
274
+ }
275
+ }