Skip to main content

Netcode for GameObjects (Netcode) Error Messages

Learn more about Unity error messages, including error collecting, issues that cause them, and how to handle.

Error Capturing#

Error messages are captured and returned through Unity Editor Diagnostics (required) and Roslyn Analyzers.

  • Unity ILPP and Editor errors are the source of truth. ILPP occurs in Unity and returns error messages, which prevents you from building/playing your game (hard compile errors).
  • Roslyn Analyzers provide immediate feedback within the IDE, without jumping back to Unity to let it compile with your new changes.

NetworkObject errors#

Error:

  • Cannot find pending soft sync object. Is the projects the same? UnityEngine.Debug:LogError(Object)
  • ArgumentNullException: Cannot spawn null object Parameter name: netObject

This exception should only occur if your scenes are not the same, for example if the scene of your server contains a NetworkObject which is not present in the client scene. Verify the scene objects work correctly by entering playmode in both editors.

ServerRPC errors#

Error:

  • Server: [Netcode] Only owner can invoke ServerRPC that is marked to require ownership
  • Host: KeyNotFoundException: The given key was not present in the dictionary.

The ServerRPC should only be used on the server. Make sure to add isServer check before calling.

If the call is added correctly but still returns a nullreferenceexception, NetworkManager.Singleton may be returning null. Verify you created the GameObject with a NetworkManager component, which handles all initialization. NetworkManager.Singleton is a reference to a instance of the NetworkManager component.