create-threenative 0.2.1 → 0.2.3

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 (343) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +10 -2
  3. package/agent-docs/asset-mcp-loop.md +33 -0
  4. package/agent-docs/ctx-surface.md +69 -0
  5. package/agent-docs/engine-capabilities.md +4 -0
  6. package/agent-docs/framework-blocks-you.md +60 -0
  7. package/agent-docs/look-at-it-and-budget-the-look.md +27 -0
  8. package/agent-docs/performance-default.md +42 -0
  9. package/agent-docs/pixel-budget.md +20 -0
  10. package/agent-docs/playtest-fail-closed.md +23 -0
  11. package/agent-docs/references/assertion-reference.md +652 -0
  12. package/agent-docs/references/capability-reference.md +3279 -0
  13. package/agent-docs/references/capture-the-frame.md +53 -0
  14. package/agent-docs/references/ctx-cookbook.md +51 -0
  15. package/agent-docs/references/debug-surface.md +63 -0
  16. package/agent-docs/references/finding-assets.md +147 -0
  17. package/agent-docs/references/gameplay-recipes.md +54 -0
  18. package/agent-docs/references/menu-screens.md +69 -0
  19. package/agent-docs/references/mobile-memory-budget.md +87 -0
  20. package/agent-docs/references/sculpt-from-a-reference.md +39 -0
  21. package/agent-docs/references/visual-baseline.md +133 -0
  22. package/agent-docs/references/webview-ui.md +113 -0
  23. package/agent-docs/sculpt-loop.md +16 -0
  24. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  25. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  26. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  27. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  28. package/agent-files/.threenative/agents/builder.md +32 -0
  29. package/agent-files/.threenative/agents/verifier.md +31 -0
  30. package/agent-files/AGENT-ROLES.md +26 -0
  31. package/capabilities.json +3542 -0
  32. package/dist/index.d.ts +191 -3
  33. package/dist/index.js +1707 -73
  34. package/dist/threenative.d.ts +9 -2
  35. package/dist/threenative.js +1825 -148
  36. package/package.json +30 -6
  37. package/template-assets/loading.ts +315 -0
  38. package/template-assets/patches/three@0.185.1.patch +287 -0
  39. package/templates/action-rpg/.codex/config.toml +15 -0
  40. package/templates/action-rpg/.mcp.json +6 -2
  41. package/templates/action-rpg/AGENTS.md +370 -6
  42. package/templates/action-rpg/CLAUDE.md +370 -6
  43. package/templates/action-rpg/index.html +0 -1
  44. package/templates/action-rpg/package.json +15 -11
  45. package/templates/action-rpg/playtests/combat.playtest.json +23 -9
  46. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  47. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  48. package/templates/action-rpg/playtests/performance.playtest.json +22 -0
  49. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  50. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  51. package/templates/action-rpg/public/icon.png +0 -0
  52. package/templates/action-rpg/src/entities/Enemy.ts +14 -4
  53. package/templates/action-rpg/src/game.ts +21 -0
  54. package/templates/action-rpg/src/render/lighting.ts +6 -1
  55. package/templates/action-rpg/src/render/loading.ts +267 -42
  56. package/templates/action-rpg/src/render/postprocessing.ts +68 -15
  57. package/templates/action-rpg/src/render/worldEnvironment.ts +583 -0
  58. package/templates/action-rpg/src/scenes/Play.ts +49 -19
  59. package/templates/action-rpg/src/state.ts +4 -0
  60. package/templates/action-rpg/src/style.css +45 -1
  61. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  62. package/templates/action-rpg/src/ui/App.tsx +9 -8
  63. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  64. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  65. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  66. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  67. package/templates/action-rpg/src/ui/main.tsx +14 -0
  68. package/templates/action-rpg/threenative.config.ts +21 -8
  69. package/templates/action-rpg/vite.config.ts +32 -2
  70. package/templates/defense/.codex/config.toml +15 -0
  71. package/templates/defense/.mcp.json +6 -2
  72. package/templates/defense/AGENTS.md +371 -8
  73. package/templates/defense/CLAUDE.md +371 -8
  74. package/templates/defense/README.md +2 -1
  75. package/templates/defense/index.html +0 -1
  76. package/templates/defense/package.json +16 -12
  77. package/templates/defense/playtests/leak.playtest.json +9 -4
  78. package/templates/defense/playtests/performance.playtest.json +22 -0
  79. package/templates/defense/playtests/placement.playtest.json +5 -5
  80. package/templates/defense/playtests/pointer-placement.playtest.json +89 -0
  81. package/templates/defense/playtests/scan.playtest.json +3 -3
  82. package/templates/defense/playtests/survive.playtest.json +11 -6
  83. package/templates/defense/public/icon.png +0 -0
  84. package/templates/defense/src/attackers/Attacker.ts +28 -12
  85. package/templates/defense/src/game.ts +24 -2
  86. package/templates/defense/src/render/lighting.ts +6 -1
  87. package/templates/defense/src/render/loading.ts +263 -37
  88. package/templates/defense/src/render/postprocessing.ts +70 -13
  89. package/templates/defense/src/render/shapes.ts +38 -0
  90. package/templates/defense/src/render/worldEnvironment.ts +583 -0
  91. package/templates/defense/src/scenes/Defense.ts +109 -50
  92. package/templates/defense/src/state.ts +6 -0
  93. package/templates/defense/src/style.css +45 -1
  94. package/templates/defense/src/ui/App.tsx +9 -4
  95. package/templates/defense/src/ui/GameUi.tsx +20 -0
  96. package/templates/defense/src/ui/Hud.tsx +6 -5
  97. package/templates/defense/src/ui/main.tsx +14 -0
  98. package/templates/defense/threenative.config.ts +21 -8
  99. package/templates/defense/vite.config.ts +34 -1
  100. package/templates/minimal/.codex/config.toml +15 -0
  101. package/templates/minimal/.mcp.json +6 -2
  102. package/templates/minimal/AGENTS.md +360 -255
  103. package/templates/minimal/CLAUDE.md +360 -255
  104. package/templates/minimal/index.html +0 -1
  105. package/templates/minimal/package.json +14 -11
  106. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  107. package/templates/minimal/playtests/play.playtest.json +17 -5
  108. package/templates/minimal/public/icon.png +0 -0
  109. package/templates/minimal/src/game.ts +1 -0
  110. package/templates/minimal/src/render/camera.ts +1 -1
  111. package/templates/minimal/src/render/hud.ts +24 -8
  112. package/templates/minimal/src/render/lighting.ts +23 -2
  113. package/templates/minimal/src/render/loading.ts +23 -103
  114. package/templates/minimal/src/render/postprocessing.ts +92 -14
  115. package/templates/minimal/src/render/sky.ts +37 -32
  116. package/templates/minimal/src/render/worldEnvironment.ts +583 -0
  117. package/templates/minimal/src/scenes/Play.ts +91 -13
  118. package/templates/minimal/src/state.ts +8 -1
  119. package/templates/minimal/threenative.config.ts +15 -10
  120. package/templates/minimal/vite.config.ts +28 -1
  121. package/templates/platformer/.codex/config.toml +15 -0
  122. package/templates/platformer/.mcp.json +6 -2
  123. package/templates/platformer/AGENTS.md +385 -130
  124. package/templates/platformer/CLAUDE.md +385 -130
  125. package/templates/platformer/index.html +0 -1
  126. package/templates/platformer/package.json +17 -14
  127. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  128. package/templates/platformer/playtests/branding.playtest.json +29 -0
  129. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  130. package/templates/platformer/playtests/collect.playtest.json +1 -1
  131. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  132. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  133. package/templates/platformer/playtests/damage.playtest.json +4 -1
  134. package/templates/platformer/playtests/dash.playtest.json +2 -2
  135. package/templates/platformer/playtests/jump.playtest.json +2 -3
  136. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  137. package/templates/platformer/playtests/oneway.playtest.json +1 -1
  138. package/templates/platformer/playtests/performance.playtest.json +6 -5
  139. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  140. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  141. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  142. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +13 -4
  143. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  144. package/templates/platformer/playtests/touch-controls-web.playtest.json +46 -0
  145. package/templates/platformer/public/icon.png +0 -0
  146. package/templates/platformer/src/entities/Character.ts +16 -10
  147. package/templates/platformer/src/entities/Patrol.ts +5 -0
  148. package/templates/platformer/src/game.ts +24 -1
  149. package/templates/platformer/src/render/lighting.ts +6 -1
  150. package/templates/platformer/src/render/loading.ts +270 -61
  151. package/templates/platformer/src/render/postprocessing.ts +68 -15
  152. package/templates/platformer/src/render/touch-controls.ts +54 -36
  153. package/templates/platformer/src/render/worldEnvironment.ts +583 -0
  154. package/templates/platformer/src/scenes/Level.ts +47 -22
  155. package/templates/platformer/src/state.ts +4 -0
  156. package/templates/platformer/src/style.css +45 -1
  157. package/templates/platformer/src/ui/App.tsx +9 -4
  158. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  159. package/templates/platformer/src/ui/Hud.tsx +6 -5
  160. package/templates/platformer/src/ui/main.tsx +14 -0
  161. package/templates/platformer/threenative.config.ts +20 -10
  162. package/templates/platformer/vite.config.ts +34 -1
  163. package/templates/racing/.codex/config.toml +15 -0
  164. package/templates/racing/.mcp.json +6 -2
  165. package/templates/racing/AGENTS.md +370 -6
  166. package/templates/racing/CLAUDE.md +370 -6
  167. package/templates/racing/index.html +0 -1
  168. package/templates/racing/package.json +16 -12
  169. package/templates/racing/playtests/boost.playtest.json +5 -5
  170. package/templates/racing/playtests/outcome.playtest.json +14 -4
  171. package/templates/racing/playtests/performance.playtest.json +22 -0
  172. package/templates/racing/playtests/ranking.playtest.json +2 -2
  173. package/templates/racing/playtests/rescue.playtest.json +12 -6
  174. package/templates/racing/playtests/reverse.playtest.json +3 -3
  175. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  176. package/templates/racing/public/icon.png +0 -0
  177. package/templates/racing/src/game.ts +24 -1
  178. package/templates/racing/src/render/camera.ts +10 -6
  179. package/templates/racing/src/render/lighting.ts +6 -1
  180. package/templates/racing/src/render/loading.ts +291 -34
  181. package/templates/racing/src/render/postprocessing.ts +70 -13
  182. package/templates/racing/src/render/worldEnvironment.ts +583 -0
  183. package/templates/racing/src/scenes/Race.ts +68 -36
  184. package/templates/racing/src/state.ts +4 -0
  185. package/templates/racing/src/style.css +45 -1
  186. package/templates/racing/src/track/Lap.ts +20 -9
  187. package/templates/racing/src/track/Ranking.ts +53 -14
  188. package/templates/racing/src/track/Track.ts +29 -16
  189. package/templates/racing/src/track/TrackSector.ts +14 -4
  190. package/templates/racing/src/ui/App.tsx +9 -4
  191. package/templates/racing/src/ui/GameUi.tsx +20 -0
  192. package/templates/racing/src/ui/Hud.tsx +6 -5
  193. package/templates/racing/src/ui/main.tsx +14 -0
  194. package/templates/racing/threenative.config.ts +21 -8
  195. package/templates/racing/vite.config.ts +34 -1
  196. package/templates/sailing/.codex/config.toml +15 -0
  197. package/templates/sailing/.mcp.json +20 -0
  198. package/templates/sailing/AGENTS.md +388 -0
  199. package/templates/sailing/CLAUDE.md +390 -0
  200. package/templates/sailing/README.md +25 -0
  201. package/templates/sailing/index.html +12 -0
  202. package/templates/sailing/kit.json +7 -0
  203. package/templates/sailing/native-playtests/survives.playtest.json +21 -0
  204. package/templates/sailing/package.json +52 -0
  205. package/templates/sailing/playtests/fail.playtest.json +24 -0
  206. package/templates/sailing/playtests/performance.playtest.json +21 -0
  207. package/templates/sailing/playtests/survives.playtest.json +38 -0
  208. package/templates/sailing/playtests/win.playtest.json +31 -0
  209. package/templates/sailing/public/favicon.svg +5 -0
  210. package/templates/sailing/public/icon.png +0 -0
  211. package/templates/sailing/src/entities/Ship.ts +96 -0
  212. package/templates/sailing/src/game.ts +40 -0
  213. package/templates/sailing/src/main.ts +15 -0
  214. package/templates/sailing/src/render/camera.ts +21 -0
  215. package/templates/sailing/src/render/lighting.ts +36 -0
  216. package/templates/sailing/src/render/loading.ts +315 -0
  217. package/templates/sailing/src/render/materials.ts +28 -0
  218. package/templates/sailing/src/render/palette.ts +24 -0
  219. package/templates/sailing/src/render/postprocessing.ts +33 -0
  220. package/templates/sailing/src/render/props.ts +52 -0
  221. package/templates/sailing/src/render/sky.ts +32 -0
  222. package/templates/sailing/src/render/water-material.ts +14 -0
  223. package/templates/sailing/src/render/water-shaders.ts +12 -0
  224. package/templates/sailing/src/render/wave-nodes.ts +10 -0
  225. package/templates/sailing/src/render/worldEnvironment.ts +590 -0
  226. package/templates/sailing/src/scenes/Boot.ts +12 -0
  227. package/templates/sailing/src/scenes/Sailing.ts +106 -0
  228. package/templates/sailing/src/state.ts +10 -0
  229. package/templates/sailing/src/style.css +61 -0
  230. package/templates/sailing/src/ui/App.tsx +15 -0
  231. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  232. package/templates/sailing/src/ui/Hud.tsx +55 -0
  233. package/templates/sailing/src/ui/Menu.tsx +30 -0
  234. package/templates/sailing/src/ui/main.tsx +7 -0
  235. package/templates/sailing/tailwind.config.ts +2 -0
  236. package/templates/sailing/threenative.config.ts +34 -0
  237. package/templates/sailing/tsconfig.json +17 -0
  238. package/templates/sailing/vite.config.ts +34 -0
  239. package/templates/shooter/.codex/config.toml +15 -0
  240. package/templates/shooter/.mcp.json +6 -2
  241. package/templates/shooter/AGENTS.md +373 -7
  242. package/templates/shooter/CLAUDE.md +373 -7
  243. package/templates/shooter/index.html +0 -1
  244. package/templates/shooter/package.json +16 -11
  245. package/templates/shooter/playtests/fail.playtest.json +5 -4
  246. package/templates/shooter/playtests/input-control.playtest.json +131 -0
  247. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  248. package/templates/shooter/playtests/performance.playtest.json +22 -0
  249. package/templates/shooter/playtests/shooter.playtest.json +22 -18
  250. package/templates/shooter/playtests/survives.playtest.json +1 -1
  251. package/templates/shooter/public/favicon.svg +1 -1
  252. package/templates/shooter/public/icon.png +0 -0
  253. package/templates/shooter/src/game.ts +24 -1
  254. package/templates/shooter/src/main.ts +3 -13
  255. package/templates/shooter/src/render/camera.ts +62 -12
  256. package/templates/shooter/src/render/lighting.ts +6 -1
  257. package/templates/shooter/src/render/loading.ts +262 -33
  258. package/templates/shooter/src/render/palette.ts +1 -1
  259. package/templates/shooter/src/render/postprocessing.ts +68 -16
  260. package/templates/shooter/src/render/shapes.ts +178 -0
  261. package/templates/shooter/src/render/ui.css +34 -1
  262. package/templates/shooter/src/render/worldEnvironment.ts +583 -0
  263. package/templates/shooter/src/scenes/Play.ts +246 -73
  264. package/templates/shooter/src/state.ts +13 -0
  265. package/templates/shooter/src/style.css +26 -0
  266. package/templates/shooter/src/ui/App.tsx +10 -12
  267. package/templates/shooter/src/ui/GameUi.tsx +20 -0
  268. package/templates/shooter/src/ui/Hud.tsx +8 -10
  269. package/templates/shooter/src/ui/Menu.tsx +24 -9
  270. package/templates/shooter/src/ui/main.tsx +15 -0
  271. package/templates/shooter/src/weapons/Projectile.ts +21 -10
  272. package/templates/shooter/threenative.config.ts +21 -8
  273. package/templates/shooter/vite.config.ts +32 -2
  274. package/templates/starter/.codex/config.toml +15 -0
  275. package/templates/starter/.mcp.json +6 -2
  276. package/templates/starter/AGENTS.md +429 -326
  277. package/templates/starter/CLAUDE.md +429 -326
  278. package/templates/starter/assets/pickup.wav +0 -0
  279. package/templates/starter/gitignore +4 -0
  280. package/templates/starter/index.html +0 -1
  281. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  282. package/templates/starter/native-playtests/render-chain.playtest.json +12 -0
  283. package/templates/starter/package.json +16 -12
  284. package/templates/starter/playtests/assets.playtest.json +65 -0
  285. package/templates/starter/playtests/buffer.playtest.json +59 -9
  286. package/templates/starter/playtests/cloth.playtest.json +113 -0
  287. package/templates/starter/playtests/coyote.playtest.json +60 -8
  288. package/templates/starter/playtests/forward.playtest.json +29 -4
  289. package/templates/starter/playtests/gameover.playtest.json +66 -0
  290. package/templates/starter/playtests/goal.playtest.json +67 -0
  291. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  292. package/templates/starter/playtests/look.playtest.json +34 -6
  293. package/templates/starter/playtests/models-baseline.png +0 -0
  294. package/templates/starter/playtests/models.playtest.json +74 -0
  295. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  296. package/templates/starter/playtests/odometer.playtest.json +54 -0
  297. package/templates/starter/playtests/pause.playtest.json +27 -4
  298. package/templates/starter/playtests/play.playtest.json +43 -7
  299. package/templates/starter/playtests/respawn.playtest.json +46 -6
  300. package/templates/starter/playtests/restart.playtest.json +65 -10
  301. package/templates/starter/playtests/seed.playtest.json +44 -8
  302. package/templates/starter/playtests/survives.playtest.json +27 -4
  303. package/templates/starter/playtests/textures-baseline.png +0 -0
  304. package/templates/starter/playtests/textures.playtest.json +74 -0
  305. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  306. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  307. package/templates/starter/public/icon.png +0 -0
  308. package/templates/starter/src/entities/Goal.ts +122 -0
  309. package/templates/starter/src/entities/Player.ts +40 -2
  310. package/templates/starter/src/game.ts +25 -0
  311. package/templates/starter/src/render/camera.ts +31 -5
  312. package/templates/starter/src/render/easing.ts +5 -0
  313. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  314. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  315. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  316. package/templates/starter/src/render/lighting.ts +6 -1
  317. package/templates/starter/src/render/loading.ts +315 -0
  318. package/templates/starter/src/render/materials.ts +17 -1
  319. package/templates/starter/src/render/pennant.ts +54 -0
  320. package/templates/starter/src/render/postprocessing.ts +46 -15
  321. package/templates/starter/src/render/scenery.ts +83 -0
  322. package/templates/starter/src/render/shapes.ts +9 -21
  323. package/templates/starter/src/render/worldEnvironment.ts +583 -0
  324. package/templates/starter/src/scenes/Play.ts +146 -36
  325. package/templates/starter/src/state.ts +12 -0
  326. package/templates/starter/src/style.css +45 -1
  327. package/templates/starter/src/ui/App.tsx +9 -6
  328. package/templates/starter/src/ui/GameUi.tsx +20 -0
  329. package/templates/starter/src/ui/Hud.tsx +52 -29
  330. package/templates/starter/src/ui/Menu.tsx +25 -23
  331. package/templates/starter/src/ui/main.tsx +14 -0
  332. package/templates/starter/threenative.config.ts +27 -9
  333. package/templates/starter/tools/look.mjs +109 -0
  334. package/templates/starter/vite.config.ts +32 -2
  335. package/templates/minimal/assets/.gitkeep +0 -0
  336. package/templates/minimal/public/.gitkeep +0 -0
  337. package/templates/platformer/assets/.gitkeep +0 -0
  338. package/templates/platformer/public/.gitkeep +0 -0
  339. package/templates/starter/assets/.gitkeep +0 -0
  340. package/templates/starter/public/.gitkeep +0 -0
  341. package/templates/starter/public/pickup.ogg +0 -0
  342. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  343. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -1,6 +1,14 @@
