poetahto / mirage Goto Github PK

Mirage is a rolling-release high level API for the Unity Game Engine that provides a powerful, yet easy to use networking API. Be it a online MMO, co-op adventure game or a first person shooter, Mirage improves your networked projects' probability of success significantly. With its modular structure, Mirage lets you unleash maximum performance out of your networking.

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

Mirage is a rolling-release network stack. With every update, you get the latest features and bug fixes. You are encouraged to diagnose, report and help fix bugs that you find: Issue tickets will be investigated, feature requests are considered and pull requests are regularly reviewed.

Mirage is built by passionate network engineers and is backed by a friendly community.

To install Mirage, follow these steps:

1. Mirage requires at least Unity 2020 LTS. You may install Unity 2020 LTS via the Unity website or via the Unity Hub.
   You may use newer versions, however LTS versions are strongly recommended as newer versions can contain bugs, glitches or just flat out break game projects.
2. Start a new project or open your existing one. If opening an exsiting one, it is strongly recommended to back it up before installing Mirage.
3. Add the OpenUPM registry. Click on the Edit menu, then select Project settings..., select Package Manager and add a scoped registry like so:
   Name: OpenUPM
   Url: https://package.openupm.com
   Scopes:
   • com.cysharp.unitask
   • com.openupm
   • com.miragenet
4. Close the project settings.
5. Open the package manager by clicking on the Window menu and selecting Package Manager. Then select Packages, My Registries, select the latest version of Mirage and click install, like so:
6. You may come back to the package manager at any time to uninstall Mirage or upgrade it.

If you've got a project already using Mirror and you want to migrate it to Mirage, it's recommended to check out our Migration Guide for a smooth transition. Also check the heading below, as there are some major differences between Mirage and the other network library.

Mirage has some notable differences from its distant sister, Mirror. The table below briefly details them:

Some notable features that Mirage has:

• Fast play mode support
• Clients can connect to multiple servers - for example, be connected to a chat server while connected to a game server
• Components can be added in child objects
• Modular API: You only use the components you need
• Error handling
• Version defines
• Server Rpcs can return values
• Bit packing to help compress values and reduce bandwidth

Peeking under the hood, Mirage is built upon fundamental pillars:

• Mirage avoids singletons and static state in general
• Mirage follows the SOLID principles
• Mirage has high
• Mirage has low

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

1. Install the git client
2. Clone this repo

   cd /path/to/somewhere/on/your/disk
   mkdir MirageNetworking
   git clone https://github.com/MirageNet/Mirage.git MirageNetworking

3. Open the newly cloned repo in Unity 2020 LTS or later.

1. Install git or use your favorite git client (Fork, SourceTree, etc)
2. As administrator, clone this repo with symbolic links support using Git Bash:

   cd C:\UnityProjects\DontReallyUseThisExamplePath
   mkdir MirageNetworking
   git clone -c core.symlinks=true https://github.com/MirageNet/Mirage.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 Mirage but Unity will not see the examples.
3. Open in Unity 2020 LTS or later.

Mirage supports multiple ways of transporting data:

• Native UDP socket (default on Windows, Mac and Linux) with fallback to C# UDP Sockets (default on other platforms)
• Steam (Facepunch Steamworks)
• WebSocket for WebGL clients (SimpleWebSocket)

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request 😃

The team will review it ASAP and give it the stamp of approval, ask for changes or decline it with a detailed explaination.

Thank you for using Mirage and we hope to see your project be successful!