View source for Minecraft:Java Edition protocol/Development version

This page documents the changes from release 1.21.10 (protocol 773) to the current release (26.2, protocol 776). The stable protocol documentation is currently lagging behind, and the changes documented here will be merged soon, once they are complete. For previous development version pages, see the [[Minecraft:Minecraft Wiki:Projects/wiki.vg merge/Protocol version numbers|Protocol version numbers]] page.

One who wishes to commandeer the merging of this into the [[Minecraft:Java_Edition_protocol|''Java Edition'' protocol]] pages when an update is made must be sure to respect any changes that may have occurred to the respective packets there.

== Contents ==

<div style="float:right;">__TOC__</div>

=== Data types ===

No changes so far.

=== Packets ===

=== Handshaking ===
{{packet list/begin|Handshaking|serverbound}}
{{packet list|Handshake|intention}}
 |}
<div>
=== Status ===
<div style="display: inline-grid">
{{packet list/begin|Status|clientbound}}
{{packet list|Status Response|status_response}}
{{packet list|Pong Response (status)|pong_response}}
 |}
</div>
<div style="display: inline-grid">
{{packet list/begin|Status|serverbound}}
{{packet list|Status Request|status_request}}
{{packet list|Ping Request (status)|ping_request}}
 |}
</div>
</div>
=== Login ===
<div>
<div style="display: inline-grid">
{{packet list/begin|Login|clientbound}}
{{packet list|Disconnect (login)|login_disconnect}}
{{packet list|Encryption Request|hello}}
{{packet list|Login Success|login_finished}}
{{packet list|Set Compression|login_compression}}
{{packet list|Login Plugin Request|custom_query}}
{{packet list|Cookie Request|cookie_request}}
 |}
</div>
<div style="display: inline-grid">
{{packet list/begin|Login|serverbound}}
{{packet list|Login Start|hello}}
{{packet list|Encryption Response|key}}
{{packet list|Login Plugin Response|custom_query_answer}}
{{packet list|Login Acknowledged|login_acknowledged}}
{{packet list|Cookie Response|cookie_response}}
 |}
</div>
</div>
=== Configuration ===
<div>
<div style="display: inline-grid">
{{packet list/begin|Configuration|clientbound}}
{{packet list|Cookie Request|cookie_request}}
{{packet list|Plugin Message (clientbound)|custom_payload}}
{{packet list|Disconnect|disconnect}}
{{packet list|Finish Configuration|finish_configuration}}
{{packet list|Keep Alive (clientbound)|keep_alive}}
{{packet list|Ping|ping}}
{{packet list|Reset Chat|reset_chat}}
{{packet list|Registry Data|registry_data}}
{{packet list|Remove Resource Pack|resource_pack_pop}}
{{packet list|Add Resource Pack|resource_pack_push}}
{{packet list|Store Cookie|store_cookie}}
{{packet list|Transfer|transfer}}
{{packet list|Feature Flags|update_enabled_features}}
{{packet list|Update Tags|update_tags}}
{{packet list|Known Packs (clientbound)|select_known_packs}}
{{packet list|Custom Report Details|custom_report_details}}
{{packet list|Server Links|server_links}}
{{packet list|Clear Dialog|clear_dialog}}
{{packet list|Show Dialog|show_dialog}}
{{packet list|Code of Conduct|code_of_conduct}}
 |}
</div>
<div style="display: inline-grid">
{{packet list/begin|Configuration|serverbound}}
{{packet list|Client Information|client_information}}
{{packet list|Cookie Response|cookie_response}}
{{packet list|Plugin Message (serverbound)|custom_payload}}
{{packet list|Acknowledge Finish Configuration|finish_configuration}}
{{packet list|Keep Alive (serverbound)|keep_alive}}
{{packet list|Pong|pong}}
{{packet list|Resource Pack Response|resource_pack}}
{{packet list|Known Packs (serverbound)|select_known_packs}}
{{packet list|Custom Click Action|custom_click_action}}
{{packet list|Accept Code of Conduct|accept_code_of_conduct}}
 |}
