@dcl/protocol 1.0.0-3583035976.commit-35d616d → 1.0.0-35899496093.commit-329ba0e

package/proto/decentraland/sdk/components/avatar_modifier_area.proto

@@ -7,13 +7,28 @@ import "decentraland/sdk/components/common/id.proto";
 
 option (common.ecs_component_id) = 1070;
 
-enum AvatarModifierType {
-  AMT_HIDE_AVATARS = 0;
-  AMT_DISABLE_PASSPORTS = 1;
+// The AvatarModifierArea component can be attached to an Entity to define a region of space where 
+// avatar behavior changes.
+//
+// The Entity's Transform position determines the center-point of the region, while its size is 
+// given as a vector in the `area` property below. The Transform rotation is applied, but the scale 
+// is ignored.
+//
+// The modifier effect is only applied to avatars inside the region. It does not affect how players 
+// standing inside it see avatars on the other side of the boundary.
+//
+// Note that, while commonly used to delineate a 2D area in a scene (hence the name), the region
+// is actually a 3D volume.
+message PBAvatarModifierArea {
+  decentraland.common.Vector3 area = 1;      // the 3D size of the region
+  repeated string exclude_ids = 2;           // user IDs that can enter and remain unaffected
+  repeated AvatarModifierType modifiers = 3; // list of modifiers to apply
+  optional bool use_collider_range = 5;      // if true, the player will be considered inside the area when they are within 0.3m of the area. default true
 }
 
-message PBAvatarModifierArea {
-  decentraland.common.Vector3 area = 1;
-  repeated string exclude_ids = 2;
-  repeated AvatarModifierType modifiers = 3;
+// AvatarModifierType is an effect that should be applied to avatars inside the region.
+enum AvatarModifierType {
+  AMT_HIDE_AVATARS = 0;      // avatars are invisible
+  AMT_DISABLE_PASSPORTS = 1; // selecting (e.g. clicking) an avatar will not bring up their profile.
+  AMT_HIDE_NAMETAGS = 2;     // the name tag displayed above an avatar is hidden.
 }

package/proto/decentraland/sdk/components/avatar_movement.proto

@@ -0,0 +1,62 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/common/vectors.proto";
+
+option (common.ecs_component_id) = 1501;
+
+message PBAvatarMovement {
+  decentraland.common.Vector3 velocity = 1;
+  float orientation = 2;                                    // 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.
+  optional decentraland.common.Vector3 ground_direction = 3;
+  optional bool walk_success = 4;                           // set for one frame when a walk_target ends: true = reached target, false = failed; absent = in progress or no walk
+  optional MovementAnimation animation = 5;                 // if set, the engine plays this animation instead of selecting one from velocity heuristics
+  optional float tilt_pitch = 6;                            // 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.
+  optional float tilt_roll = 7;                             // 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.
+}
+
+// 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).
+message MovementAnimation {
+  string src = 1;                                           // scene-relative path to the gltf/glb asset (resolved via the scene content map)
+  bool loop = 2;                                            // whether the clip repeats once it reaches the end
+  float speed = 3;                                          // playback speed multiplier (1.0 = clip's native rate)
+  bool idle = 4;                                            // true: a triggerSceneEmote may take over; false: emotes are suppressed while this animation plays
+  optional float transition_seconds = 5;                    // cross-fade duration when `src` changes; defaults to 0.2 when unset. Not applied to loop/speed/idle changes.
+  optional float playback_time = 6;                         // 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.
+  repeated string sounds = 7;                               // 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).
+}
+
+// engine behaviour (uses only capsule shapecasts and GJK closest point for portability):
+// 1: set avatar orientation from movement info -> P1
+// 2: record "ground collider" - nearest collider within threshold distance in ground_direction using avatar collider shapecast
+// 3: update all colliders, record previous transform and new transform.
+// 4: apply ground collider movement: take collider closest point, modify P1 translation and rotation by closest point translation and rotation change -> P2
+// 5: resolve collisions using position-based constraints
+//   initialize constraints to -inf, +inf
+//   repeat
+//       for each collider[i] that collides with the P3+N player:
+//           if closest point = capsule middle (i.e. collider collides with P3 collider but with radius 0), 
+//               ignore / continue
+//           else 
+//               update constraints based on minimum movement to escape collision
+//               e.g. if avatar is 1cm into the floor, constraint_min = max(constraint_min, vec3(0, 0.01, 0))
+//       reposition player to satisfy constraints for each axis:
+//           y: satsify floor before ceiling: new position = max(constraint_min, min(constraint_max, current position))
+//           x and z: if squashed, take average, else satisfy the required constraint
+//           if constraint_min > constraint_max then new position = average(constraint_min, constraint_max) 
+//           else new position = clamp(current position, constraint_min, constraint_max)
+//   while position !~= previous position
+// 6: apply velocity (collide and slide)
+//   disable anything we are initially colliding with
+//   shapecast avatar from position to position + velocity * timestep
+//   on impact:
+//       project velocity onto slide plane (standard "Collide & Slide")
+//       velocity = old velocity - (normal * dot(velocity, normal))
+//       repeat continue with residual velocity and residual time
+// 7: provide AvatarMovementInfo values
+//      actual velocity = (final - P3+N) / timestep
+//      external_velocity = (P3+N - P1) / timestep

package/proto/decentraland/sdk/components/avatar_movement_info.proto

@@ -0,0 +1,36 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/common/vectors.proto";
+import "decentraland/sdk/components/avatar_locomotion_settings.proto";
+import "decentraland/sdk/components/input_modifier.proto";
+
+option (common.ecs_component_id) = 1500;
+
+message PBAvatarMovementInfo {
+  float step_time = 1;                                      // the length of time the current step velocity will apply for
+  float previous_step_time = 2;                             // the length of time the previous step velocity applied for
+  decentraland.common.Vector3 requested_velocity = 3;       // the velocity requested for the previous frame
+  decentraland.common.Vector3 actual_velocity = 4;          // the resulting velocity taking collisions into account
+  decentraland.common.Vector3 external_velocity = 5;        // the velocity imparted by movement of the "ground" platform or pushing from other moving colliders
+  decentraland.sdk.components.PBAvatarLocomotionSettings active_avatar_locomotion_settings = 6;
+  decentraland.sdk.components.PBInputModifier active_input_modifier = 7;
+  optional decentraland.common.Vector3 walk_target = 8;    // if set, the movement scene should walk the player to this scene-relative position
+  optional float walk_threshold = 9;                        // stop distance for walk_target; considered reached when within this distance
+  optional AvatarAnimationState active_animation_state = 10; // 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.
+}
+
+// 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.
+message AvatarAnimationState {
+  string src = 1;                                           // same scene-relative path the controlling scene supplied
+  bool loop = 2;                                            // mirrors the request
+  float speed = 3;                                          // mirrors the request
+  bool idle = 4;                                            // mirrors the request
+  float playback_time = 5;                                  // seconds into the clip; wraps on loop; frozen while an emote override is playing
+  float duration = 6;                                       // total clip length in seconds
+  uint32 loop_count = 7;                                    // how many times the clip has completed since it started
+}

package/proto/decentraland/sdk/components/avatar_nametag.proto

@@ -0,0 +1,33 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/common/colors.proto";
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1221;
+
+// The AvatarNametag component adds a plate with scene-provided text above an avatar's nametag,
+// for example to show a rank or a role that the scene assigns to that player.
+//
+// Valid only on an avatar-bearing entity:
+// - the local player: `engine.PlayerEntity`
+// - another player in the scene: that player's entity
+// - an NPC: any entity with an AvatarShape
+// Writes to any other entity are ignored.
+//
+// Player entity ids are not stable across disconnects: a write to a stale entity lands on
+// whoever holds that id next. Resolve the entity from the user id on every write, and remove
+// the component when the player leaves the scene.
+//
+// The plate is local to the client that renders it; it is never relayed to other players.
+message PBAvatarNametag {
+  // The plate text: a single line, for example "Club Owner". Empty draws the plate without text,
+  // and spaces are preserved: a label of spaces widens a text-less plate. For a plate sized
+  // exactly to a word without showing it, set label_color equal to background_color instead.
+  string label = 1;
+
+  optional decentraland.common.Color3 label_color = 2;      // (default: the client's native nametag text color)
+  optional decentraland.common.Color3 background_color = 3; // (default: the client's native nametag background color)
+  optional decentraland.common.Color3 border_color = 4;     // (default: background_color, so the plate carries no visible border)
+}

package/proto/decentraland/sdk/components/avatar_shape.proto

@@ -5,28 +5,41 @@ import "decentraland/sdk/components/common/id.proto";
 option (common.ecs_component_id) = 1080;
 import "decentraland/common/colors.proto";
 
+// The AvatarShape component contains the information required to draw and animate avatar, acting as
+// a simplified GLTF container for this specific case. 
+//
+// All fields (except ID) are optional have reasonable default values. In the case of `wearables`,
+// each slot on the Avatar's body that is not explicitly included in the list has its own default.
+//
+// Note that, while AvatarShape can be attached to any Entity, it's only actually used in the global 
+// Avatar Scene. Other requirements are usually better served by GLTFs.
 message PBAvatarShape {
-  string id = 1;
-  optional string name = 2; // default = NPC
-  optional string body_shape = 3; // default = urn:decentraland:off-chain:base-avatars:BaseFemale
-  optional decentraland.common.Color3 skin_color = 4; // default = decentraland.common.Color3(R = 0.6f, G = 0.462f, B = 0.356f)
-  optional decentraland.common.Color3 hair_color = 5; // default = decentraland.common.Color3(R = 0.283f, G = 0.142f, B = 0f)
-  optional decentraland.common.Color3 eye_color = 6; // default = decentraland.common.Color3(R = 0.6f, G = 0.462f, B = 0.356f)
-  optional string expression_trigger_id = 7;
-  optional int64 expression_trigger_timestamp = 8; // default = timestamp
-  optional bool talking = 9;
-  /**
-   * default = ["urn:decentraland:off-chain:base-avatars:f_eyes_00", 
-   *  "urn:decentraland:off-chain:base-avatars:f_eyebrows_00",
-   *  "urn:decentraland:off-chain:base-avatars:f_mouth_00" 
-   *  "urn:decentraland:off-chain:base-avatars:standard_hair", 
-   *  "urn:decentraland:off-chain:base-avatars:f_simple_yellow_tshirt", 
-   *  "urn:decentraland:off-chain:base-avatars:f_brown_trousers", 
-   *  "urn:decentraland:off-chain:base-avatars:bun_shoes"]
-   */
-  repeated string wearables = 10;
-  /**
-   * default = []
-   */
-  repeated string emotes = 11;
-}
+  string id = 1;                  // the user ID
+  optional string name = 2;       // visible name (default: "NPC")
+  optional string body_shape = 3; // shape URN (default "urn:decentraland:off-chain:base-avatars:BaseFemale")
+
+  optional decentraland.common.Color3 skin_color = 4; // RGB (default [0.6, 0.462, 0.356])
+  optional decentraland.common.Color3 hair_color = 5; // RGB (default [0.283, 0.142, 0])
+  optional decentraland.common.Color3 eye_color = 6;  // RGB (default [0.6, 0.462, 0.356])
+
+  optional string expression_trigger_id = 7;       // current emote animations
+  optional int64 expression_trigger_timestamp = 8; // start of emote animations (in the same order)
+
+  optional bool talking = 9; // whether to display the floating voice chat icon
+
+  // Wearable URNs, one for each body slot.
+  //   Default values for each unspecified slot:
+  //     Eyes    : "urn:decentraland:off-chain:base-avatars:f_eyes_00", 
+  //     Eyebrows: "urn:decentraland:off-chain:base-avatars:f_eyebrows_00",
+  //     Mouth   : "urn:decentraland:off-chain:base-avatars:f_mouth_00" 
+  //     Hair    : "urn:decentraland:off-chain:base-avatars:standard_hair", 
+  //     Shirt   : "urn:decentraland:off-chain:base-avatars:f_simple_yellow_tshirt", 
+  //     Trousers: "urn:decentraland:off-chain:base-avatars:f_brown_trousers", 
+  //     Shoes   : "urn:decentraland:off-chain:base-avatars:bun_shoes"]
+  repeated string wearables = 10; 
+  repeated string emotes = 11; // available emotes (default empty)
+
+  optional bool show_only_wearables = 12; // hides the skin + hair + facial features (default: false)
+  repeated string force_render = 13; // slots that will render even if hidden
+}
+

package/proto/decentraland/sdk/components/billboard.proto

@@ -4,14 +4,32 @@ package decentraland.sdk.components;
 
 import "decentraland/sdk/components/common/id.proto";
 
+// https://adr.decentraland.org/adr/ADR-198
 option (common.ecs_component_id) = 1090;
 
-enum BillboardMode {
-  BM_ALL_AXES = 0;
-  BM_Y_AXE = 1;
+// The Billboard component makes an Entity automatically reorient its rotation to face a target.
+// By default (when target_entity is unset), the billboard faces the main camera. When target_entity
+// is set, the billboard faces that entity instead. Setting target_entity to the camera reserved
+// entity (2) is equivalent to leaving the field unset. If the referenced target entity doesn’t exist
+// or is deleted, the billboard reorientation is disabled until the target exists again.
+//
+// As the name indicates, it’s used to display in-game billboards and frequently combined with
+// the TextShape component.
+//
+// Billboard only affects the Entity’s rotation. Its scale and position are still determined by its
+// Transform.
+message PBBillboard {
+  optional BillboardMode billboard_mode = 1; // the BillboardMode (default: BM_ALL)
+  optional uint32 target_entity = 2; // entity to face instead of the camera; if the referenced entity doesn’t exist, the billboard behavior is disabled until it does
 }
 
-message PBBillboard {
-  optional BillboardMode billboard_mode = 1; // default=BM_ALL_AXES
-  optional bool opposite_direction = 2; // default=false
+// BillboardMode indicates one or more axis for automatic rotation, in OR-able bit flag form.
+// Only the values below and the (BM_X | BM_Y) combination are valid.
+enum BillboardMode {
+  BM_NONE = 0;
+  BM_X = 1;
+  BM_Y = 2;
+  BM_Z = 4;
+  BM_ALL = 7; // bitwise combination BM_X | BM_Y | BM_Z
 }
+

package/proto/decentraland/sdk/components/camera_layer.proto

@@ -0,0 +1,30 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/common/colors.proto";
+
+option (common.ecs_component_id) = 1503;
+
+message PBCameraLayer {
+    // layer to which these settings apply. must be > 0
+    // Layer 0 is the default "real world" layer viewed by the player and cannot be modified.
+    uint32 layer = 1;
+
+    // should the sun light affect this layer? default false
+    optional bool directional_light = 2;
+
+    // should this layer show player avatars? default false
+    optional bool show_avatars = 3;
+
+    // should this layer show the sky? default false
+    optional bool show_skybox = 4;
+
+    // should this layer show distance fog? default false
+    optional bool show_fog = 5;
+
+    // ambient light overrides for this layer. default -> use same as main camera
+    optional decentraland.common.Color3 ambient_color_override = 6;
+    optional float ambient_brightness_override = 7;
+}

package/proto/decentraland/sdk/components/camera_layers.proto

@@ -0,0 +1,11 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1208;
+
+message PBCameraLayers {
+    repeated uint32 layers = 1;
+}

package/proto/decentraland/sdk/components/camera_mode.proto

@@ -5,6 +5,8 @@ import "decentraland/sdk/components/common/id.proto";
 option (common.ecs_component_id) = 1072;
 import "decentraland/sdk/components/common/camera_type.proto";
 
+// The CameraMode component can be used to determine whether the player is using a first-person o 
+// third-person view.
 message PBCameraMode {
-  common.CameraType mode = 1;
+  common.CameraType mode = 1; // the camera type (1st-person or 3rd-person)
 }

package/proto/decentraland/sdk/components/camera_mode_area.proto

@@ -8,7 +8,19 @@ import "decentraland/sdk/components/common/id.proto";
 
 option (common.ecs_component_id) = 1071;
 
+// The CameraModeArea component can be attached to an Entity to define a region of space where 
+// the player's camera mode (1st-person or 3rd-person) is overridden.
+//
+// The Entity's Transform position determines the center-point of the region, while its size is 
+// given as a vector in the `area` property below. The Transform rotation is applied, but the scale 
+// is ignored.
+//
+// When players leave the region, their previous setting is restored.
+//
+// Note that, while commonly used to delineate a 2D area in a scene (hence the name), the region
+// is actually a 3D volume.
 message PBCameraModeArea {
-  decentraland.common.Vector3 area = 1;
-  common.CameraType mode = 2;
+  decentraland.common.Vector3 area = 1; // the 3D size of the region
+  common.CameraType mode = 2;           // the camera mode to enforce
+  optional bool use_collider_range = 4; // if true, the player will be considered inside the area when they are within 0.3m of the area. default true
 }

package/proto/decentraland/sdk/components/common/avatar_mask.proto

@@ -0,0 +1,7 @@
+syntax = "proto3";
+package decentraland.sdk.components.common;
+
+// Mask for which bones an animation applies to.
+enum AvatarMask {
+  AM_UPPER_BODY = 0;
+}

package/proto/decentraland/sdk/components/common/camera_transition.proto

@@ -0,0 +1,11 @@
+syntax = "proto3";
+package decentraland.sdk.components.common;
+
+// Defines the transition used towards the camera that contains the CameraTransition.
+// This structure may be updated in the future to specify from/to entities and to have easing functions.
+message CameraTransition {
+  oneof transition_mode {
+    float time = 1;
+    float speed = 2; // meters per second; e.g. speed 1 -> 1 meter per second
+  }
+}

package/proto/decentraland/sdk/components/common/camera_type.proto

@@ -5,4 +5,5 @@ package decentraland.sdk.components.common;
 enum CameraType {
   CT_FIRST_PERSON = 0;
   CT_THIRD_PERSON = 1;
+  CT_CINEMATIC = 2;    // controlled by the scene
 }

package/proto/decentraland/sdk/components/common/explorer_ui.proto

@@ -0,0 +1,14 @@
+syntax = "proto3";
+package decentraland.sdk.components.common;
+
+// Identifies which fullscreen explorer panel OpenExplorerUi targets.
+// EU_SETTINGS holds 0 so an unset `ui` field defaults to the least-intrusive panel.
+enum ExplorerUi {
+  EU_SETTINGS = 0;
+  EU_MAP = 1;
+  EU_BACKPACK = 2;
+  EU_CAMERA_REEL = 3;
+  EU_COMMUNITIES = 4;
+  EU_PLACES = 5;
+  EU_EVENTS = 6;
+}

package/proto/decentraland/sdk/components/common/input_action.proto

@@ -17,4 +17,24 @@ enum InputAction {
   IA_ACTION_4 = 11;
   IA_ACTION_5 = 12;
   IA_ACTION_6 = 13;
+  // Modifier key (Shift on desktop)
+  IA_MODIFIER = 14;
 }
+
+// PointerEventType is a kind of interaction that can be detected.
+enum PointerEventType {
+  PET_UP = 0;
+  PET_DOWN = 1;
+  PET_HOVER_ENTER = 2;
+  PET_HOVER_LEAVE = 3;
+  PET_PROXIMITY_ENTER = 4;
+  PET_PROXIMITY_LEAVE = 5;
+  PET_DRAG_LOCKED = 6;
+  PET_DRAG = 7;
+  PET_DRAG_END = 8;
+}
+
+enum InteractionType {
+  CURSOR = 0;
+  PROXIMITY = 1;
+}

package/proto/decentraland/sdk/components/common/loading_state.proto

@@ -0,0 +1,10 @@
+syntax = "proto3";
+package decentraland.sdk.components.common;
+
+enum LoadingState {
+  UNKNOWN = 0;
+  LOADING = 1;
+  NOT_FOUND = 2;
+  FINISHED_WITH_ERROR = 3;
+  FINISHED = 4;
+}

package/proto/decentraland/sdk/components/common/media_state.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+package decentraland.sdk.components.common;
+
+enum MediaState {
+  MS_NONE = 0;
+  MS_ERROR = 1;
+  MS_LOADING = 2;
+  MS_READY = 3;
+  MS_PLAYING = 4;
+  MS_BUFFERING = 5;
+  MS_SEEKING = 6;
+  MS_PAUSED = 7;
+}

package/proto/decentraland/sdk/components/common/raycast_hit.proto

@@ -0,0 +1,16 @@
+syntax = "proto3";
+
+package decentraland.sdk.components.common;
+import "decentraland/common/vectors.proto";
+
+// RaycastHit contains information about the intersection of a ray with a mesh.
+message RaycastHit {
+  // Position will be relative to the scene
+  decentraland.common.Vector3 position = 1;      // the intersection point in global coordinates
+  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
+  decentraland.common.Vector3 normal_hit = 4;    // normal of the hit surface in global coordinates
+  float length = 5;                              // the distance between the ray origin and the hit position
+  optional string mesh_name = 6;                 // mesh name, if collision happened inside a GltfContainer
+  optional uint32 entity_id = 7;                 // the ID of the Entity that has the impacted mesh attached
+}

package/proto/decentraland/sdk/components/common/texts.proto

@@ -15,6 +15,7 @@ enum TextAlignMode {
 }
 
 enum Font {
-  F_LIBERATION_SANS = 0;
-  F_SANS_SERIF = 1;
+  F_SANS_SERIF = 0;
+  F_SERIF = 1;
+  F_MONOSPACE = 2;
 }

package/proto/decentraland/sdk/components/engine_info.proto

@@ -0,0 +1,16 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1048;
+
+// EngineInfo provides information about the graphics engine running the scene.
+// The values of this component are written at the "physics" stage of the ADR-148. Meaning
+// the tick_number and frame_number of the same frame could be used as correlation numbers
+// for timestamps in other components.
+message PBEngineInfo {
+  uint32 frame_number = 1; // frame counter of the engine
+  float total_runtime = 2; // total runtime of this scene in seconds
+  uint32 tick_number  = 3; // tick counter of the scene as per ADR-148
+  bool scene_hidden   = 4; // visibility state of the scene regarding Explorer fullscreen UI
+}

package/proto/decentraland/sdk/components/explorer_ui_events_result.proto

@@ -0,0 +1,31 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/sdk/components/common/explorer_ui.proto";
+
+option (common.ecs_component_id) = 1220;
+
+// PBExplorerUiEventsResult transports the lifecycle events of fullscreen explorer panels — a panel was
+// opened, a panel was closed. It is a grow only value set appended to the scene root entity, so every
+// event of a tick is delivered and none overwrites another.
+message PBExplorerUiEventsResult {
+  // Emitted when a fullscreen explorer panel is opened.
+  message UiOpened {}
+
+  // Emitted when a fullscreen explorer panel is closed.
+  message UiClosed {}
+
+  decentraland.sdk.components.common.ExplorerUi ui = 1; // The panel that the event refers to
+  uint32 timestamp = 2;                                 // The scene tick when the event occurred
+
+  // Extension point, deliberately narrow: a variant belongs here only if it is meaningful for every
+  // value of `ui`, because `ui` and `event` are independent axes and every combination of the two is
+  // representable. An event that belongs to one panel alone (an item was worn in the backpack, a photo
+  // was taken in the camera reel) is not added here — it gets its own result component, where the
+  // component identity carries the panel and no contradictory pair can be expressed at all.
+  oneof event {
+    UiOpened opened = 10;
+    UiClosed closed = 11;
+  }
+}

package/proto/decentraland/sdk/components/global_light.proto

@@ -0,0 +1,22 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/common/colors.proto";
+import "decentraland/common/vectors.proto";
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1206;
+
+// defines the global scene light settings. must be added to the scene root.
+// to control sunlight color, intensity, shadows etc, you can also add a PBLight to the scene root.
+message PBGlobalLight {
+  // the direction the directional light shines in.
+  // default depends on time of day and explorer implementation
+  optional decentraland.common.Vector3 direction = 1;
+  // ambient light color
+  // default: White
+  optional decentraland.common.Color3 ambient_color = 2;
+  // ambient light intensity. the explorer default ambient brightness is multiplied by this non-physical quantity.
+  // default 1
+  optional float ambient_brightness = 3; 
+}

package/proto/decentraland/sdk/components/gltf_container.proto

@@ -4,10 +4,16 @@ package decentraland.sdk.components;
 import "decentraland/sdk/components/common/id.proto";
 option (common.ecs_component_id) = 1041;
 
+// GltfContainer loads a GLTF file (and any additional files packaged inside) attached to an Entity.
+//
+// This allows the use of custom models, materials, collision boundaries and shapes that can't be 
+// achieved using MeshRenderer, MeshCollider and other standard components.
 message PBGltfContainer {
-   // which file to load
-  string src = 1;
-  
-  // SDK7xx which node to load
-  // SDK7xx optional string scene_name = 2;
+  string src = 1; // the GLTF file path as listed in the scene's manifest.
+
+  reserved 2;
+  reserved 3;
+
+  optional uint32 visible_meshes_collision_mask = 4; // default: 0
+  optional uint32 invisible_meshes_collision_mask = 5; // default: CL_POINTER | CL_PHYSICS
 }

package/proto/decentraland/sdk/components/gltf_container_loading_state.proto

@@ -0,0 +1,26 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1049;
+
+import "decentraland/sdk/components/common/loading_state.proto";
+
+// GltfContainerLoadingState is set by the engine and provides information about
+// the current state of the GltfContainer of an entity.
+message PBGltfContainerLoadingState {
+  common.LoadingState current_state = 1;
+  repeated string node_paths = 2; // all node paths in the gltf, which can be used with a GltfNode to inspect and modify the gltf contents
+  repeated string mesh_names = 3; // all meshes in the gltf. unnamed meshes will be auto-assigned a name of the form `MeshX` or `MeshX/PrimitiveY`
+                                  // where X is the mesh index and Y is the primitive index (and there is more than 1 primitive). note this may 
+                                  // conflict with manually named meshes - to avoid any issues make sure all your meshes are explicitly named.
+  repeated string material_names = 4; // all materials in the gltf. unnamed materials will be auto-assigned a name of the form `MaterialX` where
+                                      // X is the material index. note this may conflict with manually named materials - to avoid any issues make
+                                      // sure all your materials are explicitly named.
+  repeated string skin_names = 5; // all mesh skins in the gltf. unnamed skins will be auto-assigned a name of the form `SkinX` where
+                                  // X is the skin index. note this may conflict with manually named skins - to avoid any issues make sure all 
+                                  // your skins are explicitly named.
+  repeated string animation_names = 6; // all animations in the gltf. unnamed animations will be auto-assigned a name of the form `AnimationX` where
+                                       // X is the animation index. note this may conflict with manually named anims - to avoid any issues make sure all 
+                                       // your animations are explicitly named.
+}