@dcl/ecs 7.24.5-29247185020.commit-e92dfe6 → 7.24.5-29255693632.commit-d9d75fe

package/dist/components/generated/pb/decentraland/sdk/components/avatar_locomotion_settings.gen.d.ts

@@ -19,6 +19,12 @@ export interface PBAvatarLocomotionSettings {
     runJumpHeight?: number | undefined;
     /** Cooldown time after a hard landing before the avatar can move again (in seconds) */
     hardLandingCooldown?: number | undefined;
+    /** Height of the double jump (in meters) */
+    doubleJumpHeight?: number | undefined;
+    /** Maximum speed when gliding (in meters per second) */
+    glidingSpeed?: number | undefined;
+    /** Maximum falling speed when gliding (in meters per second) */
+    glidingFallingSpeed?: number | undefined;
 }
 /**
  * @public

package/dist/components/generated/pb/decentraland/sdk/components/avatar_locomotion_settings.gen.js

@@ -9,6 +9,9 @@ function createBasePBAvatarLocomotionSettings() {
         jumpHeight: undefined,
         runJumpHeight: undefined,
         hardLandingCooldown: undefined,
+        doubleJumpHeight: undefined,
+        glidingSpeed: undefined,
+        glidingFallingSpeed: undefined,
     };
 }
 /**
@@ -35,6 +38,15 @@ export var PBAvatarLocomotionSettings;
         if (message.hardLandingCooldown !== undefined) {
             writer.uint32(53).float(message.hardLandingCooldown);
         }
+        if (message.doubleJumpHeight !== undefined) {
+            writer.uint32(61).float(message.doubleJumpHeight);
+        }
+        if (message.glidingSpeed !== undefined) {
+            writer.uint32(69).float(message.glidingSpeed);
+        }
+        if (message.glidingFallingSpeed !== undefined) {
+            writer.uint32(77).float(message.glidingFallingSpeed);
+        }
         return writer;
     }
     PBAvatarLocomotionSettings.encode = encode;
@@ -81,6 +93,24 @@ export var PBAvatarLocomotionSettings;
                     }
                     message.hardLandingCooldown = reader.float();
                     continue;
+                case 7:
+                    if (tag !== 61) {
+                        break;
+                    }
+                    message.doubleJumpHeight = reader.float();
+                    continue;
+                case 8:
+                    if (tag !== 69) {
+                        break;
+                    }
+                    message.glidingSpeed = reader.float();
+                    continue;
+                case 9:
+                    if (tag !== 77) {
+                        break;
+                    }
+                    message.glidingFallingSpeed = reader.float();
+                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;

package/dist/components/generated/pb/decentraland/sdk/components/avatar_modifier_area.gen.d.ts

@@ -8,7 +8,9 @@ export declare const enum AvatarModifierType {
     /** AMT_HIDE_AVATARS - avatars are invisible */
     AMT_HIDE_AVATARS = 0,
     /** AMT_DISABLE_PASSPORTS - selecting (e.g. clicking) an avatar will not bring up their profile. */
-    AMT_DISABLE_PASSPORTS = 1
+    AMT_DISABLE_PASSPORTS = 1,
+    /** AMT_HIDE_NAMETAGS - the name tag displayed above an avatar is hidden. */
+    AMT_HIDE_NAMETAGS = 2
 }
 /**
  * @public

package/dist/components/generated/pb/decentraland/sdk/components/avatar_modifier_area.gen.js

@@ -12,6 +12,8 @@ export var AvatarModifierType;
     AvatarModifierType[AvatarModifierType["AMT_HIDE_AVATARS"] = 0] = "AMT_HIDE_AVATARS";
     /** AMT_DISABLE_PASSPORTS - selecting (e.g. clicking) an avatar will not bring up their profile. */
     AvatarModifierType[AvatarModifierType["AMT_DISABLE_PASSPORTS"] = 1] = "AMT_DISABLE_PASSPORTS";
