minecraft-data 3.35.0 → 3.36.1

package/.github/workflows/ci.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [14.x]
+        node-version: [18.x]
     steps:
     - uses: actions/checkout@v2
       with:

package/doc/history.md

@@ -1,5 +1,13 @@
 # History
 
+## 3.36.1
+
+* update `minecraft-data`
+
+## 3.36.0
+
+* update `minecraft-data`
+
 ## 3.35.0
 
 * update `minecraft-data`

package/index.d.ts

@@ -449,6 +449,10 @@ declare namespace MinecraftData {
      * The category of an entity : a semantic category
      */
     category?: string;
+    /**
+     * The pc metadata tags of an entity. (Naming is via mc code, with data_ and id_ prefixes stripped)
+     */
+    metadataKeys?: string[];
   }
   
   

package/minecraft-data/data/bedrock/1.16.201/proto.yml

@@ -707,7 +707,10 @@ packet_mob_effect:
    !id: 0x1c
    !bound: client
    runtime_entity_id: varint
-   event_id: u8
+   event_id: u8 =>
+      1: add
+      2: update
+      3: remove
    effect_id: zigzag32
    amplifier: zigzag32
    particles: bool
@@ -753,6 +756,7 @@ packet_interact:
    action_id: u8 =>
       3: leave_vehicle
       4: mouse_over_entity
+      5: npc_open
       6: open_inventory
    # TargetEntityRuntimeID is the runtime ID of the entity that the player interacted with. This is empty
    # for the InteractActionOpenInventory action type.
@@ -1162,7 +1166,11 @@ packet_player_list:
 packet_simple_event:
    !id: 0x40
    !bound: client
-   event_type: lu16
+   event_type: lu16 =>
+      0: uninitialized_subtype
+      1: enable_commands
+      2: disable_commands
+      3: unlock_world_template_settings
 
 # Event is sent by the server to send an event with additional data. It is typically sent to the client for
 # telemetry reasons, much like the SimpleEvent packet.
@@ -1601,9 +1609,14 @@ packet_show_store_offer:
    unknown0: string
    unknown1: bool
 
+# PurchaseReceipt is sent by the client to the server to notify the server it purchased an item from the
+# Marketplace store that was offered by the server. The packet is only used for partnered servers.
 packet_purchase_receipt:
    !id: 0x5c
    !bound: server
+   # Receipts is a list of receipts, or proofs of purchases, for the offers that have been purchased by the
+   # player.
+   receipts: string[]varint
 
 packet_player_skin:
    !id: 0x5d
@@ -1614,9 +1627,18 @@ packet_player_skin:
    old_skin_name: string
    is_verified: bool
 
+# SubClientLogin is sent when a sub-client joins the server while another client is already connected to it.
+# The packet is sent as a result of split-screen game play, and allows up to four players to play using the
+# same network connection. After an initial Login packet from the 'main' client, each sub-client that
+# connects sends a SubClientLogin to request their own login.
 packet_sub_client_login:
    !id: 0x5e
-   !bound: client
+   !bound: server
+   # ConnectionRequest is a string containing information about the player and JWTs that may be used to
+   # verify if the player is connected to XBOX Live. The connection request also contains the necessary
+   # client public key to initiate encryption.
+   # The ConnectionRequest in this packet is identical to the one found in the Login packet.
+   tokens: '["encapsulated", { "lengthType": "varint", "type": "LoginTokens" }]'
 
 packet_initiate_web_socket_connection:
    !id: 0x5f
@@ -1628,9 +1650,11 @@ packet_set_last_hurt_by:
    !bound: client
    unknown: varint
 
+# BookEdit is sent by the client when it edits a book. It is sent each time a modification was made and the
+# player stops its typing 'session', rather than simply after closing the book.
 packet_book_edit:
    !id: 0x61
-   !bound: client
+   !bound: server
    type: u8 =>
       0: replace_page
       1: add_page
@@ -1701,7 +1725,7 @@ packet_show_profile:
 # in the settings UI.
 packet_set_default_game_type:
    !id: 0x69
-   !bound: client
+   !bound: server
    # GameType is the new game type that is set. When sent by the client, this is the requested new default
    # game type.
    gamemode: GameMode
@@ -1736,6 +1760,7 @@ packet_lab_table:
    action_type: u8 =>
       0: combine
       1: react
