@dcl/protocol 1.0.0-3338184295.commit-c785923 → 1.0.0-33413306233.commit-16d337c

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

@@ -7,13 +7,27 @@ 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
 }
 
-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_nametag.proto

@@ -0,0 +1,31 @@
+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.
+  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,45 @@ 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)
+}
+
+// Mask for which bones an animation applies to.
+enum AvatarEmoteMask {
+  AEM_FULL_BODY = 0;
+  AEM_UPPER_BODY = 1;
 }

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_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,18 @@ 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
 }

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,21 @@ 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;
+}
+
+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/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,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;
+}

package/proto/decentraland/sdk/components/gltf_node_modifiers.proto

@@ -0,0 +1,25 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/sdk/components/material.proto";
+
+option (common.ecs_component_id) = 1099;
+
+// GltfNodeModifiers component is to be used attached to entities that have the GltfContainer component.
+//
+// This allows to override either the Material or the Casting Shadows behaviour of the target GLTF Node.
+// 
+// * If the 'path' of the first modifier in the collection is an empty string: the configuration will
+// affect all of the GLTF Nodes (as a global modifier).
+// * Otherwise, for the modifiers whose 'path' is found in the GLTF hierarchy, the modifier will affect only
+// the target Nodes.
+message PBGltfNodeModifiers {
+  message GltfNodeModifier {
+    string path = 1; // The GLTF hierarchy path of the target Node to be affected
+    optional bool cast_shadows = 2; // The casting shadows enabled override
+    optional PBMaterial material = 3; // The Material that will be overridden on the target Node
+  }
+  repeated GltfNodeModifier modifiers  = 1;
+}

package/proto/decentraland/sdk/components/input_modifier.proto

@@ -0,0 +1,22 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1078;
+
+message PBInputModifier {
+    // when a boolean = false (default) the message is ignored and doesn't consume bandwidth
+    message StandardInput {
+        optional bool disable_all = 1;
+        optional bool disable_walk = 2;
+        optional bool disable_jog = 3;
+        optional bool disable_run = 4;
+        optional bool disable_jump = 5;
+        optional bool disable_emote = 6;
+        optional bool disable_double_jump = 7;
+        optional bool disable_gliding = 8;
+    }
+
+    oneof mode {
+        StandardInput standard = 1;
+    }
+}

package/proto/decentraland/sdk/components/light_source.proto

@@ -0,0 +1,28 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/common/colors.proto";
+import "decentraland/common/texture.proto";
+option (common.ecs_component_id) = 1079;
+
+message PBLightSource {
+  optional bool active = 1;                                          // default = true, whether the lightSource is active or not.
+  optional decentraland.common.Color3 color = 2;                     // default = white, the tint of the light, in RGB format where each component is a floating point value with a range from 0 to 1.
+  optional float intensity = 3;                                      // default = 16000, light intensity expressed in candels (lumens/m^2 at 1 m distance, or lumens divided by 4*pi)
+  optional float range = 4;                                          // default = -1, how far the light travels, expressed in meters. If negative will be computed automatically as pow(intensity, 0.25)
+  optional bool shadow = 5;                                          // default = false, whether the light casts shadows or not.
+  optional decentraland.common.TextureUnion shadow_mask_texture = 6; // Texture mask through which shadows are cast to simulate caustics, soft shadows, and light shapes such as light entering from a window.
+
+  oneof type {
+    Point point = 7;
+    Spot spot = 8;
+  }
+
+  message Point {
+  }
+
+  message Spot {
+    optional float inner_angle = 9;   // default = 21.8. Inner angle can't be higher than outer angle, otherwise will default to same value. Min value is 0. Max value is 179.
+    optional float outer_angle = 10;  // default = 30. Outer angle can't be lower than inner angle, otherwise will inner angle will be set to same value. Max value is 179.
+  }
+}

package/proto/decentraland/sdk/components/main_camera.proto

