create-threenative 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (343) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +10 -2
  3. package/agent-docs/asset-mcp-loop.md +33 -0
  4. package/agent-docs/ctx-surface.md +69 -0
  5. package/agent-docs/engine-capabilities.md +4 -0
  6. package/agent-docs/framework-blocks-you.md +60 -0
  7. package/agent-docs/look-at-it-and-budget-the-look.md +27 -0
  8. package/agent-docs/performance-default.md +42 -0
  9. package/agent-docs/pixel-budget.md +20 -0
  10. package/agent-docs/playtest-fail-closed.md +23 -0
  11. package/agent-docs/references/assertion-reference.md +652 -0
  12. package/agent-docs/references/capability-reference.md +3279 -0
  13. package/agent-docs/references/capture-the-frame.md +53 -0
  14. package/agent-docs/references/ctx-cookbook.md +51 -0
  15. package/agent-docs/references/debug-surface.md +63 -0
  16. package/agent-docs/references/finding-assets.md +147 -0
  17. package/agent-docs/references/gameplay-recipes.md +54 -0
  18. package/agent-docs/references/menu-screens.md +69 -0
  19. package/agent-docs/references/mobile-memory-budget.md +87 -0
  20. package/agent-docs/references/sculpt-from-a-reference.md +39 -0
  21. package/agent-docs/references/visual-baseline.md +133 -0
  22. package/agent-docs/references/webview-ui.md +113 -0
  23. package/agent-docs/sculpt-loop.md +16 -0
  24. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  25. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  26. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  27. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  28. package/agent-files/.threenative/agents/builder.md +32 -0
  29. package/agent-files/.threenative/agents/verifier.md +31 -0
  30. package/agent-files/AGENT-ROLES.md +26 -0
  31. package/capabilities.json +3542 -0
  32. package/dist/index.d.ts +191 -3
  33. package/dist/index.js +1707 -73
  34. package/dist/threenative.d.ts +9 -2
  35. package/dist/threenative.js +1825 -148
  36. package/package.json +30 -6
  37. package/template-assets/loading.ts +315 -0
  38. package/template-assets/patches/three@0.185.1.patch +287 -0
  39. package/templates/action-rpg/.codex/config.toml +15 -0
  40. package/templates/action-rpg/.mcp.json +6 -2
  41. package/templates/action-rpg/AGENTS.md +370 -6
  42. package/templates/action-rpg/CLAUDE.md +370 -6
  43. package/templates/action-rpg/index.html +0 -1
  44. package/templates/action-rpg/package.json +15 -11
  45. package/templates/action-rpg/playtests/combat.playtest.json +23 -9
  46. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  47. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  48. package/templates/action-rpg/playtests/performance.playtest.json +22 -0
  49. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  50. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  51. package/templates/action-rpg/public/icon.png +0 -0
  52. package/templates/action-rpg/src/entities/Enemy.ts +14 -4
  53. package/templates/action-rpg/src/game.ts +21 -0
  54. package/templates/action-rpg/src/render/lighting.ts +6 -1
  55. package/templates/action-rpg/src/render/loading.ts +267 -42
  56. package/templates/action-rpg/src/render/postprocessing.ts +68 -15
  57. package/templates/action-rpg/src/render/worldEnvironment.ts +583 -0
  58. package/templates/action-rpg/src/scenes/Play.ts +49 -19
  59. package/templates/action-rpg/src/state.ts +4 -0
  60. package/templates/action-rpg/src/style.css +45 -1
  61. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  62. package/templates/action-rpg/src/ui/App.tsx +9 -8
  63. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  64. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  65. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  66. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  67. package/templates/action-rpg/src/ui/main.tsx +14 -0
  68. package/templates/action-rpg/threenative.config.ts +21 -8
  69. package/templates/action-rpg/vite.config.ts +32 -2
  70. package/templates/defense/.codex/config.toml +15 -0
  71. package/templates/defense/.mcp.json +6 -2
  72. package/templates/defense/AGENTS.md +371 -8
  73. package/templates/defense/CLAUDE.md +371 -8
  74. package/templates/defense/README.md +2 -1
  75. package/templates/defense/index.html +0 -1
  76. package/templates/defense/package.json +16 -12
  77. package/templates/defense/playtests/leak.playtest.json +9 -4
  78. package/templates/defense/playtests/performance.playtest.json +22 -0
  79. package/templates/defense/playtests/placement.playtest.json +5 -5
  80. package/templates/defense/playtests/pointer-placement.playtest.json +89 -0
  81. package/templates/defense/playtests/scan.playtest.json +3 -3
  82. package/templates/defense/playtests/survive.playtest.json +11 -6
  83. package/templates/defense/public/icon.png +0 -0
  84. package/templates/defense/src/attackers/Attacker.ts +28 -12
  85. package/templates/defense/src/game.ts +24 -2
  86. package/templates/defense/src/render/lighting.ts +6 -1
  87. package/templates/defense/src/render/loading.ts +263 -37
  88. package/templates/defense/src/render/postprocessing.ts +70 -13
  89. package/templates/defense/src/render/shapes.ts +38 -0
  90. package/templates/defense/src/render/worldEnvironment.ts +583 -0
  91. package/templates/defense/src/scenes/Defense.ts +109 -50
  92. package/templates/defense/src/state.ts +6 -0
  93. package/templates/defense/src/style.css +45 -1
  94. package/templates/defense/src/ui/App.tsx +9 -4
  95. package/templates/defense/src/ui/GameUi.tsx +20 -0
  96. package/templates/defense/src/ui/Hud.tsx +6 -5
  97. package/templates/defense/src/ui/main.tsx +14 -0
  98. package/templates/defense/threenative.config.ts +21 -8
  99. package/templates/defense/vite.config.ts +34 -1
  100. package/templates/minimal/.codex/config.toml +15 -0
  101. package/templates/minimal/.mcp.json +6 -2
  102. package/templates/minimal/AGENTS.md +360 -255
  103. package/templates/minimal/CLAUDE.md +360 -255
  104. package/templates/minimal/index.html +0 -1
  105. package/templates/minimal/package.json +14 -11
  106. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  107. package/templates/minimal/playtests/play.playtest.json +17 -5
  108. package/templates/minimal/public/icon.png +0 -0
  109. package/templates/minimal/src/game.ts +1 -0
  110. package/templates/minimal/src/render/camera.ts +1 -1
  111. package/templates/minimal/src/render/hud.ts +24 -8
  112. package/templates/minimal/src/render/lighting.ts +23 -2
  113. package/templates/minimal/src/render/loading.ts +23 -103
  114. package/templates/minimal/src/render/postprocessing.ts +92 -14
  115. package/templates/minimal/src/render/sky.ts +37 -32
  116. package/templates/minimal/src/render/worldEnvironment.ts +583 -0
  117. package/templates/minimal/src/scenes/Play.ts +91 -13
  118. package/templates/minimal/src/state.ts +8 -1
  119. package/templates/minimal/threenative.config.ts +15 -10
  120. package/templates/minimal/vite.config.ts +28 -1
  121. package/templates/platformer/.codex/config.toml +15 -0
  122. package/templates/platformer/.mcp.json +6 -2
  123. package/templates/platformer/AGENTS.md +385 -130
  124. package/templates/platformer/CLAUDE.md +385 -130
  125. package/templates/platformer/index.html +0 -1
  126. package/templates/platformer/package.json +17 -14
  127. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  128. package/templates/platformer/playtests/branding.playtest.json +29 -0
  129. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  130. package/templates/platformer/playtests/collect.playtest.json +1 -1
  131. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  132. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  133. package/templates/platformer/playtests/damage.playtest.json +4 -1
  134. package/templates/platformer/playtests/dash.playtest.json +2 -2
  135. package/templates/platformer/playtests/jump.playtest.json +2 -3
  136. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  137. package/templates/platformer/playtests/oneway.playtest.json +1 -1
  138. package/templates/platformer/playtests/performance.playtest.json +6 -5
  139. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  140. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  141. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  142. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +13 -4
  143. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  144. package/templates/platformer/playtests/touch-controls-web.playtest.json +46 -0
  145. package/templates/platformer/public/icon.png +0 -0
  146. package/templates/platformer/src/entities/Character.ts +16 -10
  147. package/templates/platformer/src/entities/Patrol.ts +5 -0
  148. package/templates/platformer/src/game.ts +24 -1
  149. package/templates/platformer/src/render/lighting.ts +6 -1
  150. package/templates/platformer/src/render/loading.ts +270 -61
  151. package/templates/platformer/src/render/postprocessing.ts +68 -15
  152. package/templates/platformer/src/render/touch-controls.ts +54 -36
  153. package/templates/platformer/src/render/worldEnvironment.ts +583 -0
  154. package/templates/platformer/src/scenes/Level.ts +47 -22
  155. package/templates/platformer/src/state.ts +4 -0
  156. package/templates/platformer/src/style.css +45 -1
  157. package/templates/platformer/src/ui/App.tsx +9 -4
  158. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  159. package/templates/platformer/src/ui/Hud.tsx +6 -5
  160. package/templates/platformer/src/ui/main.tsx +14 -0
  161. package/templates/platformer/threenative.config.ts +20 -10
  162. package/templates/platformer/vite.config.ts +34 -1
  163. package/templates/racing/.codex/config.toml +15 -0
  164. package/templates/racing/.mcp.json +6 -2
  165. package/templates/racing/AGENTS.md +370 -6
  166. package/templates/racing/CLAUDE.md +370 -6
  167. package/templates/racing/index.html +0 -1
  168. package/templates/racing/package.json +16 -12
  169. package/templates/racing/playtests/boost.playtest.json +5 -5
  170. package/templates/racing/playtests/outcome.playtest.json +14 -4
  171. package/templates/racing/playtests/performance.playtest.json +22 -0
  172. package/templates/racing/playtests/ranking.playtest.json +2 -2
  173. package/templates/racing/playtests/rescue.playtest.json +12 -6
  174. package/templates/racing/playtests/reverse.playtest.json +3 -3
  175. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  176. package/templates/racing/public/icon.png +0 -0
  177. package/templates/racing/src/game.ts +24 -1
  178. package/templates/racing/src/render/camera.ts +10 -6
  179. package/templates/racing/src/render/lighting.ts +6 -1
  180. package/templates/racing/src/render/loading.ts +291 -34
  181. package/templates/racing/src/render/postprocessing.ts +70 -13
  182. package/templates/racing/src/render/worldEnvironment.ts +583 -0
  183. package/templates/racing/src/scenes/Race.ts +68 -36
  184. package/templates/racing/src/state.ts +4 -0
  185. package/templates/racing/src/style.css +45 -1
  186. package/templates/racing/src/track/Lap.ts +20 -9
  187. package/templates/racing/src/track/Ranking.ts +53 -14
  188. package/templates/racing/src/track/Track.ts +29 -16
  189. package/templates/racing/src/track/TrackSector.ts +14 -4
  190. package/templates/racing/src/ui/App.tsx +9 -4
  191. package/templates/racing/src/ui/GameUi.tsx +20 -0
  192. package/templates/racing/src/ui/Hud.tsx +6 -5
  193. package/templates/racing/src/ui/main.tsx +14 -0
  194. package/templates/racing/threenative.config.ts +21 -8
  195. package/templates/racing/vite.config.ts +34 -1
  196. package/templates/sailing/.codex/config.toml +15 -0
  197. package/templates/sailing/.mcp.json +20 -0
  198. package/templates/sailing/AGENTS.md +388 -0
  199. package/templates/sailing/CLAUDE.md +390 -0
  200. package/templates/sailing/README.md +25 -0
  201. package/templates/sailing/index.html +12 -0
  202. package/templates/sailing/kit.json +7 -0
  203. package/templates/sailing/native-playtests/survives.playtest.json +21 -0
  204. package/templates/sailing/package.json +52 -0
  205. package/templates/sailing/playtests/fail.playtest.json +24 -0
  206. package/templates/sailing/playtests/performance.playtest.json +21 -0
  207. package/templates/sailing/playtests/survives.playtest.json +38 -0
  208. package/templates/sailing/playtests/win.playtest.json +31 -0
  209. package/templates/sailing/public/favicon.svg +5 -0
  210. package/templates/sailing/public/icon.png +0 -0
  211. package/templates/sailing/src/entities/Ship.ts +96 -0
  212. package/templates/sailing/src/game.ts +40 -0
  213. package/templates/sailing/src/main.ts +15 -0
  214. package/templates/sailing/src/render/camera.ts +21 -0
  215. package/templates/sailing/src/render/lighting.ts +36 -0
  216. package/templates/sailing/src/render/loading.ts +315 -0
  217. package/templates/sailing/src/render/materials.ts +28 -0
  218. package/templates/sailing/src/render/palette.ts +24 -0
  219. package/templates/sailing/src/render/postprocessing.ts +33 -0
  220. package/templates/sailing/src/render/props.ts +52 -0
  221. package/templates/sailing/src/render/sky.ts +32 -0
  222. package/templates/sailing/src/render/water-material.ts +14 -0
  223. package/templates/sailing/src/render/water-shaders.ts +12 -0
  224. package/templates/sailing/src/render/wave-nodes.ts +10 -0
  225. package/templates/sailing/src/render/worldEnvironment.ts +590 -0
  226. package/templates/sailing/src/scenes/Boot.ts +12 -0
  227. package/templates/sailing/src/scenes/Sailing.ts +106 -0
  228. package/templates/sailing/src/state.ts +10 -0
  229. package/templates/sailing/src/style.css +61 -0
  230. package/templates/sailing/src/ui/App.tsx +15 -0
  231. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  232. package/templates/sailing/src/ui/Hud.tsx +55 -0
  233. package/templates/sailing/src/ui/Menu.tsx +30 -0
  234. package/templates/sailing/src/ui/main.tsx +7 -0
  235. package/templates/sailing/tailwind.config.ts +2 -0
  236. package/templates/sailing/threenative.config.ts +34 -0
  237. package/templates/sailing/tsconfig.json +17 -0
  238. package/templates/sailing/vite.config.ts +34 -0
  239. package/templates/shooter/.codex/config.toml +15 -0
  240. package/templates/shooter/.mcp.json +6 -2
  241. package/templates/shooter/AGENTS.md +373 -7
  242. package/templates/shooter/CLAUDE.md +373 -7
  243. package/templates/shooter/index.html +0 -1
  244. package/templates/shooter/package.json +16 -11
  245. package/templates/shooter/playtests/fail.playtest.json +5 -4
  246. package/templates/shooter/playtests/input-control.playtest.json +131 -0
  247. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  248. package/templates/shooter/playtests/performance.playtest.json +22 -0
  249. package/templates/shooter/playtests/shooter.playtest.json +22 -18
  250. package/templates/shooter/playtests/survives.playtest.json +1 -1
  251. package/templates/shooter/public/favicon.svg +1 -1
  252. package/templates/shooter/public/icon.png +0 -0
  253. package/templates/shooter/src/game.ts +24 -1
  254. package/templates/shooter/src/main.ts +3 -13
  255. package/templates/shooter/src/render/camera.ts +62 -12
  256. package/templates/shooter/src/render/lighting.ts +6 -1
  257. package/templates/shooter/src/render/loading.ts +262 -33
  258. package/templates/shooter/src/render/palette.ts +1 -1
  259. package/templates/shooter/src/render/postprocessing.ts +68 -16
  260. package/templates/shooter/src/render/shapes.ts +178 -0
  261. package/templates/shooter/src/render/ui.css +34 -1
  262. package/templates/shooter/src/render/worldEnvironment.ts +583 -0
  263. package/templates/shooter/src/scenes/Play.ts +246 -73
  264. package/templates/shooter/src/state.ts +13 -0
  265. package/templates/shooter/src/style.css +26 -0
  266. package/templates/shooter/src/ui/App.tsx +10 -12
  267. package/templates/shooter/src/ui/GameUi.tsx +20 -0
  268. package/templates/shooter/src/ui/Hud.tsx +8 -10
  269. package/templates/shooter/src/ui/Menu.tsx +24 -9
  270. package/templates/shooter/src/ui/main.tsx +15 -0
  271. package/templates/shooter/src/weapons/Projectile.ts +21 -10
  272. package/templates/shooter/threenative.config.ts +21 -8
  273. package/templates/shooter/vite.config.ts +32 -2
  274. package/templates/starter/.codex/config.toml +15 -0
  275. package/templates/starter/.mcp.json +6 -2
  276. package/templates/starter/AGENTS.md +429 -326
  277. package/templates/starter/CLAUDE.md +429 -326
  278. package/templates/starter/assets/pickup.wav +0 -0
  279. package/templates/starter/gitignore +4 -0
  280. package/templates/starter/index.html +0 -1
  281. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  282. package/templates/starter/native-playtests/render-chain.playtest.json +12 -0
  283. package/templates/starter/package.json +16 -12
  284. package/templates/starter/playtests/assets.playtest.json +65 -0
  285. package/templates/starter/playtests/buffer.playtest.json +59 -9
  286. package/templates/starter/playtests/cloth.playtest.json +113 -0
  287. package/templates/starter/playtests/coyote.playtest.json +60 -8
  288. package/templates/starter/playtests/forward.playtest.json +29 -4
  289. package/templates/starter/playtests/gameover.playtest.json +66 -0
  290. package/templates/starter/playtests/goal.playtest.json +67 -0
  291. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  292. package/templates/starter/playtests/look.playtest.json +34 -6
  293. package/templates/starter/playtests/models-baseline.png +0 -0
  294. package/templates/starter/playtests/models.playtest.json +74 -0
  295. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  296. package/templates/starter/playtests/odometer.playtest.json +54 -0
  297. package/templates/starter/playtests/pause.playtest.json +27 -4
  298. package/templates/starter/playtests/play.playtest.json +43 -7
  299. package/templates/starter/playtests/respawn.playtest.json +46 -6
  300. package/templates/starter/playtests/restart.playtest.json +65 -10
  301. package/templates/starter/playtests/seed.playtest.json +44 -8
  302. package/templates/starter/playtests/survives.playtest.json +27 -4
  303. package/templates/starter/playtests/textures-baseline.png +0 -0
  304. package/templates/starter/playtests/textures.playtest.json +74 -0
  305. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  306. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  307. package/templates/starter/public/icon.png +0 -0
  308. package/templates/starter/src/entities/Goal.ts +122 -0
  309. package/templates/starter/src/entities/Player.ts +40 -2
  310. package/templates/starter/src/game.ts +25 -0
  311. package/templates/starter/src/render/camera.ts +31 -5
  312. package/templates/starter/src/render/easing.ts +5 -0
  313. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  314. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  315. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  316. package/templates/starter/src/render/lighting.ts +6 -1
  317. package/templates/starter/src/render/loading.ts +315 -0
  318. package/templates/starter/src/render/materials.ts +17 -1
  319. package/templates/starter/src/render/pennant.ts +54 -0
  320. package/templates/starter/src/render/postprocessing.ts +46 -15
  321. package/templates/starter/src/render/scenery.ts +83 -0
  322. package/templates/starter/src/render/shapes.ts +9 -21
  323. package/templates/starter/src/render/worldEnvironment.ts +583 -0
  324. package/templates/starter/src/scenes/Play.ts +146 -36
  325. package/templates/starter/src/state.ts +12 -0
  326. package/templates/starter/src/style.css +45 -1
  327. package/templates/starter/src/ui/App.tsx +9 -6
  328. package/templates/starter/src/ui/GameUi.tsx +20 -0
  329. package/templates/starter/src/ui/Hud.tsx +52 -29
  330. package/templates/starter/src/ui/Menu.tsx +25 -23
  331. package/templates/starter/src/ui/main.tsx +14 -0
  332. package/templates/starter/threenative.config.ts +27 -9
  333. package/templates/starter/tools/look.mjs +109 -0
  334. package/templates/starter/vite.config.ts +32 -2
  335. package/templates/minimal/assets/.gitkeep +0 -0
  336. package/templates/minimal/public/.gitkeep +0 -0
  337. package/templates/platformer/assets/.gitkeep +0 -0
  338. package/templates/platformer/public/.gitkeep +0 -0
  339. package/templates/starter/assets/.gitkeep +0 -0
  340. package/templates/starter/public/.gitkeep +0 -0
  341. package/templates/starter/public/pickup.ogg +0 -0
  342. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  343. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -1,5 +1,5 @@
