|
|
| (984 intermediate revisions by 57 users not shown) |
| Line 1: |
Line 1: |
| − | {{Box
| + | 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. |
| − | |BORDER = #FF9999
| |
| − | |BACKGROUND = #FFCC99
| |
| − | |WIDTH = 100%
| |
| − | |ICON =
| |
| − | |HEADING = Under construction
| |
| − | |CONTENT = In light of the recent release of Minecraft 1.9, this article still contains some changes between 1.8.9 and 1.9, which are currently being merged into [[Protocol]]. If you want to contribute, please coordinate with us in [irc://irc.freenode.net/mcdevs #mcdevs], and ping [[User:Fenhl|Fenhl]] before making any edits.
| |
| − | }}
| |
| − | | |
| − | This page documents the changes from the [[Protocol|last stable Minecraft release]] (currently [[Protocol version numbers|1.9, protocol 107]]) to the current pre-release (currently [[Protocol version numbers|1.9.1-pre2, protocol 108]]). Note that this page contains bleeding-edge information that may not be completely or correctly documented.
| |
| | | | |
| | 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 21: |
Line 12: |
| | | | |
| | === Packets === | | === Packets === |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! ID
| |
| − | ! Packet name
| |
| − | !colspan="2"| Documentation
| |
| − | |-
| |
| − | !colspan="4"| Handshaking serverbound
| |
| − | {{PacketList|0x00|Handshake}}
| |
| − | |-
| |
| − | !colspan="4"| Play clientbound
| |
| − | {{PacketList|0x23|Join Game}}
| |
| − | {{PacketList|0x25|Entity Relative Move}}
| |
| − | {{PacketList|0x26|Entity Look And Relative Move}}
| |
| − | {{PacketList|0x3A|Attach Entity}}
| |
| − | |-
| |
| − | !colspan="4"| Play serverbound
| |
| − | {{PacketList|0x00|Teleport Confirm|rel=added}}
| |
| − | {{PacketList|0x01|Tab-Complete|rel=Tab-Complete 2}}
| |
| − | {{PacketList|0x03|Client Status}}
| |
| − | {{PacketList|0x04|Client Settings}}
| |
| − | {{PacketList|0x0A|Use Entity}}
| |
| − | {{PacketList|0x10|Vehicle Move (serverbound)|rel=added}}
| |
| − | {{PacketList|0x11|Steer Boat|rel=added}}
| |
| − | {{PacketList|0x13|Player Digging}}
| |
| − | {{PacketList|0x14|Entity Action}}
| |
| − | {{PacketList|0x19|Update Sign|rel=Update Sign 2}}
| |
| − | {{PacketList|0x1A|Animation|rel=Animation 2}}
| |
| − | {{PacketList|0x1C|Player Block Placement}}
| |
| − | {{PacketList|0x1D|Use Item|rel=added}}
| |
| − | |}
| |
| − |
| |
| − | == New/modified data types ==
| |
| − |
| |
| − | None so far.
| |
| − |
| |
| − | == Handshaking ==
| |
| − |
| |
| − | === Clientbound ===
| |
| − |
| |
| − | No changes so far.
| |
| − |
| |
| − | === Serverbound ===
| |
| − |
| |
| − | ==== Handshake ====
| |
| − |
| |
| − | This causes the server to switch into the target state.
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Packet ID
| |
| − | ! State
| |
| − | ! Bound To
| |
| − | ! Field Name
| |
| − | ! Field Type
| |
| − | ! Notes
| |
| − | |-
| |
| − | |rowspan="4"| 0x00
| |
| − | |rowspan="4"| Handshaking
| |
| − | |rowspan="4"| Server
| |
| − | | Protocol Version
| |
| − | | VarInt
| |
| − | | See [[protocol version numbers]] (currently {{Change|107|108}})
| |
| − | |-
| |
| − | | Server Address
| |
| − | | String
| |
| − | | hostname or IP, e.g. localhost or 127.0.0.1 (does this support IPv6?)
| |
| − | |-
| |
| − | | Server Port
| |
| − | | Unsigned Short
| |
| − | | default is 25565
| |
| − | |-
| |
| − | | Next State
| |
| − | | VarInt Enum
| |
| − | | 1 for [[#Status|status]], 2 for [[#Login|login]]
| |
| − | |}
| |
| − |
| |
| − | == Play ==
| |
| − |
| |
| − | === Clientbound ===
| |
| − |
| |
| − | ==== Join Game ====
| |
| − |
| |
| − | See [[Protocol Encryption]] for information on logging in.
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Packet ID
| |
| − | ! State
| |
| − | ! Bound To
| |
| − | ! Field Name
| |
| − | ! Field Type
| |
| − | ! Notes
| |
| − | |-
| |
| − | |rowspan="7"| 0x23
| |
| − | |rowspan="7"| Play
| |
| − | |rowspan="7"| Client
| |
| − | | Entity ID
| |
| − | | Int
| |
| − | | The player's Entity ID (EID)
| |
| − | |-
| |
| − | | Gamemode
| |
| − | | Unsigned Byte
| |
| − | | 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.
| |
| − | |-
| |
| − | | Dimension
| |
| − | | {{Change|Byte|Int}} Enum
| |
| − | | -1: Nether, 0: Overworld, 1: End
| |
| − | |-
| |
| − | | Difficulty
| |
| − | | Unsigned Byte
| |
| − | | 0: peaceful, 1: easy, 2: normal, 3: hard
| |
| − | |-
| |
| − | | Max Players
| |
| − | | Unsigned Byte
| |
| − | | Used by the client to draw the player list
| |
| − | |-
| |
| − | | Level Type
| |
| − | | String
| |
| − | | default, flat, largeBiomes, amplified, default_1_1
| |
| − | |-
| |
| − | | Reduced Debug Info
| |
| − | | Boolean
| |
| − | | If true, a Notchian client shows reduced information on the {{Minecraft Wiki|debug screen}}.
| |
| − | |}
| |
| − |
| |
| − | ==== Entity Relative Move ====
| |
| − |
| |
| − | This packet is sent by the server when an entity moves less then 8 blocks; if an entity moves more than 8 blocks [[#Entity Teleport|Entity Teleport]] should be sent instead.
| |
| − |
| |
| − | This packet allows at most 8 blocks movement in any direction, because short range is from -32768 to 32767. And 32768/(128*32)=8.
| |
| − |
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Packet ID
| |
| − | ! State
| |
| − | ! Bound To
| |
| − | ! Field Name
| |
| − | ! Field Type
| |
| − | ! Notes
| |
| − | |-
| |
| − | |rowspan="5"| {{Change|0x15|0x25}}
| |
| − | |rowspan="5"| Play
| |
| − | |rowspan="5"| Client
| |
| − | | Entity ID
| |
| − | | VarInt
| |
| − | |
| |
| − | |-
| |
| − | | Delta X
| |
| − | | {{Change|Byte|Short}}
| |
| − | | Change in X position as {{Change|a [[Data Types#Fixed-point numbers|Fixed-Point number]]|(currentX * 32 - prevX * 32) * 128}}
| |
| − | |-
| |
| − | | Delta Y
| |
| − | | {{Change|Byte|Short}}
| |
| − | | Change in Y position as {{Change|a [[Data Types#Fixed-point numbers|Fixed-Point number]]|(currentY * 32 - prevY * 32) * 128}}
| |
| − | |-
| |
| − | | Delta Z
| |
| − | | {{Change|Byte|Short}}
| |
| − | | Change in Z position as {{Change|a [[Data Types#Fixed-point numbers|Fixed-Point number]]|(currentZ * 32 - prevZ * 32) * 128}}
| |
| − | |-
| |
| − | | On Ground
| |
| − | | Boolean
| |
| − | |
| |
| − | |}
| |
| − |
| |
| − | ==== Entity Look And Relative Move ====
| |
| − |
| |
| − | This packet is sent by the server when an entity rotates and moves. Since a short range is limited from -32768 to 32767, and movement is offset of fixed-point numbers, this packet allows at most 8 blocks movement in any direction. (-32768/(32*128) == -8)
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Packet ID
| |
| − | ! State
| |
| − | ! Bound To
| |
| − | ! Field Name
| |
| − | ! Field Type
| |
| − | ! Notes
| |
| − | |-
| |
| − | |rowspan="7"| {{Change|0x17|0x26}}
| |
| − | |rowspan="7"| Play
| |
| − | |rowspan="7"| Client
| |
| − | | Entity ID
| |
| − | | VarInt
| |
| − | |
| |
| − | |-
| |
| − | | Delta X
| |
| − | | {{Change|Byte|Short}}
| |
| − | | Change in X position as {{Change|a [[Data Types#Fixed-point numbers|Fixed-Point number]]|(currentX * 32 - prevX * 32) * 128}}
| |
| − | |-
| |
| − | | Delta Y
| |
| − | | {{Change|Byte|Short}}
| |
| − | | Change in Y position as {{Change|a [[Data Types#Fixed-point numbers|Fixed-Point number]]|(currentY * 32 - prevY * 32) * 128}}
| |
| − | |-
| |
| − | | Delta Z
| |
| − | | {{Change|Byte|Short}}
| |
| − | | Change in Z position as {{Change|a [[Data Types#Fixed-point numbers|Fixed-Point number]]|(currentZ * 32 - prevZ * 32) * 128}}
| |
| − | |-
| |
| − | | Yaw
| |
| − | | Angle
| |
| − | | New angle, not a delta
| |
| − | |-
| |
| − | | Pitch
| |
| − | | Angle
| |
| − | | New angle, not a delta
| |
| − | |-
| |
| − | | On Ground
| |
| − | | Boolean
| |
| − | |
| |
| − | |}
| |
| − |
| |
| − | ==== Attach Entity ====
| |
| − |
| |
| − | This packet is sent when a player has been attached to an entity (e.g. Minecart).
| |
| − |
| |
| − | {| class="wikitable"
| |
| − | ! Packet ID
| |
| − | ! State
| |
| − | ! Bound To
| |
| − | ! Field Name
| |
| − | ! Field Type
| |
| − | ! Notes
| |
| − | |-
| |
| − | |rowspan="3"| {{change|0x1B|0x3A}}
| |
| − | |rowspan="3"| Play
| |
| − | |rowspan="3"| Client
| |
| − | | Entity ID
| |
| − | | Int
| |
| − | | Attached entity's EID
| |
| − | |-
| |
| − | | Vehicle ID
| |
| − | | Int
| |
| − | | Vechicle's Entity ID. Set to -1 to detach
| |
| − | |-style="background-color: #f4cccc; text-decoration: line-through;"
| |
| − | | Leash
| |
| − | | Boolean
| |
| − | | If true leashes the entity to the vehicle
| |
| − | |}
| |
| − |
| |
| − | === Serverbound ===
| |
| | | | |
| | No changes so far. | | No changes so far. |
| | | | |
| − | == Status ==
| + | [[Category:Minecraft Modern]] |
| − | | |
| − | === Clientbound ===
| |
| − | | |
| − | No changes so far.
| |
| − | | |
| − | === Serverbound ===
| |
| − | | |
| − | No changes so far.
| |
| − | | |
| − | == Login ==
| |
| − | | |
| − | === Clientbound ===
| |
| − | | |
| − | No changes so far.
| |
| − | | |
| − | === Serverbound ===
| |
| − | | |
| − | No changes so far.
| |
