![mMirror Logo](https://user-images.githubusercontent.com/16416509/119120944-6db26780-ba5f-11eb-9cdd-fc8500207f4d.png) **It's only the dreamers who ever move mountains.** Original Concept Art for Games that made us dream. Copyright Blizzard, Blizzard, Riot Games, Joymax in that order.

Original Concept Art for Games that made us dream. Copyright Blizzard, Blizzard, Riot Games, Joymax in that order.

## Mirror Mirror is a **high level** Networking library for **Unity 2019/2020 LTS**, compatible with different **low level** [Transports](https://github.com/vis2k/Mirror#low-level-transports). Mirror is for indie games & small [MMOs](https://www.youtube.com/watch?v=mDCNff1S9ZU), made by the developers of [uMMORPG](https://assetstore.unity.com/packages/templates/systems/ummorpg-components-edition-159401) and [Cubica](https://www.youtube.com/watch?v=D_f_MntrLVE). Mirror is optimized for **ease of use** & **probability of success**. We needed a networking library that allows us to **[launch our games](https://mirror-networking.com/showcase/)** and **survive the next decade**. Mirror is **[stable](https://mirror-networking.gitbook.io/docs/general/tests)** & **[production](https://www.oculus.com/experiences/quest/2564158073609422/)** ready. ## Free & Open Mirror is **free & open source**! * Code: MIT licensed. * Dedicated Servers: [Anywhere](https://mirror-networking.gitbook.io/docs/guides/server-hosting)! * Player Hosted: [Free Epic Relay](https://github.com/FakeByte/EpicOnlineTransport)! We need Mirror for our own games, which is why we will never charge anything. Funded only by [Donations](https://github.com/sponsors/vis2k) from our [fantastic community](https://discordapp.com/invite/N9QVxbM) of over 10,000 people. ## Architecture The **Server & Client** are **ONE project** in order to achieve an order of magnitude gain in productivity. Making multiplayer games this way is fun & easy. Instead of MonoBehaviour, Mirror provides **NetworkBehaviour** components with: * **[Server]** / **[Client]** tags for server-only / client-only code * **[Command]** for Client->Server function calls (e.g. UseItem) * **[ClientRpc]** / **[TargetRpc]** for Server->Client function calls (e.g. AddChatMessage) * **[SyncVar]** / SyncList to automatically synchronize variables from Server->Client ## Getting Started Get **Unity 2019 LTS**, download [Mirror on the Asset Store](https://assetstore.unity.com/packages/tools/network/mirror-129321), open one of the examples & press Play! Check out our [Documentation](https://mirror-networking.gitbook.io/) to learn how it all works. If you are migrating from UNET, then please check out our [Migration Guide](https://mirror-networking.gitbook.io/docs/general/migration-guide). ## Made with Mirror

Population: ONE	Zooba	SCP: Secret Laboratory	Naïca Online

Laurum Online	SamuTale	Nimoyd	The Wall

Nestables	A Glimpse of Luna	One More Night	Cubica

Inferna	NightZ	Roze Blud	Wawa United

MACE

And [many more](https://mirror-networking.com/showcase/)... ## Mirror LTS (Long Term Support) If you use Mirror in production, consider Mirror LTS! * **Bug fixes** only. * **Consistent API**: update any time, without any breaking features. * Lives along side **Unity 2019** LTS. * Supported from Sept. 2021 to Sept 2022, depending on feedback. **Mirror V46 LTS** is available to all [GitHub Sponsors](https://github.com/sponsors/vis2k). All sponsors are invited to the [Mirror V46 LTS Repository](https://github.com/MirrorNetworking/Mirror-46-LTS) automatically. ## Low Level Transports * (built in) [KCP](https://github.com/vis2k/kcp2k): reliable UDP * (built in) [Telepathy](https://github.com/vis2k/Telepathy): TCP * (built in) [Websockets](https://github.com/MirrorNetworking/SimpleWebTransport): Websockets * [Ignorance](https://github.com/SoftwareGuy/Ignorance/): ENET UDP * [LiteNetLib](https://github.com/MirrorNetworking/LiteNetLibTransport/) UDP * [FizzySteam](https://github.com/Chykary/FizzySteamworks/): SteamNetwork * [FizzyFacepunch](https://github.com/Chykary/FizzyFacepunch/): SteamNetwork * [Epic Relay](https://github.com/FakeByte/EpicOnlineTransport): Epic Online Services * [Bubble](https://github.com/Squaresweets/BubbleTransport): Apple GameCenter * [Light Reflective Mirror](https://github.com/Derek-R-S/Light-Reflective-Mirror): Self-Hosted Relay * [Oculus P2P](https://github.com/hyferg/MirrorOculusP2P): Oculus Platform Service ## Benchmarks * [uMMORPG 480 CCU](https://youtu.be/mDCNff1S9ZU) (worst case) * [Jesus' Benchmarks](https://docs.google.com/document/d/1GMxcWAz3ePt3RioK8k4erpVSpujMkYje4scOuPwM8Ug/edit?usp=sharing) ## Development & Contributing Mirror is used **in production** by everything from small indie projects to million dollar funded games that will run for a decade or more. Therefore it is important for us to follow the [KISS principle](https://en.wikipedia.org/wiki/KISS_principle) in order for our games to survive, so that we can still fix networking bugs 10 years from now if needed. # Bug Bounty

A lot of projects use Mirror in production. If you found a critical bug / exploit in Mirror core, please reach out to us in private. Depending on the severity of the exploit, we offer $50 - $500 for now. Rewards based on Mirror's [donations](https://github.com/sponsors/vis2k), capped at amount of donations we received that month. **Specifically we are looking for:** * Ways to crash a Mirror server * Ways to exploit a Mirror server * Ways to leave a Mirror server in undefined state We are **not** looking for DOS/DDOS attacks. The exploit should be possible with just a couple of network packets, and it should be reproducible. **Credits / past findings / fixes:** * 2020, fholm: fuzzing ConnectMessage to stop further connects [[#2397](https://github.com/vis2k/Mirror/pull/2397)]