In this section we cover how coherence handles loading CoherenceSync
Prefabs into memory and instantiating them when a new remote entity appears on the network.
Whenever you start synchronizing one of your Prefabs, either by adding the CoherenceSync
component manually or clicking the Sync with coherence toggle in the Prefab inspector, coherence will create a CoherenceSyncConfig
ScriptableObject to track the existence of this entity, and add it to a registry.
This object holds information on how a certain type of network entity is loaded and instantiated. As a user, the two main changeable options here are Load via, and Instantiate via.
There is a 1:1 correspondence between a networked Prefab and its CoherenceSyncConfig
object, so you can also edit the related CoherenceSyncConfig
in the inspector of any CoherenceSync
component:
The CoherenceSyncConfig
object allows us to do the following:
Hard reference the prefab in Editor, this means that whenever we have to do postprocessing in synced prefabs, we don't have to do a lookup or load them from Resources.
Serialize the method of loading and instantiating this prefab in runtime.
Soft reference the prefab in Runtime with a GUID, this means we can access the loading and instantiating implementations without having to load the prefab itself into memory.
Every time a CoherenceSyncConfig
object is created, it gets added to a registry that is another ScriptableObject of type CoherenceSyncConfigRegistry
.
You can inspect all of the CoherenceSyncConfig
assets in one place in the CoherenceSync Objects window, found under the coherence > CoherenceSync Objects menu item:
This is a great way to see the configuration of different entities next to each other, and to do mass edits.
Assets/coherence/CoherenceSyncConfigs
is the default location of all CoherenceSyncConfig
objects.
You can also manually inspect the CoherenceSyncConfigRegistry
by selecting it from Assets/coherence
folder