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,83 @@
1
+ import { InstancedBatch } from "@threenative/core";
2
+ import { buildStaticColliders } from "@threenative/physics";
3
+ import { Group, type Object3D } from "three";
4
+ import { floorSlab, floorTile, gantry, ramp, wallSlab } from "./render/shapes.js";
5
+
6
+ export const ROOM_WIDTH = 22;
7
+ export const ROOM_DEPTH = 26;
8
+ export const WALL_HEIGHT = 4.4;
9
+ export const GANTRY_HEIGHT = 5;
10
+ export const GANTRY_SPAN = 5.4;
11
+ /** Where the ball starts, and where it has to end up. */
12
+ export const BALL_START = { x: -5.5, y: 0.5, z: 7 } as const;
13
+ export const GOAL_POSITION = { x: 5.4, y: 0, z: -8.4 } as const;
14
+
15
+ /**
16
+ * Every mesh the ball can hit and none it cannot.
17
+ *
18
+ * `buildStaticColliders` reads the meshes a game authored and builds fixed trimesh bodies from
19
+ * them, so the room's collision is the room's geometry rather than a second, hand-written list of
20
+ * boxes that drifts from it the first time a wall moves. The predicate is the game's: only meshes
21
+ * this file named `room-*` become colliders, so the floor tiles and the goal ring stay decorative.
22
+ */
23
+ export function buildRoom(): Group {
24
+ const room = new Group();
25
+ room.name = "room";
26
+ room.add(floorSlab(ROOM_WIDTH, ROOM_DEPTH));
27
+
28
+ const half = { x: ROOM_WIDTH / 2, z: ROOM_DEPTH / 2 };
29
+ for (const [width, depth, x, z] of [
30
+ [ROOM_WIDTH, 0.6, 0, -half.z],
31
+ [ROOM_WIDTH, 0.6, 0, half.z],
32
+ [0.6, ROOM_DEPTH, -half.x, 0],
33
+ [0.6, ROOM_DEPTH, half.x, 0],
34
+ ] as const) {
35
+ const wall = wallSlab(width, WALL_HEIGHT, depth);
36
+ wall.position.set(x, WALL_HEIGHT / 2, z);
37
+ room.add(wall);
38
+ }
39
+
40
+ // The lip the ball cannot clear on its own. Everything the player does is in service of
41
+ // getting past this one 0.55m step.
42
+ const lip = ramp(ROOM_WIDTH - 1.2, 0.55, 0.9);
43
+ lip.position.set(0, 0.275, -1.5);
44
+ room.add(lip);
45
+
46
+ const frame = gantry(GANTRY_SPAN, GANTRY_HEIGHT);
47
+ frame.position.set(0, 0, 3.2);
48
+ room.add(frame);
49
+ return room;
50
+ }
51
+
52
+ /**
53
+ * The floor's tile grid, as one draw.
54
+ *
55
+ * `InstancedBatch` takes the geometry and the material from the game and places copies as the
56
+ * layout is walked, so the grid never has to be counted first. Two hundred and forty tiles cost
57
+ * one draw call, which is why the room can have a readable floor at all.
58
+ */
59
+ export function buildFloorTiles(parent: Object3D, size = 2): void {
60
+ const { geometry, material } = floorTile(size);
61
+ const tiles = new InstancedBatch({ geometry, material });
62
+ const columns = Math.floor((ROOM_WIDTH - 1) / size);
63
+ const rows = Math.floor((ROOM_DEPTH - 1) / size);
64
+ for (let column = 0; column < columns; column += 1) {
65
+ for (let row = 0; row < rows; row += 1) {
66
+ if ((column + row) % 2 === 1) continue;
67
+ tiles.place({
68
+ position: [
69
+ (column + 0.5) * size - (columns * size) / 2,
70
+ 0.03,
71
+ (row + 0.5) * size - (rows * size) / 2,
72
+ ],
73
+ });
74
+ }
75
+ }
76
+ tiles.build({ name: "floor-tiles", parent, receiveShadow: true });
77
+ }
78
+
79
+ export function collideRoom(physics: Parameters<typeof buildStaticColliders>[0], room: Object3D) {
80
+ return buildStaticColliders(physics, room, {
81
+ predicate: (object) => object.name.startsWith("room-"),
82
+ });
83
+ }
@@ -0,0 +1,12 @@
1
+ import { Scene } from "@threenative/core";
2
+ import type { PuzzlePhysics } from "../physics.js";
3
+ import type { GameState } from "../state.js";
4
+ import { type GameCtx, Puzzle } from "./Puzzle.js";
5
+
6
+ export class Boot extends Scene<GameState, PuzzlePhysics> {
7
+ static override readonly initialState = Puzzle.initialState;
8
+
9
+ override enter(ctx: GameCtx): void {
10
+ void ctx.goto("puzzle");
11
+ }
12
+ }
@@ -0,0 +1,158 @@
1
+ import {
2
+ type ICtx,
3
+ Scene,
4
+ type SceneFrame,
5
+ afterPhysics,
6
+ isMobile,
7
+ isTouchscreenAvailable,
8
+ } from "@threenative/core";
9
+ import { type PerspectiveCamera, Vector3 } from "three";
10
+ import { Ball } from "../entities/Ball.js";
11
+ import { Crate } from "../entities/Crate.js";
12
+ import { Gripper } from "../entities/Gripper.js";
13
+ import { Pendulum } from "../entities/Pendulum.js";
14
+ import type { PuzzlePhysics } from "../physics.js";
15
+ import { followGripper, setupCamera } from "../render/camera.js";
16
+ import { setupLighting } from "../render/lighting.js";
17
+ import { createLoadingScreen } from "../render/loading.js";
18
+ import { setupPost } from "../render/postprocessing.js";
19
+ import { goalRing } from "../render/shapes.js";
20
+ import { setupSky } from "../render/sky.js";
21
+ import { TouchControls } from "../render/touch-controls.js";
22
+ import { GOAL_POSITION, buildFloorTiles, buildRoom, collideRoom } from "../room.js";
23
+ import { FLOOR_FAIL_Y, type GameState, INITIAL_STATE } from "../state.js";
24
+
25
+ export type GameCtx = ICtx<GameState, PuzzlePhysics>;
26
+
27
+ /** Where the three crates start. Move them and the puzzle changes; that is the intent. */
28
+ const CRATE_SPAWNS = [
29
+ // The first crate sits straight ahead of the claw's spawn, just outside grab range: walking
30
+ // forward and pressing grab is the first thing the room teaches, and `playtests/carry` is that
31
+ // exact walk. Move this and the scenario's hold has to move with it.
32
+ new Vector3(-5.5, 0.6, 6.2),
33
+ new Vector3(-1.6, 0.6, 4.4),
34
+ new Vector3(2.8, 0.6, 5.4),
35
+ ] as const;
36
+ const GRAB_RANGE = 2.1;
37
+
38
+ export class Puzzle extends Scene<GameState, PuzzlePhysics> {
39
+ static override readonly initialState = INITIAL_STATE;
40
+
41
+ override enter(ctx: GameCtx): SceneFrame<GameState, PuzzlePhysics> {
42
+ setupSky(ctx.scene);
43
+ const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
44
+ // isMobile() arrives as an argument because src/render/ imports no framework package: the
45
+ // platform decision is made here, in portable game code.
46
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, { godraysLight: sun, mobile: isMobile() });
47
+ const camera = ctx.camera as PerspectiveCamera;
48
+ setupCamera(camera);
49
+ ctx.add(camera);
50
+ const loading = createLoadingScreen(ctx);
51
+
52
+ const room = buildRoom();
53
+ ctx.add(room);
54
+ buildFloorTiles(room);
55
+ collideRoom(ctx, room);
56
+ const ring = goalRing();
57
+ ring.position.set(GOAL_POSITION.x, GOAL_POSITION.y, GOAL_POSITION.z);
58
+ ctx.add(ring);
59
+
60
+ const showTouchControls = isMobile() && isTouchscreenAvailable();
61
+ const touchControls = showTouchControls
62
+ ? ctx.entities.add("touch-controls", new TouchControls(camera))
63
+ : undefined;
64
+
65
+ const gripper = new Gripper(ctx);
66
+ ctx.entities.add("player", gripper);
67
+ const ball = new Ball(ctx);
68
+ ctx.entities.add("ball", ball);
69
+ const pendulum = new Pendulum(ctx);
70
+ ctx.entities.add("pendulum", pendulum);
71
+ const crates = CRATE_SPAWNS.map((spawn, index) => {
72
+ const crate = new Crate(ctx, spawn, String(index));
73
+ ctx.entities.add(`crate.${index}`, crate);
74
+ return crate;
75
+ });
76
+
77
+ let held: Crate | undefined;
78
+ let cratesMoved = 0;
79
+ let elapsed = 0;
80
+ let status = INITIAL_STATE.status;
81
+
82
+ const nearest = (): Crate | undefined => {
83
+ let best: Crate | undefined;
84
+ let bestDistance = GRAB_RANGE * GRAB_RANGE;
85
+ for (const crate of crates) {
86
+ const distance = crate.mesh.position.distanceToSquared(gripper.mesh.position);
87
+ if (distance > bestDistance) continue;
88
+ best = crate;
89
+ bestDistance = distance;
90
+ }
91
+ return best;
92
+ };
93
+ const toggleGrab = (): void => {
94
+ if (held !== undefined) {
95
+ held.release();
96
+ held = undefined;
97
+ cratesMoved += 1;
98
+ return;
99
+ }
100
+ held = nearest();
101
+ held?.hold();
102
+ };
103
+
104
+ // The pointer is the other way in. `ctx.pointer` dispatches to the meshes the game
105
+ // registered, so a tap on a crate is a grab without a raycast written here.
106
+ for (const crate of crates) {
107
+ ctx.pointer?.on(crate.mesh, "tapped", () => {
108
+ if (held !== undefined) return;
109
+ held = crate;
110
+ crate.hold();
111
+ });
112
+ }
113
+
114
+ // The camera reads a body physics has already moved this frame, so it runs after the step
115
+ // rather than before it. Reading in the frame function instead is one step of lag, and on a
116
+ // swinging weight one step of lag is visible.
117
+ afterPhysics(ctx, (dt) => followGripper(camera, gripper.mesh.position, dt));
118
+
119
+ return (frameCtx, dt) => {
120
+ loading.update();
121
+ if (frameCtx.input.justPressed("restart")) {
122
+ frameCtx.state.set(INITIAL_STATE);
123
+ frameCtx.state.flush();
124
+ void frameCtx.goto("puzzle");
125
+ return;
126
+ }
127
+
128
+ const touch = touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size);
129
+ elapsed += dt;
130
+ gripper.update(frameCtx, dt, touch);
131
+ if (frameCtx.input.justPressed("grab") || touch?.grabPressed === true) toggleGrab();
132
+ if (frameCtx.input.justPressed("swing") || touch?.swingPressed === true) pendulum.swing();
133
+ held?.carry(gripper.mesh.position, dt);
134
+ if (ball.scored) status = "SOLVED";
135
+ // A ball that left the room is a level bug, not a loss: say so rather than waiting forever.
136
+ if (ball.mesh.position.y < FLOOR_FAIL_Y) ball.body.linearVelocity = { x: 0, y: 0, z: 0 };
137
+
138
+ const previous = frameCtx.state.getState();
139
+ const next: GameState = {
140
+ cratesMoved,
141
+ elapsed,
142
+ holding: held !== undefined,
143
+ paused: previous.paused,
144
+ status,
145
+ swings: pendulum.swings,
146
+ uiReady: previous.uiReady,
147
+ };
148
+ if (
149
+ next.cratesMoved !== previous.cratesMoved ||
150
+ next.holding !== previous.holding ||
151
+ next.status !== previous.status ||
152
+ next.swings !== previous.swings ||
153
+ Math.floor(next.elapsed) !== Math.floor(previous.elapsed)
154
+ )
155
+ frameCtx.state.set(next);
156
+ };
157
+ }
158
+ }
@@ -0,0 +1,30 @@
1
+ export type PuzzleStatus = "PLAYING" | "SOLVED";
2
+
3
+ /** How far the ball may drift below the floor before the run is treated as lost geometry. */
4
+ export const FLOOR_FAIL_Y = -6;
5
+
6
+ export type GameState = {
7
+ /** Set from the UI's pause and resume intents, and read back by the menu. */
8
+ paused: boolean;
9
+ /** True once the UI layer has rendered and published its interactive rectangles. */
10
+ uiReady: boolean;
11
+ /** How many crates the player has picked up and set down again. */
12
+ cratesMoved: number;
13
+ /** Seconds since the room opened. */
14
+ elapsed: number;
15
+ /** True while a crate is held by the pointer or by the grab key. */
16
+ holding: boolean;
17
+ /** How many times the hinged weight has been released. */
18
+ swings: number;
19
+ status: PuzzleStatus;
20
+ };
21
+
22
+ export const INITIAL_STATE: GameState = {
23
+ paused: false,
24
+ uiReady: false,
25
+ cratesMoved: 0,
26
+ elapsed: 0,
27
+ holding: false,
28
+ swings: 0,
29
+ status: "PLAYING",
30
+ };
@@ -0,0 +1,96 @@
1
+ @import "tailwindcss";
2
+
3
+ @source "../index.html";
4
+ @source "./";
5
+
6
+ @theme {
7
+ --color-ink: #07131d;
8
+ --color-panel: #0d2430;
9
+ --color-line: #1d4a58;
10
+ --color-lume: #f5c451;
11
+ --color-win: #79e0b2;
12
+ --color-danger: #ff7182;
13
+ --color-text: #c1dce2;
14
+ --color-muted: #6c9aa5;
15
+ --font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
16
+ }
17
+
18
+ html,
19
+ body,
20
+ #root {
21
+ width: 100%;
22
+ height: 100%;
23
+ margin: 0;
24
+ overflow: hidden;
25
+ }
26
+
27
+ body {
28
+ color: var(--color-text);
29
+ font-family: var(--font-mono);
30
+ -webkit-font-smoothing: antialiased;
31
+ }
32
+
33
+ /*
34
+ * The page's backdrop belongs to the web document's own mount point, never to `body`.
35
+ * `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
36
+ * transparent web view loads over the game: a `body` background there paints an opaque sheet over
37
+ * the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
38
+ * in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
39
+ */
40
+
41
+ #root {
42
+ background: var(--color-ink);
43
+ }
44
+
45
+ /* Boot failures are a page state, so the generated game owns their presentation. */
46
+ [data-threenative-canvas-error="true"] {
47
+ position: fixed;
48
+ inset: 0;
49
+ z-index: 1000;
50
+ display: grid;
51
+ place-items: center;
52
+ box-sizing: border-box;
53
+ padding: clamp(1.5rem, 8vw, 6rem);
54
+ overflow: auto;
55
+ background: #fff7ed;
56
+ color: var(--color-ink);
57
+ font-family: inherit;
58
+ font-size: clamp(1rem, 2vw, 1.5rem);
59
+ line-height: 1.5;
60
+ text-align: center;
61
+ white-space: pre-wrap;
62
+ overflow-wrap: anywhere;
63
+ }
64
+
65
+ /* The debug surface is framework plumbing; its default presentation is yours to change. */
66
+ [data-threenative-debug-overlay="true"] {
67
+ position: fixed;
68
+ top: 1rem;
69
+ right: 1rem;
70
+ z-index: 50;
71
+ max-width: 24rem;
72
+ padding: 0.75rem;
73
+ pointer-events: none;
74
+ background: rgb(2 6 23 / 90%);
75
+ box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
76
+ color: #cffafe;
77
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
78
+ font-size: 12px;
79
+ line-height: 1.5;
80
+ }
81
+
82
+ [data-threenative-debug-overlay="true"] table {
83
+ width: 100%;
84
+ table-layout: fixed;
85
+ }
86
+
87
+ [data-threenative-debug-overlay="true"] th,
88
+ [data-threenative-debug-overlay="true"] td {
89
+ padding-right: 1rem;
90
+ text-align: left;
91
+ }
92
+
93
+ [data-threenative-debug-overlay="true"] td:last-child {
94
+ overflow-wrap: anywhere;
95
+ word-break: break-all;
96
+ }
@@ -0,0 +1,22 @@
1
+ import type { IGame } from "@threenative/core";
2
+ import { DebugOverlay, GameCanvas } from "@threenative/ui";
3
+ import type { PuzzlePhysics } from "../physics.js";
4
+ import type { GameState } from "../state.js";
5
+ import { GameUi } from "./GameUi.js";
6
+
7
+ /**
8
+ * The web target's page: the canvas, then the same UI every other target renders.
9
+ *
10
+ * `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first.
11
+ * The UI itself comes from `GameUi`, unchanged — this file exists only because the web build also
12
+ * has to put a canvas on the page.
13
+ */
14
+ export function App({ game }: { game: IGame<GameState, PuzzlePhysics> }) {
15
+ return (
16
+ <main className="relative h-screen w-screen overflow-hidden bg-ink">
17
+ <GameCanvas className="absolute inset-0" game={game} />
18
+ <GameUi />
19
+ <DebugOverlay />
20
+ </main>
21
+ );
22
+ }
@@ -0,0 +1,20 @@
1
+ import { UiLayer } from "@threenative/ui";
2
+ import { Hud } from "./Hud.js";
3
+ import { Menu } from "./Menu.js";
4
+
5
+ /**
6
+ * Everything the player sees that is not the scene.
7
+ *
8
+ * One component, mounted twice by two entries that differ only in what else is on the page:
9
+ * `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
10
+ * page the native web view loads. Keeping both entries pointed at this file is what makes "the
11
+ * same UI on every target" a fact rather than an intention.
12
+ */
13
+ export function GameUi() {
14
+ return (
15
+ <UiLayer>
16
+ <Hud />
17
+ <Menu />
18
+ </UiLayer>
19
+ );
20
+ }
@@ -0,0 +1,57 @@
1
+ import { useUiState } from "@threenative/ui";
2
+ import type { GameState } from "../state.js";
3
+
4
+ export function Hud() {
5
+ const state = useUiState<GameState>();
6
+ // Nothing to draw until the game publishes its first snapshot, a few milliseconds in.
7
+ // Rendering zeroes instead would put wrong numbers on screen and then correct them.
8
+ if (state === undefined) return null;
9
+ const solved = state.status === "SOLVED";
10
+ return (
11
+ <div className="pointer-events-none absolute inset-0 p-6 text-[11px] uppercase tracking-[0.16em] text-text">
12
+ <div className="flex items-start justify-between">
13
+ <div>
14
+ <div className="text-[10px] text-muted">contraption room 01</div>
15
+ <div className="mt-2 flex items-baseline gap-5 text-[18px] text-white">
16
+ <span>
17
+ time <b id="elapsed">{Math.floor(state.elapsed)}</b>s
18
+ </span>
19
+ <span className={solved ? "text-win" : "text-lume"} id="status">
20
+ {state.status}
21
+ </span>
22
+ </div>
23
+ </div>
24
+ <div className="text-right">
25
+ <div className="text-[10px] text-muted">crates moved</div>
26
+ <div className="mt-2 text-[22px] text-white" id="crates">
27
+ {state.cratesMoved}
28
+ </div>
29
+ </div>
30
+ </div>
31
+ <div className="absolute bottom-6 left-6 flex items-end gap-8">
32
+ <div>
33
+ <div className="text-[10px] text-muted">swings</div>
34
+ <div className="mt-1 text-[26px] leading-none text-white" id="swings">
35
+ {state.swings}
36
+ </div>
37
+ </div>
38
+ <div>
39
+ <div className="text-[10px] text-muted">claw</div>
40
+ <div className="mt-1 text-[18px] leading-none text-white" id="holding">
41
+ {state.holding ? "holding" : "empty"}
42
+ </div>
43
+ </div>
44
+ <div className="text-[10px] leading-relaxed text-muted">
45
+ <div>wasd move · e grab · f swing</div>
46
+ <div>roll the ball into the ring</div>
47
+ </div>
48
+ </div>
49
+ {solved && (
50
+ <div className="absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 border border-win/70 bg-win/10 px-8 py-5 text-center">
51
+ <div className="text-[28px] tracking-[0.28em] text-win">SOLVED</div>
52
+ <div className="mt-2 text-[10px] text-muted">press R to reset the room</div>
53
+ </div>
54
+ )}
55
+ </div>
56
+ );
57
+ }
@@ -0,0 +1,7 @@
1
+ export function Menu() {
2
+ return (
3
+ <div className="pointer-events-none absolute bottom-6 right-6 border border-line bg-panel/80 px-4 py-3 text-[10px] uppercase tracking-[0.12em] text-muted">
4
+ tap a crate to grab · F swings the weight · R restart
5
+ </div>
6
+ );
7
+ }
@@ -0,0 +1,14 @@
1
+ import { createRoot } from "react-dom/client";
2
+ import { GameUi } from "./GameUi.js";
3
+ import "../style.css";
4
+
5
+ /**
6
+ * The UI entry the native web view loads.
7
+ *
8
+ * It mounts the UI and nothing else — no scene, no simulation, no renderer. The game runs beside
9
+ * it in the native runtime and reaches it only through published state and intents, which is why
10
+ * this file imports no game code at all.
11
+ */
12
+ const root = document.getElementById("tn-ui");
13
+ if (root === null) throw new Error("Missing #tn-ui element.");
14
+ createRoot(root).render(<GameUi />);
@@ -0,0 +1 @@
1
+ export default {};
@@ -0,0 +1,49 @@
1
+ import type { IThreeNativeConfig } from "@threenative/core";
2
+
3
+ const config: IThreeNativeConfig = {
4
+ app: {
5
+ id: "com.threenative.__PROJECT_ID__",
6
+ name: "__PROJECT_NAME__",
7
+ version: "1.0.0",
8
+ build: 1,
9
+ icon: "public/icon.png",
10
+ icons: { web: { favicon: "public/favicon.svg" } },
11
+ },
12
+ display: {
13
+ orientation: "landscape",
14
+ fullscreen: true,
15
+ keepScreenOn: true,
16
+ maxFps: 60,
17
+ },
18
+ window: {
19
+ title: "__PROJECT_NAME__",
20
+ width: 1280,
21
+ height: 720,
22
+ maximized: false,
23
+ resizable: true,
24
+ },
25
+ bootSplash: {
26
+ backgroundColor: "#07131d",
27
+ },
28
+ nativeEntry: "src/game.ts",
29
+ renderer: {
30
+ preferWebGPU: true, // Use WebGPU when the host exposes it.
31
+ // The engine holds the `display.maxFps` budget by scaling the 3D drawing buffer, and reports
32
+ // the scale it settled on in every `TN_FRAME_BUDGET` window. Replace with a number in (0, 1]
33
+ // to pin it — the loop stops and the reporting does not. CSS, UI and camera framing never move.
34
+ resolutionScale: "auto",
35
+ // Multisampling resolves triangle edges. A cutout silhouette — foliage, a fence, hair — is
36
+ // carved inside the triangle by an alpha test, so it resolves through the coverage mask or
37
+ // not at all, which is what this spends the samples above on. It costs no target and no
38
+ // extra pass; set it false for a deliberately hard-edged look. `TN_ALPHA_ANTIALIASING`
39
+ // reports what it did, and says so when a single-sampled surface leaves it nothing to do.
40
+ alphaAntialiasing: true,
41
+ },
42
+ // One UI on every target: src/ui/ renders through the platform's own browser-class renderer,
43
+ // so the same React, Tailwind, CSS and SVG run on web, desktop, Android and iOS alike.
44
+ // Switch to "native" for a UI drawn as part of the rendered frame, with no web view and no
45
+ // extra process — and own the appearance difference that comes with it.
46
+ ui: { renderer: "web" },
47
+ };
48
+
49
+ export default config;
@@ -0,0 +1,17 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "lib": ["ES2022", "DOM", "DOM.Iterable"],
5
+ "module": "ESNext",
6
+ "moduleResolution": "bundler",
7
+ "jsx": "react-jsx",
8
+ "types": ["vite/client"],
9
+ "strict": true,
10
+ "noUncheckedIndexedAccess": true,
11
+ "noEmit": true,
12
+ "skipLibCheck": true,
13
+ "verbatimModuleSyntax": true,
14
+ "isolatedModules": true
15
+ },
16
+ "include": ["src/**/*.ts", "src/**/*.tsx", "*.ts"]
17
+ }
@@ -0,0 +1,38 @@
1
+ import tailwindcss from "@tailwindcss/vite";
2
+ import { watchAssets } from "@threenative/assets";
3
+ import react from "@vitejs/plugin-react";
4
+ import { createEngineFreshnessPlugin, createWebBrandPlugin } from "create-threenative";
5
+ import { defineConfig } from "vite";
6
+ import type { Plugin } from "vite";
7
+ import config from "./threenative.config.js";
8
+
9
+ /**
10
+ * Recompiles assets/ into public/ while the dev server runs, so editing a texture does not
11
+ * need a rebuild. Serve-only by declaration: builds compile through `threenative build`.
12
+ */
13
+ function assetsWatchPlugin(): Plugin {
14
+ return {
15
+ name: "threenative-assets-watch",
16
+ apply: "serve",
17
+ configureServer(server) {
18
+ const handle = watchAssets({ config: config.assets, cwd: server.config.root });
19
+ server.httpServer?.once("close", () => handle.close());
20
+ },
21
+ };
22
+ }
23
+
24
+ export default defineConfig({
25
+ plugins: [
26
+ createEngineFreshnessPlugin(),
27
+ createWebBrandPlugin(),
28
+ react(),
29
+ tailwindcss(),
30
+ assetsWatchPlugin(),
31
+ ],
32
+ server: {
33
+ watch: {
34
+ ignored: ["**/artifacts/**", "**/screenshots/**", "**/playtests/**"],
35
+ usePolling: true,
36
+ },
37
+ },
38
+ });
@@ -13,3 +13,7 @@ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
13
13
  [mcp_servers.threenative-engine]