</div>
</div>
=== Play ===
<div>
<div style="display: inline-grid">
{{packet list/begin|Play|clientbound}}
{{packet list|Bundle Delimiter|bundle_delimiter}}
{{packet list|Spawn Entity|add_entity}}
{{packet list|Entity Animation|animate}}
{{packet list|Award Statistics|award_stats}}
{{packet list|Acknowledge Block Change|block_changed_ack}}
{{packet list|Set Block Destroy Stage|block_destruction}}
{{packet list|Block Entity Data|block_entity_data}}
{{packet list|Block Action|block_event}}
{{packet list|Block Update|block_update}}
{{packet list|Boss Bar|boss_event}}
{{packet list|Change Difficulty|change_difficulty}}
{{packet list|Chunk Batch Finished|chunk_batch_finished}}
{{packet list|Chunk Batch Start|chunk_batch_start}}
{{packet list|Chunk Biomes|chunks_biomes}}
{{packet list|Clear Titles|clear_titles}}
{{packet list|Command Suggestions Response|command_suggestions}}
{{packet list|Commands|commands}}
{{packet list|Close Container|container_close}}
{{packet list|Set Container Content|container_set_content}}
{{packet list|Set Container Property|container_set_data}}
{{packet list|Set Container Slot|container_set_slot}}
{{packet list|Cookie Request|cookie_request}}
{{packet list|Set Cooldown|cooldown}}
{{packet list|Chat Suggestions|custom_chat_completions}}
{{packet list|Plugin Message (clientbound)|custom_payload}}
{{packet list|Damage Event|damage_event}}
{{packet list|Debug Block Value|debug_block_value}}
{{packet list|Debug Chunk Value|debug_chunk_value}}
{{packet list|Debug Entity Value|debug_entity_value}}
{{packet list|Debug Event|debug_event}}
{{packet list|Debug Sample|debug_sample}}
{{packet list|Delete Message|delete_chat}}
{{packet list|Disconnect|disconnect}}
{{packet list|Disguised Chat Message|disguised_chat}}
{{packet list|Entity Event|entity_event}}
{{packet list|Teleport Entity|entity_position_sync}}
{{packet list|Explosion|explode}}
{{packet list|Unload Chunk|forget_level_chunk}}
{{packet list|Game Event|game_event}}
{{packet list|Game Rule Values|game_rule_values|change=added}}
{{packet list|Game Test Highlight Position|game_test_highlight_pos}}
{{packet list|Open Horse Screen|horse_screen_open|change=removed}}
{{packet list|Open Horse Screen|mount_screen_open|change=added}}
{{packet list|Hurt Animation|hurt_animation}}
{{packet list|Initialize World Border|initialize_border}}
{{packet list|Keep Alive (clientbound)|keep_alive}}
{{packet list|Chunk Data and Update Light|level_chunk_with_light}}
{{packet list|World Event|level_event}}
{{packet list|Particle|level_particles}}
{{packet list|Update Light|light_update}}
{{packet list|Login (play)|login}}
{{packet list|Low Disk Space Warning|low_disk_space_warning|change=added}}
{{packet list|Map Data|map_item_data}}
{{packet list|Merchant Offers|merchant_offers}}
{{packet list|Update Entity Position|move_entity_pos}}
{{packet list|Update Entity Position and Rotation|move_entity_pos_rot}}
{{packet list|Move Minecart Along Track|move_minecart_along_track}}
{{packet list|Update Entity Rotation|move_entity_rot}}
{{packet list|Move Vehicle (clientbound)|move_vehicle}}
{{packet list|Open Book|open_book}}
{{packet list|Open Screen|open_screen}}
{{packet list|Open Sign Editor|open_sign_editor}}
{{packet list|Ping|ping}}
{{packet list|Ping Response|pong_response}}
{{packet list|Place Ghost Recipe|place_ghost_recipe}}
{{packet list|Player Abilities (clientbound)|player_abilities}}
{{packet list|Player Chat Message|player_chat}}
{{packet list|End Combat|player_combat_end}}
{{packet list|Enter Combat|player_combat_enter}}
{{packet list|Combat Death|player_combat_kill}}
{{packet list|Player Info Remove|player_info_remove}}
{{packet list|Player Info Update|player_info_update}}
{{packet list|Look At|player_look_at}}
{{packet list|Synchronize Player Position|player_position}}
{{packet list|Player Rotation|player_rotation}}
{{packet list|Recipe Book Add|recipe_book_add}}
{{packet list|Recipe Book Remove|recipe_book_remove}}
{{packet list|Recipe Book Settings|recipe_book_settings}}
{{packet list|Remove Entities|remove_entities}}
{{packet list|Remove Entity Effect|remove_mob_effect}}
{{packet list|Reset Score|reset_score}}
{{packet list|Remove Resource Pack|resource_pack_pop}}
{{packet list|Add Resource Pack|resource_pack_push}}
{{packet list|Respawn|respawn}}
{{packet list|Set Head Rotation|rotate_head}}
{{packet list|Update Section Blocks|section_blocks_update}}
{{packet list|Select Advancements Tab|select_advancements_tab}}
{{packet list|Server Data|server_data}}
{{packet list|Set Action Bar Text|set_action_bar_text}}
{{packet list|Set Border Center|set_border_center}}
{{packet list|Set Border Lerp Size|set_border_lerp_size}}
{{packet list|Set Border Size|set_border_size}}
{{packet list|Set Border Warning Delay|set_border_warning_delay}}
{{packet list|Set Border Warning Distance|set_border_warning_distance}}
{{packet list|Set Camera|set_camera}}
{{packet list|Set Center Chunk|set_chunk_cache_center}}
{{packet list|Set Render Distance|set_chunk_cache_radius}}
{{packet list|Set Cursor Item|set_cursor_item}}
{{packet list|Set Default Spawn Position|set_default_spawn_position}}
{{packet list|Display Objective|set_display_objective}}
{{packet list|Set Entity Metadata|set_entity_data}}
{{packet list|Link Entities|set_entity_link}}
{{packet list|Set Entity Velocity|set_entity_motion}}
{{packet list|Set Equipment|set_equipment}}
{{packet list|Set Experience|set_experience}}
{{packet list|Set Health|set_health}}
{{packet list|Set Held Item (clientbound)|set_held_slot}}
{{packet list|Update Objectives|set_objective}}
{{packet list|Set Passengers|set_passengers}}
{{packet list|Set Player Inventory Slot|set_player_inventory}}
{{packet list|Update Teams|set_player_team}}
{{packet list|Update Score|set_score}}
{{packet list|Set Simulation Distance|set_simulation_distance}}
{{packet list|Set Subtitle Text|set_subtitle_text}}
{{packet list|Update Time|set_time}}
{{packet list|Set Title Text|set_title_text}}
{{packet list|Set Title Animation Times|set_titles_animation}}
{{packet list|Entity Sound Effect|sound_entity}}
{{packet list|Sound Effect|sound}}
{{packet list|Start Configuration|start_configuration}}
{{packet list|Stop Sound|stop_sound}}
{{packet list|Store Cookie|store_cookie}}
{{packet list|System Chat Message|system_chat}}
{{packet list|Set Tab List Header And Footer|tab_list}}
{{packet list|Tag Query Response|tag_query}}
{{packet list|Pickup Item|take_item_entity}}
{{packet list|Synchronize Vehicle Position|teleport_entity}}
{{packet list|Test Instance Block Status|test_instance_block_status}}
{{packet list|Set Ticking State|ticking_state}}
{{packet list|Step Tick|ticking_step}}
{{packet list|Transfer|transfer}}
{{packet list|Update Advancements|update_advancements}}
{{packet list|Update Attributes|update_attributes}}
{{packet list|Entity Effect|update_mob_effect}}
{{packet list|Update Recipes|update_recipes}}
{{packet list|Update Tags|update_tags}}
{{packet list|Projectile Power|projectile_power}}
{{packet list|Custom Report Details|custom_report_details}}
{{packet list|Server Links|server_links}}
{{packet list|Waypoint|waypoint}}
{{packet list|Clear Dialog|clear_dialog}}
{{packet list|Show Dialog|show_dialog}}
 |}