+    /** AMT_HIDE_NAMETAGS - the name tag displayed above an avatar is hidden. */
+    AvatarModifierType[AvatarModifierType["AMT_HIDE_NAMETAGS"] = 2] = "AMT_HIDE_NAMETAGS";
 })(AvatarModifierType || (AvatarModifierType = {}));
 /**
  * @public

package/dist/components/generated/pb/decentraland/sdk/components/avatar_movement.gen.d.ts

@@ -5,11 +5,41 @@ import { Vector3 } from "../../common/vectors.gen";
  */
 export interface PBAvatarMovement {
     velocity: Vector3 | undefined;
-    /** 0-360, we don't allow pitch/roll */
+    /** 0-360, yaw only; this is the authoritative facing (other clients read it, and physics treats the avatar as upright). Lean is expressed separately via tilt_pitch/tilt_roll. */
     orientation: number;
     groundDirection?: Vector3 | undefined;
     /** set for one frame when a walk_target ends: true = reached target, false = failed; absent = in progress or no walk */
     walkSuccess?: boolean | undefined;
+    /** if set, the engine plays this animation instead of selecting one from velocity heuristics */
+    animation?: MovementAnimation | undefined;
+    /** render-only forward/back lean in degrees, applied on top of `orientation` (rotation about the avatar's local X axis). Does not affect the physics capsule (stays upright) or the facing other clients read. Defaults to 0. */
+    tiltPitch?: number | undefined;
+    /** render-only sideways lean in degrees, applied on top of `orientation` (rotation about the avatar's local Z axis). Same constraints as tilt_pitch. Useful e.g. for glider banking. Defaults to 0. */
+    tiltRoll?: number | undefined;
+}
+/**
+ * Describes the animation the movement scene wants the avatar to play.
+ * One GLB = one clip (following the scene-emote convention: single clip, or a clip named with `_Avatar` suffix).
+ * When absent the engine falls back to its built-in velocity-based selection (walk/run/jump/idle).
+ */
+/**
+ * @public
+ */
+export interface MovementAnimation {
+    /** scene-relative path to the gltf/glb asset (resolved via the scene content map) */
+    src: string;
+    /** whether the clip repeats once it reaches the end */
+    loop: boolean;
+    /** playback speed multiplier (1.0 = clip's native rate) */
+    speed: number;
+    /** true: a triggerSceneEmote may take over; false: emotes are suppressed while this animation plays */
+    idle: boolean;
+    /** cross-fade duration when `src` changes; defaults to 0.2 when unset. Not applied to loop/speed/idle changes. */
+    transitionSeconds?: number | undefined;
+    /** if set, the engine seeks to this position (in seconds) this frame. Clear on subsequent frames to allow normal playback. The scene can read `AvatarAnimationState.playback_time` first to decide. */
+    playbackTime?: number | undefined;
+    /** scene-relative paths to audio clips (.mp3/.ogg) to play this frame on the avatar audio bus. Fire-and-forget: each listed clip plays once per frame it appears; leaving a clip set for multiple frames re-triggers it. No stop mechanism. Use `AvatarAnimationState.playback_time` to trigger sounds at the right point in the clip (e.g. foot plants). */
+    sounds: string[];
 }
 /**
  * @public
@@ -18,3 +48,10 @@ export declare namespace PBAvatarMovement {
     function encode(message: PBAvatarMovement, writer?: _m0.Writer): _m0.Writer;
     function decode(input: _m0.Reader | Uint8Array, length?: number): PBAvatarMovement;
 }
+/**
+ * @public
+ */
+export declare namespace MovementAnimation {
+    function encode(message: MovementAnimation, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): MovementAnimation;
+}

package/dist/components/generated/pb/decentraland/sdk/components/avatar_movement.gen.js

@@ -3,7 +3,15 @@ import _m0 from "protobufjs/minimal";
 import { Vector3 } from "../../common/vectors.gen";
 const protobufPackageSarasa = "decentraland.sdk.components";
 function createBasePBAvatarMovement() {
-    return { velocity: undefined, orientation: 0, groundDirection: undefined, walkSuccess: undefined };
+    return {
+        velocity: undefined,
+        orientation: 0,
+        groundDirection: undefined,
+        walkSuccess: undefined,
+        animation: undefined,
+        tiltPitch: undefined,
+        tiltRoll: undefined,
+    };
 }
 /**
  * @public
@@ -23,6 +31,15 @@ export var PBAvatarMovement;
         if (message.walkSuccess !== undefined) {
             writer.uint32(32).bool(message.walkSuccess);
         }
+        if (message.animation !== undefined) {
+            MovementAnimation.encode(message.animation, writer.uint32(42).fork()).ldelim();
+        }
+        if (message.tiltPitch !== undefined) {
+            writer.uint32(53).float(message.tiltPitch);
+        }
+        if (message.tiltRoll !== undefined) {
+            writer.uint32(61).float(message.tiltRoll);
+        }
         return writer;
     }
     PBAvatarMovement.encode = encode;
@@ -57,6 +74,24 @@ export var PBAvatarMovement;
                     }
                     message.walkSuccess = reader.bool();
                     continue;
+                case 5:
+                    if (tag !== 42) {
+                        break;
+                    }
+                    message.animation = MovementAnimation.decode(reader, reader.uint32());
+                    continue;
+                case 6:
+                    if (tag !== 53) {
+                        break;
+                    }
+                    message.tiltPitch = reader.float();
+                    continue;
+                case 7:
+                    if (tag !== 61) {
+                        break;
+                    }
+                    message.tiltRoll = reader.float();
+                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -67,3 +102,103 @@ export var PBAvatarMovement;
     }
     PBAvatarMovement.decode = decode;
 })(PBAvatarMovement || (PBAvatarMovement = {}));
+function createBaseMovementAnimation() {
+    return {
+        src: "",
+        loop: false,
+        speed: 0,
+        idle: false,
+        transitionSeconds: undefined,
+        playbackTime: undefined,
+        sounds: [],
+    };
+}
+/**
+ * @public
+ */
+export var MovementAnimation;
+(function (MovementAnimation) {
+    function encode(message, writer = _m0.Writer.create()) {
+        if (message.src !== "") {
+            writer.uint32(10).string(message.src);
+        }
+        if (message.loop === true) {
+            writer.uint32(16).bool(message.loop);
+        }
+        if (message.speed !== 0) {
+            writer.uint32(29).float(message.speed);
+        }
+        if (message.idle === true) {
+            writer.uint32(32).bool(message.idle);
+        }
+        if (message.transitionSeconds !== undefined) {
+            writer.uint32(45).float(message.transitionSeconds);
+        }
+        if (message.playbackTime !== undefined) {
+            writer.uint32(53).float(message.playbackTime);
+        }
+        for (const v of message.sounds) {
+            writer.uint32(58).string(v);
+        }
+        return writer;
+    }
+    MovementAnimation.encode = encode;
+    function decode(input, length) {
+        const reader = input instanceof _m0.Reader ? input : _m0.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseMovementAnimation();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.src = reader.string();
+                    continue;
+                case 2:
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.loop = reader.bool();
+                    continue;
+                case 3:
+                    if (tag !== 29) {
+                        break;
+                    }
+                    message.speed = reader.float();
+                    continue;
+                case 4:
+                    if (tag !== 32) {
+                        break;
+                    }
+                    message.idle = reader.bool();
+                    continue;
+                case 5:
+                    if (tag !== 45) {
+                        break;
+                    }
+                    message.transitionSeconds = reader.float();
+                    continue;
+                case 6:
+                    if (tag !== 53) {
+                        break;
+                    }
+                    message.playbackTime = reader.float();
+                    continue;
+                case 7:
+                    if (tag !== 58) {
+                        break;
+                    }
+                    message.sounds.push(reader.string());
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    }
+    MovementAnimation.decode = decode;
+})(MovementAnimation || (MovementAnimation = {}));

