create-threenative 0.2.3 → 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 (447) hide show
  1. package/README.md +53 -2
  2. package/agent-docs/references/assertion-reference.md +173 -6
  3. package/agent-docs/references/capability-reference.md +1303 -99
  4. package/agent-docs/references/capture-the-frame.md +7 -0
  5. package/agent-docs/references/creating-creatures.md +215 -0
  6. package/agent-docs/references/ctx-cookbook.md +69 -0
  7. package/agent-docs/references/debug-surface.md +8 -3
  8. package/agent-docs/references/dream-loop.md +150 -0
  9. package/agent-docs/references/finding-assets.md +70 -2
  10. package/agent-docs/references/sculpt-from-a-reference.md +3 -2
  11. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  12. package/agent-docs/references/visual-baseline.md +41 -0
  13. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  14. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  15. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  16. package/agent-files/.agents/skills/threenative-builder/SKILL.md +1 -1
  17. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  18. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  19. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  20. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  21. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  22. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +1 -1
  23. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  24. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  25. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  26. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  27. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  28. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  29. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  30. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  31. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  32. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  33. package/agent-files/scripts/reference.mjs +705 -0
  34. package/agent-files/scripts/visual-loop.mjs +382 -0
  35. package/capabilities.json +1881 -131
  36. package/dist/index.d.ts +39 -6
  37. package/dist/index.js +297 -32
  38. package/dist/threenative.js +822 -105
  39. package/package.json +30 -5
  40. package/template-assets/loading.ts +12 -2
  41. package/template-assets/patches/three@0.185.1.patch +249 -14
  42. package/template-assets/worldEnvironment.ts +758 -0
  43. package/templates/action-rpg/.codex/config.toml +4 -0
  44. package/templates/action-rpg/.cursor/mcp.json +32 -0
  45. package/templates/action-rpg/.gemini/settings.json +32 -0
  46. package/templates/action-rpg/.mcp.json +15 -3
  47. package/templates/action-rpg/.vscode/mcp.json +36 -0
  48. package/templates/action-rpg/.zed/settings.json +36 -0
  49. package/templates/action-rpg/AGENTS.md +69 -378
  50. package/templates/action-rpg/CLAUDE.md +69 -378
  51. package/templates/action-rpg/opencode.json +41 -0
  52. package/templates/action-rpg/package.json +7 -7
  53. package/templates/action-rpg/playtests/combat.playtest.json +9 -0
  54. package/templates/action-rpg/playtests/performance.playtest.json +24 -7
  55. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  56. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  57. package/templates/action-rpg/src/conventions.ts +35 -0
  58. package/templates/action-rpg/src/entities/Enemy.ts +2 -3
  59. package/templates/action-rpg/src/entities/Player.ts +20 -3
  60. package/templates/action-rpg/src/render/camera.ts +7 -2
  61. package/templates/action-rpg/src/render/lighting.ts +5 -3
  62. package/templates/action-rpg/src/render/loading.ts +12 -2
  63. package/templates/action-rpg/src/render/materials.ts +11 -0
  64. package/templates/action-rpg/src/render/palette.ts +10 -3
  65. package/templates/action-rpg/src/render/postprocessing.ts +21 -58
  66. package/templates/action-rpg/src/render/quality.ts +170 -0
  67. package/templates/action-rpg/src/render/shapes.ts +185 -26
  68. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  69. package/templates/action-rpg/src/render/vfx.ts +257 -0
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +208 -33
  71. package/templates/action-rpg/src/scenes/Play.ts +43 -6
  72. package/templates/action-rpg/src/style.css +20 -0
  73. package/templates/action-rpg/threenative.config.ts +7 -0
  74. package/templates/defense/.codex/config.toml +4 -0
  75. package/templates/defense/.cursor/mcp.json +32 -0
  76. package/templates/defense/.gemini/settings.json +32 -0
  77. package/templates/defense/.mcp.json +15 -3
  78. package/templates/defense/.vscode/mcp.json +36 -0
  79. package/templates/defense/.zed/settings.json +36 -0
  80. package/templates/defense/AGENTS.md +62 -385
  81. package/templates/defense/CLAUDE.md +62 -385
  82. package/templates/defense/opencode.json +41 -0
  83. package/templates/defense/package.json +7 -7
  84. package/templates/defense/playtests/performance.playtest.json +24 -7
  85. package/templates/defense/playtests/pointer-placement.playtest.json +87 -20
  86. package/templates/defense/playtests/scan.playtest.json +1 -1
  87. package/templates/defense/playtests/survive.playtest.json +14 -0
  88. package/templates/defense/src/attackers/Attacker.ts +4 -4
  89. package/templates/defense/src/board/Route.ts +22 -8
  90. package/templates/defense/src/conventions.ts +18 -0
  91. package/templates/defense/src/entities/Player.ts +11 -3
  92. package/templates/defense/src/game.ts +2 -3
  93. package/templates/defense/src/physics.ts +9 -39
  94. package/templates/defense/src/placement/Buildable.ts +4 -4
  95. package/templates/defense/src/render/camera.ts +9 -3
  96. package/templates/defense/src/render/loading.ts +12 -2
  97. package/templates/defense/src/render/materials.ts +9 -0
  98. package/templates/defense/src/render/palette.ts +12 -5
  99. package/templates/defense/src/render/postprocessing.ts +21 -58
  100. package/templates/defense/src/render/quality.ts +170 -0
  101. package/templates/defense/src/render/shapes.ts +142 -23
  102. package/templates/defense/src/render/sky.ts +2 -2
  103. package/templates/defense/src/render/worldEnvironment.ts +208 -33
  104. package/templates/defense/src/scenes/Boot.ts +2 -2
  105. package/templates/defense/src/scenes/Defense.ts +13 -6
  106. package/templates/defense/src/style.css +20 -0
  107. package/templates/defense/src/towers/Tower.ts +11 -12
  108. package/templates/defense/src/towers/targeting.ts +1 -1
  109. package/templates/defense/src/ui/App.tsx +2 -2
  110. package/templates/defense/threenative.config.ts +7 -0
  111. package/templates/minimal/.codex/config.toml +4 -0
  112. package/templates/minimal/.cursor/mcp.json +32 -0
  113. package/templates/minimal/.gemini/settings.json +32 -0
  114. package/templates/minimal/.mcp.json +15 -3
  115. package/templates/minimal/.vscode/mcp.json +36 -0
  116. package/templates/minimal/.zed/settings.json +36 -0
  117. package/templates/minimal/AGENTS.md +76 -485
  118. package/templates/minimal/CLAUDE.md +76 -485
  119. package/templates/minimal/opencode.json +41 -0
  120. package/templates/minimal/package.json +6 -6
  121. package/templates/minimal/playtests/play.playtest.json +2 -1
  122. package/templates/minimal/playtests/survives.playtest.json +48 -4
  123. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  124. package/templates/minimal/src/conventions.ts +18 -0
  125. package/templates/minimal/src/entities/Player.ts +39 -6
  126. package/templates/minimal/src/main.ts +14 -4
  127. package/templates/minimal/src/render/materials.ts +7 -0
  128. package/templates/minimal/src/render/palette.ts +3 -3
  129. package/templates/minimal/src/render/postprocessing.ts +17 -56
  130. package/templates/minimal/src/render/quality.ts +162 -0
  131. package/templates/minimal/src/render/sky.ts +23 -9
  132. package/templates/minimal/src/render/touch-controls.ts +165 -0
  133. package/templates/minimal/src/render/worldEnvironment.ts +208 -33
  134. package/templates/minimal/src/scenes/Play.ts +47 -11
  135. package/templates/minimal/src/style.css +20 -0
  136. package/templates/minimal/threenative.config.ts +7 -0
  137. package/templates/platformer/.codex/config.toml +4 -0
  138. package/templates/platformer/.cursor/mcp.json +32 -0
  139. package/templates/platformer/.gemini/settings.json +32 -0
  140. package/templates/platformer/.mcp.json +15 -3
  141. package/templates/platformer/.vscode/mcp.json +36 -0
  142. package/templates/platformer/.zed/settings.json +36 -0
  143. package/templates/platformer/AGENTS.md +70 -430
  144. package/templates/platformer/CLAUDE.md +70 -430
  145. package/templates/platformer/opencode.json +41 -0
  146. package/templates/platformer/package.json +7 -7
  147. package/templates/platformer/playtests/oneway.playtest.json +29 -2
  148. package/templates/platformer/playtests/performance.playtest.json +2 -1
  149. package/templates/platformer/playtests/survives.playtest.json +31 -0
  150. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +3 -0
  151. package/templates/platformer/playtests/touch-controls-web.playtest.json +15 -4
  152. package/templates/platformer/src/conventions.ts +18 -0
  153. package/templates/platformer/src/entities/Character.ts +63 -1
  154. package/templates/platformer/src/game.ts +3 -1
  155. package/templates/platformer/src/level/Platform.ts +13 -1
  156. package/templates/platformer/src/render/lighting.ts +7 -4
  157. package/templates/platformer/src/render/loading.ts +12 -2
  158. package/templates/platformer/src/render/palette.ts +4 -1
  159. package/templates/platformer/src/render/postprocessing.ts +32 -57
  160. package/templates/platformer/src/render/quality.ts +170 -0
  161. package/templates/platformer/src/render/worldEnvironment.ts +208 -33
  162. package/templates/platformer/src/scenes/Level.ts +52 -12
  163. package/templates/platformer/src/style.css +20 -0
  164. package/templates/platformer/threenative.config.ts +7 -0
  165. package/templates/puzzle/.codex/config.toml +19 -0
  166. package/templates/puzzle/.cursor/mcp.json +32 -0
  167. package/templates/puzzle/.gemini/settings.json +32 -0
  168. package/templates/puzzle/.mcp.json +32 -0
  169. package/templates/puzzle/.vscode/mcp.json +36 -0
  170. package/templates/puzzle/.zed/settings.json +36 -0
  171. package/templates/puzzle/AGENTS.md +96 -0
  172. package/templates/puzzle/CLAUDE.md +98 -0
  173. package/templates/puzzle/README.md +43 -0
  174. package/templates/puzzle/index.html +12 -0
  175. package/templates/puzzle/kit.json +7 -0
  176. package/templates/puzzle/opencode.json +41 -0
  177. package/templates/puzzle/package.json +50 -0
  178. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  179. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  180. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  181. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  182. package/templates/puzzle/public/favicon.svg +5 -0
  183. package/templates/puzzle/src/conventions.ts +25 -0
  184. package/templates/puzzle/src/entities/Ball.ts +70 -0
  185. package/templates/puzzle/src/entities/Crate.ts +76 -0
  186. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  187. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  188. package/templates/puzzle/src/game.ts +48 -0
  189. package/templates/puzzle/src/main.ts +15 -0
  190. package/templates/puzzle/src/physics.ts +19 -0
  191. package/templates/puzzle/src/render/camera.ts +37 -0
  192. package/templates/puzzle/src/render/lighting.ts +55 -0
  193. package/templates/puzzle/src/render/loading.ts +325 -0
  194. package/templates/puzzle/src/render/materials.ts +28 -0
  195. package/templates/puzzle/src/render/palette.ts +31 -0
  196. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  197. package/templates/puzzle/src/render/quality.ts +170 -0
  198. package/templates/puzzle/src/render/shapes.ts +134 -0
  199. package/templates/puzzle/src/render/sky.ts +16 -0
  200. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  201. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  202. package/templates/puzzle/src/room.ts +83 -0
  203. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  204. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  205. package/templates/puzzle/src/state.ts +30 -0
  206. package/templates/puzzle/src/style.css +96 -0
  207. package/templates/puzzle/src/ui/App.tsx +22 -0
  208. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  209. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  210. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  211. package/templates/puzzle/src/ui/main.tsx +14 -0
  212. package/templates/puzzle/tailwind.config.ts +1 -0
  213. package/templates/puzzle/threenative.config.ts +49 -0
  214. package/templates/puzzle/tsconfig.json +17 -0
  215. package/templates/puzzle/vite.config.ts +38 -0
  216. package/templates/racing/.codex/config.toml +4 -0
  217. package/templates/racing/.cursor/mcp.json +32 -0
  218. package/templates/racing/.gemini/settings.json +32 -0
  219. package/templates/racing/.mcp.json +15 -3
  220. package/templates/racing/.vscode/mcp.json +36 -0
  221. package/templates/racing/.zed/settings.json +36 -0
  222. package/templates/racing/AGENTS.md +63 -379
  223. package/templates/racing/CLAUDE.md +63 -379
  224. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  225. package/templates/racing/opencode.json +41 -0
  226. package/templates/racing/package.json +8 -7
  227. package/templates/racing/playtests/performance.playtest.json +24 -7
  228. package/templates/racing/playtests/survives.playtest.json +36 -4
  229. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  230. package/templates/racing/src/conventions.ts +6 -0
  231. package/templates/racing/src/entities/RacingCar.ts +16 -4
  232. package/templates/racing/src/entities/Rival.ts +5 -2
  233. package/templates/racing/src/render/camera.ts +7 -4
  234. package/templates/racing/src/render/lighting.ts +22 -13
  235. package/templates/racing/src/render/loading.ts +12 -2
  236. package/templates/racing/src/render/materials.ts +54 -4
  237. package/templates/racing/src/render/palette.ts +23 -6
  238. package/templates/racing/src/render/postprocessing.ts +21 -58
  239. package/templates/racing/src/render/quality.ts +170 -0
  240. package/templates/racing/src/render/shapes.ts +537 -26
  241. package/templates/racing/src/render/sky.ts +5 -2
  242. package/templates/racing/src/render/touch-controls.ts +185 -0
  243. package/templates/racing/src/render/worldEnvironment.ts +208 -33
  244. package/templates/racing/src/scenes/Race.ts +17 -2
  245. package/templates/racing/src/style.css +20 -0
  246. package/templates/racing/src/track/Track.ts +270 -31
  247. package/templates/racing/threenative.config.ts +7 -0
  248. package/templates/runner/.codex/config.toml +19 -0
  249. package/templates/runner/.cursor/mcp.json +32 -0
  250. package/templates/runner/.gemini/settings.json +32 -0
  251. package/templates/runner/.mcp.json +32 -0
  252. package/templates/runner/.vscode/mcp.json +36 -0
  253. package/templates/runner/.zed/settings.json +36 -0
  254. package/templates/runner/AGENTS.md +96 -0
  255. package/templates/runner/CLAUDE.md +98 -0
  256. package/templates/runner/README.md +43 -0
  257. package/templates/runner/index.html +12 -0
  258. package/templates/runner/kit.json +7 -0
  259. package/templates/runner/opencode.json +41 -0
  260. package/templates/runner/package.json +50 -0
  261. package/templates/runner/playtests/performance.playtest.json +23 -0
  262. package/templates/runner/playtests/streams.playtest.json +38 -0
  263. package/templates/runner/playtests/survives.playtest.json +51 -0
  264. package/templates/runner/public/favicon.svg +5 -0
  265. package/templates/runner/src/conventions.ts +24 -0
  266. package/templates/runner/src/entities/Runner.ts +135 -0
  267. package/templates/runner/src/game.ts +50 -0
  268. package/templates/runner/src/main.ts +15 -0
  269. package/templates/runner/src/physics.ts +13 -0
  270. package/templates/runner/src/render/camera.ts +39 -0
  271. package/templates/runner/src/render/dust.ts +131 -0
  272. package/templates/runner/src/render/lighting.ts +57 -0
  273. package/templates/runner/src/render/loading.ts +325 -0
  274. package/templates/runner/src/render/materials.ts +27 -0
  275. package/templates/runner/src/render/palette.ts +30 -0
  276. package/templates/runner/src/render/postprocessing.ts +34 -0
  277. package/templates/runner/src/render/quality.ts +170 -0
  278. package/templates/runner/src/render/shapes.ts +68 -0
  279. package/templates/runner/src/render/sky.ts +51 -0
  280. package/templates/runner/src/render/touch-controls.ts +185 -0
  281. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  282. package/templates/runner/src/scenes/Boot.ts +12 -0
  283. package/templates/runner/src/scenes/Run.ts +142 -0
  284. package/templates/runner/src/state.ts +29 -0
  285. package/templates/runner/src/style.css +96 -0
  286. package/templates/runner/src/track.ts +176 -0
  287. package/templates/runner/src/ui/App.tsx +22 -0
  288. package/templates/runner/src/ui/GameUi.tsx +20 -0
  289. package/templates/runner/src/ui/Hud.tsx +55 -0
  290. package/templates/runner/src/ui/Menu.tsx +7 -0
  291. package/templates/runner/src/ui/main.tsx +14 -0
  292. package/templates/runner/tailwind.config.ts +1 -0
  293. package/templates/runner/threenative.config.ts +49 -0
  294. package/templates/runner/tsconfig.json +17 -0
  295. package/templates/runner/vite.config.ts +38 -0
  296. package/templates/sailing/.codex/config.toml +4 -0
  297. package/templates/sailing/.cursor/mcp.json +32 -0
  298. package/templates/sailing/.gemini/settings.json +32 -0
  299. package/templates/sailing/.mcp.json +15 -3
  300. package/templates/sailing/.vscode/mcp.json +36 -0
  301. package/templates/sailing/.zed/settings.json +36 -0
  302. package/templates/sailing/AGENTS.md +62 -355
  303. package/templates/sailing/CLAUDE.md +62 -355
  304. package/templates/sailing/README.md +12 -9
  305. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  306. package/templates/sailing/native-playtests/survives.playtest.json +20 -3
  307. package/templates/sailing/opencode.json +41 -0
  308. package/templates/sailing/package.json +8 -8
  309. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  310. package/templates/sailing/playtests/float.playtest.json +59 -0
  311. package/templates/sailing/playtests/performance.playtest.json +21 -6
  312. package/templates/sailing/playtests/survives.playtest.json +8 -0
  313. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  314. package/templates/sailing/src/conventions.ts +8 -0
  315. package/templates/sailing/src/entities/Ship.ts +150 -13
  316. package/templates/sailing/src/render/camera.ts +15 -8
  317. package/templates/sailing/src/render/lighting.ts +10 -5
  318. package/templates/sailing/src/render/loading.ts +12 -2
  319. package/templates/sailing/src/render/materials.ts +24 -8
  320. package/templates/sailing/src/render/ocean.ts +179 -0
  321. package/templates/sailing/src/render/palette.ts +14 -21
  322. package/templates/sailing/src/render/postprocessing.ts +23 -22
  323. package/templates/sailing/src/render/props.ts +584 -34
  324. package/templates/sailing/src/render/quality.ts +140 -0
  325. package/templates/sailing/src/render/sky.ts +8 -3
  326. package/templates/sailing/src/render/touch-controls.ts +142 -0
  327. package/templates/sailing/src/render/worldEnvironment.ts +206 -38
  328. package/templates/sailing/src/scenes/Sailing.ts +43 -16
  329. package/templates/sailing/src/style.css +20 -0
  330. package/templates/sailing/threenative.config.ts +7 -1
  331. package/templates/shooter/.codex/config.toml +4 -0
  332. package/templates/shooter/.cursor/mcp.json +32 -0
  333. package/templates/shooter/.gemini/settings.json +32 -0
  334. package/templates/shooter/.mcp.json +15 -3
  335. package/templates/shooter/.vscode/mcp.json +36 -0
  336. package/templates/shooter/.zed/settings.json +36 -0
  337. package/templates/shooter/AGENTS.md +76 -415
  338. package/templates/shooter/CLAUDE.md +76 -415
  339. package/templates/shooter/kit.json +2 -2
  340. package/templates/shooter/opencode.json +41 -0
  341. package/templates/shooter/package.json +7 -7
  342. package/templates/shooter/playtests/combat.playtest.json +48 -0
  343. package/templates/shooter/playtests/input-control.playtest.json +165 -35
  344. package/templates/shooter/playtests/per-item.playtest.json +3 -3
  345. package/templates/shooter/playtests/performance.playtest.json +24 -7
  346. package/templates/shooter/playtests/shooter.playtest.json +13 -7
  347. package/templates/shooter/playtests/survives.playtest.json +27 -0
  348. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  349. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  350. package/templates/shooter/src/combat/damage.ts +1 -2
  351. package/templates/shooter/src/conventions.ts +51 -0
  352. package/templates/shooter/src/entities/Player.ts +235 -18
  353. package/templates/shooter/src/entities/Target.ts +2 -2
  354. package/templates/shooter/src/game.ts +13 -4
  355. package/templates/shooter/src/render/camera.ts +49 -39
  356. package/templates/shooter/src/render/decals.ts +211 -0
  357. package/templates/shooter/src/render/lighting.ts +7 -3
  358. package/templates/shooter/src/render/loading.ts +12 -2
  359. package/templates/shooter/src/render/materials.ts +56 -3
  360. package/templates/shooter/src/render/palette.ts +6 -3
  361. package/templates/shooter/src/render/postprocessing.ts +21 -58
  362. package/templates/shooter/src/render/quality.ts +170 -0
  363. package/templates/shooter/src/render/scale.ts +22 -0
  364. package/templates/shooter/src/render/shapes.ts +343 -62
  365. package/templates/shooter/src/render/sky.ts +5 -1
  366. package/templates/shooter/src/render/touch-controls.ts +305 -0
  367. package/templates/shooter/src/render/ui.css +85 -0
  368. package/templates/shooter/src/render/ui.ts +19 -3
  369. package/templates/shooter/src/render/vfx.ts +215 -0
  370. package/templates/shooter/src/render/worldEnvironment.ts +208 -33
  371. package/templates/shooter/src/scenes/Play.ts +171 -56
  372. package/templates/shooter/src/state.ts +5 -0
  373. package/templates/shooter/src/style.css +20 -0
  374. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  375. package/templates/shooter/src/ui/GameUi.tsx +2 -0
  376. package/templates/shooter/src/ui/Hud.tsx +7 -1
  377. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  378. package/templates/shooter/src/weapons/Projectile.ts +8 -3
  379. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  380. package/templates/shooter/threenative.config.ts +7 -0
  381. package/templates/starter/.codex/config.toml +4 -0
  382. package/templates/starter/.cursor/mcp.json +32 -0
  383. package/templates/starter/.gemini/settings.json +32 -0
  384. package/templates/starter/.mcp.json +15 -3
  385. package/templates/starter/.vscode/mcp.json +36 -0
  386. package/templates/starter/.zed/settings.json +36 -0
  387. package/templates/starter/AGENTS.md +70 -527
  388. package/templates/starter/CLAUDE.md +70 -527
  389. package/templates/starter/native-playtests/render-chain.playtest.json +73 -4
  390. package/templates/starter/opencode.json +41 -0
  391. package/templates/starter/package.json +7 -7
  392. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  393. package/templates/starter/playtests/look.playtest.json +110 -6
  394. package/templates/starter/playtests/play.playtest.json +3 -2
  395. package/templates/starter/playtests/survives.playtest.json +21 -0
  396. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  397. package/templates/starter/src/conventions.ts +18 -0
  398. package/templates/starter/src/entities/Goal.ts +18 -3
  399. package/templates/starter/src/entities/Player.ts +72 -9
  400. package/templates/starter/src/game.ts +2 -0
  401. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  402. package/templates/starter/src/render/camera.ts +1 -1
  403. package/templates/starter/src/render/coast.ts +199 -0
  404. package/templates/starter/src/render/hero.ts +88 -0
  405. package/templates/starter/src/render/implicitSurface.ts +199 -0
  406. package/templates/starter/src/render/kuwahara.ts +174 -0
  407. package/templates/starter/src/render/lighting.ts +4 -4
  408. package/templates/starter/src/render/loading.ts +12 -2
  409. package/templates/starter/src/render/materials.ts +25 -6
  410. package/templates/starter/src/render/outline.ts +141 -0
  411. package/templates/starter/src/render/painterly.ts +86 -0
  412. package/templates/starter/src/render/palette.ts +15 -6
  413. package/templates/starter/src/render/postprocessing.ts +87 -36
  414. package/templates/starter/src/render/quality.ts +185 -0
  415. package/templates/starter/src/render/rockRidge.ts +198 -0
  416. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  417. package/templates/starter/src/render/scenery.ts +16 -59
  418. package/templates/starter/src/render/textureLifetime.ts +53 -0
  419. package/templates/starter/src/render/touch-controls.ts +165 -0
  420. package/templates/starter/src/render/water.ts +38 -0
  421. package/templates/starter/src/render/watercolor.ts +85 -0
  422. package/templates/starter/src/render/worldEnvironment.ts +208 -33
  423. package/templates/starter/src/scenes/Play.ts +103 -16
  424. package/templates/starter/src/style.css +27 -7
  425. package/templates/starter/threenative.config.ts +7 -7
  426. package/agent-docs/asset-mcp-loop.md +0 -33
  427. package/agent-docs/ctx-surface.md +0 -69
  428. package/agent-docs/engine-capabilities.md +0 -4
  429. package/agent-docs/framework-blocks-you.md +0 -60
  430. package/agent-docs/look-at-it-and-budget-the-look.md +0 -27
  431. package/agent-docs/performance-default.md +0 -42
  432. package/agent-docs/pixel-budget.md +0 -20
  433. package/agent-docs/playtest-fail-closed.md +0 -23
  434. package/agent-docs/sculpt-loop.md +0 -16
  435. package/templates/action-rpg/src/physics.ts +0 -40
  436. package/templates/defense/public/icon.png +0 -0
  437. package/templates/minimal/public/icon.png +0 -0
  438. package/templates/platformer/public/icon.png +0 -0
  439. package/templates/racing/public/icon.png +0 -0
  440. package/templates/sailing/public/icon.png +0 -0
  441. package/templates/sailing/src/render/water-material.ts +0 -14
  442. package/templates/sailing/src/render/water-shaders.ts +0 -12
  443. package/templates/sailing/src/render/wave-nodes.ts +0 -10
  444. package/templates/shooter/public/icon.png +0 -0
  445. package/templates/shooter/src/physics.ts +0 -49
  446. package/templates/starter/public/icon.png +0 -0
  447. /package/{templates/action-rpg/public → template-assets}/icon.png +0 -0
