← Back to Index

ClientboundMapItemDataPacket (67)

Map item data including pixels, decorations, and creation info
Field Name Type Field Index Description
Map ID (Required) ActorUniqueID 0

ActorUniqueID

Field Name Type Field Index Description
Actor Unique ID (Required) varint64 0
Dimension (Required) uint8 1
Is Locked (Required) boolean 2
Map Origin (Required) BlockPos 3

BlockPos

Field Name Type Field Index Description
X (Required) varint32 0
Y (Required) varint32 1
Z (Required) varint32 2
Creation Map IDs array<ActorUniqueID> 4 Map IDs for newly created maps. Present only for Creation updates.

ActorUniqueID (Array Item)

Field Name Type Field Index Description
Actor Unique ID (Required) varint64 0
Scale int8 5 Map scale. Present whenever any of Creation, DecorationUpdate or TextureUpdate is set.
Tracked Actor IDs array<MapItemTrackedActor UniqueId> 6 Unique IDs of tracked actors paired with the Decorations list. Present only for DecorationUpdate.

MapItemTrackedActor UniqueId (Array Item)

Field Name Type Field Index Description
Type (Required) int32 0 Discriminator for the optional Entity ID / Block Position payload.
Enum Values:
Index Value
0 Entity
1 BlockEntity
2 Other
Entity ID ActorUniqueID 1 Tracked entity's unique ID. Present only when Type is Entity.

ActorUniqueID

Field Name Type Field Index Description
Actor Unique ID (Required) varint64 0
Block Position BlockPos 2 Tracked block entity position. Present only when Type is BlockEntity.

BlockPos

Field Name Type Field Index Description
X (Required) varint32 0
Y (Required) varint32 1
Z (Required) varint32 2
Decorations array<MapDecoration> 7 Map decorations paired with Tracked Actor IDs. Present only for DecorationUpdate.

MapDecoration (Array Item)

Field Name Type Field Index Description
Image Type (Required) int8 0
Enum Values:
Index Value
0 MarkerWhite
1 MarkerGreen
2 MarkerRed
3 MarkerBlue
4 XWhite
5 TriangleRed
6 SquareWhite
7 MarkerSign
8 MarkerPink
9 MarkerOrange
10 MarkerYellow
11 MarkerTeal
12 TriangleGreen
13 SmallSquareWhite
14 Mansion
15 Monument
16 NoDraw
17 VillageDesert
18 VillagePlains
19 VillageSavanna
20 VillageSnowy
21 VillageTaiga
22 JungleTemple
23 WitchHut
24 TrialChambers
25 Count
Rotation (Required) uint8 1
X (Required) uint8 2
Y (Required) uint8 3
Label (Required) string 4
Color (Required) Color 5

Color

Field Name Type Field Index Description
Color (Required) int32 0
Width varint32 8 Width of the updated pixel region. Present only for TextureUpdate.
Height varint32 9 Height of the updated pixel region. Present only for TextureUpdate.
Start X varint32 10 X-coordinate of the updated pixel region. Present only for TextureUpdate.
Start Y varint32 11 Y-coordinate of the updated pixel region. Present only for TextureUpdate.
Pixels array<uint32> 12 ARGB pixel data for the updated region. Present only for TextureUpdate.