package/dist/components/generated/pb/decentraland/sdk/components/avatar_movement_info.gen.d.ts

@@ -22,6 +22,32 @@ export interface PBAvatarMovementInfo {
     walkTarget?: Vector3 | undefined;
     /** stop distance for walk_target; considered reached when within this distance */
     walkThreshold?: number | undefined;
+    /** current state of a scene-driven movement animation. Absent when the engine is using its velocity-based fallback. `playback_time` freezes while a triggerSceneEmote is overriding the animation. */
+    activeAnimationState?: AvatarAnimationState | undefined;
+}
+/**
+ * Mirror of the scene-driven movement animation currently playing, reported by the engine.
+ * Readable by any scene (not just the controller) so niche effects (e.g. dust cloud on landing) can react.
+ * Active emotes are not represented here — scenes already have their own way to read them.
+ */
+/**
+ * @public
+ */
+export interface AvatarAnimationState {
+    /** same scene-relative path the controlling scene supplied */
+    src: string;
+    /** mirrors the request */
+    loop: boolean;
+    /** mirrors the request */
+    speed: number;
+    /** mirrors the request */
+    idle: boolean;
+    /** seconds into the clip; wraps on loop; frozen while an emote override is playing */
+    playbackTime: number;
+    /** total clip length in seconds */
+    duration: number;
+    /** how many times the clip has completed since it started */
+    loopCount: number;
 }
 /**
  * @public
@@ -30,3 +56,10 @@ export declare namespace PBAvatarMovementInfo {
     function encode(message: PBAvatarMovementInfo, writer?: _m0.Writer): _m0.Writer;
     function decode(input: _m0.Reader | Uint8Array, length?: number): PBAvatarMovementInfo;
 }
+/**
+ * @public
+ */
+export declare namespace AvatarAnimationState {
+    function encode(message: AvatarAnimationState, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): AvatarAnimationState;
+}

package/dist/components/generated/pb/decentraland/sdk/components/avatar_movement_info.gen.js

