Telepathy

Simple, message based, allocation free MMO Scale TCP networking in C#. And no magic.

Telepathy was designed with the KISS Principle in mind.

Telepathy is fast and extremely reliable, designed for MMO scale Networking.

Telepathy uses framing, so anything sent will be received the same way.

Telepathy is raw C# and made for Unity & Mirror | DOTSNET.

What makes Telepathy special?

Telepathy was originally designed for uMMORPG after 3 years in UDP hell.

We needed a library that is:

• Stable & Bug free: Telepathy uses only 700 lines of code. There is no magic.
• High performance: Telepathy can handle thousands of connections and packages.
• Concurrent: Telepathy uses two threads per connection. It can make heavy use of multi core processors.
• Allocation Free: Telepathy has no allocations in hot path. Avoids GC spikes in Games.
• Simple: Telepathy wraps all the insanity behind Connect/Send/Disconnect/Tick.
• Message based: sending messages A,B,C are received as A,B,C. Never as AB,C or BC,A.

MMORPGs are insanely difficult to make and we created Telepathy so that we would never have to worry about low level Networking again.

See also: SyncThing article on KCP vs. TCP.

What about...

• Async Sockets: perform great in regular C# projects, but poorly when used in Unity.
• UDP vs. TCP: Minecraft and World of Warcraft are two of the biggest multiplayer games of all time and they both use TCP networking. There is a reason for that.

Using the Telepathy Server

…

Using the Telepathy Client

…

Unity Integration

Here is a very simple MonoBehaviour script for Unity. It's really just the above code with logging configured for Unity's Debug.Log:

…

Make sure to enable 'run in Background' for your project settings, which is a must for all multiplayer games. Then build it, start the server in the build and the client in the Editor and press Space to send a test message.

Benchmarks

Real World

Telepathy is constantly tested in production with uMMORPG. We recently tested 500 players all broadcasting to each other in the worst case scenario, without issues.

We had to stop the test because we didn't have more players to spawn clients.

Connections Test

We also test only the raw Telepathy library by spawning 1 server and 1000 clients, each client sending 100 bytes 14 times per second and the server echoing the same message back to each client. This test should be a decent example for an MMORPG scenario and allows us to test if the raw Telepathy library can handle it.

Test Computer: 2015 Macbook Pro with a 2,2 GHz Intel Core i7 processor.

Test Results:

Clients	CPU Usage	Ram Usage	Bandwidth Client+Server	Result
128	7%	26 MB	1-2 MB/s	Passed
500	28%	51 MB	3-4 MB/s	Passed
1000	42%	75 MB	3-5 MB/s	Passed

You can run this test yourself by running the provided LoadTest