+      2: reset
    # Position is the position at which the lab table used was located.
    position: vec3i
    # ReactionType is the type of the reaction that took place as a result of the items put into the lab
@@ -1889,7 +1914,7 @@ packet_level_event_generic:
 # or if the book should be removed from it.
 packet_lectern_update:
    !id: 0x7d
-   !bound: client
+   !bound: server
    # Page is the page number in the book that was opened by the player on the lectern.
    page: u8
    # PageCount is the number of pages that the book opened in the lectern has.
@@ -1905,7 +1930,9 @@ packet_video_stream_connect:
    !bound: client
    server_uri: string
    frame_send_frequency: lf32
-   action: u8
+   action: u8 =>
+      1: none
+      2: close
    resolution_x: li32
    resolution_y: li32
 
@@ -1945,7 +1972,7 @@ packet_map_create_locked_copy:
 
 packet_structure_template_data_export_request:
    !id: 0x84
-   !bound: client
+   !bound: server
 
 packet_structure_template_data_export_response:
    !id: 0x85
@@ -1960,7 +1987,7 @@ packet_update_block_properties:
 # what blobs it needs and which blobs it already has, in an ACK type system.
 packet_client_cache_blob_status:
    !id: 0x87
-   !bound: client
+   !bound: server
    # The number of MISSes in this packet
    misses: varint
    # The number of HITs in this packet
@@ -2224,7 +2251,7 @@ ArmorDamageType: [ "bitflags",
 # identical to the SetPlayerGameType packet.
 packet_update_player_game_type:
    !id: 0x97
-   !bound: server
+   !bound: client
    # GameType is the new game type of the player. It is one of the constants that can be found in
    # set_player_game_type.go. Some of these game types require additional flags to be set in an
    # AdventureSettings packet for the game mode to obtain its full functionality.
@@ -2399,7 +2426,7 @@ packet_item_component:
 # safer version of the text.
 packet_filter_text_packet:
    !id: 0xa3
-   !bound: client
+   !bound: both
    # Text is either the text from the client or the safer version of the text sent by the server.
    text: string
    # FromServer indicates if the packet was sent by the server or not.

package/minecraft-data/data/bedrock/1.16.201/protocol.json

@@ -4231,7 +4231,17 @@
         },
         {
           "name": "event_id",
-          "type": "u8"
+          "type": [
+            "mapper",
+            {
+              "type": "u8",
+              "mappings": {
+                "1": "add",
+                "2": "update",
+                "3": "remove"
+              }
+            }
+          ]
         },
         {
           "name": "effect_id",
@@ -4339,6 +4349,7 @@
               "mappings": {
                 "3": "leave_vehicle",
                 "4": "mouse_over_entity",
+                "5": "npc_open",
                 "6": "open_inventory"
               }
             }
@@ -4992,7 +5003,18 @@
       [
         {
           "name": "event_type",
-          "type": "lu16"
+          "type": [
+            "mapper",
+            {
+              "type": "lu16",
+              "mappings": {
+                "0": "uninitialized_subtype",
+                "1": "enable_commands",
+                "2": "disable_commands",
+                "3": "unlock_world_template_settings"
+              }
+            }
+          ]
         }
       ]
     ],
@@ -5889,7 +5911,18 @@
     ],
     "packet_purchase_receipt": [
       "container",
-      []
+      [
+        {
+          "name": "receipts",
+          "type": [
+            "array",
+            {
+              "countType": "varint",
+              "type": "string"
+            }
+          ]
+        }
+      ]
     ],
     "packet_player_skin": [
       "container",
@@ -5918,7 +5951,18 @@
     ],
     "packet_sub_client_login": [
       "container",
-      []
+      [
+        {
+          "name": "tokens",
+          "type": [
+            "encapsulated",
+            {
+              "lengthType": "varint",
+              "type": "LoginTokens"
+            }
+          ]
+        }
+      ]
     ],
     "packet_initiate_web_socket_connection": [
       "container",
@@ -6201,7 +6245,8 @@
               "type": "u8",
               "mappings": {
                 "0": "combine",
-                "1": "react"
+                "1": "react",
+                "2": "reset"
               }
             }
           ]