@@ -15,6 +15,7 @@ function createBasePBAvatarMovementInfo() {
         activeInputModifier: undefined,
         walkTarget: undefined,
         walkThreshold: undefined,
+        activeAnimationState: undefined,
     };
 }
 /**
@@ -50,6 +51,9 @@ export var PBAvatarMovementInfo;
         if (message.walkThreshold !== undefined) {
             writer.uint32(77).float(message.walkThreshold);
         }
+        if (message.activeAnimationState !== undefined) {
+            AvatarAnimationState.encode(message.activeAnimationState, writer.uint32(82).fork()).ldelim();
+        }
         return writer;
     }
     PBAvatarMovementInfo.encode = encode;
@@ -114,6 +118,12 @@ export var PBAvatarMovementInfo;
                     }
                     message.walkThreshold = reader.float();
                     continue;
+                case 10:
+                    if (tag !== 82) {
+                        break;
+                    }
+                    message.activeAnimationState = AvatarAnimationState.decode(reader, reader.uint32());
+                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -124,3 +134,95 @@ export var PBAvatarMovementInfo;
     }
     PBAvatarMovementInfo.decode = decode;
 })(PBAvatarMovementInfo || (PBAvatarMovementInfo = {}));
+function createBaseAvatarAnimationState() {
+    return { src: "", loop: false, speed: 0, idle: false, playbackTime: 0, duration: 0, loopCount: 0 };
+}
+/**
+ * @public
+ */
+export var AvatarAnimationState;
+(function (AvatarAnimationState) {
+    function encode(message, writer = _m0.Writer.create()) {
+        if (message.src !== "") {
+            writer.uint32(10).string(message.src);
+        }
+        if (message.loop === true) {
+            writer.uint32(16).bool(message.loop);
+        }
+        if (message.speed !== 0) {
+            writer.uint32(29).float(message.speed);
+        }
+        if (message.idle === true) {
+            writer.uint32(32).bool(message.idle);
+        }
+        if (message.playbackTime !== 0) {
+            writer.uint32(45).float(message.playbackTime);
+        }
+        if (message.duration !== 0) {
+            writer.uint32(53).float(message.duration);
+        }
+        if (message.loopCount !== 0) {
+            writer.uint32(56).uint32(message.loopCount);
+        }
+        return writer;
+    }
+    AvatarAnimationState.encode = encode;
+    function decode(input, length) {
+        const reader = input instanceof _m0.Reader ? input : _m0.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseAvatarAnimationState();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.src = reader.string();
+                    continue;
+                case 2:
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.loop = reader.bool();
+                    continue;
+                case 3:
+                    if (tag !== 29) {
+                        break;
+                    }
+                    message.speed = reader.float();
+                    continue;
+                case 4:
+                    if (tag !== 32) {
+                        break;
+                    }
+                    message.idle = reader.bool();
+                    continue;
+                case 5:
+                    if (tag !== 45) {
+                        break;
+                    }
+                    message.playbackTime = reader.float();
+                    continue;
+                case 6:
+                    if (tag !== 53) {
+                        break;
+                    }
+                    message.duration = reader.float();
+                    continue;
+                case 7:
+                    if (tag !== 56) {
+                        break;
+                    }
+                    message.loopCount = reader.uint32();
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    }
+    AvatarAnimationState.decode = decode;
+})(AvatarAnimationState || (AvatarAnimationState = {}));

package/dist/components/generated/pb/decentraland/sdk/components/ui_canvas_information.gen.d.ts

@@ -19,6 +19,14 @@ export interface PBUiCanvasInformation {
      * on the contrary, if the chat UI is shown, the rect would be smaller.
      */
     interactableArea: BorderRect | undefined;
+    /**
+     * informs the sdk about the screen inset area (safe margins). these are the
+     * insets from each edge of the screen that are reserved by the device or
+     * platform UI (for example: the notch, status bar, home indicator, or rounded
+     * corners on mobile). scenes should avoid placing critical UI within these
+     * insets to ensure it is not occluded. on desktop this is typically (0, 0, 0, 0).
+     */
+    screenInsetArea?: BorderRect | undefined;
 }
 /**
  * @public

package/dist/components/generated/pb/decentraland/sdk/components/ui_canvas_information.gen.js

@@ -3,7 +3,7 @@ import _m0 from "protobufjs/minimal";
 import { BorderRect } from "../../common/border_rect.gen";
 const protobufPackageSarasa = "decentraland.sdk.components";
 function createBasePBUiCanvasInformation() {
-    return { devicePixelRatio: 0, width: 0, height: 0, interactableArea: undefined };
+    return { devicePixelRatio: 0, width: 0, height: 0, interactableArea: undefined, screenInsetArea: undefined };
 }
 /**
  * @public
@@ -23,6 +23,9 @@ export var PBUiCanvasInformation;
         if (message.interactableArea !== undefined) {
             BorderRect.encode(message.interactableArea, writer.uint32(34).fork()).ldelim();
         }
+        if (message.screenInsetArea !== undefined) {
+            BorderRect.encode(message.screenInsetArea, writer.uint32(42).fork()).ldelim();
+        }
         return writer;
     }
     PBUiCanvasInformation.encode = encode;
@@ -57,6 +60,12 @@ export var PBUiCanvasInformation;
                     }
                     message.interactableArea = BorderRect.decode(reader, reader.uint32());
                     continue;
+                case 5:
+                    if (tag !== 42) {
+                        break;
+                    }
+                    message.screenInsetArea = BorderRect.decode(reader, reader.uint32());
+                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;

package/dist-cjs/components/generated/pb/decentraland/sdk/components/avatar_locomotion_settings.gen.d.ts

@@ -19,6 +19,12 @@ export interface PBAvatarLocomotionSettings {
     runJumpHeight?: number | undefined;
     /** Cooldown time after a hard landing before the avatar can move again (in seconds) */
     hardLandingCooldown?: number | undefined;
