NeoFPS Installation
Overview
On first adding NeoFPS to a project, once the assets have been imported, the NeoFPS hub should appear, guiding you through the installation and providing useful ingormation on getting started. This document covers any extra steps and gives details of what is happening in case you want more manual control of the installation process.
Unity Settings
NeoFPS requires various project settings to be applied in order to function correctly. This includes custom layers, custom input axes, and an optimised layer collision matrix. NeoFPS has an automated system for applying Unity settings built into the NeoFPS Hub. It uses version numbers to track when updates to NeoFPS require new settings to be applied and will open the hub on the Unity Settings page if they are not up to date. You can also find the hub in the toolbar via Tools/NeoFPS/NeoFPS Hub.
You can apply all required settings automatically here. If you are installing NeoFPS in a fresh project then this is the recommended approach. If you would prefer to apply the correct settings manually then you can do so using the Individual Settings section. Clicking the Apply Manually button for a section will open the relevant Unity settings editor and flag the settings as up to date in the NeoFPS hub. The following is a breakdown of what is required for each section:
Settings | Details |
---|---|
Layers and Tags | NeoFPS makes extensive use of custom layers. For more information, see the Layers and Tags documentation. |
Physics | NeoFPS uses the physics layer collision matrix to define interactions between the custom layers. For more information see the Layer Collision Matrix section of the Layers and Tags documentation. This must be changed after the layers and tags have been set up. |
Input | To enable consistent controller mapping across platforms, NeoFPS has some fairly complex input settings. You can find a full list in the Input Settings documentation. |
Player Settings | NeoFPS uses the Linear color space (this will be set to "Gamma" by default). Without this change, the sample scenes will look very washed out and bright. |
Build Settings | See the Sample Scenes section below. |
Sample Scenes
Sample scenes that demonstrate NeoFPS' features can be found in the project folder: NeoFPS/Samples/SinglePlayer/Scenes
The MainMenu scene is intended as a jumping off point for the individual demos and needs to be set as the first scene in the build settings (index 0). This means it will be the start-up scene for standalone builds. The Loading scene is a loading screen that is displayed when loading demo scenes. By default, this must be the second scene in the build settings (index 1), though this can be changed via the Neo Scene Manager in the hub.
The Unity Settings page applies the above settings automatically as part of the Build Settings section.
Post Processing
NeoFPS makes use of Unity's Post Processing Stack V2 package. On first adding NeoFPS to your project this should be installed automatically. If you want to check manually that the package is installed then you can access the package manager via the toolbar at: Window/Package Manager. Once opened, click the All tab at the top of the package list on the left. Scroll down and select Post Processing. At the bottom right of the description panel is an install button unless the package is already installed.
Due to a bug in the way the PostProcessLayer component is serialized, this has been removed from all cameras and replaced with a script which attaches and sets up the component at runtime. For more information see the PostProcessLayerFix behaviour reference.