@dcl/protocol 1.0.0-2891196094.commit-6b15eaa → 1.0.0-28980486989.commit-1e80e43

package/{ecs → proto/decentraland/sdk}/components/README.md

@@ -6,8 +6,8 @@ Inside each proto, we need to have at least this template:
 ```proto
 syntax = "proto3";
 
-import "common/id.proto";
-option (ecs_component_id) = XXXX;
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = XXXX;
 
 message PBComponentName {
     float one_parameter = 1;
@@ -22,7 +22,7 @@ Some points that must be well-defined:
 
 
 ## Common directory
-The common directory only has to have unambiguous structures like Vector3, Color3, Quaternion, etc. These messages will never change.
+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.

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/asset_load.proto

@@ -0,0 +1,10 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1213;
+
+// AssetLoad component allows an entity to request the pre-loading of one or more assets by the renderer.
+message PBAssetLoad {
+    repeated string assets = 1;
+}

package/proto/decentraland/sdk/components/asset_load_loading_state.proto

@@ -0,0 +1,16 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1214;
+
+import "decentraland/sdk/components/common/loading_state.proto";
+
+// AssetLoadLoadingState is set by the engine and provides information about
+// the current state of the AssetLoad of an entity.
+// The renderer appends a new object of this in each command, there can be many commands per frames
+message PBAssetLoadLoadingState {
+  common.LoadingState current_state = 1;   // current loading state
+  string asset = 2;                        // the asset being loaded (asset's scene path)
+  uint32 timestamp = 3;                    // monotonic counter
+}

package/proto/decentraland/sdk/components/audio_analysis.proto

@@ -0,0 +1,44 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1212;
+
+enum PBAudioAnalysisMode {
+    MODE_RAW = 0;
+    MODE_LOGARITHMIC = 1;
+}
+
+message PBAudioAnalysis {
+
+    // Parameters section
+    PBAudioAnalysisMode mode = 1;
+
+    // Used only when mode == MODE_LOGARITHMIC
+    optional float amplitude_gain = 100;
+    optional float bands_gain = 101;
+    // End when mode == MODE_LOGARITHMIC
+
+    // End Parameters section
+
+    // Result section
+    float amplitude = 200;
+
+    // Protobuf doesn't support fixed arrays -> 8 band fields
+    float band_0 = 201;
+    float band_1 = 202;
+    float band_2 = 203;
+    float band_3 = 204;
+    float band_4 = 205;
+    float band_5 = 206;
+    float band_6 = 207;
+    float band_7 = 208;
+
+    // End Result section
+
+    // Future fields
+    // float spectral_centroid = 13;
+    // float spectral_flux = 14;
+    // bool onset = 15;
+    // float bpm = 16;
+}

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,22 @@
+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
+  // either the audio will be global or spatial (default: false)
+  // global: plays the same way for every listener. It is not affected by distance, direction, or position.
+  // spatial: changes depending on where the listener is relative to the sound source
+  optional bool spatial = 4;
+  // Within the min distance the audio will cease to grow louder in volume (default: 0)
+  optional float spatial_min_distance = 5;
+  // The distance where sound either becomes inaudible or stops attenuation (default: 60)
+  optional float spatial_max_distance = 6;
+}

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_locomotion_settings.proto

@@ -0,0 +1,21 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1211;
+
+// The PBAvatarLocomotionSettings component allows scenes to modify locomotion settings defining things such
+// as the avatar movement speed, jump height etc.
+message PBAvatarLocomotionSettings {
+  optional float walk_speed = 1;            // Maximum speed when walking (in meters per second)
+  optional float jog_speed = 2;             // Maximum speed when jogging (in meters per second)
+  optional float run_speed = 3;             // Maximum speed when running (in meters per second)
+  optional float jump_height = 4;           // Height of a regular jump (in meters)
+  optional float run_jump_height = 5;       // Height of a jump while running (in meters)
+  optional float hard_landing_cooldown = 6; // Cooldown time after a hard landing before the avatar can move again (in seconds)
+  optional float double_jump_height = 7;    // Height of the double jump (in meters)
+  optional float gliding_speed = 8;         // Maximum speed when gliding (in meters per second)
+  optional float gliding_falling_speed = 9; // Maximum falling speed when gliding (in meters per second)
+}

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

@@ -0,0 +1,33 @@
+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.
+  AMT_HIDE_NAMETAGS = 2;     // the name tag displayed above an avatar is hidden.
+}

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

@@ -0,0 +1,49 @@
+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)
+}
+
+// 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

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

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