@@ -0,0 +1,11 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1075;
+
+// PBMainCamera.virtualCameraEntity defines which VirtualCamera entity is active at the moment.
+// This component may hold 'repeated common.CameraTransition' transitionOverrides in the future
+message PBMainCamera {
+  optional uint32 virtual_camera_entity = 1; // current active virtual camera
+}

package/proto/decentraland/sdk/components/map_pin.proto

@@ -0,0 +1,16 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+import "decentraland/common/vectors.proto";
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/common/texture.proto";
+option (common.ecs_component_id) = 1097;
+
+// @deprecated
+// Used internally for the game orchestrator PX, not exposed in the SDK
+message PBMapPin {
+  decentraland.common.Vector2 position = 1;
+  optional decentraland.common.TextureUnion texture = 2;
+  float icon_size = 3;
+  string title = 4;
+  string description = 5;
+}

package/proto/decentraland/sdk/components/material.proto

@@ -17,26 +17,41 @@ enum MaterialTransparencyMode {
 }
 
 message PBMaterial {
-  optional decentraland.common.TextureUnion texture = 1; // default = null
+  message UnlitMaterial {
+    optional decentraland.common.TextureUnion texture = 1; // default = null
+    optional float alpha_test = 2; // default = 0.5. range value: from 0 to 1
+    optional bool cast_shadows = 3; // default =  true
+    optional decentraland.common.Color4 diffuse_color = 4; // default = white;
+    optional decentraland.common.TextureUnion alpha_texture = 5; // default = null. Note that tilling and offset properties are ignored for this texture.
+  }
+
+  message PbrMaterial {
+    optional decentraland.common.TextureUnion texture = 1; // default = null
   
-  optional float alpha_test = 2; // default = 0.5. range value: from 0 to 1
-  optional bool cast_shadows = 3; // default =  true
-
-  optional decentraland.common.TextureUnion alpha_texture = 4; // default = null
-  optional decentraland.common.TextureUnion emissive_texture = 5; // default = null
-  optional decentraland.common.TextureUnion bump_texture = 6; // default = null
-
-  optional decentraland.common.Color3 albedo_color = 7; // default = white;
-  optional decentraland.common.Color3 emissive_color = 8; // default = black;
-  optional decentraland.common.Color3 reflectivity_color = 9; // default = white;
-
-  optional MaterialTransparencyMode transparency_mode = 10; // default = TransparencyMode.Auto
-
-  optional float metallic = 11; // default = 0.5
-  optional float roughness = 12; // default = 0.5
-  optional float glossiness = 13; // default = 1
-
-  optional float specular_intensity = 14; // default = 1
-  optional float emissive_intensity = 15; // default = 2
-  optional float direct_intensity = 16; // default = 1
-}
+    optional float alpha_test = 2; // default = 0.5. range value: from 0 to 1
+    optional bool cast_shadows = 3; // default =  true
+  
+    optional decentraland.common.TextureUnion alpha_texture = 4; // @deprecated Alpha textures are no longer supported on PBRMaterial and UnlitMaterial.alphaTexture should be used instead.
+    optional decentraland.common.TextureUnion emissive_texture = 5; // default = null. Note that tilling and offset properties are ignored for this texture.
+    optional decentraland.common.TextureUnion bump_texture = 6; // default = null. Note that tilling and offset properties are ignored for this texture.
+  
+    optional decentraland.common.Color4 albedo_color = 7; // default = white;
+    optional decentraland.common.Color3 emissive_color = 8; // default = black;
+    optional decentraland.common.Color3 reflectivity_color = 9; // default = white;
+  
+    optional MaterialTransparencyMode transparency_mode = 10; // default = TransparencyMode.Auto
+  
+    optional float metallic = 11; // default = 0.5
+    optional float roughness = 12; // default = 0.5
+    reserved 13;
+  
+    optional float specular_intensity = 14; // default = 1
+    optional float emissive_intensity = 15; // default = 2
+    optional float direct_intensity = 16; // default = 1
+  }
+
+  oneof material {
+    UnlitMaterial unlit = 1;
+    PbrMaterial pbr = 2;
+  }
+}