minecraft-data 3.83.1 → 3.84.1

package/.github/workflows/ci.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [18.x]
+        node-version: [22.x]
     steps:
     - uses: actions/checkout@v2
       with:
@@ -22,6 +22,6 @@ jobs:
     - run: npm test
     - name: Upload index.d.ts
       if: always()
-      uses: actions/upload-artifact@v3.0.0
+      uses: actions/upload-artifact@v4.0.0
       with:
         path: index.d.ts

package/.github/workflows/npm-publish.yml

@@ -16,7 +16,7 @@ jobs:
     - name: Set up Node.js
       uses: actions/setup-node@master
       with:
-        node-version: 18.0.0
+        node-version: 22.0.0
     - run: npm install
     - id: publish
       uses: JS-DevTools/npm-publish@v1

package/data.js

@@ -2377,10 +2377,32 @@ module.exports =
       get steve () { return require("./minecraft-data/data/bedrock/1.21.50/steve.json") },
       get blocksB2J () { return require("./minecraft-data/data/bedrock/1.21.0/blocksB2J.json") },
       get blocksJ2B () { return require("./minecraft-data/data/bedrock/1.21.0/blocksJ2B.json") },
-      proto: __dirname + '/minecraft-data/data/bedrock/latest/proto.yml',
+      proto: __dirname + '/minecraft-data/data/bedrock/1.21.50/proto.yml',
       types: __dirname + '/minecraft-data/data/bedrock/latest/types.yml',
       get version () { return require("./minecraft-data/data/bedrock/1.21.50/version.json") },
       get language () { return require("./minecraft-data/data/bedrock/1.20.10/language.json") }
+    },
+    '1.21.60': {
+      get blocks () { return require("./minecraft-data/data/bedrock/1.21.0/blocks.json") },
+      get blockStates () { return require("./minecraft-data/data/bedrock/1.21.0/blockStates.json") },
+      get blockCollisionShapes () { return require("./minecraft-data/data/bedrock/1.21.0/blockCollisionShapes.json") },
+      get biomes () { return require("./minecraft-data/data/bedrock/1.20.0/biomes.json") },
+      get entities () { return require("./minecraft-data/data/bedrock/1.21.0/entities.json") },
+      get items () { return require("./minecraft-data/data/bedrock/1.21.0/items.json") },
+      get recipes () { return require("./minecraft-data/data/bedrock/1.19.10/recipes.json") },
+      get instruments () { return require("./minecraft-data/data/bedrock/1.17.0/instruments.json") },
+      get materials () { return require("./minecraft-data/data/pc/1.17/materials.json") },
+      get enchantments () { return require("./minecraft-data/data/bedrock/1.19.1/enchantments.json") },
+      get effects () { return require("./minecraft-data/data/pc/1.17/effects.json") },
+      get protocol () { return require("./minecraft-data/data/bedrock/1.21.60/protocol.json") },
+      get windows () { return require("./minecraft-data/data/bedrock/1.16.201/windows.json") },
+      get steve () { return require("./minecraft-data/data/bedrock/1.21.50/steve.json") },
+      get blocksB2J () { return require("./minecraft-data/data/bedrock/1.21.0/blocksB2J.json") },
+      get blocksJ2B () { return require("./minecraft-data/data/bedrock/1.21.0/blocksJ2B.json") },
+      proto: __dirname + '/minecraft-data/data/bedrock/latest/proto.yml',
+      types: __dirname + '/minecraft-data/data/bedrock/latest/types.yml',
+      get version () { return require("./minecraft-data/data/bedrock/1.21.60/version.json") },
+      get language () { return require("./minecraft-data/data/bedrock/1.21.60/language.json") }
     }
   }
 }

package/doc/history.md

@@ -1,5 +1,13 @@
 # History
 
+## 3.84.1
+
+* update `minecraft-data`
+
+## 3.84.0
+
+* update `minecraft-data`
+
 ## 3.83.1
 
 * update `minecraft-data`

package/minecraft-data/.github/workflows/bedrock-ci.yml

@@ -12,10 +12,10 @@ jobs:
     timeout-minutes: 14
 
     steps:
