mirror of
https://github.com/MirrorNetworking/Mirror.git
synced 2024-11-18 02:50:32 +00:00
228 lines
15 KiB
Markdown
228 lines
15 KiB
Markdown
|
|
|
|
[](https://assetstore.unity.com/packages/tools/network/mirror-129321)
|
|
[](https://mirror-networking.gitbook.io/)
|
|
[](https://mirror-networking.com/showcase/)
|
|
[](https://mirror-networking.gitbook.io/docs/community-guides/video-tutorials)
|
|
[](https://forum.unity.com/threads/mirror-networking-for-unity-aka-hlapi-community-edition.425437/)
|
|
[](https://ci.appveyor.com/project/vis2k73562/hlapi-community-edition/branch/mirror)
|
|
[](https://discordapp.com/invite/N9QVxbM)
|
|
[](https://github.com/vis2k/Mirror/releases/latest)
|
|
[](https://github.com/vis2k/Mirror/blob/master/LICENSE)
|
|
[](https://trello.com/b/fgAE7Tud)
|
|
|
|
**It's only the dreamers who ever move mountains.**
|
|
|
|
<img src="https://user-images.githubusercontent.com/16416509/119117854-3e4e2b80-ba5c-11eb-8236-ce6cfd2b6b07.png" title="Original Concept Art for Games that made us dream. Copyright Blizzard, Blizzard, Riot Games, Joymax in that order."/>
|
|
|
|
## Mirror Networking
|
|
The **#1** free **open source** game networking library for **Unity 2019 / 2020 / 2021**.
|
|
|
|
Used **in production** by major hits like [**Population: ONE**](https://www.populationonevr.com/) and many [more](#made-with-mirror).
|
|
|
|
Originally based on [**UNET**](https://blog.unity.com/technology/announcing-unet-new-unity-multiplayer-technology): battle tested **since 2014** for 8 years and counting!
|
|
|
|
Mirror is **[stable](https://mirror-networking.gitbook.io/docs/general/tests)**, [**modular**](https://github.com/vis2k/Mirror#low-level-transports) & **[easy to use](https://mirror-networking.gitbook.io/)** for all types of games, even [MMORPGs](https://www.youtube.com/watch?v=mDCNff1S9ZU) 🎮.
|
|
|
|
**Made in 🇩🇪🇺🇸🇬🇧🇸🇬🇹🇼 with ❤️**.
|
|
|
|
---
|
|
## Architecture
|
|
The **Server & Client** are **ONE project** in order to achieve maximum productivity.
|
|
|
|
Simply use **NetworkBehaviour** instead of **MonoBehaviour**.
|
|
|
|
Making multiplayer games this way is fun & easy:
|
|
|
|
```cs
|
|
public class Player : NetworkBehaviour
|
|
{
|
|
// synced automatically
|
|
[SyncVar] public int health = 100;
|
|
|
|
// lists, dictionaries, sets too
|
|
SyncList<Item> inventory = new SyncList<Item>();
|
|
|
|
// server/client-only code
|
|
[Server] void LevelUp() {}
|
|
[Client] void Animate() {}
|
|
|
|
void Update()
|
|
{
|
|
// isServer/isClient for runtime checks
|
|
if (isServer) Heal();
|
|
if (isClient) Move();
|
|
}
|
|
|
|
// zero overhead remote calls
|
|
[Command] void CmdUseItem(int slot) {} // client to server
|
|
[Rpc] void RpcRespawn() {} // server to all clients
|
|
[TargetRpc] void Hello() {} // server to one client
|
|
}
|
|
```
|
|
|
|
There's also **NetworkServer** & **NetworkClient**. And that's about it 🤩.
|
|
|
|
---
|
|
## Free, Open & Community Funded
|
|
Mirror is **free & open source** (MIT Licensed).
|
|
|
|
"Free" as in free beer, and freedom to use it any way you like.
|
|
|
|
- Run [Dedicated Servers](https://mirror-networking.gitbook.io/docs/guides/server-hosting) anywhere.
|
|
- Free player hosted games thanks to [Epic Relay](https://github.com/FakeByte/EpicOnlineTransport)!
|
|
|
|
Mirror is funded by [**Donations**](https://github.com/sponsors/vis2k) from our [fantastic community](https://discordapp.com/invite/N9QVxbM) of over 14,000 users!
|
|
|
|
---
|
|
## Getting Started
|
|
Get **Unity 2019 / 2020 / 2021 LTS**, [Download Mirror](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](https://www.populationonevr.com/)
|
|
[](https://www.populationonevr.com/)
|
|
The [BigBoxVR](https://www.bigboxvr.com/) team started using Mirror in February 2019 for what eventually became one of the most popular Oculus Rift games.
|
|
|
|
In addition to [24/7 support](https://github.com/sponsors/vis2k) from the Mirror team, BigBoxVR also hired one of our engineers.
|
|
|
|
**Population: ONE** was recently [acquired by Facebook](https://uploadvr.com/population-one-facebook-bigbox-acquire/).
|
|
|
|
### [Nimoyd](https://www.nimoyd.com/)
|
|
[](https://www.nimoyd.com/)
|
|
Nudge Nudge Games' first title: the colorful, post-apocalyptic open world sandbox game [Nimoyd](https://store.steampowered.com/app/1313210/Nimoyd__Survival_Sandbox/) is being developed with Mirror.
|
|
|
|
_Soon to be released for PC & mobile!_
|
|
|
|
### [Dinkum](https://store.steampowered.com/app/1062520/Dinkum/)
|
|
[](https://store.steampowered.com/app/1062520/Dinkum/)
|
|
Set in the Australian Outback, Dinkum is a relaxing farming & survival game. Made by just one developer, Dinkum already reached 1000+ "Overwhelmingly Positive" reviews 1 week after its early access release.
|
|
|
|
James Bendon initially made the game with UNET, and then [switched to Mirror](https://www.playdinkum.com/blog/2019/1/11/devlog-13-biomes-and-traps) in 2019.
|
|
|
|
### [A Glimpse of Luna](https://www.glimpse-luna.com/)
|
|
[](https://www.glimpse-luna.com/)
|
|
[A Glimpse of Luna](https://www.glimpse-luna.com/) - a tactical multiplayer card battle game with the most beautiful concept art & soundtrack.
|
|
|
|
Made with Mirror by two brothers with [no prior game development](https://www.youtube.com/watch?v=5J2wj8l4pFA&start=12) experience.
|
|
|
|
### [Sun Haven](https://store.steampowered.com/app/1432860/Sun_Haven/)
|
|
[](https://store.steampowered.com/app/1432860/Sun_Haven/)
|
|
[Sun Haven](https://store.steampowered.com/app/1432860/Sun_Haven/) - A beautiful human town, a hidden elven village, and a monster city filled with farming, magic, dragons, and adventure.
|
|
|
|
After their successful [Kickstarter](https://www.kickstarter.com/projects/sunhaven/sunhaven/description), Sun Haven was released on Steam in 2021 and later on ported to Mirror in 2022.
|
|
|
|
### [Inferna](https://inferna.net/)
|
|
[](https://inferna.net/)
|
|
One of the first MMORPGs made with Mirror, released in 2019.
|
|
|
|
An open world experience with over 1000 CCU during its peak, spread across multiple server instances.
|
|
|
|
### [Samutale](https://www.samutale.com/)
|
|
[](https://www.samutale.com/)
|
|
A sandbox survival samurai MMORPG, originally released in September 2016.
|
|
|
|
Later on, the Netherlands based Maple Media switched their netcode to Mirror.
|
|
|
|
### [Untamed Isles](https://store.steampowered.com/app/1823300/Untamed_Isles/)
|
|
[](https://store.steampowered.com/app/1823300/Untamed_Isles/)
|
|
The turn based, monster taming **MMORPG** [Untamed Isles](https://store.steampowered.com/app/1823300/Untamed_Isles/) is currently being developed by [Phat Loot Studios](https://untamedisles.com/about/).
|
|
|
|
After their successful [Kickstarter](https://www.kickstarter.com/projects/untamedisles/untamed-isles), the New Zealand based studio is aiming for a 2022 release date.
|
|
|
|
### [Zooba](https://play.google.com/store/apps/details?id=com.wildlife.games.battle.royale.free.zooba&gl=US)
|
|
[](https://play.google.com/store/apps/details?id=com.wildlife.games.battle.royale.free.zooba&gl=US)
|
|
[Wildlife Studio's](https://wildlifestudios.com/) hit Zooba made it to rank #5 of the largest battle royal shooters in the U.S. mobile market.
|
|
|
|
The game has over **50 million** downloads on [Google Play](https://play.google.com/store/apps/details?id=com.wildlife.games.battle.royale.free.zooba&gl=US), with Wildlife Studios as one of the top 10 largest mobile gaming companies in the world.
|
|
|
|
### [Portals](https://theportal.to/)
|
|
[](https://theportal.to/)
|
|
A browser-based metaverse, Portals is an immersive social space where you can explore, make your own, and gather with others.
|
|
|
|
### [SCP: Secret Laboratory](https://scpslgame.com/)
|
|
[](https://scpslgame.com/)
|
|
[Northwood Studios'](https://store.steampowered.com/developer/NWStudios/about/) first title: the multiplayer horror game SCP: Secret Laboratory was one of Mirror's early adopters.
|
|
|
|
Released in December 2017, today it has more than **140,000** reviews on [Steam](https://store.steampowered.com/app/700330/SCP_Secret_Laboratory/?curator_clanid=33782778).
|
|
|
|
### [Naïca Online](https://naicaonline.com/)
|
|
[](https://naicaonline.com/)
|
|
[Naïca](https://naicaonline.com/) is a beautiful, free to play 2D pixel art MMORPG.
|
|
|
|
The [France based team](https://naicaonline.com/en/news/view/1) was one of Mirror's early adopters, releasing their first public beta in November 2020.
|
|
|
|
### [Laurum Online](https://laurum.online/)
|
|
[](https://laurum.online/)
|
|
[Laurum Online](https://play.google.com/store/apps/details?id=com.project7.project7beta) - a 2D retro mobile MMORPG with over 500,000 downloads on Google Play.
|
|
|
|
### And many more...
|
|
<a href="https://store.steampowered.com/app/719200/The_Wall/"><img src="https://cdn.akamai.steamstatic.com/steam/apps/719200/header.jpg?t=1588105839" height="100" title="The wall"/></a>
|
|
<a href="https://store.steampowered.com/app/535630/One_More_Night/"><img src="https://cdn.akamai.steamstatic.com/steam/apps/535630/header.jpg?t=1584831320" height="100" title="One more night"/></a>
|
|
<img src="https://i.ytimg.com/vi/D_f_MntrLVE/maxresdefault.jpg" height="100" title="Block story"/>
|
|
<a href="https://nightz.io"><img src="https://user-images.githubusercontent.com/16416509/130729336-9c4e95d9-69bc-4410-b894-b2677159a472.jpg" height="100" title="Nightz.io"/></a>
|
|
<a href="https://store.steampowered.com/app/1016030/Wawa_United/"><img src="https://user-images.githubusercontent.com/16416509/162982300-c29d89bc-210a-43ef-8cce-6e5555bb09bc.png" height="100" title="Wawa united"/></a>
|
|
<a href="https://store.steampowered.com/app/1745640/MACE_Mapinguaris_Temple/"><img src="https://user-images.githubusercontent.com/16416509/166089837-bbecf190-0f06-4c88-910d-1ce87e2f171d.png" title="MACE" height="100"/></a>
|
|
<a href="https://www.adversator.com/"><img src="https://user-images.githubusercontent.com/16416509/178641128-37dc270c-bedf-4891-8284-33573d1776b9.jpg" title="Adversator" height="100"/></a>
|
|
<a href="https://store.steampowered.com/app/670260/Solace_Crafting/"><img src="https://i.ibb.co/j6qCSVR/190058119-d9d62b95-5fd4-4823-bd6e-67833253c752.png" title="Solace Crafting" height="100"/></a>
|
|
|
|
## 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.
|
|
|
|
## Modular Transports
|
|
Mirror uses **KCP** (reliable UDP) by default, but you may use any of our community transports for low level packet sending:
|
|
* (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
|
|
* [2022] mischa [400-800 CCU](https://discord.com/channels/343440455738064897/1007519701603205150/1019879180592238603) tests
|
|
* [2021] [Jesus' Benchmarks](https://docs.google.com/document/d/1GMxcWAz3ePt3RioK8k4erpVSpujMkYje4scOuPwM8Ug/edit?usp=sharing)
|
|
* [2019] [uMMORPG 480 CCU](https://youtu.be/mDCNff1S9ZU) (worst case)
|
|
|
|
## 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.
|
|
|
|
We prefer to work slow & thoroughly in order to not break everyone's games 🐌.
|
|
|
|
Therefore, we need to [KISS](https://en.wikipedia.org/wiki/KISS_principle) 😗.
|
|
|
|
---
|
|
# Bug Bounty
|
|
<img src="https://user-images.githubusercontent.com/16416509/110572995-718b5900-8195-11eb-802c-235c82a03bf7.png" height="150">
|
|
|
|
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)]
|