+    /** Height of the double jump (in meters) */
+    doubleJumpHeight?: number | undefined;
+    /** Maximum speed when gliding (in meters per second) */
+    glidingSpeed?: number | undefined;
+    /** Maximum falling speed when gliding (in meters per second) */
+    glidingFallingSpeed?: number | undefined;
 }
 /**
  * @public

package/dist-cjs/components/generated/pb/decentraland/sdk/components/avatar_locomotion_settings.gen.js

@@ -15,6 +15,9 @@ function createBasePBAvatarLocomotionSettings() {
         jumpHeight: undefined,
         runJumpHeight: undefined,
         hardLandingCooldown: undefined,
+        doubleJumpHeight: undefined,
+        glidingSpeed: undefined,
+        glidingFallingSpeed: undefined,
     };
 }
 /**
@@ -41,6 +44,15 @@ var PBAvatarLocomotionSettings;
         if (message.hardLandingCooldown !== undefined) {
             writer.uint32(53).float(message.hardLandingCooldown);
         }
+        if (message.doubleJumpHeight !== undefined) {
+            writer.uint32(61).float(message.doubleJumpHeight);
+        }
+        if (message.glidingSpeed !== undefined) {
+            writer.uint32(69).float(message.glidingSpeed);
+        }
+        if (message.glidingFallingSpeed !== undefined) {
+            writer.uint32(77).float(message.glidingFallingSpeed);
+        }
         return writer;
     }
     PBAvatarLocomotionSettings.encode = encode;
@@ -87,6 +99,24 @@ var PBAvatarLocomotionSettings;
                     }
                     message.hardLandingCooldown = reader.float();
                     continue;
+                case 7:
+                    if (tag !== 61) {
+                        break;
+                    }
+                    message.doubleJumpHeight = reader.float();
+                    continue;
+                case 8:
+                    if (tag !== 69) {
+                        break;
+                    }
+                    message.glidingSpeed = reader.float();
+                    continue;
+                case 9:
+                    if (tag !== 77) {
+                        break;
+                    }
+                    message.glidingFallingSpeed = reader.float();
+                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;

package/dist-cjs/components/generated/pb/decentraland/sdk/components/avatar_modifier_area.gen.d.ts

@@ -8,7 +8,9 @@ export declare const enum AvatarModifierType {
     /** AMT_HIDE_AVATARS - avatars are invisible */
     AMT_HIDE_AVATARS = 0,
     /** AMT_DISABLE_PASSPORTS - selecting (e.g. clicking) an avatar will not bring up their profile. */
-    AMT_DISABLE_PASSPORTS = 1
+    AMT_DISABLE_PASSPORTS = 1,
+    /** AMT_HIDE_NAMETAGS - the name tag displayed above an avatar is hidden. */
+    AMT_HIDE_NAMETAGS = 2
 }
 /**
  * @public

package/dist-cjs/components/generated/pb/decentraland/sdk/components/avatar_modifier_area.gen.js

@@ -18,6 +18,8 @@ var AvatarModifierType;
     AvatarModifierType[AvatarModifierType["AMT_HIDE_AVATARS"] = 0] = "AMT_HIDE_AVATARS";
     /** AMT_DISABLE_PASSPORTS - selecting (e.g. clicking) an avatar will not bring up their profile. */
     AvatarModifierType[AvatarModifierType["AMT_DISABLE_PASSPORTS"] = 1] = "AMT_DISABLE_PASSPORTS";
+    /** AMT_HIDE_NAMETAGS - the name tag displayed above an avatar is hidden. */
+    AvatarModifierType[AvatarModifierType["AMT_HIDE_NAMETAGS"] = 2] = "AMT_HIDE_NAMETAGS";
 })(AvatarModifierType = exports.AvatarModifierType || (exports.AvatarModifierType = {}));
 /**
  * @public

package/dist-cjs/components/generated/pb/decentraland/sdk/components/avatar_movement.gen.d.ts

@@ -5,11 +5,41 @@ import { Vector3 } from "../../common/vectors.gen";
  */
 export interface PBAvatarMovement {
     velocity: Vector3 | undefined;
-    /** 0-360, we don't allow pitch/roll */
+    /** 0-360, yaw only; this is the authoritative facing (other clients read it, and physics treats the avatar as upright). Lean is expressed separately via tilt_pitch/tilt_roll. */
     orientation: number;
     groundDirection?: Vector3 | undefined;
     /** set for one frame when a walk_target ends: true = reached target, false = failed; absent = in progress or no walk */
     walkSuccess?: boolean | undefined;
+    /** if set, the engine plays this animation instead of selecting one from velocity heuristics */
+    animation?: MovementAnimation | undefined;
+    /** render-only forward/back lean in degrees, applied on top of `orientation` (rotation about the avatar's local X axis). Does not affect the physics capsule (stays upright) or the facing other clients read. Defaults to 0. */
+    tiltPitch?: number | undefined;
+    /** render-only sideways lean in degrees, applied on top of `orientation` (rotation about the avatar's local Z axis). Same constraints as tilt_pitch. Useful e.g. for glider banking. Defaults to 0. */
+    tiltRoll?: number | undefined;
+}
+/**
+ * Describes the animation the movement scene wants the avatar to play.
+ * One GLB = one clip (following the scene-emote convention: single clip, or a clip named with `_Avatar` suffix).
+ * When absent the engine falls back to its built-in velocity-based selection (walk/run/jump/idle).
+ */
+/**
+ * @public
+ */
+export interface MovementAnimation {
+    /** scene-relative path to the gltf/glb asset (resolved via the scene content map) */
+    src: string;
+    /** whether the clip repeats once it reaches the end */
+    loop: boolean;
+    /** playback speed multiplier (1.0 = clip's native rate) */
+    speed: number;
+    /** true: a triggerSceneEmote may take over; false: emotes are suppressed while this animation plays */
+    idle: boolean;
+    /** cross-fade duration when `src` changes; defaults to 0.2 when unset. Not applied to loop/speed/idle changes. */
+    transitionSeconds?: number | undefined;
+    /** if set, the engine seeks to this position (in seconds) this frame. Clear on subsequent frames to allow normal playback. The scene can read `AvatarAnimationState.playback_time` first to decide. */
+    playbackTime?: number | undefined;
+    /** scene-relative paths to audio clips (.mp3/.ogg) to play this frame on the avatar audio bus. Fire-and-forget: each listed clip plays once per frame it appears; leaving a clip set for multiple frames re-triggers it. No stop mechanism. Use `AvatarAnimationState.playback_time` to trigger sounds at the right point in the clip (e.g. foot plants). */
+    sounds: string[];
 }
 /**
  * @public
@@ -18,3 +48,10 @@ export declare namespace PBAvatarMovement {
     function encode(message: PBAvatarMovement, writer?: _m0.Writer): _m0.Writer;
     function decode(input: _m0.Reader | Uint8Array, length?: number): PBAvatarMovement;
 }
+/**
+ * @public
+ */
+export declare namespace MovementAnimation {
+    function encode(message: MovementAnimation, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): MovementAnimation;
+}