-    - name: Use Node.js 18.x
+    - name: Use Node.js 22.x
       uses: actions/setup-node@v1
       with:
-        node-version: 18.x
+        node-version: 22.x
     # Old versions of bedrock use old libssl that Ubuntu no longer ships with; need manual install
     - name: Install libssl 1.1
       run: |

package/minecraft-data/.github/workflows/build-gh-pages.yml

@@ -10,10 +10,10 @@ jobs:
         with:
           fetch-depth: 0
           ref: web
-      - name: Use Node.js 18.x
+      - name: Use Node.js 22.x
         uses: actions/setup-node@v1
         with:
-          node-version: 18.x
+          node-version: 22.x
       - name: Run tool
         run: |
             npm install

package/minecraft-data/.github/workflows/ci.yml

@@ -13,7 +13,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [18.x]
+        node-version: [22.x]
 
     steps:
     - uses: actions/checkout@v2

package/minecraft-data/.github/workflows/update-helper.yml

@@ -14,7 +14,7 @@ jobs:
     - name: Set up Node.js
       uses: actions/setup-node@master
       with:
-        node-version: 18.0.0
+        node-version: 22.0.0
     - name: Install Github Actions toolkit
       run: npm i gh-helpers
       working-directory: .github/helper-bot

package/minecraft-data/README.md

@@ -10,7 +10,7 @@ Language independent module providing minecraft data for minecraft clients, serv
 Supports
 * Minecraft PC version 0.30c (classic), 1.7.10, 1.8.8, 1.9 (15w40b, 1.9, 1.9.1-pre2, 1.9.2, 1.9.4),
 1.10 (16w20a, 1.10-pre1, 1.10, 1.10.1, 1.10.2), 1.11 (16w35a, 1.11, 1.11.2), 1.12 (17w15a, 17w18b, 1.12-pre4, 1.12, 1.12.1, 1.12.2), 1.13 (17w50a, 1.13, 1.13.1, 1.13.2-pre1, 1.13.2-pre2, 1.13.2), 1.14 (1.14, 1.14.1, 1.14.3, 1.14.4), 1.15 (1.15, 1.15.1, 1.15.2), 1.16 (20w13b, 20w14a, 1.16-rc1, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5), 1.17, 1.17.1, 1.18 (1.18, 1.18.1, 1.18.2), 1.19 (1.19, 1.19.2, 1.19.3, 1.19.4), 1.20 (1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6), 1.21 (1.21, 1.21.1, 1.21.3)
-* Minecraft bedrock version 0.14, 0.15, 1.0, 1.16.201, 1.16.210, 1.16.220, 1.17.0, 1.17.10, 1.17.30, 1.17.40, 1.18.0, 1.18.11, 1.18.30, 1.19.1, 1.19.10, 1.19.20, 1.19.21, 1.19.30, 1.19.40, 1.19.50, 1.19.60, 1.19.62, 1.19.63, 1.19.70, 1.19.80, 1.20.0, 1.20.10, 1.20.30, 1.20.40, 1.20.50, 1.20.61, 1.20.71, 1.20.80, 1.21.0, 1.21.2, 1.21.20, 1.21.30, 1.21.42, 1.21.50
+* Minecraft bedrock version 0.14, 0.15, 1.0, 1.16.201, 1.16.210, 1.16.220, 1.17.0, 1.17.10, 1.17.30, 1.17.40, 1.18.0, 1.18.11, 1.18.30, 1.19.1, 1.19.10, 1.19.20, 1.19.21, 1.19.30, 1.19.40, 1.19.50, 1.19.60, 1.19.62, 1.19.63, 1.19.70, 1.19.80, 1.20.0, 1.20.10, 1.20.30, 1.20.40, 1.20.50, 1.20.61, 1.20.71, 1.20.80, 1.21.0, 1.21.2, 1.21.20, 1.21.30, 1.21.42, 1.21.50, 1.21.60
 
 
 ## Wrappers

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

@@ -873,13 +873,23 @@ packet_animate:
    !id: 0x2c
    !bound: both
    action_id: zigzag32 =>
+      # Unused
       0: none
