create-threenative 0.2.2 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (588) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +61 -2
  3. package/agent-docs/references/assertion-reference.md +819 -0
  4. package/agent-docs/references/capability-reference.md +4483 -0
  5. package/agent-docs/references/capture-the-frame.md +60 -0
  6. package/agent-docs/references/creating-creatures.md +215 -0
  7. package/agent-docs/references/ctx-cookbook.md +120 -0
  8. package/agent-docs/references/debug-surface.md +68 -0
  9. package/agent-docs/references/dream-loop.md +150 -0
  10. package/agent-docs/references/finding-assets.md +215 -0
  11. package/agent-docs/references/gameplay-recipes.md +54 -0
  12. package/agent-docs/references/menu-screens.md +69 -0
  13. package/agent-docs/references/mobile-memory-budget.md +87 -0
  14. package/agent-docs/references/sculpt-from-a-reference.md +40 -0
  15. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  16. package/agent-docs/references/visual-baseline.md +174 -0
  17. package/agent-docs/references/webview-ui.md +113 -0
  18. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  19. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  20. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  21. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  22. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  23. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  24. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  25. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  26. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  27. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  28. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  29. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  30. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  31. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  32. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  33. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  34. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  35. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  36. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  37. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  38. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  39. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  40. package/agent-files/.threenative/agents/builder.md +32 -0
  41. package/agent-files/.threenative/agents/verifier.md +31 -0
  42. package/agent-files/AGENT-ROLES.md +26 -0
  43. package/agent-files/scripts/reference.mjs +705 -0
  44. package/agent-files/scripts/visual-loop.mjs +382 -0
  45. package/capabilities.json +5292 -0
  46. package/dist/index.d.ts +224 -3
  47. package/dist/index.js +1972 -73
  48. package/dist/threenative.d.ts +9 -2
  49. package/dist/threenative.js +2570 -176
  50. package/package.json +55 -6
  51. package/template-assets/icon.png +0 -0
  52. package/template-assets/loading.ts +325 -0
  53. package/template-assets/patches/three@0.185.1.patch +522 -0
  54. package/template-assets/worldEnvironment.ts +758 -0
  55. package/templates/action-rpg/.codex/config.toml +19 -0
  56. package/templates/action-rpg/.cursor/mcp.json +32 -0
  57. package/templates/action-rpg/.gemini/settings.json +32 -0
  58. package/templates/action-rpg/.mcp.json +18 -2
  59. package/templates/action-rpg/.vscode/mcp.json +36 -0
  60. package/templates/action-rpg/.zed/settings.json +36 -0
  61. package/templates/action-rpg/AGENTS.md +84 -29
  62. package/templates/action-rpg/CLAUDE.md +84 -29
  63. package/templates/action-rpg/index.html +0 -1
  64. package/templates/action-rpg/opencode.json +41 -0
  65. package/templates/action-rpg/package.json +15 -11
  66. package/templates/action-rpg/playtests/combat.playtest.json +32 -9
  67. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  68. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  69. package/templates/action-rpg/playtests/performance.playtest.json +39 -0
  70. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  71. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  72. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  73. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  74. package/templates/action-rpg/src/conventions.ts +35 -0
  75. package/templates/action-rpg/src/entities/Enemy.ts +16 -7
  76. package/templates/action-rpg/src/entities/Player.ts +20 -3
  77. package/templates/action-rpg/src/game.ts +21 -0
  78. package/templates/action-rpg/src/render/camera.ts +7 -2
  79. package/templates/action-rpg/src/render/lighting.ts +11 -4
  80. package/templates/action-rpg/src/render/loading.ts +278 -43
  81. package/templates/action-rpg/src/render/materials.ts +11 -0
  82. package/templates/action-rpg/src/render/palette.ts +10 -3
  83. package/templates/action-rpg/src/render/postprocessing.ts +32 -16
  84. package/templates/action-rpg/src/render/quality.ts +170 -0
  85. package/templates/action-rpg/src/render/shapes.ts +185 -26
  86. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  87. package/templates/action-rpg/src/render/vfx.ts +257 -0
  88. package/templates/action-rpg/src/render/worldEnvironment.ts +758 -0
  89. package/templates/action-rpg/src/scenes/Play.ts +91 -24
  90. package/templates/action-rpg/src/state.ts +4 -0
  91. package/templates/action-rpg/src/style.css +65 -1
  92. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  93. package/templates/action-rpg/src/ui/App.tsx +9 -8
  94. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  95. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  96. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  97. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  98. package/templates/action-rpg/src/ui/main.tsx +14 -0
  99. package/templates/action-rpg/threenative.config.ts +28 -8
  100. package/templates/action-rpg/vite.config.ts +32 -2
  101. package/templates/defense/.codex/config.toml +19 -0
  102. package/templates/defense/.cursor/mcp.json +32 -0
  103. package/templates/defense/.gemini/settings.json +32 -0
  104. package/templates/defense/.mcp.json +18 -2
  105. package/templates/defense/.vscode/mcp.json +36 -0
  106. package/templates/defense/.zed/settings.json +36 -0
  107. package/templates/defense/AGENTS.md +81 -41
  108. package/templates/defense/CLAUDE.md +81 -41
  109. package/templates/defense/README.md +2 -1
  110. package/templates/defense/index.html +0 -1
  111. package/templates/defense/opencode.json +41 -0
  112. package/templates/defense/package.json +16 -12
  113. package/templates/defense/playtests/leak.playtest.json +9 -4
  114. package/templates/defense/playtests/performance.playtest.json +39 -0
  115. package/templates/defense/playtests/placement.playtest.json +5 -5
  116. package/templates/defense/playtests/pointer-placement.playtest.json +156 -0
  117. package/templates/defense/playtests/scan.playtest.json +4 -4
  118. package/templates/defense/playtests/survive.playtest.json +25 -6
  119. package/templates/defense/src/attackers/Attacker.ts +32 -16
  120. package/templates/defense/src/board/Route.ts +22 -8
  121. package/templates/defense/src/conventions.ts +18 -0
  122. package/templates/defense/src/entities/Player.ts +11 -3
  123. package/templates/defense/src/game.ts +25 -4
  124. package/templates/defense/src/physics.ts +9 -39
  125. package/templates/defense/src/placement/Buildable.ts +4 -4
  126. package/templates/defense/src/render/camera.ts +9 -3
  127. package/templates/defense/src/render/lighting.ts +6 -1
  128. package/templates/defense/src/render/loading.ts +274 -38
  129. package/templates/defense/src/render/materials.ts +9 -0
  130. package/templates/defense/src/render/palette.ts +12 -5
  131. package/templates/defense/src/render/postprocessing.ts +32 -12
  132. package/templates/defense/src/render/quality.ts +170 -0
  133. package/templates/defense/src/render/shapes.ts +180 -23
  134. package/templates/defense/src/render/sky.ts +2 -2
  135. package/templates/defense/src/render/worldEnvironment.ts +758 -0
  136. package/templates/defense/src/scenes/Boot.ts +2 -2
  137. package/templates/defense/src/scenes/Defense.ts +122 -56
  138. package/templates/defense/src/state.ts +6 -0
  139. package/templates/defense/src/style.css +65 -1
  140. package/templates/defense/src/towers/Tower.ts +11 -12
  141. package/templates/defense/src/towers/targeting.ts +1 -1
  142. package/templates/defense/src/ui/App.tsx +11 -6
  143. package/templates/defense/src/ui/GameUi.tsx +20 -0
  144. package/templates/defense/src/ui/Hud.tsx +6 -5
  145. package/templates/defense/src/ui/main.tsx +14 -0
  146. package/templates/defense/threenative.config.ts +28 -8
  147. package/templates/defense/vite.config.ts +34 -1
  148. package/templates/minimal/.codex/config.toml +19 -0
  149. package/templates/minimal/.cursor/mcp.json +32 -0
  150. package/templates/minimal/.gemini/settings.json +32 -0
  151. package/templates/minimal/.mcp.json +18 -2
  152. package/templates/minimal/.vscode/mcp.json +36 -0
  153. package/templates/minimal/.zed/settings.json +36 -0
  154. package/templates/minimal/AGENTS.md +78 -382
  155. package/templates/minimal/CLAUDE.md +78 -382
  156. package/templates/minimal/index.html +0 -1
  157. package/templates/minimal/opencode.json +41 -0
  158. package/templates/minimal/package.json +14 -11
  159. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  160. package/templates/minimal/playtests/play.playtest.json +18 -5
  161. package/templates/minimal/playtests/survives.playtest.json +48 -4
  162. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  163. package/templates/minimal/src/conventions.ts +18 -0
  164. package/templates/minimal/src/entities/Player.ts +39 -6
  165. package/templates/minimal/src/game.ts +1 -0
  166. package/templates/minimal/src/main.ts +14 -4
  167. package/templates/minimal/src/render/camera.ts +1 -1
  168. package/templates/minimal/src/render/hud.ts +24 -8
  169. package/templates/minimal/src/render/lighting.ts +23 -2
  170. package/templates/minimal/src/render/loading.ts +23 -103
  171. package/templates/minimal/src/render/materials.ts +7 -0
  172. package/templates/minimal/src/render/palette.ts +3 -3
  173. package/templates/minimal/src/render/postprocessing.ts +55 -16
  174. package/templates/minimal/src/render/quality.ts +162 -0
  175. package/templates/minimal/src/render/sky.ts +51 -32
  176. package/templates/minimal/src/render/touch-controls.ts +165 -0
  177. package/templates/minimal/src/render/worldEnvironment.ts +758 -0
  178. package/templates/minimal/src/scenes/Play.ts +128 -14
  179. package/templates/minimal/src/state.ts +8 -1
  180. package/templates/minimal/src/style.css +20 -0
  181. package/templates/minimal/threenative.config.ts +22 -10
  182. package/templates/minimal/vite.config.ts +28 -1
  183. package/templates/platformer/.codex/config.toml +19 -0
  184. package/templates/platformer/.cursor/mcp.json +32 -0
  185. package/templates/platformer/.gemini/settings.json +32 -0
  186. package/templates/platformer/.mcp.json +18 -2
  187. package/templates/platformer/.vscode/mcp.json +36 -0
  188. package/templates/platformer/.zed/settings.json +36 -0
  189. package/templates/platformer/AGENTS.md +81 -186
  190. package/templates/platformer/CLAUDE.md +81 -186
  191. package/templates/platformer/index.html +0 -1
  192. package/templates/platformer/opencode.json +41 -0
  193. package/templates/platformer/package.json +17 -14
  194. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  195. package/templates/platformer/playtests/branding.playtest.json +29 -0
  196. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  197. package/templates/platformer/playtests/collect.playtest.json +1 -1
  198. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  199. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  200. package/templates/platformer/playtests/damage.playtest.json +4 -1
  201. package/templates/platformer/playtests/dash.playtest.json +2 -2
  202. package/templates/platformer/playtests/jump.playtest.json +2 -3
  203. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  204. package/templates/platformer/playtests/oneway.playtest.json +30 -3
  205. package/templates/platformer/playtests/performance.playtest.json +7 -5
  206. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  207. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  208. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  209. package/templates/platformer/playtests/survives.playtest.json +31 -0
  210. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +16 -4
  211. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  212. package/templates/platformer/playtests/touch-controls-web.playtest.json +57 -0
  213. package/templates/platformer/src/conventions.ts +18 -0
  214. package/templates/platformer/src/entities/Character.ts +79 -11
  215. package/templates/platformer/src/entities/Patrol.ts +5 -0
  216. package/templates/platformer/src/game.ts +27 -2
  217. package/templates/platformer/src/level/Platform.ts +13 -1
  218. package/templates/platformer/src/render/lighting.ts +13 -5
  219. package/templates/platformer/src/render/loading.ts +281 -62
  220. package/templates/platformer/src/render/palette.ts +4 -1
  221. package/templates/platformer/src/render/postprocessing.ts +42 -14
  222. package/templates/platformer/src/render/quality.ts +170 -0
  223. package/templates/platformer/src/render/touch-controls.ts +54 -36
  224. package/templates/platformer/src/render/worldEnvironment.ts +758 -0
  225. package/templates/platformer/src/scenes/Level.ts +97 -32
  226. package/templates/platformer/src/state.ts +4 -0
  227. package/templates/platformer/src/style.css +65 -1
  228. package/templates/platformer/src/ui/App.tsx +9 -4
  229. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  230. package/templates/platformer/src/ui/Hud.tsx +6 -5
  231. package/templates/platformer/src/ui/main.tsx +14 -0
  232. package/templates/platformer/threenative.config.ts +27 -10
  233. package/templates/platformer/vite.config.ts +34 -1
  234. package/templates/puzzle/.codex/config.toml +19 -0
  235. package/templates/puzzle/.cursor/mcp.json +32 -0
  236. package/templates/puzzle/.gemini/settings.json +32 -0
  237. package/templates/puzzle/.mcp.json +32 -0
  238. package/templates/puzzle/.vscode/mcp.json +36 -0
  239. package/templates/puzzle/.zed/settings.json +36 -0
  240. package/templates/puzzle/AGENTS.md +96 -0
  241. package/templates/puzzle/CLAUDE.md +98 -0
  242. package/templates/puzzle/README.md +43 -0
  243. package/templates/puzzle/index.html +12 -0
  244. package/templates/puzzle/kit.json +7 -0
  245. package/templates/puzzle/opencode.json +41 -0
  246. package/templates/puzzle/package.json +50 -0
  247. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  248. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  249. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  250. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  251. package/templates/puzzle/public/favicon.svg +5 -0
  252. package/templates/puzzle/src/conventions.ts +25 -0
  253. package/templates/puzzle/src/entities/Ball.ts +70 -0
  254. package/templates/puzzle/src/entities/Crate.ts +76 -0
  255. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  256. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  257. package/templates/puzzle/src/game.ts +48 -0
  258. package/templates/puzzle/src/main.ts +15 -0
  259. package/templates/puzzle/src/physics.ts +19 -0
  260. package/templates/puzzle/src/render/camera.ts +37 -0
  261. package/templates/puzzle/src/render/lighting.ts +55 -0
  262. package/templates/puzzle/src/render/loading.ts +325 -0
  263. package/templates/puzzle/src/render/materials.ts +28 -0
  264. package/templates/puzzle/src/render/palette.ts +31 -0
  265. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  266. package/templates/puzzle/src/render/quality.ts +170 -0
  267. package/templates/puzzle/src/render/shapes.ts +134 -0
  268. package/templates/puzzle/src/render/sky.ts +16 -0
  269. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  270. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  271. package/templates/puzzle/src/room.ts +83 -0
  272. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  273. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  274. package/templates/puzzle/src/state.ts +30 -0
  275. package/templates/puzzle/src/style.css +96 -0
  276. package/templates/puzzle/src/ui/App.tsx +22 -0
  277. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  278. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  279. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  280. package/templates/puzzle/src/ui/main.tsx +14 -0
  281. package/templates/puzzle/tailwind.config.ts +1 -0
  282. package/templates/puzzle/threenative.config.ts +49 -0
  283. package/templates/puzzle/tsconfig.json +17 -0
  284. package/templates/puzzle/vite.config.ts +38 -0
  285. package/templates/racing/.codex/config.toml +19 -0
  286. package/templates/racing/.cursor/mcp.json +32 -0
  287. package/templates/racing/.gemini/settings.json +32 -0
  288. package/templates/racing/.mcp.json +18 -2
  289. package/templates/racing/.vscode/mcp.json +36 -0
  290. package/templates/racing/.zed/settings.json +36 -0
  291. package/templates/racing/AGENTS.md +84 -36
  292. package/templates/racing/CLAUDE.md +84 -36
  293. package/templates/racing/index.html +0 -1
  294. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  295. package/templates/racing/opencode.json +41 -0
  296. package/templates/racing/package.json +17 -12
  297. package/templates/racing/playtests/boost.playtest.json +5 -5
  298. package/templates/racing/playtests/outcome.playtest.json +14 -4
  299. package/templates/racing/playtests/performance.playtest.json +39 -0
  300. package/templates/racing/playtests/ranking.playtest.json +2 -2
  301. package/templates/racing/playtests/rescue.playtest.json +12 -6
  302. package/templates/racing/playtests/reverse.playtest.json +3 -3
  303. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  304. package/templates/racing/playtests/survives.playtest.json +36 -4
  305. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  306. package/templates/racing/src/conventions.ts +6 -0
  307. package/templates/racing/src/entities/RacingCar.ts +16 -4
  308. package/templates/racing/src/entities/Rival.ts +5 -2
  309. package/templates/racing/src/game.ts +24 -1
  310. package/templates/racing/src/render/camera.ts +15 -8
  311. package/templates/racing/src/render/lighting.ts +28 -14
  312. package/templates/racing/src/render/loading.ts +302 -35
  313. package/templates/racing/src/render/materials.ts +54 -4
  314. package/templates/racing/src/render/palette.ts +23 -6
  315. package/templates/racing/src/render/postprocessing.ts +32 -12
  316. package/templates/racing/src/render/quality.ts +170 -0
  317. package/templates/racing/src/render/shapes.ts +537 -26
  318. package/templates/racing/src/render/sky.ts +5 -2
  319. package/templates/racing/src/render/touch-controls.ts +185 -0
  320. package/templates/racing/src/render/worldEnvironment.ts +758 -0
  321. package/templates/racing/src/scenes/Race.ts +84 -37
  322. package/templates/racing/src/state.ts +4 -0
  323. package/templates/racing/src/style.css +65 -1
  324. package/templates/racing/src/track/Lap.ts +20 -9
  325. package/templates/racing/src/track/Ranking.ts +53 -14
  326. package/templates/racing/src/track/Track.ts +284 -32
  327. package/templates/racing/src/track/TrackSector.ts +14 -4
  328. package/templates/racing/src/ui/App.tsx +9 -4
  329. package/templates/racing/src/ui/GameUi.tsx +20 -0
  330. package/templates/racing/src/ui/Hud.tsx +6 -5
  331. package/templates/racing/src/ui/main.tsx +14 -0
  332. package/templates/racing/threenative.config.ts +28 -8
  333. package/templates/racing/vite.config.ts +34 -1
  334. package/templates/runner/.codex/config.toml +19 -0
  335. package/templates/runner/.cursor/mcp.json +32 -0
  336. package/templates/runner/.gemini/settings.json +32 -0
  337. package/templates/runner/.mcp.json +32 -0
  338. package/templates/runner/.vscode/mcp.json +36 -0
  339. package/templates/runner/.zed/settings.json +36 -0
  340. package/templates/runner/AGENTS.md +96 -0
  341. package/templates/runner/CLAUDE.md +98 -0
  342. package/templates/runner/README.md +43 -0
  343. package/templates/runner/index.html +12 -0
  344. package/templates/runner/kit.json +7 -0
  345. package/templates/runner/opencode.json +41 -0
  346. package/templates/runner/package.json +50 -0
  347. package/templates/runner/playtests/performance.playtest.json +23 -0
  348. package/templates/runner/playtests/streams.playtest.json +38 -0
  349. package/templates/runner/playtests/survives.playtest.json +51 -0
  350. package/templates/runner/public/favicon.svg +5 -0
  351. package/templates/runner/src/conventions.ts +24 -0
  352. package/templates/runner/src/entities/Runner.ts +135 -0
  353. package/templates/runner/src/game.ts +50 -0
  354. package/templates/runner/src/main.ts +15 -0
  355. package/templates/runner/src/physics.ts +13 -0
  356. package/templates/runner/src/render/camera.ts +39 -0
  357. package/templates/runner/src/render/dust.ts +131 -0
  358. package/templates/runner/src/render/lighting.ts +57 -0
  359. package/templates/runner/src/render/loading.ts +325 -0
  360. package/templates/runner/src/render/materials.ts +27 -0
  361. package/templates/runner/src/render/palette.ts +30 -0
  362. package/templates/runner/src/render/postprocessing.ts +34 -0
  363. package/templates/runner/src/render/quality.ts +170 -0
  364. package/templates/runner/src/render/shapes.ts +68 -0
  365. package/templates/runner/src/render/sky.ts +51 -0
  366. package/templates/runner/src/render/touch-controls.ts +185 -0
  367. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  368. package/templates/runner/src/scenes/Boot.ts +12 -0
  369. package/templates/runner/src/scenes/Run.ts +142 -0
  370. package/templates/runner/src/state.ts +29 -0
  371. package/templates/runner/src/style.css +96 -0
  372. package/templates/runner/src/track.ts +176 -0
  373. package/templates/runner/src/ui/App.tsx +22 -0
  374. package/templates/runner/src/ui/GameUi.tsx +20 -0
  375. package/templates/runner/src/ui/Hud.tsx +55 -0
  376. package/templates/runner/src/ui/Menu.tsx +7 -0
  377. package/templates/runner/src/ui/main.tsx +14 -0
  378. package/templates/runner/tailwind.config.ts +1 -0
  379. package/templates/runner/threenative.config.ts +49 -0
  380. package/templates/runner/tsconfig.json +17 -0
  381. package/templates/runner/vite.config.ts +38 -0
  382. package/templates/sailing/.codex/config.toml +19 -0
  383. package/templates/sailing/.cursor/mcp.json +32 -0
  384. package/templates/sailing/.gemini/settings.json +32 -0
  385. package/templates/sailing/.mcp.json +32 -0
  386. package/templates/sailing/.vscode/mcp.json +36 -0
  387. package/templates/sailing/.zed/settings.json +36 -0
  388. package/templates/sailing/AGENTS.md +95 -0
  389. package/templates/sailing/CLAUDE.md +97 -0
  390. package/templates/sailing/README.md +28 -0
  391. package/templates/sailing/index.html +12 -0
  392. package/templates/sailing/kit.json +7 -0
  393. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  394. package/templates/sailing/native-playtests/survives.playtest.json +38 -0
  395. package/templates/sailing/opencode.json +41 -0
  396. package/templates/sailing/package.json +52 -0
  397. package/templates/sailing/playtests/fail.playtest.json +24 -0
  398. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  399. package/templates/sailing/playtests/float.playtest.json +59 -0
  400. package/templates/sailing/playtests/performance.playtest.json +36 -0
  401. package/templates/sailing/playtests/survives.playtest.json +46 -0
  402. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  403. package/templates/sailing/playtests/win.playtest.json +31 -0
  404. package/templates/sailing/public/favicon.svg +5 -0
  405. package/templates/sailing/src/conventions.ts +8 -0
  406. package/templates/sailing/src/entities/Ship.ts +233 -0
  407. package/templates/sailing/src/game.ts +40 -0
  408. package/templates/sailing/src/main.ts +15 -0
  409. package/templates/sailing/src/render/camera.ts +28 -0
  410. package/templates/sailing/src/render/lighting.ts +41 -0
  411. package/templates/sailing/src/render/loading.ts +325 -0
  412. package/templates/sailing/src/render/materials.ts +44 -0
  413. package/templates/sailing/src/render/ocean.ts +179 -0
  414. package/templates/sailing/src/render/palette.ts +17 -0
  415. package/templates/sailing/src/render/postprocessing.ts +34 -0
  416. package/templates/sailing/src/render/props.ts +602 -0
  417. package/templates/sailing/src/render/quality.ts +140 -0
  418. package/templates/sailing/src/render/sky.ts +37 -0
  419. package/templates/sailing/src/render/touch-controls.ts +142 -0
  420. package/templates/sailing/src/render/worldEnvironment.ts +758 -0
  421. package/templates/sailing/src/scenes/Boot.ts +12 -0
  422. package/templates/sailing/src/scenes/Sailing.ts +133 -0
  423. package/templates/sailing/src/state.ts +10 -0
  424. package/templates/sailing/src/style.css +81 -0
  425. package/templates/sailing/src/ui/App.tsx +15 -0
  426. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  427. package/templates/sailing/src/ui/Hud.tsx +55 -0
  428. package/templates/sailing/src/ui/Menu.tsx +30 -0
  429. package/templates/sailing/src/ui/main.tsx +7 -0
  430. package/templates/sailing/tailwind.config.ts +2 -0
  431. package/templates/sailing/threenative.config.ts +40 -0
  432. package/templates/sailing/tsconfig.json +17 -0
  433. package/templates/sailing/vite.config.ts +34 -0
  434. package/templates/shooter/.codex/config.toml +19 -0
  435. package/templates/shooter/.cursor/mcp.json +32 -0
  436. package/templates/shooter/.gemini/settings.json +32 -0
  437. package/templates/shooter/.mcp.json +18 -2
  438. package/templates/shooter/.vscode/mcp.json +36 -0
  439. package/templates/shooter/.zed/settings.json +36 -0
  440. package/templates/shooter/AGENTS.md +81 -54
  441. package/templates/shooter/CLAUDE.md +81 -54
  442. package/templates/shooter/index.html +0 -1
  443. package/templates/shooter/kit.json +2 -2
  444. package/templates/shooter/opencode.json +41 -0
  445. package/templates/shooter/package.json +16 -11
  446. package/templates/shooter/playtests/combat.playtest.json +48 -0
  447. package/templates/shooter/playtests/fail.playtest.json +5 -4
  448. package/templates/shooter/playtests/input-control.playtest.json +261 -0
  449. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  450. package/templates/shooter/playtests/performance.playtest.json +39 -0
  451. package/templates/shooter/playtests/shooter.playtest.json +31 -21
  452. package/templates/shooter/playtests/survives.playtest.json +28 -1
  453. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  454. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  455. package/templates/shooter/public/favicon.svg +1 -1
  456. package/templates/shooter/src/combat/damage.ts +1 -2
  457. package/templates/shooter/src/conventions.ts +51 -0
  458. package/templates/shooter/src/entities/Player.ts +235 -18
  459. package/templates/shooter/src/entities/Target.ts +2 -2
  460. package/templates/shooter/src/game.ts +35 -3
  461. package/templates/shooter/src/main.ts +3 -13
  462. package/templates/shooter/src/render/camera.ts +78 -18
  463. package/templates/shooter/src/render/decals.ts +211 -0
  464. package/templates/shooter/src/render/lighting.ts +13 -4
  465. package/templates/shooter/src/render/loading.ts +274 -35
  466. package/templates/shooter/src/render/materials.ts +56 -3
  467. package/templates/shooter/src/render/palette.ts +6 -3
  468. package/templates/shooter/src/render/postprocessing.ts +32 -17
  469. package/templates/shooter/src/render/quality.ts +170 -0
  470. package/templates/shooter/src/render/scale.ts +22 -0
  471. package/templates/shooter/src/render/shapes.ts +519 -60
  472. package/templates/shooter/src/render/sky.ts +5 -1
  473. package/templates/shooter/src/render/touch-controls.ts +305 -0
  474. package/templates/shooter/src/render/ui.css +119 -1
  475. package/templates/shooter/src/render/ui.ts +19 -3
  476. package/templates/shooter/src/render/vfx.ts +215 -0
  477. package/templates/shooter/src/render/worldEnvironment.ts +758 -0
  478. package/templates/shooter/src/scenes/Play.ts +385 -97
  479. package/templates/shooter/src/state.ts +18 -0
  480. package/templates/shooter/src/style.css +46 -0
  481. package/templates/shooter/src/ui/App.tsx +10 -12
  482. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  483. package/templates/shooter/src/ui/GameUi.tsx +22 -0
  484. package/templates/shooter/src/ui/Hud.tsx +14 -10
  485. package/templates/shooter/src/ui/Menu.tsx +24 -9
  486. package/templates/shooter/src/ui/main.tsx +15 -0
  487. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  488. package/templates/shooter/src/weapons/Projectile.ts +29 -13
  489. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  490. package/templates/shooter/threenative.config.ts +28 -8
  491. package/templates/shooter/vite.config.ts +32 -2
  492. package/templates/starter/.codex/config.toml +19 -0
  493. package/templates/starter/.cursor/mcp.json +32 -0
  494. package/templates/starter/.gemini/settings.json +32 -0
  495. package/templates/starter/.mcp.json +18 -2
  496. package/templates/starter/.vscode/mcp.json +36 -0
  497. package/templates/starter/.zed/settings.json +36 -0
  498. package/templates/starter/AGENTS.md +72 -426
  499. package/templates/starter/CLAUDE.md +72 -426
  500. package/templates/starter/assets/pickup.wav +0 -0
  501. package/templates/starter/gitignore +4 -0
  502. package/templates/starter/index.html +0 -1
  503. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  504. package/templates/starter/native-playtests/render-chain.playtest.json +81 -0
  505. package/templates/starter/opencode.json +41 -0
  506. package/templates/starter/package.json +16 -12
  507. package/templates/starter/playtests/assets.playtest.json +65 -0
  508. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  509. package/templates/starter/playtests/buffer.playtest.json +59 -9
  510. package/templates/starter/playtests/cloth.playtest.json +113 -0
  511. package/templates/starter/playtests/coyote.playtest.json +60 -8
  512. package/templates/starter/playtests/forward.playtest.json +29 -4
  513. package/templates/starter/playtests/gameover.playtest.json +66 -0
  514. package/templates/starter/playtests/goal.playtest.json +67 -0
  515. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  516. package/templates/starter/playtests/look.playtest.json +142 -10
  517. package/templates/starter/playtests/models-baseline.png +0 -0
  518. package/templates/starter/playtests/models.playtest.json +74 -0
  519. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  520. package/templates/starter/playtests/odometer.playtest.json +54 -0
  521. package/templates/starter/playtests/pause.playtest.json +27 -4
  522. package/templates/starter/playtests/play.playtest.json +44 -7
  523. package/templates/starter/playtests/respawn.playtest.json +46 -6
  524. package/templates/starter/playtests/restart.playtest.json +65 -10
  525. package/templates/starter/playtests/seed.playtest.json +44 -8
  526. package/templates/starter/playtests/survives.playtest.json +48 -4
  527. package/templates/starter/playtests/textures-baseline.png +0 -0
  528. package/templates/starter/playtests/textures.playtest.json +74 -0
  529. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  530. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  531. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  532. package/templates/starter/src/conventions.ts +18 -0
  533. package/templates/starter/src/entities/Goal.ts +137 -0
  534. package/templates/starter/src/entities/Player.ts +111 -10
  535. package/templates/starter/src/game.ts +27 -0
  536. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  537. package/templates/starter/src/render/camera.ts +31 -5
  538. package/templates/starter/src/render/coast.ts +199 -0
  539. package/templates/starter/src/render/easing.ts +5 -0
  540. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  541. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  542. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  543. package/templates/starter/src/render/hero.ts +88 -0
  544. package/templates/starter/src/render/implicitSurface.ts +199 -0
  545. package/templates/starter/src/render/kuwahara.ts +174 -0
  546. package/templates/starter/src/render/lighting.ts +10 -5
  547. package/templates/starter/src/render/loading.ts +325 -0
  548. package/templates/starter/src/render/materials.ts +39 -4
  549. package/templates/starter/src/render/outline.ts +141 -0
  550. package/templates/starter/src/render/painterly.ts +86 -0
  551. package/templates/starter/src/render/palette.ts +15 -6
  552. package/templates/starter/src/render/pennant.ts +54 -0
  553. package/templates/starter/src/render/postprocessing.ts +97 -15
  554. package/templates/starter/src/render/quality.ts +185 -0
  555. package/templates/starter/src/render/rockRidge.ts +198 -0
  556. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  557. package/templates/starter/src/render/scenery.ts +40 -0
  558. package/templates/starter/src/render/shapes.ts +9 -21
  559. package/templates/starter/src/render/textureLifetime.ts +53 -0
  560. package/templates/starter/src/render/touch-controls.ts +165 -0
  561. package/templates/starter/src/render/water.ts +38 -0
  562. package/templates/starter/src/render/watercolor.ts +85 -0
  563. package/templates/starter/src/render/worldEnvironment.ts +758 -0
  564. package/templates/starter/src/scenes/Play.ts +243 -46
  565. package/templates/starter/src/state.ts +12 -0
  566. package/templates/starter/src/style.css +72 -8
  567. package/templates/starter/src/ui/App.tsx +9 -6
  568. package/templates/starter/src/ui/GameUi.tsx +20 -0
  569. package/templates/starter/src/ui/Hud.tsx +52 -29
  570. package/templates/starter/src/ui/Menu.tsx +25 -23
  571. package/templates/starter/src/ui/main.tsx +14 -0
  572. package/templates/starter/threenative.config.ts +27 -9
  573. package/templates/starter/tools/look.mjs +109 -0
  574. package/templates/starter/vite.config.ts +32 -2
  575. package/templates/action-rpg/src/physics.ts +0 -40
  576. package/templates/minimal/assets/.gitkeep +0 -0
  577. package/templates/minimal/public/.gitkeep +0 -0
  578. package/templates/minimal/public/icon.png +0 -0
  579. package/templates/platformer/assets/.gitkeep +0 -0
  580. package/templates/platformer/public/.gitkeep +0 -0
  581. package/templates/platformer/public/icon.png +0 -0
  582. package/templates/shooter/src/physics.ts +0 -49
  583. package/templates/starter/assets/.gitkeep +0 -0
  584. package/templates/starter/public/.gitkeep +0 -0
  585. package/templates/starter/public/icon.png +0 -0
  586. package/templates/starter/public/pickup.ogg +0 -0
  587. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  588. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -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 }));