package/dist-cjs/components/generated/pb/decentraland/sdk/components/avatar_movement.gen.js

@@ -3,13 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PBAvatarMovement = void 0;
+exports.MovementAnimation = exports.PBAvatarMovement = void 0;
 /* eslint-disable */
 const minimal_1 = __importDefault(require("protobufjs/minimal"));
 const vectors_gen_1 = require("../../common/vectors.gen");
 const protobufPackageSarasa = "decentraland.sdk.components";
 function createBasePBAvatarMovement() {
-    return { velocity: undefined, orientation: 0, groundDirection: undefined, walkSuccess: undefined };
+    return {
+        velocity: undefined,
+        orientation: 0,
+        groundDirection: undefined,
+        walkSuccess: undefined,
+        animation: undefined,
+        tiltPitch: undefined,
+        tiltRoll: undefined,
+    };
 }
 /**
  * @public
@@ -29,6 +37,15 @@ var PBAvatarMovement;
         if (message.walkSuccess !== undefined) {
             writer.uint32(32).bool(message.walkSuccess);
         }
+        if (message.animation !== undefined) {
+            MovementAnimation.encode(message.animation, writer.uint32(42).fork()).ldelim();
+        }
+        if (message.tiltPitch !== undefined) {
+            writer.uint32(53).float(message.tiltPitch);
+        }
+        if (message.tiltRoll !== undefined) {
+            writer.uint32(61).float(message.tiltRoll);
+        }
         return writer;
     }
     PBAvatarMovement.encode = encode;
@@ -63,6 +80,24 @@ var PBAvatarMovement;
                     }
                     message.walkSuccess = reader.bool();
                     continue;
+                case 5:
+                    if (tag !== 42) {
+                        break;
+                    }
+                    message.animation = MovementAnimation.decode(reader, reader.uint32());
+                    continue;
+                case 6:
+                    if (tag !== 53) {
+                        break;
+                    }
+                    message.tiltPitch = reader.float();
+                    continue;
+                case 7:
+                    if (tag !== 61) {
+                        break;
+                    }
+                    message.tiltRoll = reader.float();
+                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -73,3 +108,103 @@ var PBAvatarMovement;
     }
     PBAvatarMovement.decode = decode;
 })(PBAvatarMovement = exports.PBAvatarMovement || (exports.PBAvatarMovement = {}));
+function createBaseMovementAnimation() {
+    return {
+        src: "",
+        loop: false,
+        speed: 0,
+        idle: false,
+        transitionSeconds: undefined,
+        playbackTime: undefined,
+        sounds: [],
+    };
+}
+/**
+ * @public
+ */
+var MovementAnimation;
+(function (MovementAnimation) {
+    function encode(message, writer = minimal_1.default.Writer.create()) {
+        if (message.src !== "") {
+            writer.uint32(10).string(message.src);
+        }
+        if (message.loop === true) {
+            writer.uint32(16).bool(message.loop);
+        }
+        if (message.speed !== 0) {
+            writer.uint32(29).float(message.speed);
+        }
+        if (message.idle === true) {
+            writer.uint32(32).bool(message.idle);
+        }
+        if (message.transitionSeconds !== undefined) {
+            writer.uint32(45).float(message.transitionSeconds);
+        }
+        if (message.playbackTime !== undefined) {
+            writer.uint32(53).float(message.playbackTime);
+        }
+        for (const v of message.sounds) {
+            writer.uint32(58).string(v);
+        }
+        return writer;
+    }
+    MovementAnimation.encode = encode;
+    function decode(input, length) {
+        const reader = input instanceof minimal_1.default.Reader ? input : minimal_1.default.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseMovementAnimation();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.src = reader.string();
+                    continue;
+                case 2:
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.loop = reader.bool();
+                    continue;
+                case 3:
+                    if (tag !== 29) {
+                        break;
+                    }
+                    message.speed = reader.float();
+                    continue;
+                case 4:
+                    if (tag !== 32) {
+                        break;
+                    }
+                    message.idle = reader.bool();
+                    continue;
+                case 5:
+                    if (tag !== 45) {
+                        break;
+                    }
+                    message.transitionSeconds = reader.float();
+                    continue;
+                case 6:
+                    if (tag !== 53) {
+                        break;
+                    }
+                    message.playbackTime = reader.float();
+                    continue;
+                case 7:
+                    if (tag !== 58) {
+                        break;
+                    }
+                    message.sounds.push(reader.string());
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    }
+    MovementAnimation.decode = decode;
+})(MovementAnimation = exports.MovementAnimation || (exports.MovementAnimation = {}));

