Game Messages

This page describes the game messages structure, all kinds of game messages available, and their purpose.

Message ID	Name
0	Unused
1	NETMSGTYPE_SV_MOTD
2	NETMSGTYPE_SV_BROADCAST
3	NETMSGTYPE_SV_CHAT
4	NETMSGTYPE_SV_KILLMSG
5	NETMSGTYPE_SV_SOUNDGLOBAL (DDNet Only)
6	NETMSGTYPE_SV_TUNEPARAMS
7	Unused
8	NETMSGTYPE_SV_READYTOENTER
9	NETMSGTYPE_SV_WEAPONPICKUP
10	NETMSGTYPE_SV_EMOTICON
11	NETMSGTYPE_SV_VOTECLEAROPTIONS
12	NETMSGTYPE_SV_VOTEOPTIONLISTADD
13	NETMSGTYPE_SV_VOTEOPTIONADD
14	NETMSGTYPE_SV_VOTEOPTIONREMOVE
15	NETMSGTYPE_SV_VOTESET
16	NETMSGTYPE_SV_VOTESTATUS
17	NETMSGTYPE_CL_SAY
18	NETMSGTYPE_CL_SETTEAM
19	NETMSGTYPE_CL_SETSPECTATORMODE
20	NETMSGTYPE_CL_STARTINFO
21	NETMSGTYPE_CL_CHANGEINFO (DDNet Only)
22	NETMSGTYPE_CL_KILL
23	NETMSGTYPE_CL_EMOTICON
24	NETMSGTYPE_CL_VOTE
25	NETMSGTYPE_CL_CALLVOTE

INFO

• SV : Server sending to client
• CL : Client sending to server

1 - NETMSGTYPE_SV_MOTD

This message sends the server message of the day to a client.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Message	String	The message of the day text, usually taken from the server configuration.

2 - NETMSGTYPE_SV_BROADCAST

This message sends a broadcast message to a specific client.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Message	String	The broadcast text shown to the client.

3 - NETMSGTYPE_SV_CHAT

This message sends a chat line to the client. It supports all-chat, team chat, and whisper chat.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Mode	Integer	Chat mode: 0 = no chat, 1 = all, 2 = team, 3 = whisper.
Client ID	Integer	The client ID of the player who sent the chat message. -1 is used for server/system chat.
Target ID	Integer	The whisper target client ID. -1 when the message is not a whisper.
Message	String	The chat text.

4 - NETMSGTYPE_SV_KILLMSG

This message informs clients about a player death and the source of the kill.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Killer	Integer	Client ID of the killer (0 to 63), or a special value when the kill has no normal source: -2 = self-kill by kill command, -1 = world/environment kill.
Victim	Integer	Client ID of the player that died (0 to 63).
Weapon	Integer	Weapon identifier (0 to 5) for the kill, or a special value: -3 = self-kill by kill command, -2 = world/environment kill, -1 = team-locked weapon.
Mode Special	Integer	Extra mode-specific value used by the client to render the kill message.

5 - NETMSGTYPE_SV_SOUNDGLOBAL

This message tells the client to play a global sound.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Sound ID	Integer	Sound ID to play globally.

6 - NETMSGTYPE_SV_TUNEPARAMS

This message sends tuning parameters to a client so the client can match the server physics settings.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Show Large Structure