14
14
  command = "node"
15
15
  args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
16
+
17
+ [mcp_servers.threenative-blender]
18
+ command = "node"
19
+ args = ["./node_modules/@threenative/core/mcp/blender.mjs"]
@@ -0,0 +1,32 @@
1
+ {
2
+ "mcpServers": {
3
+ "threenative-assets": {
4
+ "command": "node",
5
+ "args": [
6
+ "./node_modules/@threenative/core/mcp/assets.mjs"
7
+ ],
8
+ "env": {
9
+ "ASSET_DOWNLOAD_DIR": "./public/assets",
10
+ "AUDIO_DOWNLOAD_DIR": "./public/audio"
11
+ }
12
+ },
13
+ "threenative-sculpt": {
14
+ "command": "node",
15
+ "args": [
16
+ "./node_modules/@threenative/core/mcp/sculpt.mjs"
17
+ ]
18
+ },
19
+ "threenative-engine": {
20
+ "command": "node",
21
+ "args": [
22
+ "./node_modules/@threenative/core/mcp/engine.mjs"
23
+ ]
24
+ },
25
+ "threenative-blender": {
26
+ "command": "node",
27
+ "args": [
28
+ "./node_modules/@threenative/core/mcp/blender.mjs"
29
+ ]
30
+ }
31
+ }
32
+ }