@dcl/protocol 1.0.0-10043247792.commit-428d1eb

package/proto/decentraland/realm/about.proto

@@ -0,0 +1,73 @@
+syntax = "proto3";
+package decentraland.realm;
+
+message AboutResponse {
+  bool healthy = 1;
+  AboutConfiguration configurations = 2;
+  ContentInfo content = 3;
+  CommsInfo comms = 4;
+  LambdasInfo lambdas = 5;
+  optional BffInfo bff = 6;
+  bool accepting_users = 7;
+
+  message MinimapConfiguration {
+    bool enabled = 1;
+    optional string data_image = 2;
+    optional string estate_image = 3;
+  }
+
+  message SkyboxConfiguration {
+    // only one value at a time
+    optional float fixed_hour = 1;
+  }
+
+  message AboutConfiguration {
+    optional string realm_name = 1;
+    uint32 network_id = 2;
+    repeated string global_scenes_urn = 3;
+    repeated string scenes_urn = 4;
+    optional MinimapConfiguration minimap = 5;
+    optional SkyboxConfiguration skybox = 6;
+
+    // A content server to be used to load the parcels around the user. Uses the POST /entities/active endpoint
+    // to continously fetch the parcels around the users. if null, then the default content server will be used
+    // if == "" then the city_loader will be disabled and the scenes_urn will be used to load the world
+    optional string city_loader_content_server = 7;
+  }
+
+  message ContentInfo {
+    // common properties
+    bool healthy = 1;
+    optional string version = 2;
+    optional string commit_hash = 3;
+    string public_url = 4;
+  }
+  message LambdasInfo {
+    // common properties
+    bool healthy = 1;
+    optional string version = 2;
+    optional string commit_hash = 3;
+    string public_url = 4;
+  }
+  message CommsInfo {
+    // common properties
+    bool healthy = 1;
+    optional string version = 2;
+    optional string commit_hash = 3;
+    optional string public_url = 4;
+    // specific properties
+    string protocol = 50;
+    optional int32 users_count = 51;
+    optional string fixed_adapter = 52;
+  }
+  message BffInfo {
+    // common properties
+    bool healthy = 1;
+    optional string version = 2;
+    optional string commit_hash = 3;
+    string public_url = 4;
+    // specific properties
+    optional int32 user_count = 51;
+    optional string protocol_version = 52;
+  }
+}

package/proto/decentraland/sdk/components/README.md

@@ -0,0 +1,32 @@
+# How to add a new ECS Component with Protocol-Buffers
+
+In this directory, we have all the components with the schema `ComponentName.proto`. `ComponentName` has to be PascalCase, and the `.proto` is the extension that is recognized as protocol-buffer schema.
+
+Inside each proto, we need to have at least this template:
+```proto
+syntax = "proto3";
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = XXXX;
+
+message PBComponentName {
+    float one_parameter = 1;
+}
+
+```
+
+Some points that must be well-defined:
+- `XXXX` the component ID is a super important property of the component, and it has to be unique at least between proto, otherwise, the code generation will fail.
+- `PBComponentName` the root message has to be the same as the file name with the prefix `PB`
+- `one_parameter` each parameter name has to be snake_case.
+
+
+## Common directory
+The common directory only has to have unambiguous structures like decentraland.common.Vector3, decentraland.common.Color3, Quaternion, etc. These messages will never change.
+
+## About specific options with other languages
+The definition must be the minimal proto code, and it shouldn't have a specific option to compile on some platform. So if you have to add additional information to the proto, you will be able to run a post-process after the protocol schemas acquisition.
+For example, in the unity-renderer repo, it'll be necessary to add the `csharp_namespace` option but it's the responsibility of this particular implementation. This code option doesn't define how the component is.
+
+# Test component
+If you write a proto and then push, CI will fail because the tests will fail. All the components need to be tested. `@dcl/ecs/test/components` has some examples!

package/proto/decentraland/sdk/components/Transform.md

@@ -0,0 +1,25 @@
+
+# Transform
+
+Transform is not a protocol-buffer definition, because it uses the native byte-buffer to write directly on the wire. This allows the consumer to copy the message directly on memory and the component be serialized a little bit faster.
+
+```cpp
+// Transform length = 44 
+struct Transform {
+    float positionX;
+    float positionY;
+    float positionZ;
+
+    float rotationX;
+    float rotationY;
+    float rotationZ;
+    float rotationW;
+
+    float scaleX;
+    float scaleY;
+    float scaleZ;
+
+    uint32_t parentEntity;
+};
+```
+- Serialized in big-endian

package/proto/decentraland/sdk/components/animator.proto