Field	Type	Description
Ground Control Speed	Integer	Maximum horizontal control speed while grounded.
Ground Control Acceleration	Integer	Horizontal acceleration while grounded.
Ground Friction	Integer	Friction applied while grounded.
Ground Jump Impulse	Integer	Vertical impulse applied by a ground jump.
Air Jump Impulse	Integer	Vertical impulse applied by an air jump.
Air Control Speed	Integer	Maximum horizontal control speed while in the air.
Air Control Acceleration	Integer	Horizontal acceleration while in the air.
Air Friction	Integer	Friction applied while in the air.
Hook Length	Integer	Maximum hook length.
Hook Fire Speed	Integer	Speed at which the hook is fired.
Hook Drag Acceleration	Integer	Acceleration used while dragging with the hook.
Hook Drag Speed	Integer	Speed used while dragging with the hook.
Gravity	Integer	World gravity value.
Velramp Start	Integer	Start of the velocity ramp.
Velramp Range	Integer	Range of the velocity ramp.
Velramp Curvature	Integer	Curvature of the velocity ramp.
Gun Curvature	Integer	Projectile curvature for the gun.
Gun Speed	Integer	Projectile speed for the gun.
Gun Lifetime	Integer	Lifetime, in ticks, for gun projectiles.
Shotgun Curvature	Integer	Projectile curvature for shotgun pellets.
Shotgun Speed	Integer	Projectile speed for shotgun pellets.
Shotgun Speeddiff	Integer	Speed variation factor for shotgun spread.
Shotgun Lifetime	Integer	Lifetime, in ticks, for shotgun projectiles.
Grenade Curvature	Integer	Projectile curvature for grenades.
Grenade Speed	Integer	Projectile speed for grenades.
Grenade Lifetime	Integer	Lifetime, in ticks, for grenades.
Laser Reach	Integer	Maximum laser reach.
Laser Bounce Delay	Integer	Delay between laser bounces.
Laser Bounce Num	Integer	Number of laser bounces.
Laser Bounce Cost	Integer	Ammunition cost for each laser bounce.
Laser Damage	Integer	Laser damage value.
Player Collision	Integer	Enables or disables player collision.
Player Hooking	Integer	Enables or disables hooking players.

8 - NETMSGTYPE_SV_READYTOENTER

This message tells the client that it may enter the game.

• Vital : ✅
• Instant Sending : ✅
• Sending Path : Server -> Client

Structure:

Empty payload

9 - NETMSGTYPE_SV_WEAPONPICKUP

This message informs a client that it picked up a weapon.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Weapon	Integer	Weapon ID that was picked up: 0 = hammer, 1 = gun, 2 = shotgun, 3 = grenade, 4 = laser.

10 - NETMSGTYPE_SV_EMOTICON

This message tells clients to display an emoticon above a player.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Client ID	Integer	The client ID of the player showing the emoticon.
Emoticon	Integer	Emoticon ID to display: 0 = oop, 1 = exclamation, 2 = hearts, 3 = drop, 4 = dotdot, 5 = music, 6 = sorry, 7 = ghost, 8 = sushi, 9 = splattee, 10 = deviltee, 11 = zomg, 12 = zzz, 13 = wtf, 14 = eyes, 15 = question.

11 - NETMSGTYPE_SV_VOTECLEAROPTIONS

This message clears the client-side vote option list.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Empty payload

12 - NETMSGTYPE_SV_VOTEOPTIONLISTADD

This message adds a batch of vote options to the client-side vote option list.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Num. Options	Integer	Number of vote option descriptions included in the message.
Description 0	String	First vote option description.
...	...	...
Description N	String	Last vote option description.

13 - NETMSGTYPE_SV_VOTEOPTIONADD

This message adds a single vote option to the client-side vote option list.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Description	String	Vote option description to add.

14 - NETMSGTYPE_SV_VOTEOPTIONREMOVE

This message removes a single vote option from the client-side vote option list.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Description	String	Vote option description to remove.

15 - NETMSGTYPE_SV_VOTESET

This message starts, updates, or ends a vote on the client.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Client ID	Integer	Client ID that created the vote, or -1 when no creator should be shown.
Type	Integer	Vote type: 0 = unknown, 1 = start option, 2 = start kick, 3 = start spectator, 4 = abort, 5 = pass, 6 = fail.
Timeout	Integer	Remaining vote timeout in seconds, or 0 when the vote is closed.
Description	String	Vote description shown to the client. Empty when the vote is closed.
Reason	String	Vote reason shown to the client. Empty when the vote is closed.

16 - NETMSGTYPE_SV_VOTESTATUS

This message updates the client with the current vote count.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Server -> Client

Structure:

Field	Type	Description
Yes	Integer	Number of yes votes.
No	Integer	Number of no votes.
Pass	Integer	Number of players that have not voted.
Total	Integer	Total number of eligible voters.