@@ -0,0 +1,41 @@
1
+ {
2
+ "$schema": "https://opencode.ai/config.json",
3
+ "mcp": {
4
+ "threenative-assets": {
5
+ "type": "local",
6
+ "command": [
7
+ "node",
8
+ "./node_modules/@threenative/core/mcp/assets.mjs"
9
+ ],
10
+ "enabled": true,
11
+ "environment": {
12
+ "ASSET_DOWNLOAD_DIR": "./public/assets",
13
+ "AUDIO_DOWNLOAD_DIR": "./public/audio"
14
+ }
15
+ },
16
+ "threenative-sculpt": {
17
+ "type": "local",
18
+ "command": [
19
+ "node",
20
+ "./node_modules/@threenative/core/mcp/sculpt.mjs"
21
+ ],
22
+ "enabled": true
23
+ },
24
+ "threenative-engine": {
25
+ "type": "local",
26
+ "command": [
27
+ "node",
28
+ "./node_modules/@threenative/core/mcp/engine.mjs"
29
+ ],
30
+ "enabled": true
31
+ },
32
+ "threenative-blender": {
33
+ "type": "local",
34
+ "command": [
35
+ "node",
36
+ "./node_modules/@threenative/core/mcp/blender.mjs"
37
+ ],
38
+ "enabled": true
39
+ }
40
+ }
41
+ }
@@ -0,0 +1,50 @@
1
+ {
2
+ "name": "__PROJECT_NAME__",
3
+ "private": true,
4
+ "license": "MIT",
5
+ "type": "module",
6
+ "scripts": {
7
+ "dev": "vite",
8
+ "build": "threenative build",
9
+ "build:web": "threenative build --target web",
10
+ "build:desktop": "threenative build --target desktop",
11
+ "build:android": "threenative build --target android",
12
+ "build:ios": "threenative build --target ios",
13
+ "pretest": "playwright install chromium",
14
+ "test": "vite build && threenative-playtest --scenario \"playtests/*.playtest.json\" --browser-recipe webgpu --headed --server-command \"pnpm dev --host 127.0.0.1 --port $PORT --strictPort\"",
15
+ "typecheck": "tsc --noEmit -p tsconfig.json"
16
+ },
17
+ "dependencies": {
18
+ "@threenative/core": "0.3.1",
19
+ "@threenative/physics": "0.3.1",
20
+ "@threenative/ui": "0.3.1",
21
+ "react": "19.2.0",
22
+ "react-dom": "19.2.0",
23
+ "three": "0.185.1"
24
+ },
25
+ "devDependencies": {
26
+ "@gltf-transform/cli": "4.4.2",
27
+ "@tailwindcss/vite": "4.3.3",
28
+ "@threenative/assets": "0.3.1",
29
+ "@threenative/playtest": "0.3.1",
30
+ "@types/react": "19.2.0",
31
+ "@types/react-dom": "19.2.0",
32
+ "@types/three": "0.185.3",
33
+ "@vitejs/plugin-react": "6.0.5",
34
+ "create-threenative": "0.2.4",
35
+ "esbuild": "0.27.0",
36
+ "playwright": "1.62.1",
37
+ "tailwindcss": "4.3.3",
38
+ "typescript": "5.9.3",
39
+ "vite": "8.2.0"
40
+ },
41
+ "optionalDependencies": {
42
+ "@threenative/runtime-native": "0.3.1"
43
+ },
44
+ "pnpm": {
45
+ "onlyBuiltDependencies": ["@threenative/core", "@threenative/runtime-native"],
46
+ "patchedDependencies": {
47
+ "three@0.185.1": "patches/three@0.185.1.patch"
48
+ }
49
+ }
50
+ }
@@ -0,0 +1,71 @@
1
+ {
2
+ "name": "carry",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
9
+ "warmupFrames": 40,
10
+ "subject": "player",
11
+ "steps": [
12
+ {
13
+ "kind": "input",
14
+ "label": "walk-to-crate",
15
+ "press": "ArrowUp",
16
+ "holdTicks": 30,
17
+ "release": true
18
+ },
19
+ {
20
+ "kind": "input",
21
+ "label": "grab",
22
+ "press": "KeyE",
23
+ "holdTicks": 4,
24
+ "release": true
25
+ },
26
+ {
27
+ "kind": "wait",
28
+ "label": "lift",
29
+ "waitTicks": 30,
30
+ "release": true
31
+ },
32
+ {
33
+ "kind": "input",
34
+ "label": "carry-back",
35
+ "press": "ArrowDown",
36
+ "holdTicks": 70,
37
+ "release": true
38
+ },
39
+ {
40
+ "kind": "wait",
41
+ "label": "settle",
42
+ "waitTicks": 20,
43
+ "release": true
44
+ }
45
+ ],
46
+ "assert": {
47
+ "diagnostics": {
48
+ "noConsoleErrors": true,
49
+ "noNetworkErrors": true,
50
+ "noRuntimeDiagnostics": true,
51
+ "runtimeReady": true
52
+ },
53
+ "components": [
54
+ {
55
+ "component": "held",
56
+ "entity": "crate.0",
57
+ "equals": true
58
+ },
59
+ {
60
+ "changed": true,
61
+ "component": "position",
62
+ "entity": "crate.0",
63
+ "path": "2"
64
+ }
65
+ ],
66
+ "movement": {
67
+ "entity": "player",
68
+ "minDistance": 1.5
69
+ }
70
+ }
71
+ }
@@ -0,0 +1,23 @@
1
+ {
2
+ "acceptanceId": "puzzle-production-performance",
3
+ "artifacts": { "screenshots": "after" },
4
+ "assert": {
5
+ "performance": {
6
+ "maxDrawCalls": 145,
7
+ "maxFrameMsP95": 33,
8
+ "maxTriangles": 12000,
9
+ "minFps": 30
10
+ },
11
+ "renderChain": { "tier": "high" }
12
+ },
13
+ "name": "production-performance",
14
+ "schemaVersion": 1,
15
+ "steps": [
16
+ { "kind": "input", "press": "ArrowRight", "holdTicks": 60, "release": true },
17
+ { "kind": "wait", "waitTicks": 600, "release": true }
18
+ ],
19
+ "subject": "player",
20
+ "target": "web",
21
+ "viewport": { "height": 1080, "width": 1920 },
22
+ "warmupFrames": 60
23
+ }
@@ -0,0 +1,51 @@
1
+ {
2
+ "name": "survives",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": { "width": 1280, "height": 720 },
6
+ "warmupFrames": 40,
7
+ "subject": "player",
8
+ "steps": [
9
+ { "kind": "input", "label": "move", "press": "ArrowUp", "holdTicks": 60, "release": true },
10
+ { "kind": "wait", "label": "settle", "waitTicks": 10, "release": true }
11
+ ],
12
+ "assert": {
13
+ "diagnostics": {
14
+ "noConsoleErrors": true,
15
+ "noNetworkErrors": true,
16
+ "noRuntimeDiagnostics": true,
17
+ "runtimeReady": true
18
+ },
19
+ "components": [
20
+ {
21
+ "allowTrivial": "GroundSnap settles the claw before this movement observation; the finite near-zero clearance is the generated call-site proof.",
22
+ "component": "groundClearance",
23
+ "entity": "player",
24
+ "lte": 0.01
25
+ }
26
+ ],
27
+ "movement": {
28
+ "entity": "player",
29
+ "minDistance": 0.5,
30
+ "minAxisDelta": { "axis": "-z", "min": 0.5 }
31
+ },
32
+ "visibility": [
33
+ {
34
+ "entity": "touch-controls",
35
+ "present": false,
36
+ "allowTrivial": "Desktop keyboard lanes intentionally omit touch controls while movement proves the scene is active."
37
+ }
38
+ ],
39
+ "visual": [
40
+ {
41
+ "region": {
42
+ "x": 0,
43
+ "y": 0,
44
+ "width": 1280,
45
+ "height": 720,
46
+ "minNonblankPixelRatio": 0.01
47
+ }
48
+ }
49
+ ]
50
+ }
51
+ }
@@ -0,0 +1,38 @@
1
+ {
2
+ "name": "swing",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": { "width": 1280, "height": 720 },
6
+ "warmupFrames": 60,
7
+ "subject": "pendulum",
8
+ "steps": [
9
+ { "kind": "wait", "label": "hang-still", "waitTicks": 60, "release": true },
10
+ { "kind": "input", "label": "shove", "press": "KeyF", "holdTicks": 4, "release": true },
11
+ { "kind": "wait", "label": "swing-out", "waitTicks": 40, "release": true }
12
+ ],
13
+ "assert": {
14
+ "diagnostics": {
15
+ "noConsoleErrors": true,
16
+ "noNetworkErrors": true,
17
+ "noRuntimeDiagnostics": true,
18
+ "runtimeReady": true
19
+ },
20
+ "components": [
21
+ {
22
+ "component": "swings",
23
+ "entity": "pendulum",
24
+ "gte": 1
25
+ },
26
+ {
27
+ "changed": true,
28
+ "component": "position",
29
+ "entity": "pendulum",
30
+ "path": "2"
31
+ }
32
+ ],
33
+ "movement": {
34
+ "entity": "pendulum",
35
+ "minDistance": 0.3
36
+ }
37
+ }
38
+ }
@@ -0,0 +1,5 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
2
+ <rect width="64" height="64" rx="12" fill="#07131d"/>
3
+ <path d="M15 49 32 12l17 37-17-8-17 8Z" fill="#f5c451"/>
4
+ <path d="M32 23v20" stroke="#07131d" stroke-width="5"/>
5
+ </svg>
@@ -0,0 +1,25 @@
1
+ import { GroundSnap, normaliseToMetres } from "@threenative/core";
2
+ import type { Group } from "three";
3
+
4
+ export interface IPuzzleConventions {
5
+ readonly applyGrounding: (surfaceY: number, dt: number) => void;
6
+ readonly groundSnap: GroundSnap;
7
+ readonly normaliseFactor: number;
8
+ }
9
+
10
+ /**
11
+ * One metre is one metre, and the claw's feet meet the floor.
12
+ *
13
+ * `normaliseToMetres` returns the factor it applied, and `GroundSnap` reports the clearance it
14
+ * settled on. Both are published through the gripper's `debug()`, so a scenario can prove the
15
+ * conventions ran rather than trusting that they did.
16
+ */
17
+ export function prepareGripperConventions(model: Group): IPuzzleConventions {
18
+ const normaliseFactor = normaliseToMetres(model, { axis: "height", metres: 1.7 });
19
+ const groundSnap = new GroundSnap(model);
20
+ return {
21
+ applyGrounding: (surfaceY, dt) => groundSnap.apply(model, surfaceY, dt),
22
+ groundSnap,
23
+ normaliseFactor,
24
+ };
25
+ }
@@ -0,0 +1,70 @@
1
+ import type { ICtx } from "@threenative/core";
2
+ import { Area3D, CollisionShape3D, RigidBody3D } from "@threenative/physics";
3
+ import type { Mesh } from "three";
4
+ import { BALL_LAYER, BALL_MASK, type PuzzlePhysics } from "../physics.js";
5
+ import { BALL_RADIUS, GOAL_RADIUS, ball as ballMesh } from "../render/shapes.js";
6
+ import { BALL_START, GOAL_POSITION } from "../room.js";
7
+ import type { GameState } from "../state.js";
8
+
9
+ type GameCtx = ICtx<GameState, PuzzlePhysics>;
10
+
11
+ /**
12
+ * The thing that has to reach the goal, and the goal that notices when it does.
13
+ *
14
+ * The goal is an `Area3D`: an overlap volume that reports what is inside it without becoming
15
+ * something the ball can bounce off. A win condition written as a distance check instead would
16
+ * pass through walls and fire on a ball that flew over the ring.
17
+ */
18
+ export class Ball {
19
+ readonly mesh: Mesh;
20
+ readonly body: RigidBody3D;
21
+ readonly goal: Area3D;
22
+ #scored = false;
23
+
24
+ constructor(ctx: GameCtx) {
25
+ this.mesh = ballMesh();
26
+ this.mesh.position.set(BALL_START.x, BALL_START.y, BALL_START.z);
27
+ ctx.add(this.mesh);
28
+ this.body = new RigidBody3D({
29
+ collisionLayer: BALL_LAYER,
30
+ collisionMask: BALL_MASK,
31
+ entity: "ball",
32
+ mass: 3.2,
33
+ object: this.mesh,
34
+ physics: ctx.physics,
35
+ shape: CollisionShape3D.sphere(BALL_RADIUS),
36
+ });
37
+ this.goal = new Area3D({
38
+ collisionLayer: 0,
39
+ collisionMask: BALL_LAYER,
40
+ entity: "goal",
41
+ physics: ctx.physics,
42
+ position: { x: GOAL_POSITION.x, y: GOAL_POSITION.y + 0.5, z: GOAL_POSITION.z },
43
+ shape: CollisionShape3D.sphere(GOAL_RADIUS),
44
+ });
45
+ // Godot's `Area3D.body_entered`, unchanged. The mask above means only the ball can raise it.
46
+ this.goal.on("bodyEntered", () => {
47
+ this.#scored = true;
48
+ });
49
+ }
50
+
51
+ /** True once the ball has entered the goal volume, and every frame after. */
52
+ get scored(): boolean {
53
+ return this.#scored;
54
+ }
55
+
56
+ debug(): Record<string, unknown> {
57
+ const velocity = this.body.linearVelocity;
58
+ return {
59
+ position: this.mesh.position.toArray(),
60
+ scored: this.scored,
61
+ speed: Math.hypot(velocity.x, velocity.y, velocity.z),
62
+ };
63
+ }
64
+
65
+ dispose(): void {
66
+ this.goal.dispose();
67
+ this.body.dispose();
68
+ this.mesh.removeFromParent();
69
+ }
70
+ }
@@ -0,0 +1,76 @@
1
+ import type { ICtx } from "@threenative/core";
2
+ import { CollisionShape3D, RigidBody3D } from "@threenative/physics";
3
+ import type { Mesh, Vector3 } from "three";
4
+ import { CRATE_LAYER, CRATE_MASK, type PuzzlePhysics } from "../physics.js";
5
+ import { CRATE_SIZE, crate as crateMesh } from "../render/shapes.js";
6
+ import type { GameState } from "../state.js";
7
+
8
+ type GameCtx = ICtx<GameState, PuzzlePhysics>;
9
+
10
+ const CARRY_HEIGHT = 1.15;
11
+ const CARRY_BLEND = 12;
12
+
13
+ /**
14
+ * A box the player can pick up, carry and set down.
15
+ *
16
+ * Carrying is a velocity, not a teleport. Snapping a dynamic body to the claw each frame makes it
17
+ * pass through walls and pop the solver; steering its velocity toward the carry point keeps every
18
+ * contact the room has honest, which is the whole point of a physics puzzle.
19
+ */
20
+ export class Crate {
21
+ readonly mesh: Mesh;
22
+ readonly body: RigidBody3D;
23
+ #held = false;
24
+
25
+ constructor(
26
+ ctx: GameCtx,
27
+ position: Vector3,
28
+ readonly id: string,
29
+ ) {
30
+ this.mesh = crateMesh();
31
+ this.mesh.position.copy(position);
32
+ ctx.add(this.mesh);
33
+ this.body = new RigidBody3D({
34
+ collisionLayer: CRATE_LAYER,
35
+ collisionMask: CRATE_MASK,
36
+ entity: `crate.${id}`,
37
+ mass: 14,
38
+ object: this.mesh,
39
+ physics: ctx.physics,
40
+ shape: CollisionShape3D.box(CRATE_SIZE, CRATE_SIZE, CRATE_SIZE),
41
+ });
42
+ }
43
+
44
+ get held(): boolean {
45
+ return this.#held;
46
+ }
47
+
48
+ hold(): void {
49
+ this.#held = true;
50
+ }
51
+
52
+ /** Lets go, keeping whatever velocity the carry gave it — a shove is a legitimate solution. */
53
+ release(): void {
54
+ this.#held = false;
55
+ }
56
+
57
+ carry(target: Vector3, dt: number): void {
58
+ if (!this.#held) return;
59
+ const blend = Math.min(1, Math.max(0, dt) * CARRY_BLEND);
60
+ const position = this.mesh.position;
61
+ this.body.linearVelocity = {
62
+ x: ((target.x - position.x) / Math.max(dt, 1 / 240)) * blend,
63
+ y: ((target.y + CARRY_HEIGHT - position.y) / Math.max(dt, 1 / 240)) * blend,
64
+ z: ((target.z - position.z) / Math.max(dt, 1 / 240)) * blend,
65
+ };
66
+ }
67
+
68
+ debug(): Record<string, unknown> {
69
+ return { held: this.#held, position: this.mesh.position.toArray() };
70
+ }
71
+
72
+ dispose(): void {
73
+ this.body.dispose();
74
+ this.mesh.removeFromParent();
75
+ }
76
+ }
@@ -0,0 +1,69 @@
1
+ import type { ICtx } from "@threenative/core";
2
+ import { type Group, Vector3 } from "three";
3
+ import { type IPuzzleConventions, prepareGripperConventions } from "../conventions.js";
4
+ import type { PuzzlePhysics } from "../physics.js";
5
+ import { gripper as gripperMesh } from "../render/shapes.js";
6
+ import type { ITouchInput } from "../render/touch-controls.js";
7
+ import { ROOM_DEPTH, ROOM_WIDTH } from "../room.js";
8
+ import type { GameState } from "../state.js";
9
+
10
+ type GameCtx = ICtx<GameState, PuzzlePhysics>;
11
+
12
+ const MOVE_SPEED = 5.2;
13
+ const SPAWN = new Vector3(-5.5, 0, 9);
14
+ const MARGIN = 1.4;
15
+
16
+ /**
17
+ * The player.
18
+ *
19
+ * A claw rather than a character: this game is about what the player moves, not about the mover,
20
+ * so the gripper is kinematic, stays on the floor, and carries exactly one crate. It is a plain
21
+ * transform with no rigid body — nothing in the room should be solvable by shoving the player
22
+ * into it.
23
+ */
24
+ export class Gripper {
25
+ readonly mesh: Group;
26
+ readonly tags = ["player", "gripper"];
27
+ #conventions: IPuzzleConventions;
28
+
29
+ constructor(ctx: GameCtx) {
30
+ this.mesh = gripperMesh();
31
+ this.mesh.name = "player";
32
+ this.mesh.position.copy(SPAWN);
33
+ this.#conventions = prepareGripperConventions(this.mesh);
34
+ ctx.add(this.mesh);
35
+ }
36
+
37
+ update(ctx: GameCtx, dt: number, touch?: ITouchInput): void {
38
+ const move = ctx.input.vector("move");
39
+ if (touch !== undefined) {
40
+ move.x += touch.move.x;
41
+ move.y += touch.move.y;
42
+ move.clampLength(0, 1);
43
+ }
44
+ const limitX = ROOM_WIDTH / 2 - MARGIN;
45
+ const limitZ = ROOM_DEPTH / 2 - MARGIN;
46
+ this.mesh.position.x = Math.min(
47
+ limitX,
48
+ Math.max(-limitX, this.mesh.position.x + move.x * MOVE_SPEED * dt),
49
+ );
50
+ this.mesh.position.z = Math.min(
51
+ limitZ,
52
+ Math.max(-limitZ, this.mesh.position.z - move.y * MOVE_SPEED * dt),
53
+ );
54
+ if (move.lengthSq() > 0) this.mesh.rotation.y = Math.atan2(move.x, -move.y);
55
+ this.#conventions.applyGrounding(0, dt);
56
+ }
57
+
58
+ debug(): Record<string, unknown> {
59
+ return {
60
+ groundClearance: this.#conventions.groundSnap.clearance,
61
+ normaliseFactor: this.#conventions.normaliseFactor,
62
+ position: this.mesh.position.toArray(),
63
+ };
64
+ }
65
+
66
+ dispose(): void {
67
+ this.mesh.removeFromParent();
68
+ }
69
+ }
@@ -0,0 +1,89 @@
1
+ import type { ICtx } from "@threenative/core";
2
+ import { CollisionShape3D, Joint3D, RigidBody3D } from "@threenative/physics";
3
+ import { type Mesh, Vector3 } from "three";
4
+ import { type PuzzlePhysics, ROOM_LAYER, WEIGHT_LAYER } from "../physics.js";
5
+ import { weight as weightMesh } from "../render/shapes.js";
6
+ import { GANTRY_HEIGHT } from "../room.js";
7
+ import type { GameState } from "../state.js";
8
+
9
+ type GameCtx = ICtx<GameState, PuzzlePhysics>;
10
+
11
+ const BOB_RADIUS = 0.62;
12
+ const CABLE = 2.6;
13
+ const ANCHOR = new Vector3(0, GANTRY_HEIGHT, 3.2);
14
+ const SHOVE = 7.5;
15
+
16
+ /**
17
+ * A weight on a hinge, and the only force in the room the player cannot supply by walking.
18
+ *
19
+ * The beam is a fixed body with no visual of its own — the gantry mesh is decoration, and the
20
+ * hinge needs something on the world side to hang from. `Joint3D.hinge` takes the anchor in each
21
+ * body's *local* space, so the beam's anchor is its origin and the bob's is the cable length
22
+ * above its centre.
23
+ */
24
+ export class Pendulum {
25
+ readonly mesh: Mesh;
26
+ readonly bob: RigidBody3D;
27
+ readonly beam: RigidBody3D;
28
+ readonly hinge: Joint3D;
29
+ #swings = 0;
30
+
31
+ constructor(ctx: GameCtx) {
32
+ this.mesh = weightMesh(BOB_RADIUS);
33
+ this.mesh.name = "pendulum-weight";
34
+ this.mesh.position.set(ANCHOR.x, ANCHOR.y - CABLE, ANCHOR.z);
35
+ ctx.add(this.mesh);
36
+
37
+ this.beam = new RigidBody3D({
38
+ collisionLayer: ROOM_LAYER,
39
+ collisionMask: 0,
40
+ entity: "pendulum.beam",
41
+ physics: ctx.physics,
42
+ position: { x: ANCHOR.x, y: ANCHOR.y, z: ANCHOR.z },
43
+ shape: CollisionShape3D.box(0.3, 0.2, 0.3),
44
+ type: "fixed",
45
+ });
46
+ this.bob = new RigidBody3D({
47
+ collisionLayer: WEIGHT_LAYER,
48
+ entity: "pendulum.bob",
49
+ mass: 90,
50
+ object: this.mesh,
51
+ physics: ctx.physics,
52
+ shape: CollisionShape3D.sphere(BOB_RADIUS),
53
+ });
54
+ this.hinge = Joint3D.hinge({
55
+ anchorA: { x: 0, y: 0, z: 0 },
56
+ anchorB: { x: 0, y: CABLE, z: 0 },
57
+ axis: { x: 1, y: 0, z: 0 },
58
+ bodyA: this.beam,
59
+ bodyB: this.bob,
60
+ physics: ctx.physics,
61
+ });
62
+ }
63
+
64
+ get swings(): number {
65
+ return this.#swings;
66
+ }
67
+
68
+ /** One shove along +z. The bob does the rest, which is the reason it is on a hinge. */
69
+ swing(): void {
70
+ this.#swings += 1;
71
+ const velocity = this.bob.linearVelocity;
72
+ this.bob.linearVelocity = { x: velocity.x, y: velocity.y, z: velocity.z + SHOVE };
73
+ }
74
+
75
+ debug(): Record<string, unknown> {
76
+ return {
77
+ position: this.mesh.position.toArray(),
78
+ speed: Math.hypot(this.bob.linearVelocity.x, this.bob.linearVelocity.z),
79
+ swings: this.#swings,
80
+ };
81
+ }
82
+
83
+ dispose(): void {
84
+ this.hinge.dispose();
85
+ this.bob.dispose();
86
+ this.beam.dispose();
87
+ this.mesh.removeFromParent();
88
+ }
89
+ }
@@ -0,0 +1,48 @@
1
+ import { defineGame } from "@threenative/core";
2
+ import { playtest } from "@threenative/core/playtest";
3
+ import { rapier } from "@threenative/physics";
4
+ import config from "../threenative.config.js";
5
+ import type { PuzzlePhysics } from "./physics.js";
6
+ import { Boot } from "./scenes/Boot.js";
7
+ import { Puzzle } from "./scenes/Puzzle.js";
8
+ import type { GameState } from "./state.js";
9
+
10
+ const game = defineGame<GameState, PuzzlePhysics>({
11
+ input: {
12
+ move: {
13
+ down: ["ArrowDown", "KeyS"],
14
+ left: ["ArrowLeft", "KeyA"],
15
+ right: ["ArrowRight", "KeyD"],
16
+ up: ["ArrowUp", "KeyW"],
17
+ },
18
+ grab: { keys: ["KeyE", "Space"] },
19
+ restart: { keys: ["KeyR"] },
20
+ swing: { keys: ["KeyF"] },
21
+ },
22
+ plugins: [rapier({ gravity: { x: 0, y: -9.81, z: 0 } }), playtest()],
23
+ display: config.display,
24
+ render: config.renderer,
25
+ scenes: { boot: Boot, puzzle: Puzzle },
26
+ seed: 51_204,
27
+ start: "boot",
28
+ });
29
+
30
+ export default game;
31
+
32
+ /**
33
+ * What the UI can ask the game to do.
34
+ *
35
+ * Intents are one-way and named by the game: the UI sends `restart`, `pause` or `resume` and the
36
+ * game decides what each means. Nothing comes back this way — the UI reads the game's published
37
+ * state instead, which keeps one source of truth on the side that owns the simulation.
38
+ */
39
+ game.ui.onIntent((intent) => {
40
+ if (intent === "restart") void game.goto("puzzle");
41
+ if (intent === "pause") game.pause();
42
+ if (intent === "resume") game.resume();
43
+ game.state.set({
44
+ uiReady: game.ui.connected,
45
+ ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
46
+ });
47
+ game.state.flush();
48
+ });
@@ -0,0 +1,15 @@
1
+ import { acceptHotUpdate } from "@threenative/core/hot";
2
+ import { createElement } from "react";
3
+ import { createRoot } from "react-dom/client";
4
+ import game from "./game.js";
5
+ import { App } from "./ui/App.js";
6
+ import "./style.css";
7
+
8
+ import.meta.hot?.accept();
9
+ acceptHotUpdate(game, import.meta.hot);
10
+ const root = document.getElementById("root");
11
+ if (root === null) throw new Error("Missing #root element.");
12
+ const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
13
+ const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
14
+ appRoot.__threenativeRoot = reactRoot;
15
+ reactRoot.render(createElement(App, { game }));