create-threenative 0.2.2 → 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
package/package.json CHANGED
@@ -1,11 +1,17 @@
1
1
  {
2
2
  "name": "create-threenative",
3
- "version": "0.2.2",
3
+ "version": "0.2.3",
4
+ "license": "MIT",
4
5
  "description": "Scaffold a readable ThreeNative game project.",
5
6
  "type": "module",
6
7
  "files": [
7
8
  "dist",
8
- "templates"
9
+ "templates",
10
+ "template-assets",
11
+ "agent-docs",
12
+ "agent-files",
13
+ "capabilities.json",
14
+ "README.md"
9
15
  ],
10
16
  "bin": {
11
17
  "create-threenative": "./dist/index.js",
@@ -19,26 +25,44 @@
19
25
  "types": "./dist/index.d.ts",
20
26
  "import": "./dist/index.js"
21
27
  },
28
+ "./web-brand": {
29
+ "types": "./dist/index.d.ts",
30
+ "import": "./dist/index.js"
31
+ },
22
32
  "./package.json": "./package.json"
23
33
  },
24
34
  "publishConfig": {
25
35
  "access": "public"
26
36
  },
27
37
  "sideEffects": false,
38
+ "dependencies": {
39
+ "@gltf-transform/core": "4.4.2",
40
+ "@gltf-transform/extensions": "4.4.2",
41
+ "@gltf-transform/functions": "4.4.2",
42
+ "draco3dgltf": "^1.5.7",
43
+ "ktx-parse": "^1.1.0",
44
+ "ktx2-encoder": "0.6.0",
45
+ "meshoptimizer": "1.1.1",
46
+ "three": "0.185.1"
47
+ },
28
48
  "devDependencies": {
49
+ "@gltf-transform/core": "4.4.2",
29
50
  "@types/node": "20.19.43",
30
51
  "@types/three": "0.185.3",
31
52
  "esbuild": "0.27.0",
32
53
  "publint": "0.3.22",
33
- "three": "0.185.1",
34
54
  "tsup": "8.5.1",
35
55
  "typescript": "5.9.3",
36
- "@threenative/core": "0.2.0",
37
- "@threenative/physics": "0.2.1"
56
+ "@threenative/assets": "0.3.0",
57
+ "@threenative/physics": "0.3.0",
58
+ "@threenative/core": "0.3.0"
59
+ },
60
+ "peerDependencies": {
61
+ "@threenative/assets": ">=0.3.0 <0.4.0"
38
62
  },
39
63
  "scripts": {
40
64
  "build": "tsup --config tsup.config.ts && publint",
41
65
  "typecheck": "tsc --noEmit",
42
- "test": "pnpm run build"
66
+ "test": "publint --strict"
43
67
  }
44
68
  }
