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
@@ -0,0 +1,59 @@
1
+ {
2
+ "name": "per-item-mechanisms",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": { "width": 1280, "height": 720 },
6
+ "warmupFrames": 60,
7
+ "subject": "player",
8
+ "steps": [
9
+ { "kind": "wait", "label": "sprite-baseline", "waitTicks": 1, "release": true },
10
+ {
11
+ "kind": "input",
12
+ "label": "hit",
13
+ "press": "KeyF",
14
+ "holdTicks": 1,
15
+ "release": true
16
+ },
17
+ {
18
+ "kind": "wait",
19
+ "label": "shake-and-animation",
20
+ "waitTicks": 12,
21
+ "release": true
22
+ }
23
+ ],
24
+ "assert": {
25
+ "diagnostics": {
26
+ "noNetworkErrors": true,
27
+ "noRuntimeDiagnostics": false,
28
+ "runtimeDiagnosticsOptOutReason": "Headless Linux Chromium emits the known WebGPU buffer diagnostic; gameplay and mechanism assertions remain authoritative.",
29
+ "runtimeReady": true
30
+ },
31
+ "resources": [
32
+ {
33
+ "id": "state",
34
+ "path": "cameraShakes",
35
+ "atSteps": [{ "label": "hit", "equals": 1 }],
36
+ "changed": true
37
+ },
38
+ {
39
+ "id": "state",
40
+ "path": "nameplateFacingCamera",
41
+ "atSteps": [{ "label": "sprite-baseline", "equals": 1 }]
42
+ },
43
+ { "id": "state", "path": "pickupFrameChanges", "changed": true }
44
+ ],
45
+ "signals": [{ "name": "hit", "entity": "player", "minCount": 1, "atStep": "hit" }],
46
+ "visibility": [
47
+ {
48
+ "allowTrivial": "The shooter scene begins with the player visible and in frame; the hit and animation assertions prove the new mechanisms also ran.",
49
+ "entity": "player",
50
+ "minProjectedPixels": 20
51
+ }
52
+ ],
53
+ "movement": {
54
+ "entity": "camera.main",
55
+ "minDistance": 0.001,
56
+ "rotationChanged": true
57
+ }
58
+ }
59
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "acceptanceId": "prd-194-performance-shooter",
3
+ "artifacts": { "screenshots": false },
4
+ "assert": {
5
+ "performance": {
6
+ "maxDrawCalls": 295,
7
+ "maxFrameMsP95": 33,
8
+ "maxTriangles": 2500
9
+ },
10
+ "renderChain": { "tier": "high" }
11
+ },
12
+ "name": "production-performance",
13
+ "schemaVersion": 1,
14
+ "steps": [
15
+ { "kind": "input", "press": "ArrowRight", "holdTicks": 60, "release": true },
16
+ { "kind": "wait", "waitTicks": 600, "release": true }
17
+ ],
18
+ "subject": "player",
19
+ "target": "web",
20
+ "viewport": { "height": 1080, "width": 1920 },
21
+ "warmupFrames": 60
22
+ }
@@ -46,23 +46,23 @@
46
46
  "runtimeReady": true
47
47
  },
