@dcl/protocol 1.0.0-3482040729.commit-4f0f6b5 → 1.0.0-34875307214.commit-1ca8fa7

package/proto/decentraland/sdk/components/pointer_events_result.proto

@@ -4,22 +4,16 @@ package decentraland.sdk.components;
 
 import "decentraland/sdk/components/common/id.proto";
 import "decentraland/sdk/components/common/input_action.proto";
-import "decentraland/sdk/components/pointer_hover_feedback.proto";
-import "decentraland/sdk/components/raycast_result.proto";
+import "decentraland/sdk/components/common/raycast_hit.proto";
 
 option (common.ecs_component_id) = 1063;
 
-// the renderer will set this component to the root entity once per frame with all the events
+// renderer append a new object of this in each command, there can be many commands per frames
 message PBPointerEventsResult {
-  // a list of the last N pointer commands (from the engine)
-  repeated PointerCommand commands = 1;
-
-  // this message represents a pointer event, used both for UP and DOWN actions
-  message PointerCommand {
-    common.InputAction button = 1; // identifier of the input
-    RaycastHit hit = 2;
-    PointerEventType state = 4;
-    int32 timestamp = 5; // could be a Lamport timestamp
-    optional float analog = 6; // if the input is analog then we store it here
-  }
+  common.InputAction button = 1; // identifier of the input
+  common.RaycastHit hit = 2;
+  common.PointerEventType state = 4;
+  uint32 timestamp = 5;          // monotonic counter
+  optional float analog = 6;     // if the input is analog then we store it here
+  uint32 tick_number = 7;        // number of tick in which the event was produced, equals to EngineInfo.tick_number
 }

package/proto/decentraland/sdk/components/pointer_lock.proto

@@ -4,6 +4,8 @@ package decentraland.sdk.components;
 import "decentraland/sdk/components/common/id.proto";
 option (common.ecs_component_id) = 1074;
 
+// PointerLock indicates whether the mouse pointer is automatically following the camera’s point of
+// focus (locked), or can move freely on the screen (unlocked).
 message PBPointerLock {
-  bool is_pointer_locked = 1;
+  bool is_pointer_locked = 1; // whether the pointer is locked
 }

package/proto/decentraland/sdk/components/primary_pointer_info.proto

@@ -0,0 +1,44 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/common/vectors.proto";
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1209;
+
+// The PBPrimaryPointerInfo component provides information about the current state of the primary 
+// pointer input device (mouse, touch, gamepad, or VR controller). It tracks the pointer's position,
+// movement, and interaction capabilities in both 2D screen space and 3D world space.
+//
+// This component is essential for:
+// - Tracking cursor/pointer position and movement
+// - Converting 2D screen coordinates to 3D world space interactions
+// - Supporting multiple input methods (mouse, touch, gamepad, VR)
+// - Enabling ray-based interactions for 3D object selection
+//
+// The component can be used to:
+// - Implement drag-and-drop functionality
+// - Handle touch interactions on mobile devices
+// - Support gamepad navigation
+// - Enable VR controller interactions
+// - Convert screen coordinates to world space rays for 3D interactions
+//
+// Note: Touch, Pad, and Wand support, as well as dragging, will be added later.
+message PBPrimaryPointerInfo {
+  optional PointerType pointer_type = 1;  // The type of input device being used
+  optional decentraland.common.Vector2 screen_coordinates = 2;  // Current position in screen space (pixels)
+  optional decentraland.common.Vector2 screen_delta = 3;  // Movement since last frame (pixels)
+  // ray direction that can be used with the primary camera origin for
+  // raycasting from the cursor into the world
+  optional decentraland.common.Vector3 world_ray_direction = 4; // Direction vector for 3D ray casting
+}
+
+// PointerType enumerates the different input devices that can be used for pointer interactions.
+// Each type has specific characteristics and use cases in the virtual world.
+enum PointerType {
+  POT_NONE = 0;   // No pointer input
+  POT_MOUSE = 1;  // Traditional mouse input
+  POT_PAD = 2;
+  POT_TOUCH = 3;
+  POT_WAND = 4;
+}

