Play

Clientbound

class minecraft.packets.play_clientbound.BundleDelimiter

The delimeter for a bundle of packets. When received, the client should store every subsequent packet it receives, and wait until another delimiter is received. Once that happens, the client is guaranteed to process every packet in the bundle on the same tick.

Packet ID: 0x00

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO) → BundleDelimiter

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SpawnEntity(entity_id: Varint, entity_uuid: UUID, entity_type: Varint, x: Double, y: Double, z: Double, pitch: Angle, yaw: Angle, head_yaw: Angle, data: Varint, velocity_x: Short, velocity_y: Short, velocity_z: Short)

Sent by the server when a vehicle or other non-living entity is created.

Packet ID: 0x01

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SpawnExperienceOrb(entity_id: Varint, x: Double, y: Double, z: Double, count: Short)

Spawns one or more experience orbs.

Packet ID: 0x02

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SpawnPlayer(entity_id: Varint, player_uuid: UUID, x: Double, y: Double, z: Double, yaw: Angle, pitch: Angle)

This packet is sent by the server when a player comes into visible range, not when a player joins.

Packet ID: 0x03

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.EntityAnimation(entity_id: Varint, animation: Animation)

Sent whenever an entity should change animation.

Packet ID: 0x04

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.AwardStats(stats: list[tuple[minecraft.datatypes.Varint, minecraft.datatypes.Varint]])

Sent as a response to Client Command (id 1). Will only send the changed values if previously requested.

Packet ID: 0x05

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.AcknowledgeBlockChange(sequence_id: Varint)

Acknowledges a user-initiated block change. After receiving this packet, the client should display the block state sent by the server instead of the one predicted by the client.

Packet ID: 0x06

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetBlockDestroyStage(entity_id: Varint, location: Position, destroy_stage: Byte)

0-9 are the displayable destroy stages and each other number means that there is no animation on this coordinate.

Packet ID: 0x07

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.BlockEntityData(location: Position, type: Varint, nbt_data: NBT)

Sets the block entity associated with the block at the given location.

Packet ID: 0x08

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.BlockAction(location: Position, action_id: UnsignedByte, action_param: UnsignedByte, block_type: Varint)

This packet is used for a number of actions and animations performed by blocks, usually non-persistent. The client should ignore the provided block type and instead uses the block state in their world.

Packet ID: 0x09

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.BlockUpdate(location: Position, block_id: Varint)

Fired whenever a block is changed within the render distance.

Packet ID: 0x0A

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.BossBar(uuid: UUID, action: UnsignedByte, title: Chat | None, health: Float | None, color: BossBarColor | None, division: BossBarDivision | None, flags: UnsignedByte | None)

Sent by the server to update the boss bar on the client.

Packet ID: 0x0B

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.ChangeDifficulty(difficulty: UnsignedByte, locked: Boolean = Boolean(value=False))

Changes the difficulty setting in the client’s option menu.

Packet ID: 0x0C

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.ChunkBiomes(chunk_biome_data: list[minecraft.datatypes.DataProxy])

Sent by the server to update the biomes within a chunk.

Packet ID: 0x0D

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.ClearTitles(reset: Boolean)

Clear the client’s current title information, with the option to also reset it.

Packet ID: 0x0E

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.CommandSuggestionsResponse(transaction_id: Varint, start: Varint, length: Varint, matches: list[minecraft.datatypes.CommandSuggestionMatch])

The server responds with a list of auto-completions of the last word sent to it.

Packet ID: 0x0F

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.Commands(nodes: list[minecraft.datatypes.CommandNode], root_index: Varint)

lists all of the commands on the server, and how they are parsed.

Packet ID: 0x10

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.CloseContainer(window_id: UnsignedByte)

This packet is sent from the server to the client when a window is forcibly closed, such as when a chest is destroyed while it’s open.

Packet ID: 0x11

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetContainerContents(window_id: UnsignedByte, state_id: Varint, contents: list[minecraft.datatypes.Slot], carried_item: Slot)

Sent by the server when items in multiple slots (in a window) are added/removed. This includes the main inventory, equipped armour and crafting slots. This packet with Window ID set to “0” is sent during the player joining sequence to initialise the player’s inventory.