@@ -0,0 +1,315 @@
1
+ import {
2
+ type Camera,
3
+ CanvasTexture,
4
+ ClampToEdgeWrapping,
5
+ Mesh,
6
+ MeshBasicMaterial,
7
+ type OrthographicCamera,
8
+ PlaneGeometry,
9
+ type Scene,
10
+ type Texture,
11
+ } from "three";
12
+ import { palette } from "./palette.js";
13
+
14
+ /* BEGIN THREENATIVE LOADING APPEARANCE */
15
+ /** Action-RPG look and composition; edit this file, not framework configuration. */
16
+ export const loading = {
17
+ backgroundColor: palette.skyLow,
18
+ backgroundImage: undefined as string | undefined,
19
+ enabled: true,
20
+ fillImage: undefined as string | undefined,
21
+ logoImage: undefined as string | undefined,
22
+ progressColor: palette.accent,
23
+ showStatus: false,
24
+ trackColor: palette.skyHigh,
25
+ bar: { anchorX: 0.5, anchorY: 0.74, height: 10, maxWidth: 500, width: 0.58 },
26
+ } as const;
27
+ /* END THREENATIVE LOADING APPEARANCE */
28
+
29
+ interface ILoadingHost {
30
+ readonly assets?: { texture(path: string): Promise<Texture> };
31
+ readonly camera: Camera;
32
+ readonly canvasLayer: {
33
+ readonly camera: OrthographicCamera;
34
+ readonly scene: Scene;
35
+ opaque: boolean;
36
+ };
37
+ readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
38
+ readonly scene: Scene;
39
+ readonly startup: { readonly progress: number; whenReady(): Promise<void> };
40
+ readonly viewport?: {
41
+ readonly safeArea: { height: number; width: number; x: number; y: number };
42
+ };
43
+ }
44
+
45
+ interface ILoadingController {
46
+ update(): void;
47
+ finish(): void;
48
+ }
49
+
50
+ function noOp(layer: ILoadingHost["canvasLayer"]): ILoadingController {
51
+ layer.opaque = false;
52
+ return { finish: () => undefined, update: () => undefined };
53
+ }
54
+
55
+ function meshFor(
56
+ layer: ILoadingHost["canvasLayer"],
57
+ material: MeshBasicMaterial,
58
+ renderOrder: number,
59
+ ): Mesh<PlaneGeometry, MeshBasicMaterial> {
60
+ const mesh = new Mesh(new PlaneGeometry(1, 1), material);
61
+ mesh.frustumCulled = false;
62
+ mesh.renderOrder = renderOrder;
63
+ layer.scene.add(mesh);
64
+ return mesh;
65
+ }
66
+
67
+ function imageAspect(texture: Texture | null | undefined): number {
68
+ const image = texture?.image as { height?: number; width?: number } | undefined;
69
+ const width = image?.width ?? 1;
70
+ const height = image?.height ?? 1;
71
+ return width > 0 && height > 0 ? width / height : 1;
72
+ }
73
+
74
+ function configureTexture(texture: Texture): void {
75
+ texture.wrapS = ClampToEdgeWrapping;
76
+ texture.wrapT = ClampToEdgeWrapping;
77
+ texture.needsUpdate = true;
78
+ }
79
+
80
+ function setFillUv(geometry: PlaneGeometry, progress: number, base: readonly number[]): void {
81
+ const uv = geometry.getAttribute("uv");
82
+ for (let index = 0; index < uv.count; index += 1) uv.setX(index, (base[index] ?? 0) * progress);
83
+ uv.needsUpdate = true;
84
+ }
85
+
86
+ function coverUv(
87
+ geometry: PlaneGeometry,
88
+ texture: Texture,
89
+ width: number,
90
+ height: number,
91
+ baseU: readonly number[],
92
+ baseV: readonly number[],
93
+ ): void {
94
+ const imageRatio = imageAspect(texture);
95
+ const boxRatio = width / Math.max(1, height);
96
+ const visibleU = imageRatio > boxRatio ? boxRatio / imageRatio : 1;
97
+ const visibleV = imageRatio < boxRatio ? imageRatio / boxRatio : 1;
98
+ const offsetU = (1 - visibleU) / 2;
99
+ const offsetV = (1 - visibleV) / 2;
100
+ const uv = geometry.getAttribute("uv");
101
+ for (let index = 0; index < uv.count; index += 1) {
102
+ uv.setX(index, offsetU + (baseU[index] ?? 0) * visibleU);
103
+ uv.setY(index, offsetV + (baseV[index] ?? 0) * visibleV);
104
+ }
105
+ uv.needsUpdate = true;
106
+ }
107
+
108
+ function statusMesh(
109
+ layer: ILoadingHost["canvasLayer"],
110
+ ):
111
+ | { mesh: Mesh<PlaneGeometry, MeshBasicMaterial>; texture: Texture; update(value: number): void }
112
+ | undefined {
113
+ if (!loading.showStatus || typeof document === "undefined") return undefined;
114
+ const canvas = document.createElement("canvas");
115
+ canvas.width = 180;
116
+ canvas.height = 48;
117
+ const context = canvas.getContext("2d");
118
+ if (context === null) return undefined;
119
+ const texture = new CanvasTexture(canvas);
120
+ const mesh = meshFor(
121
+ layer,
122
+ new MeshBasicMaterial({ depthTest: false, depthWrite: false, map: texture, transparent: true }),
123
+ 4,
124
+ );
125
+ const update = (value: number): void => {
126
+ context.clearRect(0, 0, canvas.width, canvas.height);
127
+ context.fillStyle = "#ffffff";
128
+ context.font = "700 20px monospace";
129
+ context.textAlign = "center";
130
+ context.textBaseline = "middle";
131
+ context.fillText(`${Math.round(value * 100)}%`, canvas.width / 2, canvas.height / 2);
132
+ texture.needsUpdate = true;
133
+ };
134
+ update(0);
135
+ return { mesh, texture, update };
136
+ }
137
+
138
+ export function createLoadingScreen(host: ILoadingHost): ILoadingController {
139
+ const layer = host.canvasLayer;
140
+ if (!loading.enabled) return noOp(layer);
141
+ const camera = layer.camera;
142
+ const backdrop = meshFor(
143
+ layer,
144
+ new MeshBasicMaterial({ color: loading.backgroundColor, depthTest: false, depthWrite: false }),
145
+ 0,
146
+ );
147
+ const track = meshFor(
148
+ layer,
149
+ new MeshBasicMaterial({ color: loading.trackColor, depthTest: false, depthWrite: false }),
150
+ 1,
151
+ );
152
+ const fill = meshFor(
153
+ layer,
154
+ new MeshBasicMaterial({ color: loading.progressColor, depthTest: false, depthWrite: false }),
155
+ 2,
156
+ );
157
+ const fillBaseU = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
158
+ fill.geometry.getAttribute("uv").getX(index),
159
+ );
160
+ const fillBaseV = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
161
+ fill.geometry.getAttribute("uv").getY(index),
162
+ );
163
+ const logo =
164
+ loading.logoImage === undefined
165
+ ? undefined
166
+ : meshFor(
167
+ layer,
168
+ new MeshBasicMaterial({
169
+ color: 0xffffff,
170
+ depthTest: false,
171
+ depthWrite: false,
172
+ transparent: true,
173
+ }),
174
+ 3,
175
+ );
176
+ const status = statusMesh(layer);
177
+ const parts = [
178
+ backdrop,
179
+ track,
180
+ fill,
181
+ ...(logo === undefined ? [] : [logo]),
182
+ ...(status === undefined ? [] : [status.mesh]),
183
+ ];
184
+ const ownedTextures = new Set<Texture>(status === undefined ? [] : [status.texture]);
185
+ let width = 1;
186
+ let height = 1;
187
+ let barWidth = 1;
188
+ let barHeight: number = loading.bar.height;
189
+ let barX = 0;
190
+ let barY = 0;
191
+ let progress = 0;
192
+ let done = false;
193
+ let backdropTexture: Texture | undefined;
194
+
195
+ const layout = (): void => {
196
+ width = Math.max(1, camera.right - camera.left);
197
+ height = Math.max(1, camera.top - camera.bottom);
198
+ const safe = host.viewport?.safeArea ?? { height, width, x: 0, y: 0 };
199
+ const safeWidth = Math.max(1, Math.min(width, safe.width));
200
+ const safeHeight = Math.max(1, Math.min(height, safe.height));
201
+ const safeX = Math.max(0, Math.min(width - safeWidth, safe.x));
202
+ const safeY = Math.max(0, Math.min(height - safeHeight, safe.y));
203
+ barWidth = Math.max(2, Math.min(loading.bar.maxWidth, safeWidth * loading.bar.width));
204
+ barHeight = Math.max(2, Math.min(loading.bar.height, safeHeight * 0.05));
205
+ barX = safeX + safeWidth * loading.bar.anchorX;
206
+ barY = safeY + safeHeight * loading.bar.anchorY;
207
+ const worldX = (screenX: number): number => camera.left + screenX;
208
+ const worldY = (screenY: number): number => camera.top - screenY;
209
+ const visibleWidth = Math.max(loading.bar.minWidth, barWidth * progress);
210
+ backdrop.scale.set(width, height, 1);
211
+ backdrop.position.set(worldX(width / 2), worldY(height / 2), 0);
212
+ track.scale.set(barWidth, barHeight, 1);
213
+ track.position.set(worldX(barX), worldY(barY), 0);
214
+ fill.scale.set(visibleWidth, barHeight, 1);
215
+ fill.position.set(worldX(barX - barWidth / 2 + visibleWidth / 2), worldY(barY), 0);
216
+ if (logo?.visible) {
217
+ const logoWidth = Math.min(safeWidth * 0.42, 280);
218
+ logo.scale.set(
219
+ logoWidth,
220
+ Math.min(logoWidth / imageAspect(logo.material.map), safeHeight * 0.22),
221
+ 1,
222
+ );
223
+ logo.position.set(worldX(barX), worldY(Math.max(safeY, barY - safeHeight * 0.2)), 0);
224
+ }
225
+ if (status !== undefined) {
226
+ status.mesh.scale.set(Math.min(180, safeWidth * 0.32), 48, 1);
227
+ status.mesh.position.set(worldX(barX), worldY(Math.min(height, barY + barHeight * 2.5)), 0);
228
+ }
229
+ if (backdropTexture !== undefined)
230
+ coverUv(backdrop.geometry, backdropTexture, width, height, fillBaseU, fillBaseV);
231
+ };
232
+
233
+ const updateProgress = (value: number): void => {
234
+ progress = Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
235
+ setFillUv(fill.geometry, progress, fillBaseU);
236
+ status?.update(progress);
237
+ layout();
238
+ };
239
+
240
+ const attachTexture = (mesh: Mesh<PlaneGeometry, MeshBasicMaterial>, texture: Texture): void => {
241
+ if (done) return;
242
+ configureTexture(texture);
243
+ mesh.material.map = texture;
244
+ mesh.material.color.set(0xffffff);
245
+ mesh.material.needsUpdate = true;
246
+ ownedTextures.add(texture);
247
+ if (mesh === backdrop) backdropTexture = texture;
248
+ layout();
249
+ updateProgress(progress);
250
+ };
251
+
252
+ const load = (source: string | undefined, mesh: Mesh<PlaneGeometry, MeshBasicMaterial>): void => {
253
+ if (source === undefined || host.assets === undefined) return;
254
+ void host.assets
255
+ .texture(source)
256
+ .then((texture) => attachTexture(mesh, texture))
257
+ .catch(() => undefined);
258
+ };
259
+ load(loading.backgroundImage, backdrop);
260
+ load(loading.fillImage, fill);
261
+ if (logo !== undefined && loading.logoImage !== undefined && host.assets !== undefined) {
262
+ void host.assets
263
+ .texture(loading.logoImage)
264
+ .then((texture) => {
265
+ if (done) return;
266
+ configureTexture(texture);
267
+ logo.material.map = texture;
268
+ logo.material.needsUpdate = true;
269
+ logo.visible = true;
270
+ ownedTextures.add(texture);
271
+ layout();
272
+ })
273
+ .catch(() => undefined);
274
+ }
275
+
276
+ layer.opaque = true;
277
+ layout();
278
+ updateProgress(0);
279
+
280
+ const finish = (): void => {
281
+ if (done) return;
282
+ done = true;
283
+ for (const mesh of parts) {
284
+ mesh.removeFromParent();
285
+ mesh.geometry.dispose();
286
+ mesh.material.dispose();
287
+ }
288
+ for (const texture of ownedTextures) texture.dispose();
289
+ layer.opaque = false;
290
+ };
291
+
292
+ void (async () => {
293
+ await host.startup.whenReady();
294
+ if (done) return;
295
+ // Prewarm the world's shaders, but do not wait for them here. `whenReady()` already means the
296
+ // world is safe to show, and compiling a lit, post-processed scene takes far longer than the
297
+ // launch window: hold the screen for it and a playtest — which advances a fixed step as fast
298
+ // as the machine allows — runs an entire scenario behind the launch screen, so every capture
299
+ // photographs the loading bar instead of the game. The prewarm still happens; it no longer
300
+ // decides when the player sees the world.
301
+ try {
302
+ void host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
303
+ } catch {
304
+ // A renderer without compileAsync is not a reason to keep the world hidden.
305
+ }
306
+ finish();
307
+ })();
308
+
309
+ return {
310
+ finish,
311
+ update(): void {
312
+ if (!done) updateProgress(host.startup.progress);
313
+ },
314
+ };
315
+ }
@@ -0,0 +1,287 @@
1
+ diff --git a/build/three.cjs b/build/three.cjs
2
+ index 8939a67d..b0f91724 100644
3
+ --- a/build/three.cjs
4
+ +++ b/build/three.cjs
5
+ @@ -26116,6 +26116,8 @@ function copyArrayContents( src, target ) {
6
+ */
7
+ class BatchedMesh extends Mesh {
8
+
9
+ + static threeNativeBatchedVelocityPatch = true;
10
+ +
11
+ /**
12
+ * Constructs a new batched mesh.
13
+ *
14
+ diff --git a/build/three.core.js b/build/three.core.js
15
+ index 0bb9262c..868a634b 100644
16
+ --- a/build/three.core.js
17
+ +++ b/build/three.core.js
18
+ @@ -26136,6 +26136,8 @@ function copyArrayContents( src, target ) {
19
+ */
20
+ class BatchedMesh extends Mesh {
21
+
22
+ + static threeNativeBatchedVelocityPatch = true;
23
+ +
24
+ /**
25
+ * Constructs a new batched mesh.
26
+ *
27
+ diff --git a/build/three.webgpu.js b/build/three.webgpu.js
28
+ index 2e490796..325b497a 100644
29
+ --- a/build/three.webgpu.js
30
+ +++ b/build/three.webgpu.js
31
+ @@ -18500,7 +18500,8 @@ const instance = /*@__PURE__*/ Fn( ( [ matrices, colors = null ], builder ) => {
32
+
33
+ const previousInstanceData = _previousInstanceMatrices.get( object );
34
+
35
+ - previousInstanceData.previousInstanceMatrix.array.set( matrices.array );
36
+ + const scheduledPrevious = object[ Symbol.for( 'threenative.velocity.previousInstanceMatrices' ) ];
37
+ + previousInstanceData.previousInstanceMatrix.array.set( scheduledPrevious ?? matrices.array );
38
+
39
+ } );
40
+
41
+ @@ -18599,6 +18600,7 @@ const batch = /*@__PURE__*/ Fn( ( [ batchMesh ], builder ) => {
42
+ const indirectId = getIndirectIndex( batchMesh._indirectTexture, int( batchingIdNode ) );
43
+
44
+ const matricesTexture = batchMesh._matricesTexture;
45
+ + const previousMatricesTexture = batchMesh._previousMatricesTexture ?? matricesTexture;
46
+
47
+ const size = int( textureSize( textureLoad( matricesTexture ), 0 ).x ).toConst();
48
+ const j = float( indirectId ).mul( 4 ).toInt().toConst();
49
+ @@ -18626,6 +18628,19 @@ const batch = /*@__PURE__*/ Fn( ( [ batchMesh ], builder ) => {
50
+
51
+ positionLocal.assign( batchingMatrix.mul( positionLocal ) );
52
+
53
+ + if ( builder.needsPreviousData() ) {
54
+ +
55
+ + const previousBatchingMatrix = mat4(
56
+ + textureLoad( previousMatricesTexture, ivec2( x, y ) ),
57
+ + textureLoad( previousMatricesTexture, ivec2( x.add( 1 ), y ) ),
58
+ + textureLoad( previousMatricesTexture, ivec2( x.add( 2 ), y ) ),
59
+ + textureLoad( previousMatricesTexture, ivec2( x.add( 3 ), y ) )
60
+ + );
61
+ +
62
+ + positionPrevious.assign( previousBatchingMatrix.mul( positionPrevious ).xyz );
63
+ +
64
+ + }
65
+ +
66
+ const transformedNormal = normalLocal.div( vec3( bm[ 0 ].dot( bm[ 0 ] ), bm[ 1 ].dot( bm[ 1 ] ), bm[ 2 ].dot( bm[ 2 ] ) ) );
67
+
68
+ const batchingNormal = bm.mul( transformedNormal ).xyz;
69
+ @@ -18777,7 +18792,8 @@ const skinning = /*@__PURE__*/ Fn( ( [ skinnedMesh ], builder ) => {
70
+
71
+ if ( skeletonData !== undefined ) {
72
+
73
+ - skeletonData.previousBoneMatrices.set( skeleton.boneMatrices );
74
+ + const scheduledPrevious = object[ Symbol.for( 'threenative.velocity.previousBoneMatrices' ) ];
75
+ + skeletonData.previousBoneMatrices.set( scheduledPrevious ?? skeleton.boneMatrices );
76
+
77
+ }
78
+
79
+ @@ -18844,7 +18860,8 @@ const computeSkinning = /*@__PURE__*/ Fn( ( [ skinnedMesh, toPosition = null ],
80
+
81
+ if ( state !== undefined ) {
82
+
83
+ - state.previousBoneMatrices.set( skeleton.boneMatrices );
84
+ + const scheduledPrevious = skinnedMesh[ Symbol.for( 'threenative.velocity.previousBoneMatrices' ) ];
85
+ + state.previousBoneMatrices.set( scheduledPrevious ?? skeleton.boneMatrices );
86
+
87
+ }
88
+
89
+ @@ -39725,7 +39742,8 @@ class VelocityNode extends TempNode {
90
+
91
+ const previousModelMatrix = getPreviousMatrix( object );
92
+
93
+ - this.previousModelWorldMatrix.value.copy( previousModelMatrix );
94
+ + const scheduledPrevious = object[ Symbol.for( 'threenative.velocity.previousWorldMatrix' ) ];
95
+ + this.previousModelWorldMatrix.value.copy( scheduledPrevious ?? previousModelMatrix );
96
+
97
+ //
98
+
99
+ @@ -53841,7 +53859,7 @@ class NodeBuilder {
100
+
101
+ const mrt = this.renderer.getMRT();
102
+
103
+ - return ( mrt && mrt.has( 'velocity' ) ) || getDataFromObject( this.object ).useVelocity === true;
104
+ + return ( mrt && mrt.has( 'velocity' ) ) || getDataFromObject( this.object ).useVelocity === true || this.object.userData?.useVelocity === true;
105
+
106
+ }
107
+
108
+ @@ -83814,6 +83832,14 @@ class WebGPUBackend extends Backend {
109
+ */
110
+ this.compatibilityMode = null;
111
+
112
+ + /**
113
+ + * A reference to the WebGPU instance that creates adapters.
114
+ + *
115
+ + * @type {?GPU}
116
+ + * @default null
117
+ + */
118
+ + this.gpu = null;
119
+ +
120
+ /**
121
+ * A reference to the device.
122
+ *
123
+ @@ -83926,7 +83952,9 @@ class WebGPUBackend extends Backend {
124
+ xrCompatible: renderer.xr.enabled
125
+ };
126
+
127
+ - const adapter = ( typeof navigator !== 'undefined' ) ? await navigator.gpu.requestAdapter( adapterOptions ) : null;
128
+ + this.gpu = ( typeof navigator !== 'undefined' ) ? navigator.gpu : null;
129
+ +
130
+ + const adapter = this.gpu !== null ? await this.gpu.requestAdapter( adapterOptions ) : null;
131
+
132
+ if ( adapter === null ) {
133
+
134
+ diff --git a/src/nodes/accessors/Batch.js b/src/nodes/accessors/Batch.js
135
+ index ab62e98d..2cf4bb60 100644
136
+ --- a/src/nodes/accessors/Batch.js
137
+ +++ b/src/nodes/accessors/Batch.js
138
+ @@ -1,6 +1,6 @@
139
+
140
+ import { normalLocal } from './Normal.js';
141
+ -import { positionLocal } from './Position.js';
142
+ +import { positionLocal, positionPrevious } from './Position.js';
143
+ import { vec3, mat3, mat4, int, ivec2, float, Fn } from '../tsl/TSLBase.js';
144
+ import { textureLoad } from './TextureNode.js';
145
+ import { textureSize } from './TextureSizeNode.js';
146
+ @@ -64,6 +64,7 @@ export const batch = /*@__PURE__*/ Fn( ( [ batchMesh ], builder ) => {
147
+ const indirectId = getIndirectIndex( batchMesh._indirectTexture, int( batchingIdNode ) );
148
+
149
+ const matricesTexture = batchMesh._matricesTexture;
150
+ + const previousMatricesTexture = batchMesh._previousMatricesTexture ?? matricesTexture;
151
+
152
+ const size = int( textureSize( textureLoad( matricesTexture ), 0 ).x ).toConst();
153
+ const j = float( indirectId ).mul( 4 ).toInt().toConst();
154
+ @@ -90,6 +91,19 @@ export const batch = /*@__PURE__*/ Fn( ( [ batchMesh ], builder ) => {
155
+ const bm = mat3( batchingMatrix );
156
+
157
+ positionLocal.assign( batchingMatrix.mul( positionLocal ) );
158
+ + if ( builder.needsPreviousData() ) {
159
+ +
160
+ + const previousBatchingMatrix = mat4(
161
+ + textureLoad( previousMatricesTexture, ivec2( x, y ) ),
162
+ + textureLoad( previousMatricesTexture, ivec2( x.add( 1 ), y ) ),
163
+ + textureLoad( previousMatricesTexture, ivec2( x.add( 2 ), y ) ),
164
+ + textureLoad( previousMatricesTexture, ivec2( x.add( 3 ), y ) )
165
+ + );
166
+ +
167
+ + positionPrevious.assign( previousBatchingMatrix.mul( positionPrevious ).xyz );
168
+ +
169
+ + }
170
+ +
171
+
172
+ const transformedNormal = normalLocal.div( vec3( bm[ 0 ].dot( bm[ 0 ] ), bm[ 1 ].dot( bm[ 1 ] ), bm[ 2 ].dot( bm[ 2 ] ) ) );
173
+
174
+ @@ -104,5 +118,3 @@ export const batch = /*@__PURE__*/ Fn( ( [ batchMesh ], builder ) => {
175
+ }
176
+
177
+ }, 'void' );
178
+ -
179
+ -
180
+ diff --git a/src/nodes/accessors/Instance.js b/src/nodes/accessors/Instance.js
181
+ index b89834b9..c7b7bdd7 100644
182
+ --- a/src/nodes/accessors/Instance.js
183
+ +++ b/src/nodes/accessors/Instance.js
184
+ @@ -220,7 +220,8 @@ export const instance = /*@__PURE__*/ Fn( ( [ matrices, colors = null ], builder
185
+
186
+ const previousInstanceData = _previousInstanceMatrices.get( object );
187
+
188
+ - previousInstanceData.previousInstanceMatrix.array.set( matrices.array );
189
+ + const scheduledPrevious = object[ Symbol.for( 'threenative.velocity.previousInstanceMatrices' ) ];
190
+ + previousInstanceData.previousInstanceMatrix.array.set( scheduledPrevious ?? matrices.array );
191
+
192
+ } );
193
+
194
+ diff --git a/src/nodes/accessors/Skinning.js b/src/nodes/accessors/Skinning.js
195
+ index 2356aed8..aaeea633 100644
196
+ --- a/src/nodes/accessors/Skinning.js
197
+ +++ b/src/nodes/accessors/Skinning.js
198
+ @@ -149,7 +149,8 @@ export const skinning = /*@__PURE__*/ Fn( ( [ skinnedMesh ], builder ) => {
199
+
200
+ if ( skeletonData !== undefined ) {
201
+
202
+ - skeletonData.previousBoneMatrices.set( skeleton.boneMatrices );
203
+ + const scheduledPrevious = object[ Symbol.for( 'threenative.velocity.previousBoneMatrices' ) ];
204
+ + skeletonData.previousBoneMatrices.set( scheduledPrevious ?? skeleton.boneMatrices );
205
+
206
+ }
207
+
208
+ @@ -216,7 +217,8 @@ export const computeSkinning = /*@__PURE__*/ Fn( ( [ skinnedMesh, toPosition = n
209
+
210
+ if ( state !== undefined ) {
211
+
212
+ - state.previousBoneMatrices.set( skeleton.boneMatrices );
213
+ + const scheduledPrevious = skinnedMesh[ Symbol.for( 'threenative.velocity.previousBoneMatrices' ) ];
214
+ + state.previousBoneMatrices.set( scheduledPrevious ?? skeleton.boneMatrices );
215
+
216
+ }
217
+
218
+ diff --git a/src/nodes/accessors/VelocityNode.js b/src/nodes/accessors/VelocityNode.js
219
+ index 373548b0..c48002ab 100644
220
+ --- a/src/nodes/accessors/VelocityNode.js
221
+ +++ b/src/nodes/accessors/VelocityNode.js
222
+ @@ -106,7 +106,8 @@ class VelocityNode extends TempNode {
223
+
224
+ const previousModelMatrix = getPreviousMatrix( object );
225
+
226
+ - this.previousModelWorldMatrix.value.copy( previousModelMatrix );
227
+ + const scheduledPrevious = object[ Symbol.for( 'threenative.velocity.previousWorldMatrix' ) ];
228
+ + this.previousModelWorldMatrix.value.copy( scheduledPrevious ?? previousModelMatrix );
229
+
230
+ //
231
+
232
+ diff --git a/src/nodes/core/NodeBuilder.js b/src/nodes/core/NodeBuilder.js
233
+ index be00b81e..1990da8f 100644
234
+ --- a/src/nodes/core/NodeBuilder.js
235
+ +++ b/src/nodes/core/NodeBuilder.js
236
+ @@ -3450,7 +3450,7 @@ class NodeBuilder {
237
+
238
+ const mrt = this.renderer.getMRT();
239
+
240
+ - return ( mrt && mrt.has( 'velocity' ) ) || getDataFromObject( this.object ).useVelocity === true;
241
+ + return ( mrt && mrt.has( 'velocity' ) ) || getDataFromObject( this.object ).useVelocity === true || this.object.userData?.useVelocity === true;
242
+
243
+ }
244
+
245
+ diff --git a/src/objects/BatchedMesh.js b/src/objects/BatchedMesh.js
246
+ index 2ef7cb25..35cc0ffe 100644
247
+ --- a/src/objects/BatchedMesh.js
248
+ +++ b/src/objects/BatchedMesh.js
249
+ @@ -181,6 +181,8 @@ function copyArrayContents( src, target ) {
250
+ */
251
+ class BatchedMesh extends Mesh {
252
+
253
+ + static threeNativeBatchedVelocityPatch = true;
254
+ +
255
+ /**
256
+ * Constructs a new batched mesh.
257
+ *
258
+ diff --git a/src/renderers/webgpu/WebGPUBackend.js b/src/renderers/webgpu/WebGPUBackend.js
259
+ index 06e20369..37b5e0be 100644
260
+ --- a/src/renderers/webgpu/WebGPUBackend.js
261
+ +++ b/src/renderers/webgpu/WebGPUBackend.js
262
+ @@ -102,6 +102,14 @@ class WebGPUBackend extends Backend {
263
+ */
264
+ this.compatibilityMode = null;
265
+
266
+ + /**
267
+ + * A reference to the WebGPU instance that creates adapters.
268
+ + *
269
+ + * @type {?GPU}
270
+ + * @default null
271
+ + */
272
+ + this.gpu = null;
273
+ +
274
+ /**
275
+ * A reference to the device.
276
+ *
277
+ @@ -214,7 +222,9 @@ class WebGPUBackend extends Backend {
278
+ xrCompatible: renderer.xr.enabled
279
+ };
280
+
281
+ - const adapter = ( typeof navigator !== 'undefined' ) ? await navigator.gpu.requestAdapter( adapterOptions ) : null;
282
+ + this.gpu = ( typeof navigator !== 'undefined' ) ? navigator.gpu : null;
283
+ +
284
+ + const adapter = this.gpu !== null ? await this.gpu.requestAdapter( adapterOptions ) : null;
285
+
286
+ if ( adapter === null ) {
287
+
@@ -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"]