package/proto/decentraland/sdk/components/raycast.proto

@@ -7,15 +7,65 @@ import "decentraland/sdk/components/common/id.proto";
 
 option (common.ecs_component_id) = 1067;
 
+// The PBRaycast component and PBRaycastResult are defined in https://adr.decentraland.org/adr/ADR-200
+//
+// The Raycast component allows scenes to request raycasting from the game engine. The results will
+// be available in a RaycastResult component set later on the same Entity.
+message PBRaycast {
+  // Correlation ID, defined by the scene and used internally by the scene
+  optional uint32 timestamp = 1;
+
+  // How much to offset the starting point of the ray, relative to the entity's transform.
+  // Defaults to vec3(0,0,0)
+  optional decentraland.common.Vector3 origin_offset = 2;
+
+  oneof direction {
+    // The direction of the ray in local coordinates (relative to the origin point)
+    decentraland.common.Vector3 local_direction = 6;
+
+    // The direction of the ray in global coordinates (relative to origin)
+    decentraland.common.Vector3 global_direction = 3;
+
+    // Target coordinates of the raycast, in global coordinates
+    decentraland.common.Vector3 global_target = 7;
+
+    // Will point to the final world position of another entity
+    uint32 target_entity = 10;
+  }
+
+  // Maximum length of the ray in virtual meters (global space)
+  float max_distance = 4;
+
+  // the RaycastQueryType behavior
+  RaycastQueryType query_type = 5;
+
+  // Indicates the renderer to perform the raycast on every scene tick (ADR-148),
+  // otherwise it will be performed only once, defaults to false
+  optional bool continuous = 8;
+
+  // Collision mask, by default CL_POINTER | CL_PHYSICS
+  optional uint32 collision_mask = 9;
+
+  // shape to cast, default ray
+  optional RaycastShape shape = 11; 
+
+  // include hits with entities from other scenes
+  optional bool include_world = 12; 
+}
+
+// RaycastQueryType indicates whether the ray should stop on the first collition, or continue.
 enum RaycastQueryType {
+  // Pick the first (not necessarily the closest) hit within the range
   RQT_HIT_FIRST = 0;
+  // Pick all hits within the range
   RQT_QUERY_ALL = 1;
+  // Do not perform the raycast, only set the raycast result with empty hits
+  RQT_NONE = 2;
 }
 
-message PBRaycast {
-  int32 timestamp = 1;
-  decentraland.common.Vector3 origin = 2;
-  decentraland.common.Vector3 direction = 3;
-  float max_distance = 4;
-  RaycastQueryType query_type = 5;
-}
+enum RaycastShape {
+  // cast a point, get collisions along a ray
+  RS_RAY = 0;
+  // cast the avatar collider shape, get collisions from sweeping the shape
+  RS_AVATAR = 1;
+}

package/proto/decentraland/sdk/components/raycast_result.proto

@@ -1,25 +1,21 @@
 syntax = "proto3";
 package decentraland.sdk.components;
 
-import "decentraland/sdk/components/common/id.proto";
 import "decentraland/common/vectors.proto";
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/sdk/components/common/raycast_hit.proto";
 
 option (common.ecs_component_id) = 1068;
 
+// The PBRaycast component and PBRaycastResult are defined in https://adr.decentraland.org/adr/ADR-200
+//
+// The RaycastResult component is added to an Entity when the results of a previously attached
+// Raycast component are available. It contains information about the ray and any objects it
+// collided with.
 message PBRaycastResult {
-  int32 timestamp = 1;
-  decentraland.common.Vector3 origin = 2;
-  decentraland.common.Vector3 direction = 3;
-  repeated RaycastHit hits = 4;
+  optional uint32 timestamp = 1;                 // timestamp is a correlation id, copied from the PBRaycast
+  decentraland.common.Vector3 global_origin = 2; // the starting point of the ray in global coordinates
+  decentraland.common.Vector3 direction = 3;     // the direction vector of the ray in global coordinates
+  repeated decentraland.sdk.components.common.RaycastHit hits = 4; // zero or more hits
+  uint32 tick_number = 5;                        // number of tick in which the event was produced, equals to EngineInfo.tick_number
 }
