Pre-release protocol
This page documents the changes from the last stable Minecraft release (currently 1.20.2, protocol 764) to the current pre-release (currently 1.20.3-pre1, protocol Snapshot 164). 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.
Contents
Data types
NBT
The NBT specification was changed so that the root tag is no longer required to be a Compound Tag when sent over the network.
Presently in the pre-release, only Compound Tag and String Tag types are used as root, but the Notchian server/client implementation is able to handle NBT Tags of any type.
Chat
The Chat type is now serialized as a NBT Tag instead of a JSON String, unless explicitly stated otherwise.
Name | Size (bytes) | Encodes | Notes |
---|---|---|---|
Chat | ≥ 1 ≤ (262144×4) + 3 |
See Chat | Encoded as a String with max length of 262144. |
Chat | Varies | See Chat | Encoded as a NBT Tag, with the type of tag used depending on the case:
|
This affects the following packets and data types containing Chat fields:
- Disconnect (configuration)
- Resource Pack (configuration)
- Boss Bar
- Command Suggestions Response
- Disconnect (play)
- Disguised Chat Message
- Map Data
- Open Screen
- Player Chat Message
- Combat Death
- Player Info Update
- Resource Pack (play)
- Server Data
- Set Action Bar Text
- Update Objectives
- Update Teams
- Set Subtitle Text
- Set Title Text
- System Chat Message
- Set Tab List Header And Footer
- Update Advancements
- Slot data type (values in the item NBT field)
- Chat entity metadata type
- OptChat entity metadata type
However, the following are NOT affected, as to maintain backwards compatibility with older versions:
Particle
Particle Name | Particle ID | Data | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
minecraft:ambient_entity_effect
|
0 | None | ||||||||||||||||||||||||
minecraft:angry_villager
|
1 | None | ||||||||||||||||||||||||
minecraft:block
|
2 |
| ||||||||||||||||||||||||
minecraft:block_marker
|
3 |
| ||||||||||||||||||||||||
minecraft:bubble
|
4 | None | ||||||||||||||||||||||||
minecraft:cloud
|
5 | None | ||||||||||||||||||||||||
minecraft:crit
|
6 | None | ||||||||||||||||||||||||
minecraft:damage_indicator
|
7 | None | ||||||||||||||||||||||||
minecraft:dragon_breath
|
8 | None | ||||||||||||||||||||||||
minecraft:dripping_lava
|
9 | None | ||||||||||||||||||||||||
minecraft:falling_lava
|
10 | None | ||||||||||||||||||||||||
minecraft:landing_lava
|
11 | None | ||||||||||||||||||||||||
minecraft:dripping_water
|
12 | None | ||||||||||||||||||||||||
minecraft:falling_water
|
13 | None | ||||||||||||||||||||||||
minecraft:dust
|
14 |
| ||||||||||||||||||||||||
minecraft:dust_color_transition
|
15 |
| ||||||||||||||||||||||||
minecraft:effect
|
16 | None | ||||||||||||||||||||||||
minecraft:elder_guardian
|
17 | None | ||||||||||||||||||||||||
minecraft:enchanted_hit
|
18 | None | ||||||||||||||||||||||||
minecraft:enchant
|
19 | None | ||||||||||||||||||||||||
minecraft:end_rod
|
20 | None | ||||||||||||||||||||||||
minecraft:entity_effect
|
21 | None | ||||||||||||||||||||||||
minecraft:explosion_emitter
|
22 | None | ||||||||||||||||||||||||
minecraft:explosion
|
23 | None | ||||||||||||||||||||||||
minecraft:gust
|
24 | None | ||||||||||||||||||||||||
minecraft:gust_emitter
|
25 | None | ||||||||||||||||||||||||
minecraft:sonic_boom
|
None | |||||||||||||||||||||||||
minecraft:falling_dust
|
| |||||||||||||||||||||||||
minecraft:firework
|
None | |||||||||||||||||||||||||
minecraft:fishing
|
None | |||||||||||||||||||||||||
minecraft:flame
|
None | |||||||||||||||||||||||||
minecraft:cherry_leaves
|
None | |||||||||||||||||||||||||
minecraft:sculk_soul
|
None | |||||||||||||||||||||||||
minecraft:sculk_charge
|
| |||||||||||||||||||||||||
minecraft:sculk_charge_pop
|
None | |||||||||||||||||||||||||
minecraft:soul_fire_flame
|
None | |||||||||||||||||||||||||
minecraft:soul
|
None | |||||||||||||||||||||||||
minecraft:flash
|
None | |||||||||||||||||||||||||
minecraft:happy_villager
|
None | |||||||||||||||||||||||||
minecraft:composter
|
None | |||||||||||||||||||||||||
minecraft:heart
|
None | |||||||||||||||||||||||||
minecraft:instant_effect
|
None | |||||||||||||||||||||||||
minecraft:item
|
| |||||||||||||||||||||||||
minecraft:vibration
|
| |||||||||||||||||||||||||
minecraft:item_slime
|
None | |||||||||||||||||||||||||
minecraft:item_snowball
|
None | |||||||||||||||||||||||||
minecraft:large_smoke
|
None | |||||||||||||||||||||||||
minecraft:lava
|
None | |||||||||||||||||||||||||
minecraft:mycelium
|
None | |||||||||||||||||||||||||
minecraft:note
|
None | |||||||||||||||||||||||||
minecraft:poof
|
None | |||||||||||||||||||||||||
minecraft:portal
|
None | |||||||||||||||||||||||||
minecraft:rain
|
None | |||||||||||||||||||||||||
minecraft:smoke
|
None | |||||||||||||||||||||||||
minecraft:white_smoke
|
54 | None | ||||||||||||||||||||||||
minecraft:sneeze
|
None | |||||||||||||||||||||||||
minecraft:spit
|
None | |||||||||||||||||||||||||
minecraft:squid_ink
|
None | |||||||||||||||||||||||||
minecraft:sweep_attack
|
None | |||||||||||||||||||||||||
minecraft:totem_of_undying
|
None | |||||||||||||||||||||||||
minecraft:underwater
|
None | |||||||||||||||||||||||||
minecraft:splash
|
None | |||||||||||||||||||||||||
minecraft:witch
|
None | |||||||||||||||||||||||||
minecraft:bubble_pop
|
None | |||||||||||||||||||||||||
minecraft:current_down
|
None | |||||||||||||||||||||||||
minecraft:bubble_column_up
|
None | |||||||||||||||||||||||||
minecraft:nautilus
|
None | |||||||||||||||||||||||||
minecraft:dolphin
|
None | |||||||||||||||||||||||||
minecraft:campfire_cosy_smoke
|
None | |||||||||||||||||||||||||
minecraft:campfire_signal_smoke
|
None | |||||||||||||||||||||||||
minecraft:dripping_honey
|
None | |||||||||||||||||||||||||
minecraft:falling_honey
|
None | |||||||||||||||||||||||||
minecraft:landing_honey
|
None | |||||||||||||||||||||||||
minecraft:falling_nectar
|
None | |||||||||||||||||||||||||
minecraft:falling_spore_blossom
|
None | |||||||||||||||||||||||||
minecraft:ash
|
None | |||||||||||||||||||||||||
minecraft:crimson_spore
|
None | |||||||||||||||||||||||||
minecraft:warped_spore
|
None | |||||||||||||||||||||||||
minecraft:spore_blossom_air
|
None | |||||||||||||||||||||||||
minecraft:dripping_obsidian_tear
|
None | |||||||||||||||||||||||||
minecraft:falling_obsidian_tear
|
None | |||||||||||||||||||||||||
minecraft:landing_obsidian_tear
|
None | |||||||||||||||||||||||||
minecraft:reverse_portal
|
None | |||||||||||||||||||||||||
minecraft:white_ash
|
None | |||||||||||||||||||||||||
minecraft:small_flame
|
None | |||||||||||||||||||||||||
minecraft:snowflake
|
None | |||||||||||||||||||||||||
minecraft:dripping_dripstone_lava
|
None | |||||||||||||||||||||||||
minecraft:falling_dripstone_lava
|
None | |||||||||||||||||||||||||
minecraft:dripping_dripstone_water
|
None | |||||||||||||||||||||||||
minecraft:falling_dripstone_water
|
None | |||||||||||||||||||||||||
minecraft:glow_squid_ink
|
None | |||||||||||||||||||||||||
minecraft:glow
|
None | |||||||||||||||||||||||||
minecraft:wax_on
|
None | |||||||||||||||||||||||||
minecraft:wax_off
|
None | |||||||||||||||||||||||||
minecraft:electric_spark
|
None | |||||||||||||||||||||||||
minecraft:scrape
|
None | |||||||||||||||||||||||||
minecraft:shriek
|
| |||||||||||||||||||||||||
minecraft:egg_crack
|
None | |||||||||||||||||||||||||
minecraft:dust_plume
|
98 | None | ||||||||||||||||||||||||
minecraft:gust_dust
|
99 | None | ||||||||||||||||||||||||
minecraft:trial_spawner_detection
|
100 | None |
Packets
ID | Packet name | Documentation | |
---|---|---|---|
Configuration clientbound | |||
0x06 | Resource Pack (configuration) | Current | |
0x06 | Remove Resource Pack (configuration) | Pre | |
0x07 | Add Resource Pack (configuration) | Pre | |
Feature Flags | Current | Pre | |
Configuration serverbound | |||
0x05 | Resource Pack Response (configuration) | Current | Pre |
Play clientbound | |||
0x1E | Explosion | Current | Pre |
0x20 | Game Event | Current | Pre |
0x42 | Reset Score | Pre | |
0x42 | Resource Pack (play) | Current | |
0x43 | Remove Resource Pack (play) | Pre | |
0x44 | Add Resource Pack (play) | Pre | |
Respawn | Current | (unchanged) | |
Set Head Rotation | Current | (unchanged) | |
Update Section Blocks | Current | (unchanged) | |
Select Advancements Tab | Current | (unchanged) | |
Server Data | Current | (unchanged) | |
Set Action Bar Text | Current | (unchanged) | |
Set Border Center | Current | (unchanged) | |
Set Border Lerp Size | Current | (unchanged) | |
Set Border Size | Current | (unchanged) | |
Set Border Warning Delay | Current | (unchanged) | |
Set Border Warning Distance | Current | (unchanged) | |
Set Camera | Current | (unchanged) | |
Set Held Item | Current | (unchanged) | |
Set Center Chunk | Current | (unchanged) | |
Set Render Distance | Current | (unchanged) | |
Set Default Spawn Position | Current | (unchanged) | |
Display Objective | Current | (unchanged) | |
Set Entity Metadata | Current | (unchanged) | |
Link Entities | Current | (unchanged) | |
Set Entity Velocity | Current | (unchanged) | |
Set Equipment | Current | (unchanged) | |
Set Experience | Current | (unchanged) | |
Set Health | Current | (unchanged) | |
Update Objectives | Current | Pre | |
Set Passengers | Current | (unchanged) | |
Update Teams | Current | (unchanged) | |
Update Score | Current | Pre | |
Set Simulation Distance | Current | (unchanged) | |
Set Subtitle Text | Current | (unchanged) | |
Update Time | Current | (unchanged) | |
Set Title Text | Current | (unchanged) | |
Set Title Animation Times | Current | (unchanged) | |
Entity Sound Effect | Current | (unchanged) | |
Sound Effect | Current | (unchanged) | |
Start Configuration | Current | (unchanged) | |
Stop Sound | Current | (unchanged) | |
System Chat Message | Current | (unchanged) | |
Set Tab List Header And Footer | Current | (unchanged) | |
Tag Query Response | Current | (unchanged) | |
Pickup Item | Current | (unchanged) | |
Teleport Entity | Current | (unchanged) | |
0x6E | Set Ticking State | Pre | |
0x6F | Step Tick | Pre | |
Update Advancements | Current | (unchanged) | |
Update Attributes | Current | (unchanged) | |
Entity Effect | Current | (unchanged) | |
Update Recipes | Current | Pre | |
Update Tags | Current | (unchanged) | |
Play serverbound | |||
0x0F | Change Container Slot State | Pre | |
Serverbound Plugin Message (play) | Current | (unchanged) | |
Edit Book | Current | (unchanged) | |
Query Entity Tag | Current | (unchanged) | |
Interact | Current | (unchanged) | |
Jigsaw Generate | Current | (unchanged) | |
Serverbound Keep Alive (play) | Current | (unchanged) | |
Lock Difficulty | Current | (unchanged) | |
Set Player Position | Current | (unchanged) | |
Set Player Position and Rotation | Current | (unchanged) | |
Set Player Rotation | Current | (unchanged) | |
Set Player On Ground | Current | (unchanged) | |
Move Vehicle | Current | (unchanged) | |
Paddle Boat | Current | (unchanged) | |
Pick Item | Current | (unchanged) | |
Ping Request (play) | Current | (unchanged) | |
Place Recipe | Current | (unchanged) | |
Player Abilities | Current | (unchanged) | |
Player Action | Current | (unchanged) | |
Player Command | Current | (unchanged) | |
Player Input | Current | (unchanged) | |
Pong (play) | Current | (unchanged) | |
Change Recipe Book Settings | Current | (unchanged) | |
Set Seen Recipe | Current | (unchanged) | |
Rename Item | Current | (unchanged) | |
Resource Pack Response (play) | Current | Pre | |
Seen Advancements | Current | (unchanged) | |
Select Trade | Current | (unchanged) | |
Set Beacon Effect | Current | (unchanged) | |
Set Held Item | Current | (unchanged) | |
Program Command Block | Current | (unchanged) | |
Program Command Block Minecart | Current | (unchanged) | |
Set Creative Mode Slot | Current | (unchanged) | |
Program Jigsaw Block | Current | Pre | |
Program Structure Block | Current | (unchanged) | |
Update Sign | Current | (unchanged) | |
Swing Arm | Current | (unchanged) | |
Teleport To Entity | Current | (unchanged) | |
Use Item On | Current | (unchanged) | |
Use Item | Current | (unchanged) |
New/modified data types
No changes so far.
Entity Metadata
Type (VarInt Enum) | Value (Varies) | Notes |
---|---|---|
0 | Byte | |
1 | VarInt | |
2 | VarLong | |
3 | Float | |
4 | String | |
5 | Chat | |
6 | OptChat (Boolean + Chat) | Chat is present if the Boolean is set to true |
7 | Slot | |
8 | Boolean | |
9 | Rotation | 3 Floats: rotation on x, rotation on y, rotation on z |
10 | Position | |
11 | OptPosition (Boolean + Position) | Position is present if the Boolean is set to true |
12 | Direction (VarInt) | (Down = 0, Up = 1, North = 2, South = 3, West = 4, East = 5) |
13 | OptUUID (Boolean + UUID) | UUID is present if the Boolean is set to true |
14 | BlockID (VarInt) | |
15 | OptBlockID (VarInt) | 0 for absent (implies air); otherwise, a block state ID as per the global palette |
16 | NBT | |
17 | Particle | |
18 | Villager Data | 3 VarInts: villager type, villager profession, level |
19 | OptVarInt | 0 for absent; 1 + actual value otherwise. Used for entity IDs. |
20 | Pose | A VarInt enum: 0: STANDING, 1: FALL_FLYING, 2: SLEEPING, 3: SWIMMING, 4: SPIN_ATTACK, 5: SNEAKING, 6: LONG_JUMPING, 7: DYING, 8: CROAKING, 9: USING_TONGUE, 10: SITTING, 11: ROARING, 12: SNIFFING, 13: EMERGING, 14: DIGGING, 15: SLIDING, 16: SHOOTING, 17: INHALING |
21 | Cat Variant | A VarInt that points towards the CAT_VARIANT registry. |
22 | Frog Variant | A VarInt that points towards the FROG_VARIANT registry. |
23 | OptGlobalPos (Boolean + GlobalPos) | GlobalPos consists of a dimension identifier and Position. |
24 | Painting Variant | A VarInt that points towards the PAINTING_VARIANT registry. |
25 | Sniffer State | A VarInt enum: IDLING = 0, FEELING_HAPPY = 1, SCENTING = 2, SNIFFING = 3, SEARCHING = 4, DIGGING = 5, RISING = 6 |
26 | Vector3 | 3 Floats: x, y, z |
27 | Quaternion | 4 Floats: x, y, z, w |
Abstract Vehicle
Extends Entity.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | VarInt | Shaking power | 0 | |
9 | VarInt | Shaking direction | 1 | |
10 | Float | Shaking multiplier | 0.0 |
Abstract Minecart
Extends Abstract Vehicle.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | VarInt | Shaking power | 0 | |
9 | VarInt | Shaking direction | 1 | |
10 | Float | Shaking multiplier | 0.0 | |
11 | VarInt | Custom block ID and damage | 0 | |
12 | VarInt | Custom block Y position (in 16ths of a block) | 6 | |
13 | Boolean | Show custom block | false |
Boat
Extends Abstract Vehicle.
Index | Type | Meaning | Default | |
---|---|---|---|---|
8 | VarInt | Time since last hit | 0 | |
9 | VarInt | Forward direction | 1 | |
10 | Float | Damage taken | 0.0 | |
11 | VarInt | Type (0=oak, 1=spruce, 2=birch, 3=jungle, 4=acacia, 5=dark oak) | 0 | |
12 | Boolean | Is left paddle turning | false | |
13 | Boolean | Is right paddle turning | false | |
14 | VarInt | 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.
Serverbound
No changes so far.
Login
Clientbound
No changes so far.
Serverbound
No changes so far.
Configuration
Clientbound
Remove Resource Pack (configuration)
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x06 | Configuration | Client | Has UUID | Boolean | Whether a specific resource pack should be removed, or all of them. |
UUID | Optional UUID | The UUID of the resource pack to be removed. Only present if the previous field is true. |
Add Resource Pack (configuration)
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x07 | Configuration | Client | UUID | UUID | The unique identifier of the resource pack. |
URL | String (32767) | The URL to the resource pack. | |||
Hash | String (40) | A 40 character hexadecimal, case-insensitive SHA-1 hash of the resource pack file. If it's not a 40 character hexadecimal string, the client will not use it for hash verification and likely waste bandwidth. | |||
Forced | Boolean | The Notchian client will be forced to use the resource pack from the server. If they decline they will be kicked from the server. | |||
Has Prompt Message | Boolean | Whether a custom message should be used on the resource pack prompt. | |||
Prompt Message | Optional Chat | This is shown in the prompt making the client accept or decline the resource pack. Only present if the previous field is true. |
Feature Flags
Used to enable and disable features, generally experimental ones, on the client.
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
Configuration | Client | Total Features | VarInt | Number of features that appear in the array below. | |
Feature Flags | Identifier Array |
As of 1.20.2 1.20.3, the following feature flags are available:
- minecraft:vanilla - enables vanilla features
- minecraft:bundle - enables support for the bundle
- minecraft:trade_rebalance - enables support for the rebalanced villager trades
- minecraft:update_1_21 - enables support for 1.21 features
Serverbound
Resource Pack Response (configuration)
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x05 | Configuration | Server | |||
UUID | UUID | The unique identifier of the resource pack received in the Add Resource Pack (configuration) request. | |||
Result | VarInt Enum |
Result can be one of the following values:
ID | Result |
---|---|
0 | Successfully downloaded |
1 | Declined |
2 | Failed to download |
3 | Accepted |
4 | Invalid URL |
5 | Failed to reload |
6 | Discarded |
Play
Clientbound
Explosion
Sent when an explosion occurs (creepers, TNT, and ghast fireballs).
Each block in Records is set to air. Coordinates for each axis in record is int(X) + record.x
There is currently a disparity in the Notchian implementation between the data that is read from and written to the network. The write logic only serializes the particle id for the fields Small explosion particle
and Large explosion particle
, while the read logic expects the particle id and extra required data. See MC-266537 for more information.
Packet ID | State | Bound To | Field Name | Field Type | Notes | |
---|---|---|---|---|---|---|
0x1E | Play | Client | X | Double | ||
Y | Double | |||||
Z | Double | |||||
Strength | Float | minecraft:explosion_emitter particle, while a lesser strength spawns a minecraft:explosion particle.If the strength is greater or equal to 2.0, or the block interaction is not 0 (keep), large explosion particles are used. Otherwise, small explosion particles are used. | ||||
Record Count | VarInt | Number of elements in the following array. | ||||
Records | Array of (Byte, Byte, Byte) | Each record is 3 signed bytes long; the 3 bytes are the XYZ (respectively) signed offsets of affected blocks. | ||||
Player Motion X | Float | X velocity of the player being pushed by the explosion. | ||||
Player Motion Y | Float | Y velocity of the player being pushed by the explosion. | ||||
Player Motion Z | Float | Z velocity of the player being pushed by the explosion. | ||||
Block interaction | VarInt Enum | 0 = keep, 1 = destroy, 2 = destroy_with_decay, 3 = trigger_block. | ||||
Small explosion particle | VarInt | The particle ID listed in the particle data type. | ||||
Large explosion particle | VarInt | The particle ID listed in the particle data type. | ||||
Explosion sound | Sound Name | Identifier | The name of the sound played. | |||
Has Fixed Range | Optional Boolean | Whether is has fixed range. | ||||
Range | Optional Float | The fixed range of the sound. Only present if previous boolean is true. |
Game Event
Used for a wide variety of game events, from weather to bed use to game mode to demo messages.
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x20 | Play | Client | Event | Unsigned Byte | See below. |
Value | Float | Depends on Event. |
Events:
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. 1: Roll the credits and respawn player. 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. 101: Tell movement controls. 102: Tell jump control. 103: Tell inventory control. 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. 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. 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. 1: Immediately respawn (sent when the doImmediateRespawn gamerule changes).
|
12 | Limited crafting | 0: Disable limited crafting. 1: Enable limited crafting (sent when the doLimitedCrafting gamerule changes).
|
13 | Start waiting for level chunks | Instructs the client to begin the waiting process for the level chunks. Sent by the server after the level is cleared on the client and is being re-sent (either during the first, or subsequent reconfigurations). |
Reset Score
This is sent to the client when it should remove a scoreboard item.
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x42 | Play | Client | Entity Name | String (32767) | The entity whose score this is. For players, this is their username; for other entities, it is their UUID. |
Has Objective Name | Boolean | Whether the score should be removed for the specified objective, or for all of them. | |||
Objective Name | Optional String (32767) | The name of the objective the score belongs to. Only present if the previous field is true. |
Remove Resource Pack (play)
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x43 | Play | Client | Has UUID | Boolean | Whether a specific resource pack should be removed, or all of them. |
UUID | Optional UUID | The UUID of the resource pack to be removed. Only present if the previous field is true. |
Add Resource Pack (play)
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x44 | Play | Client | UUID | UUID | The unique identifier of the resource pack. |
URL | String (32767) | The URL to the resource pack. | |||
Hash | String (40) | A 40 character hexadecimal, case-insensitive SHA-1 hash of the resource pack file. If it's not a 40 character hexadecimal string, the client will not use it for hash verification and likely waste bandwidth. | |||
Forced | Boolean | The Notchian client will be forced to use the resource pack from the server. If they decline they will be kicked from the server. | |||
Has Prompt Message | Boolean | Whether a custom message should be used on the resource pack prompt. | |||
Prompt Message | Optional Chat | This is shown in the prompt making the client accept or decline the resource pack. Only present if the previous field is true. |
Update Objectives
This is sent to the client when it should create a new scoreboard objective or remove one.
Packet ID | State | Bound To | Field Name | Field Type | Notes | |
---|---|---|---|---|---|---|
Play | Client | Objective Name | String (32767) | A unique name for the objective. | ||
Mode | Byte | 0 to create the scoreboard. 1 to remove the scoreboard. 2 to update the display text. | ||||
Objective Value | Optional Chat | Only if mode is 0 or 2.The text to be displayed for the score. | ||||
Type | Optional VarInt Enum | Only if mode is 0 or 2. 0 = "integer", 1 = "hearts". | ||||
Has Number Format | Optional Boolean | Only if mode is 0 or 2. Whether this objective has a set number format for the scores. | ||||
Number Format | Optional VarInt Enum | Only if mode is 0 or 2 and the previous boolean is true. Determines how the score number should be formatted. | ||||
Number Format | Field Name | |||||
0: blank | no fields | no fields | Show nothing. | |||
1: styled | Styling | Compound Tag | The styling to be used when formatting the score number. This is similar to a Chat, but only the styling fields are present. | |||
2: fixed | Content | Chat | The text to be used as placeholder. |
Update Score
This is sent to the client when it should update a scoreboard item.
Packet ID | State | Bound To | Field Name | Field Type | Notes | |
---|---|---|---|---|---|---|
Play | Client | Entity Name | String (32767) | The entity whose score this is. For players, this is their username; for other entities, it is their UUID. | ||
Action | VarInt Enum | 0 to create/update an item. 1 to remove an item. | ||||
Objective Name | String (32767) | The name of the objective the score belongs to. | ||||
Value | The score to be displayed next to the entry. | |||||
Has Display Name | Boolean | Whether this score has a custom display name. | ||||
Display Name | Optional Chat | The custom display name. Only present if the previous boolean is true. | ||||
Has Number Format | Boolean | Whether this score has a set number format. This overrides the number format set on the objective, if any. | ||||
Number Format | Optional VarInt Enum | Determines how the score number should be formatted. Only present if the previous boolean is true. | ||||
Number Format | Field Name | |||||
0: blank | no fields | no fields | Show nothing. | |||
1: styled | Styling | Compound Tag | The styling to be used when formatting the score number. This is similar to a Chat, but only the styling fields are present. | |||
2: fixed | Content | Chat | The text to be used as placeholder. |
Set Ticking State
Used to adjust the ticking rate of the client, and whether it's frozen.
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x6E | Play | Server | Tick rate | Float | |
Is frozen | Boolean |
Step Tick
Advances the client processing by the specified number of ticks. Has no effect is the client ticking is not frozen.
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x6F | Play | Client | Tick steps | VarInt |
Update Recipes
Packet ID | State | Bound To | Field Name | Field Type | Notes | ||
---|---|---|---|---|---|---|---|
Play | Client | Num Recipes | VarInt | Number of elements in the following array. | |||
Recipe | Type | Array | Identifier | The recipe type, see below. | |||
Recipe ID | Identifier | ||||||
Data | Varies | Additional data for the recipe. |
Recipe types:
Type | Description | Data | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
minecraft:crafting_shapeless
|
Shapeless crafting recipe. All items in the ingredient list must be present, but in any order/slot. | As follows:
| |||||||||||||||||||||||||||||
minecraft:crafting_shaped
|
Shaped crafting recipe. All items must be present in the same pattern (which may be flipped horizontally or translated). | As follows:
| |||||||||||||||||||||||||||||
minecraft:crafting_special_armordye
|
Recipe for dying leather armor | As follows:
| |||||||||||||||||||||||||||||
minecraft:crafting_special_bookcloning
|
Recipe for copying contents of written books | ||||||||||||||||||||||||||||||
minecraft:crafting_special_mapcloning
|
Recipe for copying maps | ||||||||||||||||||||||||||||||
minecraft:crafting_special_mapextending
|
Recipe for adding paper to maps | ||||||||||||||||||||||||||||||
minecraft:crafting_special_firework_rocket
|
Recipe for making firework rockets | ||||||||||||||||||||||||||||||
minecraft:crafting_special_firework_star
|
Recipe for making firework stars | ||||||||||||||||||||||||||||||
minecraft:crafting_special_firework_star_fade
|
Recipe for making firework stars fade between multiple colors | ||||||||||||||||||||||||||||||
minecraft:crafting_special_repairitem
|
Recipe for repairing items via crafting | ||||||||||||||||||||||||||||||
minecraft:crafting_special_tippedarrow
|
Recipe for crafting tipped arrows | ||||||||||||||||||||||||||||||
minecraft:crafting_special_bannerduplicate
|
Recipe for copying banner patterns | ||||||||||||||||||||||||||||||
minecraft:crafting_special_shielddecoration
|
Recipe for applying a banner's pattern to a shield | ||||||||||||||||||||||||||||||
minecraft:crafting_special_shulkerboxcoloring
|
Recipe for recoloring a shulker box | ||||||||||||||||||||||||||||||
minecraft:crafting_special_suspiciousstew
|
Recipe for crafting suspicious stews | ||||||||||||||||||||||||||||||
minecraft:crafting_decorated_pot
|
Recipe for crafting decorated pots | ||||||||||||||||||||||||||||||
minecraft:smelting
|
Smelting recipe | As follows:
| |||||||||||||||||||||||||||||
minecraft:blasting
|
Blast furnace recipe | ||||||||||||||||||||||||||||||
minecraft:smoking
|
Smoker recipe | ||||||||||||||||||||||||||||||
minecraft:campfire_cooking
|
Campfire recipe | ||||||||||||||||||||||||||||||
minecraft:stonecutting
|
Stonecutter recipe | As follows:
| |||||||||||||||||||||||||||||
minecraft:smithing_transform
|
Recipe for smithing netherite gear | As follows:
| |||||||||||||||||||||||||||||
minecraft:smithing_trim
|
Recipe for applying armor trims | As follows:
|
Ingredient is defined as:
Name | Type | Description |
---|---|---|
Count | VarInt | Number of elements in the following array. |
Items | Array of Slot | Any item in this array may be used for the recipe. The count of each item should be 1. |
Serverbound
Change Container Slot State
This packet is sent by the client when toggling the state of a Crafter.
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x0F | Play | 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. |
Resource Pack Response (play)
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x27 | Play | Server | |||
UUID | UUID | The unique identifier of the resource pack received in the Add Resource Pack (play) request. | |||
Result | VarInt Enum |
Result can be one of the following values:
ID | Result |
---|---|
0 | Successfully downloaded |
1 | Declined |
2 | Failed to download |
3 | Accepted |
4 | Invalid URL |
5 | Failed to reload |
6 | Discarded |
Program Jigsaw Block
Sent when Done is pressed on the Jigsaw Block interface.
Packet ID | State | Bound To | Field Name | Field Type | Notes |
---|---|---|---|---|---|
0x2F | Play | Server | Location | Position | Block entity location |
Name | Identifier | ||||
Target | Identifier | ||||
Pool | Identifier | ||||
Final state | String (32767) | "Turns into" on the GUI, final_state in NBT.
| |||
Joint type | String (32767) | rollable if the attached piece can be rotated, else aligned .
| |||
Selection priority | VarInt | ||||
Placement priority | VarInt |