1
- import { type ICtx, Scene, type SceneFrame } from "@threenative/core";
2
- import { type PerspectiveCamera, Vector3 } from "three";
1
+ import { type ICtx, Scene, type SceneFrame, isMobile } from "@threenative/core";
2
+ import { type Object3D, type PerspectiveCamera, Vector3 } from "three";
3
3
  import { Attacker } from "../attackers/Attacker.js";
4
4
  import { ROUTE_TEST_SLOT, RouteBoard, SAFE_BUILD_SLOTS } from "../board/Route.js";
5
5
  import { Economy, TOWER_COST } from "../economy.js";
@@ -10,6 +10,7 @@ import { setupCamera } from "../render/camera.js";
10
10
  import { setupLighting } from "../render/lighting.js";
11
11
  import { createLoadingScreen } from "../render/loading.js";
12
12
  import { setupPost } from "../render/postprocessing.js";
13
+ import { buildTiles, setTileHighlighted } from "../render/shapes.js";
13
14
  import { setupSky } from "../render/sky.js";
14
15
  import { type GameState, INITIAL_STATE, MAX_LEAKS, registerLeak } from "../state.js";
15
16
  import { Tower } from "../towers/Tower.js";
@@ -18,24 +19,30 @@ import { WaveSchedule } from "../waves.js";
18
19
  export type GameCtx = ICtx<GameState, DefensePhysics>;
