Network Project Config

Overview

Network Project Config is an asset that contains a variety of information and parameters that affect the associated Photon Fusion project such as:

• Version
• Peer Mode
• Default Player Count
• Network Condition Testing
• Encryption
• Prefab Inspection

This asset is located under Assets/Photon/Fusion/Resources/NetworkProject.Config.fusion. You can also access this by selecting Tools > Fusion > NetworkProjectConfig from the top Unity Editor menu. Any changes to this asset must be applied, so make sure to click the Apply button near the bottom of the Inspector to do so or confirm to save changes when prompted.

Fusion Version

This first section lists what version of Fusion is currently being used. When expanded, the dropdown shows more detailed information about each dynamic-link library (DLL) used by Fusion.

Physics

From Fusion 2.1.x. Enabling Physics Forecast enables extrapolation of NetworkTransforms with Rigidbodies. This puts these objects into local time and enables smooth interaction on all clients.

You can read more about Physics here.

Miscellaneous

This section contains settings that handle miscellaneous parameters regarding Fusion projects.

• Enqueue Incomplete Synchronous Spawns: if enabled, synchronous incomplete spawns (Addressables, etc.) get enqueued instead of throwing an exception. They will instead return Fusion.NetworkSpawnStatus.Queued and an attempt to spawn the object will occur on the next frame. Enabling this can be useful for transitioning from Fusion 1.x.
• Invoke Render In Batch Mode: if this is enabled, Fusion.SimulationBehaviour.Render callbacks will be invoked when playing a game in Batch Mode. Batch mode refers to the -batchmode parameter that can be passed to the Unity build executable. Disabling this may be useful for a game using a headless server that is run in Batch Mode. You can read more about Unity's Batch Mode here.
• Network Id Is Object Name: when checked, the name of newly spawned objects will be modified to include the Network Id in them as follows: [Network Id] Original Object Name.
• Hide Network Object Inactivity Guard: nested inside NetworkObjects, a GameObject named NetworkObjectInactivityGuard tracks the OnDestroy message of NetworkObjects that are destroyed before being activated. If this option is checked, these guards will not be visible in the hierarchy.
• Allow Client Server Modes in WebGL: This setting is not relevant for Shared Mode as using Shared Mode does not exhibit the same WebGL limitations as Client Server Modes.

Network

• Connection Timeout: amount of time, in seconds, before a disconnect will occur if no updates are received. Servers will disconnect clients if no updates are received from said client; clients will disconnect from the server if there is no update received from said server.
• Connecting Shutdown Time: amount of time, in seconds, after a connection status changes to Shutdown, and the connection and its associated references are released.
  Reliable Data Transfer Modes: determines the reliable data transfer modes.
  • Client to Server: allows data to be reliably transferred from clients to the server.
  • Client to Client With Server Proxy: allows data to be reliably from Client to Client, using the Server as proxy.

Encryption

This toggle sets if Encryption should be enabled or disabled for this Fusion project. Note, you must check this and update the project's Encryption Mode in the Photon App Settings.
You can read more about encryption here.

Network Conditions

Network Conditions allow users to simulate and test different network conditions such as latency and loss.

• Enabled: if checked, more options will appear.
• Delay Shape sets the pattern of the delay oscillation:
  • Noise;
  • Sine;
  • Square;
  • Triangle;
  • Saw;
  • Reverse Saw.
• Delay Min: minimum delay, in seconds, ranging from 0 to 0.5.
• Delay Max: maximum delay, in seconds, ranging from 0 to 0.5.
• Delay Period: rate at which the delay will oscillate in seconds between Delay Min and Delay Max.
• Delay Threshold: when the oscillation falls below this value, which ranges from 0 to 1, the delay will be set to Delay Min.
• Additional Jitter: after the oscillator determines the next delay value, a random value ranging from 0 to this in seconds will be added to the delay.
• Loss Chance Shape: sets the pattern of the loss oscillation. Choices are identical to Delay Shape
• Loss Chance Min: the lowest chance value that a loss will occur, ranging from 0 (0%) to 1 (100%).
• Loss Chance Max: the highest chance value that a loss will occur, ranging from 0 (0%) to 1 (100%).
• Loss Chance Threshold: when the oscillation falls below this value, which ranges from 0 to 1, the delay will be set to Loss Chance Min.
• Loss Chance Period: the rate at which the loss chance oscillate between Loss Chance Min and Loss Chance Max in seconds.
• Additional Loss: after the oscillator determines the next loss chance value, an additional random value ranging from 0 to this (normalized) percentage of loss chance is added.