@@ -0,0 +1,19 @@
1
+ import type { IPhysicsContext } from "@threenative/physics";
2
+
3
+ /**
4
+ * One bit per thing that can touch another thing.
5
+ *
6
+ * Layers are the game's, not the framework's: `interactionGroups` from `@threenative/physics`
7
+ * encodes whichever numbers you put here into a Rapier group. Keep them powers of two and keep
8
+ * the meaning in one place — a mask assembled inline at three call sites is how a crate quietly
9
+ * stops colliding with the ball.
10
+ */
11
+ export const ROOM_LAYER = 1;
12
+ export const CRATE_LAYER = 2;
13
+ export const BALL_LAYER = 4;
14
+ export const WEIGHT_LAYER = 8;
15
+
16
+ export const CRATE_MASK = ROOM_LAYER | CRATE_LAYER | BALL_LAYER | WEIGHT_LAYER;
17
+ export const BALL_MASK = ROOM_LAYER | CRATE_LAYER | BALL_LAYER | WEIGHT_LAYER;
18
+
19
+ export type PuzzlePhysics = IPhysicsContext;
@@ -0,0 +1,37 @@
1
+ import type { PerspectiveCamera, Vector3 } from "three";
2
+
3
+ const HEIGHT = 20;
4
+ const BACK = 17;
5
+ /** How far the rig is allowed to lean toward the claw. A puzzle is read by comparing two things
6
+ * that are not moving, so the frame must stay still enough to compare them. */
7
+ const LEAN = 2.4;
8
+ // Biased toward the far half, but not so far that the claw's spawn sits on the bottom edge —
9
+ // which is exactly where the first framing put it.
10
+ const LOOK_AT = { x: 0, y: 0.4, z: 0.6 };
11
+
12
+ export function setupCamera(camera: PerspectiveCamera): void {
13
+ camera.fov = 42;
14
+ camera.near = 0.1;
15
+ camera.far = 120;
16
+ camera.position.set(0, HEIGHT, BACK);
17
+ camera.lookAt(LOOK_AT.x, LOOK_AT.y, LOOK_AT.z);
18
+ camera.updateProjectionMatrix();
19
+ }
20
+
21
+ /**
22
+ * A fixed three-quarter rig that leans toward the claw and never leaves the room.
23
+ *
24
+ * The lean is clamped and the look-at target is constant. An earlier version scaled both the
25
+ * position and the target by the claw's position; walking to a wall then swung the whole frame
26
+ * outside the room and tipped the floor plane, which looked like a broken scene and was a broken
27
+ * camera. Damping a bounded offset around a fixed target cannot do that.
28
+ */
29
+ export function followGripper(camera: PerspectiveCamera, target: Vector3, dt: number): void {
30
+ const blend = Math.min(1, Math.max(0, dt) * 3);
31
+ const wantX = Math.max(-LEAN, Math.min(LEAN, target.x * 0.3));
32
+ const wantZ = BACK + Math.max(-LEAN, Math.min(LEAN, target.z * 0.2));
33
+ camera.position.x += (wantX - camera.position.x) * blend;
34
+ camera.position.z += (wantZ - camera.position.z) * blend;
35
+ camera.position.y = HEIGHT;
36
+ camera.lookAt(LOOK_AT.x, LOOK_AT.y, LOOK_AT.z);
37
+ }
@@ -0,0 +1,55 @@
1
+ import {
2
+ AmbientLight,
3
+ DirectionalLight,
4
+ HemisphereLight,
5
+ PCFSoftShadowMap,
6
+ type Scene,
7
+ } from "three";
8
+ import { palette } from "./palette.js";
9
+
10
+ type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
11
+
12
+ /**
13
+ * Key, fill, rim, ambient — named, so each one can be changed on its own.
14
+ *
15
+ * An indoor contraption room lives or dies on contact shadows: the player has to see that a crate
16
+ * is *on* the floor and that the ball is *touching* the ramp, or every physical judgement becomes
17
+ * a guess. So the key is hard, with a tight shadow frustum.
18
+ *
19
+ * It is also nearly overhead, and that was a fix rather than a preference. A key at fifteen
20
+ * degrees off the horizon threw the left wall across half the play area, and the first capture
21
+ * had a black floor on one side and a legible one on the other — the room looked broken. In an
22
+ * interior with walls this tall, the key belongs above the room and the fill has to be strong
23
+ * enough that its shadow still has a readable floor inside it.
24
+ *
25
+ * Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
26
+ * the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
27
+ * rendering a black pass.
28
+ */
29
+ export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
30
+ renderer.shadowMap.enabled = true;
31
+ renderer.shadowMap.type = PCFSoftShadowMap;
32
+ scene.add(new HemisphereLight(palette.skyLow, palette.floor, 2.4));
33
+
34
+ const key = new DirectionalLight(0xfff2dd, 3);
35
+ key.position.set(-4, 24, 7);
36
+ key.castShadow = true;
37
+ key.shadow.mapSize.set(1024, 1024);
38
+ key.shadow.camera.near = 0.5;
39
+ key.shadow.camera.far = 70;
40
+ key.shadow.camera.left = -18;
41
+ key.shadow.camera.right = 18;
42
+ key.shadow.camera.top = 18;
43
+ key.shadow.camera.bottom = -18;
44
+ key.shadow.normalBias = 0.035;
45
+ scene.add(key);
46
+
47
+ // Cool, from behind and low: it separates the steel and the wall tops from the dark beyond the
48
+ // room without adding a second set of shadows to read.
49
+ const rim = new DirectionalLight(palette.skyLow, 1.3);
50
+ rim.position.set(9, 5, -14);
51
+ scene.add(rim);
52
+ scene.add(new AmbientLight(palette.skyLow, 0.5));
53
+
54
+ return key;
55
+ }