Packet ID: 0x12

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetContainerProperty(window_id: UnsignedByte, property: Short, value: Short)

This packet is used to inform the client that part of a GUI window should be updated.

Packet ID: 0x13

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetContainerSlot(window_id: Byte, state_id: Varint, slot: Short, item: Slot)

Sent by the server when an item in a slot (in a window) is added/removed.

Packet ID: 0x14

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetCooldown(item_id: Varint, cooldown: Varint)

This packet is used to inform the client that a cooldown should be started for an item.

Packet ID: 0x15

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.ChatSuggestions(action: ChatSuggestionAction, entries: list[minecraft.datatypes.String])

Unused by the default server. Likely provided for custom servers to send chat message completions to clients.

Packet ID: 0x16

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.PluginMessageClientbound(channel: Identifier, data: ByteArray)

Mods and plugins can use this to send their data. Minecraft itself uses several plugin channels. These internal channels are in the minecraft namespace.

Packet ID: 0x17

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.DamageEvent(entity_id: Varint, source_type_id: Varint, source_cause_id: Varint, source_direct_id: Varint, source_position_x: Double | None = None, source_position_y: Double | None = None, source_position_z: Double | None = None)

Sent by the server to make the player take damage.

Packet ID: 0x18

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.DeleteMessage(signature: ByteArray)

Sent by the server to delete a message from the client’s chat.

Packet ID: 0x19

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.DisconnectPlay(reason: Chat)

Sent by the server before it disconnects a client. The client should assume that the server has already closed the connection by the time the packet arrives.

Packet ID: 0x1A

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.DisguisedChatMessage(message: String)

Used to send system chat messages to the client.

Packet ID: 0x1B

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.EntityEvent(entity_id: Varint, entity_status: Byte)

Entity statuses generally trigger an animation for an entity.

Packet ID: 0x1C

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.Explosion(x: Double, y: Double, z: Double, strength: Float, records: list[tuple[minecraft.datatypes.Byte, minecraft.datatypes.Byte, minecraft.datatypes.Byte]], player_motion_x: Float, player_motion_y: Float, player_motion_z: Float)

Sent when an explosion occurs (creepers, TNT, and ghast fireballs).

Packet ID: 0x1D

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UnloadChunk(x: Int, z: Int)

Tells the client to unload a chunk.

Packet ID: 0x1E

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.GameEvent(event: GameEvents, value: Float)

Used for a wide variety of game events, from weather to bed use to gamemode to demo messages.

Packet ID: 0x1F

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.OpenHorseScreen(window_id: UnsignedByte, slot_count: Varint, entity_id: Int)

Opens the horse inventory screen.

Packet ID: 0x20

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.HurtAnimation(entity_id: Varint, yaw: Float)

Plays a bobbing animation for the entity receiving damage.

Packet ID: 0x21

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.InitializeWorldBorder(x: Double, z: Double, old_diameter: Double, new_diameter: Double, speed: Varlong, portal_teleport_boundary: Varint, warning_time: Varint, warning_blocks: Varint)

Initializes the world border.

Packet ID: 0x22

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.KeepAliveClientbound(keep_alive_id: Long)

The server will frequently send out a keep-alive, each containing a random ID. The client must respond with the same payload (see serverbound Keep Alive). If the client does not respond to them for over 30 seconds, the server kicks the client. Vice versa, if the server does not send any keep-alives for 20 seconds, the client will disconnect and yields a “Timed out” exception.

Packet ID: 0x23

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.ChunkDataAndUpdateLight(chunk_x: Int, chunk_z: Int, heightmaps: NBT, data: ByteArray, block_entities: list[minecraft.datatypes.BlockEntity], trust_edges: Boolean, sky_light_mask: BitSet, block_light_mask: BitSet, empty_sky_light_mask: BitSet, empty_block_light_mask: BitSet, sky_light: list[minecraft.datatypes.ByteArray], block_light: list[minecraft.datatypes.ByteArray])

A chunk data packet with the light data included.

Packet ID: 0x24

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.WorldEvent(event: WorldEvents, location: Position, data: Int, disable_relative_volume: Boolean)