@@ -0,0 +1,31 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1042;
+
+// The Animator component is a container for multiple potential animations an Entity can display,
+// separately or at the same time. It can be used to start, stop or blend animations; as well as
+// to inspect their playback state.
+//
+// Animations have a `weight` property, which determines how pronounced the animation will be. This
+// can be adjusted to blend animations together, or gracefully transition from one to the next.
+message PBAnimator {
+  repeated PBAnimationState states = 1; // a collection of animations and their current state
+}
+
+// (*) initial state means what frame is set when the state is reset:
+// - if `speed` >= 0 the frame set is the first one
+// - if `speed` < 0 the frame set is the last one
+// (**) repeating means going back to the initial state at the moment the given animation is finished and keeps playing
+
+// AnimationState indicates the status and configuration of one available animation.
+message PBAnimationState {
+  reserved 1;                     // deprecated `name` prop
+  string clip = 2;                // the animation path in the `files` array of the scene manifest
+  optional bool playing = 3;      // whether this animation is currently playing
+  optional float weight = 4;      // @experimental the "weight" of this animation (see below, default: 1.0)
+  optional float speed = 5;       // the playback speed (default: 1.0)
+  optional bool loop = 6;         // whether the animation repeats (**) until is manually stopped (default: true)
+  optional bool should_reset = 7; // whether the animation is restored to the initial state (*) when it changes from stopped to playing (default: false)
+}

package/proto/decentraland/sdk/components/audio_event.proto

@@ -0,0 +1,12 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/sdk/components/common/media_state.proto";
+option (common.ecs_component_id) = 1105;
+
+message PBAudioEvent {
+  common.MediaState state = 1;
+  uint32 timestamp = 2;     // monotonic counter
+}

package/proto/decentraland/sdk/components/audio_source.proto

@@ -0,0 +1,31 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1020;
+
+// The AudioSource component can play an audio clips bundled with the scene, controlling some
+// of the behavior.
+//
+// In each AudioSource instance, the sound is spatially located at the associated entity’s position,
+// given by its Transform.
+//
+// Note that the `audio_clip_url` is not actually a URL, but rather the path of a file bundled with
+// the scene and declared in its manifest. The name was chosen because the URL use-case will
+// eventually be supported.
+//
+// `playing=true` when it's previously `playing=true`
+//  a) if clip is playing and `current_time` is NOT SET, the clip remains in the current `current_time`
+//  b) if clip is stopped or `current_time` is set, the clip is played from the `current_time` (if set) or from the beginning
+//
+// If other property (volume, loop, pitch) is changed while playing, the clip is keep playing with the new properties
+// Changing `audio_clip_url` while playing stops the current clip and plays the new one (as a new instance)
+message PBAudioSource {
+  optional bool playing = 1; // whether the clip is currently playing.
+  optional float volume = 2; // the audio volume (default: 1.0).
+  optional bool loop = 3;    // whether the clip should restart when finished.
+  optional float pitch = 4;  // the audio pitch (default: 1.0).
+  string audio_clip_url = 5; // the clip path as given in the `files` array of the scene's manifest.
+  optional float current_time = 6;  // specifies the current playback time of the clip in seconds (default: 0).
+  optional bool global = 7; // whether the audio plays at constant volume across the scene.
+}

package/proto/decentraland/sdk/components/audio_stream.proto

@@ -0,0 +1,14 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1021;
+
+// The AudioStream component can play external audio clips given a URL, streaming it in real-time.
+//
+// Despite being attached to a particular entity, the sound is not affected by its position.
+message PBAudioStream {  
+  optional bool playing = 1; // whether the clip is currently playing
+  optional float volume = 2; // the audio volume (default: 1.0)
+  string url = 3;            // the audio stream HTTP URL
+}

package/proto/decentraland/sdk/components/avatar_attach.proto

@@ -0,0 +1,51 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1073;
+
+// The AvatarAttach component automatically repositions an Entity to maintain the same position and
+// rotation relative to some part of an avatar, called the "anchor point". The Entity
+// will follow this anchor as it moves.
+//
+// The Entity's own Transform is overridden by this component. To offset position and adjust scale,
+// add a child to the anchored Entity and set a Transform on it instead.
+//
+// AvatarAnchorPointType indicates which part of the avatar the Entity must follow.
+message PBAvatarAttach {
+  optional string avatar_id = 1;             // the user ID of the avatar (default: local user)
+  AvatarAnchorPointType anchor_point_id = 2; // the anchor point.
+}
+
+// AvatarAnchorPointType determines the part of the avatar's body that anchors the Entity.
+enum AvatarAnchorPointType {
+  // @deprecated consider parenting to `engine.PlayerEntity`, this will attach to player position with an arbitrary offset
+  AAPT_POSITION = 0;
+  AAPT_NAME_TAG = 1;
+  AAPT_HEAD = 4;
+  AAPT_NECK = 5;
+  AAPT_SPINE = 6;
+  AAPT_SPINE1 = 7;
+  AAPT_SPINE2 = 8;
+  AAPT_HIP = 9;
+  AAPT_LEFT_SHOULDER = 10;
+  AAPT_LEFT_ARM = 11;
+  AAPT_LEFT_FOREARM = 12;
+  AAPT_LEFT_HAND = 2;
+  AAPT_LEFT_HAND_INDEX = 13;
+  AAPT_RIGHT_SHOULDER = 14;
+  AAPT_RIGHT_ARM = 15;
+  AAPT_RIGHT_FOREARM = 16;
+  AAPT_RIGHT_HAND = 3;
+  AAPT_RIGHT_HAND_INDEX = 17;
+  AAPT_LEFT_UP_LEG = 18;
+  AAPT_LEFT_LEG = 19;
+  AAPT_LEFT_FOOT = 20;
+  AAPT_LEFT_TOE_BASE = 21;
+  AAPT_RIGHT_UP_LEG = 22;
+  AAPT_RIGHT_LEG = 23;
+  AAPT_RIGHT_FOOT = 24;
+  AAPT_RIGHT_TOE_BASE = 25;
+}

