MirrorNG is a high level Networking API for Unity.

MirrorNG is built and tested for MMO Scale Networking by the developers of Cubica.

MirrorNG is optimized for ease of use and probability of success.

With MirrorNG the objects in the client are mirror images of the objects in the server. MirrorNG provides all the tools necessary to keep them in sync and pass messages between them.

The Server & Client are ONE project in order to achieve an order of magnitude gain in productivity.

When migrating a project from Mirror to MirrorNG, these will be the most notable differences.

MirrorNG has many new features

• MirrorNG supports fast domain reload
• Components can be added in child objects
• Your client can connect to multiple servers. For example chat server and game server
• Modular, use only the components you need.
• Error handling
• Version defines
• Server Rpcs can return values

If you look under the hood, the code base has some significant differences based on the core values of each project

• MirrorNG follows the SOLID principles.
• MirrorNG avoids singletons and static state in general.
• MirrorNG has high
• MirrorNG has low
• MirrorNG values code quality, Mirror values API stability

If you want to make a game with MirrorNG, the preferred installation method is Unity Package Manager.

Use unity 2019.3 or later.

1. Install git
2. Open your project in unity
3. Install UniTask using Unity Package Manager
4. Click on Windows -> Package Manager
5. Click on the plus sign on the left and click on "Add package from git URL..."
6. enter https://github.com/MirrorNG/MirrorNG.git?path=/Assets/Mirror
7. Unity will download and install MirrorNG
8. Set a Scoped Register to see updates

This is how I do it for Cubica because unity will display all versions of MirrorNG and allow me to switch amongst them.

1. Install git
2. Install node.js 12
3. Install openupm
4. install MirrorNG in your project:

   cd YOUR_PROJECT
   openupm add com.mirrorng.mirrorng 

5. Open your project in Unity

If you prefer some pain, you can download it directly from the release section and add it to your project. You will need to manually install UniTask and Cecil.

If you want to contribute to MirrorNG, follow these steps:

1. Install git
2. clone this repo
3. Open in unity 2019.4.x or later

1. Install git or use your favorite git client
2. as administrator, clone this repo with symbolic links support:

   git clone -c core.symlinks=true https://github.com/MirrorNG/MirrorNG.git

   It you don't want to use administrator, add symlink support to your account. If you don't enable symlinks, you will be able to work on MirrorNG but Unity will not see the examples.
3. Open in unity 2019.4.x or later

Here is a list of some transports supported by NG and how they compare to each other

There are several ways to contribute to this project:

• Pull requests for bug fixes and features are always appreciated.
• Pull requests to improve the documentation is also welcome
• Make tutorials on how to use this
• Test it and open issues
• Review existing pull requests
• Donations

When contributing code, please keep these things in mind:

• KISS principle. Everything needs to be as simple as possible.
• An API is like a joke, if you have to explain it is not a good one. Do not require people to read the documentation if you can avoid it.
• Follow C# code conventions.
• Follow SOLID principles as much as possible.
• Keep your pull requests small and obvious, if a PR can be split into several small ones, do so.