+      # Server bound notification to swing the player's arm. Server is expected to rebroadcast to all that should see the arm move.
+      #  See also PlayerAuthInputPacket::InputData::MissedSwing for a very similar action
       1: swing_arm
       2: unknown
+      # Client bound notification to stop sleeping in a bed
       3: wake_up
+      # Client-bound notification to play critical hit particles
       4: critical_hit
+      # Unused
       5: magic_critical_hit
+      # Sent every tick the client is in a boat exclusively in legacy client authoritative movement.
+      # See Player Auth Input for how to compute this in the latest protocol.
       128: row_right
+      # Sent every tick the client is in a boat exclusively in legacy client authoritative movement.
+      # See Player Auth Input for how to compute this in the latest protocol.
       129: row_left
    runtime_entity_id: varint64
    _: action_id ?

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

@@ -306,10 +306,19 @@ Transaction:
          changed_slots: []varint
             slot_id: u8
    transaction_type: varint =>
+      # Sent for container UI operations depending on if ItemStackNetManager is enabled
       0: normal
+      # Sent from server to client to reject a transaction
       1: inventory_mismatch
+      # Sent for a player performing right click style item use.
+      # See the contained ItemUseInventoryTransaction::ActionType for the expected use case.
       2: item_use
+      # Sent for a player right clicking on an entity or attacking them.
+      # See ItemUseInventoryTransaction::ActionType for which it is.
       3: item_use_on_entity
+      # Sent when releasing right click on a chargeable item like a bow or finishing charging like a crossbow.
+      # This is different than canceling item use early which would be in Player Auth Input.
+      # See ItemReleaseInventoryTransaction::ActionType for which it is.
       4: item_release
    network_ids: bool
    inventory_actions: []varint
@@ -375,7 +384,9 @@ Transaction:
          # ActionType is the type of the UseItemOnEntity inventory transaction. It is one of the action types
          # found in the constants above, and specifies the way the player interacted with the entity.
          action_type: varint =>
+            # Right click interact with actor.
             0: interact
+            # Left click style attack of actor or elytra spin attack. Server is expected to deal damage to the entity with visuals.
             1: attack
          # HotBarSlot is the hot bar slot that the player was holding while clicking the entity. It should be used
          # to ensure that the hot bar slot and held item are correctly synchronised with the server.
@@ -396,7 +407,9 @@ Transaction:
          # As of 1.13, the ActionType is always 0. This field can be ignored, because releasing food (by consuming
          # it) or releasing a bow (to shoot an arrow) is essentially the same.
          action_type: varint =>
+            # Release right click and hold style item use, like firing a bow
             0: release
+            # Finish right click and hold style item use, like charging a crossbow
             1: consume
          # HotBarSlot is the hot bar slot that the player was holding while releasing the item. It should be used
          # to ensure that the hot bar slot and held item are correctly synchronised with the server.

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

@@ -894,13 +894,23 @@ packet_animate:
    !id: 0x2c
    !bound: both
    action_id: zigzag32 =>
+      # Unused
       0: none
+      # Server bound notification to swing the player's arm. Server is expected to rebroadcast to all that should see the arm move.
+      #  See also PlayerAuthInputPacket::InputData::MissedSwing for a very similar action
       1: swing_arm
       2: unknown
+      # Client bound notification to stop sleeping in a bed
       3: wake_up
+      # Client-bound notification to play critical hit particles
       4: critical_hit
+      # Unused
       5: magic_critical_hit
+      # Sent every tick the client is in a boat exclusively in legacy client authoritative movement.
+      # See Player Auth Input for how to compute this in the latest protocol.
       128: row_right
+      # Sent every tick the client is in a boat exclusively in legacy client authoritative movement.
+      # See Player Auth Input for how to compute this in the latest protocol.
       129: row_left
    runtime_entity_id: varint64
    _: action_id ?

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

@@ -494,8 +494,9 @@
                     "16": "minecart_display_block",
                     "17": "minecart_display_offset",
                     "18": "minecart_has_display",
