Prefab setup: CoherenceSync
In this section, we will learn how to prepare a Prefab for network replication.
Video tutorial
Setting up basic syncing is explained in this video, from 1:00 and onwards:
Using the coherence Hub
You can let the coherence Hub guide you through your Prefab setup process. Simply select a Prefab, open the GameObject tab in the coherence Hub (coherence > coherence Hub) and follow the instructions.
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252FZSlzDMNLgDZ1kRM3guku%252FCoherenceHub_ObjectSetup.png%3Falt%3Dmedia%26token%3Daac5ac3e-7920-42a6-80a7-45f7dfeffa76&width=768&dpr=4&quality=100&sign=7c9ab8a1&sv=1)
Step by step
You can also follow the detailed step-by-step text guide below.
1. Add CoherenceSync
to your GameObject
CoherenceSync
to your GameObjectFor a Unity GameObject to be networked through coherence, it needs to have a CoherenceSync
component attached. Currently, only Prefabs are supported. If your GameObject is not a Prefab, CoherenceSync
can assist you.
First, create a new GameObject. In this example, we're going to create a cube.
Next, we add the CoherenceSync
component to Cube.
CoherenceSync
inspector now tells us that we need to make a Prefab out of this GameObject for it to work. We get to choose where to create it:
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252FG1Od5bOtgbuOVAz97ETy%252FCoherenceSync_NotConfigured.png%3Falt%3Dmedia%26token%3Deff07cf1-f2af-4101-8918-3f5d67bcb9cf&width=768&dpr=4&quality=100&sign=641a620b&sv=1)
(Optional) Networking an already existing Prefab
If you wish to start networking a Prefab that already exists in your project, you have several options to do it. Remember that they all lead to the same result.
You can:
Click on the Sync with coherence checkbox at the top of the Prefab inspector.
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252FTLXSY4O06Fya5RPKueyo%252FSyncWithCoherence_Checkbox.png%3Falt%3Dmedia%26token%3Da3400ef8-ecc8-46d9-b6b2-800c348c064a&width=768&dpr=4&quality=100&sign=5b0cba8d&sv=1)
Manually add the
CoherenceSync
component.
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252FAFhJoz7mkJ5hwsVa3Ceu%252FAddCoherenceSync.png%3Falt%3Dmedia%26token%3Dab8ada3d-6b8e-447c-b390-1a66e1b79ba2&width=768&dpr=4&quality=100&sign=abe0b2b5&sv=1)
Drag the Prefab to the CoherenceSync Objects window. You can find it in coherence > CoherenceSync Objects.
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252FTMyIoGIVcvqyvnpTabLJ%252FAddToSyncObjects.gif%3Falt%3Dmedia%26token%3Db6d41947-bb21-43ca-b5a2-ef4da8a0042c&width=768&dpr=4&quality=100&sign=3ae9bbbf&sv=1)
(Optional) Prefab variants
One way to configure your Prefab instead of just adding CoherenceSync
to it, is to fork a Prefab variant and add the component there.
In our Cube example, instead of adding CoherenceSync to Cube, you can create a Cube (Networked) Prefab and add CoherenceSync
to it:
Learn how to create and use Prefab variants in the Unity Manual.
This way, you can retain the original Prefab untouched, and build all the network functionality separately, in its own Prefab.
Another way to use Prefab variants to our advantage is to have a base Prefab using CoherenceSync
, and create Prefab variants off that one with customizations. For example, Enemy (base Prefab) and Enemy 1, Enemy 2, Enemy 3... (variant Prefabs, using different models, animations, materials, etc.). In this setup, all of the enemies will share the networking settings stored in CoherenceSync
, so you don't have to manually update every one of them.
The Prefab variant inherits the network settings from its parent, and you change those with overrides in the Configuration window. When a synced variable, method or component action is present in the variant and not in the parent, it will be bolded and it will have the blue line next to it, just like any other override in Unity:
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252FCdLhH6WEas3OCTC1ZyVV%252FPrefabVariantConfig.png%3Falt%3Dmedia%26token%3Db5955092-ab97-4668-9789-b9873ac017c7&width=768&dpr=4&quality=100&sign=c8b5b512&sv=1)
2. Configure CoherenceSync
CoherenceSync
The CoherenceSync
component will help you prepare an object for network synchronization during design time. It also exposes an API that allows us to manipulate the object during runtime.
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252FEsDPLauUjSzApsmirp5l%252FCoherenceSync_Inspector.png%3Falt%3Dmedia%26token%3D135c09e1-1076-4af1-9947-820b897409f7&width=768&dpr=4&quality=100&sign=f95e8c18&sv=1)
In its Inspector you can configure settings for Lifetime (Session-based or Persistent), Authority transfer (Not Transferable, Request or Steal), Simulate In (Client Side, Server Side or Server Side with Client Input) and Adoption settings for when persistent entities become orphaned, and more.
There are also a host of Events that are triggered at different times.
Its Inspector has quite a number of settings. For more information on them, refer to the CoherenceSync
page.
For now, we can leave these settings to their defaults.
2.1 Select variables to replicate
CoherenceSync
allows you to automatically network all public variables and methods on any of the attached components, from Unity components such as Transform
, Animator
, etc. to any custom script, including scripts that came with the Asset Store packages that you may have downloaded.
To set it up, click on the Configure button in the CoherenceSync
's Inspector. This brings up the Configuration window. Here you can select which variables you would like to sync across the network:
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252FguN7EuVcIpgiVkd5lzdc%252FConfigureWindow_BaseProperties.png%3Falt%3Dmedia%26token%3D8520d454-8c4a-4be4-95e2-7c0af2918aeb&width=768&dpr=4&quality=100&sign=1bb30b94&sv=1)
You will notice that position is already selected, and can't be removed. For our use case, let's add rotation and scale.
Note that you can configure variables, methods and components not only on the root, but also on child GameObjects.
Close the Configuration dialog.
3. Add a movement script
This simple movement script will use WASD or the Arrow keys to move the Prefab around the scene.
Click on Assets > Create > C# Script. Name it Move.cs
. Copy-paste the following content into the file:
Wait for Unity to compile the file, then add it to the Prefab.
4. Disable the component on replicated objects
We have added a Move
script to the Prefab. This means that if we just run the scene, we will be able to use the keyboard to move the object around.
But what happens on other Clients, where this object is not authoritative, but replicated? We want the position to be replicated over the network without keyboard input interfering with it.
In the Configuration window, click the Components tab:
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252Fftz06kG8DMBlxF8d67b6%252FComponentActions.png%3Falt%3Dmedia%26token%3D6c7599c7-d9ee-4554-a35b-d0199a1c3ca3&width=768&dpr=4&quality=100&sign=cb867483&sv=1)
Here you will see a list of Component Actions that you can apply to non-authoritative entities that have been spawned by the network.
Selecting Disable for your Move
script will make sure the Component is disabled for network instances of your Prefab:
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252F7XmQYSFLyz5ZQ7gyDuFh%252FComponentActionDisabled.png%3Falt%3Dmedia%26token%3Dd18fdf46-e2e4-453c-af37-bd121d9a6ea9&width=768&dpr=4&quality=100&sign=4f3cc369&sv=1)
This ensures that, if a copy of this Prefab is instantiated on a Client with no authority, this script will be disabled and won't interfere with the position that is being synced on the network.
5. Bake the netcode
Once everything is setup, you should ensure to run the process of Baking: coherence will produce the necessary netcode (i.e. a bunch of C# scripts) to ensure that when the game is running and the Client connects, all of the properties and network messages you might have configured will correctly sync.
This process is very quick, and can be done in different ways:
From the menu item coherence > Bake
Within the coherence Hub, in the Baking tab, using Bake Now:
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252FYJ8DV9yH2Nk1oxXXhLk0%252FBakingFromTheHub.png%3Falt%3Dmedia%26token%3D7d9bc763-f940-4cfb-8088-02183542a117&width=768&dpr=4&quality=100&sign=22e71e53&sv=1)
When a Prefab contains changes that need baking, its Inspector will warn you. Pressing Bake here will actually bake all code for all Prefabs:
![](https://docs.coherence.io/~gitbook/image?url=https%3A%2F%2F976449006-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4xmLLczbgaGVeoF6vews%252Fuploads%252FDRmfsragWhQfwktRrdZR%252FNeedToBake.png%3Falt%3Dmedia%26token%3D40fe5bb7-ef26-4348-a2d7-29ec2c97af3f&width=768&dpr=4&quality=100&sign=f8446f2d&sv=1)
To recap
In short, setting up a Prefab for networking requires:
A Prefab with a
CoherenceSync
added to itOptionally, setting some of its properties
Configuring what to sync in the Configure window
Disabling components on remote entities, in the Configure > Components tab
Baking the netcode
This is it! Setting up a Prefab to be networked doesn't require additional steps.
Now you can run this setup locally or using the coherence Cloud.
Helper scripts
Helper scripts and samples can be found here. These cover things such as:
Spawning a player
Basic inputs to get Game Objects moving
Score keeper
Displaying player names
Camera facing UI
Off-screen spawning of enemies or other Game Objects
Indicator (arrow) for guiding the player towards off-screen Game Objects
Implementing Network Commands and Authority Transfer
Connection Events
Last updated