Release 1.51.0: characters and motion

CHANGELOG.md

@@ -5,6 +5,29 @@
      per release, newest first. HTML comments like this one are stripped before
      rendering, so maintainer notes stay out of the user-facing window. -->
 
+## 1.51.0 — characters and motion 🕺
+
+- **Clips are their own files.** A `.tpanim` is a small clip file in the Explorer (VRM Animation inside, so it opens in
+  VRM tools too). Import `.vrma`, `.bvh`, animation `.glb` or `.fbx`, then drop a clip on a character: it plays on every
+  peer, the bytes travel once and the model never changes.
+- **Any clip on any humanoid.** VRM, Mixamo, Meshy, UniRig, KayKit and Quaternius rigs map onto the VRM 1.0 humanoid by
+  themselves (fix the map by hand if you like). *Apply clip…* fits a clip to each character's skeleton.
+- **Free CC0 packs.** Characters (10 avatars) and Motion (87 clips: locomotion, jumps, sitting, swimming, combat…),
+  in the Asset Browser's new Motion tab, plus an Avatars tab reading the Open Source Avatars registry.
+- **VRM characters** with spring bones, expressions (a Set Expression node too) and their licence in the Inspector.
+- **Game-ready clips.** In place or moving, *Loop it*, trim, split, join with a crossfade, *Extract clips* from a model;
+  a Crossfade on Play Animation and a new **Blend by Speed** node, so characters stop snapping between poses.
+- **Animation states.** A window per character with states and transitions. The one-click **Locomotion preset** makes
+  even a fresh VRM walk, run and jump under the Player controller, filling missing clips from the Motion pack. New
+  nodes: Set Animation Parameter, On Animation State.
+- **Skeleton fix-ups.** Rename, move, add, delete and mirror bones; automatic weights, smoothing and a weight brush.
+- **Download a character with its clips.** One GLB for Blender, Unity, Unreal and Godot (default), model + clip files,
+  or the model alone; one clip as `.tpanim`, `.glb`, `.vrma` or `.bvh`.
+- **Animate a model's named parts** and attach things to its sockets (Attach to Socket node); agents get the
+  `animate_parts` tool.
+- **Licence warnings.** Everything records where it came from. Licences that ask for credit or restrict sharing warn you
+  in Download, Export and Publish, and never block.
+
 ## 1.50.0 — talk to your agent 💬
 
 - **Chat with the AI agents in your session.** The AI assistant window lists them next to your own assistant: pick

package.json

@@ -31,6 +31,7 @@
 	"devDependencies": {
 		"@axe-core/playwright": "4.14.0",
 		"@iwer/devui": "2.7.0",
+		"@pixiv/three-vrm-animation": "^3.5.5",
 		"@sveltejs/adapter-static": "^3.0.10",
 		"@sveltejs/kit": "^2.70.3",
 		"@sveltejs/vite-plugin-svelte": "^7.3.1",
@@ -58,6 +59,7 @@
 		"@gltf-transform/functions": "^4.5.1",
 		"@jitl/quickjs-wasmfile-release-sync": "0.32.0",
 		"@lucide/svelte": "^1.61.0",
+		"@pixiv/three-vrm": "3.5.5",
 		"@shaderfrog/core": "^4.0.2",
 		"@shaderfrog/glsl-parser": "^7.0.1",
 		"@threlte/core": "^8.6.1",

src/App.svelte

@@ -32,6 +32,8 @@
   // panel, so it sits with ConfirmModal where every entry point can reach it.
   import StorageModal from './components/menu/StorageModal.svelte'
   import ReplaceModelModal from './components/menu/ReplaceModelModal.svelte'
+  // 57: Apply clip… / Download… / the Skeleton view — a tiny host, the dialogs load on open
+  import CharacterDialogs from './components/characters/CharacterDialogs.svelte'
   import PlaceholderTooltip from './components/menu/PlaceholderTooltip.svelte'
   import Flow from './components/Flow.svelte'
   import FlowCode from './components/editors/FlowCode.svelte'
@@ -405,11 +407,15 @@ import { startMusicToolbox } from './lib/musicToolbox'
     const files = [...(event.dataTransfer?.files ?? [])]
     if (files.length === 0) return
     const skipped = []
-    const modelExt = /\.(glb|gltf|obj|stl|fbx)$/
+    const modelExt = /\.(glb|gltf|obj|stl|fbx|vrm)$/
     // 17-D2: a .mtl / texture dropped ALONGSIDE a model is its companion, not
     // an unsupported file — importFile pairs them up.
     const companionExt = /\.(mtl|png|jpe?g|webp|bmp|gif)$/i
     const companions = files.filter((file) => companionExt.test(file.name))
+    // 57 M1: animation clip files go to the Explorer (converted to .tpanim) and onto the rig under the cursor
+    const clipExt = /\.(tpanim|vrma|bvh)$/i
+    const clipFiles = files.filter((file) => clipExt.test(file.name))
+    if (clipFiles.length) import('./lib/explorerDrop').then((m) => m.dropClipFiles(clipFiles, event.clientX, event.clientY))
     // 60 Q5: a drop of nothing but images is not a model's companions — they used to be
     // dropped silently. Ask what they are for: a reference image to build over, or the Explorer.
     const imageExt = /\.(png|jpe?g|webp|bmp|gif)$/i
@@ -419,6 +425,7 @@ import { startMusicToolbox } from './lib/musicToolbox'
     }
     files.forEach((file) => {
       const name = file.name.toLowerCase()
+      if (clipFiles.includes(file)) return
       if (modelExt.test(name)) importFile(file, file.name.replace(modelExt, ''), undefined, undefined, companions)
       else if (name.endsWith('.json')) load(file)
       else if (!companions.includes(file)) skipped.push(file.name)
@@ -479,6 +486,7 @@ import { startMusicToolbox } from './lib/musicToolbox'
 <!-- 36 U9: Replace model… for a loading/failed placeholder, and the hover tooltip over one -->
 <ReplaceModelModal />
 <PlaceholderTooltip />
+<CharacterDialogs />
 <DrawToolbar />
 <SculptToolbar />
 <SplineToolbar />