48
48
  "resources": [
49
- { "id": "GameState", "path": "hitDistanceTenths", "equals": 78, "changed": true },
50
- { "id": "GameState", "path": "hitNormalXPercent", "equals": 0, "changed": true },
51
- { "id": "GameState", "path": "hitNormalYPercent", "equals": 0, "changed": true },
52
- { "id": "GameState", "path": "hitNormalZPercent", "equals": 100, "changed": true },
53
- { "id": "GameState", "path": "friendlyPassed", "equals": 1, "changed": true },
54
- { "id": "GameState", "path": "wallBlocked", "equals": 1, "changed": true },
55
- { "id": "GameState", "path": "radiusInsideDeaths", "equals": 2, "changed": true },
56
- { "id": "GameState", "path": "radiusNearAlive", "equals": 0, "changed": true },
57
- { "id": "GameState", "path": "radiusMidAlive", "equals": 0, "changed": true },
58
- { "id": "GameState", "path": "radiusOutsideAlive", "equals": 1 },
59
- { "id": "GameState", "path": "scanCount", "gte": 100, "changed": true },
60
- { "id": "GameState", "path": "health", "atSteps": [{ "label": "damage", "equals": 65 }] },
61
- { "id": "GameState", "path": "deaths", "atSteps": [{ "label": "death", "equals": 1 }] },
62
- { "id": "GameState", "path": "respawns", "atSteps": [{ "label": "respawn", "equals": 1 }] },
63
- { "id": "GameState", "path": "pickups", "atSteps": [{ "label": "pickup", "equals": 1 }] },
64
- { "id": "GameState", "path": "wavesCleared", "equals": 5, "changed": true },
65
- { "id": "GameState", "path": "gameWon", "equals": 1, "changed": true }
49
+ { "id": "state", "path": "hitDistanceTenths", "equals": 78, "changed": true },
50
+ { "id": "state", "path": "hitNormalXPercent", "equals": 22, "changed": true },
51
+ { "id": "state", "path": "hitNormalYPercent", "equals": 0, "changed": true },
52
+ { "id": "state", "path": "hitNormalZPercent", "equals": 98, "changed": true },
53
+ { "id": "state", "path": "friendlyPassed", "equals": 1, "changed": true },
54
+ { "id": "state", "path": "wallBlocked", "equals": 1, "changed": true },
55
+ { "id": "state", "path": "radiusInsideDeaths", "equals": 2, "changed": true },
56
+ { "id": "state", "path": "radiusNearAlive", "equals": 0, "changed": true },
57
+ { "id": "state", "path": "radiusMidAlive", "equals": 0, "changed": true },
58
+ { "id": "state", "path": "radiusOutsideAlive", "equals": 1 },
59
+ { "id": "state", "path": "scanCount", "gte": 100, "changed": true },
60
+ { "id": "state", "path": "health", "atSteps": [{ "label": "damage", "equals": 65 }] },
61
+ { "id": "state", "path": "deaths", "atSteps": [{ "label": "death", "equals": 1 }] },
62
+ { "id": "state", "path": "respawns", "atSteps": [{ "label": "respawn", "equals": 1 }] },
63
+ { "id": "state", "path": "pickups", "atSteps": [{ "label": "pickup", "equals": 1 }] },
64
+ { "id": "state", "path": "wavesCleared", "equals": 5, "changed": true },
65
+ { "id": "state", "path": "gameWon", "equals": 1, "changed": true }
66
66
  ],
67
67
  "components": [
68
68
  {
@@ -82,7 +82,11 @@
82
82
  { "name": "cleared", "entity": "wave", "minCount": 5 }
83
83
  ],
84
84
  "visibility": [
85
- { "entity": "player", "minProjectedPixels": 20 },
85
+ {
86
+ "allowTrivial": "The shooter scene begins with the player visible and in frame; this held visibility row accompanies the combat assertions.",
87
+ "entity": "player",
88
+ "minProjectedPixels": 20
89
+ },
86
90
  { "entity": "demo-target", "present": false }
87
91
  ]
88
92
  }
@@ -3,7 +3,7 @@
3
3
  "target": "web",
4
4
  "schemaVersion": 1,
5
5
  "viewport": { "width": 1280, "height": 720 },
6
- "warmupFrames": 10,
6
+ "warmupFrames": 60,
7
7
  "subject": "player",