</div>
<div style="display: inline-grid">
{{packet list/begin|Play|serverbound}}
{{packet list|Confirm Teleportation|accept_teleportation}}
{{packet list|Attack|attack|change=added}}
{{packet list|Query Block Entity Tag|block_entity_tag_query}}
{{packet list|Bundle Item Selected|bundle_item_selected}}
{{packet list|Change Difficulty|change_difficulty}}
{{packet list|Change Game Mode|change_game_mode}}
{{packet list|Acknowledge Message|chat_ack}}
{{packet list|Chat Command|chat_command}}
{{packet list|Signed Chat Command|chat_command_signed}}
{{packet list|Chat Message|chat}}
{{packet list|Player Session|chat_session_update}}
{{packet list|Chunk Batch Received|chunk_batch_received}}
{{packet list|Client Status|client_command}}
{{packet list|Client Tick End|client_tick_end}}
{{packet list|Client Information|client_information}}
{{packet list|Command Suggestions Request|command_suggestion}}
{{packet list|Acknowledge Configuration|configuration_acknowledged}}
{{packet list|Click Container Button|container_button_click}}
{{packet list|Click Container|container_click}}
{{packet list|Close Container|container_close}}
{{packet list|Change Container Slot State|container_slot_state_changed}}
{{packet list|Cookie Response|cookie_response}}
{{packet list|Plugin Message (serverbound)|custom_payload}}
{{packet list|Debug Subscription Request|debug_subscription_request}}
{{packet list|Edit Book|edit_book}}
{{packet list|Query Entity Tag|entity_tag_query}}
{{packet list|Interact|interact}}
{{packet list|Jigsaw Generate|jigsaw_generate}}
{{packet list|Keep Alive (serverbound)|keep_alive}}
{{packet list|Lock Difficulty|lock_difficulty}}
{{packet list|Set Player Position|move_player_pos}}
{{packet list|Set Player Position and Rotation|move_player_pos_rot}}
{{packet list|Set Player Rotation|move_player_rot}}
{{packet list|Set Player Movement Flags|move_player_status_only}}
{{packet list|Move Vehicle (serverbound)|move_vehicle}}
{{packet list|Paddle Boat|paddle_boat}}
{{packet list|Pick Item From Block|pick_item_from_block}}
{{packet list|Pick Item From Entity|pick_item_from_entity}}
{{packet list|Ping Request|ping_request}}
{{packet list|Place Recipe|place_recipe}}
{{packet list|Player Abilities (serverbound)|player_abilities}}
{{packet list|Player Action|player_action}}
{{packet list|Player Command|player_command}}
{{packet list|Player Input|player_input}}
{{packet list|Player Loaded|player_loaded}}
{{packet list|Pong|pong}}
{{packet list|Change Recipe Book Settings|recipe_book_change_settings}}
{{packet list|Set Seen Recipe|recipe_book_seen_recipe}}
{{packet list|Rename Item|rename_item}}
{{packet list|Resource Pack Response|resource_pack}}
{{packet list|Seen Advancements|seen_advancements}}
{{packet list|Select Trade|select_trade}}
{{packet list|Set Beacon Effect|set_beacon}}
{{packet list|Set Held Item (serverbound)|set_carried_item}}
{{packet list|Program Command Block|set_command_block}}
{{packet list|Program Command Block Minecart|set_command_minecart}}
{{packet list|Set Creative Mode Slot|set_creative_mode_slot}}
{{packet list|Set Game Rules|set_game_rule|change=added}}
{{packet list|Program Jigsaw Block|set_jigsaw_block}}
{{packet list|Program Structure Block|set_structure_block}}
{{packet list|Set Test Block|set_test_block}}
{{packet list|Update Sign|sign_update}}
{{packet list|Spectator Action|spectator_action|change=added}}
{{packet list|Swing Arm|swing}}
{{packet list|Teleport To Entity|teleport_to_entity}}
{{packet list|Test Instance Block Action|test_instance_block_action}}
{{packet list|Use Item On|use_item_on}}
{{packet list|Use Item|use_item}}
{{packet list|Custom Click Action|custom_click_action}}
 |}
</div>
</div>

== Slot data ==