1
- import { type ICtx, Scene, type SceneFrame } from "@threenative/core";
1
+ import {
2
+ Billboard3D,
3
+ CameraShake,
4
+ type ICtx,
5
+ Scene,
6
+ type SceneFrame,
7
+ SpriteAnimator3D,
8
+ isMobile,
9
+ } from "@threenative/core";
2
10
  import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
- import { type Mesh, type PerspectiveCamera, Vector3 } from "three";
11
+ import { Mesh, MeshBasicMaterial, type PerspectiveCamera, Quaternion, Vector3 } from "three";
4
12
  import { applyDirectDamage, applyRadiusDamage } from "../combat/damage.js";
5
13
  import { Pickup } from "../entities/Pickup.js";
6
14
  import {
@@ -13,13 +21,19 @@ import {
13
21
  } from "../entities/Player.js";
14
22
  import { Target } from "../entities/Target.js";
15
23
  import { SpawnPoints } from "../level/SpawnPoints.js";
24
+ import type { IRayHit } from "../physics.js";
16
25
  import { emitPlaytestEvent } from "../playtest-events.js";
17
- import { createArenaCamera } from "../render/camera.js";
26
+ import { createArenaCamera, createArenaShakeOptions } from "../render/camera.js";
18
27
  import { setupLighting } from "../render/lighting.js";
19
28
  import { createLoadingScreen } from "../render/loading.js";
20
29
  import { createMaterials } from "../render/materials.js";
21
30
  import { setupPost } from "../render/postprocessing.js";
22
- import { createArena, createFriendlyVisual, createWallVisual } from "../render/shapes.js";
31
+ import {
32
+ PICKUP_SPRITE_FRAMES,
33
+ createArena,
34
+ createFriendlyVisual,
35
+ createWallVisual,
36
+ } from "../render/shapes.js";
23
37
  import { setupSky } from "../render/sky.js";
24
38
  import type { GameState } from "../state.js";
25
39
  import { WaveDirector } from "../waves.js";
@@ -29,6 +43,10 @@ import { Projectile } from "../weapons/Projectile.js";
29
43
  export type GameCtx = ICtx<GameState, IPhysicsContext>;
30
44
 
31
45
  const AIM = new Vector3(0, 0, -1);
46
+ const UP = new Vector3(0, 1, 0);
47
+ // Relative mouse pixels to radians. Mouse look is applied per pixel moved, not per second —
48
+ // the delta is already frame-rate independent, so no dt scaling.
49
+ const LOOK_RADIANS_PER_PIXEL = 0.005;
32
50
  const DEMO_POSITION = new Vector3(0, 0.85, -4);
33
51
  const WAVE_POSITION = new Vector3(0, 0.9, -9);
34
52
  const SCAN_POSITION = new Vector3(3, 0.9, 0);
@@ -40,11 +58,22 @@ const SPAWN_POINTS = new SpawnPoints([
40
58
  ]);
41
59
 
42
60
  type TargetEntry = { readonly id: string; readonly target: Target };
61
+ type ProjectileEntry = {
62
+ readonly collisionMask: number;
63
+ readonly id: string;
64
+ readonly value: Projectile;
65
+ };
43
66
 
44
67
  export class Play extends Scene<GameState, IPhysicsContext> {
45
68
  static override readonly initialState: GameState = {
69
+ paused: false,
70
+ uiReady: false,
71
+ aimedShots: 0,
72
+ aiming: 0,
46
73
  armor: 0,
74
+ cameraShakes: 0,
47
75
  deaths: 0,
76
+ demoDamage: 0,
48
77
  demoTargetAlive: 1,
49
78
  friendlyPassed: 0,
50
79
  gameOver: 0,
@@ -55,6 +84,9 @@ export class Play extends Scene<GameState, IPhysicsContext> {
55
84
  hitNormalYPercent: -101,
56
85
  hitNormalZPercent: -101,
57
86
  lives: 3,
87
+ nameplateFacingCamera: 0,
88
+ pickupFrame: 0,
89
+ pickupFrameChanges: 0,
58
90
  pickups: 0,
59
91
  radiusInsideDeaths: 0,
60
92
  radiusMidAlive: 1,
@@ -63,10 +95,12 @@ export class Play extends Scene<GameState, IPhysicsContext> {
63
95
  respawns: 0,
64
96
  scanCount: 0,
65
97
  score: 0,
98
+ shotsFired: 0,
66
99
  targetsRemaining: 1,
67
100
  wave: 1,
68
101
  wavesCleared: 0,
69
102
  wallBlocked: 0,
103
+ yawDegrees: 0,
70
104
  phase: "playing",
71
105
  };
72
106
 
@@ -74,11 +108,24 @@ export class Play extends Scene<GameState, IPhysicsContext> {
74
108
  const camera = ctx.camera as PerspectiveCamera;
75
109
  const materials = createMaterials();
76
110
  setupSky(ctx.scene);
77
- setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
78
- setupPost(ctx.renderer, ctx.scene, camera);
111
+ const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
112
+ // isMobile() arrives as an argument because src/render/ imports no framework package: the
113
+ // platform decision is made here, in portable game code, exactly like createRandom.
114
+ setupPost(ctx.renderer, ctx.scene, camera, { godraysLight: sun, mobile: isMobile() });
79
115
  const loading = createLoadingScreen(ctx);
80
116
  ctx.add(camera);
81
- const rig = createArenaCamera(camera);
117
+ const shake = new CameraShake(createArenaShakeOptions());
118
+ const rig = createArenaCamera(camera, shake);
119
+ const billboards: Billboard3D[] = [];
120
+ const billboardFront = new Vector3(0, 0, 1);
121
+ const billboardExpected = new Vector3();
122
+ const billboardCameraPosition = new Vector3();
123
+ const billboardObjectPosition = new Vector3();
124
+ const billboardUp = new Vector3(0, 1, 0);
125
+ const billboardExpectedUp = new Vector3();
126
+ const billboardCameraQuaternion = new Quaternion();
127
+ const billboardWorldQuaternion = new Quaternion();
128
+ const spriteAnimators: SpriteAnimator3D[] = [];
82
129
  ctx.viewport.resize();
83
130
 
84
131
  const arena = createArena(materials);
@@ -102,33 +149,54 @@ export class Play extends Scene<GameState, IPhysicsContext> {
102
149
  };
103
150
  const targets = new Map<number, Target>();
104
151
  const waveTargets: TargetEntry[] = [];
105
- const projectiles: Array<{ readonly id: string; readonly value: Projectile }> = [];
152
+ const projectiles: ProjectileEntry[] = [];
153
+ const targetScratch: Target[] = [];
106
154
  let projectileIndex = 0;
107
155
  const waveDirector = new WaveDirector();
108
156
  const hitscan = new Hitscan();
109
157
  const spawnPoints = SPAWN_POINTS;
110
158
  const elapsed = { value: 0 };
159
+ // Look state: relative mouse pixels accumulate here, the camera rig orbits by it, and the
160
+ // aim direction rotates with it. Reported through ctx.state so a playtest can observe the
161
+ // rotation after the real input path.
162
+ const lookState = { yaw: 0 };
163
+ const aimDirection = new Vector3();
164
+ const enemyDirection = new Vector3();
165
+ const aimForward = (): Vector3 => aimDirection.copy(AIM).applyAxisAngle(UP, -lookState.yaw);
111
166
 
112
- const createEnemyProjectile = (origin: Vector3): void => {
113
- const direction = getPlayer().mesh.position.clone().sub(origin).normalize();
114
- const id = `projectile.enemy.${projectileIndex++}`;
115
- const projectile = new Projectile(
116
- ctx,
117
- materials,
118
- origin,
119
- direction,
120
- WORLD_LAYER | PLAYER_LAYER,
121
- (hit) => {
122
- if (hit.body.id === getPlayer().body.body.id) {
123
- getPlayer().takeDamage(20);
124
- emitPlaytestEvent({ entity: "player", name: "projectile-hit" });
125
- }
126
- },
127
- );
128
- projectiles.push({ id, value: projectile });
167
+ const onEnemyProjectileHit = (hit: IRayHit): void => {
168
+ if (hit.body.id === getPlayer().body.body.id) {
169
+ getPlayer().takeDamage(20);
170
+ emitPlaytestEvent({ entity: "player", name: "projectile-hit" });
171
+ }
172
+ };
173
+ const onPlayerProjectileHit = (hit: IRayHit): void => {
174
+ if (applyDirectDamage(targets, hit.body.id, 22))
175
+ emitPlaytestEvent({ entity: "player", name: "projectile-defeated" });
176
+ };
177
+
178
+ const acquireProjectile = (
179
+ origin: Vector3,
180
+ direction: Vector3,
181
+ collisionMask: number,
182
+ onHit: (hit: IRayHit) => void,
183
+ ): void => {
184
+ for (const entry of projectiles) {
185
+ if (!entry.value.dead || entry.collisionMask !== collisionMask) continue;
186
+ entry.value.reset(origin, direction, onHit);
187
+ return;
188
+ }
189
+ const id = `projectile.pool.${projectileIndex++}`;
190
+ const projectile = new Projectile(ctx, materials, origin, direction, collisionMask, onHit);
191
+ projectiles.push({ collisionMask, id, value: projectile });
129
192
  ctx.entities.add(id, projectile);
130
193
  };
131
194
 
195
+ const createEnemyProjectile = (origin: Vector3): void => {
196
+ const direction = enemyDirection.copy(getPlayer().mesh.position).sub(origin).normalize();
197
+ acquireProjectile(origin, direction, WORLD_LAYER | PLAYER_LAYER, onEnemyProjectileHit);
198
+ };
199
+
132
200
  const registerTarget = (
133
201
  id: string,
134
202
  position: Vector3,
@@ -139,6 +207,10 @@ export class Play extends Scene<GameState, IPhysicsContext> {
139
207
  ...options,
140
208
  onFire: options.onFire ?? createEnemyProjectile,
141
209
  });
210
+ const nameplate = target.mesh.getObjectByName("target-nameplate");
211
+ if (nameplate === undefined)
212
+ throw new Error("Shooter target visual is missing its target-nameplate.");
213
+ billboards.push(new Billboard3D(nameplate, { camera }));
142
214
  targets.set(target.body.body.id, target);
143
215
  ctx.entities.add(id, target);
144
216
  if (scan) target.startScanning(ctx, getPlayer().body.body.id);
@@ -169,7 +241,9 @@ export class Play extends Scene<GameState, IPhysicsContext> {
169
241
  if (lives === 0) return;
170
242
  ctx.after(0.5, () => {
171
243
  waveDirector.reset();
172
- const spawn = spawnPoints.furthestFrom(waveTargets.map(({ target }) => target));
244
+ targetScratch.length = 0;
245
+ for (const entry of waveTargets) targetScratch.push(entry.target);
246
+ const spawn = spawnPoints.furthestFrom(targetScratch);
173
247
  getPlayer().respawn(spawn);
174
248
  const state = ctx.state.getState();
175
249
  ctx.state.set({
@@ -257,6 +331,17 @@ export class Play extends Scene<GameState, IPhysicsContext> {
257
331
  },
258
332
  );
259
333
  ctx.entities.add("health-pickup", pickup);
334
+ const pickupAnimation = pickup.mesh.getObjectByName("pickup-animation");
335
+ if (
336
+ !(pickupAnimation instanceof Mesh) ||
337
+ !(pickupAnimation.material instanceof MeshBasicMaterial)
338
+ )
339
+ throw new Error("Shooter pickup visual is missing its animated sprite material.");
340
+ if (pickupAnimation.material.map === null)
341
+ throw new Error("Shooter pickup animated sprite is missing its atlas texture.");
342
+ spriteAnimators.push(
343
+ new SpriteAnimator3D({ frames: PICKUP_SPRITE_FRAMES, texture: pickupAnimation.material.map }),
344
+ );
260
345
 
261
346
  const spawnWave = (wave: number): void => {
262
347
  const target = registerTarget(`wave.target.${wave}`, WAVE_POSITION.clone(), {
@@ -270,18 +355,21 @@ export class Play extends Scene<GameState, IPhysicsContext> {
270
355
  waveDirector.start(spawnWave);
271
356
  rig.snap(player.mesh.position);
272
357
 
273
- const fireHitscan = (): void => {
274
- const hit = hitscan.fire(ctx.physics, player.aimOrigin(), AIM, HOSTILE_LAYER);
275
- if (hit === undefined) return;
276
- const state = ctx.state.getState();
358
+ const resolveHitscanImpact = (
359
+ hit: NonNullable<ReturnType<typeof hitscan.fire>>,
360
+ state: GameState,
361
+ ): void => {
277
362
  const target = targets.get(hit.body.id);
278
363
  if (target !== undefined) applyDirectDamage(targets, hit.body.id, 40);
279
364
  const demoHit = hit.body.id === demo.body.body.id;
365
+ shake.trigger();
280
366
  ctx.state.set({
367
+ cameraShakes: state.cameraShakes + 1,
281
368
  demoTargetAlive: demo.alive ? 1 : 0,
282
369
  friendlyPassed: demoHit && friendlyBody.body.id !== hit.body.id ? 1 : state.friendlyPassed,
283
370
  ...(demoHit
284
371
  ? {
372
+ demoDamage: state.demoDamage + 40,
285
373
  hitDistanceTenths: Math.round(hit.distance * 10),
286
374
  hitNormalXPercent: Math.round(hit.normal.x * 100),
287
375
  hitNormalYPercent: Math.round(hit.normal.y * 100),
@@ -297,28 +385,36 @@ export class Play extends Scene<GameState, IPhysicsContext> {
297
385
  if (target?.alive === false) emitPlaytestEvent({ entity: "target", name: "defeated" });
298
386
  };
299
387
 
388
+ const fireHitscan = (whileAiming: boolean): void => {
389
+ const state = ctx.state.getState();
390
+ const originOffset = player
391
+ .aimOrigin()
392
+ .sub(player.mesh.position)
393
+ .applyAxisAngle(UP, -lookState.yaw)
394
+ .add(player.mesh.position);
395
+ const hit = hitscan.fire(ctx.physics, originOffset, aimForward(), HOSTILE_LAYER);
396
+ ctx.state.set({
397
+ aimedShots: whileAiming ? state.aimedShots + 1 : state.aimedShots,
398
+ shotsFired: state.shotsFired + 1,
399
+ });
400
+ emitPlaytestEvent({ entity: "player", name: "fired", aimed: whileAiming ? 1 : 0 });
401
+ if (hit !== undefined) resolveHitscanImpact(hit, state);
402
+ };
403
+
300
404
  const fireProjectile = (): void => {
301
- const id = `projectile.player.${projectileIndex++}`;
302
- const projectile = new Projectile(
303
- ctx,
304
- materials,
405
+ acquireProjectile(
305
406
  player.aimOrigin(),
306
407
  AIM,
307
408
  HOSTILE_LAYER | WORLD_LAYER,
308
- (hit) => {
309
- if (applyDirectDamage(targets, hit.body.id, 22))
310
- emitPlaytestEvent({ entity: "player", name: "projectile-defeated" });
311
- },
409
+ onPlayerProjectileHit,
312
410
  );
313
- projectiles.push({ id, value: projectile });
314
- ctx.entities.add(id, projectile);
315
411
  };
316
412
 
317
413
  const fireRadius = (): void => {
318
414
  applyRadiusDamage(ctx.physics, BLAST_CENTRE, 3.5, 80, targets);
319
- const insideDeaths = [radiusNear, radiusMid].filter(
320
- (target) => target.alive === false,
321
- ).length;
415
+ let insideDeaths = 0;
416
+ if (!radiusNear.alive) insideDeaths += 1;
417
+ if (!radiusMid.alive) insideDeaths += 1;
322
418
  ctx.state.set({
323
419
  radiusInsideDeaths: insideDeaths,
324
420
  radiusMidAlive: radiusMid.alive ? 1 : 0,
@@ -359,8 +455,20 @@ export class Play extends Scene<GameState, IPhysicsContext> {
359
455
  return true;
360
456
  };
361
457
 
458
+ const handleAimEdges = (frameCtx: GameCtx): void => {
459
+ if (frameCtx.input.justPressed("aim")) {
460
+ ctx.state.set({ aiming: 1 });
461
+ emitPlaytestEvent({ entity: "player", name: "aim-engaged" });
462
+ }
463
+ if (frameCtx.input.justReleased("aim")) {
464
+ ctx.state.set({ aiming: 0 });
465
+ emitPlaytestEvent({ entity: "player", name: "aim-released" });
466
+ }
467
+ };
468
+
362
469
  const handleInput = (frameCtx: GameCtx): void => {
363
- if (frameCtx.input.justPressed("fire")) fireHitscan();
470
+ handleAimEdges(frameCtx);
471
+ if (frameCtx.input.justPressed("fire")) fireHitscan(frameCtx.input.pressed("aim"));
364
472
  if (frameCtx.input.justPressed("projectile")) fireProjectile();
365
473
  if (frameCtx.input.justPressed("blast")) fireRadius();
366
474
  if (frameCtx.input.justPressed("probe")) probeWall();
@@ -369,43 +477,96 @@ export class Play extends Scene<GameState, IPhysicsContext> {
369
477
  };
370
478
 
371
479
  const updateProjectiles = (frameCtx: GameCtx, dt: number): void => {
372
- for (const entry of [...projectiles]) {
373
- entry.value.update(frameCtx, dt);
374
- if (!entry.value.dead) continue;
375
- removeEntity(entry.id);
376
- projectiles.splice(projectiles.indexOf(entry), 1);
377
- }
480
+ for (const entry of projectiles) entry.value.update(frameCtx, dt);
378
481
  };
379
482
 
380
483
  const updateWaves = (frameCtx: GameCtx): void => {
381
- waveDirector.update(
382
- frameCtx,
383
- waveTargets.filter(({ target }) => target.alive).length,
384
- spawnWave,
385
- (wave) => {
386
- const state = frameCtx.state.getState();
387
- frameCtx.state.set({ score: state.score + 100, wavesCleared: waveDirector.cleared });
388
- emitPlaytestEvent({ entity: "wave", name: "cleared", wave });
389
- },
390
- );
484
+ let liveTargets = 0;
485
+ for (const entry of waveTargets) if (entry.target.alive) liveTargets += 1;
486
+ waveDirector.update(frameCtx, liveTargets, spawnWave, (wave) => {
487
+ const state = frameCtx.state.getState();
488
+ frameCtx.state.set({ score: state.score + 100, wavesCleared: waveDirector.cleared });
489
+ emitPlaytestEvent({ entity: "wave", name: "cleared", wave });
490
+ });
391
491
  if (waveDirector.won) frameCtx.state.set({ gameWon: 1, phase: "won" });
392
492
  };
393
493
 
494
+ const hudPatch: Partial<GameState> = {};
495
+ const lookPatch: Partial<GameState> = {};
496
+ let lastHealth = -1;
497
+ let lastScanCount = -1;
498
+ let lastTargetsRemaining = -1;
499
+ let lastWave = -1;
500
+ let lastWavesCleared = -1;
501
+ let lastPickupFrame = -1;
502
+ const pickupPatch: Partial<GameState> = {};
503
+ const nameplatePatch: Partial<GameState> = {};
504
+ const syncNameplateFacingCamera = (frameCtx: GameCtx): void => {
505
+ const nameplate = billboards[0]?.object;
506
+ if (nameplate === undefined) return;
507
+ nameplate.updateWorldMatrix(true, false);
508
+ camera.getWorldPosition(billboardCameraPosition);
509
+ nameplate.getWorldPosition(billboardObjectPosition);
510
+ billboardExpected.subVectors(billboardCameraPosition, billboardObjectPosition).normalize();
511
+ billboardFront
512
+ .set(0, 0, 1)
513
+ .applyQuaternion(nameplate.getWorldQuaternion(billboardWorldQuaternion));
514
+ camera.getWorldQuaternion(billboardCameraQuaternion);
515
+ billboardExpectedUp
516
+ .set(0, 1, 0)
517
+ .applyQuaternion(billboardCameraQuaternion)
518
+ .projectOnPlane(billboardExpected)
519
+ .normalize();
520
+ billboardUp
521
+ .set(0, 1, 0)
522
+ .applyQuaternion(nameplate.getWorldQuaternion(billboardWorldQuaternion));
523
+ const nameplateFacingCamera =
524
+ billboardFront.dot(billboardExpected) >= 0.999 &&
525
+ billboardUp.dot(billboardExpectedUp) >= 0.999
526
+ ? 1
527
+ : 0;
528
+ if (frameCtx.state.getState().nameplateFacingCamera === nameplateFacingCamera) return;
529
+ nameplatePatch.nameplateFacingCamera = nameplateFacingCamera;
530
+ frameCtx.state.set(nameplatePatch);
531
+ };
394
532
  const syncStateAndHud = (frameCtx: GameCtx): void => {
395
- const liveTargets = waveTargets.filter(({ target }) => target.alive).length;
396
- const currentScanCount = [...targets.values()].reduce(
397
- (sum, target) => sum + target.scanCount,
398
- 0,
399
- );
533
+ let liveTargets = 0;
534
+ for (const entry of waveTargets) if (entry.target.alive) liveTargets += 1;
535
+ let currentScanCount = 0;
536
+ for (const target of targets.values()) currentScanCount += target.scanCount;
400
537
  const previous = frameCtx.state.getState();
401
538
  const scanCount = Math.max(previous.scanCount, currentScanCount);
402
- frameCtx.state.set({
403
- health: player.health,
404
- scanCount,
405
- targetsRemaining: liveTargets,
406
- wave: waveDirector.wave,
407
- wavesCleared: waveDirector.cleared,
408
- });
539
+ const wave = waveDirector.wave;
540
+ const wavesCleared = waveDirector.cleared;
541
+ if (
542
+ player.health === lastHealth &&
543
+ scanCount === lastScanCount &&
544
+ liveTargets === lastTargetsRemaining &&
545
+ wave === lastWave &&
546
+ wavesCleared === lastWavesCleared
547
+ )
548
+ return;
549
+ lastHealth = player.health;
550
+ lastScanCount = scanCount;
551
+ lastTargetsRemaining = liveTargets;
552
+ lastWave = wave;
553
+ lastWavesCleared = wavesCleared;
554
+ hudPatch.health = player.health;
555
+ hudPatch.scanCount = scanCount;
556
+ hudPatch.targetsRemaining = liveTargets;
557
+ hudPatch.wave = wave;
558
+ hudPatch.wavesCleared = wavesCleared;
559
+ frameCtx.state.set(hudPatch);
560
+ };
561
+
562
+ // Relative mouse pixels accumulate here once per frame; the same yaw drives both the
563
+ // camera orbit and the aim direction, and the total is published for playtests.
564
+ const applyLook = (frameCtx: GameCtx): void => {
565
+ const look = frameCtx.input.vector("look");
566
+ if (look.x === 0) return;
567
+ lookState.yaw += look.x * LOOK_RADIANS_PER_PIXEL;
568
+ lookPatch.yawDegrees = Math.round((lookState.yaw * 180) / Math.PI);
569
+ ctx.state.set(lookPatch);
409
570
  };
410
571
 
411
572
  return (frameCtx, dt) => {
@@ -413,16 +574,28 @@ export class Play extends Scene<GameState, IPhysicsContext> {
413
574
  elapsed.value += dt;
414
575
  if (restart(frameCtx)) return;
415
576
  handleInput(frameCtx);
577
+ applyLook(frameCtx);
416
578
 
417
579
  player.update(frameCtx, dt);
418
580
  hitscan.update(dt);
419
581
  updateProjectiles(frameCtx, dt);
420
582
  for (const target of targets.values()) target.update(dt);
583
+ for (const animator of spriteAnimators) animator.update(dt);
584
+ const pickupFrame = spriteAnimators[0]?.frameIndex ?? 0;
585
+ if (pickupFrame !== lastPickupFrame) {
586
+ lastPickupFrame = pickupFrame;
587
+ const previous = frameCtx.state.getState();
588
+ pickupPatch.pickupFrame = pickupFrame;
589
+ pickupPatch.pickupFrameChanges = previous.pickupFrameChanges + 1;
590
+ frameCtx.state.set(pickupPatch);
591
+ }
421
592
  pickup.update(dt);
422
593
  removeDeadTargets();
423
594
  updateWaves(frameCtx);
424
595
  syncStateAndHud(frameCtx);
425
- rig.follow(player.mesh.position, dt);
596
+ rig.follow(player.mesh.position, dt, lookState.yaw);
597
+ for (const billboard of billboards) billboard.update();
598
+ syncNameplateFacingCamera(frameCtx);
426
599
  };
427
600
  }
428
601
  }
@@ -1,8 +1,16 @@
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;
4
10
  armor: number;
11
+ cameraShakes: number;
5
12
  deaths: number;
13
+ demoDamage: number;
6
14
  demoTargetAlive: number;
7
15
  friendlyPassed: number;
8
16
  gameOver: number;
@@ -13,6 +21,9 @@ export type GameState = {
13
21
  hitNormalYPercent: number;
14
22
  hitNormalZPercent: number;
15
23
  lives: number;
24
+ nameplateFacingCamera: number;
25
+ pickupFrame: number;
26
+ pickupFrameChanges: number;
16
27
  pickups: number;
17
28
  radiusInsideDeaths: number;
18
29
  radiusMidAlive: number;
@@ -21,9 +32,11 @@ export type GameState = {
21
32
  respawns: number;
22
33
  scanCount: number;
23
34
  score: number;
35
+ shotsFired: number;
24
36
  targetsRemaining: number;
25
37
  wave: number;
26
38
  wavesCleared: number;
27
39
  wallBlocked: number;
40
+ yawDegrees: number;
28
41
  phase: GamePhase;
29
42
  };
@@ -0,0 +1,26 @@
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
+ }
@@ -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,20 @@
1
+ import { UiLayer } from "@threenative/ui";
2
+ import { Hud } from "./Hud.js";
3
+ import { Menu } from "./Menu.js";
4
+
5
+ /**
6
+ * Everything the player sees that is not the scene.
7
+ *
8
+ * One component, mounted twice by two entries that differ only in what else is on the page:
9
+ * `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
10
+ * page the native web view loads. Keeping both entries pointed at this file is what makes "the
11
+ * same UI on every target" a fact rather than an intention.
12
+ */
13
+ export function GameUi() {
14
+ return (
15
+ <UiLayer>
16
+ <Hud />
17
+ <Menu />
18
+ </UiLayer>
19
+ );
20
+ }
@@ -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 { health, lives, 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>