package/proto/decentraland/sdk/components/avatar_base.proto

@@ -0,0 +1,15 @@
+
+syntax = "proto3";
+package decentraland.sdk.components;
+import "decentraland/common/colors.proto";
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1087;
+
+// AvatarBase sets all modifiers over the avatar's apparence.
+message PBAvatarBase {
+  decentraland.common.Color3 skin_color = 1;
+  decentraland.common.Color3 eyes_color = 2;
+  decentraland.common.Color3 hair_color = 3;
+  string body_shape_urn = 4;
+  string name = 5;
+}

package/proto/decentraland/sdk/components/avatar_emote_command.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1088;
+
+// AvatarEmoteCommand is a grow only value set, used to signal the renderer about
+// avatar emotes playback.
+message PBAvatarEmoteCommand {
+  string emote_urn = 1;
+  bool loop = 2;
+  uint32 timestamp = 3;          // monotonic counter
+}

package/proto/decentraland/sdk/components/avatar_equipped_data.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1091;
+
+// AvatarEquipData is used to read the information about the avatar's owneables.
+// this component is written by the engine using the communications transports'
+// data.
+message PBAvatarEquippedData {
+  repeated string wearable_urns = 1;
+  repeated string emote_urns = 2;
+}

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

@@ -0,0 +1,32 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/common/vectors.proto";
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1070;
+
+// 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
+}
+
+// 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.
+}

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

@@ -0,0 +1,42 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+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;                  // 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)
+}
+

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

@@ -0,0 +1,29 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+
+// https://adr.decentraland.org/adr/ADR-198
+option (common.ecs_component_id) = 1090;
+
+// The Billboard component makes an Entity automatically reorient its rotation to face the camera. 
+// 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)
+}
+
+// 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_mode.proto

@@ -0,0 +1,12 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+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; // the camera type (1st-person or 3rd-person)
+}

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

@@ -0,0 +1,25 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/common/vectors.proto";
+import "decentraland/sdk/components/common/camera_type.proto";
+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; // the 3D size of the region
+  common.CameraType mode = 2;           // the camera mode to enforce
+}

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

@@ -0,0 +1,9 @@
+syntax = "proto3";
+
+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/id.md

@@ -0,0 +1,2 @@
+# Why id as file option?
+Extending this option in the component definition allows having the data of its ID in the protocol buffer code generator. 

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

@@ -0,0 +1,8 @@
+syntax = "proto3";
+package decentraland.sdk.components.common;
+
+import "google/protobuf/descriptor.proto";
+
+extend google.protobuf.FileOptions {
+  optional int32 ecs_component_id = 50000;
+}

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

@@ -0,0 +1,28 @@
+syntax = "proto3";
+
+package decentraland.sdk.components.common;
+
+enum InputAction {
+  IA_POINTER = 0;
+  IA_PRIMARY = 1;
+  IA_SECONDARY = 2;
+  IA_ANY = 3;
+  IA_FORWARD = 4;
+  IA_BACKWARD = 5;
+  IA_RIGHT = 6;
+  IA_LEFT = 7;
+  IA_JUMP = 8;
+  IA_WALK = 9;
+  IA_ACTION_3 = 10;
+  IA_ACTION_4 = 11;
+  IA_ACTION_5 = 12;
+  IA_ACTION_6 = 13;
+}
+
+// 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;
+}

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

@@ -0,0 +1,21 @@
+syntax = "proto3";
+
+package decentraland.sdk.components.common;
+
+enum TextAlignMode {
+  TAM_TOP_LEFT = 0;
+  TAM_TOP_CENTER = 1;
+  TAM_TOP_RIGHT = 2;
+  TAM_MIDDLE_LEFT = 3;
+  TAM_MIDDLE_CENTER = 4;
+  TAM_MIDDLE_RIGHT = 5;
+  TAM_BOTTOM_LEFT = 6;
+  TAM_BOTTOM_CENTER = 7;
+  TAM_BOTTOM_RIGHT = 8;
+}
+
+enum Font {
+  F_SANS_SERIF = 0;
+  F_SERIF = 1;
+  F_MONOSPACE = 2;
+}

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

@@ -0,0 +1,15 @@
+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
+}

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

@@ -0,0 +1,19 @@
+syntax = "proto3";
+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 {
+  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,13 @@
+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;
+}