We have mentioned that, at some point, Unity 6.x will eventually only support v2.x of the Netcode for GameObjects SDK. As with all projects, it is inevitable to end support for legacy versions. Today we are announcing Netcode for GameObjects v1.x will not be supported in 6000.3 and beyond. This decision is primarily based on freeing up resources to provide a better netcode experience by focusing on the current version (v2.x) and future versions. With that being said, starting with Unity 6000.3 LTS we are ending support for Netcode for GameObjects v1.x.
What this means:
- Unity versions 6000.3+ LTS will only support Netcode for GameObjects v2.x.
- Unity versions 6000.2 LTS and below will still support Netcode for GameObjects v1.x until the end of life of the last supported editor version.
- This means we will still be supporting/updating/fixing v1.x for the earlier editor versions.
We always recommend updating to the most recent version of Netcode for GameObjects to get the most recent fixes and features.
In order to update your project from 1.X version to 2.X version of Netcode for GameObjects (currently latest version is 2.4.4) you should follow the guide below:
- Incompatible changes in the NetworkTransform when upgrading from Netcode for GameObjects v1.x to v2.x:
- The method NetworkTransform.Update can no longer be overridden, for performance reasons. It has been replaced by a new NetworkTransform.OnUpdate method, which is only invoked on non-authority instances.
- If you previously overrode NetworkTransform.Update in order to gain more control over non-authority NetworkTransform instances - for example, to customize the way NetworkTransform instance positions are interpolated between updates - you must override NetworkTransform.OnUpdate instead.
- If you previously overrode NetworkTransform.Update in order to add logic for authority instances, we recommend you instead make a new class (such as a NetworkBehaviour) implementing INetworkUpdateSystem and then register/unregister it with the NetworkUpdateLoop when gaining and losing authority.
- If you have not overridden NetworkTransform.Update, then you should not have to make any adjustments at all.
- Open your v1.x project in Unity 6.
- Upgrade your Netcode for GameObjects version to the most recent v2.x version.