-                    "20": "old_swell",
-                    "21": "swell_dir",
+                    "19": "horse_type",
+                    "20": "creeper_swell",
+                    "21": "creeper_swell_direction",
                     "22": "charge_amount",
                     "23": "enderman_held_runtime_id",
                     "24": "entity_age",
@@ -525,7 +526,7 @@
                     "49": "wither_target_1",
                     "50": "wither_target_2",
                     "51": "wither_target_3",
-                    "52": "aerial_attack",
+                    "52": "wither_aerial_attack",
                     "53": "boundingbox_width",
                     "54": "boundingbox_height",
                     "55": "fuse_length",
@@ -533,7 +534,7 @@
                     "57": "rider_rotation_locked",
                     "58": "rider_max_rotation",
                     "59": "rider_min_rotation",
-                    "60": "rider_rotation_offset",
+                    "60": "rider_seat_rotation_offset",
                     "61": "area_effect_cloud_radius",
                     "62": "area_effect_cloud_waiting",
                     "63": "area_effect_cloud_particle_id",
@@ -550,7 +551,7 @@
                     "74": "controlling_rider_seat_number",
                     "75": "strength",
                     "76": "max_strength",
-                    "77": "spell_casting_color",
+                    "77": "evoker_spell_casting_color",
                     "78": "limited_life",
                     "79": "armor_stand_pose_index",
                     "80": "ender_crystal_time_offset",
@@ -568,11 +569,11 @@
                     "92": "flags_extended",
                     "93": "laying_amount",
                     "94": "laying_amount_previous",
-                    "95": "duration",
-                    "96": "spawn_time",
-                    "97": "change_rate",
-                    "98": "change_on_pickup",
-                    "99": "pickup_count",
+                    "95": "area_effect_cloud_duration",
+                    "96": "area_effect_cloud_spawn_time",
+                    "97": "area_effect_cloud_change_rate",
+                    "98": "area_effect_cloud_change_on_pickup",
+                    "99": "area_effect_cloud_pickup_count",
                     "100": "interact_text",
                     "101": "trade_tier",
                     "102": "max_trade_tier",

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

@@ -136,8 +136,9 @@ MetadataDictionary: []varint
       16: minecart_display_block #int (id | (data << 16))
       17: minecart_display_offset #int
       18: minecart_has_display #byte (must be 1 for minecart to show block inside)
-      20: old_swell
-      21: swell_dir
+      19: horse_type
+      20: creeper_swell
+      21: creeper_swell_direction
       22: charge_amount
       23: enderman_held_runtime_id #short
       24: entity_age #short
@@ -167,7 +168,7 @@ MetadataDictionary: []varint
       49: wither_target_1 #long
       50: wither_target_2 #long
       51: wither_target_3 #long
-      52: aerial_attack
+      52: wither_aerial_attack
       53: boundingbox_width
       54: boundingbox_height
       55: fuse_length
@@ -175,7 +176,7 @@ MetadataDictionary: []varint
       57: rider_rotation_locked #byte
       58: rider_max_rotation #float
       59: rider_min_rotation #float
-      60: rider_rotation_offset
+      60: rider_seat_rotation_offset
       61: area_effect_cloud_radius #float
       62: area_effect_cloud_waiting #int
       63: area_effect_cloud_particle_id #int
@@ -192,7 +193,7 @@ MetadataDictionary: []varint
       74: controlling_rider_seat_number #byte
       75: strength #int
       76: max_strength #int
-      77: spell_casting_color #int
+      77: evoker_spell_casting_color #int
       78: limited_life
       79: armor_stand_pose_index # int
       80: ender_crystal_time_offset # int
@@ -210,11 +211,11 @@ MetadataDictionary: []varint
       92: flags_extended
       93: laying_amount
       94: laying_amount_previous
-      95: duration
-      96: spawn_time
-      97: change_rate
-      98: change_on_pickup
-      99: pickup_count
+      95: area_effect_cloud_duration
+      96: area_effect_cloud_spawn_time
+      97: area_effect_cloud_change_rate
+      98: area_effect_cloud_change_on_pickup
+      99: area_effect_cloud_pickup_count
       100: interact_text
       101: trade_tier
       102: max_trade_tier