-
-// Position will be relative to the scene  
-message RaycastHit {
-  decentraland.common.Vector3 position = 1;
-  decentraland.common.Vector3 origin = 2;
-  decentraland.common.Vector3 direction = 3;
-  decentraland.common.Vector3 normal_hit = 4;
-  float length = 5;
-  optional string mesh_name = 6;
-  optional int64 entity_id = 7;
-}

package/proto/decentraland/sdk/components/realm_info.proto

@@ -0,0 +1,15 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1106;
+
+message PBRealmInfo {
+  string base_url = 1;                        // the domain of the realm server
+  string realm_name = 2;                      // the name of the realm server (more info https://adr.decentraland.org/adr/ADR-110)
+  int32 network_id = 3;                       // the network id (1=Ethereum, more info https://chainlist.org/)
+  string comms_adapter = 4;                   // comms adapter (more info https://adr.decentraland.org/adr/ADR-180)
+  bool is_preview = 5;                        // true if the scene is running as a local preview, instead of published in Decentraland.
+  optional string room = 6;                   // the room session id.
+  optional bool is_connected_scene_room = 7;  // true if the user is connected to the scene room.
+}

package/proto/decentraland/sdk/components/skybox_time.proto

@@ -0,0 +1,20 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1210;
+
+// The SkyboxTime component allows controlling the time of day for the skybox,
+// affecting the lighting and appearance of the sky in the scene.
+message PBSkyboxTime {
+  uint32 fixed_time = 1;  // fixed time of day, represented as a number of seconds since the start of the day, where 0 is 00:00hs, 43200 is 12:00hs and 86400 is 24:00hs
+  optional TransitionMode transition_mode = 2;  // default = TransitionMode.TM_FORWARD, controls the direction of time transitions
+}
+
+// Controls the direction for animated skybox transitions
+enum TransitionMode {
+  TM_FORWARD = 0;   // transitions forward (default)
+  TM_BACKWARD = 1;  // transitions backward
+}

package/proto/decentraland/sdk/components/text_shape.proto

@@ -8,26 +8,39 @@ import "decentraland/sdk/components/common/texts.proto";
 
 option (common.ecs_component_id) = 1030;
 
