Giter Site home page Giter Site logo

juo2 / mirror Goto Github PK

View Code? Open in Web Editor NEW

This project forked from mirrornetworking/mirror

0.0 0.0 0.0 364.97 MB

#1 Open Source Unity Networking Library

Home Page: https://mirror-networking.com

License: MIT License

JavaScript 0.11% Smalltalk 0.01% C# 99.88% PowerShell 0.01%

mirror's Introduction

Mirror Logo

Download Documentation Showcase Video Tutorials Forum Build Discord release License: MIT Roadmap

It's only the dreamers who ever move mountains.

Mirror Networking

The #1 free open source game networking library for Unity 2019 / 2020 / 2021 / 2022 LTS.

Used in production by major hits like Population: ONE and many more.

Originally based on UNET: battle tested since 2014 for 9 years and counting!

Mirror is stable, modular & easy to use for all types of games, even small MMORPGs ๐ŸŽฎ.

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:

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
    [ClientRpc] 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 Source & Community Focused

Mirror is free & open source (MIT Licensed).

๐Ÿบ "Free" as in free beer, and freedom to use it any way you like.

  • Host Game Servers anywhere!
  • Customize anything freely!
  • No paywalls, no CCU costs, no strings attached!

๐Ÿค We are a team of professional game developers, who are paid to use Mirror in production. Our incentives will always align with the community, because we are Mirror users just like you!

โค๏ธ Our fantastic community of over 14,000 users contributes feedback & improvements every day. Please join us on our journey, help others, and consider a Donation if you love our work!

The top quote is from Fitzcarraldo, which is quite reminiscent of this project.


Getting Started

Get Unity 2019 / 2020 / 2021 / 2022 LTS, Download Mirror, open one of the examples & press Play!

Check out our Documentation to learn how it all works.

If you are migrating from UNET, then please check out our Migration Guide.


Mirror LTS (Long Term Support)

Mirror LTS is available on the Asset Store.

Mirror LTS gives you peace of mind to run your game in production. Without any breaking changes, ever!

  • Bug fixes only.
  • Consistent API: update any time, without any breaking features.
  • Lives along side Unity 2019/2020/2021 LTS.
  • Supported for two years at a time.

Made with Mirror

Population: ONE The BigBoxVR 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 from the Mirror team, BigBoxVR also hired one of our engineers.

Population: ONE was acquired by Meta in June 2021, and they've just released a new Sandbox addon in 2022!

swarmvr_compressed SPIDER-MAN WITH GUNS!

SWARM is a fast-paced, arcade-style grapple shooter, with quick sessions, bright colorful worlds and globally competitive leaderboards that will take you back to the glory days of Arcade Games.

Available for the Meta Quest, made with Mirror.

nimoyd_smaller Nudge Nudge Games' first title: the colorful, post-apocalyptic open world sandbox game Nimoyd is being developed with Mirror.

Soon to be released for PC & mobile!

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 in 2019.

a glimpse of luna A Glimpse of Luna - a tactical multiplayer card battle game with the most beautiful concept art & soundtrack.

Made with Mirror by two brothers with no prior game development experience.

sun haven 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, Sun Haven was released on Steam in 2021 and later on ported to Mirror in 2022.

A Township Tale A Township Tale is an immersive VR experience, where you can build towns and explore worlds with your friends.

Made with our KCP transport, available on the Meta Quest Store with over 6000+ ratings.

Inferna MMORPG 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 A sandbox survival samurai MMORPG, originally released in September 2016.

Later on, the Netherlands based Maple Media switched their netcode to Mirror.

Untamed Isles The turn based, monster taming MMORPG Untamed Isles is currently being developed by Phat Loot Studios.

After their successful Kickstarter, the New Zealand based studio is aiming for a 2022 release date.

Zooba Wildlife Studio's 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, with Wildlife Studios as one of the top 10 largest mobile gaming companies in the world.

Portals Animal Crossing meets Yakuza meets Minecraft โ€” a city builder with a multiplayer central hub. Gather, trade and build โ€” all in the browser!

scp - secret laboratory_smaller Northwood Studios' 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.

Naica Online Naรฏca is a beautiful, free to play 2D pixel art MMORPG.

The France based team was one of Mirror's early adopters, releasing their first public beta in November 2020.

Laurum Online Laurum Online - a 2D retro mobile MMORPG with over 500,000 downloads on Google Play.

Empires Mobile Empires Mobile - Retro mobile MMORPG for Android and iOS, reaching 5000 CCU at times. Check out their video for some early MMORPG nostalgia.

Castaways Castaways is a sandbox game where you are castaway to a small remote island where you must work with others to survive and build a thriving new civilization.

Castaway runs in the Browser, thanks to Mirror's WebGL support.

Overpowered Overwpowered, the exciting new card game that combines strategy, myth, and fun into one riveting web-based experience. Launched in 2023, made with Mirror!

And many more...

Modular Transports

Mirror uses KCP (reliable UDP) by default, but you may use any of our community transports for low level packet sending:

Benchmarks

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 ๐Ÿ˜—.


Information Security

Mirror alternative Logo

Mirror-Networking follows common information security industry standards & best practices.

Mirror is free open source software (MIT Licensed), with over 80% test coverage. The company is located in Germany. We do not collect any user data, impose no restrictions on users & developers, or rely on any closed source dependencies other than Unity.

This makes Mirror an attractive choice for government agencies and large corporations with strict information security requirements.

Feel free to reach out to business [at] mirror-networking.com if you have any questions, or need to review any of our policies:

  • Development best Practices and SDLC.pdf
  • Disaster Recovery Procedure.pdf
  • Document Retention and Destruction Policy.pdf
  • Encryption Policy.pdf
  • Information Security Guidelines.pdf
  • Privacy Policy
  • Security Policy
  • Vulnerability Management Policy.pdf

Please reach out if you decide to use Mirror.

We are excited to hear about your project, and happy to help if needed!


Incident Response & Bug Bounty

A lot of projects use Mirror in production. If you found a critical bug / exploit in Mirror core, please follow the steps outlined in our Security Policy.

Credits / past findings / fixes:


Credits & Thanks ๐Ÿ™

๐Ÿชž Alexey Abramychev (UNET)
๐Ÿชž Alan
๐Ÿชž c6burns
๐Ÿชž Coburn
๐Ÿชž cooper
๐Ÿชž FakeByte
๐Ÿชž fholm
๐Ÿชž Gabe (BigBoxVR)
๐Ÿชž imer
๐Ÿชž James Frowen
๐Ÿชž JesusLuvsYooh
๐Ÿชž Mischa
๐Ÿชž Mr. Gadget
๐Ÿชž NinjaKickja
๐Ÿชž Paul Pacheco
๐Ÿชž Sean Riley (UNET)

mirror's People

Contributors

paulpach avatar mrgadget1024 avatar james-frowen avatar atlv24 avatar miwarnec avatar michalpetryka avatar jesusluvsyooh avatar imerr avatar uweeby avatar katori avatar lymdun avatar softwareguy avatar fakebyte avatar beguiled avatar timpickup avatar ninjakickja avatar icezman001 avatar lumeriith avatar dmerner avatar atikadze avatar konstantin890 avatar rxmarccall avatar cxxpxr avatar shulinnn avatar callumferguson avatar apkd avatar hyouuu avatar tomkrikorian avatar mukaschultze avatar coyote-a avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.