← Back to Index

AddPlayerPacket (12)

Add Player
A new player joins the game; the server sends this packet to the other players.
Field Name Type Field Index Description
UUID (Required) mce::UUID 0 The player's unique account UUID, used to match the entry to a player list entry and skin.

mce::UUID

Field Name Type Field Index Description
Most Significant Bits (Required) uint64 0
Least Significant Bits (Required) uint64 1
Player Name (Required) string 1 Display name of the player.
Target Runtime ID (Required) ActorRuntimeID 2 Runtime ID of the spawned player actor.

ActorRuntimeID

Field Name Type Field Index Description
Actor Runtime ID (Required) varuint64 0
Platform Chat Id (Required) string 3 Platform-specific online ID used for platform chat.
Position (Required) Vec3 4 Spawn position of the player, with the actor height offset already applied.

Vec3

Field Name Type Field Index Description
X (Required) float 0
Y (Required) float 1
Z (Required) float 2
Velocity (Required) Vec3 5 Initial velocity of the player.

Vec3

Field Name Type Field Index Description
X (Required) float 0
Y (Required) float 1
Z (Required) float 2
Rotation (Required) Vec2 6 Body rotation (pitch, yaw) in degrees.

Vec2

Field Name Type Field Index Description
X (Required) float 0
Y (Required) float 1
Y-Head Rotation (Required) float 7 Head yaw rotation in degrees.
Carried Item (Required) NetworkItemStackDescriptor 8 The item currently held by the player.
Player Game Type (Required) varint32 9 The player's game mode.
Enum Values:
Index Value
0 Undefined
1 Survival
2 Creative
3 Adventure
4 Default
5 Spectator
6 WorldDefault
Entity Data (Required) SynchedActorDataList 10 Synched actor data (data items) for the player entity.

SynchedActorDataList

Field Name Type Field Index Description
Data (Required) array<DataItemEntry> 0

DataItemEntry (Array Item)

Field Name Type Field Index Description
ID (Required) varuint32 0
Payload (Required) oneOf 1
oneOf<DataItemBytePayload, DataItemShortPayload, DataItemIntPayload, DataItemFloatPayload, DataItemStringPayload, DataItemCompoundTagPayload, DataItemPosPayload, DataItemInt64Payload, DataItemVec3Payload>:
Control Value [uint32] Type Details
0 DataItemBytePayload -
1 DataItemShortPayload -
2 DataItemIntPayload -
3 DataItemFloatPayload -
4 DataItemStringPayload -
5 DataItemCompoundTagPayload -
6 DataItemPosPayload -
7 DataItemInt64Payload -
8 DataItemVec3Payload -
Synched Properties (Required) PropertySyncData 11 Synched entity property values for the player.

PropertySyncData

Field Name Type Field Index Description
Int Entries List (Required) array<PropertySyncData::PropertySyncIntEntry> 0

PropertySyncData::PropertySyncIntEntry (Array Item)

Field Name Type Field Index Description
Property Index (Required) varuint32 0
Data (Required) varint32 1
Float Entries List (Required) array<PropertySyncData::PropertySyncFloatEntry> 1

PropertySyncData::PropertySyncFloatEntry (Array Item)

Field Name Type Field Index Description
Property Index (Required) varuint32 0
Data (Required) float 1
Abilities Data (Required) SerializedAbilitiesData 12 The player's permissions and ability layers.

SerializedAbilitiesData

Field Name Type Field Index Description
Target Player Raw Id (Required) int64 0
Player Permissions (Required) int8 1
Enum Values:
Index Value
0 Visitor
1 Member
2 Operator
3 Custom
Command Permissions (Required) uint8 2
Enum Values:
Index Value
0 Any
1 GameDirectors
2 Admin
3 Host
4 Owner
5 Internal
Layers (Required) array<SerializedAbilitiesDataSerializedLayer> 3

SerializedAbilitiesDataSerializedLayer (Array Item)

Field Name Type Field Index Description
SerializedLayer (Required) uint16 0
AbilitiesSet (Required) uint32 1
AbilityValues (Required) uint32 2
FlySpeed (Required) float 3
VerticalFlySpeed (Required) float 4
WalkSpeed (Required) float 5
Actor Links (Required) array<ActorLink> 13 Actor links describing what the player is riding or linked to.

ActorLink (Array Item)

Field Name Type Field Index Description
Target A (Required) ActorUniqueID 0

ActorUniqueID

Field Name Type Field Index Description
Actor Unique ID (Required) varint64 0
Target B (Required) ActorUniqueID 1

ActorUniqueID

Field Name Type Field Index Description
Actor Unique ID (Required) varint64 0
Type (Required) uint8 2
Enum Values:
Index Value
0 None
1 Riding
2 Passenger
Immediate (Required) boolean 3
Passenger Initiated (Required) boolean 4 Whether the link was changed by the passenger
Vehicle Angular Velocity (Required) float 5
Device Id (Required) string 14 A unique device id obtained from the connection request.
Build Platform (Required) int32 15 The device/build platform the player is on.
Enum Values:
Index Value
0 Google
1 iOS
2 OSX
3 Amazon
4 Win32
5 Dedicated
6 Sony
7 Nx
8 Xbox
9 Linux
10 Unknown