+// The TextShape component renders customizable floating text.
+//
+// The position and rotation of the text are defined by the Entity's Transform, while its size
+// can either scale with the Transform or be fixed by a font size.
+//
+// Several options can be configured, including color, padding, line spacing and drop shadows.
 message PBTextShape {
-  string text = 1;
-  optional common.Font font = 2; // default=F_SANS_SERIF
-  optional float font_size = 3; // default=10
-  optional bool font_auto_size = 4;
-  optional common.TextAlignMode text_align = 5; // default=TAM_CENTER_CENTER
-  optional float width = 6; // default=1
-  optional float height = 7; // default=1
-  optional float padding_top = 8;
-  optional float padding_right = 9;
-  optional float padding_bottom = 10;
-  optional float padding_left = 11;
-  optional float line_spacing = 12;
-  optional int32 line_count = 13;
-  optional bool text_wrapping = 14;
-  optional float shadow_blur = 15;
-  optional float shadow_offset_x = 16;
-  optional float shadow_offset_y = 17;
-  optional float outline_width = 18;
-  optional decentraland.common.Color3 shadow_color = 19; // default=(1.0,1.0,1.0)
-  optional decentraland.common.Color3 outline_color = 20; // default=(1.0,1.0,1.0)
-  optional decentraland.common.Color4 text_color = 21; // default=(1.0,1.0,1.0)
+  string text = 1; // the content
+
+  optional common.Font font = 2;    // the font (default F_SANS_SERIF)
+  optional float font_size = 3;     // the font size (default 10)
+  optional bool font_auto_size = 4; // override `font_size` to automatically fit in `width`/`height`
+  
+  optional common.TextAlignMode text_align = 5; // X and Y alignment (default TAM_CENTER_CENTER)
+
+  optional float width = 6;           // available horizontal space (default 1)
+  optional float height = 7;          // available vertical space (default 1)
+  optional float padding_top = 8;     // distance from text to top border (default 0)
+  optional float padding_right = 9;   // distance from text to right border (default 0)
+  optional float padding_bottom = 10; // distance from text to bottom border (default 0)
+  optional float padding_left = 11;   // distance from text to left border (default 0)
+  
+  optional float line_spacing = 12; // extra distance between lines (default 0)
+  optional int32 line_count = 13;   // maximum number of lines to display
+  optional bool text_wrapping = 14; // wrap text when the border is reached (default false)
+
+  optional float shadow_blur = 15;     // blurriness of the drop shadow (default 0)
+  optional float shadow_offset_x = 16; // horizontal length of the shadow (default 0)
+  optional float shadow_offset_y = 17; // vertical length of the shadow (default 0)
+  optional float outline_width = 18;   // width of the stroke outlining each letter (default 0)
+
+  optional decentraland.common.Color3 shadow_color = 19;  // drop shadow color (default [1.0, 1.0, 1.0])
+  optional decentraland.common.Color3 outline_color = 20; // outline stroke color (default [1.0, 1.0, 1.0])
+  optional decentraland.common.Color4 text_color = 21;    // text color (default [1.0, 1.0, 1.0])
+  optional string font_src = 22;    // a font file in the scene, or a Google Fonts family name; `font` is the fallback (default: unset)
 }

package/proto/decentraland/sdk/components/texture_camera.proto

@@ -0,0 +1,46 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/common/colors.proto";
+
+option (common.ecs_component_id) = 1207;
+
+message PBTextureCamera {
+    // rendered texture width
+    optional uint32 width = 1;
+    // rendered texture height
+    optional uint32 height = 2;
+    // which layer of entities to render. entity layers can be specified by adding PBCameraLayers to target entities.
+    // defaults to 0
+    optional uint32 layer = 3;
+
+    // default black
+    optional decentraland.common.Color4 clear_color = 6;
+    // default infinity
+    optional float far_plane = 7;
+
+    oneof mode {
+        Perspective perspective = 8;
+        Orthographic orthographic = 9;
+        /* Portal portal = 10; */ 
+    };
+
+    // controls whether this camera acts as a receiver for audio on sources with matching `PBCameraLayers`.
+    // range: 0 (off) - 1 (full volume)
+    // default: 0
+    optional float volume = 10;
+}
+
+message Perspective {
+    // vertical field of view in radians
+    // defaults to pi/4 = 45 degrees
+    optional float field_of_view = 1;
+}
+
+message Orthographic {
+    // vertical extent of the visible range in meters
+    // defaults to 4m
+    optional float vertical_range = 1;
+}

package/proto/decentraland/sdk/components/touch_screen_controls.proto