@@ -6541,7 +6586,16 @@
         },
         {
           "name": "action",
-          "type": "u8"
+          "type": [
+            "mapper",
+            {
+              "type": "u8",
+              "mappings": {
+                "1": "none",
+                "2": "close"
+              }
+            }
+          ]
         },
         {
           "name": "resolution_x",

package/minecraft-data/data/bedrock/1.16.210/proto.yml

@@ -746,7 +746,10 @@ packet_mob_effect:
    !id: 0x1c
    !bound: client
    runtime_entity_id: varint64
-   event_id: u8
+   event_id: u8 =>
+      1: add
+      2: update
+      3: remove
    effect_id: zigzag32
    amplifier: zigzag32
    particles: bool
@@ -796,6 +799,7 @@ packet_interact:
    action_id: u8 =>
       3: leave_vehicle
       4: mouse_over_entity
+      5: npc_open
       6: open_inventory
    # TargetEntityRuntimeID is the runtime ID of the entity that the player interacted with. This is empty
    # for the InteractActionOpenInventory action type.
@@ -1194,7 +1198,11 @@ packet_player_list:
 packet_simple_event:
    !id: 0x40
    !bound: client
-   event_type: lu16
+   event_type: lu16 =>
+      0: uninitialized_subtype
+      1: enable_commands
+      2: disable_commands
+      3: unlock_world_template_settings
 
 # Event is sent by the server to send an event with additional data. It is typically sent to the client for
 # telemetry reasons, much like the SimpleEvent packet.
@@ -1669,9 +1677,14 @@ packet_show_store_offer:
    unknown0: string
    unknown1: bool
 
+# PurchaseReceipt is sent by the client to the server to notify the server it purchased an item from the
+# Marketplace store that was offered by the server. The packet is only used for partnered servers.
 packet_purchase_receipt:
    !id: 0x5c
    !bound: server
+   # Receipts is a list of receipts, or proofs of purchases, for the offers that have been purchased by the
+   # player.
+   receipts: string[]varint
 
 packet_player_skin:
    !id: 0x5d
@@ -1682,9 +1695,18 @@ packet_player_skin:
    old_skin_name: string
    is_verified: bool
 
+# SubClientLogin is sent when a sub-client joins the server while another client is already connected to it.
+# The packet is sent as a result of split-screen game play, and allows up to four players to play using the
+# same network connection. After an initial Login packet from the 'main' client, each sub-client that
+# connects sends a SubClientLogin to request their own login.
 packet_sub_client_login:
    !id: 0x5e
-   !bound: client
+   !bound: server
+   # ConnectionRequest is a string containing information about the player and JWTs that may be used to
+   # verify if the player is connected to XBOX Live. The connection request also contains the necessary
+   # client public key to initiate encryption.
+   # The ConnectionRequest in this packet is identical to the one found in the Login packet.
+   tokens: '["encapsulated", { "lengthType": "varint", "type": "LoginTokens" }]'
 
 packet_initiate_web_socket_connection:
    !id: 0x5f
@@ -1696,9 +1718,11 @@ packet_set_last_hurt_by:
    !bound: client
    unknown: varint
 
+# BookEdit is sent by the client when it edits a book. It is sent each time a modification was made and the
+# player stops its typing 'session', rather than simply after closing the book.
 packet_book_edit:
    !id: 0x61
-   !bound: client
+   !bound: server
    type: u8 =>
       0: replace_page
       1: add_page
@@ -1769,7 +1793,7 @@ packet_show_profile:
 # in the settings UI.
 packet_set_default_game_type:
    !id: 0x69
-   !bound: client
+   !bound: server
    # GameType is the new game type that is set. When sent by the client, this is the requested new default
    # game type.
    gamemode: GameMode
@@ -1804,6 +1828,7 @@ packet_lab_table:
    action_type: u8 =>
       0: combine
       1: react
+      2: reset
    # Position is the position at which the lab table used was located.
    position: vec3i
    # ReactionType is the type of the reaction that took place as a result of the items put into the lab
@@ -1980,7 +2005,7 @@ packet_level_event_generic:
 # or if the book should be removed from it.
 packet_lectern_update:
    !id: 0x7d
-   !bound: client
+   !bound: server
    # Page is the page number in the book that was opened by the player on the lectern.
    page: u8
    # PageCount is the number of pages that the book opened in the lectern has.
@@ -1996,7 +2021,9 @@ packet_video_stream_connect:
    !bound: client
    server_uri: string
    frame_send_frequency: lf32
-   action: u8
+   action: u8 =>
+      1: none
+      2: close
    resolution_x: li32
    resolution_y: li32
 
@@ -2036,7 +2063,7 @@ packet_map_create_locked_copy:
 
 packet_structure_template_data_export_request:
    !id: 0x84
-   !bound: client
+   !bound: server
 
 packet_structure_template_data_export_response:
    !id: 0x85
@@ -2051,7 +2078,7 @@ packet_update_block_properties:
 # what blobs it needs and which blobs it already has, in an ACK type system.
 packet_client_cache_blob_status:
    !id: 0x87
-   !bound: client
+   !bound: server
    # The number of MISSes in this packet
    misses: varint
    # The number of HITs in this packet
@@ -2351,7 +2378,7 @@ ArmorDamageType: [ "bitflags",
 # identical to the SetPlayerGameType packet.
 packet_update_player_game_type:
    !id: 0x97
-   !bound: server
+   !bound: client
    # GameType is the new game type of the player. It is one of the constants that can be found in
    # set_player_game_type.go. Some of these game types require additional flags to be set in an
    # AdventureSettings packet for the game mode to obtain its full functionality.
@@ -2531,7 +2558,7 @@ packet_item_component:
 # safer version of the text.
 packet_filter_text_packet:
    !id: 0xa3
-   !bound: client
+   !bound: both
    # Text is either the text from the client or the safer version of the text sent by the server.
    text: string
    # FromServer indicates if the packet was sent by the server or not.

package/minecraft-data/data/bedrock/1.16.210/protocol.json

@@ -4415,7 +4415,17 @@
         },
         {
           "name": "event_id",
-          "type": "u8"
+          "type": [
+            "mapper",
+            {
+              "type": "u8",
+              "mappings": {
+                "1": "add",
+                "2": "update",
+                "3": "remove"
+              }
+            }
+          ]
         },
         {
           "name": "effect_id",
@@ -4523,6 +4533,7 @@
               "mappings": {
                 "3": "leave_vehicle",
                 "4": "mouse_over_entity",
+                "5": "npc_open",
                 "6": "open_inventory"
               }
             }
@@ -5156,7 +5167,18 @@
       [
         {
           "name": "event_type",
-          "type": "lu16"
+          "type": [
+            "mapper",
+            {
+              "type": "lu16",
+              "mappings": {
+                "0": "uninitialized_subtype",
+                "1": "enable_commands",
+                "2": "disable_commands",
+                "3": "unlock_world_template_settings"
+              }
+            }
+          ]
         }
       ]
     ],
