@dcl/protocol 1.0.0-2611981047.commit-6f422a3 → 1.0.0-26120507017.commit-56ef588

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

@@ -0,0 +1,44 @@
+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)
+
+  optional bool show_only_wearables = 12; // hides the skin + hair + facial features (default: false)
+}
+

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_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

@@ -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/{ecs → proto/decentraland/sdk}/components/common/id.proto

@@ -1,4 +1,5 @@
 syntax = "proto3";
+package decentraland.sdk.components.common;
 
 import "google/protobuf/descriptor.proto";
 

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

@@ -0,0 +1,37 @@
+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;
+  // 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

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

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

@@ -0,0 +1,57 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/common/colors.proto";
+import "decentraland/common/texture.proto";
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1017;
+
+enum MaterialTransparencyMode {
+  MTM_OPAQUE = 0;
+  MTM_ALPHA_TEST = 1;
+  MTM_ALPHA_BLEND = 2;
+  MTM_ALPHA_TEST_AND_ALPHA_BLEND = 3;
+  MTM_AUTO = 4;
+}
+
+message PBMaterial {
+  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; // @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;
+  }
+}

package/proto/decentraland/sdk/components/mesh_collider.proto

@@ -0,0 +1,62 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1019;
+
+// The MeshCollider component provides basic collision detection between Entities and Avatars. It 
+// can behave like a cube, a plane, a sphere or a cylinder. 
+//
+// The Entity's Transform affects the MeshCollider, scaling it and rotating it appropriately. If
+// the Transform for the collision mesh must be different than the Transform for rendering the Entity,
+// two different Entities must be used.
+//
+// More complex shapes require the use of a `GltfContainer` component.
+message PBMeshCollider {
+  // BoxMesh is a prism shape that contains the Entity.
+  message BoxMesh {}
+
+  // CylinderMesh is a truncated cone shape that contains the Entity.
+  message CylinderMesh {
+    optional float radius_top = 1;    // (default 0.5)
+    optional float radius_bottom = 2; // (default 0.5)
+  }
+
+  // PlaneMesh is a 2D rectangle described by the Entity's Transform.
+  message PlaneMesh {}
+
+  // SphereMesh is a sphere shape that contains the Entity.
+  message SphereMesh {}
+
+  optional uint32 collision_mask = 1; // enabled ColliderLayers (default CL_POINTER | CL_PHYSICS)
+
+  oneof mesh {
+    BoxMesh box = 2;
+    SphereMesh sphere = 3;
+    CylinderMesh cylinder = 4;
+    PlaneMesh plane = 5;
+  }
+}
+
+// ColliderLayer determines the kind of collision to detect, in OR-able bit flag form.
+enum ColliderLayer {
+  CL_NONE = 0;           // no collisions
+  CL_POINTER = 1;        // collisions with the player's pointer ray (e.g. mouse cursor hovering)
+  CL_PHYSICS = 2;        // collision affecting your player's physics i.e. walls, floor, moving platfroms
+  CL_PLAYER = 4;         // layer corresponding to any player avatar
+  CL_RESERVED2 = 8;
+  CL_RESERVED3 = 16;
+  CL_RESERVED4 = 32;
+  CL_RESERVED5 = 64;
+  CL_RESERVED6 = 128;
+  CL_CUSTOM1 = 256;
+  CL_CUSTOM2 = 512;
+  CL_CUSTOM3 = 1024;
+  CL_CUSTOM4 = 2048;
+  CL_CUSTOM5 = 4096;
+  CL_CUSTOM6 = 8192;
+  CL_CUSTOM7 = 16384;
+  CL_CUSTOM8 = 32768;
+}

package/proto/decentraland/sdk/components/mesh_renderer.proto

@@ -0,0 +1,43 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1018;
+
+// The MeshRenderer component renders a basic geometric shape for an Entity. It can be a cube, a 
+// plane, a sphere or a cylinder.
+//
+// The cube and plane variants can include a UV texture mapping, so specific areas of a material 
+// texture are rendered on different faces of the shape. They are serialized as a sequence of 2D
+// `float` coordinates, one for each corner of each side of each face.
+//
+// More complex shapes require the use of a `GltfContainer` component.
+message PBMeshRenderer {
+    
+    // BoxMesh renders a prism shape.
+    message BoxMesh {
+        repeated float uvs = 1; // 96-value texture map (2D * 6 faces * 2 sides * 4 vertices)
+    }
+
+    // CylinderMesh renders a truncated cone shape.
+    message CylinderMesh {
+        optional float radius_top = 1;    // (default 0.5)
+        optional float radius_bottom = 2; // (default 0.5)
+    }
+
+    // PlaneMesh renders a 2D rectangular shape.
+    message PlaneMesh {
+        repeated float uvs = 1; // 16-value texture map (2D * 1 face * 2 sides * 4 vertices)
+    }
+
+    // SphereMesh renders a spherical shape.
+    message SphereMesh {
+    }
+
+    oneof mesh {
+        BoxMesh box = 1;
+        SphereMesh sphere = 2;
+        CylinderMesh cylinder = 3;
+        PlaneMesh plane = 4;
+    }
+}

package/proto/decentraland/sdk/components/nft_shape.proto

@@ -0,0 +1,48 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/common/colors.proto";
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1040;
+
+// The NftShape component renders a framed picture from an NFT. It supports PNG, JPEG and GIF files.
+//
+// The `urn` field is the URI of the NFT, and must follow the format 'urn:decentraland:<CHAIN>:<CONTRACT_STANDARD>:<CONTRACT_ADDRESS>:<TOKEN_ID>'
+// Example: 'urn:decentraland:ethereum:erc721:0x00000000:123'
+//
+// The picture frame can have several different styles, plus a background color for images that have
+// transparent pixels.
+message PBNftShape {
+  string urn = 1;                                // the URI of the NFT
+  optional NftFrameType style = 2;               // the frame style (default NFT_CLASSIC)
+  optional decentraland.common.Color3 color = 3; // RGB background (default [0.6404918, 0.611472, 0.8584906])
+}
+
+// NftFrameType is a predefined framing style for the image.
+enum NftFrameType {
+  NFT_CLASSIC = 0;
+  NFT_BAROQUE_ORNAMENT = 1;
+  NFT_DIAMOND_ORNAMENT = 2;
+  NFT_MINIMAL_WIDE = 3;
+  NFT_MINIMAL_GREY = 4;
+  NFT_BLOCKY = 5;
+  NFT_GOLD_EDGES = 6;
+  NFT_GOLD_CARVED = 7;
+  NFT_GOLD_WIDE = 8;
+  NFT_GOLD_ROUNDED = 9;
+  NFT_METAL_MEDIUM = 10;
+  NFT_METAL_WIDE = 11;
+  NFT_METAL_SLIM = 12;
+  NFT_METAL_ROUNDED = 13;
+  NFT_PINS = 14;
+  NFT_MINIMAL_BLACK = 15;
+  NFT_MINIMAL_WHITE = 16;
+  NFT_TAPE = 17;
+  NFT_WOOD_SLIM = 18;
+  NFT_WOOD_WIDE = 19;
+  NFT_WOOD_TWIGS = 20;
+  NFT_CANVAS = 21;
+  NFT_NONE = 22;
+}