@@ -0,0 +1,38 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/sdk/components/common/input_action.proto";
+import "decentraland/common/texture.proto";
+option (common.ecs_component_id) = 1218;
+
+// The TouchScreenControls component lets a scene configure the native on-screen touch
+// controls (the mobile joystick + gamepad). It must be set on the RootEntity.
+//
+// By default every on-screen button is shown; list a button in `touch_inputs` with
+// `hide = true` to remove it (declutter). `main_action` picks which action the large
+// central button triggers, and `hide_joystick` removes the native virtual joystick. It is
+// a no-op on platforms without native on-screen controls (e.g. desktop).
+//
+// Accepted actions: only the on-screen gamepad actions map to a button — `IA_POINTER`,
+// `IA_PRIMARY`, `IA_SECONDARY`, `IA_JUMP`, and `IA_ACTION_3`..`IA_ACTION_6`. Any other
+// `InputAction` (movement actions, `IA_ANY`, `IA_MODIFIER`, or unknown/future values) is
+// ignored: a `TouchInput` entry naming a non-button action has no effect, and a `main_action`
+// that isn't a valid gamepad action falls back to the default central button (`IA_JUMP`).
+message PBTouchScreenControls {
+    // Per-button configuration. A button not listed here keeps its default (shown).
+    message TouchInput {
+        common.InputAction input_action = 1; // which on-screen button this configures
+        bool hide = 2;                        // hide this button (default: shown)
+        // Override the button glyph with this texture. For the jump button it replaces all
+        // of its dynamic states (jump / double-jump / glide).
+        optional decentraland.common.TextureUnion icon = 3;
+    }
+
+    repeated TouchInput touch_inputs = 1;
+    // The large central button's action. Only the gamepad actions are valid:
+    // jump / pointer / primary (E) / secondary (F) / action_3..action_6 (1/2/3/4).
+    // When unset, the default central button (jump) is kept.
+    optional common.InputAction main_action = 2;
+    bool hide_joystick = 3; // hide the native virtual joystick
+    bool hide_crosshair = 4; // hide the on-screen crosshair / reticle
+}

package/proto/decentraland/sdk/components/trigger_area.proto

@@ -0,0 +1,23 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1060;
+
+// The PBTriggerArea component is used to raise collision triggering events (through the TriggerAreaResult component)
+// when entities enter this component's defined area.
+//
+// ADR: https://github.com/decentraland/adr/blob/2b30a5e2b4f359a7c22a68fb827db282f6e5f887/content/ADR-258-trigger-areas.md
+//
+// The area size and rotation is defined by the Entity's Transform.
+message PBTriggerArea {
+  optional TriggerAreaMeshType mesh = 1;         // default: MT_BOX
+  optional uint32 collision_mask = 2; // default: CL_PLAYER
+}
+
+enum TriggerAreaMeshType {
+  TAMT_BOX = 0;
+  TAMT_SPHERE = 1;
+}

package/proto/decentraland/sdk/components/trigger_area_result.proto

@@ -0,0 +1,34 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/common/vectors.proto";
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1061;
+
+// The PBTriggerAreaResult component is used to transport the trigger collision event data for the PBTriggerArea component.
+// ADR: https://github.com/decentraland/adr/blob/2b30a5e2b4f359a7c22a68fb827db282f6e5f887/content/ADR-258-trigger-areas.md
+message PBTriggerAreaResult {
+  // Trigger data object
+  message Trigger {
+    uint32 entity = 1;                                          // The entity that triggered the Trigger Area
+    uint32 layers = 2;                                          // The collision layermask of the entity that triggered the Trigger Area
+    decentraland.common.Vector3 position = 3;                   // The position of the entity that triggered the trigger
+    decentraland.common.Quaternion rotation = 4;                // The rotation of the entity that triggered the trigger
+    decentraland.common.Vector3 scale = 5;                      // The scale of the entity that triggered the trigger
+  }
+  
+  uint32 triggered_entity = 1;                                  // The entity that was triggered (this is the entity that owns the trigger area)
+  decentraland.common.Vector3 triggered_entity_position = 2;    // The position of the triggered entity at the time of the trigger
+  decentraland.common.Quaternion triggered_entity_rotation = 3; // The rotation of the triggered entity at the time of the trigger
+  TriggerAreaEventType event_type = 4;                          // The state of the trigger event (ENTER, STAY, EXIT)
+  uint32 timestamp = 5;                                         // The timestamp of the trigger event
+  Trigger trigger = 6;
+}
+
+enum TriggerAreaEventType {
+  TAET_ENTER = 0;
+  TAET_STAY = 1;
+  TAET_EXIT = 2;
+}

