Ignorance: A reliable UDP based transport for vis2k's Mirror High-level API which is a much improved version of UNET. This transport uses ENET as the network backend via nxrighthere's ENet-CSharp wrapper.
This transport is currently developed and actively used by Oiran Studio.
If you use this, I'd appreciate a coffee to keep me caffeinated.
- Grab a release from the releases page or compile it from source.
- Make sure you have Mirror installed in your project. Ignorance WILL NOT function without it!
- Extract the release archive into your project, maybe under Assets/Packages/IgnoranceTransport.
- Open your project with Unity and let it detect the new transport.
- Follow "How to use" below.
NOTE: If you compile from the transport source code, you will need to grab the following files: enet.dll, enet.bundle/dylib and libenet.so from the latest release and copy them to your project folder as well as plopping the newly compiled DLL into your Unity Project. Failure to follow this important instruction will cause random things to happen, and/or Unity Editor crashes!
x64 Runtime Platforms only! This is due to the dependencies only being compiled for x64. Tested and confirmed working on Unity LTS 2017.4, the recommended version of Unity to use with Mirror. May work with newer versions of Unity as long as Mirror supports them.
Ignorance relies on ENet-CSharp to do most of the heavy-lifting. I simply hook into the wrapper and perform magic tricks to make it all work.
Ignorance also has a dependency on Mirror which is a battle-tested, improved MMO-scale version of UNET that is leaps and bounds better than what Unity could ever do. Mirror was built against Unity LTS 2017.4 but as long as you have a recent release of Mirror in your project, the Ignorance transport will happily be available as a TransportLayer option. This dependency is required to make use of the TransportLayer class.
tldr: ENet-CSharp, Mirror, Unity Engine 2017.4 LTS. DLLs are included to build against for Mirror and Unity Engine are in the repo.
- Follow instructions above. If errors occur, open a Issue ticket.
- In your Mirror NetworkManager child class, you would do:
public override void InitializeTransport() {
Transport.layer = new IgnoranceTransport();
}...to start using Ignorance as the transport mechanism. The default in Mirror is Telepathy which is TCP. The other out-of-the-box option is Unity's LLAPI but that's like dealing with cancer - Avoid.
- Continue programming your stuff as normal.
There are some exposed functions that network people might find nice to fiddle with. Since version 1.0.1, I have exposed the compression and configurable client timeout options. However, you cannot access these functions directly, but if you do the following inside your NetworkManager class, for example OnStartServer or OnStartClient overrides:
(Transport.layer as IgnoranceTransport).SomeExposedFunction();Then you can call the exposed functions that you desire.
Do not try to cast the Transport.layer as a IgnoranceTransport class if you're using another transport. It will NOT work.
Why Ignorance? Why not name it something something Reliable UDP Transport for Mirror something something?
UDP ignores (hence the name) a lot of stuff that TCP fusses over and since UDP is designed to be a scattershot shotgun approach to networking, there's no promises that UDP packets will get from A to B without going through hell and back. Reliable UDP tries to mimic TCP to some extent with the resending of packets until they land at the destination.
This makes since in some usage cases, but you should really consider TCP if you're using networking in a mission-critical environment. There's a reason why big name MMOs use TCP to keep everything in check. However, for some usage cases TCP may be a little overkill, so UDP is preferred.
nxrighthere: Debugging my broken code and identifying my packet code fuckups
Draknith (on Mirror Discord): Testing and mapping Reliable/Unreliable channels in Mirror to ENET Channels, testing.
vis2k: The madman behind the scenes that made Mirror happen!
Mirror Discord: Encouragement, Memes, LOLs and just awesome folks.