Known issues
WebGL builds running locally don't work with Firefox
WebGL builds running locally can't connect to the coherence Cloud on Firefox.
RS can rarely start dropping packets with Steam Relay
Steam Relay can sometimes suffer from intermittent lag spikes, followed by packet bursts. These will conflict with RS rate throttling rules, leading to the RS flagging the Steam Relay as a malicious or malfunctioning connection and start dropping packets. This should mainly affect only users who connect with Steam over sub-par mobile connections. We are aware if the issue and a fix is in the works.
RS rejects mismatched persistent save data
This is an issue you can encounter when updating your project from coherence v1.2 to v1.3.
If the schema changes, the persistent save data is invalidated and will not load. You need to update your persistent save data before applying the new schema.
Check your warning log for more details.
Byte arrays don't sync when changing values by index
When binding a byte[] field, the field will not be synced when changed by someField[x] = y.
The only way to actually update the field, is through someField = new byte[]... which assigns a new reference.
Warning messages when running GGPO network rollback
We have identified a misprediction bug in coherence 1.1.3 and earlier versions that causes a failed rollback right after a new Client joins a session, throwing relevant error messages. However if the Client manages to connect, this won't affect the rest of the simulation. The bug is fixed in the following release.
Warnings about missing hashes
If you're getting errors such as the ones below, the issue is that your Prefab has multiple AnimationControllers, but coherence only supports a single AnimationController.
Parameter 'Hash 1963678224' does not exist.
CoherenceSync: We can't find any binding for component 'GenericFieldQuaternion0' when receiving a component update.
Or see an error on saving a Prefab from the sample:
Delete the sample itself (mind any modifications you might have done), close Unity and delete the Library folder. Note that by doing so you're forcing a reimport of all your assets, which might take time depending on your project size.
Changing parent teleports the Entity to world zero for a frame
When using CoherenceNode on your CoherenceSync, if CoherenceNode's networked variables have interpolation applied, you'll experience this issue. Turn off interpolation for such variables.
CoherenceSync Prefab instances on the scene not appearing when using "No Duplicates" uniqueness setting
This can happen if coherence fails to set a Unique ID on your scene instances. Check the CoherenceSync inspector on Prefab instances. Look for Prefab Instance Unique ID. Click the button to generate an ID. Do this for every Prefab instance that is missing its ID.
Alternatively, you can set a Manual Unique ID of your own on the Prefab itself or per-Prefab instance on your scene.
Types missing the ExtensionOfNativeClass attribute
ExtensionOfNativeClass attributeReimport assets via menu item Assets / Reimport All.
Scripts losing references to Prefabs, Fix Serialized Data button appears
The Optimize window stops rendering components
I can't see Rooms or Worlds
Check that all your Clients are using the same Schema ID.
Prefab Variants use excessive memory
When working with Prefab Variants, Unity leaks managed references (fields marked with [SerializeReference]). This can make your Prefab grow big and use more memory than necessary. Until Unity fixes this issue, we provide you with the ability to prune the leaked references. You can prune within the Configure window.
Binding is interpolated into an incorrect position after instantiating
The current recommended workaround is to make sure that the Prefab has initial values set before instantiation. Or in the case of position and rotation, those could be directly supplied to Instantiate() instead of setting them later in the frame.
Clicking on a Prefab instance logs "CoherenceSyncEditor: Upgraded legacy archetype name on the CoherenceSync Prefab instance"
If you see this message, the CoherenceSync Prefab instance has been modified to point to the correct archetype name. If that's the case, select every CoherenceSync Prefab instance on your scene(s) to make sure this fixup happens. Even if you don't see the message, you're good to go. Make sure you save your project (Ctrl+S) to apply the changes (if any) to disk.
InvalidOperationException: Insecure connection not allowed
Random Crashes running the SDK on Unity 2021.3 on a Mac
On a Mac, when the cursor is moved quickly over the user name in the hub it can cause a crash of the Unity editor. If possible upgrade to a later version of the Unity editor.
Fix Prefab Instance button missing when a component is removed from a prefab scene instance on Unity 2021
Unity 2021 does not update the inspector window and the user cannot see the Fix Prefab Instance button. There are two ways to fix this. The first is to manually revert the removal of the component(s) from the Prefab instance. The second is to force Unity to refresh the view by clicking the Presets button in the CoherenceSync component header and then close the presets window. This will refresh the view and allow you to click the Fix Prefab Instance button.
Was this helpful?