@@ -408,8 +409,14 @@ TransactionUseItem:
    # ActionType is the type of the UseItem inventory transaction. It is one of the action types found above,
    # and specifies the way the player interacted with the block.
    action_type: varint =>
+      # Right click item use on a surface like placing a block
       0: click_block
+      # Start right click and hold style item use or potentially interact with nothing.
+      # If it is a usable item like food the server is expected to send a SetActorDataPacket with ActorFlags::USINGITEM along with the transaction response.
+      # While using an item, movement speed is slowed which will be reflected in the move vector in Player Auth Input.
       1: click_air
+      # Block breaking like left click. When using server auth block breaking as specified in StartGamePacket this is never sent.
+      # Instead, block actions are supplied in Player Auth Input.
       2: break_block
    # BlockPosition is the position of the block that was interacted with. This is only really a correct
    # block position if ActionType is not UseItemActionClickAir.
@@ -487,10 +494,19 @@ Transaction:
    legacy: TransactionLegacy
    # What type of transaction took place
    transaction_type: varint =>
+      # Sent for container UI operations depending on if ItemStackNetManager is enabled
       0: normal
+      # Sent from server to client to reject a transaction
       1: inventory_mismatch
+      # Sent for a player performing right click style item use.
+      # See the contained ItemUseInventoryTransaction::ActionType for the expected use case.
       2: item_use
+      # Sent for a player right clicking on an entity or attacking them.
+      # See ItemUseInventoryTransaction::ActionType for which it is.
       3: item_use_on_entity
+      # Sent when releasing right click on a chargeable item like a bow or finishing charging like a crossbow.
+      # This is different than canceling item use early which would be in Player Auth Input.
+      # See ItemReleaseInventoryTransaction::ActionType for which it is.
       4: item_release
    # The list of inventory internal actions in this packet, e.g. inventory GUI actions
    actions: TransactionActions
@@ -509,7 +525,9 @@ Transaction:
          # ActionType is the type of the UseItemOnEntity inventory transaction. It is one of the action types
          # found in the constants above, and specifies the way the player interacted with the entity.
          action_type: varint =>
+            # Right click interact with actor.
             0: interact
+            # Left click style attack of actor or elytra spin attack. Server is expected to deal damage to the entity with visuals.
             1: attack
          # HotBarSlot is the hot bar slot that the player was holding while clicking the entity. It should be used
          # to ensure that the hot bar slot and held item are correctly synchronised with the server.
@@ -530,7 +548,9 @@ Transaction:
          # As of 1.13, the ActionType is always 0. This field can be ignored, because releasing food (by consuming
          # it) or releasing a bow (to shoot an arrow) is essentially the same.
          action_type: varint =>
+            # Release right click and hold style item use, like firing a bow
             0: release
+            # Finish right click and hold style item use, like charging a crossbow
             1: consume
          # HotBarSlot is the hot bar slot that the player was holding while releasing the item. It should be used
          # to ensure that the hot bar slot and held item are correctly synchronised with the server.

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

@@ -924,13 +924,23 @@ packet_animate:
    !id: 0x2c
    !bound: both
    action_id: zigzag32 =>
+      # Unused
       0: none
+      # Server bound notification to swing the player's arm. Server is expected to rebroadcast to all that should see the arm move.
+      #  See also PlayerAuthInputPacket::InputData::MissedSwing for a very similar action
       1: swing_arm
       2: unknown
+      # Client bound notification to stop sleeping in a bed
       3: wake_up
+      # Client-bound notification to play critical hit particles
       4: critical_hit
+      # Unused
       5: magic_critical_hit
+      # Sent every tick the client is in a boat exclusively in legacy client authoritative movement.
+      # See Player Auth Input for how to compute this in the latest protocol.
       128: row_right
+      # Sent every tick the client is in a boat exclusively in legacy client authoritative movement.
+      # See Player Auth Input for how to compute this in the latest protocol.
       129: row_left
    runtime_entity_id: varint64
    _: action_id ?

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

@@ -671,8 +671,9 @@
                     "16": "minecart_display_block",
                     "17": "minecart_display_offset",
                     "18": "minecart_has_display",