package/proto/decentraland/sdk/components/tween.proto

@@ -0,0 +1,117 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/common/vectors.proto";
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1102;
+
+message PBTween {
+  float duration = 1; // in milliseconds
+  EasingFunction easing_function = 2;
+
+  oneof mode {
+    Move move = 3;
+    Rotate rotate = 4;
+    Scale scale = 5;
+    TextureMove texture_move = 8;
+    RotateContinuous rotate_continuous = 9;
+    MoveContinuous move_continuous = 10;
+    TextureMoveContinuous texture_move_continuous = 11;
+    MoveRotateScale move_rotate_scale = 12;
+  }
+
+  optional bool playing = 6; // default true (pause or running)
+  optional float current_time = 7; // between 0 and 1
+}
+
+message Move {
+  decentraland.common.Vector3 start = 1;
+  decentraland.common.Vector3 end = 2;
+  optional bool face_direction = 3;
+}
+
+message Rotate {
+  decentraland.common.Quaternion start = 1;
+  decentraland.common.Quaternion end = 2;
+}
+
+message Scale {
+  decentraland.common.Vector3 start = 1;
+  decentraland.common.Vector3 end = 2;
+}
+
+message MoveRotateScale {
+  decentraland.common.Vector3 position_start = 1;
+  decentraland.common.Vector3 position_end = 2;
+  decentraland.common.Quaternion rotation_start = 3;
+  decentraland.common.Quaternion rotation_end = 4;
+  decentraland.common.Vector3 scale_start = 5;
+  decentraland.common.Vector3 scale_end = 6;
+}
+
+// This tween mode allows to move the texture of a PbrMaterial or UnlitMaterial.
+// You can also specify the movement type (offset or tiling)
+message TextureMove {
+  decentraland.common.Vector2 start = 1;
+  decentraland.common.Vector2 end = 2;
+  optional TextureMovementType movement_type = 3; // default = TextureMovementType.TMT_OFFSET
+}
+
+message RotateContinuous {
+  decentraland.common.Quaternion direction = 1;
+  float speed = 2;
+}
+
+message MoveContinuous {
+  decentraland.common.Vector3 direction = 1;
+  float speed = 2;
+}
+
+message TextureMoveContinuous {
+  decentraland.common.Vector2 direction = 1;
+  float speed = 2;
+  optional TextureMovementType movement_type = 3; // default = TextureMovementType.TMT_OFFSET
+}
+
+enum TextureMovementType {
+  TMT_OFFSET = 0; // default = TextureMovementType.TMT_OFFSET
+  TMT_TILING = 1;
+}
+
+// Implementation guidelines for these easing functions can be found
+// at https://github.com/ai/easings.net/blob/6fcd5f852a470bf1a7890e8178afa0f471d5f2ec/src/easings/easingsFunctions.ts
+enum EasingFunction {
+  EF_LINEAR = 0; // default
+  EF_EASEINQUAD = 1;
+  EF_EASEOUTQUAD = 2;
+  EF_EASEQUAD = 3;
+  EF_EASEINSINE = 4;
+  EF_EASEOUTSINE = 5;
+  EF_EASESINE = 6;
+  EF_EASEINEXPO = 7;
+  EF_EASEOUTEXPO = 8;
+  EF_EASEEXPO = 9;
+  EF_EASEINELASTIC = 10;
+  EF_EASEOUTELASTIC = 11;
+  EF_EASEELASTIC = 12;
+  EF_EASEINBOUNCE = 13;
+  EF_EASEOUTBOUNCE = 14;
+  EF_EASEBOUNCE = 15;
+  EF_EASEINCUBIC = 16;
+  EF_EASEOUTCUBIC = 17;
+  EF_EASECUBIC = 18;
+  EF_EASEINQUART = 19;
+  EF_EASEOUTQUART = 20;
+  EF_EASEQUART = 21;
+  EF_EASEINQUINT = 22;
+  EF_EASEOUTQUINT = 23;
+  EF_EASEQUINT = 24;
+  EF_EASEINCIRC = 25;
+  EF_EASEOUTCIRC = 26;
+  EF_EASECIRC = 27;
+  EF_EASEINBACK = 28;
+  EF_EASEOUTBACK = 29;
+  EF_EASEBACK = 30;
+}

