This project is currently in early-access.
Boss Room is a fully functional Multiplayer Co-op Sample game made with Unity and MLAPI. We are building the sample to serve as an educational showcase of specific typical gameplay patterns frequently featured in similar games.
The intention is that you can use everything in this project as a starting point or as bits and pieces in your own Unity games.
This project uses Git Large Files Support (LFS), which ensures all large assets required locally are handled for the project. See Git LFS installation options for Windows and Mac instructions.
- A release version can be downloaded from the Latest Releases at GitHub.
- Unzip the archive file.
Using Windows' built-in extracting tool may generate an "Error 0x80010135: Path too long" error window which can invalidate the extraction process. As a workaround, shorten the zip file to a single character (for example "c.zip") and move it to the shortest path on your computer (such as in root C:) and retry. If that solution fails, another workaround is to extract the downloaded zip file using an application like 7zip.
- You are now ready to add the project to Unity Hub.
- Boss Room supports those platforms supported by MLAPI (Windows and Mac).
- Boss Room is compatible with Unity 2020.3 and later.
- Make sure to include standalone support for Windows/Mac in your installation.
Open Unity Hub.
Select the root folder of the downloaded project.
The first time you open the project, Unity will import all assets, which will take longer than usual - this is normal. The Unity MLAPI v0.1.0 package will also be installed with Boss Room.
Issues with importing due to parental control software: If you have issues with importing you may want to check your DNS settings as some ISP parental controls may block GitHub access. For example, see this information on WebSafe.
To open the project for the first time:
- In Unity Hub, double-click the project.
- Navigate to the Project window.
- Open the Assets folder.
- Open the Scene folder.
- Click the Startup scene.
- Click Play.
In order to see the multiplayer functionality in action, you can either run multiple instances of the game locally on your computer or choose to connect through the internet.
- Click File.
- Click Build Settings.
- Click Build.
After the build has completed you can launch several instances of the built executable to be able to both host and join a game.
To run multiple instances of the same app, you need to use the command line:
> Run open -n BossRoom.app
In contrast to running a local setup, when playing over internet we do not necessarily need a built executable. You can run the game in editor.
Photon Transport for MLAPI uses Photon relay server to facilitate communication between clients and server living on different networks.
See the Boss Room Photon Setup Guide for details.
The Portforward Site has guides on how to enable port forwarding on a huge number of routers. Boss Room uses UDP and needs a 9998 external port to be open.
Run builds on Mac OSX:
If you attempt to run a build on OSX and receive a warning dialog mentioning an "unidentified developer", you may need to override your security settings for this application:
In the Finder on your Mac, locate the application you want to open.
Do not use Launchpad, it does not allow you to access the shortcut menu.
Control-click the app icon, then choose Open from the shortcut menu.
The app is saved as an exception to your security settings. You can open it in the future by double-clicking it just as you can any registered app.
See Apple Support for details.