-                    "20": "old_swell",
-                    "21": "swell_dir",
+                    "19": "horse_type",
+                    "20": "creeper_swell",
+                    "21": "creeper_swell_direction",
                     "22": "charge_amount",
                     "23": "enderman_held_runtime_id",
                     "24": "entity_age",
@@ -702,7 +703,7 @@
                     "49": "wither_target_1",
                     "50": "wither_target_2",
                     "51": "wither_target_3",
-                    "52": "aerial_attack",
+                    "52": "wither_aerial_attack",
                     "53": "boundingbox_width",
                     "54": "boundingbox_height",
                     "55": "fuse_length",
@@ -710,7 +711,7 @@
                     "57": "rider_rotation_locked",
                     "58": "rider_max_rotation",
                     "59": "rider_min_rotation",
-                    "60": "rider_rotation_offset",
+                    "60": "rider_seat_rotation_offset",
                     "61": "area_effect_cloud_radius",
                     "62": "area_effect_cloud_waiting",
                     "63": "area_effect_cloud_particle_id",
@@ -727,7 +728,7 @@
                     "74": "controlling_rider_seat_number",
                     "75": "strength",
                     "76": "max_strength",
-                    "77": "spell_casting_color",
+                    "77": "evoker_spell_casting_color",
                     "78": "limited_life",
                     "79": "armor_stand_pose_index",
                     "80": "ender_crystal_time_offset",
@@ -745,11 +746,11 @@
                     "92": "flags_extended",
                     "93": "laying_amount",
                     "94": "laying_amount_previous",
-                    "95": "duration",
-                    "96": "spawn_time",
-                    "97": "change_rate",
-                    "98": "change_on_pickup",
-                    "99": "pickup_count",
+                    "95": "area_effect_cloud_duration",
+                    "96": "area_effect_cloud_spawn_time",
+                    "97": "area_effect_cloud_change_rate",
+                    "98": "area_effect_cloud_change_on_pickup",
+                    "99": "area_effect_cloud_pickup_count",
                     "100": "interact_text",
                     "101": "trade_tier",
                     "102": "max_trade_tier",

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

@@ -184,8 +184,9 @@ MetadataDictionary: []varint
       16: minecart_display_block #int (id | (data << 16))
       17: minecart_display_offset #int
       18: minecart_has_display #byte (must be 1 for minecart to show block inside)
-      20: old_swell
-      21: swell_dir
+      19: horse_type
+      20: creeper_swell
+      21: creeper_swell_direction
       22: charge_amount
       23: enderman_held_runtime_id #short
       24: entity_age #short
@@ -215,7 +216,7 @@ MetadataDictionary: []varint
       49: wither_target_1 #long
       50: wither_target_2 #long
       51: wither_target_3 #long
-      52: aerial_attack
+      52: wither_aerial_attack
       53: boundingbox_width
       54: boundingbox_height
       55: fuse_length
@@ -223,7 +224,7 @@ MetadataDictionary: []varint
       57: rider_rotation_locked #byte
       58: rider_max_rotation #float
       59: rider_min_rotation #float
-      60: rider_rotation_offset
+      60: rider_seat_rotation_offset
       61: area_effect_cloud_radius #float
       62: area_effect_cloud_waiting #int
       63: area_effect_cloud_particle_id #int
@@ -240,7 +241,7 @@ MetadataDictionary: []varint
       74: controlling_rider_seat_number #byte
       75: strength #int
       76: max_strength #int
-      77: spell_casting_color #int
+      77: evoker_spell_casting_color #int
       78: limited_life
       79: armor_stand_pose_index # int
       80: ender_crystal_time_offset # int
@@ -258,11 +259,11 @@ MetadataDictionary: []varint
       92: flags_extended
       93: laying_amount
       94: laying_amount_previous
-      95: duration
-      96: spawn_time
-      97: change_rate
-      98: change_on_pickup
-      99: pickup_count
+      95: area_effect_cloud_duration
+      96: area_effect_cloud_spawn_time
+      97: area_effect_cloud_change_rate
+      98: area_effect_cloud_change_on_pickup
+      99: area_effect_cloud_pickup_count
       100: interact_text
       101: trade_tier
       102: max_trade_tier