Sent when a client is to play a sound or particle effect.

Packet ID: 0x25

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.Particle(particle_id: Varint, long_distance: Boolean, x: Double, y: Double, z: Double, offset_x: Float, offset_y: Float, offset_z: Float, max_speed: Float, particle_count: Int, particle_data: bytes)

Displays the named particle.

Packet ID: 0x26

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateLight(chunk_x: Int, chunk_z: Int, trust_edges: Boolean, sky_light_mask: BitSet, block_light_mask: BitSet, empty_sky_light_mask: BitSet, empty_block_light_mask: BitSet, sky_light: list[minecraft.datatypes.ByteArray], block_light: list[minecraft.datatypes.ByteArray])

Updates light levels for a chunk.

Packet ID: 0x27

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.LoginPlay(entity_id: Int, is_hardcore: Boolean, gamemode: UnsignedByte, previous_gamemode: Byte, dimensions: list[minecraft.datatypes.Identifier], registry_codec: NBT, dimension_type: Identifier, dimension_name: Identifier, hashed_seed: Long, max_players: Varint, view_distance: Varint, simulation_distance: Varint, reduced_debug_info: Boolean, enable_respawn_screen: Boolean, is_debug: Boolean, is_flat: Boolean, death_dimension_name: Identifier | None = None, death_location: Position | None = None)

Updates some data about the player.

Packet ID: 0x28

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.MapDataPacket(map_id: Varint, scale: Byte, locked: Boolean, icons: list[minecraft.datatypes.MapIcon], updated_columns: UnsignedByte, updated_rows: UnsignedByte | None = None, x: Byte | None = None, z: Byte | None = None, data: list[minecraft.datatypes.UnsignedByte] | None = None)

Updates a rectangular area on a map item.

Packet ID: 0x29

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.MerchantOffers(window_id: Varint, trades: list[minecraft.datatypes.Trade], villager_level: Varint, experience: Varint, is_regular_villager: Boolean, can_restock: Boolean)

The list of trades a villager NPC is offering.

Packet ID: 0x2A

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateEntityPosition(entity_id: Varint, delta_x: Short, delta_y: Short, delta_z: Short, on_ground: Boolean)

This packet is sent by the server when an entity moves less then 8 blocks; if an entity moves more than 8 blocks Teleport Entity should be sent instead.

Packet ID: 0x2B

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateEntityPositionAndRotation(entity_id: Varint, delta_x: Short, delta_y: Short, delta_z: Short, yaw: Angle, pitch: Angle, on_ground: Boolean)

This packet is sent by the server when an entity rotates and moves. A maximum of 8 blocks can be moved.

Packet ID: 0x2C

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateEntityRotation(entity_id: Varint, yaw: Angle, pitch: Angle, on_ground: Boolean)

This packet is sent by the server when an entity rotates.

Packet ID: 0x2D

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.MoveVehicle(entity_id: Varint, x: Double, y: Double, z: Double, yaw: Angle, pitch: Angle)

This packet is sent by the server when a vehicle moves.

Packet ID: 0x2E

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.OpenBook(hand: Hand)

Sent when a player right clicks with a signed book. This tells the client to open the book GUI.

Packet ID: 0x2F

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.OpenScreen(window_id: Varint, window_type: Varint, window_title: Chat)

This is sent to the client when it should open an inventory, such as a chest, workbench, furnace, or other container.

Packet ID: 0x30

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.OpenSignEditor(location: Position)

Sent when the client has placed a sign and is allowed to send Update Sign.

Packet ID: 0x31

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.Ping(id: Int)

An unused packet by the default server. The client should respond with a Pong when recieved.

Packet ID: 0x32

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.PlaceGhostRecipe(window_id: Varint, recipe_id: Identifier)

Sent when the client has placed a ghost recipe in a crafting table.

Packet ID: 0x33

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.ClientPlayerAbilities(flags: Byte, flying_speed: Float, field_of_view_modifier: Float)

This packet is sent by the server to update the client’s abilities and flags.

Packet ID: 0x34

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.PlayerChatMessage(header: DataProxy, body: DataProxy, previous_messages: list[minecraft.datatypes.DataProxy], other: DataProxy, network_target: DataProxy)

