netcode.io

netcode.io is a simple protocol for creating secure client/server connections over UDP.

It’s designed for games like agar.io that shunt players from a main website or web backend to a number of dedicated server instances, with each dedicated server having some maximum number of players.

It has the following features:

1. Connection oriented
2. Encrypts and sign packets
3. All packets are delivered over UDP
4. Only authenticated clients can connect to dedicated servers

What are the benefits?

Simplicity

netcode.io is a simple protocol that can easily be incorporated into a client, dedicated server or web backend.

It has no external dependencies except libsodium, which is widely used and well tested.

Full bidirectional transfer of data

Once a netcode.io connection is established, data can be exchanged between client and server at any rate, bidirectionally.

No head of line blocking

Data sent across netcode.io is sent over UDP so it's not subject to head of line blocking. No head of line blocking means games play better, as time series data like player inputs and object positions are transmitted as quickly as possible, without being artificially delayed waiting for dropped packets to be resent.

Connection rate limiting can be performed on the web backend

Because netcode.io servers only accept connections from clients with short-lived connect tokens, traditional web rate limiting can be applied to the REST calls that generate connect tokens for authenticated users, instead of rate limit incoming connections at the UDP protocol level for each dedicated server instance.

How does it work?

Please refer to the second half of this whitepaper: Why can't I send UDP packets from a browser?

How can I help?

This is an open source project and we welcome contributions. Please join us!

Here are some things that we think would be helpful:

• Provide feedback on the reference implementation
• Study the code, and look for flaws and weaknesses
• Implement additional tests. Find ways to break the code!
• We welcome anybody who would like to volunteer to perform a security audit of the code
• Port netcode.io to your favorite language (eg. C#, Rust, Golang).
• Create bindings for netcode.io for your favorite language
• Help me finish writing the spec and provide feedback on the spec!
• Develop a testing framework to guarantee that different languages implementations confirm to the spec.

Please let me know if you have any more ideas, and feel free to ask questions and get involved by logging issues.

Author

The author of this library is Glenn Fiedler, a recognized expert in the field of game network programming with over 15 years experience in the game industry.

Glenn is currently writing an article series about the development of this library called Building a Game Network Protocol.

You can support Glenn's work writing articles and open source code via Patreon.

Sponsors

netcode.io is generously sponsored by:

• Gold Sponsors

• Cloud Imperium Games

• Silver Sponsors

• The Network Protocol Company

• Bronze Sponsors

• Kite & Lightning
• Data Realms

And by individual supporters on Patreon. Thank you. You make this possible!

License

BSD 3-Clause license.