@@ -460,8 +461,14 @@ TransactionUseItem:
    # ActionType is the type of the UseItem inventory transaction. It is one of the action types found above,
    # and specifies the way the player interacted with the block.
    action_type: varint =>
+      # Right click item use on a surface like placing a block
       0: click_block
+      # Start right click and hold style item use or potentially interact with nothing.
+      # If it is a usable item like food the server is expected to send a SetActorDataPacket with ActorFlags::USINGITEM along with the transaction response.
+      # While using an item, movement speed is slowed which will be reflected in the move vector in Player Auth Input.
       1: click_air
+      # Block breaking like left click. When using server auth block breaking as specified in StartGamePacket this is never sent.
+      # Instead, block actions are supplied in Player Auth Input.
       2: break_block
    # BlockPosition is the position of the block that was interacted with. This is only really a correct
    # block position if ActionType is not UseItemActionClickAir.
@@ -534,10 +541,19 @@ Transaction:
    legacy: TransactionLegacy
    # What type of transaction took place
    transaction_type: varint =>
+      # Sent for container UI operations depending on if ItemStackNetManager is enabled
       0: normal
+      # Sent from server to client to reject a transaction
       1: inventory_mismatch
+      # Sent for a player performing right click style item use.
+      # See the contained ItemUseInventoryTransaction::ActionType for the expected use case.
       2: item_use
+      # Sent for a player right clicking on an entity or attacking them.
+      # See ItemUseInventoryTransaction::ActionType for which it is.
       3: item_use_on_entity
+      # Sent when releasing right click on a chargeable item like a bow or finishing charging like a crossbow.
+      # This is different than canceling item use early which would be in Player Auth Input.
+      # See ItemReleaseInventoryTransaction::ActionType for which it is.
       4: item_release
    # The list of inventory internal actions in this packet, e.g. inventory GUI actions
    actions: TransactionActions
@@ -556,7 +572,9 @@ Transaction:
          # ActionType is the type of the UseItemOnEntity inventory transaction. It is one of the action types
          # found in the constants above, and specifies the way the player interacted with the entity.
          action_type: varint =>
+            # Right click interact with actor.
             0: interact
+            # Left click style attack of actor or elytra spin attack. Server is expected to deal damage to the entity with visuals.
             1: attack
          # HotBarSlot is the hot bar slot that the player was holding while clicking the entity. It should be used
          # to ensure that the hot bar slot and held item are correctly synchronised with the server.
@@ -577,7 +595,9 @@ Transaction:
          # As of 1.13, the ActionType is always 0. This field can be ignored, because releasing food (by consuming
          # it) or releasing a bow (to shoot an arrow) is essentially the same.
          action_type: varint =>
+            # Release right click and hold style item use, like firing a bow
             0: release
+            # Finish right click and hold style item use, like charging a crossbow
             1: consume
          # HotBarSlot is the hot bar slot that the player was holding while releasing the item. It should be used
          # to ensure that the hot bar slot and held item are correctly synchronised with the server.

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

@@ -925,13 +925,23 @@ packet_animate:
    !id: 0x2c
    !bound: both
    action_id: zigzag32 =>
+      # Unused
       0: none
+      # Server bound notification to swing the player's arm. Server is expected to rebroadcast to all that should see the arm move.
+      #  See also PlayerAuthInputPacket::InputData::MissedSwing for a very similar action
       1: swing_arm
       2: unknown
+      # Client bound notification to stop sleeping in a bed
       3: wake_up
+      # Client-bound notification to play critical hit particles
       4: critical_hit
+      # Unused
       5: magic_critical_hit
+      # Sent every tick the client is in a boat exclusively in legacy client authoritative movement.
+      # See Player Auth Input for how to compute this in the latest protocol.
       128: row_right
+      # Sent every tick the client is in a boat exclusively in legacy client authoritative movement.
+      # See Player Auth Input for how to compute this in the latest protocol.
       129: row_left
    runtime_entity_id: varint64
    _: action_id ?