Ignorance utilizes the power of ENet to provide a reliable UDP networking transport for Mirror Networking.
I'd appreciate a coffee if you use this transport.
"Probably the fastest transport out there for Mirror..." - FSEVincenzo, 2021 (Mirror Discord)_
Ignorance 1.4 is a ENet-powered transport that plugs into the Mirror Networking project. It provides a high-performance implementation of the tried and true native ENet C library which provides reliable UDP communications for your game projects. Variants of ENet are used by Triple-A game companies for their networking. Reliable UDP has a lot of benefits over TCP which was the default in Mirror.
Ignorance was originally intended to replace Unity's LLAPI Transport that ships with Mirror, however since it uses native libraries it was deemed too risky to ship with Mirror itself.
ENet supports a maximum of 4096 peers connected at the same time with up to 255 channels. Channels allow you to split up network communications so you can have channels for data that are mission critical as well as non-essential data. The native library has also been proven to be superior when compared to Unity's own LLAPI library.
Ignorance was used in a recent "Vinesauce is Hope" walking simulation demo which had multiple server instances running with over 300 CCU each. Video clips available here.
Desktop platforms such as Windows, Mac OS and Linux are supported out of the box along with Android and iOS.
Consoles are hit and miss, since they run on slimmed down operating systems.
If ENet can run on it and it's supported by Unity, you're good with Ignorance.
For more info, see the FAQ.
Please note that the repository doesn't include Mirror, instead it only provides you the Ignorance code.
Make sure you have Mirror installed and up to date before installing Ignorance.
ENet-CSharp: slightly modified version included
Mirror Networking: use Asset Store release please, only use Git Master release for bug fixes that you desperately need
Download the Unity Package from Releases that is the latest one. Simply import the Unity Package and Unity will do the rest. Follow the instructions below.
I have included a pre-configured sample scene so you can get started easily. Otherwise add the script called Ignorance to your NetworkManager object, removing any TCP-based or other UDP-based transport. Then set the script to be used in NetworkManagers' "Transport" field.
Failing that you can always ping me in the Mirror Discord and I'll reply as soon as I can. Don't excessively ping me or you'll suffer my wrath.
Bugs that do not have enough details will be closed with #wontfix. Details like your OS, Unity Editor version, any Ignorance errors, etc is essential for a good bug report.
Here's a quick primer.. It might be slightly out of date, but it covers the basics of Ignorance.
Donators: Thanks for helping keep the lights on.
FSE_Vincenzo: Resident master of the ENet way. They are part of Flying Squirrel Entertainment - go check their games out.
JesusLuvsYooh : CCU endurance testing project, ideas, fixes and other awesome stuff
Katori: Helped kickstart the threaded version that evolved into short-lived Ignorance 2.x version, which later became Ignorance Threaded.
BigBoxVR: Pull requests and found a race condition that threatened stability. Also uses Ignorance in Population One, a VR title.
Martin: Pull requests, testing with Dissonance. Great VoIP asset for Unity.
nxrighthere: Author of ENet-CSharp in which I forked and made custom improvements to it.
The Mirror Discord and the others who I have missed. Thanks a lot, you know who you are.
You too can have your name here if you send in a PR. Don't delay, get your PR in today!
To be continued...?