@umicat/three-sdk 0.18.0 → 0.19.0

package/README.md

@@ -73,6 +73,11 @@ Each rule is a decision:
   Guessing that every model calls its walk cycle `Walk` fails silently; an
   independent review's cross-rig retarget returned zero matched bones and zero
   tracks, which is the same class of failure, quieter.
+- **A prop declares which socket it belongs in** (`socket: 'hand-right'` on the
+  sword, `sockets: { 'hand-right': {...} }` on the character). Both halves are
+  properties of the MODEL, not of any game — a cap goes on a head in every game
+  there has ever been — so a game that owns a character pack does not also have
+  to own a lookup table saying a cap is headwear.
 - **Skins are declared per asset and chosen per entity**
   (`skins: { zombie: 'skins/zombieA.png' }`, then `skin: 'zombie'`). A body and
   its wardrobe are separate files, so N bodies × M skins costs N + M assets

package/dist/scene3d.d.ts

@@ -142,6 +142,17 @@ export interface ModelAsset3D {
     animations?: AnimationMap;
     /** Interchangeable textures for this model — `{ "zombie": "skins/zombieA.png" }`. */
     skins?: SkinMap;
+    /**
+     * For a model that is WORN rather than worn-on: which of a character's
+     * `sockets` it belongs in — `"head"` for a cap, `"hand-right"` for a sword.
+     *
+     * The pairing is a property of the prop, not of any game: a cap goes on a
+     * head in every game that has ever existed. Without it, "attach this cap"
+     * needs a lookup table written per game, and twelve games write twelve
+     * slightly different ones — the same argument as the socket offsets living
+     * on the character (see `Socket3D`), from the other end.
+     */
+    socket?: string;
     /** Authoring correction applied at load: most models are not born 1 unit tall. */
     importScale?: number;
     /** Named attachment points — `{ "hand-right": { bone: "arm-right", ... } }`. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umicat/three-sdk",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Three.js runtime for Umicat games: the scene3d design format, its loader with physics, a kinematic character controller, and the Umicat platform via @umicat/platform-sdk.",
   "type": "module",
   "main": "dist/index.js",