17 - NETMSGTYPE_CL_SAY

This message sends a chat message from the client to the server.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Client -> Server

Structure:

Field	Type	Description
Mode	Integer	Chat mode: 0 = no chat, 1 = all, 2 = team, 3 = whisper.
Target	Integer	Whisper target client ID, or -1 when the message is not a whisper.
Message	String	Chat text entered by the client.

18 - NETMSGTYPE_CL_SETTEAM

This message requests a team change from the client.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Client -> Server

Structure:

Field	Type	Description
Team	Integer	Requested team: -1 = spectators, 0 = red team, 1 = blue team.

19 - NETMSGTYPE_CL_SETSPECTATORMODE

This message changes how the client is spectating.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Client -> Server

Structure:

Field	Type	Description
Spectator ID	Integer	Client ID being spectated, or -1 (SPEC_FREEVIEW) for free view mode.

20 - NETMSGTYPE_CL_STARTINFO

This message sends the player's initial player information to the server.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Client -> Server

Structure:

Field	Type	Description
Name	String	Player name.
Clan	String	Player clan.
Country	Integer	Country code for the player.
Skin Part 0	String	Body skin part name.
Skin Part 1	String	Marking skin part name.
Skin Part 2	String	Decoration skin part name.
Skin Part 3	String	Hands skin part name.
Skin Part 4	String	Feet skin part name.
Skin Part 5	String	Eyes skin part name.
Use Custom Color 0	Integer	Whether the body skin part uses a custom color.
Use Custom Color 1	Integer	Whether the marking skin part uses a custom color.
Use Custom Color 2	Integer	Whether the decoration skin part uses a custom color.
Use Custom Color 3	Integer	Whether the hands skin part uses a custom color.
Use Custom Color 4	Integer	Whether the feet skin part uses a custom color.
Use Custom Color 5	Integer	Whether the eyes skin part uses a custom color.
Skin Part Color 0	Integer	Body skin part color.
Skin Part Color 1	Integer	Marking skin part color.
Skin Part Color 2	Integer	Decoration skin part color.
Skin Part Color 3	Integer	Hands skin part color.
Skin Part Color 4	Integer	Feet skin part color.
Skin Part Color 5	Integer	Eyes skin part color.

21 - NETMSGTYPE_CL_CHANGEINFO

This message sends updated player information (name, clan, skin, colors) to the server.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Client -> Server

Structure:

Field	Type	Description
Name	String	Player name.
Clan	String	Player clan.
Country	Integer	Country code for the player.
Skin	String	Skin name.
Use Custom Color	Integer	Whether the player uses custom skin colors.
Color Body	Integer	Body color value.
Color Feet	Integer	Feet color value.

22 - NETMSGTYPE_CL_KILL

This message requests the server to kill the client's current character.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Client -> Server

Structure:

Empty payload

23 - NETMSGTYPE_CL_EMOTICON

This message sends an emoticon request from the client to the server.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Client -> Server

Structure:

Field	Type	Description
Emoticon	Integer	Emoticon ID selected by the client: 0 = oop, 1 = exclamation, 2 = hearts, 3 = drop, 4 = dotdot, 5 = music, 6 = sorry, 7 = ghost, 8 = sushi, 9 = splattee, 10 = deviltee, 11 = zomg, 12 = zzz, 13 = wtf, 14 = eyes, 15 = question.

24 - NETMSGTYPE_CL_VOTE

This message sends the client's vote choice to the server.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Client -> Server

Structure:

Field	Type	Description
Vote	Integer	Vote choice: -1 = no, 0 = pass, 1 = yes.

25 - NETMSGTYPE_CL_CALLVOTE

This message requests the server to start or force a vote.

• Vital : ✅
• Instant Sending : ❌
• Sending Path : Client -> Server

Structure:

Field	Type	Description
Type	String	Vote type requested by the client.
Value	String	Value for the vote, such as a player name or team.
Reason	String	Reason shown for the vote.
Force	Integer	Whether the vote should be forced by an authenticated client.

---