Sends the client a message from a player.

Packet ID: 0x35

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.EndCombat(duration: Int, entity_id: Varint)

Unused by the default client.

Packet ID: 0x36

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.EnterCombat

Unused by the default client.

Packet ID: 0x37

State: State.PLAY

Bound to: Client

class minecraft.packets.play_clientbound.CombatDeath(player_id: Varint, entity_id: Int, message: Chat)

Used to send a respawn screen.

Packet ID: 0x38

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.PlayerInfoRemove(players: list[minecraft.datatypes.UUID])

Used by the server to remove players from the player list.

Packet ID: 0x39

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.PlayerInfoUpdate(actions: Byte, players: list[minecraft.datatypes.PlayerInfoUpdatePlayer])

Sent by the server to update the user list (<tab> in the client).

Packet ID: 0x3A

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.LookAt(feet_eyes: FeetEyes, target_x: Double, target_y: Double, target_z: Double, is_entity: Boolean, entity_id: Varint | None, entity_feet_eyes: FeetEyes | None)

Used to change the player’s look direction.

Packet ID: 0x3B

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SynchronizePlayerPosition(x: Double, y: Double, z: Double, yaw: Float, pitch: Float, flags: Byte, teleport_id: Varint)

Used to synchronize the player’s position with the server.

Packet ID: 0x3C

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateRecipeBook(action: RecipeBookActionType, crafting_recipe_book_open: Boolean, crafting_recipe_book_filter_active: Boolean, smelting_recipe_book_open: Boolean, smelting_recipe_book_filter_active: Boolean, blast_furnace_recipe_book_open: Boolean, blast_furnace_recipe_book_filter_active: Boolean, smoker_recipe_book_open: Boolean, smoker_recipe_book_filter_active: Boolean, array_1: list[minecraft.datatypes.Identifier], array_2: list[minecraft.datatypes.Identifier])

Used to update the recipe book.

Packet ID: 0x3D

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.RemoveEntities(entity_ids: list[minecraft.datatypes.Varint])

Sent by the server when an entity is to be destroyed on the client.

Packet ID: 0x3E

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.RemoveEntityEffect(entity_id: Varint, effect_id: Varint)

Sent by the server when an entity effect is to be removed from an entity.

Packet ID: 0x3F

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.ResourcePack(url: String, hash: String, forced: Boolean, prompt_message: String | None)

Sent by the server when a resource pack is to be sent to the client.

Packet ID: 0x40

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.Respawn(dimension_type: Identifier, dimension_name: Identifier, hashed_seed: Long, gamemode: UnsignedByte, previous_gamemode: Byte, is_debug: Boolean, is_flat: Boolean, copy_metadata: Boolean, has_death_location: Boolean, death_dimension: Identifier | None = None, death_location: Position | None = None)

To change the player’s dimension (overworld/nether/end), send them a respawn packet with the appropriate dimension, followed by prechunks/chunks for the new dimension, and finally a position and look packet. You do not need to unload chunks, the client will do it automatically.

Packet ID: 0x41

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetHeadRotation(entity_id: Varint, head_yaw: Angle)

Changes the direction an entity’s head is facing.

Packet ID: 0x42

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateSectionBlocks(chunk_section_position: Long, suppress_light_updates: Boolean, blocks: list[minecraft.datatypes.Varlong])

Sent whenever 2 or more blocks are changed within the same chunk on the same tick.

Packet ID: 0x43

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SelectAdvancementsTab(has_tab: Boolean, tab_id: Identifier)

Sent by the server to indicate that the client should switch advancement tab. Sent either when the client switches tab in the GUI or when an advancement in another tab is made.

Packet ID: 0x44

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.ServerData(motd: Chat, icon: String | None = None, enforces_secure_chat: Boolean = Boolean(value=False))

Sent by the server to the client to send information about the server.

Packet ID: 0x45

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetActionBarText(text: Chat)

Sent by the server to the client to set the action bar text. The action bar text is displayed as a message above the hotbar.

Packet ID: 0x46

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetBorderCenter(x: Double, z: Double)

Sent by the server to the client to set the center of the world border.

