|
|
| (43 intermediate revisions by 6 users not shown) |
| Line 1: |
Line 1: |
| − | This page documents the changes from the [[Protocol|last stable Minecraft release]] (currently [[Protocol version numbers|1.20.2, protocol 764]]) to the current pre-release (currently [[Protocol version numbers|23w42a, protocol {{Snapshot PVN|1073741981}}]]). Note that this page contains bleeding-edge information that may not be completely or correctly documented.
| + | There are currently no pre-release versions available to document on this page. For the latest stable Minecraft release, see the [[Protocol|Protocol]] page. For previous pre-release pages, see the [[Protocol version numbers|Protocol version numbers]] page. |
| | | | |
| | One who wishes to commandeer the merging of this into [[Protocol]] when an update is made must be sure to respect any changes that may have occurred to the respective packets there. | | One who wishes to commandeer the merging of this into [[Protocol]] when an update is made must be sure to respect any changes that may have occurred to the respective packets there. |
| Line 9: |
Line 9: |
| | === Data types === | | === Data types === |
| | | | |
| − | ==== NBT ====
| + | No changes so far. |
| − | | |
| − | The NBT specification was changed so that the root tag is no longer required to be a [[NBT#Specification:compound_tag|Compound Tag]] when sent over the network.
| |
| − | | |
| − | Presently in the pre-release, only [[NBT#Specification:compound_tag|Compound Tag]] and [[NBT#Specification:string_tag|String Tag]] types are used as root, but the Notchian server/client implementation is able to handle [[NBT#Specification|NBT Tags]] of any type.
| |
| − | | |
| − | ==== Chat ====
| |
| − | | |
| − | The [[Chat]] type is now serialized as a [[NBT#Specification|NBT Tag]] instead of a JSON String, unless explicitly stated otherwise.
| |
| − | | |
| − | {| class="wikitable"
| |
| − | |-
| |
| − | ! Name
| |
| − | ! Size (bytes)
| |
| − | ! Encodes
| |
| − | ! Notes
| |
| − | |- {{removed}}
| |
| − | ! id=Definitions:chat | [[#Definitions:chat|Chat]]
| |
| − | | ≥ 1 <br />≤ (262144×4) + 3
| |
| − | | See [[Chat]]
| |
| − | | Encoded as a String with max length of 262144.
| |
| − | |- {{added}}
| |
| − | ! id=Definitions:chat | [[#Definitions:chat|Chat]]
| |
| − | | Varies
| |
| − | | See [[Chat]]
| |
| − | | Encoded as a [[NBT|NBT Tag]], with the type of tag used depending on the case:
| |
| − | * As a [[NBT#Specification:string_tag|String Tag]]: For components only containing text (no styling, no events etc.).
| |
| − | * As a [[NBT#Specification:compound_tag|Compound Tag]]: Every other case.
| |
| − | |}
| |
| − | | |
| − | This affects the following packets and data types containing Chat fields:
| |
| − | * [[Protocol#Disconnect (configuration)|Disconnect (configuration)]]
| |
| − | * [[Protocol#Resource Pack (configuration)|Resource Pack (configuration)]]
| |
| − | * [[Protocol#Boss Bar|Boss Bar]]
| |
| − | * [[Protocol#Command Suggestions Response|Command Suggestions Response]]
| |
| − | * [[Protocol#Disconnect (play)|Disconnect (play)]]
| |
| − | * [[Protocol#Disguised Chat Message|Disguised Chat Message]]
| |
| − | * [[Protocol#Map Data|Map Data]]
| |
| − | * [[Protocol#Open Screen|Open Screen]]
| |
| − | * [[Protocol#Player Chat Message|Player Chat Message]]
| |
| − | * [[Protocol#Combat Death|Combat Death]]
| |
| − | * [[Protocol#Player Info Update|Player Info Update]]
| |
| − | * [[Protocol#Resource Pack (play)|Resource Pack (play)]]
| |
| − | * [[Protocol#Server Data|Server Data]]
| |
| − | * [[Protocol#Set Action Bar Text|Set Action Bar Text]]
| |
| − | * [[Protocol#Update Objectives|Update Objectives]]
| |
| − | * [[Protocol#Update Teams|Update Teams]]
| |
| − | * [[Protocol#Set Subtitle Text|Set Subtitle Text]]
| |
| − | * [[Protocol#Set Title Text|Set Title Text]]
| |
| − | * [[Protocol#System Chat Message|System Chat Message]]
| |
| − | * [[Protocol#Set Tab List Header And Footer|Set Tab List Header And Footer]]
| |
| − | * [[Protocol#Update Advancements|Update Advancements]]
| |
| − | <br>
| |
| − | * [[Slot|Slot data type (values in the item NBT field)]]
| |
| − | * [[Entity_metadata#Entity_Metadata_Format|Chat entity metadata type]]
| |
| − | * [[Entity_metadata#Entity_Metadata_Format|OptChat entity metadata type]]
| |
| − | <br>
| |
| − | This '''does not''' affect the following packets and data types containing Chat fields:
| |
| − | * [[Protocol#Disconnect (login)|Disconnect (login)]]
| |
| | | | |
| | === Packets === | | === Packets === |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! ID
| |
| − | ! Packet name
| |
| − | !colspan="2"| Documentation
| |
| − | |-
| |
| − | !colspan="4"| Configuration clientbound
| |
| − | {{PacketList|0x07|Feature Flags}}
| |
| − | |-
| |
| − | !colspan="4"| Play clientbound
| |
| − | {{PacketList|0x20|Game Event}}
| |
| − | |-
| |
| − | !colspan="4"| Play serverbound
| |
| − | {{PacketList|0x0F|Change Container Slot State|rel=added}}
| |
| − | {{PacketList|{{change|0x0F|0x10}}|Serverbound Plugin Message (play)|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x10|0x11}}|Edit Book|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x11|0x12}}|Query Entity Tag|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x12|0x13}}|Interact|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x13|0x14}}|Jigsaw Generate|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x14|0x15}}|Serverbound Keep Alive (play)|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x15|0x16}}|Lock Difficulty|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x16|0x17}}|Set Player Position|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x17|0x18}}|Set Player Position and Rotation|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x18|0x19}}|Set Player Rotation|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x19|0x1A}}|Set Player On Ground|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x1A|0x1B}}|Move Vehicle|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x1B|0x1C}}|Paddle Boat|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x1C|0x1D}}|Pick Item|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x1D|0x1E}}|Ping Request (play)|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x1E|0x1F}}|Place Recipe|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x1F|0x20}}|Player Abilities|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x20|0x21}}|Player Action|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x21|0x22}}|Player Command|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x22|0x23}}|Player Input|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x23|0x24}}|Pong (play)|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x24|0x25}}|Change Recipe Book Settings|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x25|0x26}}|Set Seen Recipe|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x26|0x27}}|Rename Item|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x27|0x28}}|Resource Pack Response (play)|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x28|0x29}}|Seen Advancements|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x29|0x2A}}|Select Trade|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x2A|0x2B}}|Set Beacon Effect|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x2B|0x2C}}|Set Held Item|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x2C|0x2D}}|Program Command Block|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x2D|0x2E}}|Program Command Block Minecart|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x2E|0x2F}}|Set Creative Mode Slot|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x2F|0x30}}|Program Jigsaw Block|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x30|0x31}}|Program Structure Block|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x31|0x32}}|Update Sign|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x32|0x33}}|Swing Arm|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x33|0x34}}|Teleport To Entity|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x34|0x35}}|Use Item On|pre=unchanged}}
| |
| − | {{PacketList|{{change|0x35|0x36}}|Use Item|pre=unchanged}}
| |
| − | |}
| |
| − |
| |
| − | == New/modified data types ==
| |
| − |
| |
| − | No changes so far.
| |
| − |
| |
| − | == Entity Metadata ==
| |
| − |
| |
| − | === Abstract Vehicle ===
| |
| − |
| |
| − | {{Metadata inherit|Abstract Vehicle|inherits=Entity|start_at=8}}
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Index
| |
| − | ! Type
| |
| − | !style="width: 250px;" colspan="2"| Meaning
| |
| − | ! Default
| |
| − | |- {{added}}
| |
| − | | {{Metadata id|}}
| |
| − | | VarInt
| |
| − | |colspan="2"| Shaking power
| |
| − | | 0
| |
| − | |- {{added}}
| |
| − | | {{Metadata id|}}
| |
| − | | VarInt
| |
| − | |colspan="2"| Shaking direction
| |
| − | | 1
| |
| − | |- {{added}}
| |
| − | | {{Metadata id|}}
| |
| − | | Float
| |
| − | |colspan="2"| Shaking multiplier
| |
| − | | 0.0
| |
| − | |-
| |
| − | |}
| |
| − |
| |
| − | === Abstract Minecart===
| |
| − |
| |
| − | {{Metadata inherit|Abstract Minecart|inherits=Abstract Vehicle}}
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Index
| |
| − | ! Type
| |
| − | !style="width: 250px;" colspan="2"| Meaning
| |
| − | ! Default
| |
| − | |- {{removed}}
| |
| − | | 8
| |
| − | | VarInt
| |
| − | |colspan="2"| Shaking power
| |
| − | | 0
| |
| − | |- {{removed}}
| |
| − | | 9
| |
| − | | VarInt
| |
| − | |colspan="2"| Shaking direction
| |
| − | | 1
| |
| − | |- {{removed}}
| |
| − | | 10
| |
| − | | Float
| |
| − | |colspan="2"| Shaking multiplier
| |
| − | | 0.0
| |
| − | |-
| |
| − | | 11
| |
| − | | VarInt
| |
| − | |colspan="2"| Custom block ID and damage
| |
| − | | 0
| |
| − | |-
| |
| − | | 12
| |
| − | | VarInt
| |
| − | |colspan="2"| Custom block Y position (in 16ths of a block)
| |
| − | | 6
| |
| − | |-
| |
| − | | 13
| |
| − | | Boolean
| |
| − | |colspan="2"| Show custom block
| |
| − | | false
| |
| − | |}
| |
| − |
| |
| − | === Boat ===
| |
| − |
| |
| − | {{Metadata inherit|Boat|inherits=Abstract Vehicle}}
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Index
| |
| − | ! Type
| |
| − | !style="width: 250px;" colspan="2"| Meaning
| |
| − | ! Default
| |
| − | |- {{removed}}
| |
| − | | 8
| |
| − | | VarInt
| |
| − | |colspan="2"| Time since last hit
| |
| − | | 0
| |
| − | |- {{removed}}
| |
| − | | 9
| |
| − | | VarInt
| |
| − | |colspan="2"| Forward direction
| |
| − | | 1
| |
| − | |- {{removed}}
| |
| − | | 10
| |
| − | | Float
| |
| − | |colspan="2"| Damage taken
| |
| − | | 0.0
| |
| − | |-
| |
| − | | 11
| |
| − | | VarInt
| |
| − | |colspan="2"| Type (0=oak, 1=spruce, 2=birch, 3=jungle, 4=acacia, 5=dark oak)
| |
| − | | 0
| |
| − | |-
| |
| − | | 12
| |
| − | | Boolean
| |
| − | |colspan="2"| Is left paddle turning
| |
| − | | false
| |
| − | |-
| |
| − | | 13
| |
| − | | Boolean
| |
| − | |colspan="2"| Is right paddle turning
| |
| − | | false
| |
| − | |-
| |
| − | | 14
| |
| − | | VarInt
| |
| − | |colspan="2"| Splash timer
| |
| − | | 0
| |
| − | |}
| |
| − |
| |
| − | == Block Actions ==
| |
| − |
| |
| − | No changes so far.
| |
| − |
| |
| − | == Inventories ==
| |
| − |
| |
| − | No changes so far.
| |
| − |
| |
| − | == Plugin Channels ==
| |
| − |
| |
| − | No changes so far.
| |
| − |
| |
| − | == Status ==
| |
| − |
| |
| − | === Clientbound ===
| |
| | | | |
| | No changes so far. | | No changes so far. |
| − |
| |
| − | === Serverbound ===
| |
| − |
| |
| − | No changes so far.
| |
| − |
| |
| − | == Login ==
| |
| − |
| |
| − | === Clientbound ===
| |
| − |
| |
| − | No changes so far.
| |
| − |
| |
| − | === Serverbound ===
| |
| − |
| |
| − | No changes so far.
| |
| − |
| |
| − | == Configuration ==
| |
| − |
| |
| − | === Clientbound ===
| |
| − |
| |
| − | ==== Feature Flags ====
| |
| − |
| |
| − | Used to enable and disable features, generally experimental ones, on the client.
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Packet ID
| |
| − | ! State
| |
| − | ! Bound To
| |
| − | ! Field Name
| |
| − | ! Field Type
| |
| − | ! Notes
| |
| − | |-
| |
| − | | rowspan="2"| 0x07
| |
| − | | rowspan="2"| Configuration
| |
| − | | rowspan="2"| Client
| |
| − | | Total Features
| |
| − | | VarInt
| |
| − | | Number of features that appear in the array below.
| |
| − | |-
| |
| − | | Feature Flags
| |
| − | | Identifier Array
| |
| − | |
| |
| − | |}
| |
| − |
| |
| − | As of {{change|1.20.2|1.20.3}}, the following feature flags are available:
| |
| − |
| |
| − | * minecraft:vanilla - enables vanilla features</li>
| |
| − | * minecraft:bundle - enables support for the bundle</li>
| |
| − | * minecraft:trade_rebalance - enables support for the rebalanced villager trades</li>
| |
| − | * {{change||minecraft:update_1_21 - enables support for 1.21 features}}</li>
| |
| − |
| |
| − | === Serverbound ===
| |
| − |
| |
| − | No changes so far.
| |
| − |
| |
| − | == Play ==
| |
| − |
| |
| − | === Clientbound ===
| |
| − |
| |
| − | ==== Game Event ====
| |
| − |
| |
| − | Used for a wide variety of game events, from weather to bed use to game mode to demo messages.
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Packet ID
| |
| − | ! State
| |
| − | ! Bound To
| |
| − | ! Field Name
| |
| − | ! Field Type
| |
| − | ! Notes
| |
| − | |-
| |
| − | | rowspan="2"| 0x20
| |
| − | | rowspan="2"| Play
| |
| − | | rowspan="2"| Client
| |
| − | | Event
| |
| − | | Unsigned Byte
| |
| − | | See below.
| |
| − | |-
| |
| − | | Value
| |
| − | | Float
| |
| − | | Depends on Event.
| |
| − | |}
| |
| − |
| |
| − | ''Events'':
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Event
| |
| − | ! Effect
| |
| − | ! Value
| |
| − | |-
| |
| − | | 0
| |
| − | | No respawn block available
| |
| − | | Note: Displays message 'block.minecraft.spawn.not_valid' (You have no home bed or charged respawn anchor, or it was obstructed) to the player.
| |
| − | |-
| |
| − | | 1
| |
| − | | Begin raining
| |
| − | |
| |
| − | |-
| |
| − | | 2
| |
| − | | End raining
| |
| − | |
| |
| − | |-
| |
| − | | 3
| |
| − | | Change game mode
| |
| − | | 0: Survival, 1: Creative, 2: Adventure, 3: Spectator.
| |
| − | |-
| |
| − | | 4
| |
| − | | Win game
| |
| − | | 0: Just respawn player.<br>1: Roll the credits and respawn player.<br>Note that 1 is only sent by notchian server when player has not yet achieved advancement "The end?", else 0 is sent.
| |
| − | |-
| |
| − | | 5
| |
| − | | Demo event
| |
| − | | 0: Show welcome to demo screen.<br>101: Tell movement controls.<br>102: Tell jump control.<br>103: Tell inventory control.<br>104: Tell that the demo is over and print a message about how to take a screenshot.
| |
| − | |-
| |
| − | | 6
| |
| − | | Arrow hit player
| |
| − | | Note: Sent when any player is struck by an arrow.
| |
| − | |-
| |
| − | | 7
| |
| − | | Rain level change
| |
| − | | Note: Seems to change both sky color and lighting.<br>Rain level ranging from 0 to 1.
| |
| − | |-
| |
| − | | 8
| |
| − | | Thunder level change
| |
| − | | Note: Seems to change both sky color and lighting (same as Rain level change, but doesn't start rain). It also requires rain to render by notchian client.<br>Thunder level ranging from 0 to 1.
| |
| − | |-
| |
| − | | 9
| |
| − | | Play pufferfish sting sound
| |
| − | |-
| |
| − | | 10
| |
| − | | Play elder guardian mob appearance (effect and sound)
| |
| − | |
| |
| − | |-
| |
| − | | 11
| |
| − | | Enable respawn screen
| |
| − | | 0: Enable respawn screen.<br>1: Immediately respawn (sent when the <code>doImmediateRespawn</code> gamerule changes).
| |
| − | |-
| |
| − | | 12
| |
| − | | Limited crafting
| |
| − | | 0: Disable limited crafting.<br>1: Enable limited crafting (sent when the <code>doLimitedCrafting</code> gamerule changes).
| |
| − | |- {{added}}
| |
| − | | 13
| |
| − | | Start waiting for level chunks
| |
| − | | Instructs the client to begin the waiting process for the level chunks.<br>Sent by the server after the level is cleared on the client and is being re-sent (either during the first, or subsequent reconfigurations).
| |
| − | |}
| |
| − |
| |
| − | === Serverbound ===
| |
| − |
| |
| − | ==== Change Container Slot State ====
| |
| − |
| |
| − | This packet is sent by the client when toggling the state of a Crafter.
| |
| − |
| |
| − | {| class="wikitable" {{added}}
| |
| − | ! Packet ID
| |
| − | ! State
| |
| − | ! Bound To
| |
| − | ! Field Name
| |
| − | ! Field Type
| |
| − | ! Notes
| |
| − | |-
| |
| − | | rowspan="3"| 0x0F
| |
| − | | rowspan="3"| Play
| |
| − | | rowspan="3"| Server
| |
| − | | Slot ID
| |
| − | | VarInt
| |
| − | | This is the ID of the slot that was changed.
| |
| − | |-
| |
| − | | Window ID
| |
| − | | VarInt
| |
| − | | This is the ID of the window that was changed.
| |
| − | |-
| |
| − | | State
| |
| − | | Boolean
| |
| − | | The new state of the slot. True for enabled, false for disabled.
| |
| − | |}
| |
| | | | |
| | [[Category:Minecraft Modern]] | | [[Category:Minecraft Modern]] |