Loss has nearly identical settings; instead of the amount of time in seconds, the values determine the percentage, ranging from 0% to 100%, that a loss will be simulated.

Heap

Allows users to define an amount of preallocated memory for use with Fusion, which helps with optimizing memory management and improving efficiency.

• Page Shift: determines the size of each Heap Page, which impacts the granularity of memory allocation. It ranges from 1 KB to 256 KB at powers of 2. A lower shift results in smaller memory allocations, while a higher shift allows for larger allocations.
• Page Count: specifies the initial number of pages allocated for the heap. Ranging from 16 to 4096, this defines the number of pages allocated for the heap and influences the total, initial memory allocated.

Weaver Settings

These are settings that affect the Fusion IL Weaver, which is used to generate low-level netcode and inject it into the Assembly-CSharp.dll.

• Assemblies to Weave: list of assemblies that are going to be weaved. They are not case sensitive. By default, these following are included:
  • Fusion.Unity;
  • Assemble-CSharp;
  • Assembly-CSharp-firstpass;
  • Fusion.Addons.Physics (if the project is using Fusion's physics systems).
• Use Serialized Dictionary: if checked, Fusion.SerializeableDictionary will be used to store the initial value of Networked Properties. If unchecked, weaver will use System.Generic.Dictionary instead; though this type is not Unity-serializable, custom serializers such as Odin may support it.
• Null Checks for Networked Properties: if set, the weaver will add a check if any Fusion.NetworkBehaviour with Networked properties have an associated Fusion.NetworkObject attached to them.
• Check Rpc Attribute Usage: if set, the weaver will check if Fusion.RpcAttribute is used in types that do not support it. For example, if Fusion.RpcAttribute is added to a Unity.MonoBehaviour method and this is checked, a warning will be logged, specifying that RPCs can only be added to Fusion.NetworkBehaviour and Fusion.SimulatedBehaviours; however, requires all types to be scanned and can increase weaving and script compilation time.You can read more about rules regarding RPCs here.
• Check Networked Properties Being Empty: if checked, users will get a warning if they try to define a property with the Fusion.NetworkedAttribute improperly. The getters and setters for these properties should be empty, such as with the following:

C#

[Networked]
public int NetworkedProperty {get; set;}

You can read more about setting up Networked Properties properly here.

Prefabs

These two settings handle how prefabs are unloaded.

• Unload Prefab On Releasing Last Instance: if true, prefabs will be unloaded when the last instance is released.
• Unload Prefabs On Shutdown: if true, all prefabs will be unloaded on shutdown.

Unloading prefabs no longer needed can help improve memory usage but will require them to be reloaded if needed again.

Auto-Generated

This section shows off automatically generated information.

• Show Network Prefab Inspector: opens up a window, allowing users to look at the different prefabs in the project that contain a Fusion.NetworkObject component and have Fusion.NetworkObject.IsSpawnable enabled.
• Prefabs: below the previously mentioned button is a dropdown list of each prefab that would be listed NetworkObject prefab in the project. This list cannot be updated by the user directly; however, additional prefabs can be registered at runtime with Fusion.NetworkPrefabTable.TryAddSource.
• Behaviour Meta: an auto-generated list containing meta information about all the Fusion.SimulationBehaviours in the project such as execution order.

Network Prefabs Inspector

As previously mentioned, the Network Prefabs Inspector allows users to inspect prefabs that contain a Fusion.NetworkObject component and have Fusion.NetworkObject.IsSpawnable enabled in more detail.

The main toolbar of this window has the following functionality:

• Refresh: refreshes the list and updates it if any new prefabs are made;
• Sync Selection: if turned on, Unity will select the prefab asset that is highlighted in the window;
• Loaded Only: if turned on, only prefabs that are loaded will be displayed.

Each row presents a different prefab; each column in this window represents the following:

• State: shows whether or not the prefab is currently loaded.
• Type: shows what kind of prefab this object is, referring to how it will be loaded.
  • R: A prefab placed in a Resources folder;
  • SL: A static prefab placed outside of a Resources folder;
  • A: A prefab loaded as an Addressable (not pictured.)
• PrefabId: the id assigned to the prefab by Fusion.
• Path: the file path to the prefab.

Back to top