10 releases
Uses old Rust 2015
0.3.1 | Apr 23, 2017 |
---|---|
0.3.0 | Apr 22, 2017 |
0.2.2 | Mar 9, 2017 |
0.1.5 | Mar 4, 2017 |
#44 in #packets
47 downloads per month
4MB
8K
SLoC
Contains (static library, 2MB) c/windows/sodium-debug.lib, (static library, 1.5MB) c/windows/sodium-release.lib
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:
- Connection oriented
- Encrypts and sign packets
- All packets are delivered over UDP
- 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 is sent across 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 limiting incoming connections at the UDP protocol level.
How does it work?
Please refer to the second half of this whitepaper: Why can't I send UDP packets from a browser?
For a complete technical specification, read the netcode 1.0 standard.
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
- Create bindings for netcode.io for your favorite language
- Port netcode.io to your favorite language (eg. C#, Rust, Golang, Java, Lua, Python, Ruby...)
- We welcome anybody who would like to volunteer to perform a security audit of the code
- Develop a testing framework to guarantee that different languages implementations conform to the standard
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
-
Silver Sponsors
-
Bronze Sponsors
And by individual supporters on Patreon. Thank you. You make this possible!
License
Dependencies
~21MB
~190K SLoC