Home

Awesome

<div align="center"> <!-- PROJECT SHIELDS -->

Contributors Forks Stargazers Issues MIT License
Unity C# Visual Studio

<!-- PROJECT LOGO --> <!-- <a href="https://github.com/mikyll/UnityDOTS-Thesis"> <img src="images/logo.png" alt="Logo" width="80" height="80"> </a> --> <h1 align="center">Multiplayer Applications and Games Project<br/>on Unity DOTS Architecture</h1> This project was carried out as an integral part of my bachelor's degree thesis in Computer Engineering, concerning the new Unity DOTS architecture. The goal of the paper, in addition to analyzing the new data-oriented layout provided by the ECS-based model, was to create a <i>working multiplayer game prototype made entirely using DOTS.</i> <br /> <a href="./Documentation/Prototype%20Documentation.md"><strong>Explore the docs »</strong></a> <br /> <br /> <a href="#demo">View Demo</a> · <a href="./Thesis%20Docs/Tesi%20di%20Laurea%20di%20Michele%20Righi%20-%20Progetto%20di%20Applicazioni%20e%20Giochi%20Multiplayer%20su%20Architettura%20Unity%20DOTS.pdf">Thesis</a> · <a href="./Presentation/PresentationDOTS%20(pdf).pdf">Presentation</a> · <a href="https://github.com/mikyll/UnityDOTS-Thesis/issues">Report Bug | Request Feature</a> · <a href="./README.it.md">Italiano <kbd><img width="20px" src="https://flagicons.lipis.dev/flags/4x3/it.svg"></kbd></a> </div> <!-- TABLE OF CONTENTS --> <details open="open"> <summary><h2 style="display: inline-block">Table of Contents</h2></summary> <ol> <li> <a href="#about-the-project">About The Project</a> <ul> <li><a href="#built-with">Built With</a></li> </ul> </li> <li> <a href="#getting-started">Getting Started</a> <ul> <li><a href="#prerequisites">Prerequisites</a></li> <li><a href="#installation">Installation</a></li> </ul> </li> <li><a href="#usage">Usage</a></li> <li><a href="#roadmap">Roadmap</a></li> <li><a href="#contributing">Contributing</a></li> <li><a href="#license">License</a></li> <li><a href="#contact">Contact</a></li> <li><a href="#acknowledgements">Acknowledgements</a></li> </ol> </details> <!-- ABOUT THE PROJECT -->

About The Project

Data-Oriented Technology Stack (DOTS) is a set of libraries created by Unity over the last few years, which is still under development at the time of writing (2021).

DOTS proposes to replace the old architecture & programming pattern of the game engine, that was based on a component model (GameObject + MonoBehaviour), with a new one based on ECS (Entities, Components, Systems). The goal is to obtain an architecture that is not limited by the object-oriented programming, which is known to have several pifalls and problems - mainly related to polymorphism, inheritance chains and reference types.

In this regard, through a data-oriented layout, DOTS allows to obtain performance by default, as the code becomes organized through the separation between data (placed inside the components) and behaviour (confined inside systems). Runtime "things" are no longer heavy objects, with data scattered in memory, but simple numeric indexes representing entities, which we can compare to the keys of a database. Among the many advantages that come with this new architecture, what stand out is the possibility to make the most of modern CPUs, exploiting the potential of multiple cores and allowing efficient use of caches, which are not satured by the myriad of useless or unnecessary data present in objects. Moreover, thanks to the separation logic, the code that developers write becomes a good low-level approximation of an already correct and efficient solution, which therefore doesn't need, if not in rare cases, to be optimized.<br/> The main packages used to make the prototype are:

<span id="demo">The following animations show an example run of the prototype, with an headless server and two connected clients: one running in the Unity editor, the other as a standalone application on a different computer. With the NetCode package, when entering PlayMode inside the editor, Unity runs the server, a client and an arbitrary number of thin clients (in this demo we didn't make use of any of those).</span>

<table style="border: none"> <tr> <td width="49.9%"><img src="./Documentation/Images/GIF_Editor_Prototype.gif" alt="EditorGIF"/></td> <td width="49.9%"><img src="./Documentation/Images/GIF_AppStandalone_Prototype.gif" alt="StandaloneGIF"/></td> </tr> <tr> <td>PC1: Unity Editor</td> <td>PC2: Standalone Build</td> </tr> </table>

Built With

<!-- GETTING STARTED -->

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

Installation

  1. Install Git at Download Git.
  2. Clone the repo.
    git clone https://github.com/mikyll/UnityDOTS-Thesis
    
  3. Download Unity Hub at Download Unity.
  4. Install a proper Unity version (2020.2.1 or higher) at Download Archive or from Unity Hub.
  5. Add the project directory on Unity Hub: Projects > Add > Select Directory.
<!-- USAGE EXAMPLES -->

Usage

To test the prototype in multiplayer you can create a build for a standalone client, then enter PlayMode in the editor and connect the standalone application; otherwise you can create one build for the server and one for the client and connect several clients to the server.

For more examples, please refer to the Documentation.

<!-- ROADMAP -->

Roadmap

See the open issues for the full list of proposed features (and known issues).

Open Issues

Future developments

<!-- CONTRIBUTING -->

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project.
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature).
  3. Commit your Changes (git commit -m 'Add some AmazingFeature').
  4. Push to the Branch (git push origin feature/AmazingFeature).
  5. Open a Pull Request.
<!-- LICENSE -->

License

Distributed under the MIT License. See LICENSE for more information.

<!-- CONTACT -->

Contact

Michele Righi - righi.michele98@gmail.com

Project Link: github.com/mikyll/UnityDOTS-Thesis

<!-- ACKNOWLEDGEMENTS -->

Acknowledgements

<div align="center">

LinkedIn GitHub followers

</div> <!-- MARKDOWN LINKS & IMAGES --> <!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->