{| class="wikitable"
 ! Name
 ! Description
 ! style="width: 50%" | Data
 |- {{added}}
 | <code>minecraft:use_effects</code>
 | 
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Can Sprint
    | {{Type|Boolean}}
    | 
    |-
    | Interact Vibrations
    | {{Type|Boolean}}
    | 
    |-
    | Speed Multiplier
    | {{Type|Float}}
    | 
    |}
 |- {{added}}
 | <code>minecraft:minimum_attack_charge</code>
 | 
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Minimum Attack Change
    | {{Type|Float}}
    | 
    |}
 |- {{added}}
 | <code>minecraft:damage_type</code>
 | Type of damage dealt by the item in melee.
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Damage Type
    | {{Type|VarInt}}
    | ID in the <code>minecraft:damage_type</code>
    |}
 |-
 | <code>minecraft:damage_resistant</code>
 | Marks this item as damage resistant.<br>The client won't render the item as being on-fire if this component is present.
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Types
    | {{change|{{Type|Identifier}}|{{Type|ID Set}}}}
    | {{change|Tag specifying d|D}}amage types the item is immune to.{{change| Not prefixed by '#'!.|}}
    |}
 |- {{added}}
 | <code>minecraft:attack_range</code>
 | 
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Min Reach
    | {{Type|Float}}
    | 
    |-
    | Max Reach
    | {{Type|Float}}
    | 
    |-
    | Min Creative Reach
    | {{Type|Float}}
    | 
    |-
    | Max Creative Reach
    | {{Type|Float}}
    | 
    |-
    | Hitbox Margin
    | {{Type|Float}}
    | 
    |-
    | Mob Factor
    | {{Type|Float}}
    | 
    |}
 |-
 | <code>minecraft:blocks_attacks</code>
 | Makes the item act like a shield.
 | As follows:
   {| class="wikitable"
    ! colspan="2"| Name
    ! colspan="2"| Type
    ! Description
    |-
    | colspan="2"| Block delay seconds
    | colspan="2"| {{Type|Float}}
    |
    |-
    | colspan="2"| Disable cooldown scale
    | colspan="2"| {{Type|Float}}
    |
    |-
    | rowspan="4"| Damage reductions
    | Horizontal blocking angle
    | rowspan="4"| {{Type|Prefixed Array}}
    | {{Type|Float}}
    |
    |-
    | Type
    | {{Type|Prefixed Optional}} {{Type|ID Set}}
    | IDs in the <code>minecraft:damage_type</code> registry.
    |-
    | Base
    | {{Type|Float}}
    |
    |-
    | Factor
    | {{Type|Float}}
    |
    |-
    | colspan="2"| Item damage threshold
    | colspan="2"| {{Type|Float}}
    |
    |-
    | colspan="2"| Item damage base
    | colspan="2"| {{Type|Float}}
    |
    |-
    | colspan="2"| Item damage factor
    | colspan="2"| {{Type|Float}}
    |
    |-
    | colspan="2"| Bypassed by
    | colspan="2"| {{Type|Prefixed Optional}} {{change|{{Type|Identifier}}|{{Type|ID Set}}}}
    | {{change||IDs in the <code>minecraft:damage_type</code> registry.}}
    |-
    | colspan="2"| Block sound
    | colspan="2"| {{Type|Prefixed Optional}} {{Type|ID Or}} {{Type|Sound Event}}
    |
    |-
    | colspan="2"| Disable sound
    | colspan="2"| {{Type|Prefixed Optional}} {{Type|ID Or}} {{Type|Sound Event}}
    |
    |}
 |- {{added}}
 | <code>minecraft:piercing_weapon</code>
 | 
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Deals Knockback
    | {{Type|Boolean}}
    | 
    |-
    | Dismounts
    | {{Type|Boolean}}
    | 
    |-
    | Sound
    | {{Type|Optional}} {{Type|Sound Event}}
    | 
    |-
    | Hit Sound
    | {{Type|Optional}} {{Type|Sound Event}}
    | 
    |}
 |- {{added}}
 | <code>minecraft:kinetic_weapon</code>
 | 
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Contact Cooldown Ticks
    | {{Type|VarInt}}
    | 
    |-
    | Delay Ticks
    | {{Type|VarInt}}
    | 
    |-
    | Dismount Conditions
    | {{Type|Optional}} [[#Kinetic Weapon Conditions|Kinetic Weapon Conditions]]
    | 
    |-
    | Knockback Conditions
    | {{Type|Optional}} [[#Kinetic Weapon Conditions|Kinetic Weapon Conditions]]
    | 
    |-
    | Damage Conditions
    | {{Type|Optional}} [[#Kinetic Weapon Conditions|Kinetic Weapon Conditions]]
    | 
    |-
    | Forward Movement
    | {{Type|Float}}
    | 
    |-
    | Damage Multiplier
    | {{Type|Float}}
    | 
    |-
    | Sound
    | {{Type|Optional}} {{Type|Sound Event}}
    | 
    |-
    | Hit Sound
    | {{Type|Optional}} {{Type|Sound Event}}
    | 
    |}
 |- {{added}}
 | <code>minecraft:swing_animation</code>
 | 
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Type
    | {{Type|VarInt}} {{Type|Enum}}
    | 0: none, 1: whack, 2: stab
    |-
    | Duration
    | {{Type|VarInt}}
    | 
    |}
 |- {{added}}
 | <code>minecraft:additional_trade_cost</code>
 | 
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Additional Trade Cost
    | {{Type|VarInt}}
    | 
    |}
 |- {{added}}
 | <code>minecraft:dye</code>
 | Makes the item act like a dye in some contexts.
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Color
    | [[#Dye_Color|Dye Color]]
    |}
 |-
 | <code>minecraft:provides_trim_material</code>
 | Used to make an item into a valid armor trim material.
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |- {{deleted}}
    | Mode
    | {{Type|Byte}} {{Type|Enum}}
    | Defines how the following field is read, either referenced or direct.
    |- {{deleted}}
    | Material
    | Varies
    |
     {| class="wikitable"
      ! Mode
      ! Data
      ! Description
      |-
      | 0
      | {{Type|Identifier}}
      | The name of a material. 
      |-
      | 1
      | {{Type|ID or}} [[#Trim Material|Trim Material]]
      | An ID in the <code>minecraft:trim_material</code> registry or a direct trim material definition.
      |}
    |- {{added}}
    | Material
    | {{Type|ID or}} [[#Trim Material|Trim Material]]
    | An ID in the <code>minecraft:trim_material</code> registry or a direct trim material definition.
    |}
 |-
 | <code>minecraft:provides_banner_patterns</code>
 | Used to make an item into a valid banner pattern material. 
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Key
    | {{change|{{Type|Identifier}}|{{Type|ID Set}}}}
    | {{change|A pattern identifier like <code>#minecraft:pattern_item/globe</code>.|IDs in the <code>minecraft:banner_pattern</code> registry.}}
    |}
 |-
 | <code>minecraft:jukebox_playable</code>
 | The song this item will play when inserted into a jukebox.<br>{{warning|The Notchian client assumes that the server will always represent the jukebox song either by name, or reference an entry on its respective registry. Trying to directly specify a jukebox song (when <code>Jukebox Song Type</code> is 0) will cause the client to fail to parse it and subsequently disconnect, which is likely an unintended bug.}}
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |- {{deleted}}
    | Mode
    | {{Type|Byte}} {{Type|Enum}}
    | Whether the jukebox song is specified directly, or just referenced by name. This defines how the following field is read.
    |- {{deleted}}
    | Jukebox Song
    | Varies
    |
     {| class="wikitable"
      ! Mode
      ! Data
      ! Description
      |-
      | 0
      | {{Type|Identifier}}
      | The name of a jukebox song in its respective registry.
      |-
      | 1
      | {{Type|ID or}} [[#Jukebox Song|Jukebox Song]]
      | ID in the <code>minecraft:jukebox_song</code> registry or a direct jukebox song.
      |}
    |- {{added}}
    | Jukebox Song
    | {{Type|ID or}} [[#Jukebox Song|Jukebox Song]]
    | ID in the <code>minecraft:jukebox_song</code> registry or a direct jukebox song.
    |}
 |- {{added}}
 | <code>minecraft:sulfur_cube_content</code>
 | The item contained in a sulfur cube.
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Content
    | {{Type|Slot}}
    | 
    |}
 |- {{added}}
 | <code>minecraft:pig/sound_variant</code>
 | The type of sounds that a pig makes.
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Variant
    | {{Type|VarInt}}
    | An ID in the <code>minecraft:pig_sound_variant</code> registry.
    |}
 |- {{added}}
 | <code>minecraft:cow/sound_variant</code>
 | The type of sounds that a cow makes.
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Variant
    | {{Type|VarInt}}
    | An ID in the <code>minecraft:cow_sound_variant</code> registry.
    |}
 |-
 | <code>minecraft:chicken/variant</code>
 | The variant of a chicken.
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |- {{deleted}}
    | Mode
    | {{Type|Byte}} {{Type|Enum}}
    | Defines how the following field is read.
    |- {{deleted}}
    | Variant
    | Varies
    |
     {| class="wikitable"
      ! Mode
      ! Data
      ! Description
      |-
      | 0
      | {{Type|Identifier}}
      | The name of a chicken variant.
      |-
      | 1
      | {{Type|VarInt}}
      | An ID in the <code>minecraft:chicken_variant</code> registry.
      |}
    |- {{added}}
    | Variant
    | {{Type|VarInt}}
    | An ID in the <code>minecraft:chicken_variant</code> registry.
    |}
 |- {{added}}
 | <code>minecraft:chicken/sound_variant</code>
 | The type of sounds that a chicken makes.
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Variant
    | {{Type|VarInt}}
    | An ID in the <code>minecraft:chicken_sound_variant</code> registry.
    |}
 |- {{added}}
 | <code>minecraft:zombie_nautilus/variant</code>
 | The variant of a zombie nautilus.
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Variant
    | {{Type|VarInt}}
    | An ID in the <code>minecraft:zombie_nautilus_variant</code> registry.
    |}
 |- {{added}}
 | <code>minecraft:cat/sound_variant</code>
 | The type of sounds that a cat makes.
 | As follows:
   {| class="wikitable"
    ! Name
    ! Type
    ! Description
    |-
    | Variant
    | {{Type|VarInt}}
    | An ID in the <code>minecraft:cat_sound_variant</code> registry.
    |}
 |}

=== Kinetic Weapon Conditions ===

{| class="wikitable"
 ! Name
 ! Type
 ! Description
 |-
 | Max Duration Ticks
 | {{Type|VarInt}}
 | 
 |-
 | Min Speed
 | {{Type|Float}}
 | 
 |-
 | Min Relative Speed
 | {{Type|Float}}
 | 
 |}

== Login ==

=== Clientbound ===

==== Login Success ====

{| class="wikitable"
 ! colspan="3"| {{packet header|clientbound|Login Success}}
 |-
 ! Field Name
 ! Field Type
 ! Notes
 |-
 | Profile
 | {{Type|Game Profile}}
 | 
 |- {{added}}
 | Session ID
 | {{Type|UUID}}
 | 
 |}

== Recipes ==

=== Slot Display structure ===

{| class="wikitable"
 ! Name
 ! Type
 ! Description
 |-
 | Slot Display Type
 | {{Type|VarInt}}
 | ID in the <code>minecraft:slot_display</code> registry.
 |-
 | Data
 | Varies
 | See [[#Slot Display types]] below.
 |}

==== Slot Display types ====

{| class="wikitable"
 ! Name
 ! Data
 |-
 | <code>minecraft:empty</code>
 | no data
 |-
 | <code>minecraft:any_fuel</code>
 | no data
 |- {{added}}
 | <code>minecraft:with_any_potion</code>
 | [[#minecraft:with_any_potion|data]]
 |- {{added}}
 | <code>minecraft:only_with_component</code>
 | [[#minecraft:only_with_component|data]]
 |-
 | <code>minecraft:item</code>
 | [[#minecraft:item|data]]
 |-
 | <code>minecraft:item_stack</code>
 | [[#minecraft:item_stack|data]]
 |-
 | <code>minecraft:tag</code>
 | [[#minecraft:tag|data]]
 |- {{added}}
 | <code>minecraft:dyed</code>
 | [[#minecraft:dye|data]]
 |-
 | <code>minecraft:smithing_trim</code>
 | [[#minecraft:smithing_trim|data]]
 |-
 | <code>minecraft:with_remainder</code>
 | [[#minecraft:with_remainder|data]]
 |-
 | <code>minecraft:composite</code>
 | [[#minecraft:composite|data]]
 |}

==== <code>minecraft:with_any_potion</code> ====

{| class="wikitable"
 ! Name
 ! Type
 ! Description
 |-
 | Base
 | {{Type|Slot Display}}
 |
 |}

==== <code>minecraft:only_with_component</code> ====

{| class="wikitable"
 ! Name
 ! Type
 ! Description
 |-
 | Base
 | {{Type|Slot Display}}
 |
 |-
 | Component Type ID
 | {{Type|VarInt}}
 | 
 |}

==== <code>minecraft:dyed</code> ====

{| class="wikitable"
 ! Name
 ! Type
 ! Description
 |-
 | Dye
 | {{Type|Slot Display}}
 |
 |-
 | Target
 | {{Type|Slot Display}}
 | 
 |}

== Play ==

=== Clientbound ===

==== Game Rule Values ====

{| class="wikitable"
 ! colspan="5"| {{packet header|clientbound|Game Rule Values}}
 |-
 ! colspan="2"| Field Name
 ! colspan="2"| Field Type
 ! Notes
 |-
 | rowspan="2"| Rules
 | Name
 | rowspan="2"| {{Type|Prefixed Array}}
 | {{Type|Identifier}}
 | 
 |-
 | Value
 | {{Type|String}} (32767)
 | 
 |}

==== Login (play) ====

See [[Minecraft:protocol encryption]] for information on logging in.

{| class="wikitable"
 ! colspan="3"| {{packet header|clientbound|Login (play)}}
 |-
 ! Field Name
 ! Field Type
 ! Notes
 |-
 | Entity ID
 | {{Type|Int}}
 | The player's Entity ID (EID).
 |-
 | Is hardcore
 | {{Type|Boolean}}
 |
 |-
 | Dimension Names
 | {{Type|Prefixed Array}} of {{Type|Identifier}}
 | Identifiers for all dimensions on the server.
 |-
 | Max Players
 | {{Type|VarInt}}
 | Was once used by the client to draw the tab list, but now it is ignored.
 |-
 | View Distance
 | {{Type|VarInt}}
 | Render distance (2-32).
 |-
 | Simulation Distance
 | {{Type|VarInt}}
 | Server simulation distance. See {{packet|Set Simulation Distance}}.
 |-
 | Reduced Debug Info
 | {{Type|Boolean}}
 | If true, a vanilla client shows reduced information on the [[Minecraft:debug screen]].  For servers in development, this should almost always be false.
 |-
 | Enable respawn screen
 | {{Type|Boolean}}
 | Set to false when the doImmediateRespawn gamerule is true.
 |-
 | Do limited crafting
 | {{Type|Boolean}}
 | Whether players can only craft recipes they have already unlocked. Currently unused by the client.
 |-
 | Dimension Type
 | {{Type|VarInt}}
 | The ID of the type of dimension in the <code>minecraft:dimension_type</code> registry, defined by the Registry Data packet.
 |-
 | Dimension Name
 | {{Type|Identifier}}
 | Name of the dimension being spawned into.
 |-
 | Hashed seed
 | {{Type|Long}}
 | First 8 bytes of the SHA-256 hash of the world's seed. Used client-side for biome noise 
 |-
 | Game mode
 | {{Type|Unsigned Byte}}
 | 0: Survival, 1: Creative, 2: Adventure, 3: Spectator.
 |-
 | Previous Game mode
 | {{Type|Byte}}
 | -1: Undefined (null), 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. The previous game mode. Vanilla client uses this for the debug (F3 + N & F3 + F4) game mode switch. (More information needed)
 |-
 | Is Debug
 | {{Type|Boolean}}
 | True if the world is a [[Minecraft:debug mode]] world; debug mode worlds cannot be modified and have predefined blocks.
 |-
 | Is Flat
 | {{Type|Boolean}}
 | True if the world is a [[Minecraft:superflat]] world; flat worlds have different void fog and a horizon at y=0 instead of y=63.
 |-
 | Has death location
 | {{Type|Boolean}}
 | If true, then the next two fields are present.
 |-
 | Death dimension name
 | {{Type|Optional}} {{Type|Identifier}}
 | Name of the dimension the player died in.
 |-
 | Death location
 | {{Type|Optional}} {{Type|Position}}
 | The location that the player died at.
 |-
 | Portal cooldown
 | {{Type|VarInt}}
 | The number of ticks until the player can use the last used portal again. Looks like it's an attempt to fix MC-180.
 |-
 | Sea level
 | {{Type|VarInt}}
 |
 |- {{added}}
 | Online mode
 | {{Type|Boolean}}
 | 
 |-
 | Enforces Secure Chat
 | {{Type|Boolean}}
 |
 |}

==== Low Disk Space Warning ====

{| class="wikitable"
 ! colspan="3"| {{packet header|clientbound|Low Disk Space Warning}}
 |-
 ! Field Name
 ! Field Type
 ! Notes
 |-
 | colspan="3"| ''no fields''
 |}

==== Update Teams ====

Creates and updates teams.

{| class="wikitable"
 ! colspan="5"| {{packet header|clientbound|Update Teams}}
 |-
 ! colspan="2"| Field Name
 ! Field Type
 ! Notes
 |-
 | colspan="2"| Team Name
 | {{Type|String}} (32767)
 | A unique name for the team. (Shared with scoreboard).
 |-
 | colspan="2"| Method
 | {{Type|Byte}}
 | Determines the layout of the remaining packet.
 |-
 | rowspan="11"| 0: create team
 | Team Display Name
 | {{Type|Text Component}}
 |
 |- {{deleted}}
 | Friendly Flags
 | {{Type|Byte}}
 | Bit mask. 0x01: Allow friendly fire, 0x02: can see invisible players on the same team.
 |- {{added}}
 | Team Prefix
 | {{Type|Text Component}}
 | Displayed before the names of players that are part of this team.
 |- {{added}}
 | Team Suffix
 | {{Type|Text Component}}
 | Displayed after the names of players that are part of this team.
 |-
 | Name Tag Visibility
 | {{Type|VarInt}} {{Type|Enum}}
 | 0 = ALWAYS, 1 = NEVER, 2 = HIDE_FOR_OTHER_TEAMS, 3 = HIDE_FOR_OWN_TEAMS
 |-
 | Collision Rule
 | {{Type|VarInt}} {{Type|Enum}}
 | 0 = ALWAYS, 1 = NEVER, 2 = PUSH_OTHER_TEAMS, 3 = PUSH_OWN_TEAM
 |-
 | Team Color
 | {{Type|VarInt}} {{Type|Enum}}
 | Used to color the names of players on the team; see below.
 |- {{added}}
 | Friendly Flags
 | {{Type|Byte}}
 | Bit mask. 0x01: Allow friendly fire, 0x02: can see invisible players on the same team.
 |- {{deleted}}
 | Team Prefix
 | {{Type|Text Component}}
 | Displayed before the names of players that are part of this team.
 |- {{deleted}}
 | Team Suffix
 | {{Type|Text Component}}
 | Displayed after the names of players that are part of this team.
 |-
 | Entities
 | {{Type|Prefixed Array}} of {{Type|String}} (32767)
 | Identifiers for the entities in this team.  For players, this is their username; for other entities, it is their UUID.
 |-
 | 1: remove team
 | ''no fields''
 | ''no fields''
 |
 |-
 | rowspan="10"| 2: update team info
 | Team Display Name
 | {{Type|Text Component}}
 |
 |- {{deleted}}
 | Friendly Flags
 | {{Type|Byte}}
 | Bit mask. 0x01: Allow friendly fire, 0x02: can see invisible entities on the same team.
 |- {{added}}
 | Team Prefix
 | {{Type|Text Component}}
 | Displayed before the names of players that are part of this team.
 |- {{added}}
 | Team Suffix
 | {{Type|Text Component}}
 | Displayed after the names of players that are part of this team.
 |-
 | Name Tag Visibility
 | {{Type|VarInt}} {{Type|Enum}}
 | 0 = ALWAYS, 1 = NEVER, 2 = HIDE_FOR_OTHER_TEAMS, 3 = HIDE_FOR_OWN_TEAMS
 |-
 | Collision Rule
 | {{Type|VarInt}} {{Type|Enum}}
 | 0 = ALWAYS, 1 = NEVER, 2 = PUSH_OTHER_TEAMS, 3 = PUSH_OWN_TEAM
 |-
 | Team Color
 | {{Type|VarInt}} {{Type|Enum}}
 | Used to color the names of players on the team; see below.
 |- {{added}}
 | Friendly Flags
 | {{Type|Byte}}
 | Bit mask. 0x01: Allow friendly fire, 0x02: can see invisible players on the same team.
 |- {{deleted}}
 | Team Prefix
 | {{Type|Text Component}}
 | Displayed before the names of players that are part of this team.
 |- {{deleted}}
 | Team Suffix
 | {{Type|Text Component}}
 | Displayed after the names of players that are part of this team.
 |-
 | 3: add entities to team
 | Entities
 | {{Type|Prefixed Array}} of {{Type|String}} (32767)
 | Identifiers for the added entities.  For players, this is their username; for other entities, it is their UUID.
 |-
 | 4: remove entities from team
 | Entities
 | {{Type|Prefixed Array}} of {{Type|String}} (32767)
 | Identifiers for the removed entities.  For players, this is their username; for other entities, it is their UUID.
 |}

Team Color: The color of a team defines how the names of the team members are visualized; any formatting code can be used. The following table lists all the possible values.

{| class="wikitable"
 ! ID
 ! Formatting
 |-
 | 0-15
 | Color formatting, same values as in [[Minecraft:Formatting codes#Color codes]].
 |-
 | 16
 | Obfuscated
 |-
 | 17
 | Bold
 |-
 | 18
 | Strikethrough
 |-
 | 19
 | Underlined
 |-
 | 20
 | Italic
 |-
 | 21
 | Reset
 |}

==== Update Time ====

Time is based on ticks, where 20 ticks happen every second. There are 24000 ticks in a day, making Minecraft days exactly 20 minutes long.

The time of day is based on the timestamp modulo 24000. 0 is sunrise, 6000 is noon, 12000 is sunset, and 18000 is midnight.

The default SMP server increments the time by <code>20</code> every second.

{| class="wikitable"
 ! colspan="5"| {{packet header|clientbound|Update Time}}
 |-
 ! colspan="2"| Field Name
 ! colspan="2"| Field Type
 ! Notes
 |-
 | colspan="2"| World Age
 | colspan="2"| {{Type|Long}}
 | In ticks; not changed by server commands.
 |- {{deleted}}
 | colspan="2"| Time of day
 | colspan="2"| {{Type|Long}}
 | The world (or region) time, in ticks.
 |- {{deleted}}
 | colspan="2"| Time of day increasing
 | colspan="2"| {{Type|Boolean}}
 | If true, the client should automatically advance the time of day according to its ticking rate.
 |- {{added}}
 | rowspan="4"| Clocks
 | Clock ID
 | rowspan="4"| {{Type|Prefixed Array}}
 | {{Type|VarInt}}
 | ID in the <code>minecraft:world_clock</code> registry.
 |- {{added}}
 | Time
 | {{Type|Long}}
 | Current time of the clock, in ticks.
 |- {{added}}
 | Fractional time
 | {{Type|Float}}
 | Fractional part of the time in ticks, normally a nonnegative number less than 1.
 |- {{added}}
 | Rate
 | {{Type|Float}}
 | Rate at which the client should automatically advance the time of the clock, in clock ticks per client tick.
 |}

=== Serverbound ===

==== Attack ====

This packet is sent from the client to the server when the client attacks another entity (a player, minecart, etc).

A vanilla server only accepts this packet if the entity being attacked is visible without obstruction and within a 4-unit radius of the player's position.

{| class="wikitable"
 ! colspan="3"| {{packet header|serverbound|Attack}}
 |-
 ! Field Name
 ! Field Type
 ! Notes
 |-
 | Entity ID
 | {{Type|VarInt}}
 | The ID of the attacked entity. Note the special case of the ender dragon described on the {{packet|Interact}} packet.
 |}

==== Client Status ====

{| class="wikitable"
 ! colspan="3"| {{packet header|serverbound|Client Status}}
 |-
 ! Field Name
 ! Field Type
 ! Notes
 |-
 | Action ID
 | {{Type|VarInt}} {{Type|Enum}}
 | See below
 |}

''Action ID'' values:

{| class="wikitable"
 |-
 ! Action ID
 ! Action
 ! Notes
 |-
 | 0
 | Perform respawn
 | Sent when the client is ready to respawn after death.
 |-
 | 1
 | Request stats
 | Sent when the client opens the Statistics menu.
 |- {{added}}
 | 2
 | Request game rule values
 | Sent when the client opens the Edit Game Rules menu.
 |}

==== Interact ====

This packet is sent from the client to the server when the client {{change|attacks or |}}right-clicks another entity (a player, minecart, etc).

A vanilla server only accepts this packet if the entity being {{change|attacked/|}}used is visible without obstruction and within a 4-unit radius of the player's position.

The target {{change|X, Y, and Z fields|offset field}} represent{{change||s}} the difference between the vector location of the cursor at the time of the packet and the entity's position.

Note that middle-click in creative mode is interpreted by the client and sent as a {{packet|Set Creative Mode Slot}} packet instead.

{| class="wikitable"
 ! colspan="3"| {{packet header|serverbound|Interact}}
 |-
 ! Field Name
 ! Field Type
 ! Notes
 |-
 | Entity ID
 | {{Type|VarInt}}
 | The ID of the entity to interact. Note the special case described below.
 |- {{deleted}}
 | Type
 | {{Type|VarInt}} {{Type|Enum}}
 | 0: interact, 1: attack, 2: interact at.
 |- {{deleted}}
 | Target X
 | {{Type|Optional}} {{Type|Float}}
 | Only if Type is interact at.
 |- {{deleted}}
 | Target Y
 | {{Type|Optional}} {{Type|Float}}
 | Only if Type is interact at.
 |- {{deleted}}
 | Target Z
 | {{Type|Optional}} {{Type|Float}}
 | Only if Type is interact at.
 |-
 | Hand
 | {{change|{{Type|Optional}}|}} {{Type|VarInt}} {{Type|Enum}}
 | Only if Type is interact or interact at; 0: main hand, 1: off hand.
 |- {{added}}
 | Target offset
 | {{Type|LpVec3}}
 | 
 |-
 | Sneak Key Pressed
 | {{Type|Boolean}}
 | If the client is pressing the sneak key. Has the same effect as a Player Command Press/Release sneak key preceding the interaction, and the state is permanently changed.
 |}

Interaction with the ender dragon is an odd special case characteristic of release deadline&ndash;driven design. 8 consecutive entity IDs following the dragon's ID (<var>id</var> + 1, <var>id</var> + 2, ..., <var>id</var> + 8) are reserved for the 8 hitboxes that make up the dragon:

{| class="wikitable"
 ! ID offset
 ! Description
 |-
 | 0
 | The dragon itself (never used in this packet)
 |-
 | 1
 | Head
 |-
 | 2
 | Neck
 |-
 | 3
 | Body
 |-
 | 4
 | Tail 1
 |-
 | 5
 | Tail 2
 |-
 | 6
 | Tail 3
 |-
 | 7
 | Wing 1
 |-
 | 8
 | Wing 2
 |}

==== Player Action ====

Sent when the player mines a block. A vanilla server only accepts digging packets with coordinates within a 6-unit radius between the center of the block and the player's eyes.

{| class="wikitable"
 ! colspan="3"| {{packet header|serverbound|Player Action}}
 |-
 ! Field Name
 ! Field Type
 ! Notes
 |-
 | Status
 | {{Type|VarInt}} {{Type|Enum}}
 | The action the player is taking against the block (see below).
 |-
 | Location
 | {{Type|Position}}
 | Block position.
 |-
 | Face
 | {{Type|Byte}} {{Type|Enum}}
 | The face being hit (see below).
 |-
 | Sequence
 | {{Type|VarInt}}
 | Block change sequence number (see [[#Acknowledge Block Change]]).
 |}

Status can be one of seven values:

{| class="wikitable"
 ! Value
 ! Meaning
 ! Notes
 |-
 | 0
 | Started digging
 | Sent when the player starts digging a block. If the block was instamined or the player is in creative mode, the client will ''not'' send Status = Finished digging, and will assume the server completed the destruction. To detect this, it is necessary to [[Minecraft:Breaking#Speed|calculate the block destruction speed]] server-side.
 |-
 | 1
 | Cancelled digging
 | Sent when the player lets go of the Mine Block key (default: left click). Face is always set to -Y.
 |-
 | 2
 | Finished digging
 | Sent when the client thinks it is finished.
 |-
 | 3
 | Drop item stack
 | Triggered by using the Drop Item key (default: Q) with the modifier to drop the entire selected stack (default: Control or Command, depending on OS). Location is always set to 0/0/0, Face is always set to -Y. Sequence is always set to 0.
 |-
 | 4
 | Drop item
 | Triggered by using the Drop Item key (default: Q). Location is always set to 0/0/0, Face is always set to -Y. Sequence is always set to 0.
 |-
 | 5
 | Shoot arrow / finish eating
 | Indicates that the currently held item should have its state updated, such as eating food, pulling back bows, using buckets, etc. Location is always set to 0/0/0, Face is always set to -Y. Sequence is always set to 0.
 |-
 | 6
 | Swap item in hand
 | Used to swap or assign an item to the second hand. Location is always set to 0/0/0, Face is always set to -Y. Sequence is always set to 0.
 |- {{added}}
 | 7
 | Stab
 | 
 |}

The Face field can be one of the following values, representing the face being hit:

{| class="wikitable"
 |-
 ! Value
 ! Offset
 ! Face
 |-
 | 0
 | -Y
 | Bottom
 |-
 | 1
 | +Y
 | Top
 |-
 | 2
 | -Z
 | North
 |-
 | 3
 | +Z
 | South
 |-
 | 4
 | -X
 | West
 |-
 | 5
 | +X
 | East
 |}

==== Set Game Rules ====

{| class="wikitable"
 ! colspan="5"| {{packet header|serverbound|Set Game Rules}}
 |-
 ! colspan="2"| Field Name
 ! colspan="2"| Field Type
 ! Notes
 |-
 | rowspan="2"| Rules
 | Name
 | rowspan="2"| {{Type|Prefixed Array}}
 | {{Type|Identifier}}
 | 
 |-
 | Value
 | {{Type|String}} (32767)
 | 
 |}

==== Spectator Action ====

Sent when the player left-clicks in spectator mode.

{| class="wikitable"
 ! colspan="3"| {{packet header|serverbound|Spectator Action}}
 |-
 ! Field Name
 ! Field Type
 ! Notes
 |-
 | Entity ID
 | {{Type|VarInt}}
 | If 0, the player was not targeting an entity. Otherwise the ID of the targeted entity plus 1.
 |}

[[Category:Java Edition protocol]]
{{license wiki.vg}}