package/dist-cjs/components/generated/pb/decentraland/sdk/components/avatar_movement_info.gen.d.ts

@@ -22,6 +22,32 @@ export interface PBAvatarMovementInfo {
     walkTarget?: Vector3 | undefined;
     /** stop distance for walk_target; considered reached when within this distance */
     walkThreshold?: number | undefined;
+    /** current state of a scene-driven movement animation. Absent when the engine is using its velocity-based fallback. `playback_time` freezes while a triggerSceneEmote is overriding the animation. */
+    activeAnimationState?: AvatarAnimationState | undefined;
+}
+/**
+ * Mirror of the scene-driven movement animation currently playing, reported by the engine.
+ * Readable by any scene (not just the controller) so niche effects (e.g. dust cloud on landing) can react.
+ * Active emotes are not represented here — scenes already have their own way to read them.
+ */
+/**
+ * @public
+ */
+export interface AvatarAnimationState {
+    /** same scene-relative path the controlling scene supplied */
+    src: string;
+    /** mirrors the request */
+    loop: boolean;
+    /** mirrors the request */
+    speed: number;
+    /** mirrors the request */
+    idle: boolean;
+    /** seconds into the clip; wraps on loop; frozen while an emote override is playing */
+    playbackTime: number;
+    /** total clip length in seconds */
+    duration: number;
+    /** how many times the clip has completed since it started */
+    loopCount: number;
 }
 /**
  * @public
@@ -30,3 +56,10 @@ export declare namespace PBAvatarMovementInfo {
     function encode(message: PBAvatarMovementInfo, writer?: _m0.Writer): _m0.Writer;
     function decode(input: _m0.Reader | Uint8Array, length?: number): PBAvatarMovementInfo;
 }
+/**
+ * @public
+ */
+export declare namespace AvatarAnimationState {
+    function encode(message: AvatarAnimationState, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): AvatarAnimationState;
+}

package/dist-cjs/components/generated/pb/decentraland/sdk/components/avatar_movement_info.gen.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PBAvatarMovementInfo = void 0;
+exports.AvatarAnimationState = exports.PBAvatarMovementInfo = void 0;
 /* eslint-disable */
 const minimal_1 = __importDefault(require("protobufjs/minimal"));
 const vectors_gen_1 = require("../../common/vectors.gen");