Packet ID: 0x47

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetBorderLerpSize(old_diameter: Double, new_diameter: Double, speed: Varlong)

Sent by the server to the client to set the size of the world border.

Packet ID: 0x48

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetBorderSize(diameter: Double)

Sent by the server to the client to set the size of the world border.

Packet ID: 0x49

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetBorderWarningDelay(delay: Varint)

Sent by the server to the client to set the warning delay of the world border.

Packet ID: 0x4A

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetBorderWarningDistance(distance: Varint)

Sent by the server to the client to set the warning distance of the world border.

Packet ID: 0x4B

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetCamera(entity_id: Varint)

Sets the entity that the player renders from. This is normally used when the player left-clicks an entity while in spectator mode.

Packet ID: 0x4C

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.ClientSetHeldItem(slot: Byte)

Sent by the server to the client to set the held item of the player.

Packet ID: 0x4D

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetCenterChunk(chunk_x: Varint, chunk_z: Varint)

Updates the client’s location. This is used to determine what chunks should remain loaded and if a chunk load should be ignored; chunks outside of the view distance may be unloaded.

Sent whenever the player moves across a chunk border horizontally, and also (according to testing) for any integer change in the vertical axis, even if it doesn’t go across a chunk section border.

Packet ID: 0x4E

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetRenderDistance(distance: Varint)

Sent by the integrated singleplayer server when changing render distance. This packet is sent by the server when the client reappears in the overworld after leaving the end.

Packet ID: 0x4F

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetDefaultSpawnLocation(location: Position, angle: Float)

Sent by the server after login to specify the coordinates of the spawn point (the point at which players spawn at, and which the compass points to). It can be sent at any time to update the point compasses point at.

Packet ID: 0x50

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.DisplayObjective(position: ScoreboardPosition, objective_name: String)

Sent by the server to the client to display an objective on the scoreboard.

Packet ID: 0x51

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetEntityMetadata(entity_id: Varint, metadata: EntityMetadata)

Sent by the server to the client to update the metadata of an entity. Any properties not included in the Metadata field are left unchanged.

Packet ID: 0x52

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.LinkEntities(attached_entity_id: Int, holding_entity_id: Int)

Sent by the server to the client to link two entities together. This is used to link a leash to a mob and the player holding it.

Packet ID: 0x53

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetEntityVelocity(entity_id: Varint, velocity_x: Short, velocity_y: Short, velocity_z: Short)

Sent by the server to the client to update the velocity of an entity.

Velocity is believed to be in units of 1/8000 of a block per server tick (50ms); for example, -1343 would move (-1343 / 8000) = ~0.167875 blocks per tick (or ~3.3575 blocks per second).

Packet ID: 0x54

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetEquipment(entity_id: Varint, equipment: list[tuple[minecraft.datatypes.Byte, minecraft.datatypes.Slot]])

Sent by the server to the client to update the equipment of an entity.

Packet ID: 0x55

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetExperience(experience_bar: Float, total_experience: Varint, level: Varint)

Sent by the server when the client should change XP levels.

Packet ID: 0x56

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetHealth(health: Float, food: Varint, food_saturation: Float)

Sent by the server when the client should change their health.

Packet ID: 0x57

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateObjectives(objective_name: String, mode: UpdateObjectiveModes, objective_value: Chat | None = None, objective_type: UpdateObjectiveType | None = None)

Sent by the server to the client to update the scoreboard objectives.

Packet ID: 0x58

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetPassengers(entity_id: Varint, passengers: list[minecraft.datatypes.Varint])

Sent by the server to the client to set the passengers of an entity.

Packet ID: 0x59

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateTeams(team_name: String, mode: UpdateTeamModes, data: DataProxy)

Sent by the server to the client to update the scoreboard teams.

Packet ID: 0x5A

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateScore(entity_name: String, action: UpdateScoreAction, objective_name: String, value: Varint | None = None)

Sent by the server to the client to update the scoreboard scores.

Packet ID: 0x5B

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetSimulationDistance(distance: Varint)

Sent by the server to the client to set the distance at which the client will receive simulation updates.

Packet ID: 0x5C

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetSubtitleText(subtitle: Chat)

