# Deprecations Certain features of Unity Networking (UNet) were removed from Mirror or modified for various reasons. This page will identify all changed and removed features, properties, and methods, the reason for change or removal, and possible alternatives. {% hint style="info" %} **Note:** Some changes in this document may apply to an upcoming release to the Asset Store. {% endhint %} ## Match Namespace & Host Migration As part of the Unity Services, this entire namespace was removed. It didn't work well to begin with, and was incredibly complex to be part of the core networking package. We expect this, along with other back-end services, will be provided through standalone apps that have integration to Mirror. ## Network Server Simple This was too complex and impractical to maintain for what little it did, and was removed. There are much easier ways to make a basic listen server, with or without one of our transports. ## Couch Co-Op The core networking was greatly simplified by removing this low-hanging fruit. It was buggy, and too convoluted to be worth fixing. For those that need something like this, consider defining a non-visible player prefab as a message conduit that spawns actual player prefabs with client authority. All inputs would route through the conduit prefab to control the player objects. ## Message Types The `MsgType` enumeration was removed. All message types are generated dynamically. Use `Send` instead. ## Network Transform [Network Transform](/docs/manual/components/network-transform.md) was fully replaced so that it only syncs position, rotation and scale, has control options for those and whether to interpolate them, and uses Snapshot Interpolation. It also has a bunch of virtual methods and there's a [Script Template](/docs/manual/general/script-templates.md) for making your own derived version. Rigidbody support was removed in favor of a separate [Network Rigidbody](/docs/manual/components/network-rigidbody.md) component. ## Network Animator [Network Animator](/docs/manual/components/network-animator.md) was also simplified, as it batches all Animator parameters into a single update message. ## SyncVar Hook Parameters [SyncVar](/docs/manual/guides/synchronization/syncvars.md) property values are now updated before the hook is called, and hooks now require two parameters of the same type as the property: `oldValue` and `newValue` ## SyncListSTRUCT Use [SyncList](/docs/manual/guides/synchronization/synclists.md) instead. ## SyncList Classes * `SyncListString` was replaced by `SyncList` . * `SyncListFloat` was replaced by `SyncList`. * `SyncListInt` was replaced by `SyncList`. * `SyncListUInt` was replaced by `SyncList`. * `SyncListBool` was replaced by `SyncList`. See [documentation](/docs/manual/guides/synchronization/synclists.md) for more details. ## SyncList Operations * `OP_REMOVE` was replaced by `OP_REMOVEAT` * `OP_DIRTY` was replaced by `OP_SET` See [documentation](/docs/manual/guides/synchronization/synclists.md) for more details. ## SyncDictionary Operations * `OP_DIRTY` was replaced by `OP_SET` See [documentation](/docs/manual/guides/synchronization/syncdictionary.md) for more details. ## SyncObject * This is now a class instead of an interface. * `Flush` - Use `ClearChanges` instead. ## Quality of Service Flags In classic UNet, QoS Flags were used to determine how packets got to the remote end. For example, if you needed a packet to be prioritized in the queue, you would specify a high priority flag which the Unity LLAPI would then receive and deal with appropriately. Unfortunately, this caused a lot of extra work for the transport layer and some of the QoS flags did not work as intended due to buggy code that relied on too much magic. In Mirror, QoS flags were replaced with a "Channels" system. While the default transport, [Telepathy](/docs/manual/transports/telepathy-transport.md), does not use channels at all because it's TCP-based, other transports, such as [Ignorance](/docs/manual/transports/ignorance.md) and [LiteNetLib](/docs/manual/transports/litenetlib-transport.md), do support them. The currently defined channels are: * `Channels.Reliable = 0` * `Channels.Unreliable = 1` ## Changes by Class ### NetworkManager * `NetworkConnection` was replaced by `NetworkConnectionToClient` in many places. * `networkPort`\ Removed as part of separating Transports to components. Not all transports use ports, but those that do have a field for it. See [Transports](/docs/manual/transports.md) for more info. * `IsHeadless()`\ Use compiler symbol `UNITY_SERVER` instead. * `ConfigureServerFrameRate` was renamed to `ConfigureHeadlessFrameRate`. * `client`\ Use NetworkClient directly, it will be made static soon. For example, use `NetworkClient.Send(message)` instead of `NetworkManager.client.Send(message)`. * `IsClientConnected()`\ Use static property `NetworkClient.isConnected` instead. * `onlineScene` and `offlineScene`\ These store full paths now, so use SceneManager.GetActiveScene().path instead. * `OnStartClient(NetworkClient client)`\ Override OnStartClient() instead since all `NetworkClient` methods are static now. * `OnClientChangeScene(string newSceneName)`\ Override `OnClientChangeScene(string newSceneName, SceneOperation sceneOperation, bool customHandling)` instead. * `OnClientChangeScene(string newSceneName, SceneOperation sceneOperation)`\ Override `OnClientChangeScene(string newSceneName, SceneOperation sceneOperation, bool customHandling)` instead. * `OnServerAddPlayer(NetworkConnection conn, AddPlayerMessage extraMessage)`\ Override `OnServerAddPlayer(NetworkConnection conn)` instead. See [Custom Player Spawn Guide](/docs/manual/guides/gameobjects/custom-character-spawning.md) for details. * `OnServerRemovePlayer(NetworkConnection conn, NetworkIdentity player)`\ Use `NetworkServer.RemovePlayerForConnection(NetworkConnection conn, GameObject player, bool keepAuthority = false)` instead. * `OnServerError(NetworkConnection conn, int errorCode)` Replaced with `OnServerError(NetworkConnection conn, Exception exception)`. * `OnClientError(NetworkConnection conn, int errorCode)` Replaced with `OnClientError(Exception exception)`. * `disconnectInactiveConnections` and `disconnectInactiveTimeout` were removed. * OnClient\* virtual methods no longer take a `NetworkConnection` parameter. Remove the parameter from your overrides and use `NetworkClient.connection` in your code instead. * `serverTickRate` renamed to `sendRate`. * `serverTickInterval` moved to `NetworkServer`. ### NetworkManagerHUD * `showGUI` was removed. Disable the component instead. ### NetworkRoomManager * `NetworkConnection` was replaced by `NetworkConnectionToClient` in many places. * `OnRoomServerCreateGamePlayer(NetworkConnection conn)`\ Use `OnRoomServerCreateGamePlayer(NetworkConnection conn, GameObject roomPlayer)` instead. * `OnRoomServerSceneLoadedForPlayer(GameObject roomPlayer, GameObject gamePlayer)`\ Use `OnRoomServerSceneLoadedForPlayer(NetworkConnection conn, GameObject roomPlayer, GameObject gamePlayer)` instead. * Client virtual methods no longer take a `NetworkConnection` parameter. Use `NetworkClient.connection` within your overrides. ### NetworkIdentity * `clientAuthorityOwner`\ Use connectionToClient instead * `GetSceneIdenity`\ Use `GetSceneIdentity` instead (typo in original name) * `RemoveClientAuthority(NetworkConnection conn)`\ NetworkConnection parameter is no longer needed and nothing is returned * `spawned` dictionary This has been split up to `NetworkServer.spawned` and `NetworkClient.spawned` dictionaries. * Local Player Authority checkbox\ This checkbox is no longer needed, and we simplified how [Authority](/docs/manual/guides/authority.md) works in Mirror. ### NetworkBehaviour * `NetworkConnection` was replaced by `NetworkConnectionToClient` in many places. * `sendInterval` attribute\ Use `NetworkBehaviour.syncInterval` field instead. Can be modified in the Inspector too. * `List m_SyncObjects`\ Use `List syncObjects` instead. * `OnSetLocalVisibility(bool visible)`\ Override `OnSetHostVisibility(bool visible)` instead. * `OnRebuildObservers`, `OnCheckObserver`, and `OnSetHostVisibility` were moved to a separate class called `NetworkVisibility` * `NetworkBehaviour.OnNetworkDestroy` was renamed to `NetworkBehaviour.OnStopClient`. * `getSyncVarHookGuard` renamed to `GetSyncVarHookGuard`. * `setSyncVarHookGuard` - renamed to `SetSyncVarHookGuard`. * `SetDirtyBit` - Use `SetSyncVarDirtyBit` instead. * `[Command]` attribute parameter `ignoreAuthority` replaced with `requiresAuthority`. * `[ClientRpc]` attribute parameter `includeOwner` replace with `excludeOwner`. * `hasAuthority` renamed to `isOwned`. ### NetworkConnection * `hostId`\ Removed because it's not needed ever since we removed LLAPI as default. It's always 0 for regular connections and -1 for local connections. Use `connection.GetType() == typeof(NetworkConnection)` to check if it's a regular or local connection. * `isConnected`\ Removed because it's pointless. A `NetworkConnection` is always connected. * `InvokeHandlerNoData(int msgType)`\ Use `InvokeHandler` instead. * `playerController`\ renamed to `identity` since that's what it is: the `NetworkIdentity` for the connection. * `RegisterHandler(short msgType, NetworkMessageDelegate handler)`\ Use `NetworkServer.RegisterHandler()` or `NetworkClient.RegisterHandler()` instead. * `UnregisterHandler(short msgType)`\ Use `NetworkServer.UnregisterHandler()` or `NetworkClient.UnregisterHandler()` instead. * `Send(int msgType, MessageBase msg, int channelId = Channels.Reliable)`\ Use `Send(msg, channelId)` instead. * `clientOwnedObjects` renamed to `owned`. ### NetworkServer * `NetworkConnection` was replaced by `NetworkConnectionToClient` in many places. * `FindLocalObject(uint netId)`\ Use `NetworkServer.spawned[netId].gameObject` instead. * `RegisterHandler(int msgType, NetworkMessageDelegate handler)`\ Use `RegisterHandler(T msg)` instead. * `RegisterHandler(MsgType msgType, NetworkMessageDelegate handler)`\ Use `RegisterHandler(T msg)` instead. * `RegisterHandler(Action handler, bool requireAuthentication = true)` Use `RegisterHandler(Action(T message, int channelId = Channels.Reliable)` instead. * `SendToReady(NetworkIdentity identity, short msgType, MessageBase msg, int channelId = Channels.Reliable)`\ Use `identity.connectionToClient.Send()` instead. * `SendToReady(NetworkIdentity identity, T message, bool includeOwner = true, int channelId = Channels.Reliable)` Renamed to `SendToReadyObservers`. * `SpawnWithClientAuthority(GameObject obj, GameObject player)`\ Use `Spawn(GameObject obj, GameObject player)` instead. * `SpawnWithClientAuthority(GameObject obj, NetworkConnection ownerConnection)`\ Use `Spawn(GameObject obj, NetworkConnection ownerConnection)` instead. * `SpawnWithClientAuthority(GameObject obj, Guid assetId, NetworkConnection ownerConnection)`\ Use `Spawn(GameObject obj, Guid assetId, NetworkConnection ownerConnection)` instead. * `disconnectInactiveConnections` and `disconnectInactiveTimeout` were removed. * `NoConnections` was renamed to `NoExternalConnections`. * `DisconnectAllExternalConnections` / `DisconnectAllConnections` Use `DisconnectAll` instead. * `OnError` renamed to `OnTransportError` for clarity. ### NetworkClient * `NetworkClient singleton`\ Use `NetworkClient` directly. Singleton isn't needed anymore as all functions are static now.\ Example: `NetworkClient.Send(message)` instead of `NetworkClient.singleton.Send(message)`. * `allClients`\ Use `NetworkClient` directly instead. There is always exactly one client. * `GetRTT()`\ Use `NetworkTime.rtt` instead. * `readyConnection` Use `connection` instead. * `isLocalClient` Use `isHostClient` instead. * `DisconnectLocalServer()` Use `NetworkClient.Disconnect()` instead. * `RegisterHandler(int msgType, NetworkMessageDelegate handler)`\ Use `RegisterHandler(T msg)` instead. * `RegisterHandler(MsgType msgType, NetworkMessageDelegate handler)`\ Use `RegisterHandler(T msg)` instead. * `RegisterHandler(Action handler, bool requireAuthentication = true)` Use `RegisterHandler(Action handler, bool requireAuthentication = true)` instead. * `UnregisterHandler(int msgType)`\ Use `UnregisterHandler(T msg)` instead. * `UnregisterHandler(MsgType msgType)`\ Use `UnregisterHandler(T msg)` instead. * `Ready(NetworkConnection conn)` Use `Ready()` without the `NetworkConnection` parameter instead. * `Send(short msgType, MessageBase msg)`\ Use `Send(T msg, int channelId = Channels.Reliable)` with no message id instead * `ShutdownAll()`\ Use `Shutdown()` instead. There is only one client. * `OnError` renamed to `OnTransportError` for clarity. ### ClientScene * Merged into `NetworkClient`. ### Network Scene Checker * Replaced by [Scene Interest Management](/docs/manual/interest-management/scene.md). ### Network Proximity Checker * Replaced by [Spatial Hash](/docs/manual/interest-management/spatial-hashing.md) / [Distance](/docs/manual/interest-management/distance.md) Interest Management. ### Network Match Checker * Replaced by Network Match and requires [Match Interest Managemen](/docs/manual/interest-management/match.md)t. ### Network Owner Checker * Replaced by Network Team and requires [Team Interest Management](/docs/manual/interest-management/team.md). ### Network Authenticator * `NetworkConnection` was replaced by `NetworkConnectionToClient` in many places. * `OnClientAuthenticate` no longer takes a `NetworkConnection` parameter.\ Use `NetworkClient.connection` as needed. * `OnClientAuthenticated` event no longer takes a `NetworkConnection` parameter.\ Use `NetworkClient.connection` as needed. * `NetworkConnection` is no longer used in client message handlers. Use `NetworkClient.connection` within your handlers instead. * `ClientAccept` and `ClientReject` no longer needs a `NetworkConnection` parameter. ### NetworkTime * `NetworkTime.timeVar` was renamed to `timeVariance`. * `NetworkTime.timeSd` was renamed to `timeStandardDeviation`. * `NetworkTime.rttVar` was renamed to `rttVariance`. * `NetworkTime.rttSd` was renamed to `rttStandardDeviation`. ### Transport * `activeTransport` renamed to `active`. ### Messages Basic messages of simple types were all removed as unnecessary bloat. You can create your own message classes instead. * `StringMessage` * `ByteMessage` * `BytesMessage` * `IntegerMessage` * `DoubleMessage` * `EmptyMessage` NetworkMessage requires structs in all cases - classes no longer supported ### NetworkReader * `Read(byte[] buffer, int offset, int count)`\ Use `ReadBytes` instead. * `ReadPackedInt32(int value)` Use `ReadInt32(int value)` instead. * `ReadPackedUInt32(uint value)` Use `ReadUInt32(uint value)` instead. * `ReadPackedUInt64(ulong value)` Use `ReadUInt64(ulong value)` instead. * `ReadBoolean` renamed to `ReadBool`. * `ReadInt16` renamed to `ReadShort`. * `ReadInt32` renamed to `ReadInt`. * `Readint64` renamed to `ReadLong`. * `ReadSingle` renamed to `ReadFloat`. ### NetworkWriter * `Write(bool value)`\ Use `WriteBool` instead. * `Write(byte value)`\ Use `WriteByte` instead. * `Write(sbyte value)`\ Use `WriteSByte` instead. * `Write(short value)`\ Use `WriteShort` instead. * `Write(ushort value)`\ Use `WriteUShort` instead. * `Write(int value)`\ Use `WriteInt` instead. * `Write(uint value)`\ Use `WriteUInt` instead. * `Write(long value)`\ Use `WriteLong` instead. * `Write(ulong value)`\ Use `WriteULong` instead. * `Write(float value)`\ Use `WriteFloat` instead. * `Write(double value)`\ Use `WriteDouble` instead. * `Write(decimal value)`\ Use `WriteDecimal` instead. * `Write(string value)`\ Use `WriteString` instead. * `Write(char value)`\ Use `WriteChar` instead. * `Write(Vector2 value)`\ Use `WriteVector2` instead. * `Write(Vector2Int value)`\ Use `WriteVector2Int` instead. * `Write(Vector3 value)`\ Use `WriteVector3` instead. * `Write(Vector3Int value)`\ Use `WriteVector3Int` instead. * `Write(Vector4 value)`\ Use `WriteVector4` instead. * `Write(Color value)`\ Use `WriteColor` instead. * `Write(Color32 value)`\ Use `WriteColor32` instead. * `Write(Guid value)`\ Use `WriteGuid` instead. * `Write(Transform value)`\ Use `WriteTransform` instead. * `Write(Quaternion value)`\ Use `WriteQuaternion` instead. * `Write(Rect value)`\ Use `WriteRect` instead. * `Write(Plane value)`\ Use `WritePlane` instead. * `Write(Ray value)`\ Use `WriteRay` instead. * `Write(Matrix4x4 value)`\ Use `WriteMatrix4x4` instead. * `Write(NetworkIdentity value)`\ Use `WriteNetworkIdentity` instead. * `Write(GameObject value)`\ Use `WriteGameObject` instead. * `Write(byte[] buffer, int offset, int count)`\ Use `WriteBytes` instead. * `WritePackedInt32(int value)`\ Use `WriteInt32(int value)` instead * `WritePackedUInt32(uint value)`\ Use `WriteUInt32(uint value)` instead * `WritePackedUInt64(ulong value)`\ Use `WriteUInt64(ulong value)` instead ### RemoteCallHelper * Renamed to `RemoteProcedureCalls`. * `CmdDelegate` renamed to `RemoteCallDelegate`. * `MirrorInvokeType` renamed to `RemoteCallType`. ### Transport * `GetConnectionInfo(int connectionId, out string address)`\ Use `ServerGetClientAddress(int connectionId)` instead. * `GetMaxBatchSize` renamed to `GetMaxPacketSize`. * `ClientSend(int channelId, ArraySegment segment)` Use `ClientSend(segment, channelId)` instead. * `ServerSend(int connectionId, int channelId, ArraySegment segment)` Use `ServerSend(connectionId, segment, channelId)` instead. ### Telepathy Transport * `MaxMessageSize`\ Use `MaxMessageSizeFromClient` or `MaxMessageSizeFromServer` instead. ### Fallback Transport * This has been removed. ### Utils * `Version` enum removed. * `DefaultReliable` renamed to `Reliable`. * `DefaultUnreliable` renamed to `Unreliable`. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://mirror-networking.gitbook.io/docs/manual/general/deprecations.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.