package/proto/decentraland/sdk/components/tween_sequence.proto

@@ -0,0 +1,18 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/sdk/components/tween.proto";
+
+option (common.ecs_component_id) = 1104;
+
+message PBTweenSequence {
+  repeated PBTween sequence = 1;
+  optional TweenLoop loop = 2;
+}
+
+enum TweenLoop {
+  TL_RESTART = 0;
+  TL_YOYO = 1;
+}

package/proto/decentraland/sdk/components/tween_state.proto

@@ -0,0 +1,18 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1103;
+
+message PBTweenState {
+  TweenStateStatus state = 1;
+  float current_time = 2; // between 0 and 1
+}
+
+enum TweenStateStatus {
+  TS_ACTIVE = 0;
+  TS_COMPLETED = 1;
+  TS_PAUSED= 2;
+}

package/proto/decentraland/sdk/components/ui_background.proto

@@ -5,7 +5,30 @@ import "decentraland/sdk/components/common/id.proto";
 option (common.ecs_component_id) = 1053;
 
 import "decentraland/common/colors.proto";
+import "decentraland/common/texture.proto";
+import "decentraland/common/border_rect.proto";
 
 message PBUiBackground {
-  optional decentraland.common.Color4 background_color = 1; // default=(0.0, 0.0, 0.0, 0.0)
-}
+  optional decentraland.common.Color4 color = 1; // default=(1.0, 1.0, 1.0, 1.0), pixel = color * sample2D(texture, uv)
+  optional decentraland.common.TextureUnion texture = 2;
+  BackgroundTextureMode texture_mode = 3;
+  optional decentraland.common.BorderRect texture_slices = 4; // default=(1/3, 1/3, 1/3, 1/3)
+  repeated float uvs = 5; // default=[0,0,0,1,1,0,1,0]: starting from bottom-left vertex clock-wise
+}
+
+enum BackgroundTextureMode {
+  // https://docs.unity3d.com/Manual/UIE-USS-SupportedProperties.html (Slicing section)
+  // https://forum.unity.com/threads/how-does-slicing-in-ui-tookkit-works.1235863/
+  // https://docs.unity3d.com/Manual/9SliceSprites.html
+  // https://developer.mozilla.org/en-US/docs/Web/CSS/border-image-slice
+  NINE_SLICES = 0;
+
+  // CENTER enables the texture to be rendered centered in relation to the
+  // element. If the element is smaller than the texture then the background
+  // should use the element as stencil to cut off the out-of-bounds area
+  CENTER = 1;
+
+  // STRETCH enables the texture to cover all the area of the container,
+  // adopting its aspect ratio.
+  STRETCH = 2;
+}

package/proto/decentraland/sdk/components/ui_canvas.proto

@@ -0,0 +1,16 @@
+syntax = "proto3";
+
+import "decentraland/sdk/components/common/id.proto";
+package decentraland.sdk.components;
+
+option (common.ecs_component_id) = 1203;
+
+import "decentraland/common/colors.proto";
+
+// The UiCanvas component can be attached to a ui root entity to specify properties of the ui texture.
+message PBUiCanvas {
+  uint32 width = 1;
+  uint32 height = 2;
+
+  optional decentraland.common.Color4 color = 3; // default = (0.0, 0.0, 0.0, 0.0) / transparent
+}