Sent by the server to the client to set the subtitle text.

Packet ID: 0x5D

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateTime(world_age: Long, time_of_day: Long)

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.

Packet ID: 0x5E

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetTitleText(title: Chat)

Sent by the server to the client to set the title text.

Packet ID: 0x5F

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetTitleAnimationTimes(fade_in: Int, stay: Int, fade_out: Int)

Sent by the server to the client to set the title animation times.

Packet ID: 0x60

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.EntitySoundEffect(sound_id: Varint, sound_category: Varint, entity_id: Varint, volume: Float, pitch: Float, seed: Long)

Sent by the server to the client to play a sound effect for an entity.

Packet ID: 0x61

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SoundEffect(sound_id: Varint, sound_category: Varint, x: Int, y: Int, z: Int, volume: Float, pitch: Float, seed: Long)

Sent by the server to the client to play a sound effect.

Packet ID: 0x5E

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.StopSound(flags: Byte, source: Varint | None, sound: Identifier | None)

Sent by the server to the client to stop a sound effect.

Packet ID: 0x63

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SystemChatMessage(content: Chat, overlay: Boolean)

Sent by the server to the client to send a chat message.

Packet ID: 0x64

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.SetTabListHeaderAndFooter(header: Chat | None, footer: Chat | None)

Sent by the server to the client to set the header and footer of the tab list.

Packet ID: 0x65

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.TagQueryResponse(transaction_id: Varint, nbt: NBT)

Sent in response to Query Block Entity Tag or Query Entity Tag.

Packet ID: 0x66

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.PickupItem(collected_entity_id: Varint, collector_entity_id: Varint, pickup_item_count: Varint)

Sent by the server to the client to spawn a pickup item.

Packet ID: 0x67

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.TeleportEntity(entity_id: Varint, x: Double, y: Double, z: Double, yaw: Angle, pitch: Angle, on_ground: Boolean)

Sent by the server to the client to teleport an entity.

Packet ID: 0x68

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateAdvancements(reset: Boolean, mapping: dict[minecraft.datatypes.Identifier, minecraft.datatypes.Advancement], identifiers: list[minecraft.datatypes.Identifier], progress: dict[minecraft.datatypes.Identifier, minecraft.datatypes.AdvancementProgress])

Sent by the server to the client to update the advancements.

Packet ID: 0x69

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateAttributes(entity_id: Varint, attributes: list[minecraft.datatypes.DataProxy])

Sets attributes on the given entity.

Packet ID: 0x6A

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.FeatureFlags(features: list[minecraft.datatypes.Identifier])

Used to enable and disable features, generally experimental ones, on the client.

Packet ID: 0x6B

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.EntityEffect(entity_id: Varint, effect_id: Byte, amplifier: Byte, duration: Varint, flags: Byte, factor_codec: NBT)

Applies an effect to the given entity.

Packet ID: 0x6C

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateRecipes(recipes: list[minecraft.datatypes.Recipe])

Updates the recipes on the client.

Packet ID: 0x6D

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_clientbound.UpdateTags(tags: list[minecraft.datatypes.DataProxy])

Updates the tags on the client.

Packet ID: 0x6E

State: State.PLAY

Bound to: Client

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

Serverbound

class minecraft.packets.play_serverbound.ConfirmTeleportation(teleport_id: Varint)

Sent by client as confirmation of Synchronize Player Position.

Packet ID: 0x00

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.QueryBlockEntityTag(transaction_id: Varint, location: Position)

Used when Shift+F3+I is pressed while looking at a block.

Packet ID: 0x01

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ChangeServerDifficulty(difficulty: UnsignedByte)

Only be used on singleplayer; the difficulty buttons are disabled in multiplayer.

Packet ID: 0x02

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.MessageAcknowledgement(message_count: Varint)

Sent by client to acknowledge a message.

Packet ID: 0x03

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ChatCommand(command: String, timestamp: Long, salt: Long, argument_signatures: list[tuple[minecraft.datatypes.String, minecraft.datatypes.ByteArray]], message_count: Varint, acknowledged: BitSet)

Sent by client to send a command.