@@ -6100,7 +6122,18 @@
     ],
     "packet_purchase_receipt": [
       "container",
-      []
+      [
+        {
+          "name": "receipts",
+          "type": [
+            "array",
+            {
+              "countType": "varint",
+              "type": "string"
+            }
+          ]
+        }
+      ]
     ],
     "packet_player_skin": [
       "container",
@@ -6129,7 +6162,18 @@
     ],
     "packet_sub_client_login": [
       "container",
-      []
+      [
+        {
+          "name": "tokens",
+          "type": [
+            "encapsulated",
+            {
+              "lengthType": "varint",
+              "type": "LoginTokens"
+            }
+          ]
+        }
+      ]
     ],
     "packet_initiate_web_socket_connection": [
       "container",
@@ -6412,7 +6456,8 @@
               "type": "u8",
               "mappings": {
                 "0": "combine",
-                "1": "react"
+                "1": "react",
+                "2": "reset"
               }
             }
           ]
@@ -6762,7 +6807,16 @@
         },
         {
           "name": "action",
-          "type": "u8"
+          "type": [
+            "mapper",
+            {
+              "type": "u8",
+              "mappings": {
+                "1": "none",
+                "2": "close"
+              }
+            }
+          ]
         },
         {
           "name": "resolution_x",

package/minecraft-data/data/bedrock/1.16.220/proto.yml

@@ -776,7 +776,10 @@ packet_mob_effect:
    !id: 0x1c
    !bound: client
    runtime_entity_id: varint64
-   event_id: u8
+   event_id: u8 =>
+      1: add
+      2: update
+      3: remove
    effect_id: zigzag32
    amplifier: zigzag32
    particles: bool
@@ -826,6 +829,7 @@ packet_interact:
    action_id: u8 =>
       3: leave_vehicle
       4: mouse_over_entity
+      5: npc_open
       6: open_inventory
    # TargetEntityRuntimeID is the runtime ID of the entity that the player interacted with. This is empty
    # for the InteractActionOpenInventory action type.
@@ -1231,7 +1235,11 @@ packet_player_list:
 packet_simple_event:
    !id: 0x40
    !bound: client
-   event_type: lu16
+   event_type: lu16 =>
+      0: uninitialized_subtype
+      1: enable_commands
+      2: disable_commands
+      3: unlock_world_template_settings
 
 # Event is sent by the server to send an event with additional data. It is typically sent to the client for
 # telemetry reasons, much like the SimpleEvent packet.
@@ -1909,7 +1917,7 @@ packet_player_skin:
 # connects sends a SubClientLogin to request their own login.
 packet_sub_client_login:
    !id: 0x5e
-   !bound: client
+   !bound: server
    # ConnectionRequest is a string containing information about the player and JWTs that may be used to
    # verify if the player is connected to XBOX Live. The connection request also contains the necessary
    # client public key to initiate encryption.
@@ -1939,7 +1947,7 @@ packet_set_last_hurt_by:
 # player stops its typing 'session', rather than simply after closing the book.
 packet_book_edit:
    !id: 0x61
-   !bound: client
+   !bound: server
    type: u8 =>
       0: replace_page
       1: add_page
@@ -1982,6 +1990,7 @@ packet_npc_request:
       3: set_name
       4: set_skin
       5: set_interaction_text
+      6: execute_opening_commands
    # CommandString is the command string set in the NPC. It may consist of multiple commands, depending on
    # what the player set in it.
    command: string
@@ -2068,7 +2077,7 @@ packet_show_profile:
 # in the settings UI.
 packet_set_default_game_type:
    !id: 0x69
-   !bound: client
+   !bound: server
    # GameType is the new game type that is set. When sent by the client, this is the requested new default
    # game type.
    gamemode: GameMode
@@ -2140,6 +2149,7 @@ packet_lab_table:
    action_type: u8 =>
       0: combine
       1: react
+      2: reset
    # Position is the position at which the lab table used was located.
    position: vec3i
    # ReactionType is the type of the reaction that took place as a result of the items put into the lab
@@ -2400,7 +2410,7 @@ packet_level_event_generic:
 # or if the book should be removed from it.
 packet_lectern_update:
    !id: 0x7d
-   !bound: client
+   !bound: server
    # Page is the page number in the book that was opened by the player on the lectern.
    page: u8
    # PageCount is the number of pages that the book opened in the lectern has.
@@ -2417,7 +2427,9 @@ packet_video_stream_connect:
    !bound: client
    server_uri: string
    frame_send_frequency: lf32
-   action: u8
+   action: u8 =>
+      1: none
+      2: close
    resolution_x: li32
    resolution_y: li32
 
@@ -2478,7 +2490,7 @@ packet_map_create_locked_copy:
 # StructureTemplateDataRequest is sent by the client to request data of a structure.
 packet_structure_template_data_export_request:
    !id: 0x84
-   !bound: client
+   !bound: server
    # StructureName is the name of the structure that was set in the structure block's UI. This is the name
    # used to export the structure to a file.
    name: string
@@ -2518,7 +2530,7 @@ packet_update_block_properties:
 # what blobs it needs and which blobs it already has, in an ACK type system.
 packet_client_cache_blob_status:
    !id: 0x87
-   !bound: client
+   !bound: server
    # The number of MISSes in this packet
    misses: varint
    # The number of HITs in this packet
@@ -2841,7 +2853,7 @@ ArmorDamageType: [ "bitflags",
 # identical to the SetPlayerGameType packet.
 packet_update_player_game_type:
    !id: 0x97
-   !bound: server
+   !bound: client
    # GameType is the new game type of the player. It is one of the constants that can be found in
    # set_player_game_type.go. Some of these game types require additional flags to be set in an
    # AdventureSettings packet for the game mode to obtain its full functionality.
@@ -3021,7 +3033,7 @@ packet_item_component:
 # safer version of the text.
 packet_filter_text_packet:
    !id: 0xa3
-   !bound: client
+   !bound: both
    # Text is either the text from the client or the safer version of the text sent by the server.
    text: string
    # FromServer indicates if the packet was sent by the server or not.