Agar.io Protocol v13

Types

• Unsigned Char (uint8)
• Unsigned Short (uint16)
• Unsigned Int (uint32)
• Signed Char (int8)
• Signed Short (int16)
• Signed Int (int32)
• Float (float32)
• Double (float64)
• Null Terminated UTF8 String (null_utf8)

Client -> Server

Spawn (0x00)

Data Type	Value	Description
uint8	0x00	Opcode
null_utf8	...	Player Name

Spectate (0x01)

Data Type	Value	Description
uint8	0x01	Opcode

Set Target (0x10)

Data Type	Value	Description
uint8	0x10	Opcode
int32	...	Target X
int32	...	Target Y
int32	0 or DKS	Part Of Integrity Checks

Split (0x11)

Data Type	Value	Description
uint8	0x11	Opcode

Eject Mass (0x15)

Data Type	Value	Description
uint8	0x15	Opcode

Captcha Response (0x56)

Data Type	Value	Description
uint8	0x56	Opcode
null_utf8	...	Generated Access Token

Login Token (0x66)

Data Type	Value	Description
uint8	0x66	Opcode
...	...	Generated Access Token

Auth Response (0x71)

Data Type	Value	Description
uint8	0x71	Opcode
...	...	Generated Auth Response

Response to Ping (0xe3)

Data Type	Value	Description
uint8	0xe3	Opcode
...	...	Ping Data

Establish Connection (0xfe)

Data Type	Value	Description
uint8	0xfe	Opcode
uint32	...	Protocol Version (0x0d)

EKS/DKS (0xff)

Data Type	Value	Description
uint8	0xff	Opcode
int32	0	EKS/DKS

Server -> Client

World Update (0x10)

Data Type	Value	Description
uint8	0x10	Opcode
uint16	0	Eat Record Length
...	...	Eat Record
...	...	Update Record (read untill cell id == 0)
uint16	0	Remove Record Length
...	...	Remove Record

Eat Record

Data Type	Value	Description
uint32	0	Eater ID
uint32	0	Victim ID

Remove Record

Data Type	Value	Description
uint32	0	Removing Cell ID

Update Cell Record

Data Type	Value	Description
uint32	...	Cell ID
int32	...	Cell X
int32	...	Cell Y
uint16	...	Cell Radius
uint8	...	Cell Flags
uint8	...	Cell Flags 2 (read if flags & 0x80)
uint8	0	Cell Color (RED) (read if flags & 0x02)
uint8	0	Cell Color (GREEN) (read if flags & 0x02)
uint8	0	Cell Color (BLUE) (read if flags & 0x02)
null_utf8	...	Cell Skin (read if flags & 0x04)
null_utf8	...	Cell Name (read if flags & 0x08)
null_utf8	...	Cell Account (read if flags_2 & 0x04)

Flags

Mask	Description
0x01	Virus
0x02	Has Color
0x04	Has Skin
0x08	Has Name
0x10	Agitated
0x20	Ejected Mass
0x80	Read Next Byte as flags

Flags (for flags_2)

Mask	Description
0x01	Food
0x02	Is Friend
0x04	Has Account Name

Spectator Position Update (0x11)

Data Type	Value	Description
uint8	0x11	Opcode
float32	...	X coordinate
float32	...	Y coordinate
float32	...	Zoom Factor

Reset (0x12)

Data Type	Value	Description
uint8	0x12	Opcode

Add Cell To Owned Cells (0x20)

Data Type	Value	Description
uint8	0x20	Opcode
uint32	...	Cell ID

Leaderboard List (0x33||0x34)

Data Type	Value	Description
uint8	0x33 or 0x34	Opcode
uint16	...	Friend Count (read if op == 0x34)
...	...	LB Record

LB Record

Mask	Description
0x01	place
0x02	player name
0x04	player account id
0x08	its meh
0x10	its friend

Data Type	Value	Description
uint8	...	Flags
uint16	...	(Read if flags & 0x01) Player Place
null_utf8	...	(Read if flags & 0x02) Player Name
null_utf8	...	(Read if flags & 0x04) Player Account

Leaderboard RGB (0x32)

Data Type	Value	Description
uint8	0x32	Opcode
uint32	...	Length
float32	...	Red
float32	...	Green
float32	...	Blue

Initial Border and Dynamic Border (0x40)

Data Type	Value	Description
uint8	0x40	Opcode
float64	...	minx
float64	...	miny
float64	...	maxx
float64	...	maxy
uint32	...	Gamemode
null_utf8	...	Server Name

Captcha Request (0x55)

Data Type	Value	Description
uint8	0x55	Opcode

Shop Info (0x66)

Data Type	Value	Description
uint8	0x66	Opcode
...	...	Info about Shop

Logged In (0x67)

Data Type	Value	Description
uint8	0x67	Opcode

Log Out (0x68)

Data Type	Value	Description
uint8	0x68	Opcode

Player Banned (0x69)

Data Type	Value	Description
uint8	0x69	Opcode
null_utf8	...	Account Name/IP

Auth (0x70)

Data Type	Value	Description
uint8	0x70	Opcode
null_utf8	...	Random String

Outdated Client (request to update agario.core.js) (0x80)

Data Type	Value	Description
uint8	0x80	Opcode

Show Arrow (0xa0)

Data Type	Value	Description
uint8	0xa0	Opcode
int16	...	x
int16	...	y
null_str8	...	(optional) (sent only once) player name

Remove Arrow (0xa1)

Data Type	Value	Description
uint8	0xa1	Opcode

Ping (0xe2)

Data Type	Value	Description
uint8	0xe2	Opcode
...	...	Random Data

DKS2 (0xf1)

Data Type	Value	Description
uint8	0xf1	Opcode
int32	DKS2	DKS2

Compressed (0xff)

Data Type	Value	Description
uint8	0xff	Opcode
uint32	...	Decompressed Length
...	...	Sub-Packet