Packet ID: 0x04

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ChatMessage(message: String, timestamp: Long, salt: Long, signature: ByteArray | None, message_count: Varint, acknowledged: BitSet)

Send a chat message.

Packet ID: 0x05

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.PlayerSession(session_id: UUID, public_key_expires_at: Long, public_key: ByteArray, public_key_signature: ByteArray)

Sent by client to send information about the player session.

Packet ID: 0x06

State: State.PLAY

Bound to: Server

class minecraft.packets.play_serverbound.ClientCommand(action_id: ClientCommandAction)

Sent by client to send a command.

Packet ID: 0x07

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ClientInformation(locale: String, view_distance: Varint, chat_mode: ChatMode, chat_colors: Boolean, displayed_skin_parts: BitSet, main_hand: MainHand, enable_text_filtering: Boolean, allow_server_listings: Boolean)

Sent by client to send information about the client.

Packet ID: 0x08

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.CommandSuggestionsRequest(transaction_id: Varint, text: String)

Sent when the client needs to tab-complete a minecraft:ask_server suggestion type.

Packet ID: 0x09

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ClickContainerButton(window_id: Byte, button_id: Byte)

Used when clicking on window buttons.

Packet ID: 0x0A

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ClickContainer(window_id: Byte, state_id: Varint, slot: Short, button: Byte, mode: Varint, slots: list[tuple[minecraft.datatypes.Short, minecraft.datatypes.Slot]], carried_item: Slot)

Sent by the client when the player clicks on a slot in a window.

Packet ID: 0x0B

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.CloseContainer(window_id: Byte)

Sent by the client when the player closes a window.

Packet ID: 0x0C

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.PluginMessageServerbound(channel: Identifier, data: ByteArray)

Sent by the client when it wants to send a plugin message to the server.

Packet ID: 0x0D

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.EditBook(slot: Varint, entries: list[minecraft.datatypes.String], title: String)

Sent by the client when the player edits a book.

Packet ID: 0x0E

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.QueryEntityTag(transaction_id: Varint, entity_id: Varint)

Sent by the client when the player queries an entity’s tags.

Packet ID: 0x0F

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.Interact(entity_id: Varint, type: InteractionType, target_x: Float | None, target_y: Float | None, target_z: Float | None, hand: Hand | None, sneaking: Boolean)

Sent by the client when the player interacts with an entity.

Packet ID: 0x10

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.JigsawGenerate(location: Position, levels: Varint, keep_jigsaws: Boolean)

Sent by the client when the player generates a jigsaw structure.

Packet ID: 0x11

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.KeepAliveServerbound(id: Long)

Sent by the client to keep the connection alive.

Packet ID: 0x12

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.LockDifficulty(locked: Boolean)

Sent by the client when the player locks the difficulty.

Packet ID: 0x13

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.SetPlayerPosition(x: Double, feet_y: Double, z: Double, on_ground: Boolean)

Updates the player’s XYZ position on the server.

Packet ID: 0x14

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.SetPlayerPositionAndRotation(x: Double, feet_y: Double, z: Double, yaw: Float, pitch: Float, on_ground: Boolean)

Sent by the client when the player moves and rotates.

Packet ID: 0x15

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.SetPlayerRotation(yaw: Float, pitch: Float, on_ground: Boolean)

Sent by the client when the player rotates.

Packet ID: 0x16

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.SetPlayerOnGround(on_ground: Boolean)

Sent by the client when the player moves on the ground.

Packet ID: 0x17

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.MoveVehicle(x: Double, y: Double, z: Double, yaw: Float, pitch: Float)

Sent by the client when the player moves the vehicle.

Packet ID: 0x18

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.PaddleBoat(left_paddle_turning: Boolean, right_paddle_turning: Boolean)

Sent by the client when the player paddles the boat.

Packet ID: 0x19

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.PickItem(slot: Varint)

Sent by the client when the player picks an item.

Packet ID: 0x1A

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.PlaceRecipe(window_id: Byte, recipe: Identifier, make_all: Boolean)

Sent by the client when the player places a recipe.

Packet ID: 0x1B

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ServerPlayerAbilities(flags: Byte)