8
8
  "steps": [
9
9
  { "kind": "input", "label": "move", "press": "ArrowUp", "holdTicks": 60, "release": true },
@@ -1,4 +1,4 @@
1
1
  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
2
- <rect width="64" height="64" rx="14" fill="#090d13"/>
2
+ <rect width="64" height="64" rx="14" fill="#101820"/>
3
3
  <path d="M16 16h32v8H24v8h16v8H24v8h24v8H16z" fill="#f6c85f"/>
4
4
  </svg>
@@ -18,15 +18,18 @@ const game = defineGame<GameState, IPhysicsContext>({
18
18
  right: ["ArrowRight", "KeyD"],
19
19
  up: ["ArrowUp", "KeyW"],
20
20
  },
21
+ aim: { mouseButtons: [2] },
21
22
  blast: { keys: ["KeyE"], buttons: [2] },
22
23
  damage: { keys: ["KeyH"] },
23
- fire: { buttons: [0], keys: ["KeyF"], pointer: true },
24
+ fire: { buttons: [0], keys: ["KeyF"], mouseButtons: [0] },
25
+ look: { pointerRelative: true },
24
26
  lethal: { keys: ["KeyX"] },
25
27
  probe: { keys: ["KeyC"] },
26
28
  projectile: { buttons: [1], keys: ["KeyG"] },
27
29
  restart: { keys: ["KeyR"] },
28
30
  },
29
31
  plugins: [rapier(), replay(), playtest({ events: drainPlaytestEvents })],
32
+ display: config.display,
30
33
  render: config.renderer,
31
34
  scenes: { boot: Boot, play: Play },
32
35
  seed: 89089,
@@ -34,3 +37,23 @@ const game = defineGame<GameState, IPhysicsContext>({
34
37
  });
35
38
 
36
39
  export default game;
40
+
41
+ /**
42
+ * What the UI can ask the game to do.
43
+ *
44
+ * Intents are one-way and named by the game: the UI sends `restart`, `pause` or `resume` and the
45
+ * game decides what each means. Nothing comes back this way — the UI reads the game's published
46
+ * state instead, which keeps one source of truth on the side that owns the simulation.
47
+ */
48
+ game.ui.onIntent((intent) => {
49
+ if (intent === "restart") void game.goto("play");
50
+ if (intent === "pause") game.pause();
51
+ if (intent === "resume") game.resume();
52
+ game.state.set({
53
+ // `game.ui.connected` is true only once the UI announced itself, which is what tells an
54
+ // overlay that never came up apart from a game whose HUD is simply empty.
55
+ uiReady: game.ui.connected,
56
+ ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
57
+ });
58
+ game.state.flush();
59
+ });
@@ -1,21 +1,11 @@
1
1
  import { acceptHotUpdate } from "@threenative/core/hot";
2
- import { createElement, useState } from "react";
2
+ import { createElement } from "react";
3
3
  import { createRoot } from "react-dom/client";
4
4
  import game from "./game.js";
5
5
  import { App } from "./ui/App.js";
6
+ import "./style.css";
6
7
  import "./render/ui.css";
7
8
 
8
- function WebApp({ game: currentGame }: { game: typeof game }) {
9
- const [paused, setPaused] = useState(false);
10
- const onTogglePause = () => {
11
- if (paused) currentGame.resume();
12
- else currentGame.pause();
13
- setPaused((value) => !value);
14
- };
15
- const onRestart = () => void currentGame.goto("play");
16
- return createElement(App, { game: currentGame, onRestart, onTogglePause, paused });
17
- }
18
-
19
9
  import.meta.hot?.accept();
20
10
  acceptHotUpdate(game, import.meta.hot);
21
11
  const root = document.getElementById("root");
@@ -23,4 +13,4 @@ if (root === null) throw new Error("Missing #root element.");
23
13
  const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
24
14
  const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
25
15
  appRoot.__threenativeRoot = reactRoot;
26
- reactRoot.render(createElement(WebApp, { game }));
16
+ reactRoot.render(createElement(App, { game }));
@@ -2,28 +2,78 @@
2
2
  import type { PerspectiveCamera, Vector3 } from "three";
3
3
  import { Vector3 as Vec3 } from "three";
4
4
 
5
+ export interface ICameraShakeOffset {
6
+ readonly position: Vector3;
7
+ readonly rotation: Vector3;
8
+ }
9
+
10
+ export interface ICameraShakeLike {
11
+ readonly update: (dt: number) => ICameraShakeOffset;
12
+ }
13
+
14
+ export interface ICameraShakeOptions {
15
+ readonly amplitude: Vector3;
16
+ readonly rotationAmplitude: Vector3;
17
+ readonly frequency: number;
18
+ readonly decay: number;
19
+ readonly curve: (phase: number) => number;
20
+ }
21
+
5
22
  export interface ICameraRig {
6
- readonly follow: (target: Vector3, dt: number) => void;
7
- readonly snap: (target: Vector3) => void;
23
+ readonly follow: (target: Vector3, dt: number, yaw?: number) => void;
24
+ readonly snap: (target: Vector3, yaw?: number) => void;
8
25
  }
9
26
 
10
- export function createArenaCamera(camera: PerspectiveCamera): ICameraRig {
27
+ const UP = new Vec3(0, 1, 0);
28
+
29
+ function composeCameraShake(camera: PerspectiveCamera, offset: ICameraShakeOffset): void {
30
+ camera.position.add(offset.position);
31
+ camera.rotation.set(
32
+ camera.rotation.x + offset.rotation.x,
33
+ camera.rotation.y + offset.rotation.y,
34
+ camera.rotation.z + offset.rotation.z,
35
+ );
36
+ }
37
+
38
+ // These are game-owned feel decisions. CameraShake only applies the values and never chooses them.
39
+ export function createArenaShakeOptions(): ICameraShakeOptions {
40
+ return {
41
+ amplitude: new Vec3(0.08, 0.05, 0.03),
42
+ rotationAmplitude: new Vec3(0.025, 0.04, 0.015),
43
+ frequency: 17,
44
+ decay: 7,
45
+ curve: (phase) => Math.sin(phase) * 0.72 + Math.sin(phase * 0.43) * 0.28,
46
+ };
47
+ }
48
+
49
+ export function createArenaCamera(camera: PerspectiveCamera, shake?: ICameraShakeLike): ICameraRig {
11
50
  const offset = new Vec3(0, 5.2, 9.2);
12
51
  const lookAhead = new Vec3(0, 0.4, -4.6);
13
52
  const desired = new Vec3();
14
53
  const aim = new Vec3();
54
+ const rotatedOffset = new Vec3();
55
+ const rotatedLookAhead = new Vec3();
15
56
 
16
- const pose = (target: Vector3): void => {
17
- camera.position.copy(target).add(offset);
18
- camera.lookAt(aim.copy(target).add(lookAhead));
57
+ // `yaw` is the look angle the scene accumulated from relative mouse motion: positive turns
58
+ // the view right. The orbit swings offset and look-ahead around the player by the same angle,
59
+ // so aim direction and camera stay one rig.
60
+ const pose = (target: Vector3, dt: number, yaw = 0): void => {
61
+ rotatedOffset.copy(offset).applyAxisAngle(UP, -yaw);
62
+ rotatedLookAhead.copy(lookAhead).applyAxisAngle(UP, -yaw);
63
+ if (dt === 0) {
64
+ camera.position.copy(target).add(rotatedOffset);
65
+ } else {
66
+ desired.copy(target).add(rotatedOffset);
67
+ camera.position.lerp(desired, 1 - Math.exp(-dt / 0.2));
68
+ }
69
+ camera.lookAt(aim.copy(target).add(rotatedLookAhead));
70
+ const shakeOffset = shake?.update(dt);
71
+ if (shakeOffset === undefined) return;
72
+ composeCameraShake(camera, shakeOffset);
19
73
  };
20
74
 
21
75
  return {
22
- follow: (target, dt) => {
23
- desired.copy(target).add(offset);
24
- camera.position.lerp(desired, 1 - Math.exp(-dt / 0.2));
25
- camera.lookAt(aim.copy(target).add(lookAhead));
26
- },
27
- snap: pose,
76
+ follow: (target, dt, yaw = 0) => pose(target, dt, yaw),
77
+ snap: (target, yaw = 0) => pose(target, 0, yaw),
28
78
  };
29
79
  }
@@ -10,7 +10,10 @@ import { palette } from "./palette.js";
10
10
 
11
11
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
12
12
 
13
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
13
+ // Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
14
+ // the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
15
+ // rendering a black pass.
16
+ export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
14
17
  renderer.shadowMap.enabled = true;
15
18
  renderer.shadowMap.type = PCFSoftShadowMap;
16
19
  scene.add(new HemisphereLight(palette.skyHigh, palette.skyLow, 1.25));
@@ -35,4 +38,6 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
35
38
  rim.position.set(8, 5, -10);
36
39
  scene.add(rim);
37
40
  scene.add(new AmbientLight(palette.skyLow, 0.3));
41
+
42
+ return key;
38
43
  }