@@ -21,6 +21,7 @@ function createBasePBAvatarMovementInfo() {
         activeInputModifier: undefined,
         walkTarget: undefined,
         walkThreshold: undefined,
+        activeAnimationState: undefined,
     };
 }
 /**
@@ -56,6 +57,9 @@ var PBAvatarMovementInfo;
         if (message.walkThreshold !== undefined) {
             writer.uint32(77).float(message.walkThreshold);
         }
+        if (message.activeAnimationState !== undefined) {
+            AvatarAnimationState.encode(message.activeAnimationState, writer.uint32(82).fork()).ldelim();
+        }
         return writer;
     }
     PBAvatarMovementInfo.encode = encode;
@@ -120,6 +124,12 @@ var PBAvatarMovementInfo;
                     }
                     message.walkThreshold = reader.float();
                     continue;
+                case 10:
+                    if (tag !== 82) {
+                        break;
+                    }
+                    message.activeAnimationState = AvatarAnimationState.decode(reader, reader.uint32());
+                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -130,3 +140,95 @@ var PBAvatarMovementInfo;
     }
     PBAvatarMovementInfo.decode = decode;
 })(PBAvatarMovementInfo = exports.PBAvatarMovementInfo || (exports.PBAvatarMovementInfo = {}));
+function createBaseAvatarAnimationState() {
+    return { src: "", loop: false, speed: 0, idle: false, playbackTime: 0, duration: 0, loopCount: 0 };
+}
+/**
+ * @public
+ */
+var AvatarAnimationState;
+(function (AvatarAnimationState) {
+    function encode(message, writer = minimal_1.default.Writer.create()) {
+        if (message.src !== "") {
+            writer.uint32(10).string(message.src);
+        }
+        if (message.loop === true) {
+            writer.uint32(16).bool(message.loop);
+        }
+        if (message.speed !== 0) {
+            writer.uint32(29).float(message.speed);
+        }
+        if (message.idle === true) {
+            writer.uint32(32).bool(message.idle);
+        }
+        if (message.playbackTime !== 0) {
+            writer.uint32(45).float(message.playbackTime);
+        }
+        if (message.duration !== 0) {
+            writer.uint32(53).float(message.duration);
+        }
+        if (message.loopCount !== 0) {
+            writer.uint32(56).uint32(message.loopCount);
+        }
+        return writer;
+    }
+    AvatarAnimationState.encode = encode;
+    function decode(input, length) {
+        const reader = input instanceof minimal_1.default.Reader ? input : minimal_1.default.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseAvatarAnimationState();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.src = reader.string();
+                    continue;
+                case 2:
+                    if (tag !== 16) {
+                        break;
+                    }
+                    message.loop = reader.bool();
+                    continue;
+                case 3:
+                    if (tag !== 29) {
+                        break;
+                    }
+                    message.speed = reader.float();
+                    continue;
+                case 4:
+                    if (tag !== 32) {
+                        break;
+                    }
+                    message.idle = reader.bool();
+                    continue;
+                case 5:
+                    if (tag !== 45) {
+                        break;
+                    }
+                    message.playbackTime = reader.float();
+                    continue;
+                case 6:
+                    if (tag !== 53) {
+                        break;
+                    }
+                    message.duration = reader.float();
+                    continue;
+                case 7:
+                    if (tag !== 56) {
+                        break;
+                    }
+                    message.loopCount = reader.uint32();
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    }
+    AvatarAnimationState.decode = decode;
+})(AvatarAnimationState = exports.AvatarAnimationState || (exports.AvatarAnimationState = {}));

package/dist-cjs/components/generated/pb/decentraland/sdk/components/ui_canvas_information.gen.d.ts

@@ -19,6 +19,14 @@ export interface PBUiCanvasInformation {
      * on the contrary, if the chat UI is shown, the rect would be smaller.
      */
     interactableArea: BorderRect | undefined;
+    /**
+     * informs the sdk about the screen inset area (safe margins). these are the
+     * insets from each edge of the screen that are reserved by the device or
+     * platform UI (for example: the notch, status bar, home indicator, or rounded
+     * corners on mobile). scenes should avoid placing critical UI within these
+     * insets to ensure it is not occluded. on desktop this is typically (0, 0, 0, 0).
+     */
+    screenInsetArea?: BorderRect | undefined;
 }
 /**
  * @public

package/dist-cjs/components/generated/pb/decentraland/sdk/components/ui_canvas_information.gen.js

@@ -9,7 +9,7 @@ const minimal_1 = __importDefault(require("protobufjs/minimal"));
 const border_rect_gen_1 = require("../../common/border_rect.gen");
 const protobufPackageSarasa = "decentraland.sdk.components";
 function createBasePBUiCanvasInformation() {
-    return { devicePixelRatio: 0, width: 0, height: 0, interactableArea: undefined };
+    return { devicePixelRatio: 0, width: 0, height: 0, interactableArea: undefined, screenInsetArea: undefined };
 }
 /**
  * @public
@@ -29,6 +29,9 @@ var PBUiCanvasInformation;
         if (message.interactableArea !== undefined) {
             border_rect_gen_1.BorderRect.encode(message.interactableArea, writer.uint32(34).fork()).ldelim();
         }
+        if (message.screenInsetArea !== undefined) {
+            border_rect_gen_1.BorderRect.encode(message.screenInsetArea, writer.uint32(42).fork()).ldelim();
+        }
         return writer;
     }
     PBUiCanvasInformation.encode = encode;
@@ -63,6 +66,12 @@ var PBUiCanvasInformation;
                     }
                     message.interactableArea = border_rect_gen_1.BorderRect.decode(reader, reader.uint32());
                     continue;
+                case 5:
+                    if (tag !== 42) {
+                        break;
+                    }
+                    message.screenInsetArea = border_rect_gen_1.BorderRect.decode(reader, reader.uint32());
+                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dcl/ecs",
   "description": "Decentraland ECS",
-  "version": "7.24.5-29247185020.commit-e92dfe6",
+  "version": "7.24.5-29255693632.commit-d9d75fe",
   "author": "DCL",
   "bugs": "https://github.com/decentraland/ecs/issues",
   "files": [
@@ -33,5 +33,5 @@
   },
   "types": "./dist/index.d.ts",
   "typings": "./dist/index.d.ts",
-  "commit": "e92dfe6298e3d808e58add843780cdbe7eb5af7d"
+  "commit": "d9d75fe5892b7e38bc96149865c34c4ab8a0f96d"
 }