The vanilla client sends this packet when the player starts/stops flying with the Flags parameter changed accordingly.

Packet ID: 0x1C

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.PlayerAction(status: PlayerActionStatus, location: Position, face: BlockFace, sequence: Varint)

Sent by the client when the player performs an action.

Packet ID: 0x1D

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.PlayerCommand(entity_id: Varint, action_id: PlayerCommandAction, jump_boost: Varint)

Sent by the client when the player uses a command.

Packet ID: 0x1E

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.PlayerInput(sideways: Float, forward: Float, flags: UnsignedByte)

Also known as ‘Input’ packet.

Packet ID: 0x1F

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.Pong(id: Int)

Response to the clientbound packet (Ping) with the same id.

Packet ID: 0x20

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ChangeRecipeBookSettings(book_id: RecipeBookID, book_open: Boolean, filter_active: Boolean)

Sent by the client when the player changes the recipe book settings.

Packet ID: 0x21

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.SetSeenRecipe(recipe_id: Identifier)

Sent by the client when the player sees a recipe.

Packet ID: 0x22

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.RenameItem(item_name: String)

Sent as a player is renaming an item in an anvil. Each keypress in the anvil UI sends a new packet.

Packet ID: 0x23

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ServerResourcePackStatus(resource_pack_status: ResourcePackStatus)

Sends the resource pack status to the server.

Packet ID: 0x24

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.SeenAdvancements(action: SeenAdvancementsAction, tab_id: Identifier | None = None)

Sent by the client when the player sees an advancement.

Packet ID: 0x25

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.SelectTrade(selected_slot: Varint)

Sent by the client when the player selects a trade in a villager’s trade UI.

Packet ID: 0x26

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.SetBeaconEffect(primary_effect: Varint | None = None, secondary_effect: Varint | None = None)

Sent by the client when the player sets the beacon effect.

Packet ID: 0x27

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ServerSetHeldItem(slot: Short)

Sent by the client when the player changes their held item.

Packet ID: 0x28

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ProgramCommandBlock(location: Position, command: String, mode: CommandBlockMode, flags: Byte)

Sent by the client when the player programs a command block.

Packet ID: 0x29

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ProgramCommandBlockMinecart(entity_id: Varint, command: String, track_output: Boolean)

Sent by the client when the player programs a command block minecart.

Packet ID: 0x2A

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.SetCreativeModeSlot(slot: Short, item: Slot)

Sent by the client when the player sets a slot in the creative inventory.

Packet ID: 0x2B

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ProgramJigsawBlock(location: Position, name: Identifier, target: Identifier, pool: Identifier, final_state: String, joint: String)

Sent when Done is pressed on the Jigsaw Block interface.

Packet ID: 0x2C

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.ProgramStructureBlock(location: Position, action: ProgramStructureBlockAction, mode: ProgramStructureBlockMode, name: String, offset_x: Byte, offset_y: Byte, offset_z: Byte, size_x: Byte, size_y: Byte, size_z: Byte, mirror: ProgramStructureBlockMirror, rotation: ProgramStructureBlockRotation, metadata: String, integrity: Float, seed: Varlong, flags: Byte)

Programs a structure block.

Packet ID: 0x2D

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.UpdateSign(location: Position, line_1: String, line_2: String, line_3: String, line_4: String)

Updates a sign.

Packet ID: 0x2E

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.SwingArm(hand: Hand)

Swings the player’s arm.

Packet ID: 0x2F

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.TeleportToEntity(target_player: UUID)

Teleports the player to the entity.

Packet ID: 0x30

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.UseItemOn(hand: Hand, location: Position, face: BlockFace, cursor_x: Float, cursor_y: Float, cursor_z: Float, inside_block: Boolean, sequence: Varint)

Uses an item on a block or entity.

Packet ID: 0x31

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet

class minecraft.packets.play_serverbound.UseItem(hand: Hand, sequence: Varint)

Uses an item.

Packet ID: 0x32

State: State.PLAY

Bound to: Server

classmethod from_bytes(data: BytesIO)

Converts a packet’s data into a packet object.

Parameters:

data (io.BytesIO) – The packet’s data.

Returns:

The packet object.

Return type:

Packet