19
20
 
20
21
  const SAFE_BUILD_HEIGHT = 0;
22
+ const EMPTY_POSITION = new Vector3();
21
23
 
22
24
  export class Defense extends Scene<GameState, DefensePhysics> {
23
25
  static override readonly initialState = INITIAL_STATE;
24
26
 
25
27
  override enter(ctx: GameCtx): SceneFrame<GameState, DefensePhysics> {
26
28
  setupSky(ctx.scene);
27
- setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
28
- setupPost(ctx.renderer, ctx.scene, ctx.camera);
29
+ const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
30
+ // isMobile() arrives as an argument because src/render/ imports no framework package: the
31
+ // platform decision is made here, in portable game code, exactly like createRandom.
32
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, { godraysLight: sun, mobile: isMobile() });
29
33
  setupCamera(ctx.camera as PerspectiveCamera);
30
34
  const loading = createLoadingScreen(ctx);
31
35
  ctx.add(ctx.camera);
32
36
  const board = new RouteBoard(ctx);
37
+ const buildSurface = buildTiles();
38
+ ctx.add(buildSurface);
33
39
  const player = new Player(ctx);
34
40
  ctx.entities.add("player", player);
35
41
  const query = directSpaceState(ctx.physics);
36
42
  const buildable = new Buildable(query);
37
43
  const economy = new Economy();
38
44
  const attackers = new Map<string, Attacker>();
45
+ const attackerPool: Attacker[] = [];
39
46
  const towers = new Map<string, Tower>();
40
47
  const removeAttackers = new Set<string>();
41
48
  let safeSlot = 0;
@@ -48,6 +55,18 @@ export class Defense extends Scene<GameState, DefensePhysics> {
48
55
  let scanWindowFrames = 0;
49
56
  let scanWindowScans = 0;
50
57
  let scanWindowValid = false;
58
+ let hoveredTile: Object3D | undefined;
59
+ let placedTile: string | undefined;
60
+ const setHoveredTile = (tile: Object3D | undefined): void => {
61
+ if (hoveredTile === tile) return;
62
+ if (hoveredTile !== undefined) setTileHighlighted(hoveredTile, false);
63
+ hoveredTile = tile;
64
+ if (hoveredTile !== undefined) setTileHighlighted(hoveredTile, true);
65
+ };
66
+ ctx.pointer?.on(buildSurface, "pointerEntered", (event) => setHoveredTile(event.object));
67
+ ctx.pointer?.on(buildSurface, "pointerExited", (event) => {
68
+ if (event.object === hoveredTile) setHoveredTile(undefined);
69
+ });
51
70
  const place = (position: Vector3): void => {
52
71
  const result = buildable.validate(position);
53
72
  if (!result.accepted) {
@@ -69,25 +88,50 @@ export class Defense extends Scene<GameState, DefensePhysics> {
69
88
  ctx.entities.add(`tower.${id}`, tower);
70
89
  lastPlaced = position.clone();
71
90
  };
91
+ ctx.pointer?.on(buildSurface, "tapped", (event) => {
92
+ const towerCount = towers.size;
93
+ place(event.point.clone().setY(SAFE_BUILD_HEIGHT));
94
+ if (towers.size > towerCount) placedTile = event.object.name;
95
+ });
96
+ ctx.entities.add("build-preview", {
97
+ debug: () => ({
98
+ hovered: hoveredTile !== undefined,
99
+ placedTile: placedTile ?? "",
100
+ position: hoveredTile?.position.toArray() ?? [],
101
+ tile: hoveredTile?.name ?? "",
102
+ }),
103
+ });
72
104
  const spawn = (wave: number, member: number): void => {
73
105
  const id = `attacker.${wave}.${member}`;
74
- const attacker = new Attacker({
75
- id,
76
- lateralOffset: member === 0 ? -0.17 : 0.17,
77
- onDefeated: () => {
78
- defeated += 1;
79
- removeAttackers.add(id);
80
- },
81
- onLeak: () => {
82
- leaks = registerLeak(leaks).leaks;
83
- removeAttackers.add(id);
84
- if (leaks >= MAX_LEAKS) status = "LOST";
85
- },
86
- pathPoints: board.points,
87
- physics: ctx.physics,
88
- });
89
- attackers.set(id, attacker);
90
- ctx.entities.add(id, attacker);
106
+ let attacker: Attacker | undefined;
107
+ for (const candidate of attackerPool) {
108
+ if (!candidate.dead && !candidate.escaped) continue;
109
+ attacker = candidate;
110
+ break;
111
+ }
112
+ if (attacker === undefined) {
113
+ const entityId = `attacker.pool.${attackerPool.length}`;
114
+ const created = new Attacker({
115
+ id: entityId,
116
+ lateralOffset: member === 0 ? -0.17 : 0.17,
117
+ onDefeated: () => {
118
+ defeated += 1;
119
+ removeAttackers.add(entityId);
120
+ },
121
+ onLeak: () => {
122
+ leaks = registerLeak(leaks).leaks;
123
+ removeAttackers.add(entityId);
124
+ if (leaks >= MAX_LEAKS) status = "LOST";
125
+ },
126
+ pathPoints: board.points,
127
+ physics: ctx.physics,
128
+ });
129
+ attacker = created;
130
+ attackerPool.push(attacker);
131
+ ctx.entities.add(entityId, attacker);
132
+ }
133
+ attacker.reset(id, member === 0 ? -0.17 : 0.17);
134
+ attackers.set(attacker.entityId, attacker);
91
135
  };
92
136
  const waves = new WaveSchedule({
93
137
  onSpawn: spawn,
@@ -95,14 +139,11 @@ export class Defense extends Scene<GameState, DefensePhysics> {
95
139
  if (leaks < MAX_LEAKS) status = "WON";
96
140
  },
97
141
  });
98
- const attemptPointerPlacement = (): void => {
99
- const hit = ctx.raycast({ targets: board.surface });
100
- if (hit !== undefined) place(hit.point.clone().setY(SAFE_BUILD_HEIGHT));
101
- };
102
142
  const recordRejected = (reason: PlacementReason): void => {
103
143
  if (reason === "route") routeRejects += 1;
104
144
  if (reason === "overlap") overlapRejects += 1;
105
145
  };
146
+ const state: GameState = { ...INITIAL_STATE };
106
147
  return (frameCtx, dt) => {
107
148
  loading.update();
108
149
  if (frameCtx.input.justPressed("restart")) {
@@ -114,7 +155,6 @@ export class Defense extends Scene<GameState, DefensePhysics> {
114
155
  if (status === "PLAYING") {
115
156
  player.update(frameCtx, dt);
116
157
  economy.update(dt);
117
- if (frameCtx.input.justPressed("build")) attemptPointerPlacement();
118
158
  if (frameCtx.input.justPressed("safeBuild")) {
119
159
  const slot = SAFE_BUILD_SLOTS[safeSlot % SAFE_BUILD_SLOTS.length];
120
160
  safeSlot += 1;
@@ -122,18 +162,21 @@ export class Defense extends Scene<GameState, DefensePhysics> {
122
162
  }
123
163
  if (frameCtx.input.justPressed("routeTest")) place(ROUTE_TEST_SLOT);
124
164
  if (frameCtx.input.justPressed("overlapTest"))
125
- place(lastPlaced ?? SAFE_BUILD_SLOTS[0] ?? new Vector3());
165
+ place(lastPlaced ?? SAFE_BUILD_SLOTS[0] ?? EMPTY_POSITION);
126
166
  for (const attacker of attackers.values()) attacker.update(dt);
127
167
  for (const tower of towers.values()) tower.update(dt);
128
- waves.update(dt, attackers.size);
129
168
  for (const id of removeAttackers) {
130
- ctx.entities.remove(id);
131
169
  attackers.delete(id);
132
170
  }
133
171
  removeAttackers.clear();
172
+ waves.update(dt, attackers.size);
173
+ }
174
+ let scanCount = 0;
175
+ let shots = 0;
176
+ for (const tower of towers.values()) {
177
+ scanCount += tower.scanCount;
178
+ shots += tower.shots;
134
179
  }
135
- const scanCount = [...towers.values()].reduce((total, tower) => total + tower.scanCount, 0);
136
- const shots = [...towers.values()].reduce((total, tower) => total + tower.shots, 0);
137
180
  if (scanWindowFrames < 300) {
138
181
  scanWindowFrames += 1;
139
182
  if (scanWindowFrames === 300) {
@@ -141,25 +184,41 @@ export class Defense extends Scene<GameState, DefensePhysics> {
141
184
  scanWindowValid = towers.size > 0 && scanCount >= 10 && scanCount <= 40 * towers.size;
142
185
  }
143
186
  }
144
- const state: GameState = {
145
- balance: economy.balance,
146
- defeated,
147
- income: economy.income,
148
- leaks,
149
- overlapRejects,
150
- placementRejects: routeRejects + overlapRejects,
151
- routeRejects,
152
- scanCount,
153
- scanWindowFrames,
154
- scanWindowScans,
155
- scanWindowValid,
156
- shots,
157
- spent: economy.spent,
158
- status,
159
- towers: towers.size,
160
- wave: waves.spawned,
161
- };
162
- frameCtx.state.set(state);
187
+ const previous = frameCtx.state.getState();
188
+ state.balance = economy.balance;
189
+ state.defeated = defeated;
190
+ state.income = economy.income;
191
+ state.leaks = leaks;
192
+ state.overlapRejects = overlapRejects;
193
+ state.placementRejects = routeRejects + overlapRejects;
194
+ state.routeRejects = routeRejects;
195
+ state.scanCount = scanCount;
196
+ state.scanWindowFrames = scanWindowFrames;
197
+ state.scanWindowScans = scanWindowScans;
198
+ state.scanWindowValid = scanWindowValid;
199
+ state.shots = shots;
200
+ state.spent = economy.spent;
201
+ state.status = status;
202
+ state.towers = towers.size;
203
+ state.wave = waves.spawned;
204
+ const changed =
205
+ state.balance !== previous.balance ||
206
+ state.defeated !== previous.defeated ||
207
+ state.income !== previous.income ||
208
+ state.leaks !== previous.leaks ||
209
+ state.overlapRejects !== previous.overlapRejects ||
210
+ state.placementRejects !== previous.placementRejects ||
211
+ state.routeRejects !== previous.routeRejects ||
212
+ state.scanCount !== previous.scanCount ||
213
+ state.scanWindowFrames !== previous.scanWindowFrames ||
214
+ state.scanWindowScans !== previous.scanWindowScans ||
215
+ state.scanWindowValid !== previous.scanWindowValid ||
216
+ state.shots !== previous.shots ||
217
+ state.spent !== previous.spent ||
218
+ state.status !== previous.status ||
219
+ state.towers !== previous.towers ||
220
+ state.wave !== previous.wave;
221
+ if (changed) frameCtx.state.set(state);
163
222
  };
164
223
  }
165
224
  }
@@ -12,6 +12,10 @@ export function registerLeak(leaks: number): {
12
12
  }
13
13
 
14
14
  export type GameState = {
15
+ /** Set from the UI\'s pause and resume intents, and read back by the menu. */
16
+ paused: boolean;
17
+ /** True once the UI layer has rendered and published its interactive rectangles. */
18
+ uiReady: boolean;
15
19
  balance: number;
16
20
  defeated: number;
17
21
  income: number;
@@ -31,6 +35,8 @@ export type GameState = {
31
35
  };
32
36
 
33
37
  export const INITIAL_STATE: GameState = {
38
+ paused: false,
39
+ uiReady: false,
34
40
  balance: 120,
35
41
  defeated: 0,
36
42
  income: 0,
@@ -25,8 +25,52 @@ body,
25
25
  }
26
26
 
27
27
  body {
28
- background: var(--color-ink);
29
28
  color: var(--color-text);
30
29
  font-family: var(--font-mono);
31
30
  -webkit-font-smoothing: antialiased;
32
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
+ /* The debug surface is framework plumbing; its default presentation is yours to change. */
46
+ [data-threenative-debug-overlay="true"] {
47
+ position: fixed;
48
+ top: 1rem;
49
+ right: 1rem;
50
+ z-index: 50;
51
+ max-width: 24rem;
52
+ padding: 0.75rem;
53
+ pointer-events: none;
54
+ background: rgb(2 6 23 / 90%);
55
+ box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
56
+ color: #cffafe;
57
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
58
+ font-size: 12px;
59
+ line-height: 1.5;
60
+ }
61
+
62
+ [data-threenative-debug-overlay="true"] table {
63
+ width: 100%;
64
+ table-layout: fixed;
65
+ }
66
+
67
+ [data-threenative-debug-overlay="true"] th,
68
+ [data-threenative-debug-overlay="true"] td {
69
+ padding-right: 1rem;
70
+ text-align: left;
71
+ }
72
+
73
+ [data-threenative-debug-overlay="true"] td:last-child {
74
+ overflow-wrap: anywhere;
75
+ word-break: break-all;
76
+ }
@@ -2,15 +2,20 @@ import type { IGame } from "@threenative/core";
2
2
  import { DebugOverlay, GameCanvas } from "@threenative/ui";
3
3
  import type { DefensePhysics } from "../physics.js";
4
4
  import type { GameState } from "../state.js";
5
- import { Hud } from "./Hud.js";
6
- import { Menu } from "./Menu.js";
5
+ import { GameUi } from "./GameUi.js";
7
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
+ */
8
14
  export function App({ game }: { game: IGame<GameState, DefensePhysics> }) {
9
15
  return (
10
16
  <main className="relative h-screen w-screen overflow-hidden bg-ink">
11
17
  <GameCanvas className="absolute inset-0" game={game} />
12
- <Hud game={game} />
13
- <Menu />
18
+ <GameUi />
14
19
  <DebugOverlay />
15
20
  </main>
16
21
  );
@@ -0,0 +1,20 @@
1
+ import { UiLayer } from "@threenative/ui";
2
+ import { Hud } from "./Hud.js";
3
+ import { Menu } from "./Menu.js";
4
+
5
+ /**
6
+ * Everything the player sees that is not the scene.
7
+ *
8
+ * One component, mounted twice by two entries that differ only in what else is on the page:
9
+ * `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
10
+ * page the native web view loads. Keeping both entries pointed at this file is what makes "the
11
+ * same UI on every target" a fact rather than an intention.
12
+ */
13
+ export function GameUi() {
14
+ return (
15
+ <UiLayer>
16
+ <Hud />
17
+ <Menu />
18
+ </UiLayer>
19
+ );
20
+ }
@@ -1,10 +1,11 @@
1
- import type { IGame } from "@threenative/core";
2
- import { useGameState } from "@threenative/ui";
3
- import type { DefensePhysics } from "../physics.js";
1
+ import { useUiState } from "@threenative/ui";
4
2
  import type { GameState } from "../state.js";
5
3
 
6
- export function Hud({ game }: { game: IGame<GameState, DefensePhysics> }) {
7
- const state = useGameState(game, (value) => value);
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;
8
9
  const statusClass =
9
10
  state.status === "WON" ? "text-win" : state.status === "LOST" ? "text-danger" : "text-lume";
10
11
  return (
@@ -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 />);
@@ -1,16 +1,19 @@
1
1
  import type { IThreeNativeConfig } from "@threenative/core";
2
2
 
3
- export default {
3
+ const config: IThreeNativeConfig = {
4
4
  app: {
5
5
  id: "com.threenative.__PROJECT_ID__",
6
6
  name: "__PROJECT_NAME__",
7
7
  version: "1.0.0",
8
8
  build: 1,
9
+ icon: "public/icon.png",
10
+ icons: { web: { favicon: "public/favicon.svg" } },
9
11
  },
10
12
  display: {
11
13
  orientation: "landscape",
12
14
  fullscreen: true,
13
15
  keepScreenOn: true,
16
+ maxFps: 60,
14
17
  },
15
18
  window: {
16
19
  title: "__PROJECT_NAME__",
@@ -18,12 +21,22 @@ export default {
18
21
  height: 720,
19
22
  resizable: true,
20
23
  },
21
- loading: {
22
- backdropColor: "#07131d",
23
- trackColor: "#193242",
24
- progressColor: "#f5c451",
25
- showProgressBar: true,
24
+ bootSplash: {
25
+ backgroundColor: "#07131d",
26
26
  },
27
27
  nativeEntry: "src/game.ts",
28
- renderer: { preferWebGPU: true },
29
- } satisfies IThreeNativeConfig;
28
+ renderer: {
29
+ preferWebGPU: true, // Use WebGPU when the host exposes it.
30
+ // The engine holds the `display.maxFps` budget by scaling the 3D drawing buffer, and reports
31
+ // the scale it settled on in every `TN_FRAME_BUDGET` window. Replace with a number in (0, 1]
32
+ // to pin it — the loop stops and the reporting does not. CSS, UI and camera framing never move.
33
+ resolutionScale: "auto",
34
+ },
35
+ // One UI on every target: src/ui/ renders through the platform's own browser-class renderer,
36
+ // so the same React, Tailwind, CSS and SVG run on web, desktop, Android and iOS alike.
37
+ // Switch to "native" for a UI drawn as part of the rendered frame, with no web view and no
38
+ // extra process — and own the appearance difference that comes with it.
39
+ ui: { renderer: "web" },
40
+ };
41
+
42
+ export default config;
@@ -1,5 +1,38 @@
1
1
  import tailwindcss from "@tailwindcss/vite";
2
+ import { watchAssets } from "@threenative/assets";
2
3
  import react from "@vitejs/plugin-react";
4
+ import { createEngineFreshnessPlugin, createWebBrandPlugin } from "create-threenative";
3
5
  import { defineConfig } from "vite";
6
+ import type { Plugin } from "vite";
7
+ import config from "./threenative.config.js";
4
8
 
5
- export default defineConfig({ plugins: [react(), tailwindcss()] });
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
+ });
@@ -0,0 +1,15 @@
1
+ [mcp_servers.threenative-assets]
2
+ command = "node"
3
+ args = ["./node_modules/@threenative/core/mcp/assets.mjs"]
4
+
5
+ [mcp_servers.threenative-assets.env]
6
+ ASSET_DOWNLOAD_DIR = "./public/assets"
7
+ AUDIO_DOWNLOAD_DIR = "./public/audio"
8
+
9
+ [mcp_servers.threenative-sculpt]
10
+ command = "node"
11
+ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
12
+
13
+ [mcp_servers.threenative-engine]
14
+ command = "node"
15
+ args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
@@ -2,7 +2,7 @@
2
2
  "mcpServers": {
3
3
  "threenative-assets": {
4
4
  "command": "node",
5
- "args": ["./node_modules/threenative-asset-mcp/dist/index.js"],
5
+ "args": ["./node_modules/@threenative/core/mcp/assets.mjs"],
6
6
  "env": {
7
7
  "ASSET_DOWNLOAD_DIR": "./public/assets",
8
8
  "AUDIO_DOWNLOAD_DIR": "./public/audio"
@@ -10,7 +10,11 @@
10
10
  },
11
11
  "threenative-sculpt": {
12
12
  "command": "node",
13
- "args": ["./node_modules/threenative-sculpt-mcp/dist/server.js"]
13
+ "args": ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
14
+ },
15
+ "threenative-engine": {
16
+ "command": "node",
17
+ "args": ["./node_modules/@threenative/core/mcp/engine.mjs"]
14
18
  }
15
19
  }
16
20
  }