Thanks for checking out our project!
This is a fully functional, first person multiplayer shooter game made in Unity and with full source and assets. It is in active development by a small team from Unity Technologies. Our goals are to test and showcase new features in Unity and to be of use for teams who can bootstrap on top of this, extract useful bits and tools or simply learn from and get inspired by what is in the project.
The project is using a number of new technologies: We use the new HD Render Pipeline, meaning all content has been authored for HDRP. We are also using the new network transport layer as well as the Entity-Component System. In the case of ECS, we have primarily adopted the "ECS-pattern" and use it in hybrid mode with a lot of regular components. As more and more features of Unity become available in ECS-aware versions, we will migrate to them.
Status and prerequisites
Current status at a glance:
Unity version: 2018.3 beta 6 Platforms : Windows (client and server) and Linux (server only) Fun : Yes Finished : No Useful : We think so
Getting the project
To get the project folder you need to clone the project. Note, that
IMPORTANT: This project uses Git Large Files Support (LFS). Downloading a zip file using the green button on Github will not work. You must clone the project with a version of git that has LFS. You can download Git LFS here: https://git-lfs.github.com/.
The project size is about 18GB. If your cloned repository is much smaller, you most likely did not have LFS when you cloned.
Getting the right version of Unity
Once you have cloned the repository, you should install the version of Unity that is listed above in the prerequisites section. Make sure you include windows standalone support in your installation.
Opening the project for the first time
The following guide should take you to the point where you can hit play in the editor and run around the levels and also build a standalone version of the game and use it to spin up a server and connect a few clients to it.
The first time you open the project you need patience! It takes a while to import all the assets.
NOTE: Due to a bug in Unity 2018.3 beta, you have to take the following steps right after the initial import:
- Search for
t:prefabin the Project search field. Then click on the first prefab and shift+click on the last to select them all. Right click and select Reimport.
- Search for
t:modelin the Project search field. Repeat the same steps as for prefabs to reimport them all.
- IF you are on a version older than beta 6, you may have had a few crashes during import. In that case you need to find
GooRiflein project, right click and select Reimport.
One day soon we will remove this note and there will be cake.
Once the editor is ready, open the Project Tools Window by navigating to FPS Sample > Windows > Project tools.
It should look like this:
Keep this window docked as you will use it a lot. From here you can open the levels, build assetbundles and build standalone players. Because this is a multiplayer game you will need to work with standalone players a lot.
Trying out preview mode
From the Project Tools window click Open next to Level_00. Our levels are split into multiple scenes but using these buttons will ensure you open all the scenes that make up a level.
Once opened, try entering playmode in the editor. You should now be able to run around in the level. This is what we call 'preview mode'. Here you can move around and test your level, player traversal and weapons.
Building bundles and standalone
Leave playmode again and in the Project Tools windows, in the bundles section, press All [force].
This will build the levels and other assets into assetbundles. The first time around this will take a significant amount of time as all shaders have to be compiled.
Once you have built the bundles, hit Build game in the game section. This builds the standalone player. Again, first time will be slow.
Using the quick start launcher
When this is done, locate the "Quick start" section at the bottom of the Project Tools window. Fill out the settings like this:
Use editor: Unused
Now hit the green Start button. This should launch two processes: one is a standalone, headless server, the other is a client that will attempt to connect to the server.
Congratulations! If you made it this far you should celebrate a bit!
Development of FPS Sample, Contributions etc.
As of today, internally development of the project happens on Perforce. We push versions of the project to github from there. As we do that we will update the CHANGELOG with highlights but the full history is not carried over.
For legal and practical reasons we are not able to take larger contributions just now. We are working to see how we can make it happen and we are always happy to hear about bugfixes and ideas for improvements in our forum. If you post bugfixes, we remind you that they will be covered by Unity Contribution Agreement.
Our intention is that you can use everything in this project as a starting point or as bits and pieces in your own Unity games. For the legal words, see LICENSE.md.